diff options
author | Willow Liquorice <willow@howhill.com> | 2022-09-07 20:41:38 +0100 |
---|---|---|
committer | Willow Liquorice <willow@howhill.com> | 2022-10-03 00:44:33 +0100 |
commit | 1d0bbddfefaefb6e3f5cd240e56462a6bef2fa09 (patch) | |
tree | a336382e5b6911dbd854c5942049db18d7a5b434 /src/transport | |
parent | 7162905b6914f0e829028934f5917686f60ef0c6 (diff) | |
download | gnunet-1d0bbddfefaefb6e3f5cd240e56462a6bef2fa09.tar.gz gnunet-1d0bbddfefaefb6e3f5cd240e56462a6bef2fa09.zip |
-DOC: Documentation cleanup pass through TRANSPORT ('missing argument' warnings)
Diffstat (limited to 'src/transport')
-rw-r--r-- | src/transport/gnunet-communicator-tcp.c | 16 | ||||
-rw-r--r-- | src/transport/gnunet-communicator-udp.c | 12 | ||||
-rw-r--r-- | src/transport/gnunet-service-tng.c | 22 | ||||
-rw-r--r-- | src/transport/gnunet-service-transport.c | 2 | ||||
-rw-r--r-- | src/transport/gnunet-service-transport_manipulation.c | 4 | ||||
-rw-r--r-- | src/transport/gnunet-service-transport_plugins.c | 1 | ||||
-rw-r--r-- | src/transport/plugin_transport_http_server.c | 2 | ||||
-rw-r--r-- | src/transport/plugin_transport_tcp.c | 2 | ||||
-rw-r--r-- | src/transport/plugin_transport_udp.c | 2 | ||||
-rw-r--r-- | src/transport/transport-testing-cmds.h | 10 | ||||
-rw-r--r-- | src/transport/transport-testing-communicator.c | 15 | ||||
-rw-r--r-- | src/transport/transport_api2_communication.c | 9 | ||||
-rw-r--r-- | src/transport/transport_api_address_to_string.c | 4 | ||||
-rw-r--r-- | src/transport/transport_api_cmd_backchannel_check.c | 12 | ||||
-rw-r--r-- | src/transport/transport_api_cmd_connecting_peers.c | 11 | ||||
-rw-r--r-- | src/transport/transport_api_core.c | 2 |
16 files changed, 42 insertions, 84 deletions
diff --git a/src/transport/gnunet-communicator-tcp.c b/src/transport/gnunet-communicator-tcp.c index 6d7a151ec..9612c8848 100644 --- a/src/transport/gnunet-communicator-tcp.c +++ b/src/transport/gnunet-communicator-tcp.c | |||
@@ -981,7 +981,7 @@ queue_destroy (struct Queue *queue) | |||
981 | * @param[in,out] hmac_secret secret for HMAC calculation | 981 | * @param[in,out] hmac_secret secret for HMAC calculation |
982 | * @param buf buffer to MAC | 982 | * @param buf buffer to MAC |
983 | * @param buf_size number of bytes in @a buf | 983 | * @param buf_size number of bytes in @a buf |
984 | * @param smac[out] where to write the HMAC | 984 | * @param[out] smac where to write the HMAC |
985 | */ | 985 | */ |
986 | static void | 986 | static void |
987 | calculate_hmac (struct GNUNET_HashCode *hmac_secret, | 987 | calculate_hmac (struct GNUNET_HashCode *hmac_secret, |
@@ -1155,8 +1155,8 @@ pass_plaintext_to_core (struct Queue *queue, | |||
1155 | * | 1155 | * |
1156 | * @param dh shared secret | 1156 | * @param dh shared secret |
1157 | * @param pid decrypting peer's identity | 1157 | * @param pid decrypting peer's identity |
1158 | * @param cipher[out] cipher to initialize | 1158 | * @param[out] cipher cipher to initialize |
1159 | * @param hmac_key[out] HMAC key to initialize | 1159 | * @param[out] hmac_key HMAC key to initialize |
1160 | */ | 1160 | */ |
1161 | static void | 1161 | static void |
1162 | setup_cipher (const struct GNUNET_HashCode *dh, | 1162 | setup_cipher (const struct GNUNET_HashCode *dh, |
@@ -1287,7 +1287,7 @@ rekey_monotime_cb (void *cls, | |||
1287 | * Setup cipher of @a queue for decryption. | 1287 | * Setup cipher of @a queue for decryption. |
1288 | * | 1288 | * |
1289 | * @param ephemeral ephemeral key we received from the other peer | 1289 | * @param ephemeral ephemeral key we received from the other peer |
1290 | * @param queue[in,out] queue to initialize decryption cipher for | 1290 | * @param[in,out] queue queue to initialize decryption cipher for |
1291 | */ | 1291 | */ |
1292 | static void | 1292 | static void |
1293 | setup_in_cipher (const struct GNUNET_CRYPTO_EcdhePublicKey *ephemeral, | 1293 | setup_in_cipher (const struct GNUNET_CRYPTO_EcdhePublicKey *ephemeral, |
@@ -1448,8 +1448,8 @@ handshake_ack_monotime_cb (void *cls, | |||
1448 | * @param queue The queue context. | 1448 | * @param queue The queue context. |
1449 | */ | 1449 | */ |
1450 | static void | 1450 | static void |
1451 | send_challenge (struct GNUNET_CRYPTO_ChallengeNonceP challenge, struct | 1451 | send_challenge (struct GNUNET_CRYPTO_ChallengeNonceP challenge, |
1452 | Queue *queue) | 1452 | struct Queue *queue) |
1453 | { | 1453 | { |
1454 | struct TCPConfirmationAck tca; | 1454 | struct TCPConfirmationAck tca; |
1455 | struct TcpHandshakeAckSignature thas; | 1455 | struct TcpHandshakeAckSignature thas; |
@@ -2608,7 +2608,7 @@ handshake_monotime_cb (void *cls, | |||
2608 | * Note that #setup_in_cipher() must have already been called. | 2608 | * Note that #setup_in_cipher() must have already been called. |
2609 | * | 2609 | * |
2610 | * @param queue queue to decrypt initial bytes from other peer for | 2610 | * @param queue queue to decrypt initial bytes from other peer for |
2611 | * @param tc[out] where to store the result | 2611 | * @param[out] tc where to store the result |
2612 | * @param ibuf incoming data, of size | 2612 | * @param ibuf incoming data, of size |
2613 | * `INITIAL_KX_SIZE` | 2613 | * `INITIAL_KX_SIZE` |
2614 | * @return #GNUNET_OK if the signature was OK, #GNUNET_SYSERR if not | 2614 | * @return #GNUNET_OK if the signature was OK, #GNUNET_SYSERR if not |
@@ -3174,7 +3174,7 @@ enc_notify_cb (void *cls, | |||
3174 | * a function to call whenever our set of 'valid' addresses changes. | 3174 | * a function to call whenever our set of 'valid' addresses changes. |
3175 | * | 3175 | * |
3176 | * @param cls closure | 3176 | * @param cls closure |
3177 | * @param app_ctx[in,out] location where the app can store stuff | 3177 | * @param[in,out] app_ctx location where the app can store stuff |
3178 | * on add and retrieve it on remove | 3178 | * on add and retrieve it on remove |
3179 | * @param add_remove #GNUNET_YES to add a new public IP address, | 3179 | * @param add_remove #GNUNET_YES to add a new public IP address, |
3180 | * #GNUNET_NO to remove a previous (now invalid) one | 3180 | * #GNUNET_NO to remove a previous (now invalid) one |
diff --git a/src/transport/gnunet-communicator-udp.c b/src/transport/gnunet-communicator-udp.c index 70848ff79..0f9a95619 100644 --- a/src/transport/gnunet-communicator-udp.c +++ b/src/transport/gnunet-communicator-udp.c | |||
@@ -998,7 +998,7 @@ kce_destroy (struct KeyCacheEntry *kce) | |||
998 | * | 998 | * |
999 | * @param msec master secret for HMAC calculation | 999 | * @param msec master secret for HMAC calculation |
1000 | * @param serial number for the @a smac calculation | 1000 | * @param serial number for the @a smac calculation |
1001 | * @param kid[out] where to write the key ID | 1001 | * @param[out] kid where to write the key ID |
1002 | */ | 1002 | */ |
1003 | static void | 1003 | static void |
1004 | get_kid (const struct GNUNET_HashCode *msec, | 1004 | get_kid (const struct GNUNET_HashCode *msec, |
@@ -1130,8 +1130,8 @@ sender_destroy (struct SenderAddress *sender) | |||
1130 | * | 1130 | * |
1131 | * @param msec master secret for calculation | 1131 | * @param msec master secret for calculation |
1132 | * @param serial number for the @a smac calculation | 1132 | * @param serial number for the @a smac calculation |
1133 | * @param key[out] where to write the decryption key | 1133 | * @param[out] key where to write the decryption key |
1134 | * @param iv[out] where to write the IV | 1134 | * @param[out] iv where to write the IV |
1135 | */ | 1135 | */ |
1136 | static void | 1136 | static void |
1137 | get_iv_key (const struct GNUNET_HashCode *msec, | 1137 | get_iv_key (const struct GNUNET_HashCode *msec, |
@@ -1237,7 +1237,7 @@ check_timeouts (void *cls) | |||
1237 | /** | 1237 | /** |
1238 | * Calculate cmac from master in @a ss. | 1238 | * Calculate cmac from master in @a ss. |
1239 | * | 1239 | * |
1240 | * @param ss[in,out] data structure to complete | 1240 | * @param[in,out] ss data structure to complete |
1241 | */ | 1241 | */ |
1242 | static void | 1242 | static void |
1243 | calculate_cmac (struct SharedSecret *ss) | 1243 | calculate_cmac (struct SharedSecret *ss) |
@@ -1397,7 +1397,7 @@ setup_shared_secret_dec (const struct GNUNET_CRYPTO_EcdhePublicKey *ephemeral) | |||
1397 | * Setup shared secret for encryption. | 1397 | * Setup shared secret for encryption. |
1398 | * | 1398 | * |
1399 | * @param ephemeral ephemeral key we are sending to the other peer | 1399 | * @param ephemeral ephemeral key we are sending to the other peer |
1400 | * @param receiver[in,out] queue to initialize encryption key for | 1400 | * @param[in,out] receiver queue to initialize encryption key for |
1401 | * @return new shared secret | 1401 | * @return new shared secret |
1402 | */ | 1402 | */ |
1403 | static struct SharedSecret * | 1403 | static struct SharedSecret * |
@@ -2198,7 +2198,7 @@ setup_sender (const struct GNUNET_PeerIdentity *target, | |||
2198 | /** | 2198 | /** |
2199 | * Check signature from @a uc against @a ephemeral. | 2199 | * Check signature from @a uc against @a ephemeral. |
2200 | * | 2200 | * |
2201 | * @param ephermal key that is signed | 2201 | * @param ephemeral key that is signed |
2202 | * @param uc signature of claimant | 2202 | * @param uc signature of claimant |
2203 | * @return #GNUNET_OK if signature is valid | 2203 | * @return #GNUNET_OK if signature is valid |
2204 | */ | 2204 | */ |
diff --git a/src/transport/gnunet-service-tng.c b/src/transport/gnunet-service-tng.c index 9b2b920d1..333211ce1 100644 --- a/src/transport/gnunet-service-tng.c +++ b/src/transport/gnunet-service-tng.c | |||
@@ -4081,7 +4081,7 @@ client_send_response (struct PendingMessage *pm) | |||
4081 | * | 4081 | * |
4082 | * @param dv data structure to pick paths from | 4082 | * @param dv data structure to pick paths from |
4083 | * @param options constraints to satisfy | 4083 | * @param options constraints to satisfy |
4084 | * @param hops_array[out] set to the result | 4084 | * @param[out] hops_array set to the result |
4085 | * @param hops_array_length length of the @a hops_array | 4085 | * @param hops_array_length length of the @a hops_array |
4086 | * @return number of entries set in @a hops_array | 4086 | * @return number of entries set in @a hops_array |
4087 | */ | 4087 | */ |
@@ -4329,7 +4329,7 @@ check_communicator_backchannel ( | |||
4329 | * Ensure ephemeral keys in our @a dv are current. If no current one exists, | 4329 | * Ensure ephemeral keys in our @a dv are current. If no current one exists, |
4330 | * set it up. | 4330 | * set it up. |
4331 | * | 4331 | * |
4332 | * @param dv[in,out] virtual link to update ephemeral for | 4332 | * @param[in,out] dv virtual link to update ephemeral for |
4333 | */ | 4333 | */ |
4334 | static void | 4334 | static void |
4335 | update_ephemeral (struct DistanceVector *dv) | 4335 | update_ephemeral (struct DistanceVector *dv) |
@@ -4562,7 +4562,7 @@ struct DVKeyState | |||
4562 | * | 4562 | * |
4563 | * @param km raw master secret | 4563 | * @param km raw master secret |
4564 | * @param iv initialization vector | 4564 | * @param iv initialization vector |
4565 | * @param key[out] symmetric cipher and HMAC state to generate | 4565 | * @param[out] key symmetric cipher and HMAC state to generate |
4566 | */ | 4566 | */ |
4567 | static void | 4567 | static void |
4568 | dv_setup_key_state_from_km (const struct GNUNET_HashCode *km, | 4568 | dv_setup_key_state_from_km (const struct GNUNET_HashCode *km, |
@@ -4604,7 +4604,7 @@ dv_setup_key_state_from_km (const struct GNUNET_HashCode *km, | |||
4604 | * @param priv_ephemeral ephemeral private key to use | 4604 | * @param priv_ephemeral ephemeral private key to use |
4605 | * @param target the target peer to encrypt to | 4605 | * @param target the target peer to encrypt to |
4606 | * @param iv unique IV to use | 4606 | * @param iv unique IV to use |
4607 | * @param key[out] set to the key material | 4607 | * @param[out] key set to the key material |
4608 | */ | 4608 | */ |
4609 | static void | 4609 | static void |
4610 | dh_key_derive_eph_pid ( | 4610 | dh_key_derive_eph_pid ( |
@@ -4629,7 +4629,7 @@ dh_key_derive_eph_pid ( | |||
4629 | * @param priv_ephemeral ephemeral private key to use | 4629 | * @param priv_ephemeral ephemeral private key to use |
4630 | * @param target the target peer to encrypt to | 4630 | * @param target the target peer to encrypt to |
4631 | * @param iv unique IV to use | 4631 | * @param iv unique IV to use |
4632 | * @param key[out] set to the key material | 4632 | * @param[out] key set to the key material |
4633 | */ | 4633 | */ |
4634 | static void | 4634 | static void |
4635 | dh_key_derive_eph_pub (const struct GNUNET_CRYPTO_EcdhePublicKey *pub_ephemeral, | 4635 | dh_key_derive_eph_pub (const struct GNUNET_CRYPTO_EcdhePublicKey *pub_ephemeral, |
@@ -4650,7 +4650,7 @@ dh_key_derive_eph_pub (const struct GNUNET_CRYPTO_EcdhePublicKey *pub_ephemeral, | |||
4650 | * material from @a key. | 4650 | * material from @a key. |
4651 | * | 4651 | * |
4652 | * @param key key material (from DH) | 4652 | * @param key key material (from DH) |
4653 | * @param hmac[out] set to the HMAC | 4653 | * @param[out] hmac set to the HMAC |
4654 | * @param data data to perform HMAC calculation over | 4654 | * @param data data to perform HMAC calculation over |
4655 | * @param data_size number of bytes in @a data | 4655 | * @param data_size number of bytes in @a data |
4656 | */ | 4656 | */ |
@@ -4740,7 +4740,7 @@ typedef void (*DVMessageHandler) (void *cls, | |||
4740 | * @param use function to call with the encapsulated message | 4740 | * @param use function to call with the encapsulated message |
4741 | * @param use_cls closure for @a use | 4741 | * @param use_cls closure for @a use |
4742 | * @param options whether path must be confirmed or not, to be passed to @a use | 4742 | * @param options whether path must be confirmed or not, to be passed to @a use |
4743 | * @param shall this TransportDVBoxMessage be forwarded without flow control. | 4743 | * @param without_fc shall this TransportDVBoxMessage be forwarded without flow control. |
4744 | * @return expected RTT for transmission, #GNUNET_TIME_UNIT_FOREVER_REL if sending failed | 4744 | * @return expected RTT for transmission, #GNUNET_TIME_UNIT_FOREVER_REL if sending failed |
4745 | */ | 4745 | */ |
4746 | static struct GNUNET_TIME_Relative | 4746 | static struct GNUNET_TIME_Relative |
@@ -6147,7 +6147,7 @@ handle_reliability_box (void *cls, | |||
6147 | * so, purge ancient statistics (more than GOODPUT_AGING_SLOTS before | 6147 | * so, purge ancient statistics (more than GOODPUT_AGING_SLOTS before |
6148 | * the current age) | 6148 | * the current age) |
6149 | * | 6149 | * |
6150 | * @param pd[in,out] data to update | 6150 | * @param[in,out] pd data to update |
6151 | * @param age current age | 6151 | * @param age current age |
6152 | */ | 6152 | */ |
6153 | static void | 6153 | static void |
@@ -6173,7 +6173,7 @@ update_pd_age (struct PerformanceData *pd, unsigned int age) | |||
6173 | * Update @a pd based on the latest @a rtt and the number of bytes | 6173 | * Update @a pd based on the latest @a rtt and the number of bytes |
6174 | * that were confirmed to be successfully transmitted. | 6174 | * that were confirmed to be successfully transmitted. |
6175 | * | 6175 | * |
6176 | * @param pd[in,out] data to update | 6176 | * @param[in,out] pd data to update |
6177 | * @param rtt latest round-trip time | 6177 | * @param rtt latest round-trip time |
6178 | * @param bytes_transmitted_ok number of bytes receiver confirmed as received | 6178 | * @param bytes_transmitted_ok number of bytes receiver confirmed as received |
6179 | */ | 6179 | */ |
@@ -8086,7 +8086,7 @@ handle_dv_box (void *cls, const struct TransportDVBoxMessage *dvb) | |||
8086 | * Client notified us about transmission from a peer. Process the request. | 8086 | * Client notified us about transmission from a peer. Process the request. |
8087 | * | 8087 | * |
8088 | * @param cls a `struct TransportClient` which sent us the message | 8088 | * @param cls a `struct TransportClient` which sent us the message |
8089 | * @param obm the send message that was sent | 8089 | * @param im the send message that was sent |
8090 | * @return #GNUNET_YES if message is well-formed | 8090 | * @return #GNUNET_YES if message is well-formed |
8091 | */ | 8091 | */ |
8092 | static int | 8092 | static int |
@@ -9302,7 +9302,7 @@ struct PendingMessageScoreContext | |||
9302 | * Select the best pending message from @a vl for transmission | 9302 | * Select the best pending message from @a vl for transmission |
9303 | * via @a queue. | 9303 | * via @a queue. |
9304 | * | 9304 | * |
9305 | * @param sc[in,out] best message so far (NULL for none), plus scoring data | 9305 | * @param[in,out] sc best message so far (NULL for none), plus scoring data |
9306 | * @param queue the queue that will be used for transmission | 9306 | * @param queue the queue that will be used for transmission |
9307 | * @param vl the virtual link providing the messages | 9307 | * @param vl the virtual link providing the messages |
9308 | * @param dvh path we are currently considering, or NULL for none | 9308 | * @param dvh path we are currently considering, or NULL for none |
diff --git a/src/transport/gnunet-service-transport.c b/src/transport/gnunet-service-transport.c index 463bcc628..93790e293 100644 --- a/src/transport/gnunet-service-transport.c +++ b/src/transport/gnunet-service-transport.c | |||
@@ -2120,7 +2120,7 @@ free_blacklist_entry (void *cls, | |||
2120 | * Set traffic metric to manipulate | 2120 | * Set traffic metric to manipulate |
2121 | * | 2121 | * |
2122 | * @param cls closure | 2122 | * @param cls closure |
2123 | * @param message containing information | 2123 | * @param tm message containing information |
2124 | */ | 2124 | */ |
2125 | static void | 2125 | static void |
2126 | handle_client_set_metric (void *cls, const struct TrafficMetricMessage *tm) | 2126 | handle_client_set_metric (void *cls, const struct TrafficMetricMessage *tm) |
diff --git a/src/transport/gnunet-service-transport_manipulation.c b/src/transport/gnunet-service-transport_manipulation.c index 04d1774c0..9f39b2dca 100644 --- a/src/transport/gnunet-service-transport_manipulation.c +++ b/src/transport/gnunet-service-transport_manipulation.c | |||
@@ -168,7 +168,7 @@ static struct GNUNET_SCHEDULER_Task *generic_send_delay_task; | |||
168 | /** | 168 | /** |
169 | * Set traffic metric to manipulate | 169 | * Set traffic metric to manipulate |
170 | * | 170 | * |
171 | * @param message containing information | 171 | * @param tm message containing information |
172 | */ | 172 | */ |
173 | void | 173 | void |
174 | GST_manipulation_set_metric (const struct TrafficMetricMessage *tm) | 174 | GST_manipulation_set_metric (const struct TrafficMetricMessage *tm) |
@@ -349,7 +349,7 @@ GST_manipulation_send (const struct GNUNET_PeerIdentity *target, | |||
349 | * | 349 | * |
350 | * @param address binary address | 350 | * @param address binary address |
351 | * @param session the session | 351 | * @param session the session |
352 | * @param prop[IN|OUT] metrics to modify | 352 | * @param[in,out] prop metrics to modify |
353 | */ | 353 | */ |
354 | void | 354 | void |
355 | GST_manipulation_manipulate_metrics (const struct GNUNET_HELLO_Address *address, | 355 | GST_manipulation_manipulate_metrics (const struct GNUNET_HELLO_Address *address, |
diff --git a/src/transport/gnunet-service-transport_plugins.c b/src/transport/gnunet-service-transport_plugins.c index 1a22335f4..218ef80ab 100644 --- a/src/transport/gnunet-service-transport_plugins.c +++ b/src/transport/gnunet-service-transport_plugins.c | |||
@@ -83,7 +83,6 @@ static struct TransportPlugin *plugins_tail; | |||
83 | * | 83 | * |
84 | * @param cls closure | 84 | * @param cls closure |
85 | * @param address address to update metrics for | 85 | * @param address address to update metrics for |
86 | * @param session the session | ||
87 | * @param distance new distance | 86 | * @param distance new distance |
88 | */ | 87 | */ |
89 | static void | 88 | static void |
diff --git a/src/transport/plugin_transport_http_server.c b/src/transport/plugin_transport_http_server.c index 78b030e9a..3ad2356b0 100644 --- a/src/transport/plugin_transport_http_server.c +++ b/src/transport/plugin_transport_http_server.c | |||
@@ -2563,7 +2563,7 @@ server_remove_address (void *cls, | |||
2563 | * Our external IP address/port mapping has changed. | 2563 | * Our external IP address/port mapping has changed. |
2564 | * | 2564 | * |
2565 | * @param cls closure, the 'struct LocalAddrList' | 2565 | * @param cls closure, the 'struct LocalAddrList' |
2566 | * @param app_ctx[in,out] location where the app can store stuff | 2566 | * @param[in,out] app_ctx location where the app can store stuff |
2567 | * on add and retrieve it on remove | 2567 | * on add and retrieve it on remove |
2568 | * @param add_remove #GNUNET_YES to mean the new public IP address, #GNUNET_NO to mean | 2568 | * @param add_remove #GNUNET_YES to mean the new public IP address, #GNUNET_NO to mean |
2569 | * the previous (now invalid) one | 2569 | * the previous (now invalid) one |
diff --git a/src/transport/plugin_transport_tcp.c b/src/transport/plugin_transport_tcp.c index ac4cc672f..ceae64709 100644 --- a/src/transport/plugin_transport_tcp.c +++ b/src/transport/plugin_transport_tcp.c | |||
@@ -1418,7 +1418,7 @@ notify_session_monitor (struct Plugin *plugin, | |||
1418 | * Our external IP address/port mapping has changed. | 1418 | * Our external IP address/port mapping has changed. |
1419 | * | 1419 | * |
1420 | * @param cls closure, the `struct Plugin` | 1420 | * @param cls closure, the `struct Plugin` |
1421 | * @param app_ctx[in,out] location where the app can store stuff | 1421 | * @param[in,out] app_ctx location where the app can store stuff |
1422 | * on add and retrieve it on remove | 1422 | * on add and retrieve it on remove |
1423 | * @param add_remove #GNUNET_YES to mean the new public IP address, #GNUNET_NO to mean | 1423 | * @param add_remove #GNUNET_YES to mean the new public IP address, #GNUNET_NO to mean |
1424 | * the previous (now invalid) one | 1424 | * the previous (now invalid) one |
diff --git a/src/transport/plugin_transport_udp.c b/src/transport/plugin_transport_udp.c index 2db31caa3..0d3ca449d 100644 --- a/src/transport/plugin_transport_udp.c +++ b/src/transport/plugin_transport_udp.c | |||
@@ -1254,7 +1254,7 @@ udp_plugin_check_address (void *cls, const void *addr, size_t addrlen) | |||
1254 | * Our external IP address/port mapping has changed. | 1254 | * Our external IP address/port mapping has changed. |
1255 | * | 1255 | * |
1256 | * @param cls closure, the `struct Plugin` | 1256 | * @param cls closure, the `struct Plugin` |
1257 | * @param app_ctx[in,out] location where the app can store stuff | 1257 | * @param[in,out] app_ctx location where the app can store stuff |
1258 | * on add and retrieve it on remove | 1258 | * on add and retrieve it on remove |
1259 | * @param add_remove #GNUNET_YES to mean the new public IP address, | 1259 | * @param add_remove #GNUNET_YES to mean the new public IP address, |
1260 | * #GNUNET_NO to mean the previous (now invalid) one | 1260 | * #GNUNET_NO to mean the previous (now invalid) one |
diff --git a/src/transport/transport-testing-cmds.h b/src/transport/transport-testing-cmds.h index 5a3fb22d6..c577feb34 100644 --- a/src/transport/transport-testing-cmds.h +++ b/src/transport/transport-testing-cmds.h | |||
@@ -227,9 +227,9 @@ GNUNET_TRANSPORT_cmd_stop_peer (const char *label, | |||
227 | * | 227 | * |
228 | * @param label name for command | 228 | * @param label name for command |
229 | * @param start_peer_label Label of the cmd to start a peer. | 229 | * @param start_peer_label Label of the cmd to start a peer. |
230 | * @param create_peer_label Label of the cmd which started the test system. | 230 | * @param create_label Label of the cmd which started the test system. |
231 | * @param num Number globally identifying the node. | 231 | * @param num Number globally identifying the node. |
232 | * @param The topology for the test setup. | 232 | * @param topology The topology for the test setup. |
233 | * @param additional_connects Number of additional connects this cmd will wait for not triggered by this cmd. | 233 | * @param additional_connects Number of additional connects this cmd will wait for not triggered by this cmd. |
234 | * @return command. | 234 | * @return command. |
235 | */ | 235 | */ |
@@ -248,9 +248,9 @@ GNUNET_TRANSPORT_cmd_connect_peers ( | |||
248 | * | 248 | * |
249 | * @param label name for command. | 249 | * @param label name for command. |
250 | * @param start_peer_label Label of the cmd to start a peer. | 250 | * @param start_peer_label Label of the cmd to start a peer. |
251 | * @param create_peer_label Label of the cmd which started the test system. | 251 | * @param create_label Label of the cmd which started the test system. |
252 | * @param num Number globally identifying the node. | 252 | * @param num Number globally identifying the node. |
253 | * @param The topology for the test setup. | 253 | * @param topology The topology for the test setup. |
254 | * @return command. | 254 | * @return command. |
255 | */ | 255 | */ |
256 | struct GNUNET_TESTING_Command | 256 | struct GNUNET_TESTING_Command |
@@ -271,7 +271,7 @@ GNUNET_TRANSPORT_cmd_send_simple (const char *label, | |||
271 | * @param num Number globally identifying the node. | 271 | * @param num Number globally identifying the node. |
272 | * @param node_n The number of the node in a network namespace. | 272 | * @param node_n The number of the node in a network namespace. |
273 | * @param namespace_n The number of the network namespace. | 273 | * @param namespace_n The number of the network namespace. |
274 | * @param The topology for the test setup. | 274 | * @param topology The topology for the test setup. |
275 | * @return command. | 275 | * @return command. |
276 | */ | 276 | */ |
277 | struct GNUNET_TESTING_Command | 277 | struct GNUNET_TESTING_Command |
diff --git a/src/transport/transport-testing-communicator.c b/src/transport/transport-testing-communicator.c index ce4af01f2..1bf88bb3d 100644 --- a/src/transport/transport-testing-communicator.c +++ b/src/transport/transport-testing-communicator.c | |||
@@ -232,7 +232,7 @@ check_communicator_backchannel (void *cls, | |||
232 | * Pass the message to the client. | 232 | * Pass the message to the client. |
233 | * | 233 | * |
234 | * @param cls Closure - communicator handle | 234 | * @param cls Closure - communicator handle |
235 | * @param msg Message | 235 | * @param bc_msg Message |
236 | */ | 236 | */ |
237 | static void | 237 | static void |
238 | handle_communicator_backchannel (void *cls, | 238 | handle_communicator_backchannel (void *cls, |
@@ -283,7 +283,7 @@ handle_communicator_backchannel (void *cls, | |||
283 | * Address of our peer added. Test message is well-formed. | 283 | * Address of our peer added. Test message is well-formed. |
284 | * | 284 | * |
285 | * @param cls the client | 285 | * @param cls the client |
286 | * @param aam the send message that was sent | 286 | * @param msg the send message that was sent |
287 | * @return #GNUNET_OK if message is well-formed | 287 | * @return #GNUNET_OK if message is well-formed |
288 | */ | 288 | */ |
289 | static int | 289 | static int |
@@ -365,7 +365,7 @@ check_incoming_msg (void *cls, | |||
365 | * Pass the message to the client. | 365 | * Pass the message to the client. |
366 | * | 366 | * |
367 | * @param cls Closure - communicator handle | 367 | * @param cls Closure - communicator handle |
368 | * @param msg Message | 368 | * @param inc_msg Message |
369 | */ | 369 | */ |
370 | static void | 370 | static void |
371 | handle_incoming_msg (void *cls, | 371 | handle_incoming_msg (void *cls, |
@@ -1146,15 +1146,6 @@ GNUNET_TRANSPORT_TESTING_transport_communicator_open_queue ( | |||
1146 | } | 1146 | } |
1147 | 1147 | ||
1148 | 1148 | ||
1149 | /** | ||
1150 | * @brief Instruct communicator to send data | ||
1151 | * | ||
1152 | * @param tc_queue The queue to use for sending | ||
1153 | * @param cont function to call when done sending | ||
1154 | * @param cont_cls closure for @a cont | ||
1155 | * @param payload Data to send | ||
1156 | * @param payload_size Size of the @a payload | ||
1157 | */ | ||
1158 | void | 1149 | void |
1159 | GNUNET_TRANSPORT_TESTING_transport_communicator_send | 1150 | GNUNET_TRANSPORT_TESTING_transport_communicator_send |
1160 | (struct GNUNET_TRANSPORT_TESTING_TransportCommunicatorHandle *tc_h, | 1151 | (struct GNUNET_TRANSPORT_TESTING_TransportCommunicatorHandle *tc_h, |
diff --git a/src/transport/transport_api2_communication.c b/src/transport/transport_api2_communication.c index aaab5df1c..3bfa53ad9 100644 --- a/src/transport/transport_api2_communication.c +++ b/src/transport/transport_api2_communication.c | |||
@@ -953,15 +953,6 @@ GNUNET_TRANSPORT_communicator_mq_add ( | |||
953 | } | 953 | } |
954 | 954 | ||
955 | 955 | ||
956 | /** | ||
957 | * Notify transport service that an MQ was updated | ||
958 | * | ||
959 | * @param ch connection to transport service | ||
960 | * @param qh the queue to update | ||
961 | * @param q_len number of messages that can be send through this queue | ||
962 | * @param priority queue priority. Queues with highest priority should be | ||
963 | * used | ||
964 | */ | ||
965 | void | 956 | void |
966 | GNUNET_TRANSPORT_communicator_mq_update ( | 957 | GNUNET_TRANSPORT_communicator_mq_update ( |
967 | struct GNUNET_TRANSPORT_CommunicatorHandle *ch, | 958 | struct GNUNET_TRANSPORT_CommunicatorHandle *ch, |
diff --git a/src/transport/transport_api_address_to_string.c b/src/transport/transport_api_address_to_string.c index c7de39ea8..5b234f802 100644 --- a/src/transport/transport_api_address_to_string.c +++ b/src/transport/transport_api_address_to_string.c | |||
@@ -56,7 +56,7 @@ struct GNUNET_TRANSPORT_AddressToStringContext | |||
56 | * Function called with responses from the service. | 56 | * Function called with responses from the service. |
57 | * | 57 | * |
58 | * @param cls our `struct GNUNET_TRANSPORT_AddressToStringContext *` | 58 | * @param cls our `struct GNUNET_TRANSPORT_AddressToStringContext *` |
59 | * @param msg message with the human-readable address | 59 | * @param atsm message with the human-readable address |
60 | * @return #GNUNET_OK if message is well-formed | 60 | * @return #GNUNET_OK if message is well-formed |
61 | */ | 61 | */ |
62 | static int | 62 | static int |
@@ -97,7 +97,7 @@ check_reply (void *cls, | |||
97 | * Function called with responses from the service. | 97 | * Function called with responses from the service. |
98 | * | 98 | * |
99 | * @param cls our `struct GNUNET_TRANSPORT_AddressToStringContext *` | 99 | * @param cls our `struct GNUNET_TRANSPORT_AddressToStringContext *` |
100 | * @param msg message with the human-readable address | 100 | * @param atsm message with the human-readable address |
101 | */ | 101 | */ |
102 | static void | 102 | static void |
103 | handle_reply (void *cls, | 103 | handle_reply (void *cls, |
diff --git a/src/transport/transport_api_cmd_backchannel_check.c b/src/transport/transport_api_cmd_backchannel_check.c index 4ffd96210..47a3190a3 100644 --- a/src/transport/transport_api_cmd_backchannel_check.c +++ b/src/transport/transport_api_cmd_backchannel_check.c | |||
@@ -557,18 +557,6 @@ backchannel_check_cleanup (void *cls) | |||
557 | } | 557 | } |
558 | 558 | ||
559 | 559 | ||
560 | /** | ||
561 | * Create command. | ||
562 | * | ||
563 | * @param label name for command. | ||
564 | * @param start_peer_label Label of the cmd to start a peer. | ||
565 | * @param create_label Label of the cmd to create the testing system. | ||
566 | * @param num Number globally identifying the node. | ||
567 | * @param node_n The number of the node in a network namespace. | ||
568 | * @param namespace_n The number of the network namespace. | ||
569 | * @param The topology for the test setup. | ||
570 | * @return command. | ||
571 | */ | ||
572 | struct GNUNET_TESTING_Command | 560 | struct GNUNET_TESTING_Command |
573 | GNUNET_TRANSPORT_cmd_backchannel_check (const char *label, | 561 | GNUNET_TRANSPORT_cmd_backchannel_check (const char *label, |
574 | const char *start_peer_label, | 562 | const char *start_peer_label, |
diff --git a/src/transport/transport_api_cmd_connecting_peers.c b/src/transport/transport_api_cmd_connecting_peers.c index 8aba290c3..5513e0d6c 100644 --- a/src/transport/transport_api_cmd_connecting_peers.c +++ b/src/transport/transport_api_cmd_connecting_peers.c | |||
@@ -220,17 +220,6 @@ connect_peers_traits (void *cls, | |||
220 | } | 220 | } |
221 | 221 | ||
222 | 222 | ||
223 | /** | ||
224 | * Create command | ||
225 | * | ||
226 | * @param label name for command | ||
227 | * @param start_peer_label Label of the cmd to start a peer. | ||
228 | * @param create_peer_label Label of the cmd which started the test system. | ||
229 | * @param num Number globally identifying the node. | ||
230 | * @param The topology for the test setup. | ||
231 | * @param additional_connects Number of additional connects this cmd will wait for not triggered by this cmd. | ||
232 | * @return command. | ||
233 | */ | ||
234 | struct GNUNET_TESTING_Command | 223 | struct GNUNET_TESTING_Command |
235 | GNUNET_TRANSPORT_cmd_connect_peers (const char *label, | 224 | GNUNET_TRANSPORT_cmd_connect_peers (const char *label, |
236 | const char *start_peer_label, | 225 | const char *start_peer_label, |
diff --git a/src/transport/transport_api_core.c b/src/transport/transport_api_core.c index 0ffaeb444..12612de09 100644 --- a/src/transport/transport_api_core.c +++ b/src/transport/transport_api_core.c | |||
@@ -713,7 +713,7 @@ handle_recv (void *cls, const struct InboundMessage *im) | |||
713 | * Function we use for handling incoming set quota messages. | 713 | * Function we use for handling incoming set quota messages. |
714 | * | 714 | * |
715 | * @param cls closure, a `struct GNUNET_TRANSPORT_CoreHandle *` | 715 | * @param cls closure, a `struct GNUNET_TRANSPORT_CoreHandle *` |
716 | * @param msg message received | 716 | * @param qm message received |
717 | */ | 717 | */ |
718 | static void | 718 | static void |
719 | handle_set_quota (void *cls, const struct QuotaSetMessage *qm) | 719 | handle_set_quota (void *cls, const struct QuotaSetMessage *qm) |