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'. .. toctree:: :numbered: :maxdepth: 3 Introduction_to_PolyORB Installation Overview_of_PolyORB_personalities Building_an_application_with_PolyORB Tasking_model_in_PolyORB CORBA RT-CORBA Ada_Distributed_Systems_Annex_(DSA) MOMA GIOP SOAP Tools Performance Conformance References .. _About_This_Guide: 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: What This Guide Contains ~~~~~~~~~~~~~~~~~~~~~~~~ This guide contains the following chapters: * :ref:`Introduction_to_PolyORB` provides a brief description of middleware and PolyORB's architecture. * :ref:`Installation` details how to configure and install PolyORB on your system. * :ref:`Overview_of_PolyORB_personalities` enumerates the different personalities, or distribution mechanisms, PolyORB provides. * :ref:`Building_an_application_with_PolyORB` presents the different steps to build a distributed application using PolyORB. * :ref:`Tasking_model_in_PolyORB` details the use of tasking constructs within PolyORB. * :ref:`CORBA` describes PolyORB's implementation of OMG's CORBA. * :ref:`RT-CORBA` describes PolyORB's implementation of RT-CORBA, the real-time extensions of OMG's CORBA. * :ref:`Ada_Distributed_Systems_Annex_(DSA)` describes PolyORB's implementation of the Ada Distributed Systems Annex. * :ref:`MOMA` describes PolyORB's implementation of MOMA, the Message Oriented Middleware for Ada. * :ref:`GIOP` describes PolyORB's implementation of GIOP, the protocol defined as part of CORBA. * :ref:`SOAP` describes PolyORB's implementation of SOAP. * :ref:`Tools` describes PolyORB's tools. * :ref:`Performance` discusses possible configuration adjustments to optimize PolyORB's run time performance. * :ref:`Conformance` discusses the conformance of the PolyORB's personalities to the CORBA and SOAP standards. * :ref:`References` provides a list of useful references to complete this documentation. .. _Conventions: Conventions ~~~~~~~~~~~ .. index:: Conventions .. index:: Typographical 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:`File Names`, :file:`button names`, and :file:`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., :file:`parent-dir/subdir/myfile.adb`. If you are using GNAT on a Windows platform, please note that the '`\\`' character should be used instead.