From a653b5fa13537ae2868ecc5759c199ff4c83a045 Mon Sep 17 00:00:00 2001 From: schmidt Date: Sun, 18 May 2003 01:11:20 +0000 Subject: ChangeLogTag:Fri May 16 11:15:53 2003 Chad Elliott --- TAO/docs/Options.html | 66 +++++++++++++++++++++++++-------------------------- 1 file changed, 33 insertions(+), 33 deletions(-) diff --git a/TAO/docs/Options.html b/TAO/docs/Options.html index 4db7b05ef49..6e429ebae29 100644 --- a/TAO/docs/Options.html +++ b/TAO/docs/Options.html @@ -9,13 +9,13 @@

Table of Contents

+

Introduction

@@ -87,18 +87,18 @@ settings, resources, strategies, and factories can be specified via
  • Environment variables are limited to specifying the interoperable object reference (IOR) and port number of TAO's Naming -Service, Trading Service and Implementation Repository. They are very -limited in flexibility and dont provide the most important +Service, Trading Service and Implementation Repository. They are +limited in flexibility and don't provide the most important configuration hooks necessary to configure TAO for real-time and -high-performance applications.

    +high-performance applications.

  • Command-line options are passed to the ORB initialization factory method, CORBA::ORB_init(), by an application using the standard argc, argv tuple passed to the application's main(). Most of the options that can be exercised through environment variables can also be manipulated through command-line -options. The command-line options are preferred over environment -variables if there is a conflict.

    +options. Command-line options override the environment variable +settings if both are enabled.

  • The Service Configurator is a framework that can be used to statically and dynamically configure components into middleware and @@ -106,14 +106,15 @@ applications. The information comprising the names of these components and their corresponding options are specified in a service configurator file, whose default file name is svc.conf. The service configurator is opened and processed -by the ORB in CORBA::ORB_init(). The service configurator -processing is done after the command line options have been parsed.

    - +by the ORB in CORBA::ORB_init(). The service configurator +processing is done after all the command-line options have been parsed.

    -

    Choosing the Right Approach

    +

    Choosing the Right Approach

    TAO's command-line options are useful when there's a fixed set of configuration options, each of which has a predefined list of @@ -496,11 +497,7 @@ selection within a TAO application.

    multicast requests. By default, the TAO_DEFAULT_NAME_SERVICE_REQUEST_PORT (10013) value is used. - - - -"http://cvs.doc.wustl.edu/viewcvs.cgi/*checkout*/TAO/docs/ORBEndpoint.html?rev=HEAD">-ORBTradingServicePort portspec + -ORBTradingServicePort portspec Specifies to which port the Trading Service is listening on for multicast requests. By default, the TAO_DEFAULT_TRADING_SERVICE_REQUEST_PORT @@ -561,20 +558,20 @@ strategies, and resources that the ORB uses. By default, TAO provides the following set of factories:

      -
    1. Default Resource and Advanced Resource Factories : +
    2. Default Resource and Advanced Resource Factories. This factory controls the creation of configurable resources used by TAO's ORB core. The resource factory is responsible for constructing and providing access to various resources used by the ORB irrespective of whether they perform client or server roles. ORB resources include reactors, protocol factories, message flushing strategies, connection purging strategies and different IOR parsers.

      -

    3. Server Strategy Factory: This factory +
    4. Server Strategy Factory. This factory creates various strategies of special utility to the ORB that is useful for controlling the behavior of servers. This factory is responsible for creating strategies useful for server objects like the concurrency strategy and the request demultiplexing strategies used by the POA.

      -

    5. Client Strategy Factory: This factory +
    6. Client Strategy Factory. This factory creates various strategies of special utility to the ORB, useful for controlling the behavior of clients. This factory is responsible for creating strategies useful for clients such as request @@ -663,7 +660,7 @@ below:

      -
      (a). Resource_Factory
      +

      1.1. Resource_Factory

      Typically, the above options are exercised via the service configurator (svc.conf) file. The following line in the @@ -676,6 +673,8 @@ specified within the double quotes in the above directive. There is an href="http://cvs.doc.wustl.edu/viewcvs.cgi/TAO/tests/LongUpcalls/svc.conf?rev=HEAD"> online example of how this is used in TAO.

      +

      +

      @@ -705,8 +704,6 @@ online example of how this is used in TAO.

      By default the ORB can handle multiple string formats, including IOR:, corbaloc:, corbaname:, and file:. The application developer can - href="http://cvs.doc.wustl.edu/viewcvs.cgi/*checkout*/TAO/docs/ior_parsing.html?rev=HEAD">add new IOR formats using this option.

      @@ -793,9 +790,9 @@ online example of how this is used in TAO.

      blocking strategy flushes the queue as soon as it becomes "full", and blocks the thread until all the data is sent.

      -
      +
      -
      (b). Advanced_Resource_Factory
      +

      1.2. Advanced_Resource_Factory

      This factory is located in the TAO_Strategies library. It accepts the options below as well as those described above in the @@ -887,7 +884,7 @@ default. The Advanced Resource Factory will emit an error if you attempt its use.

      -

      3. Server_Strategy_Factory

      +

      2. Server_Strategy_Factory

      Certain elements of the ORB relate only to a TAO server. In this context, the server is any application that passively accepts @@ -913,6 +910,7 @@ example is available online that shows how to specify this option in the svc.conf file.

      +

      @@ -1030,8 +1028,9 @@ ids which specifies that an inter-thread mutex is used to guarantee exclusive access, and null, which specifies that no locking be performed. The default is thread.

      +
      -

      5. Client_Strategy_Factory

      Similar to the +

      3. Client_Strategy_Factory

      Similar to the server strategy factory, the client strategy factory supports those elements of TAO that are specific to the behavior of clients, which are any CORBA applications that actively establish connections, submit @@ -1048,6 +1047,7 @@ the options listed within "". An example is available online that shows how to specify this option in the svc.conf file.

      +

      @@ -1105,4 +1105,4 @@ that shows how to specify this option in the svc.conf file.

      Finally, the blocked strategy as the name implies, blocks the thread until connection is complete. Some of the protocols in TAO (such as SHMIOP and SSLIOP) can only use the blocked strategy. -

      +

      -- cgit v1.2.1