[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]
[tor-bugs] #21058 [- Select a component]: Manual Modifications: Correction and Improvement
#21058: Manual Modifications: Correction and Improvement
--------------------------------------+-----------------
Reporter: agd | Owner:
Type: defect | Status: new
Priority: Medium | Milestone:
Component: - Select a component | Version:
Severity: Normal | Keywords:
Actual Points: | Parent ID:
Points: | Reviewer:
Sponsor: |
--------------------------------------+-----------------
Please modify the Manual as follows: 1) At StrictNodes: A) Please change
"will treat" to "treats '''solely'''"; B) At the end of the first
sentence, please add "(StrictNodes applies to neither ExcludeExitNodes nor
to ExitNodes)"; 2) At ExcludeExitNodes, please bold "'''outside'''" 3) At
ExitNodes: A) please bold both usages of "'''outside'''"; B) In the third
paragraph, to the end of the second sentence, please add: "(i.e. Onion
Circuits shows third nodes which DO NOT ''EXIT'' the Tor network, but are
used exclusively internally by Tor)".
For further discussion of this,
https://tor.stackexchange.com/questions/13134 has some relevance.
It is imperative, in order to maintain user trust in Tor, that the manual
accurately and precisely describe Tor's behavior.
'''PLEASE NOTE:''' I am uncertain if, in fact, StrictNodes applies
'''''solely''''' to ExcludeNodes; so please verify that as necessary. I am
quite certain regarding the other requested modification [1B] to
StrictNodes. All other requested modifications merely improve
understandability.
In-line, the above modifications would modify the relevant portions of the
Manual to read as follows [modifications offset by ">>" and "<<"]:
StrictNodes 0|1
If StrictNodes is set to 1, Tor >>treats '''solely'''<< the
ExcludeNodes option as a requirement to follow for all the circuits you
generate, even if doing so will break functionality for you >>(StrictNodes
applies to neither ExcludeExitNodes nor to ExitNodes)<<. If StrictNodes is
set to 0, Tor will still try to avoid nodes in the ExcludeNodes list, but
it will err on the side of avoiding unexpected errors. Specifically,
StrictNodes 0 tells Tor that it is okay to use an excluded node when it is
'''necessary''' to perform relay reachability self-tests, connect to a
hidden service, provide a hidden service to a client, fulfill a .exit
request, upload directory information, or download directory information.
(Default: 0)
ExcludeExitNodes node,node,…
A list of identity fingerprints, country codes, and address patterns
of nodes to never use when picking an exit node---that is, a node that
delivers traffic for you >>'''outside'''<< the Tor network. Note that any
node listed in ExcludeNodes is automatically considered to be part of this
list too. See the '''ExcludeNodes''' option for more information on how to
specify nodes. See also the caveats on the "ExitNodes" option below.
ExitNodes node,node,…
A list of identity fingerprints, country codes, and address patterns
of nodes to use as exit node---that is, a node that delivers traffic for
you >>'''outside'''<< the Tor network. See the '''ExcludeNodes''' option
for more information on how to specify nodes.
Note that if you list too few nodes here, or if you exclude too many
exit nodes with ExcludeExitNodes, you can degrade functionality. For
example, if none of the exits you list allows traffic on port 80 or 443,
you won’t be able to browse the web.
Note also that not every circuit is used to deliver traffic
>>'''outside'''<< of the Tor network. It is normal to see non-exit
circuits (such as those used to connect to hidden services, those that do
directory fetches, those used for relay reachability self-tests, and so
on) that end at a non-exit node >>(i.e. Onion Circuits shows third nodes
which DO NOT ''EXIT'' the Tor network, but are used exclusively internally
by Tor)<<. To keep a node from being used entirely, see ExcludeNodes and
StrictNodes.
The ExcludeNodes option overrides this option: any node listed in both
ExitNodes and ExcludeNodes is treated as excluded.
The .exit address notation, if enabled via AllowDotExit, overrides
this option.
--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/21058>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online
_______________________________________________
tor-bugs mailing list
tor-bugs@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs