aboutsummaryrefslogtreecommitdiff
path: root/src/include
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2011-08-29 10:19:43 +0000
committerChristian Grothoff <christian@grothoff.org>2011-08-29 10:19:43 +0000
commitcddbdf5b928c68ab71b40c950b9f01ea68a9fbdb (patch)
treeb704e00a3af618b2cd174a7f89514eaebd82a1cf /src/include
parentbb4fc4f4007988874f910d4de5492f9629301641 (diff)
downloadgnunet-cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb.tar.gz
gnunet-cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb.zip
run indent twice, it alternates between two 'canonical' forms, also run whitespace remover
Diffstat (limited to 'src/include')
-rw-r--r--src/include/block_fs.h2
-rw-r--r--src/include/gnunet_ats_service.h8
-rw-r--r--src/include/gnunet_block_lib.h8
-rw-r--r--src/include/gnunet_block_plugin.h8
-rw-r--r--src/include/gnunet_chat_service.h2
-rw-r--r--src/include/gnunet_client_lib.h4
-rw-r--r--src/include/gnunet_common.h4
-rw-r--r--src/include/gnunet_connection_lib.h2
-rw-r--r--src/include/gnunet_constants.h10
-rw-r--r--src/include/gnunet_container_lib.h12
-rw-r--r--src/include/gnunet_core_service.h8
-rw-r--r--src/include/gnunet_crypto_lib.h10
-rw-r--r--src/include/gnunet_datacache_plugin.h4
-rw-r--r--src/include/gnunet_datastore_plugin.h10
-rw-r--r--src/include/gnunet_datastore_service.h2
-rw-r--r--src/include/gnunet_disk_lib.h18
-rw-r--r--src/include/gnunet_fragmentation_lib.h2
-rw-r--r--src/include/gnunet_fs_service.h68
-rw-r--r--src/include/gnunet_getopt_lib.h8
-rw-r--r--src/include/gnunet_hello_lib.h4
-rw-r--r--src/include/gnunet_mesh_service.h8
-rw-r--r--src/include/gnunet_mesh_service_new.h4
-rw-r--r--src/include/gnunet_nat_lib.h8
-rw-r--r--src/include/gnunet_nse_service.h2
-rw-r--r--src/include/gnunet_os_lib.h2
-rw-r--r--src/include/gnunet_peer_lib.h2
-rw-r--r--src/include/gnunet_peerinfo_service.h8
-rw-r--r--src/include/gnunet_plugin_lib.h2
-rw-r--r--src/include/gnunet_protocols.h38
-rw-r--r--src/include/gnunet_pseudonym_lib.h2
-rw-r--r--src/include/gnunet_scheduler_lib.h2
-rw-r--r--src/include/gnunet_server_lib.h6
-rw-r--r--src/include/gnunet_statistics_service.h2
-rw-r--r--src/include/gnunet_time_lib.h4
-rw-r--r--src/include/gnunet_transport_plugin.h10
-rw-r--r--src/include/gnunet_transport_service.h4
36 files changed, 149 insertions, 149 deletions
diff --git a/src/include/block_fs.h b/src/include/block_fs.h
index c3dcdeced..9dc22e57f 100644
--- a/src/include/block_fs.h
+++ b/src/include/block_fs.h
@@ -140,7 +140,7 @@ struct NBlock
140 140
141 141
142/** 142/**
143 * @brief index block (indexing a DBlock that 143 * @brief index block (indexing a DBlock that
144 * can be obtained directly from reading 144 * can be obtained directly from reading
145 * the plaintext file) 145 * the plaintext file)
146 */ 146 */
diff --git a/src/include/gnunet_ats_service.h b/src/include/gnunet_ats_service.h
index 618eab0a6..9317ace43 100644
--- a/src/include/gnunet_ats_service.h
+++ b/src/include/gnunet_ats_service.h
@@ -25,7 +25,7 @@
25 * 25 *
26 * TODO: 26 * TODO:
27 * - move GNUNET_TRANSPORT_ATS* in here and rename... 27 * - move GNUNET_TRANSPORT_ATS* in here and rename...
28 * - extend API to express communication preferences to ATS 28 * - extend API to express communication preferences to ATS
29 * (to be called DIRECTLY from apps, not from transport/core!) 29 * (to be called DIRECTLY from apps, not from transport/core!)
30 */ 30 */
31#ifndef GNUNET_ATS_SERVICE_H 31#ifndef GNUNET_ATS_SERVICE_H
@@ -47,7 +47,7 @@ struct GNUNET_ATS_Handle;
47 * Signature of a function called by ATS to notify the callee that the 47 * Signature of a function called by ATS to notify the callee that the
48 * assigned bandwidth or address for a given peer was changed. If the 48 * assigned bandwidth or address for a given peer was changed. If the
49 * callback is called with address/bandwidth assignments of zero, the 49 * callback is called with address/bandwidth assignments of zero, the
50 * ATS disconnect function will still be called once the disconnect 50 * ATS disconnect function will still be called once the disconnect
51 * actually happened. 51 * actually happened.
52 * 52 *
53 * @param cls closure 53 * @param cls closure
@@ -99,7 +99,7 @@ GNUNET_ATS_shutdown (struct GNUNET_ATS_Handle *atc);
99 99
100 100
101/** 101/**
102 * Signature of a function that takes an address suggestion 102 * Signature of a function that takes an address suggestion
103 * 103 *
104 * @param cls closure 104 * @param cls closure
105 * @param peer identity of the new peer 105 * @param peer identity of the new peer
@@ -117,7 +117,7 @@ typedef void (*GNUNET_ATS_AddressSuggestionCallback) (void *cls,
117 const char *plugin_name, 117 const char *plugin_name,
118 const void *plugin_addr, 118 const void *plugin_addr,
119 size_t plugin_addr_len, 119 size_t plugin_addr_len,
120 struct Session *session, 120 struct Session * session,
121 struct 121 struct
122 GNUNET_BANDWIDTH_Value32NBO 122 GNUNET_BANDWIDTH_Value32NBO
123 bandwidth, 123 bandwidth,
diff --git a/src/include/gnunet_block_lib.h b/src/include/gnunet_block_lib.h
index 66b2490c0..01a1ec2fc 100644
--- a/src/include/gnunet_block_lib.h
+++ b/src/include/gnunet_block_lib.h
@@ -69,7 +69,7 @@ enum GNUNET_BLOCK_Type
69 GNUNET_BLOCK_TYPE_FS_SBLOCK = 4, 69 GNUNET_BLOCK_TYPE_FS_SBLOCK = 4,
70 70
71 /** 71 /**
72 * Type of a block that is used to advertise a namespace. 72 * Type of a block that is used to advertise a namespace.
73 */ 73 */
74 GNUNET_BLOCK_TYPE_FS_NBLOCK = 5, 74 GNUNET_BLOCK_TYPE_FS_NBLOCK = 5,
75 75
@@ -156,7 +156,7 @@ struct GNUNET_BLOCK_Context;
156 156
157/** 157/**
158 * Mingle hash with the mingle_number to produce different bits. 158 * Mingle hash with the mingle_number to produce different bits.
159 * 159 *
160 * @param in original hash code 160 * @param in original hash code
161 * @param mingle_number number for hash permutation 161 * @param mingle_number number for hash permutation
162 * @param hc where to store the result. 162 * @param hc where to store the result.
@@ -188,7 +188,7 @@ GNUNET_BLOCK_context_destroy (struct GNUNET_BLOCK_Context *ctx);
188/** 188/**
189 * Function called to validate a reply or a request. For 189 * Function called to validate a reply or a request. For
190 * request evaluation, simply pass "NULL" for the reply_block. 190 * request evaluation, simply pass "NULL" for the reply_block.
191 * Note that it is assumed that the reply has already been 191 * Note that it is assumed that the reply has already been
192 * matched to the key (and signatures checked) as it would 192 * matched to the key (and signatures checked) as it would
193 * be done with the "get_key" function. 193 * be done with the "get_key" function.
194 * 194 *
@@ -221,7 +221,7 @@ GNUNET_BLOCK_evaluate (struct GNUNET_BLOCK_Context *ctx,
221 * @param block block to get the key for 221 * @param block block to get the key for
222 * @param block_size number of bytes in block 222 * @param block_size number of bytes in block
223 * @param key set to the key (query) for the given block 223 * @param key set to the key (query) for the given block
224 * @return GNUNET_YES on success, 224 * @return GNUNET_YES on success,
225 * GNUNET_NO if the block is malformed 225 * GNUNET_NO if the block is malformed
226 * GNUNET_SYSERR if type not supported 226 * GNUNET_SYSERR if type not supported
227 * (or if extracting a key from a block of this type does not work) 227 * (or if extracting a key from a block of this type does not work)
diff --git a/src/include/gnunet_block_plugin.h b/src/include/gnunet_block_plugin.h
index 6d1f2f103..0ead4afad 100644
--- a/src/include/gnunet_block_plugin.h
+++ b/src/include/gnunet_block_plugin.h
@@ -20,7 +20,7 @@
20 20
21/** 21/**
22 * @file include/gnunet_block_plugin.h 22 * @file include/gnunet_block_plugin.h
23 * @brief API for block plugins. Each block plugin must conform to 23 * @brief API for block plugins. Each block plugin must conform to
24 * the API specified by this header. 24 * the API specified by this header.
25 * @author Christian Grothoff 25 * @author Christian Grothoff
26 */ 26 */
@@ -35,7 +35,7 @@
35/** 35/**
36 * Function called to validate a reply or a request. For 36 * Function called to validate a reply or a request. For
37 * request evaluation, simply pass "NULL" for the reply_block. 37 * request evaluation, simply pass "NULL" for the reply_block.
38 * Note that it is assumed that the reply has already been 38 * Note that it is assumed that the reply has already been
39 * matched to the key (and signatures checked) as it would 39 * matched to the key (and signatures checked) as it would
40 * be done with the "get_key" function. 40 * be done with the "get_key" function.
41 * 41 *
@@ -81,7 +81,7 @@ typedef enum
81 * @param block block to get the key for 81 * @param block block to get the key for
82 * @param block_size number of bytes in block 82 * @param block_size number of bytes in block
83 * @param key set to the key (query) for the given block 83 * @param key set to the key (query) for the given block
84 * @return GNUNET_YES on success, 84 * @return GNUNET_YES on success,
85 * GNUNET_NO if the block is malformed 85 * GNUNET_NO if the block is malformed
86 * GNUNET_SYSERR if type not supported 86 * GNUNET_SYSERR if type not supported
87 * (or if extracting a key from a block of this type does not work) 87 * (or if extracting a key from a block of this type does not work)
@@ -112,7 +112,7 @@ struct GNUNET_BLOCK_PluginFunctions
112 const enum GNUNET_BLOCK_Type *types; 112 const enum GNUNET_BLOCK_Type *types;
113 113
114 /** 114 /**
115 * Main function of a block plugin. Allows us to check if a 115 * Main function of a block plugin. Allows us to check if a
116 * block matches a query. 116 * block matches a query.
117 */ 117 */
118 GNUNET_BLOCK_EvaluationFunction evaluate; 118 GNUNET_BLOCK_EvaluationFunction evaluate;
diff --git a/src/include/gnunet_chat_service.h b/src/include/gnunet_chat_service.h
index 5eb0daf3f..938b43423 100644
--- a/src/include/gnunet_chat_service.h
+++ b/src/include/gnunet_chat_service.h
@@ -20,7 +20,7 @@
20 20
21/** 21/**
22 * @file include/gnunet_chat_service.h 22 * @file include/gnunet_chat_service.h
23 * @brief API for chatting via GNUnet 23 * @brief API for chatting via GNUnet
24 * @author Christian Grothoff 24 * @author Christian Grothoff
25 * @author Nathan Evans 25 * @author Nathan Evans
26 * @author Vitaly Minko 26 * @author Vitaly Minko
diff --git a/src/include/gnunet_client_lib.h b/src/include/gnunet_client_lib.h
index ed033d031..64892de0f 100644
--- a/src/include/gnunet_client_lib.h
+++ b/src/include/gnunet_client_lib.h
@@ -163,7 +163,7 @@ GNUNET_CLIENT_notify_transmit_ready (struct GNUNET_CLIENT_Connection *sock,
163 163
164/** 164/**
165 * Cancel a request for notification. 165 * Cancel a request for notification.
166 * 166 *
167 * @param th handle from the original request. 167 * @param th handle from the original request.
168 */ 168 */
169void 169void
@@ -188,7 +188,7 @@ GNUNET_CLIENT_notify_transmit_ready_cancel (struct GNUNET_CLIENT_TransmitHandle
188 * if the caller does not care about temporary connection errors, 188 * if the caller does not care about temporary connection errors,
189 * for example because the protocol is stateless 189 * for example because the protocol is stateless
190 * @param rn function to call with the response 190 * @param rn function to call with the response
191 * @param rn_cls closure for rn 191 * @param rn_cls closure for rn
192 * @return GNUNET_OK on success, GNUNET_SYSERR if a request 192 * @return GNUNET_OK on success, GNUNET_SYSERR if a request
193 * is already pending 193 * is already pending
194 */ 194 */
diff --git a/src/include/gnunet_common.h b/src/include/gnunet_common.h
index 2636824d3..b8a667524 100644
--- a/src/include/gnunet_common.h
+++ b/src/include/gnunet_common.h
@@ -235,7 +235,7 @@ GNUNET_logger_remove (GNUNET_Logger logger, void *logger_cls);
235 * NOT reentrant! 235 * NOT reentrant!
236 * 236 *
237 * @param hc the hash code 237 * @param hc the hash code
238 * @return string 238 * @return string
239 */ 239 */
240const char * 240const char *
241GNUNET_h2s (const GNUNET_HashCode * hc); 241GNUNET_h2s (const GNUNET_HashCode * hc);
@@ -368,7 +368,7 @@ GNUNET_htonll (unsigned long long n);
368 368
369/** 369/**
370 * Allocate and initialize a block of memory. 370 * Allocate and initialize a block of memory.
371 * 371 *
372 * @param buf data to initalize the block with 372 * @param buf data to initalize the block with
373 * @param size the number of bytes in buf (and size of the allocation) 373 * @param size the number of bytes in buf (and size of the allocation)
374 * @return pointer to size bytes of memory, never NULL (!) 374 * @return pointer to size bytes of memory, never NULL (!)
diff --git a/src/include/gnunet_connection_lib.h b/src/include/gnunet_connection_lib.h
index f7a6e5078..7ee3c109d 100644
--- a/src/include/gnunet_connection_lib.h
+++ b/src/include/gnunet_connection_lib.h
@@ -232,7 +232,7 @@ GNUNET_CONNECTION_get_address (struct GNUNET_CONNECTION_Handle *sock,
232/** 232/**
233 * Close the socket and free associated resources. Pending 233 * Close the socket and free associated resources. Pending
234 * transmissions may be completed or dropped depending on the 234 * transmissions may be completed or dropped depending on the
235 * arguments. If a receive call is pending and should 235 * arguments. If a receive call is pending and should
236 * NOT be completed, 'GNUNET_CONNECTION_receive_cancel' 236 * NOT be completed, 'GNUNET_CONNECTION_receive_cancel'
237 * should be called explicitly first. 237 * should be called explicitly first.
238 * 238 *
diff --git a/src/include/gnunet_constants.h b/src/include/gnunet_constants.h
index da408bf55..190cabbb0 100644
--- a/src/include/gnunet_constants.h
+++ b/src/include/gnunet_constants.h
@@ -69,7 +69,7 @@ extern "C"
69#define GNUNET_CONSTANTS_EXEC_WAIT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS, 200) 69#define GNUNET_CONSTANTS_EXEC_WAIT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS, 200)
70 70
71/** 71/**
72 * After how long do we retry a service connection that was 72 * After how long do we retry a service connection that was
73 * unavailable? Used in cases where an exponential back-off 73 * unavailable? Used in cases where an exponential back-off
74 * seems inappropriate. 74 * seems inappropriate.
75 */ 75 */
@@ -99,13 +99,13 @@ extern "C"
99 99
100/** 100/**
101 * Size of the 'struct EncryptedMessage' of the core (which 101 * Size of the 'struct EncryptedMessage' of the core (which
102 * is the per-message overhead of the core). 102 * is the per-message overhead of the core).
103 */ 103 */
104#define GNUNET_CONSTANTS_CORE_SIZE_ENCRYPTED_MESSAGE (24 + sizeof (GNUNET_HashCode)) 104#define GNUNET_CONSTANTS_CORE_SIZE_ENCRYPTED_MESSAGE (24 + sizeof (GNUNET_HashCode))
105 105
106/** 106/**
107 * Size of the 'struct OutboundMessage' of the transport 107 * Size of the 'struct OutboundMessage' of the transport
108 * (which, in combination with the 108 * (which, in combination with the
109 * GNUNET_CONSTANTS_CORE_SIZE_ENCRYPTED_MESSAGE) defines 109 * GNUNET_CONSTANTS_CORE_SIZE_ENCRYPTED_MESSAGE) defines
110 * the headers that must be pre-pendable to all GNUnet 110 * the headers that must be pre-pendable to all GNUnet
111 * messages. Taking GNUNET_SERVER_MAX_MESSAGE_SIZE 111 * messages. Taking GNUNET_SERVER_MAX_MESSAGE_SIZE
@@ -123,7 +123,7 @@ extern "C"
123 * 123 *
124 * Could theoretically be 64k minus (GNUNET_CONSTANTS_CORE_SIZE_ENCRYPTED_MESSAGE + 124 * Could theoretically be 64k minus (GNUNET_CONSTANTS_CORE_SIZE_ENCRYPTED_MESSAGE +
125 * GNUNET_CONSTANTS_TRANSPORT_SIZE_OUTBOUND_MESSAGE), but we're going 125 * GNUNET_CONSTANTS_TRANSPORT_SIZE_OUTBOUND_MESSAGE), but we're going
126 * to be more conservative for now. 126 * to be more conservative for now.
127 */ 127 */
128#define GNUNET_CONSTANTS_MAX_ENCRYPTED_MESSAGE_SIZE (63 * 1024) 128#define GNUNET_CONSTANTS_MAX_ENCRYPTED_MESSAGE_SIZE (63 * 1024)
129 129
diff --git a/src/include/gnunet_container_lib.h b/src/include/gnunet_container_lib.h
index cad85d016..0c7f60a7a 100644
--- a/src/include/gnunet_container_lib.h
+++ b/src/include/gnunet_container_lib.h
@@ -239,7 +239,7 @@ struct GNUNET_CONTAINER_MetaData;
239 239
240/** 240/**
241 * Create a fresh MetaData token. 241 * Create a fresh MetaData token.
242 * 242 *
243 * @return empty meta-data container 243 * @return empty meta-data container
244 */ 244 */
245struct GNUNET_CONTAINER_MetaData * 245struct GNUNET_CONTAINER_MetaData *
@@ -247,7 +247,7 @@ GNUNET_CONTAINER_meta_data_create (void);
247 247
248/** 248/**
249 * Duplicate a MetaData token. 249 * Duplicate a MetaData token.
250 * 250 *
251 * @param md what to duplicate 251 * @param md what to duplicate
252 * @return duplicate meta-data container 252 * @return duplicate meta-data container
253 */ 253 */
@@ -289,7 +289,7 @@ GNUNET_CONTAINER_meta_data_test_equal (const struct GNUNET_CONTAINER_MetaData
289 * used in the main libextractor library and yielding 289 * used in the main libextractor library and yielding
290 * meta data). 290 * meta data).
291 * @param type libextractor-type describing the meta data 291 * @param type libextractor-type describing the meta data
292 * @param format basic format information about data 292 * @param format basic format information about data
293 * @param data_mime_type mime-type of data (not of the original file); 293 * @param data_mime_type mime-type of data (not of the original file);
294 * can be NULL (if mime-type is not known) 294 * can be NULL (if mime-type is not known)
295 * @param data actual meta-data found 295 * @param data actual meta-data found
@@ -999,7 +999,7 @@ GNUNET_CONTAINER_heap_remove_root (struct GNUNET_CONTAINER_Heap *heap);
999 999
1000/** 1000/**
1001 * Removes a node from the heap. 1001 * Removes a node from the heap.
1002 * 1002 *
1003 * @param node node to remove 1003 * @param node node to remove
1004 * @return element data stored at the node, NULL if heap is empty 1004 * @return element data stored at the node, NULL if heap is empty
1005 */ 1005 */
@@ -1047,12 +1047,12 @@ enum GNUNET_CONTAINER_SListDisposition
1047 1047
1048 1048
1049/** 1049/**
1050 * Handle to a singly linked list 1050 * Handle to a singly linked list
1051 */ 1051 */
1052struct GNUNET_CONTAINER_SList; 1052struct GNUNET_CONTAINER_SList;
1053 1053
1054/** 1054/**
1055 * Handle to a singly linked list iterator 1055 * Handle to a singly linked list iterator
1056 */ 1056 */
1057struct GNUNET_CONTAINER_SList_Iterator; 1057struct GNUNET_CONTAINER_SList_Iterator;
1058 1058
diff --git a/src/include/gnunet_core_service.h b/src/include/gnunet_core_service.h
index 083276804..0fcff6d6f 100644
--- a/src/include/gnunet_core_service.h
+++ b/src/include/gnunet_core_service.h
@@ -201,7 +201,7 @@ typedef void (*GNUNET_CORE_StartupCallback) (void *cls,
201 * can be used to improve efficiency, ignored if inbound_notify is NULL 201 * can be used to improve efficiency, ignored if inbound_notify is NULL
202 * note that the core is allowed to drop notifications about inbound 202 * note that the core is allowed to drop notifications about inbound
203 * messages if the client does not process them fast enough (for this 203 * messages if the client does not process them fast enough (for this
204 * notification type, a bounded queue is used) 204 * notification type, a bounded queue is used)
205 * @param outbound_notify function to call for all outbound messages, can be NULL; 205 * @param outbound_notify function to call for all outbound messages, can be NULL;
206 * note that the core is allowed to drop notifications about outbound 206 * note that the core is allowed to drop notifications about outbound
207 * messages if the client does not process them fast enough (for this 207 * messages if the client does not process them fast enough (for this
@@ -234,7 +234,7 @@ GNUNET_CORE_connect (const struct GNUNET_CONFIGURATION_Handle *cfg,
234 234
235 235
236/** 236/**
237 * Disconnect from the core service. This function can only 237 * Disconnect from the core service. This function can only
238 * be called *after* all pending 'GNUNET_CORE_notify_transmit_ready' 238 * be called *after* all pending 'GNUNET_CORE_notify_transmit_ready'
239 * requests have been explicitly cancelled. 239 * requests have been explicitly cancelled.
240 * 240 *
@@ -371,7 +371,7 @@ GNUNET_CORE_peer_change_preference (struct GNUNET_CORE_Handle *h,
371/** 371/**
372 * Cancel request for getting information about a peer. 372 * Cancel request for getting information about a peer.
373 * Note that an eventual change in preference, trust or bandwidth 373 * Note that an eventual change in preference, trust or bandwidth
374 * assignment MAY have already been committed at the time, 374 * assignment MAY have already been committed at the time,
375 * so cancelling a request is NOT sure to undo the original 375 * so cancelling a request is NOT sure to undo the original
376 * request. The original request may or may not still commit. 376 * request. The original request may or may not still commit.
377 * The only thing cancellation ensures is that the callback 377 * The only thing cancellation ensures is that the callback
@@ -429,7 +429,7 @@ struct GNUNET_CORE_TransmitHandle;
429 * given number of bytes to the specified "target". Must only be 429 * given number of bytes to the specified "target". Must only be
430 * called after a connection to the respective peer has been 430 * called after a connection to the respective peer has been
431 * established (and the client has been informed about this). 431 * established (and the client has been informed about this).
432 * 432 *
433 * 433 *
434 * @param handle connection to core service 434 * @param handle connection to core service
435 * @param cork is corking allowed for this transmission? 435 * @param cork is corking allowed for this transmission?
diff --git a/src/include/gnunet_crypto_lib.h b/src/include/gnunet_crypto_lib.h
index d5a1685d1..f97b351c9 100644
--- a/src/include/gnunet_crypto_lib.h
+++ b/src/include/gnunet_crypto_lib.h
@@ -247,7 +247,7 @@ GNUNET_CRYPTO_random_u32 (enum GNUNET_CRYPTO_Quality mode, uint32_t i);
247 247
248 248
249/** 249/**
250 * Random on unsigned 64-bit values. 250 * Random on unsigned 64-bit values.
251 * 251 *
252 * @param mode desired quality of the random number 252 * @param mode desired quality of the random number
253 * @param max value returned will be in range [0,max) (exclusive) 253 * @param max value returned will be in range [0,max) (exclusive)
@@ -471,7 +471,7 @@ GNUNET_CRYPTO_hash_create_random (enum GNUNET_CRYPTO_Quality mode,
471 * 471 *
472 * @param a some hash code 472 * @param a some hash code
473 * @param b some hash code 473 * @param b some hash code
474 * @param result set to b - a 474 * @param result set to b - a
475 */ 475 */
476void 476void
477GNUNET_CRYPTO_hash_difference (const GNUNET_HashCode * a, 477GNUNET_CRYPTO_hash_difference (const GNUNET_HashCode * a,
@@ -497,7 +497,7 @@ GNUNET_CRYPTO_hash_sum (const GNUNET_HashCode * a,
497 * 497 *
498 * @param a some hash code 498 * @param a some hash code
499 * @param b some hash code 499 * @param b some hash code
500 * @param result set to a ^ b 500 * @param result set to a ^ b
501 */ 501 */
502void 502void
503GNUNET_CRYPTO_hash_xor (const GNUNET_HashCode * a, const GNUNET_HashCode * b, 503GNUNET_CRYPTO_hash_xor (const GNUNET_HashCode * a, const GNUNET_HashCode * b,
@@ -693,7 +693,7 @@ GNUNET_CRYPTO_rsa_decode_key (const char *buf, uint16_t len);
693 * files does not exist, create a new key and write it to the 693 * files does not exist, create a new key and write it to the
694 * file. Caller must free return value. Note that this function 694 * file. Caller must free return value. Note that this function
695 * can not guarantee that another process might not be trying 695 * can not guarantee that another process might not be trying
696 * the same operation on the same file at the same time. 696 * the same operation on the same file at the same time.
697 * If the contents of the file 697 * If the contents of the file
698 * are invalid the old file is deleted and a fresh key is 698 * are invalid the old file is deleted and a fresh key is
699 * created. 699 * created.
@@ -807,7 +807,7 @@ GNUNET_CRYPTO_rsa_verify (uint32_t purpose,
807/** 807/**
808 * This function should only be called in testcases 808 * This function should only be called in testcases
809 * where strong entropy gathering is not desired 809 * where strong entropy gathering is not desired
810 * (for example, for hostkey generation). 810 * (for example, for hostkey generation).
811 */ 811 */
812void 812void
813GNUNET_CRYPTO_random_disable_entropy_gathering (void); 813GNUNET_CRYPTO_random_disable_entropy_gathering (void);
diff --git a/src/include/gnunet_datacache_plugin.h b/src/include/gnunet_datacache_plugin.h
index 6868d6b76..fbfcdf1e8 100644
--- a/src/include/gnunet_datacache_plugin.h
+++ b/src/include/gnunet_datacache_plugin.h
@@ -40,7 +40,7 @@ extern "C"
40/** 40/**
41 * Function called by plugins to notify the datacache 41 * Function called by plugins to notify the datacache
42 * about content deletions. 42 * about content deletions.
43 * 43 *
44 * @param cls closure 44 * @param cls closure
45 * @param key key of the content that was deleted 45 * @param key key of the content that was deleted
46 * @param size number of bytes that were made available 46 * @param size number of bytes that were made available
@@ -133,7 +133,7 @@ struct GNUNET_DATACACHE_PluginFunctions
133 /** 133 /**
134 * Delete the entry with the lowest expiration value 134 * Delete the entry with the lowest expiration value
135 * from the datacache right now. 135 * from the datacache right now.
136 * 136 *
137 * @param cls closure (internal context for the plugin) 137 * @param cls closure (internal context for the plugin)
138 * @return GNUNET_OK on success, GNUNET_SYSERR on error 138 * @return GNUNET_OK on success, GNUNET_SYSERR on error
139 */ 139 */
diff --git a/src/include/gnunet_datastore_plugin.h b/src/include/gnunet_datastore_plugin.h
index b0aa0c6c9..fb1dff51d 100644
--- a/src/include/gnunet_datastore_plugin.h
+++ b/src/include/gnunet_datastore_plugin.h
@@ -45,7 +45,7 @@
45 * changes. 45 * changes.
46 * 46 *
47 * @param cls closure 47 * @param cls closure
48 * @param delta change in disk utilization, 48 * @param delta change in disk utilization,
49 * 0 for "reset to empty" 49 * 0 for "reset to empty"
50 */ 50 */
51typedef void (*DiskUtilizationChange) (void *cls, int delta); 51typedef void (*DiskUtilizationChange) (void *cls, int delta);
@@ -138,7 +138,7 @@ typedef int (*PluginPut) (void *cls, const GNUNET_HashCode * key, uint32_t size,
138 * Get one of the results for a particular key in the datastore. 138 * Get one of the results for a particular key in the datastore.
139 * 139 *
140 * @param cls closure 140 * @param cls closure
141 * @param offset offset of the result (modulo num-results); 141 * @param offset offset of the result (modulo num-results);
142 * specific ordering does not matter for the offset 142 * specific ordering does not matter for the offset
143 * @param key key to match, never NULL 143 * @param key key to match, never NULL
144 * @param vhash hash of the value, maybe NULL (to 144 * @param vhash hash of the value, maybe NULL (to
@@ -148,7 +148,7 @@ typedef int (*PluginPut) (void *cls, const GNUNET_HashCode * key, uint32_t size,
148 * there may be! 148 * there may be!
149 * @param type entries of which type are relevant? 149 * @param type entries of which type are relevant?
150 * Use 0 for any type. 150 * Use 0 for any type.
151 * @param proc function to call on the matching value; 151 * @param proc function to call on the matching value;
152 * proc should be called with NULL if there is no result 152 * proc should be called with NULL if there is no result
153 * @param proc_cls closure for proc 153 * @param proc_cls closure for proc
154 */ 154 */
@@ -203,10 +203,10 @@ typedef int (*PluginUpdate) (void *cls, uint64_t uid, int delta,
203 203
204/** 204/**
205 * Select a single item from the datastore at the specified offset 205 * Select a single item from the datastore at the specified offset
206 * (among those applicable). 206 * (among those applicable).
207 * 207 *
208 * @param cls closure 208 * @param cls closure
209 * @param offset offset of the result (modulo num-results); 209 * @param offset offset of the result (modulo num-results);
210 * specific ordering does not matter for the offset 210 * specific ordering does not matter for the offset
211 * @param type entries of which type should be considered? 211 * @param type entries of which type should be considered?
212 * Must not be zero (ANY). 212 * Must not be zero (ANY).
diff --git a/src/include/gnunet_datastore_service.h b/src/include/gnunet_datastore_service.h
index 3d2cc35c9..03ec9117c 100644
--- a/src/include/gnunet_datastore_service.h
+++ b/src/include/gnunet_datastore_service.h
@@ -371,7 +371,7 @@ GNUNET_DATASTORE_get_for_replication (struct GNUNET_DATASTORE_Handle *h,
371/** 371/**
372 * Cancel a datastore operation. The final callback from the 372 * Cancel a datastore operation. The final callback from the
373 * operation must not have been done yet. 373 * operation must not have been done yet.
374 * 374 *
375 * @param qe operation to cancel 375 * @param qe operation to cancel
376 */ 376 */
377void 377void
diff --git a/src/include/gnunet_disk_lib.h b/src/include/gnunet_disk_lib.h
index abca17370..5f6a37840 100644
--- a/src/include/gnunet_disk_lib.h
+++ b/src/include/gnunet_disk_lib.h
@@ -103,37 +103,37 @@ enum GNUNET_DISK_OpenFlags
103{ 103{
104 104
105 /** 105 /**
106 * Open the file for reading 106 * Open the file for reading
107 */ 107 */
108 GNUNET_DISK_OPEN_READ = 1, 108 GNUNET_DISK_OPEN_READ = 1,
109 109
110 /** 110 /**
111 * Open the file for writing 111 * Open the file for writing
112 */ 112 */
113 GNUNET_DISK_OPEN_WRITE = 2, 113 GNUNET_DISK_OPEN_WRITE = 2,
114 114
115 /** 115 /**
116 * Open the file for both reading and writing 116 * Open the file for both reading and writing
117 */ 117 */
118 GNUNET_DISK_OPEN_READWRITE = 3, 118 GNUNET_DISK_OPEN_READWRITE = 3,
119 119
120 /** 120 /**
121 * Fail if file already exists 121 * Fail if file already exists
122 */ 122 */
123 GNUNET_DISK_OPEN_FAILIFEXISTS = 4, 123 GNUNET_DISK_OPEN_FAILIFEXISTS = 4,
124 124
125 /** 125 /**
126 * Truncate file if it exists 126 * Truncate file if it exists
127 */ 127 */
128 GNUNET_DISK_OPEN_TRUNCATE = 8, 128 GNUNET_DISK_OPEN_TRUNCATE = 8,
129 129
130 /** 130 /**
131 * Create file if it doesn't exist 131 * Create file if it doesn't exist
132 */ 132 */
133 GNUNET_DISK_OPEN_CREATE = 16, 133 GNUNET_DISK_OPEN_CREATE = 16,
134 134
135 /** 135 /**
136 * Append to the file 136 * Append to the file
137 */ 137 */
138 GNUNET_DISK_OPEN_APPEND = 32 138 GNUNET_DISK_OPEN_APPEND = 32
139}; 139};
@@ -342,7 +342,7 @@ GNUNET_DISK_file_get_identifiers (const char *filename, uint64_t * dev,
342 * an absolute path, the current 'TMPDIR' will be prepended. In any case, 342 * an absolute path, the current 'TMPDIR' will be prepended. In any case,
343 * 6 random characters will be appended to the name to create a unique 343 * 6 random characters will be appended to the name to create a unique
344 * filename. 344 * filename.
345 * 345 *
346 * @param t component to use for the name; 346 * @param t component to use for the name;
347 * does NOT contain "XXXXXX" or "/tmp/". 347 * does NOT contain "XXXXXX" or "/tmp/".
348 * @return NULL on error, otherwise name of fresh 348 * @return NULL on error, otherwise name of fresh
@@ -463,7 +463,7 @@ GNUNET_DISK_file_write (const struct GNUNET_DISK_FileHandle *h,
463 * @param fn file name 463 * @param fn file name
464 * @param buffer the data to write 464 * @param buffer the data to write
465 * @param n number of bytes to write 465 * @param n number of bytes to write
466 * @param mode file permissions 466 * @param mode file permissions
467 * @return number of bytes written on success, GNUNET_SYSERR on error 467 * @return number of bytes written on success, GNUNET_SYSERR on error
468 */ 468 */
469ssize_t 469ssize_t
diff --git a/src/include/gnunet_fragmentation_lib.h b/src/include/gnunet_fragmentation_lib.h
index 06022e093..a953bd2b1 100644
--- a/src/include/gnunet_fragmentation_lib.h
+++ b/src/include/gnunet_fragmentation_lib.h
@@ -154,7 +154,7 @@ typedef void (*GNUNET_DEFRAGMENT_AckProcessor) (void *cls, uint32_t id,
154 * Create a defragmentation context. 154 * Create a defragmentation context.
155 * 155 *
156 * @param stats statistics context 156 * @param stats statistics context
157 * @param mtu the maximum message size for each fragment 157 * @param mtu the maximum message size for each fragment
158 * @param num_msgs how many fragmented messages 158 * @param num_msgs how many fragmented messages
159 * to we defragment at most at the same time? 159 * to we defragment at most at the same time?
160 * @param cls closure for proc and ackp 160 * @param cls closure for proc and ackp
diff --git a/src/include/gnunet_fs_service.h b/src/include/gnunet_fs_service.h
index e8026a66f..7bfb15ac0 100644
--- a/src/include/gnunet_fs_service.h
+++ b/src/include/gnunet_fs_service.h
@@ -19,7 +19,7 @@
19*/ 19*/
20/** 20/**
21 * @file include/gnunet_fs_service.h 21 * @file include/gnunet_fs_service.h
22 * @brief API for file-sharing via GNUnet 22 * @brief API for file-sharing via GNUnet
23 * @author Christian Grothoff 23 * @author Christian Grothoff
24 */ 24 */
25#ifndef GNUNET_FS_LIB_H 25#ifndef GNUNET_FS_LIB_H
@@ -105,7 +105,7 @@ GNUNET_FS_uri_to_string (const struct GNUNET_FS_Uri *uri);
105 * Convert keyword URI to a human readable format 105 * Convert keyword URI to a human readable format
106 * (i.e. the search query that was used in the first place) 106 * (i.e. the search query that was used in the first place)
107 * 107 *
108 * @param uri ksk uri to convert to a string 108 * @param uri ksk uri to convert to a string
109 * @return string with the keywords 109 * @return string with the keywords
110 */ 110 */
111char * 111char *
@@ -232,7 +232,7 @@ GNUNET_FS_uri_loc_create (const struct GNUNET_FS_Uri *baseUri,
232 * as decapitalization and removal of certain characters. 232 * as decapitalization and removal of certain characters.
233 * (useful for search). 233 * (useful for search).
234 * 234 *
235 * @param uri the URI to canonicalize 235 * @param uri the URI to canonicalize
236 * @return canonicalized version of the URI, NULL on error 236 * @return canonicalized version of the URI, NULL on error
237 */ 237 */
238struct GNUNET_FS_Uri * 238struct GNUNET_FS_Uri *
@@ -490,13 +490,13 @@ GNUNET_FS_getopt_set_metadata (struct GNUNET_GETOPT_CommandLineProcessorContext
490 490
491 491
492/** 492/**
493 * Possible status codes used in the callback for the 493 * Possible status codes used in the callback for the
494 * various file-sharing operations. On each file (or search), 494 * various file-sharing operations. On each file (or search),
495 * the callback is guaranteed to be called once with "START" 495 * the callback is guaranteed to be called once with "START"
496 * and once with STOPPED; calls with PROGRESS, ERROR or COMPLETED 496 * and once with STOPPED; calls with PROGRESS, ERROR or COMPLETED
497 * are optional and depend on the circumstances; parent operations 497 * are optional and depend on the circumstances; parent operations
498 * will be STARTED before child-operations and STOPPED after 498 * will be STARTED before child-operations and STOPPED after
499 * their respective child-operations. START and STOP signals 499 * their respective child-operations. START and STOP signals
500 * are typically generated either due to explicit client requests 500 * are typically generated either due to explicit client requests
501 * or because of suspend/resume operations. 501 * or because of suspend/resume operations.
502 */ 502 */
@@ -602,7 +602,7 @@ enum GNUNET_FS_Status
602 GNUNET_FS_STATUS_DOWNLOAD_LOST_PARENT, 602 GNUNET_FS_STATUS_DOWNLOAD_LOST_PARENT,
603 603
604 /** 604 /**
605 * First event generated when a client requests 605 * First event generated when a client requests
606 * a search to begin or when a namespace result 606 * a search to begin or when a namespace result
607 * automatically triggers the search for updates. 607 * automatically triggers the search for updates.
608 */ 608 */
@@ -807,7 +807,7 @@ struct GNUNET_FS_ProgressInfo
807 /** 807 /**
808 * How large is the file overall? For directories, 808 * How large is the file overall? For directories,
809 * this is only the size of the directory itself, 809 * this is only the size of the directory itself,
810 * not of the other files contained within the 810 * not of the other files contained within the
811 * directory. 811 * directory.
812 */ 812 */
813 uint64_t size; 813 uint64_t size;
@@ -864,7 +864,7 @@ struct GNUNET_FS_ProgressInfo
864 uint64_t data_len; 864 uint64_t data_len;
865 865
866 /** 866 /**
867 * Depth of the given block in the tree; 867 * Depth of the given block in the tree;
868 * 0 would be the lowest level (DBLOCKs). 868 * 0 would be the lowest level (DBLOCKs).
869 */ 869 */
870 unsigned int depth; 870 unsigned int depth;
@@ -950,7 +950,7 @@ struct GNUNET_FS_ProgressInfo
950 /** 950 /**
951 * Client context pointer for the associated search operation 951 * Client context pointer for the associated search operation
952 * (specifically, context pointer for the specific search 952 * (specifically, context pointer for the specific search
953 * result, not the overall search); only set if this 953 * result, not the overall search); only set if this
954 * download was started from a search result. 954 * download was started from a search result.
955 */ 955 */
956 void *sctx; 956 void *sctx;
@@ -1031,7 +1031,7 @@ struct GNUNET_FS_ProgressInfo
1031 uint64_t data_len; 1031 uint64_t data_len;
1032 1032
1033 /** 1033 /**
1034 * Depth of the given block in the tree; 1034 * Depth of the given block in the tree;
1035 * 0 would be the lowest level (DBLOCKS). 1035 * 0 would be the lowest level (DBLOCKS).
1036 */ 1036 */
1037 unsigned int depth; 1037 unsigned int depth;
@@ -1266,7 +1266,7 @@ struct GNUNET_FS_ProgressInfo
1266 * These values are only valid for 1266 * These values are only valid for
1267 * GNUNET_FS_STATUS_SEARCH_RESULT_SUSPEND events. 1267 * GNUNET_FS_STATUS_SEARCH_RESULT_SUSPEND events.
1268 * These events are automatically triggered for 1268 * These events are automatically triggered for
1269 * each search result before the 1269 * each search result before the
1270 * GNUNET_FS_STATUS_SEARCH_SUSPEND event. This 1270 * GNUNET_FS_STATUS_SEARCH_SUSPEND event. This
1271 * happens primarily to give the client a chance 1271 * happens primarily to give the client a chance
1272 * to clean up the "cctx" (if needed). 1272 * to clean up the "cctx" (if needed).
@@ -1296,7 +1296,7 @@ struct GNUNET_FS_ProgressInfo
1296 * These values are only valid for 1296 * These values are only valid for
1297 * GNUNET_FS_STATUS_SEARCH_RESULT_STOPPED events. 1297 * GNUNET_FS_STATUS_SEARCH_RESULT_STOPPED events.
1298 * These events are automatically triggered for 1298 * These events are automatically triggered for
1299 * each search result before the 1299 * each search result before the
1300 * GNUNET_FS_STATUS_SEARCH_STOPPED event. This 1300 * GNUNET_FS_STATUS_SEARCH_STOPPED event. This
1301 * happens primarily to give the client a chance 1301 * happens primarily to give the client a chance
1302 * to clean up the "cctx" (if needed). 1302 * to clean up the "cctx" (if needed).
@@ -1468,7 +1468,7 @@ struct GNUNET_FS_ProgressInfo
1468 uint64_t data_len; 1468 uint64_t data_len;
1469 1469
1470 /** 1470 /**
1471 * Depth of the given block in the tree; 1471 * Depth of the given block in the tree;
1472 * 0 would be the lowest level (DBLOCKS). 1472 * 0 would be the lowest level (DBLOCKS).
1473 */ 1473 */
1474 unsigned int depth; 1474 unsigned int depth;
@@ -1518,9 +1518,9 @@ struct GNUNET_FS_ProgressInfo
1518 1518
1519 1519
1520/** 1520/**
1521 * Notification of FS to a client about the progress of an 1521 * Notification of FS to a client about the progress of an
1522 * operation. Callbacks of this type will be used for uploads, 1522 * operation. Callbacks of this type will be used for uploads,
1523 * downloads and searches. Some of the arguments depend a bit 1523 * downloads and searches. Some of the arguments depend a bit
1524 * in their meaning on the context in which the callback is used. 1524 * in their meaning on the context in which the callback is used.
1525 * 1525 *
1526 * @param cls closure 1526 * @param cls closure
@@ -1661,7 +1661,7 @@ struct GNUNET_FS_Handle;
1661 * Setup a connection to the file-sharing service. 1661 * Setup a connection to the file-sharing service.
1662 * 1662 *
1663 * @param cfg configuration to use 1663 * @param cfg configuration to use
1664 * @param client_name unique identifier for this client 1664 * @param client_name unique identifier for this client
1665 * @param upcb function to call to notify about FS actions 1665 * @param upcb function to call to notify about FS actions
1666 * @param upcb_cls closure for upcb 1666 * @param upcb_cls closure for upcb
1667 * @param flags specific attributes for fs-operations 1667 * @param flags specific attributes for fs-operations
@@ -1806,7 +1806,7 @@ GNUNET_FS_file_information_create_from_data (struct GNUNET_FS_Handle *h,
1806 * @param offset offset to read from; it is possible 1806 * @param offset offset to read from; it is possible
1807 * that the caller might need to go backwards 1807 * that the caller might need to go backwards
1808 * a bit at times 1808 * a bit at times
1809 * @param max maximum number of bytes that should be 1809 * @param max maximum number of bytes that should be
1810 * copied to buf; readers are not allowed 1810 * copied to buf; readers are not allowed
1811 * to provide less data unless there is an error; 1811 * to provide less data unless there is an error;
1812 * a value of "0" will be used at the end to allow 1812 * a value of "0" will be used at the end to allow
@@ -1825,7 +1825,7 @@ typedef size_t (*GNUNET_FS_DataReader) (void *cls, uint64_t offset, size_t max,
1825 * @param h handle to the file sharing subsystem 1825 * @param h handle to the file sharing subsystem
1826 * @param client_info initial client-info value for this entry 1826 * @param client_info initial client-info value for this entry
1827 * @param length length of the file 1827 * @param length length of the file
1828 * @param reader function that can be used to obtain the data for the file 1828 * @param reader function that can be used to obtain the data for the file
1829 * @param reader_cls closure for "reader" 1829 * @param reader_cls closure for "reader"
1830 * @param keywords under which keywords should this file be available 1830 * @param keywords under which keywords should this file be available
1831 * directly; can be NULL 1831 * directly; can be NULL
@@ -1855,7 +1855,7 @@ GNUNET_FS_file_information_create_from_reader (struct GNUNET_FS_Handle *h,
1855 * for each entry in the directory. 1855 * for each entry in the directory.
1856 * 1856 *
1857 * @param cls closure 1857 * @param cls closure
1858 * @param filename name of the file (including path); must end 1858 * @param filename name of the file (including path); must end
1859 * in a "/" (even on W32) if this is a directory 1859 * in a "/" (even on W32) if this is a directory
1860 * @param fi information about the file (should not be 1860 * @param fi information about the file (should not be
1861 * used henceforth by the caller) 1861 * used henceforth by the caller)
@@ -1866,7 +1866,7 @@ typedef void (*GNUNET_FS_FileProcessor) (void *cls, const char *filename,
1866 1866
1867/** 1867/**
1868 * Type of a function that will be used to scan a directory. 1868 * Type of a function that will be used to scan a directory.
1869 * 1869 *
1870 * @param cls closure 1870 * @param cls closure
1871 * @param h handle to the file sharing subsystem 1871 * @param h handle to the file sharing subsystem
1872 * @param dirname name of the directory to scan 1872 * @param dirname name of the directory to scan
@@ -1991,7 +1991,7 @@ GNUNET_FS_file_information_is_directory (const struct GNUNET_FS_FileInformation
1991 * 1991 *
1992 * @param dir the directory 1992 * @param dir the directory
1993 * @param ent the entry to add; the entry must not have been 1993 * @param ent the entry to add; the entry must not have been
1994 * added to any other directory at this point and 1994 * added to any other directory at this point and
1995 * must not include "dir" in its structure 1995 * must not include "dir" in its structure
1996 * @return GNUNET_OK on success, GNUNET_SYSERR on error 1996 * @return GNUNET_OK on success, GNUNET_SYSERR on error
1997 */ 1997 */
@@ -2062,9 +2062,9 @@ enum GNUNET_FS_PublishOptions
2062 * @param namespace namespace to publish the file in, NULL for no namespace 2062 * @param namespace namespace to publish the file in, NULL for no namespace
2063 * @param nid identifier to use for the publishd content in the namespace 2063 * @param nid identifier to use for the publishd content in the namespace
2064 * (can be NULL, must be NULL if namespace is NULL) 2064 * (can be NULL, must be NULL if namespace is NULL)
2065 * @param nuid update-identifier that will be used for future updates 2065 * @param nuid update-identifier that will be used for future updates
2066 * (can be NULL, must be NULL if namespace or nid is NULL) 2066 * (can be NULL, must be NULL if namespace or nid is NULL)
2067 * @param options options for the publication 2067 * @param options options for the publication
2068 * @return context that can be used to control the publish operation 2068 * @return context that can be used to control the publish operation
2069 */ 2069 */
2070struct GNUNET_FS_PublishContext * 2070struct GNUNET_FS_PublishContext *
@@ -2076,7 +2076,7 @@ GNUNET_FS_publish_start (struct GNUNET_FS_Handle *h,
2076 2076
2077 2077
2078/** 2078/**
2079 * Stop a publication. Will abort incomplete publications (but 2079 * Stop a publication. Will abort incomplete publications (but
2080 * not remove blocks that have already been published) or 2080 * not remove blocks that have already been published) or
2081 * simply clean up the state for completed publications. 2081 * simply clean up the state for completed publications.
2082 * Must NOT be called from within the event callback! 2082 * Must NOT be called from within the event callback!
@@ -2183,7 +2183,7 @@ GNUNET_FS_get_indexed_files (struct GNUNET_FS_Handle *h,
2183 * @param h handle to the file sharing subsystem 2183 * @param h handle to the file sharing subsystem
2184 * @param filename file to unindex 2184 * @param filename file to unindex
2185 * @param cctx initial value for the client context 2185 * @param cctx initial value for the client context
2186 * @return NULL on error, otherwise handle 2186 * @return NULL on error, otherwise handle
2187 */ 2187 */
2188struct GNUNET_FS_UnindexContext * 2188struct GNUNET_FS_UnindexContext *
2189GNUNET_FS_unindex_start (struct GNUNET_FS_Handle *h, const char *filename, 2189GNUNET_FS_unindex_start (struct GNUNET_FS_Handle *h, const char *filename,
@@ -2200,7 +2200,7 @@ GNUNET_FS_unindex_stop (struct GNUNET_FS_UnindexContext *uc);
2200 2200
2201 2201
2202/** 2202/**
2203 * Publish an advertismement for a namespace. 2203 * Publish an advertismement for a namespace.
2204 * 2204 *
2205 * @param h handle to the file sharing subsystem 2205 * @param h handle to the file sharing subsystem
2206 * @param ksk_uri keywords to use for advertisment 2206 * @param ksk_uri keywords to use for advertisment
@@ -2280,7 +2280,7 @@ GNUNET_FS_namespace_list (struct GNUNET_FS_Handle *h,
2280 * Function called on updateable identifiers. 2280 * Function called on updateable identifiers.
2281 * 2281 *
2282 * @param cls closure 2282 * @param cls closure
2283 * @param last_id last identifier 2283 * @param last_id last identifier
2284 * @param last_uri uri used for the content published under the last_id 2284 * @param last_uri uri used for the content published under the last_id
2285 * @param last_meta metadata associated with last_uri 2285 * @param last_meta metadata associated with last_uri
2286 * @param next_id identifier that should be used for updates 2286 * @param next_id identifier that should be used for updates
@@ -2298,12 +2298,12 @@ typedef void (*GNUNET_FS_IdentifierProcessor) (void *cls, const char *last_id,
2298 * produce an update. Namespace updates form a graph where each node 2298 * produce an update. Namespace updates form a graph where each node
2299 * has a name. Each node can have any number of URI/meta-data entries 2299 * has a name. Each node can have any number of URI/meta-data entries
2300 * which can each be linked to other nodes. Cycles are possible. 2300 * which can each be linked to other nodes. Cycles are possible.
2301 * 2301 *
2302 * Calling this function with "next_id" NULL will cause the library to 2302 * Calling this function with "next_id" NULL will cause the library to
2303 * call "ip" with a root for each strongly connected component of the 2303 * call "ip" with a root for each strongly connected component of the
2304 * graph (a root being a node from which all other nodes in the Scc 2304 * graph (a root being a node from which all other nodes in the Scc
2305 * are reachable). 2305 * are reachable).
2306 * 2306 *
2307 * Calling this function with "next_id" being the name of a node will 2307 * Calling this function with "next_id" being the name of a node will
2308 * cause the library to call "ip" with all children of the node. Note 2308 * cause the library to call "ip" with all children of the node. Note
2309 * that cycles within an SCC are possible (including self-loops). 2309 * that cycles within an SCC are possible (including self-loops).
@@ -2356,7 +2356,7 @@ GNUNET_FS_search_start (struct GNUNET_FS_Handle *h,
2356 2356
2357 2357
2358/** 2358/**
2359 * Pause search. 2359 * Pause search.
2360 * 2360 *
2361 * @param sc context for the search that should be paused 2361 * @param sc context for the search that should be paused
2362 */ 2362 */
@@ -2541,7 +2541,7 @@ GNUNET_FS_meta_data_test_for_directory (const struct GNUNET_CONTAINER_MetaData
2541/** 2541/**
2542 * Set the MIMETYPE information for the given 2542 * Set the MIMETYPE information for the given
2543 * metadata to "application/gnunet-directory". 2543 * metadata to "application/gnunet-directory".
2544 * 2544 *
2545 * @param md metadata to add mimetype to 2545 * @param md metadata to add mimetype to
2546 */ 2546 */
2547void 2547void
@@ -2550,7 +2550,7 @@ GNUNET_FS_meta_data_make_directory (struct GNUNET_CONTAINER_MetaData *md);
2550 2550
2551/** 2551/**
2552 * Suggest a filename based on given metadata. 2552 * Suggest a filename based on given metadata.
2553 * 2553 *
2554 * @param md given meta data 2554 * @param md given meta data
2555 * @return NULL if meta data is useless for suggesting a filename 2555 * @return NULL if meta data is useless for suggesting a filename
2556 */ 2556 */
@@ -2617,7 +2617,7 @@ struct GNUNET_FS_DirectoryBuilder;
2617 2617
2618/** 2618/**
2619 * Create a directory builder. 2619 * Create a directory builder.
2620 * 2620 *
2621 * @param mdir metadata for the directory 2621 * @param mdir metadata for the directory
2622 */ 2622 */
2623struct GNUNET_FS_DirectoryBuilder * 2623struct GNUNET_FS_DirectoryBuilder *
@@ -2627,7 +2627,7 @@ GNUNET_FS_directory_builder_create (const struct GNUNET_CONTAINER_MetaData
2627 2627
2628/** 2628/**
2629 * Add an entry to a directory. 2629 * Add an entry to a directory.
2630 * 2630 *
2631 * @param bld directory to extend 2631 * @param bld directory to extend
2632 * @param uri uri of the entry (must not be a KSK) 2632 * @param uri uri of the entry (must not be a KSK)
2633 * @param md metadata of the entry 2633 * @param md metadata of the entry
diff --git a/src/include/gnunet_getopt_lib.h b/src/include/gnunet_getopt_lib.h
index e6afa2b3c..2f4f4c32b 100644
--- a/src/include/gnunet_getopt_lib.h
+++ b/src/include/gnunet_getopt_lib.h
@@ -250,7 +250,7 @@ GNUNET_GETOPT_set_uint (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx,
250 250
251 251
252/** 252/**
253 * Set an option of type 'int' from the command line to 1 if the 253 * Set an option of type 'int' from the command line to 1 if the
254 * given option is present. 254 * given option is present.
255 * A pointer to this function should be passed as part of the 255 * A pointer to this function should be passed as part of the
256 * 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options 256 * 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options
@@ -261,7 +261,7 @@ GNUNET_GETOPT_set_uint (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx,
261 * @param scls additional closure (will point to the 'int') 261 * @param scls additional closure (will point to the 'int')
262 * @param option name of the option 262 * @param option name of the option
263 * @param value not used (NULL) 263 * @param value not used (NULL)
264 * @return GNUNET_OK 264 * @return GNUNET_OK
265 */ 265 */
266int 266int
267GNUNET_GETOPT_set_one (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx, 267GNUNET_GETOPT_set_one (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx,
@@ -280,7 +280,7 @@ GNUNET_GETOPT_set_one (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx,
280 * which will be allocated) 280 * which will be allocated)
281 * @param option name of the option 281 * @param option name of the option
282 * @param value actual value of the option (a string) 282 * @param value actual value of the option (a string)
283 * @return GNUNET_OK 283 * @return GNUNET_OK
284 */ 284 */
285int 285int
286GNUNET_GETOPT_set_string (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx, 286GNUNET_GETOPT_set_string (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx,
@@ -298,7 +298,7 @@ GNUNET_GETOPT_set_string (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx,
298 * @param scls additional closure (will point to the 'int') 298 * @param scls additional closure (will point to the 'int')
299 * @param option name of the option 299 * @param option name of the option
300 * @param value not used (NULL) 300 * @param value not used (NULL)
301 * @return GNUNET_OK 301 * @return GNUNET_OK
302 */ 302 */
303int 303int
304GNUNET_GETOPT_increment_value (struct GNUNET_GETOPT_CommandLineProcessorContext 304GNUNET_GETOPT_increment_value (struct GNUNET_GETOPT_CommandLineProcessorContext
diff --git a/src/include/gnunet_hello_lib.h b/src/include/gnunet_hello_lib.h
index 556b41d3c..0ec1be7d1 100644
--- a/src/include/gnunet_hello_lib.h
+++ b/src/include/gnunet_hello_lib.h
@@ -130,9 +130,9 @@ GNUNET_HELLO_merge (const struct GNUNET_HELLO_Message *h1,
130 * @param h2 the second HELLO message 130 * @param h2 the second HELLO message
131 * @param now time to use for deciding which addresses have 131 * @param now time to use for deciding which addresses have
132 * expired and should not be considered at all 132 * expired and should not be considered at all
133 * @return absolute time forever if the two HELLOs are 133 * @return absolute time forever if the two HELLOs are
134 * totally identical; smallest timestamp >= now if 134 * totally identical; smallest timestamp >= now if
135 * they only differ in timestamps; 135 * they only differ in timestamps;
136 * zero if the some addresses with expirations >= now 136 * zero if the some addresses with expirations >= now
137 * do not match at all 137 * do not match at all
138 */ 138 */
diff --git a/src/include/gnunet_mesh_service.h b/src/include/gnunet_mesh_service.h
index bea706478..bf43c8289 100644
--- a/src/include/gnunet_mesh_service.h
+++ b/src/include/gnunet_mesh_service.h
@@ -135,7 +135,7 @@ typedef uint32_t GNUNET_MESH_ApplicationType;
135 * messages if the client does not process them fast enough (for this 135 * messages if the client does not process them fast enough (for this
136 * notification type, a bounded queue is used) 136 * notification type, a bounded queue is used)
137 * @param stypes Application Types the client claims to offer 137 * @param stypes Application Types the client claims to offer
138 * @return handle to the mesh service 138 * @return handle to the mesh service
139 * NULL on error (in this case, init is never called) 139 * NULL on error (in this case, init is never called)
140 */ 140 */
141struct GNUNET_MESH_Handle * 141struct GNUNET_MESH_Handle *
@@ -146,7 +146,7 @@ GNUNET_MESH_connect (const struct GNUNET_CONFIGURATION_Handle *cfg, void *cls,
146 146
147/** 147/**
148 * Get the peer on the other side of this tunnel if it is just one. Return NULL otherwise 148 * Get the peer on the other side of this tunnel if it is just one. Return NULL otherwise
149 * 149 *
150 * @param tunnel the tunnel 150 * @param tunnel the tunnel
151 * @return the peer or NULL 151 * @return the peer or NULL
152 */ 152 */
@@ -309,7 +309,7 @@ GNUNET_MESH_peer_request_connect_by_type (struct GNUNET_MESH_Handle *h,
309 309
310/** 310/**
311 * Cancel a pending request to connect to a particular peer. Destroys the 311 * Cancel a pending request to connect to a particular peer. Destroys the
312 * tunnel. 312 * tunnel.
313 * 313 *
314 * @param req request handle that was returned for the original request 314 * @param req request handle that was returned for the original request
315 */ 315 */
@@ -333,7 +333,7 @@ struct GNUNET_MESH_TransmitHandle;
333 * @param cork is corking allowed for this transmission? 333 * @param cork is corking allowed for this transmission?
334 * @param priority how important is the message? 334 * @param priority how important is the message?
335 * @param maxdelay how long can the message wait? 335 * @param maxdelay how long can the message wait?
336 * @param target destination for the message, NULL for multicast to all tunnel targets 336 * @param target destination for the message, NULL for multicast to all tunnel targets
337 * @param notify_size how many bytes of buffer space does notify want? 337 * @param notify_size how many bytes of buffer space does notify want?
338 * @param notify function to call when buffer space is available; 338 * @param notify function to call when buffer space is available;
339 * will be called with NULL on timeout or if the overall queue 339 * will be called with NULL on timeout or if the overall queue
diff --git a/src/include/gnunet_mesh_service_new.h b/src/include/gnunet_mesh_service_new.h
index 83addfce5..d0be4ee77 100644
--- a/src/include/gnunet_mesh_service_new.h
+++ b/src/include/gnunet_mesh_service_new.h
@@ -257,14 +257,14 @@ struct GNUNET_MESH_TransmitHandle;
257 257
258/** 258/**
259 * Ask the mesh to call "notify" once it is ready to transmit the 259 * Ask the mesh to call "notify" once it is ready to transmit the
260 * given number of bytes to the specified tunnel or target. 260 * given number of bytes to the specified tunnel or target.
261 * 261 *
262 * @param tunnel tunnel to use for transmission 262 * @param tunnel tunnel to use for transmission
263 * @param cork is corking allowed for this transmission? 263 * @param cork is corking allowed for this transmission?
264 * @param priority how important is the message? 264 * @param priority how important is the message?
265 * @param maxdelay how long can the message wait? 265 * @param maxdelay how long can the message wait?
266 * @param target destination for the message 266 * @param target destination for the message
267 * NULL for multicast to all tunnel targets 267 * NULL for multicast to all tunnel targets
268 * @param notify_size how many bytes of buffer space does notify want? 268 * @param notify_size how many bytes of buffer space does notify want?
269 * @param notify function to call when buffer space is available; 269 * @param notify function to call when buffer space is available;
270 * will be called with NULL on timeout or if the overall queue 270 * will be called with NULL on timeout or if the overall queue
diff --git a/src/include/gnunet_nat_lib.h b/src/include/gnunet_nat_lib.h
index c521a560c..6c1db8043 100644
--- a/src/include/gnunet_nat_lib.h
+++ b/src/include/gnunet_nat_lib.h
@@ -84,7 +84,7 @@ struct GNUNET_NAT_Handle;
84 * @param reversal_callback function to call if someone wants connection reversal from us, 84 * @param reversal_callback function to call if someone wants connection reversal from us,
85 * NULL if connection reversal is not supported 85 * NULL if connection reversal is not supported
86 * @param callback_cls closure for callback 86 * @param callback_cls closure for callback
87 * @return NULL on error, otherwise handle that can be used to unregister 87 * @return NULL on error, otherwise handle that can be used to unregister
88 */ 88 */
89struct GNUNET_NAT_Handle * 89struct GNUNET_NAT_Handle *
90GNUNET_NAT_register (const struct GNUNET_CONFIGURATION_Handle *cfg, int is_tcp, 90GNUNET_NAT_register (const struct GNUNET_CONFIGURATION_Handle *cfg, int is_tcp,
@@ -145,7 +145,7 @@ struct GNUNET_NAT_Test;
145 * 145 *
146 * @param cls closure 146 * @param cls closure
147 * @param success GNUNET_OK on success, GNUNET_NO on failure, 147 * @param success GNUNET_OK on success, GNUNET_NO on failure,
148 * GNUNET_SYSERR if the test could not be 148 * GNUNET_SYSERR if the test could not be
149 * properly started (internal failure) 149 * properly started (internal failure)
150 */ 150 */
151typedef void (*GNUNET_NAT_TestCallback) (void *cls, int success); 151typedef void (*GNUNET_NAT_TestCallback) (void *cls, int success);
@@ -227,7 +227,7 @@ struct GNUNET_NAT_MiniHandle;
227 * general-purpose 'GNUNET_NAT_register' code). However, it can be 227 * general-purpose 'GNUNET_NAT_register' code). However, it can be
228 * used if specifically UPnP-based NAT traversal is to be used or 228 * used if specifically UPnP-based NAT traversal is to be used or
229 * tested. 229 * tested.
230 * 230 *
231 * @param port port to map 231 * @param port port to map
232 * @param is_tcp GNUNET_YES to map TCP, GNUNET_NO for UDP 232 * @param is_tcp GNUNET_YES to map TCP, GNUNET_NO for UDP
233 * @param ac function to call with mapping result 233 * @param ac function to call with mapping result
@@ -244,7 +244,7 @@ GNUNET_NAT_mini_map_start (uint16_t port, int is_tcp,
244 * this function will give 'upnpc' 1s to remove tha mapping, 244 * this function will give 'upnpc' 1s to remove tha mapping,
245 * so while this function is non-blocking, a task will be 245 * so while this function is non-blocking, a task will be
246 * left with the scheduler for up to 1s past this call. 246 * left with the scheduler for up to 1s past this call.
247 * 247 *
248 * @param mini the handle 248 * @param mini the handle
249 */ 249 */
250void 250void
diff --git a/src/include/gnunet_nse_service.h b/src/include/gnunet_nse_service.h
index 451f2a2dc..a0c6016a4 100644
--- a/src/include/gnunet_nse_service.h
+++ b/src/include/gnunet_nse_service.h
@@ -70,7 +70,7 @@ typedef void (*GNUNET_NSE_Callback) (void *cls,
70 * Convert the logarithmic estimated returned to the 'GNUNET_NSE_Callback' 70 * Convert the logarithmic estimated returned to the 'GNUNET_NSE_Callback'
71 * into an absolute estimate in terms of the number of peers in the network. 71 * into an absolute estimate in terms of the number of peers in the network.
72 * 72 *
73 * @param loge logarithmic estimate 73 * @param loge logarithmic estimate
74 * @return absolute number of peers in the network (estimated) 74 * @return absolute number of peers in the network (estimated)
75 */ 75 */
76#define GNUNET_NSE_log_estimate_to_n(loge) pow(2.0, (loge)) 76#define GNUNET_NSE_log_estimate_to_n(loge) pow(2.0, (loge))
diff --git a/src/include/gnunet_os_lib.h b/src/include/gnunet_os_lib.h
index 9d611af9b..31062bd40 100644
--- a/src/include/gnunet_os_lib.h
+++ b/src/include/gnunet_os_lib.h
@@ -356,7 +356,7 @@ GNUNET_OS_install_parent_control_handler (void *cls,
356 * PATH environment variable as a search path. 356 * PATH environment variable as a search path.
357 * 357 *
358 * @param binary the name of the file to check 358 * @param binary the name of the file to check
359 * @return GNUNET_YES if the file is SUID, 359 * @return GNUNET_YES if the file is SUID,
360 * GNUNET_NO if not SUID (but binary exists) 360 * GNUNET_NO if not SUID (but binary exists)
361 * GNUNET_SYSERR on error (no such binary or not executable) 361 * GNUNET_SYSERR on error (no such binary or not executable)
362 */ 362 */
diff --git a/src/include/gnunet_peer_lib.h b/src/include/gnunet_peer_lib.h
index 89413aa59..0121e8453 100644
--- a/src/include/gnunet_peer_lib.h
+++ b/src/include/gnunet_peer_lib.h
@@ -80,7 +80,7 @@ GNUNET_PEER_change_rc (GNUNET_PEER_Id id, int delta);
80 80
81/** 81/**
82 * Decrement multiple RCs of peer identities by one. 82 * Decrement multiple RCs of peer identities by one.
83 * 83 *
84 * @param ids array of PIDs to decrement the RCs of 84 * @param ids array of PIDs to decrement the RCs of
85 * @param count size of the ids array 85 * @param count size of the ids array
86 */ 86 */
diff --git a/src/include/gnunet_peerinfo_service.h b/src/include/gnunet_peerinfo_service.h
index 50bbc458a..158eae602 100644
--- a/src/include/gnunet_peerinfo_service.h
+++ b/src/include/gnunet_peerinfo_service.h
@@ -73,7 +73,7 @@ GNUNET_PEERINFO_disconnect (struct GNUNET_PEERINFO_Handle *h);
73 73
74 74
75/** 75/**
76 * Add a host to the persistent list. This method operates in 76 * Add a host to the persistent list. This method operates in
77 * semi-reliable mode: if the transmission is not completed by 77 * semi-reliable mode: if the transmission is not completed by
78 * the time 'GNUNET_PEERINFO_disconnect' is called, it will be 78 * the time 'GNUNET_PEERINFO_disconnect' is called, it will be
79 * aborted. Furthermore, if a second HELLO is added for the 79 * aborted. Furthermore, if a second HELLO is added for the
@@ -116,15 +116,15 @@ struct GNUNET_PEERINFO_IteratorContext;
116 * host and then finally once with a NULL pointer. After that final 116 * host and then finally once with a NULL pointer. After that final
117 * invocation, the iterator context must no longer be used. 117 * invocation, the iterator context must no longer be used.
118 * 118 *
119 * Instead of calling this function with 'peer == NULL' 119 * Instead of calling this function with 'peer == NULL'
120 * it is often better to use 'GNUNET_PEERINFO_notify'. 120 * it is often better to use 'GNUNET_PEERINFO_notify'.
121 * 121 *
122 * @param h handle to the peerinfo service 122 * @param h handle to the peerinfo service
123 * @param peer restrict iteration to this peer only (can be NULL) 123 * @param peer restrict iteration to this peer only (can be NULL)
124 * @param timeout how long to wait until timing out 124 * @param timeout how long to wait until timing out
125 * @param callback the method to call for each peer 125 * @param callback the method to call for each peer
126 * @param callback_cls closure for callback 126 * @param callback_cls closure for callback
127 * @return NULL on error (in this case, 'callback' is never called!), 127 * @return NULL on error (in this case, 'callback' is never called!),
128 * otherwise an iterator context 128 * otherwise an iterator context
129 */ 129 */
130struct GNUNET_PEERINFO_IteratorContext * 130struct GNUNET_PEERINFO_IteratorContext *
diff --git a/src/include/gnunet_plugin_lib.h b/src/include/gnunet_plugin_lib.h
index fbc7e2617..d143a6ccf 100644
--- a/src/include/gnunet_plugin_lib.h
+++ b/src/include/gnunet_plugin_lib.h
@@ -54,7 +54,7 @@ typedef void *(*GNUNET_PLUGIN_Callback) (void *arg);
54 * Test if a plugin exists. 54 * Test if a plugin exists.
55 * 55 *
56 * Note that the library must export a symbol called 56 * Note that the library must export a symbol called
57 * "library_name_init" for the test to succeed. 57 * "library_name_init" for the test to succeed.
58 * 58 *
59 * @param library_name name of the plugin to test if it is installed 59 * @param library_name name of the plugin to test if it is installed
60 * @return GNUNET_YES if the plugin exists, GNUNET_NO if not 60 * @return GNUNET_YES if the plugin exists, GNUNET_NO if not
diff --git a/src/include/gnunet_protocols.h b/src/include/gnunet_protocols.h
index c12a849ce..5f3ab25ce 100644
--- a/src/include/gnunet_protocols.h
+++ b/src/include/gnunet_protocols.h
@@ -36,7 +36,7 @@ extern "C"
36#endif 36#endif
37 37
38/******************************************************************************* 38/*******************************************************************************
39 * UTIL message types 39 * UTIL message types
40 ******************************************************************************/ 40 ******************************************************************************/
41 41
42/** 42/**
@@ -45,7 +45,7 @@ extern "C"
45#define GNUNET_MESSAGE_TYPE_TEST 1 45#define GNUNET_MESSAGE_TYPE_TEST 1
46 46
47/******************************************************************************* 47/*******************************************************************************
48 * RESOLVER message types 48 * RESOLVER message types
49 ******************************************************************************/ 49 ******************************************************************************/
50 50
51/** 51/**
@@ -59,7 +59,7 @@ extern "C"
59#define GNUNET_MESSAGE_TYPE_RESOLVER_RESPONSE 5 59#define GNUNET_MESSAGE_TYPE_RESOLVER_RESPONSE 5
60 60
61/******************************************************************************* 61/*******************************************************************************
62 * ARM message types 62 * ARM message types
63 ******************************************************************************/ 63 ******************************************************************************/
64 64
65/** 65/**
@@ -100,7 +100,7 @@ extern "C"
100#define GNUNET_MESSAGE_TYPE_ARM_SHUTDOWN_ACK 14 100#define GNUNET_MESSAGE_TYPE_ARM_SHUTDOWN_ACK 14
101 101
102/******************************************************************************* 102/*******************************************************************************
103 * HELLO message types 103 * HELLO message types
104 ******************************************************************************/ 104 ******************************************************************************/
105 105
106/** 106/**
@@ -110,7 +110,7 @@ extern "C"
110#define GNUNET_MESSAGE_TYPE_HELLO 16 110#define GNUNET_MESSAGE_TYPE_HELLO 16
111 111
112/******************************************************************************* 112/*******************************************************************************
113 * FRAGMENTATION message types 113 * FRAGMENTATION message types
114 ******************************************************************************/ 114 ******************************************************************************/
115 115
116/** 116/**
@@ -126,7 +126,7 @@ extern "C"
126#define GNUNET_MESSAGE_TYPE_FRAGMENT_ACK 19 126#define GNUNET_MESSAGE_TYPE_FRAGMENT_ACK 19
127 127
128/******************************************************************************* 128/*******************************************************************************
129 * TRANSPORT message types 129 * TRANSPORT message types
130 ******************************************************************************/ 130 ******************************************************************************/
131 131
132/** 132/**
@@ -242,7 +242,7 @@ extern "C"
242#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_KEEPALIVE 39 242#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_KEEPALIVE 39
243 243
244/******************************************************************************* 244/*******************************************************************************
245 * Transport-WLAN message types 245 * Transport-WLAN message types
246 ******************************************************************************/ 246 ******************************************************************************/
247 247
248/** 248/**
@@ -269,7 +269,7 @@ extern "C"
269 269
270 270
271/******************************************************************************* 271/*******************************************************************************
272 * Transport-DV message types 272 * Transport-DV message types
273 ******************************************************************************/ 273 ******************************************************************************/
274 274
275/** 275/**
@@ -313,7 +313,7 @@ extern "C"
313#define GNUNET_MESSAGE_TYPE_DV_DISCONNECT 50 313#define GNUNET_MESSAGE_TYPE_DV_DISCONNECT 50
314 314
315/******************************************************************************* 315/*******************************************************************************
316 * Transport-UDP message types 316 * Transport-UDP message types
317 ******************************************************************************/ 317 ******************************************************************************/
318 318
319/** 319/**
@@ -327,7 +327,7 @@ extern "C"
327#define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_ACK 57 327#define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_ACK 57
328 328
329/******************************************************************************* 329/*******************************************************************************
330 * Transport-TCP message types 330 * Transport-TCP message types
331 ******************************************************************************/ 331 ******************************************************************************/
332 332
333/** 333/**
@@ -347,7 +347,7 @@ extern "C"
347#define GNUNET_MESSAGE_TYPE_TRANSPORT_ATS 62 347#define GNUNET_MESSAGE_TYPE_TRANSPORT_ATS 62
348 348
349/******************************************************************************* 349/*******************************************************************************
350 * NAT message types 350 * NAT message types
351 ******************************************************************************/ 351 ******************************************************************************/
352 352
353/** 353/**
@@ -356,7 +356,7 @@ extern "C"
356#define GNUNET_MESSAGE_TYPE_NAT_TEST 63 356#define GNUNET_MESSAGE_TYPE_NAT_TEST 63
357 357
358/******************************************************************************* 358/*******************************************************************************
359 * CORE message types 359 * CORE message types
360 ******************************************************************************/ 360 ******************************************************************************/
361 361
362/** 362/**
@@ -484,7 +484,7 @@ extern "C"
484#define GNUNET_MESSAGE_TYPE_CORE_BINARY_TYPE_MAP 87 484#define GNUNET_MESSAGE_TYPE_CORE_BINARY_TYPE_MAP 87
485 485
486/******************************************************************************* 486/*******************************************************************************
487 * DATASTORE message types 487 * DATASTORE message types
488 ******************************************************************************/ 488 ******************************************************************************/
489 489
490/** 490/**
@@ -554,7 +554,7 @@ extern "C"
554 554
555 555
556/******************************************************************************* 556/*******************************************************************************
557 * FS message types 557 * FS message types
558 ******************************************************************************/ 558 ******************************************************************************/
559 559
560/** 560/**
@@ -621,7 +621,7 @@ extern "C"
621 621
622 622
623/******************************************************************************* 623/*******************************************************************************
624 * DHT message types 624 * DHT message types
625 ******************************************************************************/ 625 ******************************************************************************/
626 626
627/** 627/**
@@ -706,7 +706,7 @@ extern "C"
706#define GNUNET_MESSAGE_TYPE_DHT_MALICIOUS_DROP 156 706#define GNUNET_MESSAGE_TYPE_DHT_MALICIOUS_DROP 156
707 707
708/******************************************************************************* 708/*******************************************************************************
709 * HOSTLIST message types 709 * HOSTLIST message types
710 ******************************************************************************/ 710 ******************************************************************************/
711 711
712/** 712/**
@@ -716,7 +716,7 @@ extern "C"
716 716
717 717
718/******************************************************************************* 718/*******************************************************************************
719 * STATISTICS message types 719 * STATISTICS message types
720 ******************************************************************************/ 720 ******************************************************************************/
721 721
722/** 722/**
@@ -752,7 +752,7 @@ extern "C"
752 752
753 753
754/******************************************************************************* 754/*******************************************************************************
755 * VPN message types 755 * VPN message types
756 ******************************************************************************/ 756 ******************************************************************************/
757 757
758/** 758/**
@@ -802,7 +802,7 @@ extern "C"
802 802
803 803
804/******************************************************************************* 804/*******************************************************************************
805 * VPN-DNS message types 805 * VPN-DNS message types
806 ******************************************************************************/ 806 ******************************************************************************/
807 807
808/** 808/**
diff --git a/src/include/gnunet_pseudonym_lib.h b/src/include/gnunet_pseudonym_lib.h
index 138375fe1..bde98ef8f 100644
--- a/src/include/gnunet_pseudonym_lib.h
+++ b/src/include/gnunet_pseudonym_lib.h
@@ -83,7 +83,7 @@ GNUNET_PSEUDONYM_add (const struct GNUNET_CONFIGURATION_Handle *cfg,
83/** 83/**
84 * List all known pseudonyms. 84 * List all known pseudonyms.
85 * 85 *
86 * @param cfg overall configuration 86 * @param cfg overall configuration
87 * @param iterator function to call for each pseudonym 87 * @param iterator function to call for each pseudonym
88 * @param closure closure for iterator 88 * @param closure closure for iterator
89 * @return number of pseudonyms found 89 * @return number of pseudonyms found
diff --git a/src/include/gnunet_scheduler_lib.h b/src/include/gnunet_scheduler_lib.h
index 0f80b9cee..9b8c57ff3 100644
--- a/src/include/gnunet_scheduler_lib.h
+++ b/src/include/gnunet_scheduler_lib.h
@@ -256,7 +256,7 @@ GNUNET_SCHEDULER_get_load (enum GNUNET_SCHEDULER_Priority p);
256 256
257/** 257/**
258 * Obtain the reason code for why the current task was 258 * Obtain the reason code for why the current task was
259 * started. Will return the same value as 259 * started. Will return the same value as
260 * the GNUNET_SCHEDULER_TaskContext's reason field. 260 * the GNUNET_SCHEDULER_TaskContext's reason field.
261 * 261 *
262 * * @return reason(s) why the current task is run 262 * * @return reason(s) why the current task is run
diff --git a/src/include/gnunet_server_lib.h b/src/include/gnunet_server_lib.h
index 45da3efa2..682a265ff 100644
--- a/src/include/gnunet_server_lib.h
+++ b/src/include/gnunet_server_lib.h
@@ -135,7 +135,7 @@ GNUNET_SERVER_create_with_sockets (GNUNET_CONNECTION_AccessCheck access,
135 * @param access function for access control 135 * @param access function for access control
136 * @param access_cls closure for access 136 * @param access_cls closure for access
137 * @param serverAddr address toes listen on (including port), NULL terminated array 137 * @param serverAddr address toes listen on (including port), NULL terminated array
138 * @param socklen lengths of respective serverAddr 138 * @param socklen lengths of respective serverAddr
139 * @param idle_timeout after how long should we timeout idle connections? 139 * @param idle_timeout after how long should we timeout idle connections?
140 * @param require_found if YES, connections sending messages of unknown type 140 * @param require_found if YES, connections sending messages of unknown type
141 * will be closed 141 * will be closed
@@ -352,7 +352,7 @@ typedef void (*GNUNET_SERVER_DisconnectCallback) (void *cls,
352 * Ask the server to notify us whenever a client disconnects. 352 * Ask the server to notify us whenever a client disconnects.
353 * This function is called whenever the actual network connection 353 * This function is called whenever the actual network connection
354 * is closed; the reference count may be zero or larger than zero 354 * is closed; the reference count may be zero or larger than zero
355 * at this point. If the server is destroyed before this 355 * at this point. If the server is destroyed before this
356 * notification is explicitly cancelled, the 'callback' will 356 * notification is explicitly cancelled, the 'callback' will
357 * once be called with a 'client' argument of NULL to indicate 357 * once be called with a 'client' argument of NULL to indicate
358 * that the server itself is now gone (and that the callback 358 * that the server itself is now gone (and that the callback
@@ -609,7 +609,7 @@ GNUNET_SERVER_mst_create (GNUNET_SERVER_MessageTokenizerCallback cb,
609 * can be NULL (will be passed back to 'cb') 609 * can be NULL (will be passed back to 'cb')
610 * @param buf input data to add 610 * @param buf input data to add
611 * @param size number of bytes in buf 611 * @param size number of bytes in buf
612 * @param purge should any excess bytes in the buffer be discarded 612 * @param purge should any excess bytes in the buffer be discarded
613 * (i.e. for packet-based services like UDP) 613 * (i.e. for packet-based services like UDP)
614 * @param one_shot only call callback once, keep rest of message in buffer 614 * @param one_shot only call callback once, keep rest of message in buffer
615 * @return GNUNET_OK if we are done processing (need more data) 615 * @return GNUNET_OK if we are done processing (need more data)
diff --git a/src/include/gnunet_statistics_service.h b/src/include/gnunet_statistics_service.h
index c246e7cda..11796d781 100644
--- a/src/include/gnunet_statistics_service.h
+++ b/src/include/gnunet_statistics_service.h
@@ -143,7 +143,7 @@ GNUNET_STATISTICS_get (struct GNUNET_STATISTICS_Handle *handle,
143 143
144 144
145/** 145/**
146 * Cancel a 'get' request. Must be called before the 'cont' 146 * Cancel a 'get' request. Must be called before the 'cont'
147 * function is called. 147 * function is called.
148 * 148 *
149 * @param gh handle of the request to cancel 149 * @param gh handle of the request to cancel
diff --git a/src/include/gnunet_time_lib.h b/src/include/gnunet_time_lib.h
index 1f157631f..f8afdae41 100644
--- a/src/include/gnunet_time_lib.h
+++ b/src/include/gnunet_time_lib.h
@@ -253,7 +253,7 @@ GNUNET_TIME_absolute_get_remaining (struct GNUNET_TIME_Absolute future);
253 253
254 254
255/** 255/**
256 * Calculate the estimate time of arrival/completion 256 * Calculate the estimate time of arrival/completion
257 * for an operation. 257 * for an operation.
258 * 258 *
259 * @param start when did the operation start? 259 * @param start when did the operation start?
@@ -363,7 +363,7 @@ GNUNET_TIME_relative_subtract (struct GNUNET_TIME_Relative a1,
363 363
364/** 364/**
365 * Convert relative time to network byte order. 365 * Convert relative time to network byte order.
366 * 366 *
367 * @param a time to convert 367 * @param a time to convert
368 * @return converted time value 368 * @return converted time value
369 */ 369 */
diff --git a/src/include/gnunet_transport_plugin.h b/src/include/gnunet_transport_plugin.h
index d7ca62219..bc5b791d5 100644
--- a/src/include/gnunet_transport_plugin.h
+++ b/src/include/gnunet_transport_plugin.h
@@ -74,9 +74,9 @@ struct SessionHeader
74 * use NULL wherever a session pointer is needed. This function 74 * use NULL wherever a session pointer is needed. This function
75 * should be called BEFORE a potential "TransmitContinuation" 75 * should be called BEFORE a potential "TransmitContinuation"
76 * from the "TransmitFunction". 76 * from the "TransmitFunction".
77 * 77 *
78 * @param cls closure 78 * @param cls closure
79 * @param peer which peer was the session for 79 * @param peer which peer was the session for
80 * @param session which session is being destoyed 80 * @param session which session is being destoyed
81 */ 81 */
82typedef void (*GNUNET_TRANSPORT_SessionEnd) (void *cls, 82typedef void (*GNUNET_TRANSPORT_SessionEnd) (void *cls,
@@ -393,14 +393,14 @@ typedef int (*GNUNET_TRANSPORT_CheckAddress) (void *cls, const void *addr,
393 393
394/** 394/**
395 * Function called for a quick conversion of the binary address to 395 * Function called for a quick conversion of the binary address to
396 * a numeric address. Note that the caller must not free the 396 * a numeric address. Note that the caller must not free the
397 * address and that the next call to this function is allowed 397 * address and that the next call to this function is allowed
398 * to override the address again. 398 * to override the address again.
399 * 399 *
400 * @param cls closure 400 * @param cls closure
401 * @param addr binary address 401 * @param addr binary address
402 * @param addr_len length of the address 402 * @param addr_len length of the address
403 * @return string representing the same address 403 * @return string representing the same address
404 */ 404 */
405typedef const char *(*GNUNET_TRANSPORT_AddressToString) (void *cls, 405typedef const char *(*GNUNET_TRANSPORT_AddressToString) (void *cls,
406 const void *addr, 406 const void *addr,
@@ -431,7 +431,7 @@ struct GNUNET_TRANSPORT_PluginFunctions
431 /** 431 /**
432 * Function that can be used to force the plugin to disconnect from 432 * Function that can be used to force the plugin to disconnect from
433 * the given peer and cancel all previous transmissions (and their 433 * the given peer and cancel all previous transmissions (and their
434 * continuations). 434 * continuations).
435 */ 435 */
436 GNUNET_TRANSPORT_DisconnectFunction disconnect; 436 GNUNET_TRANSPORT_DisconnectFunction disconnect;
437 437
diff --git a/src/include/gnunet_transport_service.h b/src/include/gnunet_transport_service.h
index 988d55784..e90acab4d 100644
--- a/src/include/gnunet_transport_service.h
+++ b/src/include/gnunet_transport_service.h
@@ -486,7 +486,7 @@ GNUNET_TRANSPORT_disconnect (struct GNUNET_TRANSPORT_Handle *handle);
486 486
487 487
488/** 488/**
489 * Ask the transport service to establish a connection to 489 * Ask the transport service to establish a connection to
490 * the given peer. 490 * the given peer.
491 * 491 *
492 * @param handle connection to transport service 492 * @param handle connection to transport service
@@ -621,7 +621,7 @@ GNUNET_TRANSPORT_offer_hello (struct GNUNET_TRANSPORT_Handle *handle,
621 * @param cfg configuration to use 621 * @param cfg configuration to use
622 * @param address address to convert (binary format) 622 * @param address address to convert (binary format)
623 * @param addressLen number of bytes in address 623 * @param addressLen number of bytes in address
624 * @param numeric should (IP) addresses be displayed in numeric form 624 * @param numeric should (IP) addresses be displayed in numeric form
625 * (otherwise do reverse DNS lookup) 625 * (otherwise do reverse DNS lookup)
626 * @param nameTrans name of the transport to which the address belongs 626 * @param nameTrans name of the transport to which the address belongs
627 * @param timeout how long is the lookup allowed to take at most 627 * @param timeout how long is the lookup allowed to take at most