Browse Source

[1271] Updated the documentation for the changes

Stephen Morris 13 years ago
parent
commit
a0e6002f56
3 changed files with 45 additions and 10 deletions
  1. 15 1
      src/bin/bind10/bind10.8
  2. 14 0
      src/bin/bind10/bind10.xml
  3. 16 9
      src/bin/bind10/bind10_src.py.in

File diff suppressed because it is too large
+ 15 - 1
src/bin/bind10/bind10.8


+ 14 - 0
src/bin/bind10/bind10.xml

@@ -50,6 +50,7 @@
       <arg><option>-p <replaceable>data_path</replaceable></option></arg>
       <arg><option>-p <replaceable>data_path</replaceable></option></arg>
       <arg><option>-u <replaceable>user</replaceable></option></arg>
       <arg><option>-u <replaceable>user</replaceable></option></arg>
       <arg><option>-v</option></arg>
       <arg><option>-v</option></arg>
+      <arg><option>-w <replaceable>wait_time</replaceable></option></arg>
       <arg><option>--brittle</option></arg>
       <arg><option>--brittle</option></arg>
       <arg><option>--cmdctl-port</option> <replaceable>port</replaceable></arg>
       <arg><option>--cmdctl-port</option> <replaceable>port</replaceable></arg>
       <arg><option>--config-file</option> <replaceable>config-filename</replaceable></arg>
       <arg><option>--config-file</option> <replaceable>config-filename</replaceable></arg>
@@ -60,6 +61,7 @@
       <arg><option>--pretty-name <replaceable>name</replaceable></option></arg>
       <arg><option>--pretty-name <replaceable>name</replaceable></option></arg>
       <arg><option>--user <replaceable>user</replaceable></option></arg>
       <arg><option>--user <replaceable>user</replaceable></option></arg>
       <arg><option>--verbose</option></arg>
       <arg><option>--verbose</option></arg>
+      <arg><option>--wait <replaceable>wait_time</replaceable></option></arg>
     </cmdsynopsis>
     </cmdsynopsis>
   </refsynopsisdiv>
   </refsynopsisdiv>
 
 
@@ -211,6 +213,18 @@ The default is the basename of ARG 0.
         </listitem>
         </listitem>
       </varlistentry>
       </varlistentry>
 
 
+      <varlistentry>
+        <term><option>-w</option> <replaceable>wait_time</replaceable>, <option>--wait</option> <replaceable>wait_time</replaceable></term>
+        <listitem>
+          <para>Sets the amount of time that BIND 10 will wait for
+          the configuration manager (a key component of BIND 10) to
+          initialize itself before abandoning the start up and
+          terminating with an error.  The wait_time is specified in
+          seconds and has a default value of 10.
+          </para>
+        </listitem>
+      </varlistentry>
+
     </variablelist>
     </variablelist>
   </refsect1>
   </refsect1>
 
 

+ 16 - 9
src/bin/bind10/bind10_src.py.in

@@ -215,7 +215,7 @@ class BoB:
     
     
     def __init__(self, msgq_socket_file=None, data_path=None,
     def __init__(self, msgq_socket_file=None, data_path=None,
     config_filename=None, nocache=False, verbose=False, setuid=None,
     config_filename=None, nocache=False, verbose=False, setuid=None,
-    username=None, cmdctl_port=None, brittle=False, pwait_time=10):
+    username=None, cmdctl_port=None, brittle=False, wait_time=10):
         """
         """
             Initialize the Boss of BIND. This is a singleton (only one can run).
             Initialize the Boss of BIND. This is a singleton (only one can run).
         
         
@@ -223,11 +223,18 @@ class BoB:
             msgq process listens on.  If verbose is True, then the boss reports
             msgq process listens on.  If verbose is True, then the boss reports
             what it is doing.
             what it is doing.
 
 
-            Data path and config filename are passed trough to config manager
+            Data path and config filename are passed through to config manager
             (if provided) and specify the config file to be used.
             (if provided) and specify the config file to be used.
 
 
             The cmdctl_port is passed to cmdctl and specify on which port it
             The cmdctl_port is passed to cmdctl and specify on which port it
             should listen.
             should listen.
+
+            brittle is a debug option that controls whether the Boss shuts down
+            after any process dies.
+
+            wait_time controls the amount of time (in seconds) that Boss waits
+            for selected processes to initialize before continuing with the
+            initialization.  Currently this is only the configuration manager.
         """
         """
         self.cc_session = None
         self.cc_session = None
         self.ccs = None
         self.ccs = None
@@ -251,7 +258,7 @@ class BoB:
         self.config_filename = config_filename
         self.config_filename = config_filename
         self.cmdctl_port = cmdctl_port
         self.cmdctl_port = cmdctl_port
         self.brittle = brittle
         self.brittle = brittle
-        self.pwait_time = pwait_time
+        self.wait_time = wait_time
         self.sockcreator = None
         self.sockcreator = None
 
 
         # If -v was set, enable full debug logging.
         # If -v was set, enable full debug logging.
@@ -514,9 +521,9 @@ class BoB:
         self.processes[bind_cfgd.pid] = bind_cfgd
         self.processes[bind_cfgd.pid] = bind_cfgd
         self.log_started(bind_cfgd.pid)
         self.log_started(bind_cfgd.pid)
 
 
-        # Wait for the configuration manager to start up.  The amount of time
+        # Wait for the configuration manager to start up as subsequent initialization
-        # can be set on the command line.
+        # cannot proceed without it.  The time to wait can be set on the command line.
-        time_remaining = self.pwait_time
+        time_remaining = self.wait_time
         msg, env = self.cc_session.group_recvmsg()
         msg, env = self.cc_session.group_recvmsg()
         while time_remaining > 0 and not self.process_running(msg, "ConfigManager"):
         while time_remaining > 0 and not self.process_running(msg, "ConfigManager"):
             logger.debug(DBG_PROCESS, BIND10_WAIT_CFGMGR)
             logger.debug(DBG_PROCESS, BIND10_WAIT_CFGMGR)
@@ -989,8 +996,8 @@ def parse_args(args=sys.argv[1:], Parser=OptionParser):
                       help="file to dump the PID of the BIND 10 process")
                       help="file to dump the PID of the BIND 10 process")
     parser.add_option("--brittle", dest="brittle", action="store_true",
     parser.add_option("--brittle", dest="brittle", action="store_true",
                       help="debugging flag: exit if any component dies")
                       help="debugging flag: exit if any component dies")
-    parser.add_option("-w", "--wait", dest="pwait_time", type="int",
+    parser.add_option("-w", "--wait", dest="wait_time", type="int",
-                      default=10, help="Time to wait for config manager to start up")
+                      default=10, help="Time (in seconds) to wait for config manager to start up")
 
 
     (options, args) = parser.parse_args(args)
     (options, args) = parser.parse_args(args)
 
 
@@ -1094,7 +1101,7 @@ def main():
     boss_of_bind = BoB(options.msgq_socket_file, options.data_path,
     boss_of_bind = BoB(options.msgq_socket_file, options.data_path,
                        options.config_file, options.nocache, options.verbose,
                        options.config_file, options.nocache, options.verbose,
                        setuid, username, options.cmdctl_port, options.brittle,
                        setuid, username, options.cmdctl_port, options.brittle,
-                       options.pwait_time)
+                       options.wait_time)
     startup_result = boss_of_bind.startup()
     startup_result = boss_of_bind.startup()
     if startup_result:
     if startup_result:
         logger.fatal(BIND10_STARTUP_ERROR, startup_result)
         logger.fatal(BIND10_STARTUP_ERROR, startup_result)