commit a47c17fc2b07fd5ed743e671e85a1e7d8b63a7fc
parent 8c6a68c258061f68466905393b76106436d3dccf
Author: Willow Liquorice <willow@howhill.com>
Date: Sat, 27 Aug 2022 23:14:48 +0100
-DOC: Minor passes over NAT, REGEX, and TRANSPORT
Diffstat:
4 files changed, 10 insertions(+), 48 deletions(-)
diff --git a/src/nat/gnunet-service-nat_mini.c b/src/nat/gnunet-service-nat_mini.c
@@ -471,11 +471,6 @@ process_refresh_output (void *cls, const char *line)
}
-/**
- * Run "upnpc -l" to find out if our mapping changed.
- *
- * @param cls the 'struct GNUNET_NAT_MiniHandle'
- */
static void
do_refresh (void *cls)
{
diff --git a/src/regex/gnunet-regex-profiler.c b/src/regex/gnunet-regex-profiler.c
@@ -321,7 +321,9 @@ static struct GNUNET_TIME_Relative reannounce_period_max;
/******************************************************************************/
/**
- * DHT connect callback.
+ * DHT connect callback. Called when we are connected to the dht service for
+ * the peer in 'cls'. If successful we connect to the stats service of this
+ * peer and then try to match the search string of this peer.
*
* @param cls internal peer id.
* @param op operation handle.
@@ -333,10 +335,10 @@ dht_connect_cb (void *cls, struct GNUNET_TESTBED_Operation *op,
void *ca_result, const char *emsg);
/**
- * DHT connect adapter.
+ * DHT connect adapter. Opens a connection to the DHT service.
*
- * @param cls not used.
- * @param cfg configuration handle.
+ * @param cls Closure (peer).
+ * @param cfg Configuration handle.
*
* @return
*/
@@ -346,10 +348,10 @@ dht_ca (void *cls, const struct GNUNET_CONFIGURATION_Handle *cfg);
/**
* Adapter function called to destroy a connection to
- * the DHT service
+ * the DHT service.
*
- * @param cls closure
- * @param op_result service handle returned from the connect adapter
+ * @param cls Closure
+ * @param op_result Service handle returned from the connect adapter.
*/
static void
dht_da (void *cls, void *op_result);
@@ -1023,16 +1025,6 @@ announce_next_regex (void *cls)
}
-/**
- * DHT connect callback. Called when we are connected to the dht service for
- * the peer in 'cls'. If successful we connect to the stats service of this
- * peer and then try to match the search string of this peer.
- *
- * @param cls internal peer id.
- * @param op operation handle.
- * @param ca_result connect adapter result.
- * @param emsg error message.
- */
static void
dht_connect_cb (void *cls,
struct GNUNET_TESTBED_Operation *op,
@@ -1060,14 +1052,6 @@ dht_connect_cb (void *cls,
}
-/**
- * DHT connect adapter. Opens a connection to the dht service.
- *
- * @param cls Closure (peer).
- * @param cfg Configuration handle.
- *
- * @return
- */
static void *
dht_ca (void *cls, const struct GNUNET_CONFIGURATION_Handle *cfg)
{
@@ -1079,12 +1063,6 @@ dht_ca (void *cls, const struct GNUNET_CONFIGURATION_Handle *cfg)
}
-/**
- * Adapter function called to destroy a connection to the dht service.
- *
- * @param cls Closure (peer).
- * @param op_result Service handle returned from the connect adapter.
- */
static void
dht_da (void *cls, void *op_result)
{
diff --git a/src/transport/gnunet-service-transport.c b/src/transport/gnunet-service-transport.c
@@ -480,7 +480,7 @@ client_connect_cb (void *cls,
/**
* Perform next action in the blacklist check.
*
- * @param cls the `struct BlacklistCheck*`
+ * @param cls the `struct GST_BlacklistCheck *`
*/
static void
do_blacklist_check (void *cls);
@@ -2189,11 +2189,6 @@ shutdown_task (void *cls)
}
-/**
- * Perform next action in the blacklist check.
- *
- * @param cls the `struct GST_BlacklistCheck *`
- */
static void
do_blacklist_check (void *cls)
{
diff --git a/src/transport/plugin_transport_http_client.c b/src/transport/plugin_transport_http_client.c
@@ -1692,12 +1692,6 @@ client_connect_get (struct GNUNET_ATS_Session *s)
}
-/**
- * Connect a HTTP put request
- *
- * @param s the session to connect
- * @return #GNUNET_SYSERR for hard failure, #GNUNET_OK for ok
- */
static int
client_connect_put (struct GNUNET_ATS_Session *s)
{