From f17707fd0e6c789f57c8b7c0b4a4b500f4cefd47 Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Mon, 7 Apr 2014 09:43:30 +0000 Subject: -doxygen --- src/dht/gnunet-service-dht_clients.c | 8 +++++--- src/dht/gnunet-service-dht_clients.h | 20 +++++++++++--------- src/dht/gnunet-service-dht_neighbours.h | 7 ++++--- 3 files changed, 20 insertions(+), 15 deletions(-) diff --git a/src/dht/gnunet-service-dht_clients.c b/src/dht/gnunet-service-dht_clients.c index 2ec3c180c..eb42f6747 100644 --- a/src/dht/gnunet-service-dht_clients.c +++ b/src/dht/gnunet-service-dht_clients.c @@ -110,7 +110,7 @@ struct ClientList /** - * Entry in the DHT routing table for a client's GET request. + * Entry in the local forwarding map for a client's GET request. */ struct ClientQueryRecord { @@ -253,7 +253,7 @@ static struct ClientMonitorRecord *monitor_head; static struct ClientMonitorRecord *monitor_tail; /** - * Hashmap for fast key based lookup, maps keys to 'struct ClientQueryRecord' entries. + * Hashmap for fast key based lookup, maps keys to `struct ClientQueryRecord` entries. */ static struct GNUNET_CONTAINER_MultiHashMap *forward_map; @@ -427,7 +427,9 @@ transmit_request (struct ClientQueryRecord *cqr) GNUNET_CONSTANTS_BLOOMFILTER_K); LOG (GNUNET_ERROR_TYPE_DEBUG, "Initiating GET for %s, replication %u, already have %u replies\n", - GNUNET_h2s(&cqr->key), cqr->replication, cqr->seen_replies_count); + GNUNET_h2s (&cqr->key), + cqr->replication, + cqr->seen_replies_count); GDS_NEIGHBOURS_handle_get (cqr->type, cqr->msg_options, cqr->replication, 0 /* hop count */ , &cqr->key, cqr->xquery, cqr->xquery_size, reply_bf, diff --git a/src/dht/gnunet-service-dht_clients.h b/src/dht/gnunet-service-dht_clients.h index 44491377e..81c876401 100644 --- a/src/dht/gnunet-service-dht_clients.h +++ b/src/dht/gnunet-service-dht_clients.h @@ -37,17 +37,17 @@ * * @param expiration when will the reply expire * @param key the query this reply is for - * @param get_path_length number of peers in 'get_path' + * @param get_path_length number of peers in @a get_path * @param get_path path the reply took on get - * @param put_path_length number of peers in 'put_path' + * @param put_path_length number of peers in @a put_path * @param put_path path the reply took on put * @param type type of the reply - * @param data_size number of bytes in 'data' + * @param data_size number of bytes in @a data * @param data application payload data */ void GDS_CLIENTS_handle_reply (struct GNUNET_TIME_Absolute expiration, - const struct GNUNET_HashCode * key, + const struct GNUNET_HashCode *key, unsigned int get_path_length, const struct GNUNET_PeerIdentity *get_path, unsigned int put_path_length, @@ -75,7 +75,8 @@ GDS_CLIENTS_process_get (uint32_t options, uint32_t desired_replication_level, unsigned int path_length, const struct GNUNET_PeerIdentity *path, - const struct GNUNET_HashCode * key); + const struct GNUNET_HashCode *key); + /** * Check if some client is monitoring GET RESP messages and notify @@ -83,13 +84,13 @@ GDS_CLIENTS_process_get (uint32_t options, * * @param type The type of data in the result. * @param get_path Peers on GET path (or NULL if not recorded). - * @param get_path_length number of entries in get_path. + * @param get_path_length number of entries in @a get_path. * @param put_path peers on the PUT path (or NULL if not recorded). - * @param put_path_length number of entries in get_path. + * @param put_path_length number of entries in @a get_path. * @param exp Expiration time of the data. - * @param key Key of the data. + * @param key Key of the @a data. * @param data Pointer to the result data. - * @param size Number of bytes in data. + * @param size Number of bytes in @a data. */ void GDS_CLIENTS_process_get_resp (enum GNUNET_BLOCK_Type type, @@ -102,6 +103,7 @@ GDS_CLIENTS_process_get_resp (enum GNUNET_BLOCK_Type type, const void *data, size_t size); + /** * Check if some client is monitoring PUT messages and notify * them in that case. diff --git a/src/dht/gnunet-service-dht_neighbours.h b/src/dht/gnunet-service-dht_neighbours.h index 225c4aae0..6eac593a0 100644 --- a/src/dht/gnunet-service-dht_neighbours.h +++ b/src/dht/gnunet-service-dht_neighbours.h @@ -75,16 +75,17 @@ GDS_NEIGHBOURS_handle_put (enum GNUNET_BLOCK_Type type, * @param hop_count how many hops did this request traverse so far? * @param key key for the content * @param xquery extended query - * @param xquery_size number of bytes in xquery + * @param xquery_size number of bytes in @a xquery * @param reply_bf bloomfilter to filter duplicates - * @param reply_bf_mutator mutator for reply_bf + * @param reply_bf_mutator mutator for @a reply_bf * @param peer_bf filter for peers not to select (again, updated) */ void GDS_NEIGHBOURS_handle_get (enum GNUNET_BLOCK_Type type, enum GNUNET_DHT_RouteOption options, uint32_t desired_replication_level, - uint32_t hop_count, const struct GNUNET_HashCode * key, + uint32_t hop_count, + const struct GNUNET_HashCode *key, const void *xquery, size_t xquery_size, const struct GNUNET_CONTAINER_BloomFilter *reply_bf, uint32_t reply_bf_mutator, -- cgit v1.2.3