Browse Source

Add documentation comments for some chutney internal options

teor 7 years ago
parent
commit
762bb838ac
1 changed files with 25 additions and 19 deletions
  1. 25 19
      lib/chutney/TorNet.py

+ 25 - 19
lib/chutney/TorNet.py

@@ -702,6 +702,7 @@ class LocalNodeController(NodeController):
                     self._env['poll_launch_time_default']
             return False
 
+# XXX: document these options
 DEFAULTS = {
     'authority': False,
     'bridgeauthority': False,
@@ -761,27 +762,32 @@ class TorEnviron(chutney.Templating.Environ):
 
        Environment fields provided:
 
-          orport, controlport, socksport, dirport:
-          dir:
-          nick:
-          tor_gencert:
-          auth_passphrase:
-          torrc_template_path:
-          hs_hostname:
+          orport, controlport, socksport, dirport: *Port torrc option
+          dir: DataDirectory torrc option
+          nick: Nickname torrc option
+          tor_gencert: name or path of the tor-gencert binary
+          auth_passphrase: obsoleted by CookieAuthentication
+          torrc_template_path: path to chutney torrc_templates directory
+          hs_hostname: the hostname of the key generated by a hidden service
+          owning_controller_process: the __OwningControllerProcess torrc line,
+             or an empty string if tor should continue after the script exits
 
        Environment fields used:
-          nodenum
-          tag
-          orport_base, controlport_base, socksport_base, dirport_base
-          tor-gencert (note hyphen)
-          chutney_dir
-          tor
-          dir
-          hs_directory
-          nick (debugging only)
-          hs-hostname (note hyphen)
-
-       XXXX document the above.  Or document all fields in one place?
+          nodenum: chutney's internal node number for the node
+          tag: a short text string that represents the type of node
+          orport_base, controlport_base, socksport_base, dirport_base: the
+             initial port numbers used by nodenum 0. Each additional node adds
+             1 to the port numbers.
+          tor-gencert (note hyphen): name or path of the tor-gencert binary (if
+             present)
+          chutney_dir: directory of the chutney source code
+          tor: name or path of the tor binary
+          net_base_dir: path to the chutney net directory
+          hs_directory: name of the hidden service directory
+          nick: Nickname torrc option (debugging only)
+          hs-hostname (note hyphen): cached hidden service hostname value
+          controlling_pid: the PID of the controlling process. After this
+             process exits, the child tor processes will exit
     """
 
     def __init__(self, parent=None, **kwargs):