2 This file is part of GNUnet.
5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 3, or (at your
8 option) any later version.
10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA.
24 * @author Julius Bünger
27 #include "gnunet_util_lib.h"
29 #include "gnunet_rps_service.h"
32 * Handler to handle requests from a client.
34 struct GNUNET_RPS_Handle
37 * The handle to the client configuration.
39 const struct GNUNET_CONFIGURATION_Handle *cfg;
42 * The connection to the client.
44 struct GNUNET_CLIENT_Connection *conn;
47 * The message queue to the client.
49 struct GNUNET_MQ_Handle *mq;
53 * Handler to single requests from the client.
55 struct GNUNET_RPS_Request_Handle
58 * The client issuing the request.
60 struct GNUNET_RPS_Handle *h;
63 * The nuber of the request.
68 * The callback to be called when we receive an answer.
70 GNUNET_RPS_NotifyReadyCB ready_cb;
73 * The closure for the callback.
79 * Array of Request_Handles.
81 struct GNUNET_RPS_Request_Handle *req_handlers = NULL;
84 * Current length of req_handlers.
86 unsigned int req_handlers_size = 0;
89 * Struct used to pack the callback, its closure (provided by the caller)
90 * and the connection handler to the service to pass it to a callback function.
95 * Callback provided by the client
97 GNUNET_RPS_NotifyReadyCB cb;
100 * Closure provided by the client
105 * Handle to the service connection
107 struct GNUNET_CLIENT_Connection *service_conn;
112 * This function is called, when the service replies to our request.
113 * It calls the callback the caller gave us with the provided closure
114 * and disconnects afterwards.
116 * @param cls the closure
117 * @param message the message
120 handle_reply (void *cls,
121 const struct GNUNET_MessageHeader *message)
123 struct GNUNET_RPS_CS_ReplyMessage *msg;
124 //struct cb_cls_pack *pack;
125 //struct GNUNET_RPS_Handle *h;
126 struct GNUNET_PeerIdentity *peers;
127 struct GNUNET_RPS_Request_Handle *rh;
129 /* Give the peers back */
130 msg = (struct GNUNET_RPS_CS_ReplyMessage *) message;
131 //pack = (struct cb_cls_pack *) cls;
132 //h = (struct GNUNET_RPS_Handle *) cls;
133 peers = (struct GNUNET_PeerIdentity *) &msg[1];
134 rh = &req_handlers[msg->n];
135 rh->ready_cb((rh)->ready_cb_cls, msg->num_peers, peers);
138 //GNUNET_CLIENT_disconnect(pack->service_conn);
142 * Error handler for mq.
144 * This function is called whan mq encounters an error.
145 * Until now mq doesn't provide useful error messages.
147 * @param cls the closure
148 * @param error error code without specyfied meaning
151 mq_error_handler (void *cls, enum GNUNET_MQ_Error error)
157 * Connect to the rps service
159 * @param cfg configuration to use
160 * @return a handle to the service
162 struct GNUNET_RPS_Handle *
163 GNUNET_RPS_connect (const struct GNUNET_CONFIGURATION_Handle *cfg)
165 struct GNUNET_RPS_Handle *h;
166 //struct GNUNET_RPS_Request_Handle *rh;
167 static const struct GNUNET_MQ_MessageHandler mq_handlers[] = {
168 {&handle_reply, GNUNET_MESSAGE_TYPE_RPS_CS_REPLY, 0},
169 GNUNET_MQ_HANDLERS_END
172 h = GNUNET_new(struct GNUNET_RPS_Handle);
173 //h->cfg = GNUNET_new(struct GNUNET_CONFIGURATION_Handle);
175 h->cfg = cfg; // FIXME |^
176 h->conn = GNUNET_CLIENT_connect("rps", cfg);
177 h->mq = GNUNET_MQ_queue_for_connection_client(h->conn,
179 mq_error_handler, // TODO implement
187 * Request n random peers.
189 * @param h handle to the rps service
190 * @param n number of peers we want to receive
191 * @param ready_cb the callback called when the peers are available
192 * @param cls closure given to the callback
193 * @return a handle to cancel this request
195 struct GNUNET_RPS_Request_Handle *
196 GNUNET_RPS_request_peers (struct GNUNET_RPS_Handle *h, uint32_t n,
197 GNUNET_RPS_NotifyReadyCB ready_cb,
200 struct GNUNET_RPS_Request_Handle *rh;
201 struct GNUNET_MQ_Envelope *ev;
202 struct GNUNET_RPS_CS_RequestMessage *msg;
204 // assert func != NULL
205 rh = GNUNET_new (struct GNUNET_RPS_Request_Handle);
207 rh->n = req_handlers_size; // TODO ntoh
208 rh->ready_cb = ready_cb;
209 rh->ready_cb_cls = cls;
211 GNUNET_array_append (req_handlers, req_handlers_size, *rh);
212 //memcpy(&req_handlers[req_handlers_size-1], rh, sizeof(struct GNUNET_RPS_Request_Handle));
214 ev = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RPS_CS_REQUEST);
215 msg->num_peers = htonl (n);
217 GNUNET_MQ_send (h->mq, ev);
222 * Seed rps service with peerIDs.
224 * @param h handle to the rps service
225 * @param n number of peers to seed
226 * @param ids the ids of the peers seeded
229 GNUNET_RPS_seed_ids (struct GNUNET_RPS_Handle *h, uint64_t n,
230 const struct GNUNET_PeerIdentity * ids)
232 struct GNUNET_MQ_Envelope *ev;
233 struct GNUNET_RPS_CS_SeedMessage *msg;
235 ev = GNUNET_MQ_msg_extra (msg, n * sizeof (struct GNUNET_PeerIdentity),
236 GNUNET_MESSAGE_TYPE_RPS_CS_SEED);
237 msg->num_peers = GNUNET_htonll (n);
238 memcpy (&msg[1], ids, n * sizeof (struct GNUNET_PeerIdentity));
239 GNUNET_MQ_send (h->mq, ev);
243 * Cancle an issued request.
245 * @param rh request handle of request to cancle
248 GNUNET_RPS_request_cancel (struct GNUNET_RPS_Request_Handle *rh)
254 * Disconnect from the rps service
256 * @param h the handle to the rps service
259 GNUNET_RPS_disconnect (struct GNUNET_RPS_Handle *h)
261 if ( NULL != h->conn ) {
262 GNUNET_CLIENT_disconnect (h->conn);
267 /* end of rps_api.c */