aboutsummaryrefslogtreecommitdiff
path: root/src/or/circuitlist.c
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2013-11-20 12:01:21 -0500
committerNick Mathewson <nickm@torproject.org>2013-11-20 12:05:36 -0500
commita406f6d0f05f812ced4bfc048f30bc8692be7e93 (patch)
treee2baab003d320b6ffce3ac7060e2afed686332c8 /src/or/circuitlist.c
parenteabcab2b7caab75ba8607c7dac225e4533998e80 (diff)
downloadtor-a406f6d0f05f812ced4bfc048f30bc8692be7e93.tar
tor-a406f6d0f05f812ced4bfc048f30bc8692be7e93.tar.gz
doxygen comments for 10169 code
Diffstat (limited to 'src/or/circuitlist.c')
-rw-r--r--src/or/circuitlist.c19
1 files changed, 13 insertions, 6 deletions
diff --git a/src/or/circuitlist.c b/src/or/circuitlist.c
index c7dfe36cf..3237b1e39 100644
--- a/src/or/circuitlist.c
+++ b/src/or/circuitlist.c
@@ -1373,7 +1373,8 @@ marked_circuit_free_cells(circuit_t *circ)
cell_queue_clear(& TO_OR_CIRCUIT(circ)->p_conn_cells);
}
-/** DOCDOC */
+/** Aggressively free buffer contents on all the buffers of all streams in the
+ * list starting at <b>stream</b>. Return the number of bytes recovered. */
static size_t
marked_circuit_streams_free_bytes(edge_connection_t *stream)
{
@@ -1392,7 +1393,8 @@ marked_circuit_streams_free_bytes(edge_connection_t *stream)
return result;
}
-/** DOCDOC */
+/** Aggressively free buffer contents on all the buffers of all streams on
+ * circuit <b>c</b>. Return the number of bytes recovered. */
static size_t
marked_circuit_free_stream_bytes(circuit_t *c)
{
@@ -1439,7 +1441,9 @@ circuit_max_queued_cell_age(const circuit_t *c, uint32_t now)
return age;
}
-/** DOCDOC*/
+/** Return the age in milliseconds of the oldest buffer chunk on any stream in
+ * the linked list <b>stream</b>, where age is taken in milliseconds before
+ * the time <b>now</b> (in truncated milliseconds since the epoch). */
static uint32_t
circuit_get_streams_max_data_age(const edge_connection_t *stream, uint32_t now)
{
@@ -1461,8 +1465,9 @@ circuit_get_streams_max_data_age(const edge_connection_t *stream, uint32_t now)
return age;
}
-/** DOCDOC
- */
+/** Return the age in milliseconds of the oldest buffer chunk on any stream
+ * attached to the circuit <b>c</b>, where age is taken in milliseconds before
+ * the time <b>now</b> (in truncated milliseconds since the epoch). */
static uint32_t
circuit_max_queued_data_age(const circuit_t *c, uint32_t now)
{
@@ -1475,7 +1480,9 @@ circuit_max_queued_data_age(const circuit_t *c, uint32_t now)
}
}
-/** DATA */
+/** Return the age of the oldest cell or stream buffer chunk on the circuit
+ * <b>c</b>, where age is taken in milliseconds before the time <b>now</b> (in
+ * truncated milliseconds since the epoch). */
static uint32_t
circuit_max_queued_item_age(const circuit_t *c, uint32_t now)
{