aboutsummaryrefslogtreecommitdiff
path: root/doc/tor.1.txt
diff options
context:
space:
mode:
authorteor <teor2345@gmail.com>2018-05-02 11:29:48 +1000
committerteor <teor2345@gmail.com>2018-05-02 11:29:48 +1000
commitd96ddf8f1b143934077bc4c1f54fa8a38087e342 (patch)
treed0dbdf0a0e6313c2edd9aceb1ab35927d4f9ae8b /doc/tor.1.txt
parent4a7590c241dbb86571de670fec3f143d27f15cb7 (diff)
downloadtor-d96ddf8f1b143934077bc4c1f54fa8a38087e342.tar.gz
tor-d96ddf8f1b143934077bc4c1f54fa8a38087e342.zip
man page: FetchUselessDescriptors and DirCache exclude extra infos
Diffstat (limited to 'doc/tor.1.txt')
-rw-r--r--doc/tor.1.txt33
1 files changed, 20 insertions, 13 deletions
diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index f003311d9c..53a8c8fe56 100644
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -540,16 +540,21 @@ GENERAL OPTIONS
(Default: 1)
[[FetchUselessDescriptors]] **FetchUselessDescriptors** **0**|**1**::
- If set to 1, Tor will fetch every consensus flavor, descriptor, and
- certificate that it hears about. Otherwise, it will avoid fetching useless
- descriptors: flavors that it is not using to build circuits, and authority
- certificates it does not trust. Tor stops fetching descriptors if it
- hasn't built any circuits lately: this option makes Tor keep fetching
- descriptors, even when idle. This option is useful if you're using a
+ If set to 1, Tor will fetch every consensus flavor, and all server
+ descriptors and authority certificates referenced by those consensuses,
+ except for extra info descriptors. When this option is 1, Tor will also
+ keep fetching descriptors, even when idle.
+ If set to 0, Tor will avoid fetching useless descriptors: flavors that it
+ is not using to build circuits, and authority certificates it does not
+ trust. When Tor hasn't built any application circuits, it will go idle,
+ and stop fetching descriptors. This option is useful if you're using a
tor client with an external parser that uses a full consensus.
- This option fetches all documents, **DirCache** fetches and serves
- all documents, **UseMicrodescriptors 0** fetches full descriptors and uses
- them to build circuits. (Default: 0)
+ This option fetches all documents except extrainfo descriptors,
+ **DirCache** fetches and serves all documents except extrainfo
+ descriptors, **DownloadExtraInfo*** fetches extrainfo documents, and serves
+ them if **DirCache** is on, and **UseMicrodescriptors** changes the
+ flavour of consensues and descriptors that is fetched and used for
+ building circuits. (Default: 0)
[[HTTPProxy]] **HTTPProxy** __host__[:__port__]::
Tor will make all its directory requests through this host:port (or host:80
@@ -2392,10 +2397,12 @@ details.)
some entry in the policy is accepted.
[[DirCache]] **DirCache** **0**|**1**::
- When this option is set, Tor caches all current directory documents and
- accepts client requests for them. Setting DirPort is not required for this,
- because clients connect via the ORPort by default. Setting either DirPort
- or BridgeRelay and setting DirCache to 0 is not supported. (Default: 1)
+ When this option is set, Tor caches all current directory documents except
+ extra info documents, and accepts client requests for them. If
+ **DownloadExtraInfo** is set, cached extra info documents are also cached.
+ Setting **DirPort** is not required for **DirCache**, because clients
+ connect via the ORPort by default. Setting either DirPort or BridgeRelay
+ and setting DirCache to 0 is not supported. (Default: 1)
[[MaxConsensusAgeForDiffs]] **MaxConsensusAgeForDiffs** __N__ **minutes**|**hours**|**days**|**weeks**::
When this option is nonzero, Tor caches will not try to generate