PolyORB User’s Guide

Robert Duff, Jérôme Hugues, Laurent Pautet, Thomas Quinot, Samuel Tardieu

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the Invariant Sections being ‘GNU Free Documentation License’, with the Front-Cover Texts being ‘PolyORB User’s Guide’, and with no Back-Cover Texts. A copy of the license is included in the section entitled ‘GNU Free Documentation License’.

About This Guide

This guide describes the use of PolyORB, a middleware that enables the construction of distributed Ada applications.

It describes the features of the middleware and related APIs and tools, and details how to use them to build Ada applications.

What This Guide Contains

This guide contains the following chapters:

  • Introduction to PolyORB provides a brief description of middleware and PolyORB’s architecture.
  • Installation details how to configure and install PolyORB on your system.
  • Overview of PolyORB personalities enumerates the different personalities, or distribution mechanisms, PolyORB provides.
  • Building an application with PolyORB presents the different steps to build a distributed application using PolyORB.
  • Tasking model in PolyORB details the use of tasking constructs within PolyORB.
  • CORBA describes PolyORB’s implementation of OMG’s CORBA.
  • RT-CORBA describes PolyORB’s implementation of RT-CORBA, the real-time extensions of OMG’s CORBA.
  • Ada Distributed Systems Annex (DSA) describes PolyORB’s implementation of the Ada Distributed Systems Annex.
  • MOMA describes PolyORB’s implementation of MOMA, the Message Oriented Middleware for Ada.
  • GIOP describes PolyORB’s implementation of GIOP, the protocol defined as part of CORBA.
  • SOAP describes PolyORB’s implementation of SOAP.
  • Tools describes PolyORB’s tools.
  • Performance Considerations discusses possible configuration adjustments to optimize PolyORB’s run time performance.
  • Conformance to Standards discusses the conformance of the PolyORB’s personalities to the CORBA and SOAP standards.
  • References provides a list of useful references to complete this documentation.

Conventions

Following are examples of the typographical and graphic conventions used in this guide:

  • Functions, utility program names, standard names, and classes.

  • Option flags

  • File Names, button names, and field names.

  • Variables.

  • Emphasis.

  • [optional information or parameters]

  • Examples are described by text

    and then shown this way.
    

Commands that are entered by the user are preceded in this manual by the characters ‘`$‘` (dollar sign followed by space). If your system uses this sequence as a prompt, then the commands will appear exactly as you see them in the manual. If your system uses some other prompt, then the command will appear with the $ replaced by whatever prompt you are using.

Full file names are shown with the ‘/‘ character as the directory separator; e.g., parent-dir/subdir/myfile.adb. If you are using GNAT on a Windows platform, please note that the ‘\‘ character should be used instead.