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
186 * Request n random peers.
188 * @param h handle to the rps service
189 * @param n number of peers we want to receive
190 * @param ready_cb the callback called when the peers are available
191 * @param cls closure given to the callback
192 * @return a handle to cancel this request
194 struct GNUNET_RPS_Request_Handle *
195 GNUNET_RPS_request_peers (struct GNUNET_RPS_Handle *h, uint32_t n,
196 GNUNET_RPS_NotifyReadyCB ready_cb,
199 struct GNUNET_RPS_Request_Handle *rh;
200 struct GNUNET_MQ_Envelope *ev;
201 struct GNUNET_RPS_CS_RequestMessage *msg;
203 // assert func != NULL
204 rh = GNUNET_new (struct GNUNET_RPS_Request_Handle);
206 rh->n = req_handlers_size; // TODO ntoh
207 rh->ready_cb = ready_cb;
208 rh->ready_cb_cls = cls;
210 GNUNET_array_append (req_handlers, req_handlers_size, *rh);
211 //memcpy(&req_handlers[req_handlers_size-1], rh, sizeof(struct GNUNET_RPS_Request_Handle));
213 ev = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RPS_CS_REQUEST);
214 msg->num_peers = htonl (n);
216 GNUNET_MQ_send (h->mq, ev);
221 * Seed rps service with peerIDs.
223 * @param h handle to the rps service
224 * @param n number of peers to seed
225 * @param ids the ids of the peers seeded
228 GNUNET_RPS_seed_ids (struct GNUNET_RPS_Handle *h, uint64_t n,
229 const struct GNUNET_PeerIdentity * ids)
231 uint32_t size_needed;
232 uint32_t tmp_num_peers;
233 struct GNUNET_MQ_Envelope *ev;
234 struct GNUNET_RPS_CS_SeedMessage *msg;
236 size_needed = sizeof (struct GNUNET_RPS_CS_SeedMessage) +
237 n * sizeof (struct GNUNET_PeerIdentity);
239 while (GNUNET_SERVER_MAX_MESSAGE_SIZE < size_needed)
241 tmp_num_peers = (GNUNET_SERVER_MAX_MESSAGE_SIZE -
242 sizeof (struct GNUNET_RPS_CS_SeedMessage)) /
243 sizeof (struct GNUNET_PeerIdentity);
245 size_needed = sizeof (struct GNUNET_RPS_CS_SeedMessage) +
246 n * sizeof (struct GNUNET_PeerIdentity);
248 ev = GNUNET_MQ_msg_extra (msg, tmp_num_peers * sizeof (struct GNUNET_PeerIdentity),
249 GNUNET_MESSAGE_TYPE_RPS_CS_SEED);
250 msg->num_peers = GNUNET_htonll (tmp_num_peers);
251 memcpy (&msg[1], ids, tmp_num_peers * sizeof (struct GNUNET_PeerIdentity));
252 GNUNET_MQ_send (h->mq, ev);
255 ev = GNUNET_MQ_msg_extra (msg, n * sizeof (struct GNUNET_PeerIdentity),
256 GNUNET_MESSAGE_TYPE_RPS_CS_SEED);
257 msg->num_peers = GNUNET_htonll (n);
258 memcpy (&msg[1], ids, n * sizeof (struct GNUNET_PeerIdentity));
259 GNUNET_MQ_send (h->mq, ev);
264 * Cancle an issued request.
266 * @param rh request handle of request to cancle
269 GNUNET_RPS_request_cancel (struct GNUNET_RPS_Request_Handle *rh)
276 * Disconnect from the rps service
278 * @param h the handle to the rps service
281 GNUNET_RPS_disconnect (struct GNUNET_RPS_Handle *h)
283 if ( NULL != h->conn )
284 GNUNET_CLIENT_disconnect (h->conn);
288 /* end of rps_api.c */