aboutsummaryrefslogtreecommitdiff
path: root/src/feature/control
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2020-07-16 09:57:52 -0400
committerNick Mathewson <nickm@torproject.org>2020-07-16 09:57:52 -0400
commitb0d7b100886ef14a785f6ca1de968df9a884d0a7 (patch)
tree931f94cbc9dd273a6df31ef3e93623babfc1ec2b /src/feature/control
parent10d8555e7db2f4835b4fc9a0f4592e470a974c5f (diff)
downloadtor-b0d7b100886ef14a785f6ca1de968df9a884d0a7.tar.gz
tor-b0d7b100886ef14a785f6ca1de968df9a884d0a7.zip
Improve documentation for our TO_*_CONN() cast functions.
Preliminary work for #40046.
Diffstat (limited to 'src/feature/control')
-rw-r--r--src/feature/control/control.c8
1 files changed, 6 insertions, 2 deletions
diff --git a/src/feature/control/control.c b/src/feature/control/control.c
index ee1026359d..b5d4c31525 100644
--- a/src/feature/control/control.c
+++ b/src/feature/control/control.c
@@ -61,8 +61,12 @@
#include <sys/stat.h>
#endif
-/** Convert a connection_t* to an control_connection_t*; assert if the cast is
- * invalid. */
+/**
+ * Cast a `connection_t *` to a `control_connection_t *`.
+ *
+ * Exit with an assertion failure if the input is not a
+ * `control_connection_t`.
+ **/
control_connection_t *
TO_CONTROL_CONN(connection_t *c)
{