aboutsummaryrefslogtreecommitdiff
path: root/src/include/gnunet_core_service.h
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2011-10-05 13:33:59 +0000
committerChristian Grothoff <christian@grothoff.org>2011-10-05 13:33:59 +0000
commit1e620c9a829531da18fa309af050c26fddd34f1f (patch)
treec6c97df2551062ee236bfd5ec35df74f1106b0dd /src/include/gnunet_core_service.h
parent0f29195adbd56ae10dea70c2951333c13e765f88 (diff)
downloadgnunet-1e620c9a829531da18fa309af050c26fddd34f1f.tar.gz
gnunet-1e620c9a829531da18fa309af050c26fddd34f1f.zip
eliminate last calls to GNUNET_CORE_peer_request_connect
Diffstat (limited to 'src/include/gnunet_core_service.h')
-rw-r--r--src/include/gnunet_core_service.h56
1 files changed, 0 insertions, 56 deletions
diff --git a/src/include/gnunet_core_service.h b/src/include/gnunet_core_service.h
index 0fcff6d6f..11514ae29 100644
--- a/src/include/gnunet_core_service.h
+++ b/src/include/gnunet_core_service.h
@@ -245,62 +245,6 @@ GNUNET_CORE_disconnect (struct GNUNET_CORE_Handle *handle);
245 245
246 246
247/** 247/**
248 * Handle for a request to the core to connect or disconnect
249 * from a particular peer. Can be used to cancel the request
250 * (before the 'cont'inuation is called).
251 */
252struct GNUNET_CORE_PeerRequestHandle;
253
254
255/**
256 * Type of function called upon completion.
257 *
258 * @param cls closure
259 * @param success GNUNET_OK on success (which for request_connect
260 * ONLY means that we transmitted the connect request to CORE,
261 * it does not mean that we are actually now connected!);
262 * GNUNET_NO on timeout,
263 * GNUNET_SYSERR if core was shut down
264 */
265typedef void (*GNUNET_CORE_ControlContinuation) (void *cls, int success);
266
267
268/**
269 * Request that the core should try to connect to a particular peer.
270 * Once the request has been transmitted to the core, the continuation
271 * function will be called. Note that this does NOT mean that a
272 * connection was successfully established -- it only means that the
273 * core will now try. Successful establishment of the connection
274 * will be signalled to the 'connects' callback argument of
275 * 'GNUNET_CORE_connect' only. If the core service does not respond
276 * to our connection attempt within the given time frame, 'cont' will
277 * be called with the TIMEOUT reason code.
278 *
279 * @param h core handle
280 * @param peer who should we connect to
281 * @param cont function to call once the request has been completed (or timed out)
282 * @param cont_cls closure for cont
283 * @return NULL on error (cont will not be called), otherwise handle for cancellation
284 */
285struct GNUNET_CORE_PeerRequestHandle *
286GNUNET_CORE_peer_request_connect (struct GNUNET_CORE_Handle *h,
287 const struct GNUNET_PeerIdentity *peer,
288 GNUNET_CORE_ControlContinuation cont,
289 void *cont_cls);
290
291
292/**
293 * Cancel a pending request to connect to a particular peer. Must not
294 * be called after the 'cont' function was invoked.
295 *
296 * @param req request handle that was returned for the original request
297 */
298void
299GNUNET_CORE_peer_request_connect_cancel (struct GNUNET_CORE_PeerRequestHandle
300 *req);
301
302
303/**
304 * Function called with perference change information about the given peer. 248 * Function called with perference change information about the given peer.
305 * 249 *
306 * @param cls closure 250 * @param cls closure