X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=src%2Ffs%2Fgnunet-service-fs_lc.h;h=c625edf0b16b968e956a2e222892759c48e32042;hb=20e86c5bb520dadff4354ab8a0728b914ed82e3f;hp=edc199fd88904ef14a7d33526fe6ecb0cdd2b537;hpb=143cde208ce477883102bf23f67a1d31aaa4ed11;p=oweals%2Fgnunet.git diff --git a/src/fs/gnunet-service-fs_lc.h b/src/fs/gnunet-service-fs_lc.h index edc199fd8..c625edf0b 100644 --- a/src/fs/gnunet-service-fs_lc.h +++ b/src/fs/gnunet-service-fs_lc.h @@ -20,7 +20,7 @@ /** * @file fs/gnunet-service-fs_lc.h - * @brief API to handle 'connected peers' + * @brief API to handle 'local clients' * @author Christian Grothoff */ #ifndef GNUNET_SERVICE_FS_LC_H @@ -42,15 +42,18 @@ GSF_local_client_lookup_ (struct GNUNET_SERVER_Client *client); /** * Handle START_SEARCH-message (search request from local client). + * Only responsible for creating the request entry itself and setting + * up reply callback and cancellation on client disconnect. Does NOT + * execute the actual request strategy (planning). * - * @param cls closure * @param client identification of the client * @param message the actual message + * @return pending request handle for the request, NULL on error */ -void -GSF_local_client_start_search_handler_ (void *cls, - struct GNUNET_SERVER_Client *client, - const struct GNUNET_MessageHeader *message); +struct GSF_PendingRequest * +GSF_local_client_start_search_handler_ (struct GNUNET_SERVER_Client *client, + const struct GNUNET_MessageHeader + *message); /** @@ -63,57 +66,18 @@ GSF_local_client_start_search_handler_ (void *cls, */ void GSF_local_client_transmit_ (struct GSF_LocalClient *lc, - const struct GNUNET_MessageHeader *msg); + const struct GNUNET_MessageHeader *msg); /** - * A local client disconnected from us. Tear down the local client - * record. + * A client disconnected from us. Tear down the local client record. * * @param cls unused * @param client handle of the client */ void -GSF_local_client_disconnect_handler_ (void *cls, - const struct GNUNET_SERVER_Client *client); - - - -/** - * Signature of function called on a local client - * - * @param cls closure - * @param lc local client handle - */ -typedef int (*GSF_LocalClientIterator)(void *cls, - struct GSF_LocalClient *lc); - +GSF_client_disconnect_handler_ (void *cls, struct GNUNET_SERVER_Client *client); -/** - * Register callback to invoke on local client disconnect. - * - * @param lc client to monitor - * @param it function to call on disconnect - * @param it_cls closure for it - */ -void -GSF_local_client_register_disconnect_callback_ (struct GSF_LocalClient *lc, - GSF_LocalClientIterator it, - void *it_cls); - - -/** - * Register callback to invoke on local client disconnect. - * - * @param lc client to stop monitoring - * @param it function to no longer call on disconnect - * @param it_cls closure for it - */ -void -GSF_connected_peer_unregister_disconnect_callback_ (struct GSF_ConnectedPeer *cp, - GSF_PendingRequestIterator it, - void *it_cls); - #endif /* end of gnunet-service-fs_lc.h */