aboutsummaryrefslogtreecommitdiff
path: root/src/or/dirserv.c
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2008-12-26 17:35:08 +0000
committerNick Mathewson <nickm@torproject.org>2008-12-26 17:35:08 +0000
commitdf5e8f65bcc1ed3353c45a80baab126476aa5011 (patch)
tree142809c03246a9f40c8813313f1ade11466dfe05 /src/or/dirserv.c
parent41aef35963efb37b85ac7ea1d24b3bd1dea936cb (diff)
downloadtor-df5e8f65bcc1ed3353c45a80baab126476aa5011.tar
tor-df5e8f65bcc1ed3353c45a80baab126476aa5011.tar.gz
Add more missing documentation, and correct an error in container.c documentation: Don't introduce two parameters called n when you're calling an algorithm O(n).
svn:r17783
Diffstat (limited to 'src/or/dirserv.c')
-rw-r--r--src/or/dirserv.c25
1 files changed, 15 insertions, 10 deletions
diff --git a/src/or/dirserv.c b/src/or/dirserv.c
index 71b837f85..8a7f2e915 100644
--- a/src/or/dirserv.c
+++ b/src/or/dirserv.c
@@ -1646,25 +1646,30 @@ should_generate_v2_networkstatus(void)
* dirserv_compute_performance_thresholds, and used by
* generate_v2_networkstatus */
-/* DOCDOC stable_uptime */
+/** Any router with an uptime of at least this value is stable. */
static uint32_t stable_uptime = 0; /* start at a safe value */
-/* DOCDOC stable_mtbf */
+/** Any router with an mtbf of at least this value is stable. */
static double stable_mtbf = 0.0;
-/* DOCDOC enough_mtbf_info */
+/** If true, we have measured enough mtbf info to look at stable_mtbf rather
+ * than stable_uptime. */
static int enough_mtbf_info = 0;
-/* DOCDOC guard_wfu */
+/** Any router with a weighted fractional uptime of at least this much might
+ * be good as a guard. */
static double guard_wfu = 0.0;
-/* DOCDOC guard_tk */
+/** Don't call a router a guard unless we've known about it for at least this
+ * many seconds. */
static long guard_tk = 0;
-/* DOCDOC fast_bandwidth */
+/** Any router with a bandwidth at least this high is "Fast" */
static uint32_t fast_bandwidth = 0;
-/* DOCDOC guard_bandwidth_including_exits */
+/** If exits can be guards, then all guards must have a bandwidth this
+ * high. */
static uint32_t guard_bandwidth_including_exits = 0;
-/* DOCDOC guard_bandwidth_excluding_exits */
+/** If exits can't be guards, then all guards must have a bandwidth this
+ * high. */
static uint32_t guard_bandwidth_excluding_exits = 0;
-/* DOCDOC total_bandwidth */
+/** Total bandwidth of all the routers we're considering. */
static uint64_t total_bandwidth = 0;
-/* DOCDOC total_exit_bandwidth */
+/** Total bandwidth of all the exit routers we're considering. */
static uint64_t total_exit_bandwidth = 0;
/** Helper: estimate the uptime of a router given its stated uptime and the