[tor-bugs] #1993 [Tor Relay]: Documentation of BridgeRelay and PublishServerDescriptor is incorrect

Tor Bug Tracker & Wiki torproject-admin at torproject.org
Fri Oct 1 17:53:06 UTC 2010


#1993: Documentation of BridgeRelay and PublishServerDescriptor is incorrect
--------------------------------+-------------------------------------------
 Reporter:  rransom             |        Type:  defect   
   Status:  new                 |    Priority:  normal   
Milestone:  Tor: 0.2.2.x-final  |   Component:  Tor Relay
  Version:                      |    Keywords:           
   Parent:                      |  
--------------------------------+-------------------------------------------
 The descriptions of the !BridgeRelay and !PublishServerDescriptor options
 in the tor(1) man page are no longer correct.

  * !BridgeRelay is not ‘Usually used in combination with
 !PublishServerDescriptor’ anymore, because the !PublishServerDescriptor
 option is not in the sample torrc in the Tor distribution.
  * The main effect of the !BridgeRelay option is now to cause a relay to
 publish a bridge descriptor to the bridge authority (rather than a relay
 descriptor to the public directory authorities), not to influence ‘how the
 relay will cache and serve directory information’.
  * Based on the syntax specified for !PublishServerDescriptor, it appears
 to control publication of ''all'' things called descriptors -- not just
 relay descriptors, as the documentation suggests, but also bridge
 descriptors and hidden service descriptors.
  * In particular, the ‘hidserv’ flag to !PublishServerDescriptor appears
 to be considered even for Tor instances that do not define ORPort.

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


More information about the tor-bugs mailing list