sarah
/
tor
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

man page: FetchUselessDescriptors and DirCache exclude extra infos

This commit is contained in:
teor 2018-05-02 11:29:48 +10:00
parent 4a7590c241
commit d96ddf8f1b
No known key found for this signature in database
GPG Key ID: 740D9E39025272A2
1 changed files with 20 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
doc/tor.1.txt
View File

@ -540,16 +540,21 @@ GENERAL OPTIONS
(Default: 1) (Default: 1)
[[FetchUselessDescriptors]] **FetchUselessDescriptors** **0**|**1**:: [[FetchUselessDescriptors]] **FetchUselessDescriptors** **0**|**1**::
If set to 1, Tor will fetch every consensus flavor, descriptor, and If set to 1, Tor will fetch every consensus flavor, and all server
certificate that it hears about. Otherwise, it will avoid fetching useless descriptors and authority certificates referenced by those consensuses,
descriptors: flavors that it is not using to build circuits, and authority except for extra info descriptors. When this option is 1, Tor will also
certificates it does not trust. Tor stops fetching descriptors if it keep fetching descriptors, even when idle.
hasn't built any circuits lately: this option makes Tor keep fetching If set to 0, Tor will avoid fetching useless descriptors: flavors that it
descriptors, even when idle. This option is useful if you're using a 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. tor client with an external parser that uses a full consensus.
This option fetches all documents, **DirCache** fetches and serves This option fetches all documents except extrainfo descriptors,
all documents, **UseMicrodescriptors 0** fetches full descriptors and uses **DirCache** fetches and serves all documents except extrainfo
them to build circuits. (Default: 0) 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__]:: [[HTTPProxy]] **HTTPProxy** __host__[:__port__]::
Tor will make all its directory requests through this host:port (or host:80 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. some entry in the policy is accepted.
[[DirCache]] **DirCache** **0**|**1**:: [[DirCache]] **DirCache** **0**|**1**::
When this option is set, Tor caches all current directory documents and When this option is set, Tor caches all current directory documents except
accepts client requests for them. Setting DirPort is not required for this, extra info documents, and accepts client requests for them. If
because clients connect via the ORPort by default. Setting either DirPort **DownloadExtraInfo** is set, cached extra info documents are also cached.
or BridgeRelay and setting DirCache to 0 is not supported. (Default: 1) 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**:: [[MaxConsensusAgeForDiffs]] **MaxConsensusAgeForDiffs** __N__ **minutes**|**hours**|**days**|**weeks**::
When this option is nonzero, Tor caches will not try to generate When this option is nonzero, Tor caches will not try to generate