diff options
author | Christian Grothoff <christian@grothoff.org> | 2011-08-29 10:19:43 +0000 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2011-08-29 10:19:43 +0000 |
commit | cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb (patch) | |
tree | b704e00a3af618b2cd174a7f89514eaebd82a1cf /src/include | |
parent | bb4fc4f4007988874f910d4de5492f9629301641 (diff) | |
download | gnunet-cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb.tar.gz gnunet-cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb.zip |
run indent twice, it alternates between two 'canonical' forms, also run whitespace remover
Diffstat (limited to 'src/include')
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 | */ |
169 | void | 169 | void |
@@ -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 | */ |
240 | const char * | 240 | const char * |
241 | GNUNET_h2s (const GNUNET_HashCode * hc); | 241 | GNUNET_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 | */ |
245 | struct GNUNET_CONTAINER_MetaData * | 245 | struct 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 | */ |
1052 | struct GNUNET_CONTAINER_SList; | 1052 | struct 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 | */ |
1057 | struct GNUNET_CONTAINER_SList_Iterator; | 1057 | struct 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 | */ |
476 | void | 476 | void |
477 | GNUNET_CRYPTO_hash_difference (const GNUNET_HashCode * a, | 477 | GNUNET_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 | */ |
502 | void | 502 | void |
503 | GNUNET_CRYPTO_hash_xor (const GNUNET_HashCode * a, const GNUNET_HashCode * b, | 503 | GNUNET_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 | */ |
812 | void | 812 | void |
813 | GNUNET_CRYPTO_random_disable_entropy_gathering (void); | 813 | GNUNET_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 | */ |
51 | typedef void (*DiskUtilizationChange) (void *cls, int delta); | 51 | typedef 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 | */ |
377 | void | 377 | void |
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 | */ |
469 | ssize_t | 469 | ssize_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 | */ |
111 | char * | 111 | char * |
@@ -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 | */ |
238 | struct GNUNET_FS_Uri * | 238 | struct 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 | */ |
2070 | struct GNUNET_FS_PublishContext * | 2070 | struct 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 | */ |
2188 | struct GNUNET_FS_UnindexContext * | 2188 | struct GNUNET_FS_UnindexContext * |
2189 | GNUNET_FS_unindex_start (struct GNUNET_FS_Handle *h, const char *filename, | 2189 | GNUNET_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 | */ |
2547 | void | 2547 | void |
@@ -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 | */ |
2623 | struct GNUNET_FS_DirectoryBuilder * | 2623 | struct 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 | */ |
266 | int | 266 | int |
267 | GNUNET_GETOPT_set_one (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx, | 267 | GNUNET_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 | */ |
285 | int | 285 | int |
286 | GNUNET_GETOPT_set_string (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx, | 286 | GNUNET_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 | */ |
303 | int | 303 | int |
304 | GNUNET_GETOPT_increment_value (struct GNUNET_GETOPT_CommandLineProcessorContext | 304 | GNUNET_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 | */ |
141 | struct GNUNET_MESH_Handle * | 141 | struct 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 | */ |
89 | struct GNUNET_NAT_Handle * | 89 | struct GNUNET_NAT_Handle * |
90 | GNUNET_NAT_register (const struct GNUNET_CONFIGURATION_Handle *cfg, int is_tcp, | 90 | GNUNET_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 | */ |
151 | typedef void (*GNUNET_NAT_TestCallback) (void *cls, int success); | 151 | typedef 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 | */ |
250 | void | 250 | void |
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 | */ |
130 | struct GNUNET_PEERINFO_IteratorContext * | 130 | struct 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 | */ |
82 | typedef void (*GNUNET_TRANSPORT_SessionEnd) (void *cls, | 82 | typedef 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 | */ |
405 | typedef const char *(*GNUNET_TRANSPORT_AddressToString) (void *cls, | 405 | typedef 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 |