summaryrefslogtreecommitdiff
path: root/src/or/router.c
diff options
context:
space:
mode:
Diffstat (limited to 'src/or/router.c')
-rw-r--r--src/or/router.c16
1 files changed, 10 insertions, 6 deletions
diff --git a/src/or/router.c b/src/or/router.c
index 220a3a5195..d4502c2274 100644
--- a/src/or/router.c
+++ b/src/or/router.c
@@ -28,13 +28,15 @@ extern long stats_n_seconds_working;
*/
static tor_mutex_t *key_lock=NULL;
static time_t onionkey_set_at=0; /**< When was onionkey last changed? */
-/** DOCDOC */
+/** Current private onionskin decryption key: used to decode CREATE cells. */
static crypto_pk_env_t *onionkey=NULL;
-/** DOCDOC */
+/** Previous private onionskin decription key: used to decode CREATE cells
+ * generated by client that have an older version of our descriptor. */
static crypto_pk_env_t *lastonionkey=NULL;
-/** DOCDOC */
+/** Private "identity key": used to sign directory info and TLS
+ * certificates. Never changes. */
static crypto_pk_env_t *identitykey=NULL;
-/** DOCDOC */
+/** Digest of identitykey. */
static char identitykey_digest[DIGEST_LEN];
/** Replace the current onion key with <b>k</b>. Does not affect lastonionkey;
@@ -999,7 +1001,8 @@ check_descriptor_bandwidth_changed(time_t now)
}
}
-/** DOCDOC */
+/** Note at log level severity that our best guess of address has changed from
+ * <b>prev</b> to <b>cur</b> */
static void
log_addr_has_changed(int severity, uint32_t prev, uint32_t cur)
{
@@ -1050,7 +1053,8 @@ check_descriptor_ipaddress_changed(time_t now)
}
}
-/** DOCDOC */
+/** The most recently guessed value of our IP address, from directory
+ * headers. */
static uint32_t last_guessed_ip = 0;
/** A directory authority told us our IP address is <b>suggestion</b>.