summaryrefslogtreecommitdiff
path: root/TAO/docs/Options.html
diff options
context:
space:
mode:
Diffstat (limited to 'TAO/docs/Options.html')
-rw-r--r--TAO/docs/Options.html341
1 files changed, 0 insertions, 341 deletions
diff --git a/TAO/docs/Options.html b/TAO/docs/Options.html
deleted file mode 100644
index 4356cc40bfc..00000000000
--- a/TAO/docs/Options.html
+++ /dev/null
@@ -1,341 +0,0 @@
-<HTML>
-<HEAD>
- <META NAME="GENERATOR" CONTENT="Adobe PageMill 2.0 Mac">
- <TITLE>Options for TAO Components</TITLE>
-</HEAD>
-
-<BODY text = "#000000"
-link="#000fff"
-vlink="#ff0f0f"
-bgcolor="#ffffff">
-
-<HR><P>
-<H3 ALIGN=CENTER>Options for TAO Components</H3>
-
-<H3>Overview</H3>
-<blockquote>
-
-<P>Certain components in TAO such as the ORB Core or Object Adapter
-can be tuned by users by providing value for options or environment
-variables to them. These options are commonly specified as (1)
-environment variables or (2) strings passed on the command-line. They
-are generally passed to component initialization methods for
-consumption.</P>
-
-<P><EM>Programmer's Note:</EM> the internal structure for options is
-the traditional <CODE>argc</CODE>/<CODE>argv</CODE> vector of strings
-style popularized by C and Unix. By convention, an initialization
-method will consume, <EM>i.e.</EM>, remove from the vector, any
-options that it recognizes.</P> </blockquote>
-
-<HR><P>
-<H3>Environment Variables</H3>
-
-The following environment variables are supported by TAO:
-
-<BLOCKQUOTE>
-<P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0" >
-<TR>
-<TH>Environment Variable</TH>
-<TH>Description</TH></TR>
-<TR>
-<TD><CODE>NameServiceIOR</CODE> <EM>which</EM></TD>
-<TD>
-Specifies which IOR the Naming Service is listening on.
-</TD></TR>
-<TR>
-<TD><CODE>NameServicePort</CODE> <EM>which</EM></TD>
-<TD>
-Specifies which port the Naming Service is listening on.
-</TD></TR>
-<TR>
-<TD><CODE>TradingServiceIOR</CODE> <EM>which</EM></TD>
-<TD>
-Specifies which IOR the Trading Service is listening on.
-</TD></TR>
-<TR>
-<TD><CODE>TradingServicePort</CODE> <EM>which</EM></TD>
-<TD>
-Specifies which port the Trading Service is listening on.
-</TD></TR>
-<TR>
-<TD><CODE>TAO_ORB_DEBUG</CODE> <EM>which</EM></TD>
-<TD>
-Enables TAO debugging mode.
-</TD></TR>
-</TABLE>
-</P>
-</BLOCKQUOTE>
-
-<HR><P>
-
-<H3>Types of Options</H3>
-
-<blockquote>
-<P>The following components can be tuned via options:</P>
-
-<UL>
- <LI><A HREF="#ORB"><CODE>CORBA::ORB</CODE></A>
- <LI><A HREF="#POA"><CODE>CORBA::POA</CODE></A>
- <LI><A HREF="#ResourceFactory"><CODE>TAO_Resource_Factory</CODE></A>
- <LI><A HREF="#DefaultServer"><CODE>TAO_Default_Server_Strategy_Factory</CODE></A>
- <LI><A HREF="#DefaultClient" TARGET="_top"><CODE>TAO_Default_Client_Strategy_Factory</CODE></A>
-</UL>
-</blockquote>
-
-<blockquote>
-<H3><CODE>CORBA::ORB</CODE><A NAME="ORB"></A></H3>
-
-<blockquote>
-<P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING=
-"0">
-<TR>
-<TH>Option</TH>
-<TH>Description</TH></TR>
-<!-- <TR NAME="ORBsvcconf"> -->
-<TD><CODE>-ORBsvcconf</CODE> <EM>config file name</EM></TD>
-<TD>Specifies the name of the file from which it will read dynamic service configuration
-directives <EM>ala</EM> ACE's Service Configurator.</TD></TR>
-<TD><CODE>-ORBsvcconfdirective</CODE> <EM>directivestring</EM></TD>
-<TD>Specifies a service configuration
-directive, which is passed to ACE's Service Configurator.</TD></TR>
-<TR>
-<TD><CODE>-ORBdaemon</CODE></TD>
-<TD>Specifies that the ORB should <I>daemonize</I> itself.</TD></TR>
-<TR>
-<TD><CODE>-ORBdebug</CODE></TD>
-<TD>Turns on the output of debugging messages within ACE's Service Configurator
-componentry.</TD></TR>
-<TR>
-<TD><CODE>-ORBhost</CODE> <EM>hostname</EM></TD>
-<TD><a name="-ORBhost"></a>Tells the Object Adapter to listen for requests on the interface associated
-with the host named <I><EM>hostname</EM></I>.</TD></TR>
-<TR>
-<TD><CODE>-ORBport</CODE> <EM>portspec</EM></TD>
-<TD>Tells the Object Adapter to listen for requests on the port specified by
-<I><EM>portspec</EM></I>, which can be a name as found in <TT>/etc/services</TT>
-or a number. The default is <TT>10013</TT>.</TD></TR>
-<TR>
-<TD><CODE>-ORBobjrefstyle</CODE> <EM>which</EM></TD>
-<TD>Specifies the user-visible style of object references. The range of values
-is <CODE>IOR</CODE>, which is the traditional nonsensical object reference,
-or <CODE>URL</CODE>, which looks more like a URL.</TD></TR>
-<TR>
-<TD><CODE>-ORBtablesize</CODE> <EM>object table size</EM></TD>
-<TD>Specifies the size of the object table as a positive, non-zero integer.
-If not specified, the default is <TT>64</TT>.</TD></TR>
-<TR>
-<TD><CODE>-ORBrcvsock</CODE> <EM>receive buffer size</EM></TD>
-<TD><A NAME="-ORBrcvsock"></a>Specify the size of the socket receive buffer as a positive, non-zero integer.
-If not specified, the system-dependent default is used.</TD></TR>
-<TR>
-<TD><CODE>-ORBsndsock</CODE> <EM>send buffer size</EM></TD>
-<TD><A NAME="-ORBsndsock"></a>Specify the size of the socket send buffer as a positive, non-zero integer.
-If not specified, the system-dependent default is used.</TD></TR>
-<TR>
-<TD><CODE>-ORBnameserviceport</CODE> <EM>portspec</EM></TD>
-<TD>Specifies which port the Naming Service is listening on.</TD></TR>
-<TR>
-<TD><CODE>-ORBnameserviceior</CODE> <EM>ior</EM></TD>
-<TD>Specifies the IOR for the Naming Service.</TD></TR>
-<TR>
-<TD><CODE>-ORBcollocation</CODE> <EM>yes/no</EM></TD>
-<TD>Specifies the use of collocation object optimization. Default is yes.</TD></TR>
-<TR>
-<TD><CODE>-ORBpreconnect</CODE> <EM>host</EM><STRONG>:</STRONG><EM>port</em>[<STRONG>,</STRONG><EM>host</EM><STRONG>:</STRONG><EM>port</em>...]</TD>
-<TD><A name="-ORBpreconnect"></a>Pre-establishes a blocking connection to each listed
-<em>host</em>:<em>port</em> 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.</TD></TR>
-<TR>
-<TD><CODE>-ORBCDRtradeoff</CODE> <EM>maxsize</EM></TD>
-<TD><A name="-ORBCDRtradeoff"></a>Control the strategy to tradeoff
-between copy vs no copy marshalling of octet sequences.
-If an octet sequence is smaller than <EM>maxsize</EM> and the current
-message block contains enough space for it the octet sequence is
-copied instead of appended to the CDR stream.</TD></TR>
-<TR>
-<TD><CODE>-ORBiioplite</CODE></TD>
-<TD><A name="-ORBiioplite"></a>Enable a lightweight version of the
- IIOP protocol. This protocol removes some of the fields in
- the GIOP and the Request header. It only works on
- homogenous environments..</TD></TR>
-<TR>
-<TD><CODE>-ORBdotteddecimaladdresses</CODE> <EM>boolean (0 / 1)</EM></TD>
-<TD><A name="-ORBdotteddecimaladdresses"></a> Use the dotted decimal
- notation for addresses.</TD></TR>
-</TABLE>
-</P>
-</blockquote>
-
-<H3><CODE>CORBA::POA</CODE><A NAME="POA"></A></H3>
-
-<blockquote>
-<P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
-<TR>
-<TH>Option</TH>
-<TH>Description</TH></TR>
-<TR>
-<TD><CODE>-OAid</CODE> <EM>OA Identifier</EM></TD>
-<TD>Associates <I><EM>OA Identifier</EM></I> with the Object Adapter.</TD></TR>
-</TABLE>
-</P>
-</blockquote>
-
-<H3><CODE>TAO_Resource_Factory</CODE><A NAME="ResourceFactory"></A></H3>
-
-<blockquote>
-<P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
-<TR>
-<TH>Option</TH>
-<TH>Description</TH></TR>
-<TR>
-<TD><CODE>-ORBresources</CODE> <EM>which</EM></TD>
-<TD>Specify whether each thread uses a global
-(<em>which</em> = <code>global</code>) or a thread-specific
-(<em>which</em> = <code>tss</code>) instance for the resources it returns.</TD></TR>
-<TR>
-<TD><CODE>-ORBpoa</CODE> <EM>which</EM></TD>
-<TD><a name="-ORBpoa"></a>Specify whether each thread uses a global
-(<em>which</em> = <code>global</code>) or a thread-specific
-(<em>which</em> = <code>tss</code>) instance for the Root POA.</TD></TR>
-<TR>
-<TD><CODE>-ORBreactorlock</CODE> <EM>which</EM></TD>
-<TD><a name="-ORBcoltable"></a>Specify whether the ORB reactor is thread-safe
-(<em>which</em> = <code>token</code>) or not
-(<em>which</em> = <code>null</code>). Default is <code>token</code></TD></TR>
-<TR>
-<TD><CODE>-ORBcoltable</CODE> <EM>which</EM></TD>
-<TD><a name="-ORBcoltable"></a>Specify whether each ORB uses a global
-(<em>which</em> = <code>global</code>) or a per-ORB
-(<em>which</em> = <code>orb</code>) collocation table.</TD></TR>
-<TR>
-<TD><CODE>-ORBinputcdrallocator</CODE> <EM>which</EM></TD>
-<TD><a name="-ORBinputcdrallocator"></a>
- Specify whether the ORB uses a global
- (<em>which</em> = <code>global</code>)
- or a per-thread (<em>which</em> = <code>tss</code>)
- allocator for the incoming CDR buffers.
- The default is <CODE>tss</CODE> and should give the
- optimal performance;
- unless the user takes advantage of the features in TAO
- to keep the CDR stream buffer after the upcall.
- </TD></TR>
-</TABLE>
-</P>
-</blockquote>
-
-<H3><CODE>TAO_Default_Server_Strategy_Factory</CODE><A NAME="DefaultServer"></A></H3>
-
-<blockquote>
-<P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0" >
-<TR>
-<TH>Option</TH>
-<TH>Description</TH></TR>
-<TR>
-<TD><CODE>-ORBconcurrency</CODE> <EM>which</EM></TD>
-<TD>Specify which concurrency strategy to use. Range of values is <code>reactive</code>
-for a purely Reactor-driven concurrency strategy or
-<code>thread-per-connection</code> for creating a new thread to service each connection.</TD></TR>
-<TR>
-<TD><CODE>-ORBtablesize</CODE> <EM>object table size</EM></TD>
-<TD>Specify the size of the object table. If not specified, the default value
-is 64.</TD></TR>
-<TR>
-
-<TD><CODE>-ORBuseridpolicydemuxstrategy</CODE> <EM>user id policy
-based demultiplexing strategy</EM></TD> <TD>Specify the demultiplexing
-lookup strategy to be used with the user id policy. The
-<EM>demultiplexing strategy</EM> can be one of <CODE>dynamic</CODE>,
-<CODE>linear</CODE>, or <CODE>user</CODE>. This option defaults to
-use the <CODE>dynamic</CODE> strategy. </TD></TR> <TR>
-
-<TD><CODE>-ORBsystemidpolicydemuxstrategy</CODE> <EM>system id policy
-based demultiplexing strategy</EM></TD> <TD>Specify the demultiplexing
-lookup strategy to be used with the system id policy. The
-<EM>demultiplexing strategy</EM> can be one of <CODE>dynamic</CODE>,
-<CODE>linear</CODE>, <CODE>active</CODE>, or <CODE>user</CODE>. This
-option defaults to use the <CODE>active</CODE> strategy. </TD></TR>
-<TR>
-
-<TD><CODE>-ORBuniqueidpolicyreversedemuxstrategy</CODE> <EM>unique id
-policy based reverse demultiplexing strategy</EM></TD> <TD>Specify the
-reverse demultiplexing lookup strategy to be used with the unique id
-policy. The <EM>reverse demultiplexing strategy</EM> can be one of
-<CODE>dynamic</CODE> or <CODE>user</CODE>. This option defaults to use
-the <CODE>dynamic</CODE> strategy. </TD></TR> <TR>
-
-<TD><CODE>-ORBthreadflags</CODE> <EM>thread flags</EM></TD>
-<TD>Specify the flags used for thread creation. Flags can be any
-logical-OR combination of <CODE>THR_DETACHED</CODE>,
-<CODE>THR_BOUND</CODE>, <CODE>THR_NEW_LWP</CODE>,
-<CODE>THE_SUSPENDED</CODE>.</TD></TR> <TR>
-
-<TD><CODE>-ORBpoalock</CODE> <EM>lock type</EM></TD> <TD><a
-name="-ORBpoalock"></a>Specify the type of lock to be used for POA
-accesses. Possible values for <em>lock type</em> are
-<code>thread</code>, which specifies that an inter-thread mutex is
-used to guarantee exclusive acccess, and <code>null</code>, which
-specifies that no locking be performed. The default is
-<code>thread</code>.</TD></TR> <TR>
-
-<TD><CODE>-ORBcoltbllock</CODE> <EM>lock type</EM></TD> <TD><a
-name="-ORBcoltbllock"></a>Specify the type of lock to be used for the
-global collocation table. Possible values for <em>lock type</em> are
-<code>thread</code>, which specifies that an inter-thread mutex is
-used to guarantee exclusive acccess, and <code>null</code>, which
-specifies that no locking be performed. The default is
-<code>thread</code>.</TD></TR> <TR>
-
-<TD><CODE>-ORBconnectorlock</CODE> <EM>lock type</EM></TD> <TD><a
-name="-ORBconnectorlock"></a>Specify the type of lock to be used by
-the connector. Possible values for <em>lock type</em> are
-<code>thread</code>, which specifies that an inter-thread mutex is
-used to guarantee exclusive acccess, and <code>null</code>, which
-specifies that no locking be performed. The default is
-<code>thread</code>.</TD></TR> <TR>
-
-<TD><CODE>-ORBpoamgrlock</CODE> <EM>lock type</EM></TD> <TD><a
-name="-ORBpoamgrlock"></a>Specify the type of lock to be used for POA
-Manager accesses. Possible values for <em>lock type</em> are
-<code>thread</code>, which specifies that an inter-thread mutex is
-used to guarantee exclusive acccess, and <code>null</code>, which
-specifies that no locking be performed. The default is
-<code>null</code>.</TD></TR>
-
-</TABLE>
-</P>
-</blockquote>
-
-<H3><CODE>TAO_Default_Client_Strategy_Factory</CODE><A NAME="DefaultClient"></A></H3>
-
-<BLOCKQUOTE>
-<P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0" >
-<TR>
-<TH>Option</TH>
-<TH>Description</TH></TR>
-<TR>
-<TD><CODE>-ORBiiopprofilelock</CODE> <EM>which</EM></TD>
-<TD>
-Specify, whether to use a lock for accessing the IIOP Profile or not.
-Default is <code>thread</code>, which means that a lock is used. The
-second option is <code>null</code>, which means a null lock is used.
-This makes sense in case of optiziations and is allowed when
-no forwarding is used or only a single threaded client.
-</TD></TR>
-<TR>
-<TD><CODE>-ORBclientconnectionhandler</CODE> <EM>MT / ST</EM></TD>
-<TD><A name="-ORBclientconnectionhandler"></a> ST means use the
-single-threaded client connection handler and MT means use the
-multi-threaded client connection handler .</TD></TR>
-</TABLE>
-</P>
-</BLOCKQUOTE>
-</blockquote>
-
-<P><HR><P>
-Back to the TAO <A HREF="components.html">components documentation</A>.
-
-<!--#include virtual="/~schmidt/cgi-sig.html" -->
-</HTML>