Beginning of updating for configuration.

1 files changed, 173 insertions, 130 deletions

diff --git a/TAO/docs/configurations.html b/TAO/docs/configurations.html
index 288be71d330..d8132f8e797 100644
--- a/TAO/docs/configurations.html
+++ b/TAO/docs/configurations.html
@@ -32,146 +32,189 @@
       <P>Details for the following configurations are provided.</P>
 
       <UL>
-	<LI><A HREF="#"><CODE>CORBA::ORB</CODE></A>
-	<LI><A HREF="#"><CODE>CORBA::POA</CODE></A>
-	<LI><A HREF="#"><CODE>TAO_Resource_Factory</CODE></A>
-	<LI><A HREF="#"><CODE>TAO_Default_Server_Strategy_Factory</CODE></A>
-	<LI><A HREF="#"><CODE>TAO_Default_Client_Strategy_Factory</CODE></A>
+	<LI><A HREF="#reactive">Single-threaded, reactive model.</A>
+	<LI><A HREF="#tpc">Multiple threads, thread-per-connection model.</A>
+	<LI><A HREF="#multiorb">Multiple threads, orb-per-thread model.</A>
+	<LI><A HREF="#multiorb-tpc">Multiple threads, orb-per-thread, thread-per-connection.</A>
       </UL>
+
+      <p>Each configuration has the following information:</p>
+
+      <p>
+      <table border=2 width="100%" cellspacing="2" cellpadding="0">
+	<tr>
+	  <th>Typical Use</th>
+	  <td>
+	    This is definitely the most common use of an ORB in a
+	    server situation, where there is a single thread handling
+	    requests from multiple clients.
+	  </td>
+	</tr>
+
+	<tr>
+	  <th>Number Threads</th>
+	  <td>1</td>
+	</tr>
+
+	<tr>
+	  <th>Thread Creator</th>
+	  <td>Operating System or whoever creates the main thread in a process.</td>
+	</tr>
+
+	<tr>
+	  <th>Resource Location</th>
+	  <td>Resources are stored process-wide.</td>
+	</tr>
+
+	<tr>
+	  <th>Thread task</th>
+	  <td>The single thread processes all connection requests and CORBA messages.</td>
+	</tr>
+      </table>
+      </p>
+
     </blockquote>
 
-    <H2>Options</H2>
+    <H2>Configurations</H2>
 
     <blockquote>
