diff options
Diffstat (limited to 'TAO/man/man7/TAO.7')
| -rw-r--r-- | TAO/man/man7/TAO.7 | 386 |
1 files changed, 0 insertions, 386 deletions
diff --git a/TAO/man/man7/TAO.7 b/TAO/man/man7/TAO.7 deleted file mode 100644 index 62439260be5..00000000000 --- a/TAO/man/man7/TAO.7 +++ /dev/null @@ -1,386 +0,0 @@ -.\" Process this file with -.\" groff -man -Tascii TAO.7 -.\" -.\" $Id$ -.\" -.TH TAO 7 "April 1999" "CORBA Tools" -.SH NAME -TAO \- The ACE ORB -.SH SYNOPSIS -.B TAO_Application -.B [ -.I TAO OPTIONS -.B ] -.SH DESCRIPTION -.B TAO -is a high performance real-time -.SM CORBA -.SM ORB. -All applications that use TAO can take advantage of the environment variables -and command line options described in this manual page. -.SH TAO ENVIRONMENT VARIABLES -.TP -.B NameServiceIOR -Specifies which IOR the TAO Naming Service is listening on. -.TP -.B NameServicePort -Specifies which port the TAO Naming Service is listening on. -.TP -.B TradingServiceIOR -Specifies which IOR the TAO Trading Service is listening on. -.TP -.B TradingServicePort -Specifies which port the Trading Service is listening on. -.TP -.B TAO_ORB_DEBUG -Enables TAO debugging mode. -.SH TAO OPTIONS -The following components can be tuned via options: -.IP -.B CORBA::ORB -.IP -.B TAO_Resource_Factory -.IP -.B TAO_Default_Server_Strategy_Factory -.IP -.B TAO_Default_Client_Strategy_Factory -.TP -.B CORBA::ORB -Typically, CORBA::ORB options are set via command line parameters, while the -rest of the options are set via the service configurator -.B (svc.conf) -file. -.IP -.BI \-ORBsvcconf \ config_file_name -\ \ Specifies the name of the file from which it will read dynamic service -configuration directives ala ACE's Service Configurator. -.IP -.BI \-ORBsvcconfdirective \ directivestring -\ \ Specifies a service configuration directive, which is passed to ACE's -Service Configurator. -.IP -.B \-ORBdaemon -\ \ Specifies that the ORB should daemonize itself. -.IP -.BI \-ORBdebug -\ \ Turns on the output of debugging messages within ACE's Service -Configurator componentry. -.IP -.BI \-ORBdebuglevel \ level -\ \ Control the level of debugging in the ORB. Higher number produce more -output (try 10). -.IP -.BI \-ORBhost \ hostname -\ \ Tells the Object Adapter to listen for requests on the interface associated with the host named -.I hostname. -.IP -.BI \-ORBport \ portspec -\ \ Tells the Object Adapter to listen for requests on the port specified by -.IR portspec , -which can be a name as found in -.B /etc/services -or a number. The default is 10013. -.IP -.BI \-ORBobjrefstyle \ IOR | URL -\ \ Specifies the user-visible style of object references. -.B IOR -is the traditional nonsensical object reference. -.B URL -makes the object reference look more like a URL. -.IP -.BI \-ORBtablesize \ object_table_size -\ \ Specifies the size of the object table as a positive, non-zero integer. If -not specified, the default is 64. -.IP -.BI \-ORBrcvsock \ receive_qabuffer_size -\ \ Specify the size of the socket receive buffer as a positive, non-zero -integer. If not specified, the system-dependent default is used. -.IP -.BI \-ORBsndsock \ send_buffer_size -\ \ Specify the size of the socket send buffer as a positive, non-zero -integer. If not specified, the system-dependent default is used. -.IP -.BI \-ORBnameserviceport \ portspec -\ \ Specifies which port the Naming Service is listening on. -.IP -.BI \-ORBnameserviceior \ IOR -\ \ Specifies the -.I IOR -for the Naming Service. -.IP -.BI \-ORBtradingserviceior \ IOR -\ \ Specifies the -.I IOR -for the Trading Service. -.IP -.BI \-ORBtradingserviceport \ portspec -\ \ Specifies which port the Trading Service is listening on. -.IP -.BI \-ORBcollocation \ yes | no -\ \ Specifies the use of collocation object optimization. Default is -.IR yes . -.IP -.BI \-ORBpreconnect \ host:port -.BR [, -.I host:port -.RB ... ] -\ \ Pre-establishes a blocking connection to each listed host:port combination. -If a connection cannot be established, a warning is announced and it continues -with the next listed. Listing the same combination multiple times will properly -establish multiple connections to that endpoint. -.IP -.BI \-ORBcdrtradeoff \ maxsize -\ \ Control the strategy to tradeoff between copy vs no copy marshalling of -octet sequences. If an octet sequence is smaller than maxsize and the current -message block contains enough space for it the octet sequence is copied instead -of appended to the CDR stream. -.IP -.B \-ORBgioplite -\ \ Enable a lightweight version of the GIOP protocol. This protocol removes -some of the fields in the GIOP and the Request header. It only works on -homogenous environments. -.IP -.BI \-ORBdotteddecimaladdresses \ boolean -(0/1) Use the dotted decimal notation for addresses. -.IP -.BI \-ORBInitRef\ ObjectId=IOR -\ \ Allows specification of an arbitrary object reference for an initial -service. The IOR could be in the one of the following formats: -.BR OMG\ IOR , \ URL \ or \ iioploc -form. -.B iioploc -is a multiple end-point IORs understood by -.B string_to_object\ () -and used as a boot-strapping mechanism by -.BR resolve_initial_references\ () . -The mappings specified through this argument override the -.B orb-install-time -defaults. -.IP -.BI \-ORBDefaultInitRef \ IOR_prefix -\ \ This argument allows resolution of initial references not explicitly -specified with -ORBInitRef. It requires a URL prefix that, after appending a -slash -.B '/' -and a simple object key, forms a new URL to identify an initial object -reference. The URL prefix format currently supported is iioploc. -.TP -.B TAO_Resource_Factory -.IP -.BI \-ORBresources \ global | tss -\ \ Specify whether each thread uses a global or a thread\-specific ( -.I tss -) instance for the resources it returns. -.IP -.BI \-ORBpoa \ global | tss -\ \ Specify whether each thread uses a global or a thread\-specific ( -.I tss -) instance for the Root POA. -.IP -.BI \-ORBreactorlock \ token | null -\ \ Specify whether the ORB reactor is thread\-safe ( -.I token -) or not ( -.I null -). Default is -.IR token . -.IP -.BI \-ORBcoltable \ global | orb -\ \ Specify whether each ORB uses a global or a per\-ORB ( -.I orb -) collocation table. -.IP -.BI \-ORBinputcdrallocator \ global | tss -\ \ Specify whether the ORB uses a global or a per\-thread ( -.I tss -) allocator for the incoming CDR buffers. Though -.I tss -should give the optimal performance; we made the default -.IR global . -TAO optimizations for octet sequences will not work when returning that data -type if the allocator is -.IR tss . -Using a -.I global -allocator also allows the users to take advantage of the TAO octet sequence -extensions to preserve the buffer after the upcall. -.TP -.B TAO_Default_Server_Strategy_Factory -.IP -.IR Note : -.B \-ORBdemuxstrategy -flag has been changed to -.B \-ORBsystemidpolicydemuxstrategy -and -.BR \-ORBuseridpolicydemuxstrategy . -.IP -.IR Note : -.B \-ORBtablesize -flag has been changed to -.BR \-ORBactiveobjectmapsize . -.IP -.BI \-ORBconcurrency \ reactive | thread\-per\-connection -\ \ Specify which concurrency strategy to use. Range of values is -.I reactive -for -a purely Reactor\-driven concurrency strategy or -.I thread\-per\-connection -for creating a new thread to service each connection. -.IP -.BI \-ORBactiveobjectmapsize \ active_object_map_size -\ \ Specify the size of the active object map. If not specified, the default -value is 64. -.IP -.BI \-ORBuseridpolicydemuxstrategy \ dynamic | linear -\ \ Specify the demultiplexing lookup strategy to be used with the user ID -policy. This option defaults to use the -.I dynamic -strategy. -.IP -.BI \-ORBsystemidpolicydemuxstrategy \ dynamic | linear | active -\ \ Specify the demultiplexing lookup strategy to be used with the system ID -policy. This option defaults to use the -.I active -strategy. -.IP -.BI \-ORBuniqueidpolicyreversedemuxstrategy \ dynamic | linear -\ \ Specify the reverse demultiplexing lookup strategy to be used with the -unique ID policy. This option defaults to use the -.I dynamic -strategy. -.IP -.BI \-ORBallowreactivationofsystemids \ 0 | 1 -\ \ Specify whether system ids can be reactivated, i.e., once an id that was -generated by the system has be deactivated, will the user reactivate a new -servant using the old ID. If the user is not going to use this feature, the -IORs can be shortened, an extra comparison in the critical upcall path removed, -and some memory on the server side can be saved. This option defaults to -.IR 1 . -.IP -.BI \-ORBactivehintinids \ 0 | 1 -\ \ Specify whether an active hint should be added to IDs. With active hints, -IDs can be found quickly. However, they lead to larger IORs. Note that this -option is disregarded if -.B \-ORBallowreactivationofsystemids -is set to -.IR 0 . -The -.B \-ORBactivehintinids -option can be -.IR 0 \ or \ 1 . -This option defaults to -.IR 1 . -.IP -.BI \-ORBpoamapsize \ poa_map_size -\ \ Specify the size of the POA map. If not specified, the default value is 24. -.IP -.BI \-ORBpersiententidpolicydemuxstrategy \ dynamic | linear -\ \ Specify the demultiplexing lookup strategy to be used with the persistent -ID policy. This option defaults to use the -.I dynamic -strategy. -.IP -.BI \-ORBtransientidpolicydemuxstrategy \ dynamic | linear | active -\ \ Specify the demultiplexing lookup strategy to be used with the transient ID -policy. This option defaults to use the -.I active -strategy. -.IP -.BI \-ORBactivehintinpoanames \ 0 | 1 -\ \ Specify whether an active hint should be added to POA names. With active -hints, POA names can be found quickly. However, they lead to larger IORs. This -option defaults to -.IR 1 . -.IP -.BI \ -ORBthreadflags \ thread_flags -\ \ Specify the flags used for thread creation. Flags can be any logical\-OR -combination of -.BR THR_DETACHED , -.BR THR_BOUND , -.B THR_NEW_LWP -and -.BR THR_SUSPENDED . -.IP -.BI \-ORBpoalock \ thread | null -\ \ Specify the type of lock to be used for POA accesses. -.I thread -specifies that an inter\-thread mutex is used to guarantee exclusive -access and -.I null -specifies that no locking be performed. The default is -.IR thread . -.IP -.BI \-ORBcoltbllock \ thread | null -\ \ Specify the type of lock to be used for the global collocation table. -.I thread -specifies that an inter\-thread mutex is used to guarantee exclusive access -and -.I null -specifies that no locking be performed. The default is -.IR thread . -.IP -.BI \-ORBconnectorlock \ thread | null -\ \ Specify the type of lock to be used by the connector. -.I thread -specifies that an inter\-thread mutex is used to guarantee exclusive access -and -.I null -specifies that no locking be performed. The default is -.IR thread . -.TP -.B TAO_Default_Client_Strategy_Factory -.IP -.BI \-ORBiiopprofilelock \ thread | null -\ \ Specify, whether to use a lock for accessing the IIOP Profile or not. -Default is -.IR thread , -which means that a lock is used. The second option is -.IR null , -which means a -.B null -lock is used. This makes sense in case of optimizations and is allowed when no -forwarding is used or only a single\-threaded client. -.IP -.BI \-ORBclientconnectionhandler \ MT | ST | RW -.IP -.I MT -means use the multi\-threaded client connection handler which uses the leader -follower model. This model allows the use of multiple threads with a single -Reactor. -.IP -.I ST -means use the single\-threaded client connection handler, i.e., the leader -follower model will not be used. However, -.I ST -does support nested upcalls and handling of new requests while waiting for the -reply from a server. -.IP -.I RW -selects a strategy that simply blocks in -.B recv() -when waiting for a response from the server instead of waiting in the Reactor. -The -.I RW -strategy only works when the application does not have to worry about new -request showing up when waiting for a response. Therefore, this strategy is -appropriate only for "pure" clients. Note that applications with nested upcalls -are not "pure" clients. Also note that this strategy will only effect two way -calls, since there is no waiting for one way calls. This strategy can also be -used in an application that is both a client and a server if the server side is -handled by a separate thread and the client threads are "pure" clients. -.IP -Default for this option is -.IR MT . -.SH AUTHORS -Center for Distributed Object Computing <http://www.cs.wustl.edu/~schmidt/doc-center.html> -.SH "SEE ALSO" -.BR TAO_Concurrency_Service (1), -.BR TAO_CosEvent_Service (1), -.BR TAO_Event_Service (1), -.BR TAO_ImplRepo_Service (1), -.BR TAO_LifeCycle_Service (1), -.BR TAO_Logging_Service (1), -.BR TAO_Naming_Service (1), -.BR TAO_Scheduling_Service (1), -.BR TAO_Time_Service (1), -.BR TAO_Trading_Service (1) |