/* This file is part of GNUnet. (C) GNUnet is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version. GNUnet is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNUnet; see the file COPYING. If not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ /** * @file rps/rps_api.c * @brief API for rps * @author Julius Bünger */ #include "platform.h" #include "gnunet_util_lib.h" #include "rps.h" #include "gnunet_rps_service.h" /** * Handler to handle requests from a client. */ struct GNUNET_RPS_Handle { /** * The handle to the client configuration. */ const struct GNUNET_CONFIGURATION_Handle *cfg; /** * The connection to the client. */ struct GNUNET_CLIENT_Connection *conn; /** * The message queue to the client. */ struct GNUNET_MQ_Handle *mq; }; /** * Handler to single requests from the client. */ struct GNUNET_RPS_Request_Handle { /** * The client issuing the request. */ struct GNUNET_RPS_Handle *h; /** * The nuber of the request. */ uint64_t n; /** * The callback to be called when we receive an answer. */ GNUNET_RPS_NotifyReadyCB ready_cb; /** * The closure for the callback. */ void *ready_cb_cls; }; /** * Array of Request_Handles. */ struct GNUNET_RPS_Request_Handle *req_handlers = NULL; /** * Current length of req_handlers. */ unsigned int req_handlers_size = 0; /** * Struct used to pack the callback, its closure (provided by the caller) * and the connection handler to the service to pass it to a callback function. */ struct cb_cls_pack { /** * Callback provided by the client */ GNUNET_RPS_NotifyReadyCB cb; /** * Closure provided by the client */ void *cls; /** * Handle to the service connection */ struct GNUNET_CLIENT_Connection *service_conn; }; /** * This function is called, when the service replies to our request. * It calls the callback the caller gave us with the provided closure * and disconnects afterwards. * * @param cls the closure * @param message the message */ static void handle_reply (void *cls, const struct GNUNET_MessageHeader *message) { struct GNUNET_RPS_CS_ReplyMessage *msg; //struct cb_cls_pack *pack; //struct GNUNET_RPS_Handle *h; struct GNUNET_PeerIdentity *peers; struct GNUNET_RPS_Request_Handle *rh; /* Give the peers back */ msg = (struct GNUNET_RPS_CS_ReplyMessage *) message; //pack = (struct cb_cls_pack *) cls; //h = (struct GNUNET_RPS_Handle *) cls; peers = (struct GNUNET_PeerIdentity *) &msg[1]; rh = &req_handlers[msg->n]; rh->ready_cb((rh)->ready_cb_cls, msg->num_peers, peers); /* Disconnect */ //GNUNET_CLIENT_disconnect(pack->service_conn); } /** * Error handler for mq. * * This function is called whan mq encounters an error. * Until now mq doesn't provide useful error messages. * * @param cls the closure * @param error error code without specyfied meaning */ static void mq_error_handler (void *cls, enum GNUNET_MQ_Error error) { //TODO LOG } /** * Connect to the rps service * * @param cfg configuration to use * @return a handle to the service */ struct GNUNET_RPS_Handle * GNUNET_RPS_connect (const struct GNUNET_CONFIGURATION_Handle *cfg) { struct GNUNET_RPS_Handle *h; //struct GNUNET_RPS_Request_Handle *rh; static const struct GNUNET_MQ_MessageHandler mq_handlers[] = { {&handle_reply, GNUNET_MESSAGE_TYPE_RPS_CS_REPLY, 0}, GNUNET_MQ_HANDLERS_END }; h = GNUNET_new(struct GNUNET_RPS_Handle); //h->cfg = GNUNET_new(struct GNUNET_CONFIGURATION_Handle); //*h->cfg = *cfg; h->cfg = cfg; // FIXME |^ h->conn = GNUNET_CLIENT_connect("rps", cfg); h->mq = GNUNET_MQ_queue_for_connection_client(h->conn, mq_handlers, mq_error_handler, // TODO implement h); return h; } /** * Request n random peers. * * @param h handle to the rps service * @param n number of peers we want to receive * @param ready_cb the callback called when the peers are available * @param cls closure given to the callback * @return a handle to cancel this request */ struct GNUNET_RPS_Request_Handle * GNUNET_RPS_request_peers (struct GNUNET_RPS_Handle *h, uint32_t n, GNUNET_RPS_NotifyReadyCB ready_cb, void *cls) { struct GNUNET_RPS_Request_Handle *rh; struct GNUNET_MQ_Envelope *ev; struct GNUNET_RPS_CS_RequestMessage *msg; // assert func != NULL rh = GNUNET_new (struct GNUNET_RPS_Request_Handle); rh->h = h; rh->n = req_handlers_size; // TODO ntoh rh->ready_cb = ready_cb; rh->ready_cb_cls = cls; GNUNET_array_append (req_handlers, req_handlers_size, *rh); //memcpy(&req_handlers[req_handlers_size-1], rh, sizeof(struct GNUNET_RPS_Request_Handle)); ev = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RPS_CS_REQUEST); msg->num_peers = htonl (n); msg->n = rh->n; GNUNET_MQ_send (h->mq, ev); return rh; } /** * Seed rps service with peerIDs. * * @param h handle to the rps service * @param n number of peers to seed * @param ids the ids of the peers seeded */ void GNUNET_RPS_seed_ids (struct GNUNET_RPS_Handle *h, uint64_t n, const struct GNUNET_PeerIdentity * ids) { uint32_t size_needed; uint32_t num_peers_max; const struct GNUNET_PeerIdentity *tmp_peer_pointer; struct GNUNET_MQ_Envelope *ev; struct GNUNET_RPS_CS_SeedMessage *msg; /* The actual size the message occupies */ size_needed = sizeof (struct GNUNET_RPS_CS_SeedMessage) + n * sizeof (struct GNUNET_PeerIdentity); /* The number of peers that fits in one message together with * the respective header */ num_peers_max = (GNUNET_SERVER_MAX_MESSAGE_SIZE - sizeof (struct GNUNET_RPS_CS_SeedMessage)) / sizeof (struct GNUNET_PeerIdentity); tmp_peer_pointer = ids; while (GNUNET_SERVER_MAX_MESSAGE_SIZE < size_needed) { ev = GNUNET_MQ_msg_extra (msg, num_peers_max * sizeof (struct GNUNET_PeerIdentity), GNUNET_MESSAGE_TYPE_RPS_CS_SEED); msg->num_peers = ntohl (num_peers_max); memcpy (&msg[1], tmp_peer_pointer, num_peers_max * sizeof (struct GNUNET_PeerIdentity)); GNUNET_MQ_send (h->mq, ev); n -= num_peers_max; size_needed = sizeof (struct GNUNET_RPS_CS_SeedMessage) + n * sizeof (struct GNUNET_PeerIdentity); /* Set pointer to beginning of next block of num_peers_max peers */ tmp_peer_pointer = &ids[num_peers_max]; } ev = GNUNET_MQ_msg_extra (msg, n * sizeof (struct GNUNET_PeerIdentity), GNUNET_MESSAGE_TYPE_RPS_CS_SEED); msg->num_peers = GNUNET_htonll (n); memcpy (&msg[1], tmp_peer_pointer, n * sizeof (struct GNUNET_PeerIdentity)); GNUNET_MQ_send (h->mq, ev); } /** * Cancle an issued request. * * @param rh request handle of request to cancle */ void GNUNET_RPS_request_cancel (struct GNUNET_RPS_Request_Handle *rh) { // TODO } /** * Disconnect from the rps service * * @param h the handle to the rps service */ void GNUNET_RPS_disconnect (struct GNUNET_RPS_Handle *h) { if ( NULL != h->conn ) GNUNET_CLIENT_disconnect (h->conn); } /* end of rps_api.c */