-      <H3><CODE>CORBA::ORB</CODE><A NAME="ORB"></A></H3>
-
-<P><TABLE BORDER="2" WIDTH="100%" HEIGHT="96" CELLSPACING="2" CELLPADDING=
-"0">
-<TR>
-<TH WIDTH="43%" HEIGHT="17">Option</TH>
-<TH WIDTH="57%">Description</TH></TR>
-<TR>
-<TD HEIGHT="30"><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>
-<TR>
-<TD HEIGHT="17"><CODE>-ORBdaemon</CODE></TD>
-<TD>Specifies that the ORB should <I>daemonize</I> itself.</TD></TR>
-<TR>
-<TD HEIGHT="17"><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>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>-ORBobjdemux</CODE> <EM>demux_method</EM></TD>
-<TD>Specifies the method used to demultiplex to an object. The range of values
-is <CODE>dynamic</CODE>, <CODE>linear</CODE>, <CODE>active</CODE>, or <CODE>user</CODE>.</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>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>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>-OAthread</CODE></TD>
-<TD>Specify a thread-per-connection concurrency policy be utilized in processing
-requests.</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>
-</TABLE>
-</P>
-
-<H3><CODE>CORBA::POA</CODE><A NAME="POA"></A></H3>
-
-<P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0" WIDTH="100%">
-<TR>
-<TH WIDTH="43%">Option</TH>
-<TH WIDTH="55%">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>
-
-<H3><CODE>TAO_Resource_Factory</CODE><A NAME="ResourceFactory"></A></H3>
-
-<P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0" WIDTH="100%" HEIGHT=
-"186">
-<TR>
-<TH WIDTH="43%" HEIGHT="17">Option</TH>
-<TH WIDTH="55%">Description</TH></TR>
-<TR>
-<TD HEIGHT="43"><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>
-</TABLE>
-</P>
-
-<H3><CODE>TAO_Default_Server_Strategy_Factory</CODE><A NAME="DefaultServer"></A></H3>
-
-<P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0" WIDTH="100%" HEIGHT=
-"186">
-<TR>
-<TH WIDTH="43%" HEIGHT="17">Option</TH>
-<TH WIDTH="55%">Description</TH></TR>
-<TR>
-<TD HEIGHT="43"><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 HEIGHT="30"><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 HEIGHT="17"><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 HEIGHT="43"><CODE>-ORBdemuxstrategy</CODE> <EM>demultiplexing strategy</EM></TD>
-<TD>Specify the demultiplexing lookup strategy. The <EM>demultiplexing strategy</EM>
-can be one of <CODE>dynamic</CODE>, <CODE>linear</CODE>, <CODE>active</CODE>,
-or <CODE>user</CODE>.</TD></TR>
-</TABLE>
-</P>
-
-<H3><CODE>TAO_Default_Client_Strategy_Factory</CODE><A NAME="DefaultClient"></A></H3>
-
-<BLOCKQUOTE>
-  <P>There are currently no options for the <CODE>TAO_Default_Client_Strategy_Factory</CODE>.</P>
-</BLOCKQUOTE>
+
+      <H3>Single-threaded, reactive model.<A NAME="reactive"></A></H3>
+
+      <p>
+      <table border=2 width="100%" cellspacing="2" cellpadding="0">
+	<tr>
+	  <th>Typical Use</th>
+	  <td>A brief description of the scenario and its typical use.</td>
+	</tr>
+
+	<tr>
+	  <th>Number Threads</th>
+	  <td>The number of threads used by ORB-related activities.</td>
+	</tr>
+
+	<tr>
+	  <th>Thread Creator</th>
+	  <td>Identifies the creator of the threads discussed above.</td>
+	</tr>
+
+	<tr>
+	  <th>Resource Location</th>
+	  <td>Where information on various resources is stored.</td>
+	</tr>
+
+	<tr>
+	  <th>Thread task</th>
+	  <td>Describes what task is undertaken for each thread.</td>
+	</tr>
+      </table>
+      </p>
+
+      <H3>Multiple threads, thread-per-connection model.<A NAME="tpc"></A></H3>
+
+      <p>
+      <table border=2 width="100%" cellspacing="2" cellpadding="0">
+	<tr>
+	  <th>Typical Use</th>
+	  <td>A brief description of the scenario and its typical use.</td>
+	</tr>
+
+	<tr>
+	  <th>Number Threads</th>
+	  <td>The number of threads used by ORB-related activities.</td>
+	</tr>
+
+	<tr>
+	  <th>Thread Creator</th>
+	  <td>Identifies the creator of the threads discussed above.</td>
+	</tr>
+
+	<tr>
+	  <th>Resource Location</th>
+	  <td>Where information on various resources is stored.</td>
+	</tr>
+
+	<tr>
+	  <th>Thread task</th>
+	  <td>Describes what task is undertaken for each thread.</td>
+	</tr>
+      </table>
+      </p>
+
+      <H3>Multiple threads, orb-per-thread model.<A NAME="multiorb"></A></H3>
+
+      <p>
+      <table border=2 width="100%" cellspacing="2" cellpadding="0">
+	<tr>
+	  <th>Typical Use</th>
+	  <td>A brief description of the scenario and its typical use.</td>
+	</tr>
+
+	<tr>
+	  <th>Number Threads</th>
+	  <td>The number of threads used by ORB-related activities.</td>
+	</tr>
+
+	<tr>
+	  <th>Thread Creator</th>
+	  <td>Identifies the creator of the threads discussed above.</td>
+	</tr>
+
+	<tr>
+	  <th>Resource Location</th>
+	  <td>Where information on various resources is stored.</td>
+	</tr>
+
+	<tr>
+	  <th>Thread task</th>
+	  <td>Describes what task is undertaken for each thread.</td>
+	</tr>
+      </table>
+      </p>
+
+      <H3>Multiple threads, orb-per-thread, thread-per-connection.<A NAME="multiorb-tpc"></A></H3>
+
+      <p>
+      <table border=2 width="100%" cellspacing="2" cellpadding="0">
+	<tr>
+	  <th>Typical Use</th>
+	  <td>A brief description of the scenario and its typical use.</td>
+	</tr>
+
+	<tr>
+	  <th>Number Threads</th>
+	  <td>The number of threads used by ORB-related activities.</td>
+	</tr>
+
+	<tr>
+	  <th>Thread Creator</th>
+	  <td>Identifies the creator of the threads discussed above.</td>
+	</tr>
+
+	<tr>
+	  <th>Resource Location</th>
+	  <td>Where information on various resources is stored.</td>
+	</tr>
+
+	<tr>
+	  <th>Thread task</th>
+	  <td>Describes what task is undertaken for each thread.</td>
+	</tr>
+      </table>
+      </p>
+
+    </blockquote>
+
 </blockquote>
 
 <P><HR ALIGN=LEFT></P>
 
 <ADDRESS><A HREF="mailto:cleeland@cs.wustl.edu">Chris Cleeland</A></ADDRESS>
 
-<P><!-- Created: Fri Aug 29 10:06:40 CDT 1997 --><!-- hhmts start -->Last
-modified: Wed Sep 3 16:35:23 CDT 1997 <!-- hhmts end -->
+<P>
+<!-- Created: Fri Aug 29 10:06:40 CDT 1997 -->
+<!-- hhmts start -->
+Last modified: Mon Dec 15 20:23:56 CST 1997
+<!-- hhmts end -->
 </BODY>
 </HTML>