summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2012-08-31 18:39:11 -0400
committerNick Mathewson <nickm@torproject.org>2012-08-31 18:39:11 -0400
commitb17bb543dab3e34f5076649707bc74d5d3bd62fd (patch)
treec60b4d250e5d931eed18c7b73eec73066f4278f6
parenta7a4bbff47c92aa4df0a932492867d1601834118 (diff)
parent774979ca4584036d17dd96071ec565955d9f04a7 (diff)
downloadtor-b17bb543dab3e34f5076649707bc74d5d3bd62fd.tar.gz
tor-b17bb543dab3e34f5076649707bc74d5d3bd62fd.zip
Merge branch 'bug6732' into maint-0.2.3
-rw-r--r--changes/bug67323
-rw-r--r--doc/tor.1.txt11
2 files changed, 13 insertions, 1 deletions
diff --git a/changes/bug6732 b/changes/bug6732
new file mode 100644
index 0000000000..7a744e014a
--- /dev/null
+++ b/changes/bug6732
@@ -0,0 +1,3 @@
+ o Documentation:
+ - Add missing documentation for consensus and microdesc files. Fix for
+ bug 6732.
diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index 7e0751b2b2..62259b7268 100644
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -1882,7 +1882,10 @@ FILES
__DataDirectory__**/cached-status/**::
The most recently downloaded network status document for each authority.
Each file holds one such document; the filenames are the hexadecimal
- identity key fingerprints of the directory authorities.
+ identity key fingerprints of the directory authorities. Mostly obsolete.
+
+__DataDirectory__**/cached-consensus** and/or **cached-microdesc-consensus**::
+ The most recent consensus network status document we've downloaded.
__DataDirectory__**/cached-descriptors** and **cached-descriptors.new**::
These files hold downloaded router statuses. Some routers may appear more
@@ -1891,6 +1894,12 @@ __DataDirectory__**/cached-descriptors** and **cached-descriptors.new**::
a given router. The ".new" file is an append-only journal; when it gets
too large, all entries are merged into a new cached-descriptors file.
+__DataDirectory__**/cached-microdescs** and **cached-microdescs.new**::
+ These files hold downloaded microdescriptors. Lines beginning with
+ @-signs are annotations that contain more information about a given
+ router. The ".new" file is an append-only journal; when it gets too
+ large, all entries are merged into a new cached-microdescs file.
+
__DataDirectory__**/cached-routers** and **cached-routers.new**::
Obsolete versions of cached-descriptors and cached-descriptors.new. When
Tor can't find the newer files, it looks here instead.