aboutsummaryrefslogtreecommitdiff
path: root/src/util
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2011-08-29 10:19:43 +0000
committerChristian Grothoff <christian@grothoff.org>2011-08-29 10:19:43 +0000
commitcddbdf5b928c68ab71b40c950b9f01ea68a9fbdb (patch)
treeb704e00a3af618b2cd174a7f89514eaebd82a1cf /src/util
parentbb4fc4f4007988874f910d4de5492f9629301641 (diff)
downloadgnunet-cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb.tar.gz
gnunet-cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb.zip
run indent twice, it alternates between two 'canonical' forms, also run whitespace remover
Diffstat (limited to 'src/util')
-rw-r--r--src/util/bandwidth.c2
-rw-r--r--src/util/client.c8
-rw-r--r--src/util/configuration.c2
-rw-r--r--src/util/connection.c8
-rw-r--r--src/util/container_heap.c8
-rw-r--r--src/util/container_meta_data.c8
-rw-r--r--src/util/container_slist.c4
-rw-r--r--src/util/crypto_hash.c2
-rw-r--r--src/util/crypto_kdf.c2
-rw-r--r--src/util/crypto_random.c2
-rw-r--r--src/util/crypto_rsa.c2
-rw-r--r--src/util/disk.c8
-rw-r--r--src/util/getopt.c6
-rw-r--r--src/util/getopt_helpers.c8
-rw-r--r--src/util/load.c2
-rw-r--r--src/util/os_installation.c2
-rw-r--r--src/util/peer.c2
-rw-r--r--src/util/plugin.c2
-rw-r--r--src/util/pseudonym.c20
-rw-r--r--src/util/resolver_api.c6
-rw-r--r--src/util/scheduler.c16
-rw-r--r--src/util/server.c6
-rw-r--r--src/util/server_mst.c2
-rw-r--r--src/util/server_nc.c4
-rw-r--r--src/util/service.c2
-rw-r--r--src/util/test_container_heap.c6
-rw-r--r--src/util/test_peer.c8
-rw-r--r--src/util/test_resolver_api.c2
-rw-r--r--src/util/time.c2
29 files changed, 76 insertions, 76 deletions
diff --git a/src/util/bandwidth.c b/src/util/bandwidth.c
index 95ff4bfff..8d81e55a0 100644
--- a/src/util/bandwidth.c
+++ b/src/util/bandwidth.c
@@ -20,7 +20,7 @@
20 20
21/** 21/**
22 * @file util/bandwidth.c 22 * @file util/bandwidth.c
23 * @brief functions related to bandwidth (unit) 23 * @brief functions related to bandwidth (unit)
24 * @author Christian Grothoff 24 * @author Christian Grothoff
25 */ 25 */
26#include "platform.h" 26#include "platform.h"
diff --git a/src/util/client.c b/src/util/client.c
index 2b866e6f8..4e6093a68 100644
--- a/src/util/client.c
+++ b/src/util/client.c
@@ -103,7 +103,7 @@ struct GNUNET_CLIENT_TransmitHandle
103 103
104 104
105/** 105/**
106 * Context for processing 106 * Context for processing
107 * "GNUNET_CLIENT_transmit_and_get_response" requests. 107 * "GNUNET_CLIENT_transmit_and_get_response" requests.
108 */ 108 */
109struct TransmitGetResponseContext 109struct TransmitGetResponseContext
@@ -692,7 +692,7 @@ write_test (void *cls, size_t size, void *buf)
692 * 692 *
693 * @param service name of the service to wait for 693 * @param service name of the service to wait for
694 * @param cfg configuration to use 694 * @param cfg configuration to use
695 * @param timeout how long to wait at most 695 * @param timeout how long to wait at most
696 * @param task task to run if service is running 696 * @param task task to run if service is running
697 * (reason will be "PREREQ_DONE" (service running) 697 * (reason will be "PREREQ_DONE" (service running)
698 * or "TIMEOUT" (service not known to be running)) 698 * or "TIMEOUT" (service not known to be running))
@@ -1108,7 +1108,7 @@ GNUNET_CLIENT_notify_transmit_ready (struct GNUNET_CLIENT_Connection *sock,
1108 1108
1109/** 1109/**
1110 * Cancel a request for notification. 1110 * Cancel a request for notification.
1111 * 1111 *
1112 * @param th handle from the original request. 1112 * @param th handle from the original request.
1113 */ 1113 */
1114void 1114void
@@ -1188,7 +1188,7 @@ transmit_for_response (void *cls, size_t size, void *buf)
1188 * if the caller does not care about temporary connection errors, 1188 * if the caller does not care about temporary connection errors,
1189 * for example because the protocol is stateless 1189 * for example because the protocol is stateless
1190 * @param rn function to call with the response 1190 * @param rn function to call with the response
1191 * @param rn_cls closure for rn 1191 * @param rn_cls closure for rn
1192 * @return GNUNET_OK on success, GNUNET_SYSERR if a request 1192 * @return GNUNET_OK on success, GNUNET_SYSERR if a request
1193 * is already pending 1193 * is already pending
1194 */ 1194 */
diff --git a/src/util/configuration.c b/src/util/configuration.c
index 534949652..c69042175 100644
--- a/src/util/configuration.c
+++ b/src/util/configuration.c
@@ -495,7 +495,7 @@ GNUNET_CONFIGURATION_remove_section (struct GNUNET_CONFIGURATION_Handle *cfg,
495 * @param cls the destination configuration (struct GNUNET_CONFIGURATION_Handle*) 495 * @param cls the destination configuration (struct GNUNET_CONFIGURATION_Handle*)
496 * @param section section for the value 496 * @param section section for the value
497 * @param option option name of the value 497 * @param option option name of the value
498 * @param value value to copy 498 * @param value value to copy
499 */ 499 */
500static void 500static void
501copy_entry (void *cls, const char *section, const char *option, 501copy_entry (void *cls, const char *section, const char *option,
diff --git a/src/util/connection.c b/src/util/connection.c
index 9aeca9096..8639d2416 100644
--- a/src/util/connection.c
+++ b/src/util/connection.c
@@ -111,7 +111,7 @@ struct GNUNET_CONNECTION_TransmitHandle
111 111
112/** 112/**
113 * During connect, we try multiple possible IP addresses 113 * During connect, we try multiple possible IP addresses
114 * to find out which one might work. 114 * to find out which one might work.
115 */ 115 */
116struct AddressProbe 116struct AddressProbe
117{ 117{
@@ -165,13 +165,13 @@ struct GNUNET_CONNECTION_Handle
165 const struct GNUNET_CONFIGURATION_Handle *cfg; 165 const struct GNUNET_CONFIGURATION_Handle *cfg;
166 166
167 /** 167 /**
168 * Linked list of sockets we are currently trying out 168 * Linked list of sockets we are currently trying out
169 * (during connect). 169 * (during connect).
170 */ 170 */
171 struct AddressProbe *ap_head; 171 struct AddressProbe *ap_head;
172 172
173 /** 173 /**
174 * Linked list of sockets we are currently trying out 174 * Linked list of sockets we are currently trying out
175 * (during connect). 175 * (during connect).
176 */ 176 */
177 struct AddressProbe *ap_tail; 177 struct AddressProbe *ap_tail;
@@ -1047,7 +1047,7 @@ GNUNET_CONNECTION_check (struct GNUNET_CONNECTION_Handle *sock)
1047/** 1047/**
1048 * Close the socket and free associated resources. Pending 1048 * Close the socket and free associated resources. Pending
1049 * transmissions may be completed or dropped depending on the 1049 * transmissions may be completed or dropped depending on the
1050 * arguments. If a receive call is pending and should 1050 * arguments. If a receive call is pending and should
1051 * NOT be completed, 'GNUNET_CONNECTION_receive_cancel' 1051 * NOT be completed, 'GNUNET_CONNECTION_receive_cancel'
1052 * should be called explicitly first. 1052 * should be called explicitly first.
1053 * 1053 *
diff --git a/src/util/container_heap.c b/src/util/container_heap.c
index 059a5b253..cd4d7909a 100644
--- a/src/util/container_heap.c
+++ b/src/util/container_heap.c
@@ -1,17 +1,17 @@
1/* 1/*
2 This file is part of GNUnet. 2 This file is part of GNUnet.
3 (C) 2008, 2009 Christian Grothoff (and other contributing authors) 3 (C) 2008, 2009 Christian Grothoff (and other contributing authors)
4 4
5 GNUnet is free software; you can redistribute it and/or modify 5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published 6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 2, or (at your 7 by the Free Software Foundation; either version 2, or (at your
8 option) any later version. 8 option) any later version.
9 9
10 GNUnet is distributed in the hope that it will be useful, but 10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of 11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details. 13 General Public License for more details.
14 14
15 You should have received a copy of the GNU General Public License 15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the 16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 59 Temple Place - Suite 330, 17 Free Software Foundation, Inc., 59 Temple Place - Suite 330,
@@ -481,7 +481,7 @@ remove_node (struct GNUNET_CONTAINER_HeapNode *node)
481 481
482/** 482/**
483 * Removes a node from the heap. 483 * Removes a node from the heap.
484 * 484 *
485 * @param node node to remove 485 * @param node node to remove
486 * @return element data stored at the node 486 * @return element data stored at the node
487 */ 487 */
diff --git a/src/util/container_meta_data.c b/src/util/container_meta_data.c
index eb515e8fb..16173cca9 100644
--- a/src/util/container_meta_data.c
+++ b/src/util/container_meta_data.c
@@ -105,7 +105,7 @@ struct GNUNET_CONTAINER_MetaData
105 105
106/** 106/**
107 * Create a fresh struct CONTAINER_MetaData token. 107 * Create a fresh struct CONTAINER_MetaData token.
108 * 108 *
109 * @return empty meta-data container 109 * @return empty meta-data container
110 */ 110 */
111struct GNUNET_CONTAINER_MetaData * 111struct GNUNET_CONTAINER_MetaData *
@@ -251,7 +251,7 @@ GNUNET_CONTAINER_meta_data_test_equal (const struct GNUNET_CONTAINER_MetaData
251 * used in the main libextractor library and yielding 251 * used in the main libextractor library and yielding
252 * meta data). 252 * meta data).
253 * @param type libextractor-type describing the meta data 253 * @param type libextractor-type describing the meta data
254 * @param format basic format information about data 254 * @param format basic format information about data
255 * @param data_mime_type mime-type of data (not of the original file); 255 * @param data_mime_type mime-type of data (not of the original file);
256 * can be NULL (if mime-type is not known) 256 * can be NULL (if mime-type is not known)
257 * @param data actual meta-data found 257 * @param data actual meta-data found
@@ -339,7 +339,7 @@ GNUNET_CONTAINER_meta_data_insert (struct GNUNET_CONTAINER_MetaData *md,
339 * used in the main libextractor library and yielding 339 * used in the main libextractor library and yielding
340 * meta data). 340 * meta data).
341 * @param type libextractor-type describing the meta data 341 * @param type libextractor-type describing the meta data
342 * @param format basic format information about data 342 * @param format basic format information about data
343 * @param data_mime_type mime-type of data (not of the original file); 343 * @param data_mime_type mime-type of data (not of the original file);
344 * can be NULL (if mime-type is not known) 344 * can be NULL (if mime-type is not known)
345 * @param data actual meta-data found 345 * @param data actual meta-data found
@@ -587,7 +587,7 @@ GNUNET_CONTAINER_meta_data_get_thumbnail (const struct GNUNET_CONTAINER_MetaData
587 587
588/** 588/**
589 * Duplicate struct GNUNET_CONTAINER_MetaData. 589 * Duplicate struct GNUNET_CONTAINER_MetaData.
590 * 590 *
591 * @param md what to duplicate 591 * @param md what to duplicate
592 * @return duplicate meta-data container 592 * @return duplicate meta-data container
593 */ 593 */
diff --git a/src/util/container_slist.c b/src/util/container_slist.c
index 2d7c24c03..1dd0344e4 100644
--- a/src/util/container_slist.c
+++ b/src/util/container_slist.c
@@ -55,7 +55,7 @@ struct GNUNET_CONTAINER_SList_Elem
55 55
56 56
57/** 57/**
58 * Handle to a singly linked list 58 * Handle to a singly linked list
59 */ 59 */
60struct GNUNET_CONTAINER_SList 60struct GNUNET_CONTAINER_SList
61{ 61{
@@ -77,7 +77,7 @@ struct GNUNET_CONTAINER_SList
77 77
78 78
79/** 79/**
80 * Handle to a singly linked list iterator 80 * Handle to a singly linked list iterator
81 */ 81 */
82struct GNUNET_CONTAINER_SList_Iterator 82struct GNUNET_CONTAINER_SList_Iterator
83{ 83{
diff --git a/src/util/crypto_hash.c b/src/util/crypto_hash.c
index 6438784ba..c253bbf2f 100644
--- a/src/util/crypto_hash.c
+++ b/src/util/crypto_hash.c
@@ -340,7 +340,7 @@ GNUNET_CRYPTO_hash_from_string (const char *enc, GNUNET_HashCode * result)
340 * fast, not involve bits[0] or bits[4] (they're used elsewhere), and be 340 * fast, not involve bits[0] or bits[4] (they're used elsewhere), and be
341 * somewhat consistent. And of course, the result should be a positive 341 * somewhat consistent. And of course, the result should be a positive
342 * number. 342 * number.
343 * 343 *
344 * @param a some hash code 344 * @param a some hash code
345 * @param b some hash code 345 * @param b some hash code
346 * @return a positive number which is a measure for 346 * @return a positive number which is a measure for
diff --git a/src/util/crypto_kdf.c b/src/util/crypto_kdf.c
index cd665ad23..eff4e6fd6 100644
--- a/src/util/crypto_kdf.c
+++ b/src/util/crypto_kdf.c
@@ -53,7 +53,7 @@ GNUNET_CRYPTO_kdf_v (void *result, size_t out_len, const void *xts,
53 * setting. Second, as shown in Section 6, using HMAC with a truncated output as an extractor 53 * setting. Second, as shown in Section 6, using HMAC with a truncated output as an extractor
54 * allows to prove the security of HKDF under considerably weaker assumptions on the underlying 54 * allows to prove the security of HKDF under considerably weaker assumptions on the underlying
55 * hash function." 55 * hash function."
56 * 56 *
57 * http://eprint.iacr.org/2010/264 57 * http://eprint.iacr.org/2010/264
58 */ 58 */
59 59
diff --git a/src/util/crypto_random.c b/src/util/crypto_random.c
index bb105437d..445f99a62 100644
--- a/src/util/crypto_random.c
+++ b/src/util/crypto_random.c
@@ -32,7 +32,7 @@
32 32
33/** 33/**
34 * Create a cryptographically weak pseudo-random number in the interval of 0 to 1. 34 * Create a cryptographically weak pseudo-random number in the interval of 0 to 1.
35 * 35 *
36 * @return number between 0 and 1. 36 * @return number between 0 and 1.
37 */ 37 */
38static double 38static double
diff --git a/src/util/crypto_rsa.c b/src/util/crypto_rsa.c
index ec46b486c..46778a842 100644
--- a/src/util/crypto_rsa.c
+++ b/src/util/crypto_rsa.c
@@ -547,7 +547,7 @@ GNUNET_CRYPTO_rsa_decode_key (const char *buf, uint16_t len)
547 * files does not exist, create a new key and write it to the 547 * files does not exist, create a new key and write it to the
548 * file. Caller must free return value. Note that this function 548 * file. Caller must free return value. Note that this function
549 * can not guarantee that another process might not be trying 549 * can not guarantee that another process might not be trying
550 * the same operation on the same file at the same time. 550 * the same operation on the same file at the same time.
551 * If the contents of the file 551 * If the contents of the file
552 * are invalid the old file is deleted and a fresh key is 552 * are invalid the old file is deleted and a fresh key is
553 * created. 553 * created.
diff --git a/src/util/disk.c b/src/util/disk.c
index 6ba5db773..9059852d3 100644
--- a/src/util/disk.c
+++ b/src/util/disk.c
@@ -139,7 +139,7 @@ translate_unix_perms (enum GNUNET_DISK_AccessPermissions perm)
139 139
140 140
141/** 141/**
142 * Iterate over all files in the given directory and 142 * Iterate over all files in the given directory and
143 * accumulate their size. 143 * accumulate their size.
144 * 144 *
145 * @param cls closure of type "struct GetFileSizeData" 145 * @param cls closure of type "struct GetFileSizeData"
@@ -339,7 +339,7 @@ GNUNET_DISK_file_get_identifiers (const char *filename, uint64_t * dev,
339 * an absolute path, the current 'TMPDIR' will be prepended. In any case, 339 * an absolute path, the current 'TMPDIR' will be prepended. In any case,
340 * 6 random characters will be appended to the name to create a unique 340 * 6 random characters will be appended to the name to create a unique
341 * filename. 341 * filename.
342 * 342 *
343 * @param t component to use for the name; 343 * @param t component to use for the name;
344 * does NOT contain "XXXXXX" or "/tmp/". 344 * does NOT contain "XXXXXX" or "/tmp/".
345 * @return NULL on error, otherwise name of fresh 345 * @return NULL on error, otherwise name of fresh
@@ -767,7 +767,7 @@ GNUNET_DISK_file_write (const struct GNUNET_DISK_FileHandle * h,
767 * @param fn file name 767 * @param fn file name
768 * @param buffer the data to write 768 * @param buffer the data to write
769 * @param n number of bytes to write 769 * @param n number of bytes to write
770 * @param mode file permissions 770 * @param mode file permissions
771 * @return number of bytes written on success, GNUNET_SYSERR on error 771 * @return number of bytes written on success, GNUNET_SYSERR on error
772 */ 772 */
773ssize_t 773ssize_t
@@ -788,7 +788,7 @@ GNUNET_DISK_fn_write (const char *fn, const void *buffer, size_t n,
788} 788}
789 789
790/** 790/**
791 * Scan a directory for files. 791 * Scan a directory for files.
792 * 792 *
793 * @param dirName the name of the directory 793 * @param dirName the name of the directory
794 * @param callback the method to call for each file, 794 * @param callback the method to call for each file,
diff --git a/src/util/getopt.c b/src/util/getopt.c
index eb79db757..d48183b2a 100644
--- a/src/util/getopt.c
+++ b/src/util/getopt.c
@@ -609,16 +609,16 @@ GN_getopt_internal (int argc, char *const *argv, const char *optstring,
609 /* Decode the current option-ARGV-element. */ 609 /* Decode the current option-ARGV-element. */
610 610
611 /* Check whether the ARGV-element is a long option. 611 /* Check whether the ARGV-element is a long option.
612 * 612 *
613 * If long_only and the ARGV-element has the form "-f", where f is 613 * If long_only and the ARGV-element has the form "-f", where f is
614 * a valid short option, don't consider it an abbreviated form of 614 * a valid short option, don't consider it an abbreviated form of
615 * a long option that starts with f. Otherwise there would be no 615 * a long option that starts with f. Otherwise there would be no
616 * way to give the -f short option. 616 * way to give the -f short option.
617 * 617 *
618 * On the other hand, if there's a long option "fubar" and 618 * On the other hand, if there's a long option "fubar" and
619 * the ARGV-element is "-fu", do consider that an abbreviation of 619 * the ARGV-element is "-fu", do consider that an abbreviation of
620 * the long option, just like "--fu", and not "-f" with arg "u". 620 * the long option, just like "--fu", and not "-f" with arg "u".
621 * 621 *
622 * This distinction seems to be the most useful approach. */ 622 * This distinction seems to be the most useful approach. */
623 623
624 if (longopts != NULL && 624 if (longopts != NULL &&
diff --git a/src/util/getopt_helpers.c b/src/util/getopt_helpers.c
index d0c8c0e6a..d050ec99c 100644
--- a/src/util/getopt_helpers.c
+++ b/src/util/getopt_helpers.c
@@ -163,7 +163,7 @@ OUTER:
163 * @param scls additional closure (will point to the 'int') 163 * @param scls additional closure (will point to the 'int')
164 * @param option name of the option 164 * @param option name of the option
165 * @param value not used (NULL) 165 * @param value not used (NULL)
166 * @return GNUNET_OK 166 * @return GNUNET_OK
167 */ 167 */
168int 168int
169GNUNET_GETOPT_increment_value (struct GNUNET_GETOPT_CommandLineProcessorContext 169GNUNET_GETOPT_increment_value (struct GNUNET_GETOPT_CommandLineProcessorContext
@@ -178,7 +178,7 @@ GNUNET_GETOPT_increment_value (struct GNUNET_GETOPT_CommandLineProcessorContext
178 178
179 179
180/** 180/**
181 * Set an option of type 'int' from the command line to 1 if the 181 * Set an option of type 'int' from the command line to 1 if the
182 * given option is present. 182 * given option is present.
183 * A pointer to this function should be passed as part of the 183 * A pointer to this function should be passed as part of the
184 * 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options 184 * 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options
@@ -189,7 +189,7 @@ GNUNET_GETOPT_increment_value (struct GNUNET_GETOPT_CommandLineProcessorContext
189 * @param scls additional closure (will point to the 'int') 189 * @param scls additional closure (will point to the 'int')
190 * @param option name of the option 190 * @param option name of the option
191 * @param value not used (NULL) 191 * @param value not used (NULL)
192 * @return GNUNET_OK 192 * @return GNUNET_OK
193 */ 193 */
194int 194int
195GNUNET_GETOPT_set_one (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx, 195GNUNET_GETOPT_set_one (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx,
@@ -214,7 +214,7 @@ GNUNET_GETOPT_set_one (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx,
214 * which will be allocated) 214 * which will be allocated)
215 * @param option name of the option 215 * @param option name of the option
216 * @param value actual value of the option (a string) 216 * @param value actual value of the option (a string)
217 * @return GNUNET_OK 217 * @return GNUNET_OK
218 */ 218 */
219int 219int
220GNUNET_GETOPT_set_string (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx, 220GNUNET_GETOPT_set_string (struct GNUNET_GETOPT_CommandLineProcessorContext *ctx,
diff --git a/src/util/load.c b/src/util/load.c
index c7ef07295..35ed443c3 100644
--- a/src/util/load.c
+++ b/src/util/load.c
@@ -164,7 +164,7 @@ calculate_load (struct GNUNET_LOAD_Value *load)
164 if (load->cummulative_request_count <= 1) 164 if (load->cummulative_request_count <= 1)
165 return; 165 return;
166 /* calcuate std dev of latency; we have for n values of "i" that: 166 /* calcuate std dev of latency; we have for n values of "i" that:
167 * 167 *
168 * avg = (sum val_i) / n 168 * avg = (sum val_i) / n
169 * stddev = (sum (val_i - avg)^2) / (n-1) 169 * stddev = (sum (val_i - avg)^2) / (n-1)
170 * = (sum (val_i^2 - 2 avg val_i + avg^2) / (n-1) 170 * = (sum (val_i^2 - 2 avg val_i + avg^2) / (n-1)
diff --git a/src/util/os_installation.c b/src/util/os_installation.c
index 00825f2b7..1f4c5f000 100644
--- a/src/util/os_installation.c
+++ b/src/util/os_installation.c
@@ -435,7 +435,7 @@ GNUNET_OS_installation_get_path (enum GNUNET_OS_InstallationPathKind dirkind)
435 * PATH environment variable as a search path. 435 * PATH environment variable as a search path.
436 * 436 *
437 * @param binary the name of the file to check 437 * @param binary the name of the file to check
438 * @return GNUNET_YES if the file is SUID, 438 * @return GNUNET_YES if the file is SUID,
439 * GNUNET_NO if not SUID (but binary exists) 439 * GNUNET_NO if not SUID (but binary exists)
440 * GNUNET_SYSERR on error (no such binary or not executable) 440 * GNUNET_SYSERR on error (no such binary or not executable)
441 */ 441 */
diff --git a/src/util/peer.c b/src/util/peer.c
index cd5444a19..1491211c5 100644
--- a/src/util/peer.c
+++ b/src/util/peer.c
@@ -157,7 +157,7 @@ GNUNET_PEER_intern (const struct GNUNET_PeerIdentity *pid)
157 157
158/** 158/**
159 * Decrement multiple RCs of peer identities by one. 159 * Decrement multiple RCs of peer identities by one.
160 * 160 *
161 * @param ids array of PIDs to decrement the RCs of 161 * @param ids array of PIDs to decrement the RCs of
162 * @param count size of the ids array 162 * @param count size of the ids array
163 */ 163 */
diff --git a/src/util/plugin.c b/src/util/plugin.c
index 08b32b295..dbd3519aa 100644
--- a/src/util/plugin.c
+++ b/src/util/plugin.c
@@ -151,7 +151,7 @@ resolve_function (struct PluginList *plug, const char *name)
151 * Test if a plugin exists. 151 * Test if a plugin exists.
152 * 152 *
153 * Note that the library must export a symbol called 153 * Note that the library must export a symbol called
154 * "library_name_init" for the test to succeed. 154 * "library_name_init" for the test to succeed.
155 * 155 *
156 * @param library_name name of the plugin to test if it is installed 156 * @param library_name name of the plugin to test if it is installed
157 * @return GNUNET_YES if the plugin exists, GNUNET_NO if not 157 * @return GNUNET_YES if the plugin exists, GNUNET_NO if not
diff --git a/src/util/pseudonym.c b/src/util/pseudonym.c
index 85a485098..85353c6da 100644
--- a/src/util/pseudonym.c
+++ b/src/util/pseudonym.c
@@ -31,41 +31,41 @@
31#include "gnunet_pseudonym_lib.h" 31#include "gnunet_pseudonym_lib.h"
32#include "gnunet_bio_lib.h" 32#include "gnunet_bio_lib.h"
33 33
34/** 34/**
35 * Name of the directory which stores meta data for pseudonym 35 * Name of the directory which stores meta data for pseudonym
36 */ 36 */
37#define PS_METADATA_DIR DIR_SEPARATOR_STR "data" DIR_SEPARATOR_STR "pseudonyms" DIR_SEPARATOR_STR "metadata" DIR_SEPARATOR_STR 37#define PS_METADATA_DIR DIR_SEPARATOR_STR "data" DIR_SEPARATOR_STR "pseudonyms" DIR_SEPARATOR_STR "metadata" DIR_SEPARATOR_STR
38 38
39/** 39/**
40 * Name of the directory which stores names for pseudonyms 40 * Name of the directory which stores names for pseudonyms
41 */ 41 */
42#define PS_NAMES_DIR DIR_SEPARATOR_STR "data" DIR_SEPARATOR_STR "pseudonyms" DIR_SEPARATOR_STR "names" DIR_SEPARATOR_STR 42#define PS_NAMES_DIR DIR_SEPARATOR_STR "data" DIR_SEPARATOR_STR "pseudonyms" DIR_SEPARATOR_STR "names" DIR_SEPARATOR_STR
43 43
44 44
45/** 45/**
46 * Registered callbacks for discovery of pseudonyms. 46 * Registered callbacks for discovery of pseudonyms.
47 */ 47 */
48struct DiscoveryCallback 48struct DiscoveryCallback
49{ 49{
50 /** 50 /**
51 * This is a linked list. 51 * This is a linked list.
52 */ 52 */
53 struct DiscoveryCallback *next; 53 struct DiscoveryCallback *next;
54 54
55 /** 55 /**
56 * Function to call each time a pseudonym is discovered. 56 * Function to call each time a pseudonym is discovered.
57 */ 57 */
58 GNUNET_PSEUDONYM_Iterator callback; 58 GNUNET_PSEUDONYM_Iterator callback;
59 59
60 /** 60 /**
61 * Closure for callback. 61 * Closure for callback.
62 */ 62 */
63 void *closure; 63 void *closure;
64}; 64};
65 65
66 66
67/** 67/**
68 * Head of the linked list of functions to call when 68 * Head of the linked list of functions to call when
69 * new pseudonyms are added. 69 * new pseudonyms are added.
70 */ 70 */
71static struct DiscoveryCallback *head; 71static struct DiscoveryCallback *head;
@@ -280,7 +280,7 @@ read_info (const struct GNUNET_CONFIGURATION_Handle *cfg,
280/** 280/**
281 * Return the unique, human readable name for the given namespace. 281 * Return the unique, human readable name for the given namespace.
282 * 282 *
283 * @param cfg configuration 283 * @param cfg configuration
284 * @param nsid cryptographic ID of the namespace 284 * @param nsid cryptographic ID of the namespace
285 * @return NULL on failure (should never happen) 285 * @return NULL on failure (should never happen)
286 */ 286 */
@@ -489,7 +489,7 @@ list_pseudonym_helper (void *cls, const char *fullname)
489/** 489/**
490 * List all available pseudonyms. 490 * List all available pseudonyms.
491 * 491 *
492 * @param cfg overall configuration 492 * @param cfg overall configuration
493 * @param iterator function to call for each pseudonym 493 * @param iterator function to call for each pseudonym
494 * @param closure closure for iterator 494 * @param closure closure for iterator
495 * @return number of pseudonyms found 495 * @return number of pseudonyms found
diff --git a/src/util/resolver_api.c b/src/util/resolver_api.c
index 3607ce67f..69c49d1e8 100644
--- a/src/util/resolver_api.c
+++ b/src/util/resolver_api.c
@@ -268,7 +268,7 @@ GNUNET_RESOLVER_disconnect ()
268/** 268/**
269 * Convert IP address to string without DNS resolution. 269 * Convert IP address to string without DNS resolution.
270 * 270 *
271 * @param sa the address 271 * @param sa the address
272 * @param salen number of bytes in sa 272 * @param salen number of bytes in sa
273 * @return address as a string, NULL on error 273 * @return address as a string, NULL on error
274 */ 274 */
@@ -469,7 +469,7 @@ handle_response (void *cls, const struct GNUNET_MessageHeader *msg)
469 469
470 470
471/** 471/**
472 * We've been asked to lookup the address for a hostname and were 472 * We've been asked to lookup the address for a hostname and were
473 * given a valid numeric string. Perform the callbacks for the 473 * given a valid numeric string. Perform the callbacks for the
474 * numeric addresses. 474 * numeric addresses.
475 * 475 *
@@ -524,7 +524,7 @@ numeric_resolution (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
524 524
525 525
526/** 526/**
527 * We've been asked to lookup the address for a hostname and were 527 * We've been asked to lookup the address for a hostname and were
528 * given a variant of "loopback". Perform the callbacks for the 528 * given a variant of "loopback". Perform the callbacks for the
529 * respective loopback numeric addresses. 529 * respective loopback numeric addresses.
530 * 530 *
diff --git a/src/util/scheduler.c b/src/util/scheduler.c
index 52824d8b3..0ed48e793 100644
--- a/src/util/scheduler.c
+++ b/src/util/scheduler.c
@@ -613,7 +613,7 @@ destroy_task (struct Task *t)
613 * empty. Keep running tasks until we are either no longer running 613 * empty. Keep running tasks until we are either no longer running
614 * "URGENT" tasks or until we have at least one "pending" task (which 614 * "URGENT" tasks or until we have at least one "pending" task (which
615 * may become ready, hence we should select on it). Naturally, if 615 * may become ready, hence we should select on it). Naturally, if
616 * there are no more ready tasks, we also return. 616 * there are no more ready tasks, we also return.
617 * 617 *
618 * @param rs FDs ready for reading 618 * @param rs FDs ready for reading
619 * @param ws FDs ready for writing 619 * @param ws FDs ready for writing
@@ -726,7 +726,7 @@ sighandler_shutdown ()
726 726
727/** 727/**
728 * Check if the system is still life. Trigger shutdown if we 728 * Check if the system is still life. Trigger shutdown if we
729 * have tasks, but none of them give us lifeness. 729 * have tasks, but none of them give us lifeness.
730 * 730 *
731 * @return GNUNET_OK to continue the main loop, 731 * @return GNUNET_OK to continue the main loop,
732 * GNUNET_NO to exit 732 * GNUNET_NO to exit
@@ -893,7 +893,7 @@ GNUNET_SCHEDULER_run (GNUNET_SCHEDULER_Task task, void *task_cls)
893 893
894/** 894/**
895 * Obtain the reason code for why the current task was 895 * Obtain the reason code for why the current task was
896 * started. Will return the same value as 896 * started. Will return the same value as
897 * the GNUNET_SCHEDULER_TaskContext's reason field. 897 * the GNUNET_SCHEDULER_TaskContext's reason field.
898 * 898 *
899 * @return reason(s) why the current task is run 899 * @return reason(s) why the current task is run
@@ -1134,7 +1134,7 @@ GNUNET_SCHEDULER_add_with_priority (enum GNUNET_SCHEDULER_Priority prio,
1134 * will be scheduled for execution once the delay has expired. It 1134 * will be scheduled for execution once the delay has expired. It
1135 * will be run with the priority of the calling task. 1135 * will be run with the priority of the calling task.
1136 * 1136 *
1137 * @param delay when should this operation time out? Use 1137 * @param delay when should this operation time out? Use
1138 * GNUNET_TIME_UNIT_FOREVER_REL for "on shutdown" 1138 * GNUNET_TIME_UNIT_FOREVER_REL for "on shutdown"
1139 * @param task main function of the task 1139 * @param task main function of the task
1140 * @param task_cls closure of task 1140 * @param task_cls closure of task
@@ -1404,7 +1404,7 @@ add_without_sets (struct GNUNET_TIME_Relative delay, int rfd, int wfd,
1404 * socket operation is ready. It will be run with the priority of 1404 * socket operation is ready. It will be run with the priority of
1405 * the calling task. 1405 * the calling task.
1406 * 1406 *
1407 * @param delay when should this operation time out? Use 1407 * @param delay when should this operation time out? Use
1408 * GNUNET_TIME_UNIT_FOREVER_REL for "on shutdown" 1408 * GNUNET_TIME_UNIT_FOREVER_REL for "on shutdown"
1409 * @param rfd read file-descriptor 1409 * @param rfd read file-descriptor
1410 * @param task main function of the task 1410 * @param task main function of the task
@@ -1445,7 +1445,7 @@ GNUNET_SCHEDULER_add_read_net (struct GNUNET_TIME_Relative delay,
1445 * socket operation is ready. It will be run with the priority of 1445 * socket operation is ready. It will be run with the priority of
1446 * the calling task. 1446 * the calling task.
1447 * 1447 *
1448 * @param delay when should this operation time out? Use 1448 * @param delay when should this operation time out? Use
1449 * GNUNET_TIME_UNIT_FOREVER_REL for "on shutdown" 1449 * GNUNET_TIME_UNIT_FOREVER_REL for "on shutdown"
1450 * @param wfd write file-descriptor 1450 * @param wfd write file-descriptor
1451 * @param task main function of the task 1451 * @param task main function of the task
@@ -1487,7 +1487,7 @@ GNUNET_SCHEDULER_add_write_net (struct GNUNET_TIME_Relative delay,
1487 * socket operation is ready. It will be run with the priority of 1487 * socket operation is ready. It will be run with the priority of
1488 * the calling task. 1488 * the calling task.
1489 * 1489 *
1490 * @param delay when should this operation time out? Use 1490 * @param delay when should this operation time out? Use
1491 * GNUNET_TIME_UNIT_FOREVER_REL for "on shutdown" 1491 * GNUNET_TIME_UNIT_FOREVER_REL for "on shutdown"
1492 * @param rfd read file-descriptor 1492 * @param rfd read file-descriptor
1493 * @param task main function of the task 1493 * @param task main function of the task
@@ -1531,7 +1531,7 @@ GNUNET_SCHEDULER_add_read_file (struct GNUNET_TIME_Relative delay,
1531 * socket operation is ready. It will be run with the priority of 1531 * socket operation is ready. It will be run with the priority of
1532 * the calling task. 1532 * the calling task.
1533 * 1533 *
1534 * @param delay when should this operation time out? Use 1534 * @param delay when should this operation time out? Use
1535 * GNUNET_TIME_UNIT_FOREVER_REL for "on shutdown" 1535 * GNUNET_TIME_UNIT_FOREVER_REL for "on shutdown"
1536 * @param wfd write file-descriptor 1536 * @param wfd write file-descriptor
1537 * @param task main function of the task 1537 * @param task main function of the task
diff --git a/src/util/server.c b/src/util/server.c
index ddbae4410..ce5d16e1e 100644
--- a/src/util/server.c
+++ b/src/util/server.c
@@ -742,7 +742,7 @@ process_incoming (void *cls, const void *buf, size_t available,
742 742
743/** 743/**
744 * Process messages from the client's message tokenizer until either 744 * Process messages from the client's message tokenizer until either
745 * the tokenizer is empty (and then schedule receiving more), or 745 * the tokenizer is empty (and then schedule receiving more), or
746 * until some handler is not immediately done (then wait for restart_processing) 746 * until some handler is not immediately done (then wait for restart_processing)
747 * or shutdown. 747 * or shutdown.
748 * 748 *
@@ -1229,10 +1229,10 @@ GNUNET_SERVER_client_disable_corking (struct GNUNET_SERVER_Client *client)
1229/** 1229/**
1230 * Wrapper for transmission notification that calls the original 1230 * Wrapper for transmission notification that calls the original
1231 * callback and update the last activity time for our connection. 1231 * callback and update the last activity time for our connection.
1232 * 1232 *
1233 * @param cls the 'struct GNUNET_SERVER_Client' 1233 * @param cls the 'struct GNUNET_SERVER_Client'
1234 * @param size number of bytes we can transmit 1234 * @param size number of bytes we can transmit
1235 * @param buf where to copy the message 1235 * @param buf where to copy the message
1236 * @return number of bytes actually transmitted 1236 * @return number of bytes actually transmitted
1237 */ 1237 */
1238static size_t 1238static size_t
diff --git a/src/util/server_mst.c b/src/util/server_mst.c
index 07a7b30b8..ad3be8f63 100644
--- a/src/util/server_mst.c
+++ b/src/util/server_mst.c
@@ -110,7 +110,7 @@ GNUNET_SERVER_mst_create (GNUNET_SERVER_MessageTokenizerCallback cb,
110 * @param client_identity ID of client for which this is a buffer 110 * @param client_identity ID of client for which this is a buffer
111 * @param buf input data to add 111 * @param buf input data to add
112 * @param size number of bytes in buf 112 * @param size number of bytes in buf
113 * @param purge should any excess bytes in the buffer be discarded 113 * @param purge should any excess bytes in the buffer be discarded
114 * (i.e. for packet-based services like UDP) 114 * (i.e. for packet-based services like UDP)
115 * @param one_shot only call callback once, keep rest of message in buffer 115 * @param one_shot only call callback once, keep rest of message in buffer
116 * @return GNUNET_OK if we are done processing (need more data) 116 * @return GNUNET_OK if we are done processing (need more data)
diff --git a/src/util/server_nc.c b/src/util/server_nc.c
index a5ee7e0d6..7a26ab9bf 100644
--- a/src/util/server_nc.c
+++ b/src/util/server_nc.c
@@ -21,7 +21,7 @@
21/** 21/**
22 * @file util/server_nc.c 22 * @file util/server_nc.c
23 * @brief convenience functions for transmission of 23 * @brief convenience functions for transmission of
24 * a notification stream 24 * a notification stream
25 * @author Christian Grothoff 25 * @author Christian Grothoff
26 */ 26 */
27 27
@@ -78,7 +78,7 @@ struct ClientList
78 struct ClientList *next; 78 struct ClientList *next;
79 79
80 /** 80 /**
81 * Overall context this client belongs to. 81 * Overall context this client belongs to.
82 */ 82 */
83 struct GNUNET_SERVER_NotificationContext *nc; 83 struct GNUNET_SERVER_NotificationContext *nc;
84 84
diff --git a/src/util/service.c b/src/util/service.c
index 9b60dc56b..9e15ae1ab 100644
--- a/src/util/service.c
+++ b/src/util/service.c
@@ -751,7 +751,7 @@ add_unixpath (struct sockaddr **saddrs, socklen_t * saddrlens,
751 *saddrs = (struct sockaddr *) un; 751 *saddrs = (struct sockaddr *) un;
752 *saddrlens = slen; 752 *saddrlens = slen;
753#else 753#else
754 /* this function should never be called 754 /* this function should never be called
755 * unless AF_UNIX is defined! */ 755 * unless AF_UNIX is defined! */
756 GNUNET_assert (0); 756 GNUNET_assert (0);
757#endif 757#endif
diff --git a/src/util/test_container_heap.c b/src/util/test_container_heap.c
index 62d675bbb..a2a004aa7 100644
--- a/src/util/test_container_heap.c
+++ b/src/util/test_container_heap.c
@@ -67,7 +67,7 @@ check ()
67 n1 = GNUNET_CONTAINER_heap_peek (myHeap); 67 n1 = GNUNET_CONTAINER_heap_peek (myHeap);
68 GNUNET_assert (NULL == n1); 68 GNUNET_assert (NULL == n1);
69 69
70 // GNUNET_CONTAINER_heap_walk_get_next: heap empty, taking if-branch 70 // GNUNET_CONTAINER_heap_walk_get_next: heap empty, taking if-branch
71 n1 = GNUNET_CONTAINER_heap_walk_get_next (myHeap); 71 n1 = GNUNET_CONTAINER_heap_walk_get_next (myHeap);
72 GNUNET_assert (NULL == n1); 72 GNUNET_assert (NULL == n1);
73 73
@@ -75,7 +75,7 @@ check ()
75 GNUNET_assert (NULL != n1); 75 GNUNET_assert (NULL != n1);
76 76
77 77
78 // GNUNET_CONTAINER_heap_peek not empty, taking if-branch 78 // GNUNET_CONTAINER_heap_peek not empty, taking if-branch
79 n2 = NULL; 79 n2 = NULL;
80 n2 = GNUNET_CONTAINER_heap_peek (myHeap); 80 n2 = GNUNET_CONTAINER_heap_peek (myHeap);
81 GNUNET_assert (NULL != n2); 81 GNUNET_assert (NULL != n2);
@@ -122,7 +122,7 @@ check ()
122 122
123 GNUNET_CONTAINER_heap_destroy (myHeap); 123 GNUNET_CONTAINER_heap_destroy (myHeap);
124 124
125 // My additions to a complete testcase 125 // My additions to a complete testcase
126 // Testing a GNUNET_CONTAINER_HEAP_ORDER_MIN 126 // Testing a GNUNET_CONTAINER_HEAP_ORDER_MIN
127 // Testing remove_node 127 // Testing remove_node
128 128
diff --git a/src/util/test_peer.c b/src/util/test_peer.c
index 395d40712..1729114ff 100644
--- a/src/util/test_peer.c
+++ b/src/util/test_peer.c
@@ -32,7 +32,7 @@
32#define DEBUG GNUNET_NO 32#define DEBUG GNUNET_NO
33 33
34/** 34/**
35 * A list of Peer ID's to play with 35 * A list of Peer ID's to play with
36 */ 36 */
37static struct GNUNET_PeerIdentity pidArr[NUMBER_OF_PEERS]; 37static struct GNUNET_PeerIdentity pidArr[NUMBER_OF_PEERS];
38 38
@@ -99,10 +99,10 @@ check ()
99 GNUNET_PEER_resolve (1, &res); 99 GNUNET_PEER_resolve (1, &res);
100 GNUNET_assert (0 == memcmp (&res, &pidArr[0], sizeof (res))); 100 GNUNET_assert (0 == memcmp (&res, &pidArr[0], sizeof (res)));
101 101
102 /* 102 /*
103 * Attempt to convert pid = 0 (which is reserved) 103 * Attempt to convert pid = 0 (which is reserved)
104 * into a peer identity object, the peer identity memory 104 * into a peer identity object, the peer identity memory
105 * is expected to be set to zero 105 * is expected to be set to zero
106 */ 106 */
107 memset (&zero, 0, sizeof (struct GNUNET_PeerIdentity)); 107 memset (&zero, 0, sizeof (struct GNUNET_PeerIdentity));
108 GNUNET_log_skip (1, GNUNET_YES); 108 GNUNET_log_skip (1, GNUNET_YES);
diff --git a/src/util/test_resolver_api.c b/src/util/test_resolver_api.c
index 563f204eb..704dc479b 100644
--- a/src/util/test_resolver_api.c
+++ b/src/util/test_resolver_api.c
@@ -32,7 +32,7 @@
32 32
33#define VERBOSE GNUNET_NO 33#define VERBOSE GNUNET_NO
34 34
35/** 35/**
36 * Using DNS root servers to check gnunet's resolver service 36 * Using DNS root servers to check gnunet's resolver service
37 * a.root-servers.net <-> 198.41.0.4 is a fix 1:1 mapping that should not change over years 37 * a.root-servers.net <-> 198.41.0.4 is a fix 1:1 mapping that should not change over years
38 * For more information have a look at IANA's website http://www.root-servers.org/ 38 * For more information have a look at IANA's website http://www.root-servers.org/
diff --git a/src/util/time.c b/src/util/time.c
index 34880b08b..d3dd3b5ec 100644
--- a/src/util/time.c
+++ b/src/util/time.c
@@ -353,7 +353,7 @@ GNUNET_TIME_relative_divide (struct GNUNET_TIME_Relative rel,
353 353
354 354
355/** 355/**
356 * Calculate the estimate time of arrival/completion 356 * Calculate the estimate time of arrival/completion
357 * for an operation. 357 * for an operation.
358 * 358 *
359 * @param start when did the operation start? 359 * @param start when did the operation start?