diff options
author | Omar Tarabai <tarabai@devegypt.com> | 2014-07-24 12:44:24 +0000 |
---|---|---|
committer | Omar Tarabai <tarabai@devegypt.com> | 2014-07-24 12:44:24 +0000 |
commit | c057bd312c783e0a2f3783dfd888a66f490b0a30 (patch) | |
tree | ff87b7bf7189a723045d7c851d2d383b786724ec /src/include/gnunet_peerstore_service.h | |
parent | f2594744c121f45f3b36867b051220e7186d6f9b (diff) | |
download | gnunet-c057bd312c783e0a2f3783dfd888a66f490b0a30.tar.gz gnunet-c057bd312c783e0a2f3783dfd888a66f490b0a30.zip |
peerstore: doxygen
Diffstat (limited to 'src/include/gnunet_peerstore_service.h')
-rw-r--r-- | src/include/gnunet_peerstore_service.h | 33 |
1 files changed, 18 insertions, 15 deletions
diff --git a/src/include/gnunet_peerstore_service.h b/src/include/gnunet_peerstore_service.h index ca751af96..fcd0bb5f2 100644 --- a/src/include/gnunet_peerstore_service.h +++ b/src/include/gnunet_peerstore_service.h | |||
@@ -134,7 +134,8 @@ GNUNET_PEERSTORE_connect (const struct GNUNET_CONFIGURATION_Handle *cfg); | |||
134 | 134 | ||
135 | /** | 135 | /** |
136 | * Disconnect from the PEERSTORE service. Any pending ITERATE and WATCH requests | 136 | * Disconnect from the PEERSTORE service. Any pending ITERATE and WATCH requests |
137 | * will be canceled. Any pending STORE requests will depend on @snyc_first flag. | 137 | * will be canceled. |
138 | * Any pending STORE requests will depend on @e snyc_first flag. | ||
138 | * | 139 | * |
139 | * @param h handle to disconnect | 140 | * @param h handle to disconnect |
140 | * @param sync_first send any pending STORE requests before disconnecting | 141 | * @param sync_first send any pending STORE requests before disconnecting |
@@ -143,30 +144,32 @@ void | |||
143 | GNUNET_PEERSTORE_disconnect (struct GNUNET_PEERSTORE_Handle *h, int sync_first); | 144 | GNUNET_PEERSTORE_disconnect (struct GNUNET_PEERSTORE_Handle *h, int sync_first); |
144 | 145 | ||
145 | /** | 146 | /** |
146 | * Store a new entry in the PEERSTORE | 147 | * Store a new entry in the PEERSTORE. |
148 | * Note that stored entries can be lost in some cases | ||
149 | * such as power failure. | ||
147 | * | 150 | * |
148 | * @param h Handle to the PEERSTORE service | 151 | * @param h Handle to the PEERSTORE service |
149 | * @param sub_system name of the sub system | 152 | * @param sub_system name of the sub system |
150 | * @param peer Peer Identity | 153 | * @param peer Peer Identity |
151 | * @param key entry key | 154 | * @param key entry key |
152 | * @param value entry value BLOB | 155 | * @param value entry value BLOB |
153 | * @param size size of 'value' | 156 | * @param size size of @e value |
154 | * @param expiry absolute time after which the entry is (possibly) deleted | 157 | * @param expiry absolute time after which the entry is (possibly) deleted |
155 | * @param options store operation option | 158 | * @param options options specific to the storage operation |
156 | * @param cont Continuation function after the store request is processed | 159 | * @param cont Continuation function after the store request is sent |
157 | * @param cont_cls Closure for 'cont' | 160 | * @param cont_cls Closure for 'cont' |
158 | */ | 161 | */ |
159 | struct GNUNET_PEERSTORE_StoreContext * | 162 | struct GNUNET_PEERSTORE_StoreContext * |
160 | GNUNET_PEERSTORE_store (struct GNUNET_PEERSTORE_Handle *h, | 163 | GNUNET_PEERSTORE_store (struct GNUNET_PEERSTORE_Handle *h, |
161 | const char *sub_system, | 164 | const char *sub_system, |
162 | const struct GNUNET_PeerIdentity *peer, | 165 | const struct GNUNET_PeerIdentity *peer, |
163 | const char *key, | 166 | const char *key, |
164 | const void *value, | 167 | const void *value, |
165 | size_t size, | 168 | size_t size, |
166 | struct GNUNET_TIME_Absolute expiry, | 169 | struct GNUNET_TIME_Absolute expiry, |
167 | enum GNUNET_PEERSTORE_StoreOption options, | 170 | enum GNUNET_PEERSTORE_StoreOption options, |
168 | GNUNET_PEERSTORE_Continuation cont, | 171 | GNUNET_PEERSTORE_Continuation cont, |
169 | void *cont_cls); | 172 | void *cont_cls); |
170 | 173 | ||
171 | /** | 174 | /** |
172 | * Cancel a store request | 175 | * Cancel a store request |
@@ -226,7 +229,7 @@ GNUNET_PEERSTORE_watch (struct GNUNET_PEERSTORE_Handle *h, | |||
226 | /** | 229 | /** |
227 | * Cancel a watch request | 230 | * Cancel a watch request |
228 | * | 231 | * |
229 | * @wc handle to the watch request | 232 | * @param wc handle to the watch request |
230 | */ | 233 | */ |
231 | void | 234 | void |
232 | GNUNET_PEERSTORE_watch_cancel(struct GNUNET_PEERSTORE_WatchContext *wc); | 235 | GNUNET_PEERSTORE_watch_cancel(struct GNUNET_PEERSTORE_WatchContext *wc); |