diff options
author | teor <teor2345@gmail.com> | 2018-05-02 11:29:48 +1000 |
---|---|---|
committer | teor <teor2345@gmail.com> | 2018-05-02 11:29:48 +1000 |
commit | d96ddf8f1b143934077bc4c1f54fa8a38087e342 (patch) | |
tree | d0dbdf0a0e6313c2edd9aceb1ab35927d4f9ae8b /doc/tor.1.txt | |
parent | 4a7590c241dbb86571de670fec3f143d27f15cb7 (diff) | |
download | tor-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.txt | 33 |
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 |