[tor-bugs] #13005 [Tor Browser]: Please document Tor Browser environment variables

[Tor Bug Tracker & Wiki]

#13005: Please document Tor Browser environment variables
-----------------------------+----------------------
     Reporter:  mttp         |      Owner:  tbb-team
         Type:  defect       |     Status:  new
     Priority:  normal       |  Milestone:
    Component:  Tor Browser  |    Version:
   Resolution:               |   Keywords:
Actual Points:               |  Parent ID:
       Points:               |
-----------------------------+----------------------

Comment (by mttp):

 Replying to [comment:2 mcs]:
 > Here is some info about the less commonly used env variables that are
 supported by Tor Launcher:
 >
 > TOR_SKIP_LAUNCH - if set to 1, do not start a tor process, and, unless
 TOR_CONFIGURE_ONLY is set to 1, do to not try to configure Tor (that is,
 do not make a control port connection).  Values other than 1 have no
 effect.
 >
 > TOR_CONFIGURE_ONLY - if set to 1, do not start Tor but try to connect
 via the control port to configure Tor.  Also, Tor Launcher will not try to
 become the primary controller.  Values other than 1 have no effect.
 >
 > TOR_FORCE_NET_CONFIG - if set to 1, display the Tor Network Settings
 wizard at startup (the value of the
 extensions.torlauncher.prompt_at_startup hidden preference is ignored).
 Values other than 1 have no effect.  Used by Tails.


 Thanks for replying so quickly Mark. Some questions I still have:

 Does TOR_TRANSPROXY do anything that TOR_SKIP_LAUNCH doesn't do?

 Am I correct in thinking that you added a new environment variable
 recently to hide the Tor Logo if set to 1?

 Is the default value of TOR_CONTROL_PASSWD the empty string?

 What is the default value of TOR_CONTROL_COOKIE_AUTH_FILE?

 I'm not sure I understand what you mean by "Also, Tor Launcher will not
 try to become the primary controller." in describing the
 TOR_CONFIGURE_ONLY option. Maybe I'm just unfamiliar the idea of a primary
 (versus secondary?) Tor controller.

 Thanks in advance.

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/13005#comment:3>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online