summaryrefslogtreecommitdiff
path: root/src/or/dirserv.c
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2008-12-23 17:56:31 +0000
committerNick Mathewson <nickm@torproject.org>2008-12-23 17:56:31 +0000
commit558e9899e4d11d8ef194e5bc1761d5d2f6dff450 (patch)
tree45eb50017f2b65c70babf90b3c088a3c952ce6de /src/or/dirserv.c
parentd7f55dafe0287c1a8c13478c4e077da65533769c (diff)
downloadtor-558e9899e4d11d8ef194e5bc1761d5d2f6dff450.tar.gz
tor-558e9899e4d11d8ef194e5bc1761d5d2f6dff450.zip
Document most undocumented variables.
svn:r17754
Diffstat (limited to 'src/or/dirserv.c')
-rw-r--r--src/or/dirserv.c17
1 files changed, 11 insertions, 6 deletions
diff --git a/src/or/dirserv.c b/src/or/dirserv.c
index 361f44f2e5..71b837f857 100644
--- a/src/or/dirserv.c
+++ b/src/or/dirserv.c
@@ -30,11 +30,13 @@ const char dirserv_c_id[] =
extern time_t time_of_process_start; /* from main.c */
-/** Do we need to regenerate the directory when someone asks for it? */
+/** Do we need to regenerate the v1 directory when someone asks for it? */
static time_t the_directory_is_dirty = 1;
-/* DOCDOC runningrouters_is_dirty */
+/** Do we need to regenerate the v1 runningrouters document when somebody
+ * asks for it? */
static time_t runningrouters_is_dirty = 1;
-/* DOCDOC the_v2_networkstatus_is_dirty */
+/** Do we need to regenerate our v2 networkstatus document when somebody asks
+ * for it? */
static time_t the_v2_networkstatus_is_dirty = 1;
/** Most recently generated encoded signed v1 directory. (v1 auth dirservers
@@ -1224,9 +1226,12 @@ directory_too_idle_to_fetch_descriptors(or_options_t *options, time_t now)
/* Used only by non-v1-auth dirservers: The v1 directory and
* runningrouters we'll serve when requested. */
-/* DOCDOC cached_directory */
+
+/** The v1 directory we'll serve (as a cache or as an authority) if
+ * requested. */
static cached_dir_t *cached_directory = NULL;
-/* DOCDOC cached_runningrouters */
+/** The v1 runningrouters document we'll serve (as a cache or as an authority)
+ * if requested. */
static cached_dir_t cached_runningrouters = { NULL, NULL, 0, 0, 0, -1 };
/** Used for other dirservers' v2 network statuses. Map from hexdigest to
@@ -1640,7 +1645,7 @@ should_generate_v2_networkstatus(void)
/* Thresholds for server performance: set by
* dirserv_compute_performance_thresholds, and used by
* generate_v2_networkstatus */
-/* XXXX stick these all in a struct. */
+
/* DOCDOC stable_uptime */
static uint32_t stable_uptime = 0; /* start at a safe value */
/* DOCDOC stable_mtbf */