diff options
author | Christian Grothoff <christian@grothoff.org> | 2013-05-15 13:39:46 +0000 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2013-05-15 13:39:46 +0000 |
commit | 5cce50f3c8b2d0c54230238de5dd19ab8bd2de3b (patch) | |
tree | 060af466361ac4102f2fe24c2d840b1ed6d22ea1 /src/include/gnunet_set_service.h | |
parent | 80417c48637b498d62f2c6eefb5e1a6fc8d5ed50 (diff) | |
download | gnunet-5cce50f3c8b2d0c54230238de5dd19ab8bd2de3b.tar.gz gnunet-5cce50f3c8b2d0c54230238de5dd19ab8bd2de3b.zip |
-comments for Florian
Diffstat (limited to 'src/include/gnunet_set_service.h')
-rw-r--r-- | src/include/gnunet_set_service.h | 19 |
1 files changed, 14 insertions, 5 deletions
diff --git a/src/include/gnunet_set_service.h b/src/include/gnunet_set_service.h index b76882319..72d7ee521 100644 --- a/src/include/gnunet_set_service.h +++ b/src/include/gnunet_set_service.h | |||
@@ -86,17 +86,26 @@ enum GNUNET_SET_Status | |||
86 | * Everything went ok. | 86 | * Everything went ok. |
87 | */ | 87 | */ |
88 | GNUNET_SET_STATUS_OK, | 88 | GNUNET_SET_STATUS_OK, |
89 | |||
89 | /** | 90 | /** |
90 | * There was a timeout. | 91 | * There was a timeout. |
91 | */ | 92 | */ |
92 | GNUNET_SET_STATUS_TIMEOUT, | 93 | GNUNET_SET_STATUS_TIMEOUT, |
94 | |||
93 | /** | 95 | /** |
94 | * The other peer refused to to the operation with us, | 96 | * The other peer refused to to the operation with us, |
95 | * or something went wrong. | 97 | * or something went wrong. |
96 | */ | 98 | */ |
97 | GNUNET_SET_STATUS_FAILURE, | 99 | GNUNET_SET_STATUS_FAILURE, |
100 | |||
101 | /** | ||
102 | * Success, all elements have been returned (but the other | ||
103 | * peer might still be receiving some from us, so we are not done). | ||
104 | */ | ||
105 | GNUNET_SET_STATUS_HALF_DONE, | ||
106 | |||
98 | /** | 107 | /** |
99 | * Success, all elements have been sent. | 108 | * Success, all elements have been sent (and received). |
100 | */ | 109 | */ |
101 | GNUNET_SET_STATUS_DONE | 110 | GNUNET_SET_STATUS_DONE |
102 | }; | 111 | }; |
@@ -140,7 +149,7 @@ struct GNUNET_SET_Element | |||
140 | /** | 149 | /** |
141 | * Actual data of the element | 150 | * Actual data of the element |
142 | */ | 151 | */ |
143 | void *data; | 152 | const void *data; |
144 | }; | 153 | }; |
145 | 154 | ||
146 | 155 | ||
@@ -161,7 +170,7 @@ typedef void (*GNUNET_SET_Continuation) (void *cls); | |||
161 | * @param status see enum GNUNET_SET_Status | 170 | * @param status see enum GNUNET_SET_Status |
162 | */ | 171 | */ |
163 | typedef void (*GNUNET_SET_ResultIterator) (void *cls, | 172 | typedef void (*GNUNET_SET_ResultIterator) (void *cls, |
164 | struct GNUNET_SET_Element *element, | 173 | const struct GNUNET_SET_Element *element, |
165 | enum GNUNET_SET_Status status); | 174 | enum GNUNET_SET_Status status); |
166 | 175 | ||
167 | 176 | ||
@@ -258,7 +267,7 @@ GNUNET_SET_destroy (struct GNUNET_SET_Handle *set); | |||
258 | * fail due to hash collisions, using a different salt for each operation | 267 | * fail due to hash collisions, using a different salt for each operation |
259 | * makes it harder for an attacker to exploit this | 268 | * makes it harder for an attacker to exploit this |
260 | * @param timeout result_cb will be called with GNUNET_SET_STATUS_TIMEOUT | 269 | * @param timeout result_cb will be called with GNUNET_SET_STATUS_TIMEOUT |
261 | * if the operation is not done after the specified time | 270 | * if the operation is not done after the specified time; @deprecated |
262 | * @param result_mode specified how results will be returned, | 271 | * @param result_mode specified how results will be returned, |
263 | * see 'GNUNET_SET_ResultMode'. | 272 | * see 'GNUNET_SET_ResultMode'. |
264 | * @param result_cb called on error or success | 273 | * @param result_cb called on error or success |
@@ -313,7 +322,7 @@ GNUNET_SET_listen_cancel (struct GNUNET_SET_ListenHandle *lh); | |||
313 | * | 322 | * |
314 | * @param request request to accept | 323 | * @param request request to accept |
315 | * @param set set used for the requested operation | 324 | * @param set set used for the requested operation |
316 | * @param timeout timeout for the set operation | 325 | * @param timeout timeout for the set operation, @deprecated |
317 | * @param result_mode specified how results will be returned, | 326 | * @param result_mode specified how results will be returned, |
318 | * see 'GNUNET_SET_ResultMode'. | 327 | * see 'GNUNET_SET_ResultMode'. |
319 | * @param result_cb callback for the results | 328 | * @param result_cb callback for the results |