diff options
Diffstat (limited to 'TAO/orbsvcs/Naming_Service/README')
-rw-r--r-- | TAO/orbsvcs/Naming_Service/README | 63 |
1 files changed, 9 insertions, 54 deletions
diff --git a/TAO/orbsvcs/Naming_Service/README b/TAO/orbsvcs/Naming_Service/README index 509e3023530..f43590489d6 100644 --- a/TAO/orbsvcs/Naming_Service/README +++ b/TAO/orbsvcs/Naming_Service/README @@ -1,40 +1,26 @@ // $Id$ This directory contains the files that implement the TAO -Naming server. The TAO Naming Service uses IP Multicast to process +Naming Service. The TAO Naming Service uses IP Multicast to process client "resolve_initial_references()" requests. To Run: ====== -% Naming_Service [-ORBport port] +% Naming_Service [-ORBport port] [-ORBobjrefstyle url] [-ORBnameserviceport nsport] - [-o ior_output_file] - [-p pid_file_name] - [-s context_size] + [-s context_size] [-t time] - [-f persitence_file_name] Arguments: ========== port The ORB port. - nsport + nsport Multicast port. - - output_file - The name of the file, in which to store IOR of the - root Naming Service context. (This file can then be - used by clients instead of multicast, to obtain the - Naming Service IOR). - - pid_file_name - The name of the file, in which to store the process id - of the Naming Service server. - context_size Size of the hash table allocated upon the creation of the root Naming Context (if one is created). All @@ -45,43 +31,10 @@ Arguments: How long the server should listen for requests before exiting. - persistence_file_name - The name of the file to use to store/read from the - persistent state of the Naming Service. - Environment Variables: ===================== - NameServicePort - Multicast port to listen on for - "resolve_initial_references" requests. - -Persistence: -=========== -TAO Naming Service has an optional persistence capability. By -default, a non-persistent version of the Naming Service is used. -Supplying "-f" command-line option to the server causes a persistent -version of the Naming Service to run. - -The file, which name is supplied along with the "-f" option, is used to store the -persistent state of the Naming Service, i.e., all Naming Contexts and -all their bindings. When "-f" option is specified: - - 1. If the specified file does not exist, the file is created - and used to store the state of the Naming Service. An initial - (root) Naming Context is also created. - - 2. If the specified file exists, it is scanned and: - a) If any inconsistency is detected in the - stored state or the file is not recognized by - the Naming Service, the server exits. A - noncorrupted version of the file must be used. - - b) If no Naming Contexts exist, an initial - (root) Naming Context is created. - - c) If one or more Naming Contexts exist, the - state stored in the file becomes the state of - the Naming Service. + NameServicePort - Multicast port. Sample Run: ========== @@ -114,7 +67,7 @@ Multicast. This behavior can be overridden in the following ways: % client -ORBnameserviceior <iiop:1.0//tango:20000/P35194c690003809cRootPOA/child_poa/NameService> - 2. Set the environment variable `NameServiceIOR' (minus the + 2. Set the environment variable `NameService' (minus the quotes), as follows in csh or tcsh: % setenv NameServiceIOR <iiop:1.0//tango:20000/P35194c690003809cRootPOA/child_poa/NameService> @@ -128,9 +81,11 @@ These two techniques may be needed in an environment where 1. There is more than one NamingService, to avoid the confusion of a server registering its object with one NamingService and the client getting the reply from some - other NamingService. + other NamingService. 2. The OS platform doesn't support multicast. 3. The client or server isn't written using TAO, and therefore doesn't use TAO's multicast NameService resolution protocol. + + |