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.
22 * @file rps/gnunet-service-rps.c
23 * @brief rps service implementation
24 * @author Julius Bünger
27 #include "gnunet_util_lib.h"
28 #include "gnunet_cadet_service.h"
29 #include "gnunet_nse_service.h"
32 #include "gnunet-service-rps_sampler.h"
37 #define LOG(kind, ...) GNUNET_log(kind, __VA_ARGS__)
39 // TODO modify @brief in every file
41 // TODO check for overflows
43 // TODO align message structs
45 // (TODO api -- possibility of getting weak random peer immideately)
47 // TODO malicious peer
49 // TODO connect to friends
51 // TODO store peers somewhere
55 // hist_size_init, hist_size_max
60 static const struct GNUNET_CONFIGURATION_Handle *cfg;
65 static struct GNUNET_PeerIdentity own_identity;
68 struct GNUNET_PeerIdentity *
69 get_rand_peer_ignore_list (const struct GNUNET_PeerIdentity *peer_list, unsigned int size,
70 const struct GNUNET_PeerIdentity *ignore_list, unsigned int ignore_size);
73 /***********************************************************************
74 * Housekeeping with peers
75 ***********************************************************************/
78 * Struct used to store the context of a connected client.
83 * The message queue to communicate with the client.
85 struct GNUNET_MQ_Handle *mq;
89 * Used to keep track in what lists single peerIDs are.
93 PULL_REPLY_PENDING = 0x01,
94 IN_OTHER_GOSSIP_LIST = 0x02, // unneeded?
95 IN_OWN_SAMPLER_LIST = 0x04, // unneeded?
96 IN_OWN_GOSSIP_LIST = 0x08, // unneeded?
99 * We set this bit when we can be sure the other peer is/was live.
106 * Functions of this type can be used to be stored at a peer for later execution.
108 typedef void (* PeerOp) (void *cls, const struct GNUNET_PeerIdentity *peer);
111 * Outstanding operation on peer consisting of callback and closure
113 struct PeerOutstandingOp
128 * Struct used to keep track of other peer's status
130 * This is stored in a multipeermap.
135 * In own gossip/sampler list, in other's gossip/sampler list
140 * Message queue open to client
142 struct GNUNET_MQ_Handle *mq;
145 * Channel open to client.
147 struct GNUNET_CADET_Channel *send_channel;
150 * Channel open from client.
152 struct GNUNET_CADET_Channel *recv_channel; // unneeded?
155 * Array of outstanding operations on this peer.
157 struct PeerOutstandingOp *outstanding_ops;
160 * Number of outstanding operations.
162 unsigned int num_outstanding_ops;
163 //size_t num_outstanding_ops;
166 * Handle to the callback given to cadet_ntfy_tmt_rdy()
168 * To be canceled on shutdown.
170 struct GNUNET_CADET_TransmitHandle *is_live_task;
173 * This is pobably followed by 'statistical' data (when we first saw
174 * him, how did we get his ID, how many pushes (in a timeinterval),
179 /***********************************************************************
180 * /Housekeeping with peers
181 ***********************************************************************/
183 /***********************************************************************
185 ***********************************************************************/
188 * Set of all peers to keep track of them.
190 static struct GNUNET_CONTAINER_MultiPeerMap *peer_map;
194 * The gossiped list of peers.
196 static struct GNUNET_PeerIdentity *gossip_list;
199 * Size of the gossiped list
201 //static unsigned int gossip_list_size;
202 static uint32_t gossip_list_size;
206 * The actual size of the sampler
208 static unsigned int sampler_size;
209 //size_t sampler_size;
212 * The size of sampler we need to be able to satisfy the client's need of
215 static unsigned int sampler_size_client_need;
218 * The size of sampler we need to be able to satisfy the Brahms protocol's
219 * need of random peers.
221 * This is directly taken as the #gossip_list_size on update of the
224 * This is one minimum size the sampler grows to.
226 static unsigned int sampler_size_est_need;
230 * Percentage of total peer number in the gossip list
231 * to send random PUSHes to
236 * Percentage of total peer number in the gossip list
237 * to send random PULLs to
242 * The percentage gamma of history updates.
243 * Simply 1 - alpha - beta
248 * Identifier for the main task that runs periodically.
250 static struct GNUNET_SCHEDULER_Task *do_round_task;
253 * Time inverval the do_round task runs in.
255 static struct GNUNET_TIME_Relative round_interval;
260 * List to store peers received through pushes temporary.
262 * TODO -> multipeermap
264 static struct GNUNET_PeerIdentity *push_list;
267 * Size of the push_list;
269 static unsigned int push_list_size;
270 //size_t push_list_size;
273 * List to store peers received through pulls temporary.
275 * TODO -> multipeermap
277 static struct GNUNET_PeerIdentity *pull_list;
280 * Size of the pull_list;
282 static unsigned int pull_list_size;
283 //size_t pull_list_size;
289 static struct GNUNET_NSE_Handle *nse;
294 static struct GNUNET_CADET_Handle *cadet_handle;
300 * Only needed in the beginning to check how many of the 64 deltas
303 static unsigned int req_counter;
306 * Time of the last request we received.
308 * Used to compute the expected request rate.
310 static struct GNUNET_TIME_Absolute last_request;
313 * Size of #request_deltas.
315 #define REQUEST_DELTAS_SIZE 64
316 static unsigned int request_deltas_size = REQUEST_DELTAS_SIZE;
319 * Last 64 deltas between requests
321 static struct GNUNET_TIME_Relative request_deltas[REQUEST_DELTAS_SIZE];
324 * The prediction of the rate of requests
326 static struct GNUNET_TIME_Relative request_rate;
330 * List with the peers we sent requests to.
332 struct GNUNET_PeerIdentity *pending_pull_reply_list;
335 * Size of #pending_pull_reply_list.
337 uint32_t pending_pull_reply_list_size;
341 * Number of history update tasks.
343 uint32_t num_hist_update_tasks;
346 /***********************************************************************
348 ***********************************************************************/
351 /***********************************************************************
353 ***********************************************************************/
356 * Check if peer is already in peer array.
359 in_arr (const struct GNUNET_PeerIdentity *array,
360 unsigned int arr_size,
361 const struct GNUNET_PeerIdentity *peer)
363 GNUNET_assert (NULL != peer);
368 GNUNET_assert (NULL != array);
373 while (0 != GNUNET_CRYPTO_cmp_peer_identity (&array[i], peer) &&
384 * Remove peer from list.
387 rem_from_list (struct GNUNET_PeerIdentity *peer_list,
388 unsigned int *list_size,
389 const struct GNUNET_PeerIdentity *peer)
393 for ( i = 0 ; i < *list_size ; i++ )
395 if (0 == GNUNET_CRYPTO_cmp_peer_identity (&peer_list[i], peer))
397 if (i < *list_size -1)
398 { /* Not at the last entry -- shift peers left */
399 memcpy (&peer_list[i], &peer_list[i +1],
400 (*list_size - i -1) * sizeof (struct GNUNET_PeerIdentity));
402 /* Remove last entry (should be now useless PeerID) */
403 GNUNET_array_grow (peer_list, *list_size, *list_size -1);
409 * Get random peer from the given list but don't return one from the @a ignore_list.
411 struct GNUNET_PeerIdentity *
412 get_rand_peer_ignore_list (const struct GNUNET_PeerIdentity *peer_list,
414 const struct GNUNET_PeerIdentity *ignore_list,
415 uint32_t ignore_size)
419 struct GNUNET_PeerIdentity *tmp_peer_list;
420 struct GNUNET_PeerIdentity *peer;
422 GNUNET_assert (NULL != peer_list);
425 tmp_peer_list = NULL;
426 GNUNET_array_grow (tmp_peer_list, tmp_size, list_size);
427 memcpy (tmp_peer_list, peer_list, list_size * sizeof (struct GNUNET_PeerIdentity));
428 peer = GNUNET_new (struct GNUNET_PeerIdentity);
433 * Choose the r_index of the peer we want to return
434 * at random from the interval of the gossip list
436 r_index = GNUNET_CRYPTO_random_u64 (GNUNET_CRYPTO_QUALITY_STRONG,
439 *peer = tmp_peer_list[r_index];
440 if (in_arr (tmp_peer_list, list_size, peer))
442 rem_from_list (tmp_peer_list, &tmp_size, peer);
448 } while (NULL == peer);
450 GNUNET_free (tmp_peer_list);
457 * Get the context of a peer. If not existing, create.
460 get_peer_ctx (struct GNUNET_CONTAINER_MultiPeerMap *peer_map,
461 const struct GNUNET_PeerIdentity *peer)
463 struct PeerContext *ctx;
465 if ( GNUNET_YES == GNUNET_CONTAINER_multipeermap_contains (peer_map, peer))
467 ctx = GNUNET_CONTAINER_multipeermap_get (peer_map, peer);
471 ctx = GNUNET_new (struct PeerContext);
474 ctx->send_channel = NULL;
475 ctx->recv_channel = NULL;
476 ctx->outstanding_ops = NULL;
477 ctx->num_outstanding_ops = 0;
478 (void) GNUNET_CONTAINER_multipeermap_put (peer_map, peer, ctx,
479 GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST);
486 * Put random peer from sampler into the gossip list as history update.
489 hist_update (void *cls, struct GNUNET_PeerIdentity *ids, uint32_t num_peers)
491 GNUNET_assert (1 == num_peers);
493 if (gossip_list_size < sampler_size_est_need)
494 GNUNET_array_append (gossip_list, gossip_list_size, *ids);
496 if (0 < num_hist_update_tasks)
497 num_hist_update_tasks--;
502 * Callback that is called when a channel was effectively established.
503 * This is given to ntfy_tmt_rdy and called when the channel was
504 * successfully established.
507 peer_is_live (void *cls, size_t size, void *buf)
509 struct GNUNET_PeerIdentity *peer;
510 struct PeerContext *peer_ctx;
514 peer = (struct GNUNET_PeerIdentity *) cls;
515 peer_ctx = get_peer_ctx (peer_map, peer);
516 peer_ctx->peer_flags |= LIVING;
518 LOG (GNUNET_ERROR_TYPE_DEBUG, "Peer %s is live\n", GNUNET_i2s (peer));
520 if (0 != peer_ctx->num_outstanding_ops)
521 { /* Call outstanding operations */
524 for ( i = 0 ; i < peer_ctx->num_outstanding_ops ; i++ )
525 peer_ctx->outstanding_ops[i].op (peer_ctx->outstanding_ops[i].op_cls, peer);
526 GNUNET_array_grow (peer_ctx->outstanding_ops, peer_ctx->num_outstanding_ops, 0);
531 //if (NULL != peer_ctx->is_live_task)
533 // GNUNET_CADET_notify_transmit_ready_cancel (peer_ctx->is_live_task);
534 // peer_ctx->is_live_task = NULL; // needed?
541 * Get the channel of a peer. If not existing, create.
543 struct GNUNET_CADET_Channel *
544 get_channel (struct GNUNET_CONTAINER_MultiPeerMap *peer_map,
545 const struct GNUNET_PeerIdentity *peer)
547 struct PeerContext *ctx;
548 struct GNUNET_PeerIdentity *tmp_peer;
550 ctx = get_peer_ctx (peer_map, peer);
551 if (NULL == ctx->send_channel)
553 ctx->send_channel = GNUNET_CADET_channel_create (cadet_handle, NULL, peer,
554 GNUNET_RPS_CADET_PORT,
555 GNUNET_CADET_OPTION_RELIABLE);
557 if (NULL == ctx->recv_channel)
559 tmp_peer = GNUNET_new (struct GNUNET_PeerIdentity);
561 ctx->is_live_task = GNUNET_CADET_notify_transmit_ready (ctx->send_channel, GNUNET_NO,
562 GNUNET_TIME_UNIT_FOREVER_REL,
563 0, peer_is_live, tmp_peer);
566 // do I have to explicitly put it in the peer_map?
567 (void) GNUNET_CONTAINER_multipeermap_put (peer_map, peer, ctx,
568 GNUNET_CONTAINER_MULTIHASHMAPOPTION_REPLACE);
570 return ctx->send_channel;
575 * Get the message queue of a specific peer.
577 * If we already have a message queue open to this client,
578 * simply return it, otherways create one.
580 struct GNUNET_MQ_Handle *
581 get_mq (struct GNUNET_CONTAINER_MultiPeerMap *peer_map,
582 const struct GNUNET_PeerIdentity *peer_id)
584 struct PeerContext *ctx;
586 ctx = get_peer_ctx (peer_map, peer_id);
589 (void) get_channel (peer_map, peer_id);
590 ctx->mq = GNUNET_CADET_mq_create (ctx->send_channel);
591 //do I have to explicitly put it in the peer_map?
592 (void) GNUNET_CONTAINER_multipeermap_put (peer_map, peer_id, ctx,
593 GNUNET_CONTAINER_MULTIHASHMAPOPTION_REPLACE);
600 * Sum all time relatives of an array.
602 struct GNUNET_TIME_Relative
603 T_relative_sum (const struct GNUNET_TIME_Relative *rel_array, uint32_t arr_size)
605 struct GNUNET_TIME_Relative sum;
608 sum = GNUNET_TIME_UNIT_ZERO;
609 for ( i = 0 ; i < arr_size ; i++ )
611 sum = GNUNET_TIME_relative_add (sum, rel_array[i]);
618 * Compute the average of given time relatives.
620 struct GNUNET_TIME_Relative
621 T_relative_avg (const struct GNUNET_TIME_Relative *rel_array, uint32_t arr_size)
623 return GNUNET_TIME_relative_divide (T_relative_sum (rel_array, arr_size), arr_size);
628 * Insert PeerID in #pull_list
630 * Called once we know a peer is live.
633 insert_in_pull_list (void *cls, const struct GNUNET_PeerIdentity *peer)
635 if (GNUNET_NO == in_arr (pull_list, pull_list_size, peer))
636 GNUNET_array_append (pull_list, pull_list_size, *peer);
640 * Check whether #insert_in_pull_list was already scheduled
643 insert_in_pull_list_scheduled (const struct PeerContext *peer_ctx)
647 for ( i = 0 ; i < peer_ctx->num_outstanding_ops ; i++ )
648 if (insert_in_pull_list == peer_ctx->outstanding_ops[i].op)
655 * Insert PeerID in #gossip_list
657 * Called once we know a peer is live.
660 insert_in_gossip_list (void *cls, const struct GNUNET_PeerIdentity *peer)
662 if (GNUNET_NO == in_arr (gossip_list, gossip_list_size, peer))
663 GNUNET_array_append (gossip_list, gossip_list_size, *peer);
667 * Check whether #insert_in_pull_list was already scheduled
670 insert_in_gossip_list_scheduled (const struct PeerContext *peer_ctx)
674 for ( i = 0 ; i < peer_ctx->num_outstanding_ops ; i++ )
675 if (insert_in_gossip_list == peer_ctx->outstanding_ops[i].op)
682 * Update sampler with given PeerID.
685 insert_in_sampler (void *cls, const struct GNUNET_PeerIdentity *peer)
687 RPS_sampler_update_list (peer);
692 * Check whether #insert_in_sampler was already scheduled
695 insert_in_sampler_scheduled (const struct PeerContext *peer_ctx)
699 for ( i = 0 ; i < peer_ctx->num_outstanding_ops ; i++ )
700 if (insert_in_sampler== peer_ctx->outstanding_ops[i].op)
707 * Wrapper around #RPS_sampler_resize()
712 uint32_t bigger_size;
716 if (sampler_size_est_need > sampler_size_client_need)
717 bigger_size = sampler_size_client_need;
719 bigger_size = sampler_size_est_need;
721 // TODO respect the min, max
722 if (sampler_size > bigger_size*4)
724 RPS_sampler_resize (sampler_size/2);
726 else if (sampler_size < bigger_size)
728 RPS_sampler_resize (sampler_size*2);
734 * Estimate request rate
736 * Called every time we receive a request from the client.
741 struct GNUNET_TIME_Relative max_round_duration;
743 if (request_deltas_size > req_counter)
745 if ( 1 < req_counter)
747 /* Shift last request deltas to the right */
748 memcpy (&request_deltas[1],
750 (req_counter - 1) * sizeof (struct GNUNET_TIME_Relative));
752 /* Add current delta to beginning */
754 GNUNET_TIME_absolute_get_difference (last_request,
755 GNUNET_TIME_absolute_get ());
756 request_rate = T_relative_avg (request_deltas, req_counter);
758 /* Compute the duration a round will maximally take */
760 GNUNET_TIME_relative_add (round_interval,
761 GNUNET_TIME_relative_divide (round_interval, 2));
763 /* Set the estimated size the sampler has to have to
764 * satisfy the current client request rate */
765 sampler_size_client_need =
766 max_round_duration.rel_value_us / request_rate.rel_value_us;
768 /* Resize the sampler */
771 last_request = GNUNET_TIME_absolute_get ();
775 /***********************************************************************
777 ***********************************************************************/
780 * Function called by NSE.
782 * Updates sizes of sampler list and gossip list and adapt those lists
786 nse_callback (void *cls, struct GNUNET_TIME_Absolute timestamp,
787 double logestimate, double std_dev)
790 //double scale; // TODO this might go gloabal/config
792 LOG (GNUNET_ERROR_TYPE_DEBUG,
793 "Received a ns estimate - logest: %f, std_dev: %f (old_size: %f)\n",
794 logestimate, std_dev, sampler_size);
796 estimate = GNUNET_NSE_log_estimate_to_n (logestimate);
797 // GNUNET_NSE_log_estimate_to_n (logestimate);
798 estimate = pow (estimate, 1.0 / 3);
799 // TODO add if std_dev is a number
800 // estimate += (std_dev * scale);
801 if ( 0 < estimate ) {
802 LOG (GNUNET_ERROR_TYPE_DEBUG, "Changing estimate to %f\n", estimate);
803 sampler_size_est_need = estimate;
805 LOG (GNUNET_ERROR_TYPE_DEBUG, "Not using estimate %f\n", estimate);
807 /* If the NSE has changed adapt the lists accordingly */
813 * Callback called once the requested PeerIDs are ready.
815 * Sends those to the requesting client.
817 void client_respond (void *cls,
818 struct GNUNET_PeerIdentity *ids, uint32_t num_peers)
820 LOG (GNUNET_ERROR_TYPE_DEBUG, "sampler returned %" PRIX32 " peers\n", num_peers);
821 struct GNUNET_MQ_Envelope *ev;
822 struct GNUNET_RPS_CS_ReplyMessage *out_msg;
823 struct GNUNET_SERVER_Client *client;
824 uint32_t size_needed;
825 struct client_ctx *cli_ctx;
827 client = (struct GNUNET_SERVER_Client *) cls;
829 size_needed = sizeof (struct GNUNET_RPS_CS_ReplyMessage) +
830 num_peers * sizeof (struct GNUNET_PeerIdentity);
832 GNUNET_assert (GNUNET_SERVER_MAX_MESSAGE_SIZE >= size_needed);
834 ev = GNUNET_MQ_msg_extra (out_msg,
835 num_peers * sizeof (struct GNUNET_PeerIdentity),
836 GNUNET_MESSAGE_TYPE_RPS_CS_REPLY);
837 out_msg->num_peers = htonl (num_peers);
841 num_peers * sizeof (struct GNUNET_PeerIdentity));
844 cli_ctx = GNUNET_SERVER_client_get_user_context (client, struct client_ctx);
845 if ( NULL == cli_ctx ) {
846 cli_ctx = GNUNET_new (struct client_ctx);
847 cli_ctx->mq = GNUNET_MQ_queue_for_server_client (client);
848 GNUNET_SERVER_client_set_user_context (client, cli_ctx);
851 GNUNET_MQ_send (cli_ctx->mq, ev);
856 * Handle RPS request from the client.
859 * @param client identification of the client
860 * @param message the actual message
863 handle_client_request (void *cls,
864 struct GNUNET_SERVER_Client *client,
865 const struct GNUNET_MessageHeader *message)
867 struct GNUNET_RPS_CS_RequestMessage *msg;
869 uint32_t size_needed;
872 msg = (struct GNUNET_RPS_CS_RequestMessage *) message;
874 num_peers = ntohl (msg->num_peers);
875 size_needed = sizeof (struct GNUNET_RPS_CS_ReplyMessage) +
876 num_peers * sizeof (struct GNUNET_PeerIdentity);
878 if (GNUNET_SERVER_MAX_MESSAGE_SIZE < size_needed)
880 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
884 for (i = 0 ; i < num_peers ; i++)
887 LOG (GNUNET_ERROR_TYPE_DEBUG, "Client requested %" PRIX32 " random peer(s).\n", num_peers);
889 RPS_sampler_get_n_rand_peers (client_respond, client, num_peers, GNUNET_YES);
891 GNUNET_SERVER_receive_done (client,
897 * Handle seed from the client.
900 * @param client identification of the client
901 * @param message the actual message
904 handle_client_seed (void *cls,
905 struct GNUNET_SERVER_Client *client,
906 const struct GNUNET_MessageHeader *message)
908 struct GNUNET_RPS_CS_SeedMessage *in_msg;
909 struct GNUNET_PeerIdentity *peers;
912 if (sizeof (struct GNUNET_RPS_CS_SeedMessage) < ntohs (message->size))
915 GNUNET_SERVER_receive_done (client,
918 in_msg = (struct GNUNET_RPS_CS_SeedMessage *) message;
919 if ((ntohs (message->size) - sizeof (struct GNUNET_RPS_CS_SeedMessage)) /
920 sizeof (struct GNUNET_PeerIdentity) != ntohl (in_msg->num_peers))
923 GNUNET_SERVER_receive_done (client,
927 in_msg = (struct GNUNET_RPS_CS_SeedMessage *) message;
928 peers = (struct GNUNET_PeerIdentity *) &message[1];
930 for ( i = 0 ; i < ntohl (in_msg->num_peers) ; i++ )
931 RPS_sampler_update_list (&peers[i]);
933 GNUNET_SERVER_receive_done (client,
939 * Handle a PUSH message from another peer.
941 * Check the proof of work and store the PeerID
942 * in the temporary list for pushed PeerIDs.
945 * @param channel The channel the PUSH was received over
946 * @param channel_ctx The context associated with this channel
947 * @param msg The message header
950 handle_peer_push (void *cls,
951 struct GNUNET_CADET_Channel *channel,
953 const struct GNUNET_MessageHeader *msg)
955 const struct GNUNET_PeerIdentity *peer;
957 // (check the proof of work)
959 peer = (const struct GNUNET_PeerIdentity *) GNUNET_CADET_channel_get_info (channel, GNUNET_CADET_OPTION_PEER);
960 // FIXME wait for cadet to change this function
961 LOG (GNUNET_ERROR_TYPE_DEBUG, "PUSH received (%s)\n", GNUNET_i2s (peer));
963 /* Add the sending peer to the push_list */
964 if (GNUNET_NO == in_arr (push_list, pull_list_size, peer))
965 GNUNET_array_append (push_list, push_list_size, *peer);
971 * Handle PULL REQUEST request message from another peer.
973 * Reply with the gossip list of PeerIDs.
976 * @param channel The channel the PUSH was received over
977 * @param channel_ctx The context associated with this channel
978 * @param msg The message header
981 handle_peer_pull_request (void *cls,
982 struct GNUNET_CADET_Channel *channel,
984 const struct GNUNET_MessageHeader *msg)
986 struct GNUNET_PeerIdentity *peer;
988 struct GNUNET_MQ_Handle *mq;
989 struct GNUNET_MQ_Envelope *ev;
990 struct GNUNET_RPS_P2P_PullReplyMessage *out_msg;
993 peer = (struct GNUNET_PeerIdentity *) GNUNET_CADET_channel_get_info (channel,
994 GNUNET_CADET_OPTION_PEER);
995 // FIXME wait for cadet to change this function
997 /* Compute actual size */
998 send_size = sizeof (struct GNUNET_RPS_P2P_PullReplyMessage) +
999 gossip_list_size * sizeof (struct GNUNET_PeerIdentity);
1001 if (GNUNET_CONSTANTS_MAX_CADET_MESSAGE_SIZE < send_size)
1002 /* Compute number of peers to send
1003 * If too long, simply truncate */
1004 send_size = (GNUNET_CONSTANTS_MAX_CADET_MESSAGE_SIZE -
1005 sizeof (struct GNUNET_RPS_P2P_PullReplyMessage)) /
1006 sizeof (struct GNUNET_PeerIdentity);
1008 send_size = gossip_list_size;
1010 LOG (GNUNET_ERROR_TYPE_DEBUG,
1011 "PULL REQUEST from peer %s received, going to send %u peers\n",
1012 GNUNET_i2s (peer), send_size);
1014 mq = get_mq (peer_map, peer);
1016 ev = GNUNET_MQ_msg_extra (out_msg,
1017 send_size * sizeof (struct GNUNET_PeerIdentity),
1018 GNUNET_MESSAGE_TYPE_RPS_PP_PULL_REPLY);
1019 //out_msg->num_peers = htonl (gossip_list_size);
1020 out_msg->num_peers = htonl (send_size);
1021 memcpy (&out_msg[1], gossip_list,
1022 send_size * sizeof (struct GNUNET_PeerIdentity));
1024 GNUNET_MQ_send (mq, ev);
1030 * Handle PULL REPLY message from another peer.
1032 * Check whether we sent a corresponding request and
1033 * whether this reply is the first one.
1035 * @param cls Closure
1036 * @param channel The channel the PUSH was received over
1037 * @param channel_ctx The context associated with this channel
1038 * @param msg The message header
1041 handle_peer_pull_reply (void *cls,
1042 struct GNUNET_CADET_Channel *channel,
1044 const struct GNUNET_MessageHeader *msg)
1046 LOG (GNUNET_ERROR_TYPE_DEBUG, "PULL REPLY received\n");
1048 struct GNUNET_RPS_P2P_PullReplyMessage *in_msg;
1049 struct GNUNET_PeerIdentity *peers;
1050 struct PeerContext *peer_ctx;
1051 struct GNUNET_PeerIdentity *sender;
1052 struct PeerContext *sender_ctx;
1053 struct PeerOutstandingOp out_op;
1056 if (sizeof (struct GNUNET_RPS_P2P_PullReplyMessage) > ntohs (msg->size))
1058 GNUNET_break_op (0); // At the moment our own implementation seems to break that.
1059 return GNUNET_SYSERR;
1061 in_msg = (struct GNUNET_RPS_P2P_PullReplyMessage *) msg;
1062 if ((ntohs (msg->size) - sizeof (struct GNUNET_RPS_P2P_PullReplyMessage)) / sizeof (struct GNUNET_PeerIdentity) != ntohl (in_msg->num_peers))
1064 LOG (GNUNET_ERROR_TYPE_ERROR, "message says it sends %" PRIu64 " peers, have space for %i peers\n",
1065 ntohl (in_msg->num_peers),
1066 (ntohs (msg->size) - sizeof (struct GNUNET_RPS_P2P_PullReplyMessage)) / sizeof (struct GNUNET_PeerIdentity));
1067 GNUNET_break_op (0);
1068 return GNUNET_SYSERR;
1071 sender = (struct GNUNET_PeerIdentity *) GNUNET_CADET_channel_get_info (
1072 (struct GNUNET_CADET_Channel *) channel, GNUNET_CADET_OPTION_PEER);
1073 // Guess simply casting isn't the nicest way...
1074 // FIXME wait for cadet to change this function
1075 sender_ctx = get_peer_ctx (peer_map, sender);
1077 if (0 == (peer_ctx->peer_flags || PULL_REPLY_PENDING))
1079 GNUNET_break_op (0);
1083 peers = (struct GNUNET_PeerIdentity *) &msg[1];
1084 for ( i = 0 ; i < ntohl (in_msg->num_peers) ; i++ )
1086 peer_ctx = get_peer_ctx (peer_map, &peers[i]);
1087 if ((0 != (peer_ctx->peer_flags && LIVING)) ||
1088 NULL != peer_ctx->recv_channel)
1090 if (GNUNET_NO == in_arr (pull_list, pull_list_size, &peers[i]))
1091 GNUNET_array_append (pull_list, pull_list_size, peers[i]);
1093 else if (GNUNET_NO == insert_in_pull_list_scheduled (peer_ctx))
1095 out_op.op = insert_in_pull_list;
1096 GNUNET_array_append (peer_ctx->outstanding_ops, peer_ctx->num_outstanding_ops, out_op);
1100 sender_ctx->peer_flags &= (~PULL_REPLY_PENDING);
1101 rem_from_list (pending_pull_reply_list, &pending_pull_reply_list_size, sender);
1108 * Send out PUSHes and PULLs.
1110 * This is executed regylary.
1113 do_round (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1115 LOG (GNUNET_ERROR_TYPE_DEBUG, "Going to execute next round\n");
1118 unsigned int *permut;
1119 unsigned int n_peers; /* Number of peers we send pushes/pulls to */
1120 struct GNUNET_MQ_Envelope *ev;
1121 const struct GNUNET_PeerIdentity *peer;
1122 struct GNUNET_MQ_Handle *mq;
1124 // TODO log lists, ...
1127 /* Would it make sense to have one shuffeled gossip list and then
1128 * to send PUSHes to first alpha peers, PULL requests to next beta peers and
1129 * use the rest to update sampler?
1130 * in essence get random peers with consumption */
1133 if (0 < gossip_list_size)
1135 permut = GNUNET_CRYPTO_random_permute (GNUNET_CRYPTO_QUALITY_STRONG,
1136 (unsigned int) gossip_list_size);
1137 if (0 != gossip_list_size)
1139 n_peers = round (alpha * gossip_list_size);
1142 LOG (GNUNET_ERROR_TYPE_DEBUG, "Going to send pushes to %u (%f * %u) peers.\n",
1143 n_peers, alpha, gossip_list_size);
1144 for ( i = 0 ; i < n_peers ; i++ )
1146 peer = &gossip_list[permut[i]];
1147 if (0 != GNUNET_CRYPTO_cmp_peer_identity (&own_identity, peer)) // TODO
1148 { // FIXME if this fails schedule/loop this for later
1149 LOG (GNUNET_ERROR_TYPE_DEBUG, "Sending PUSH to peer %s of gossiped list.\n", GNUNET_i2s (peer));
1151 ev = GNUNET_MQ_msg_header (GNUNET_MESSAGE_TYPE_RPS_PP_PUSH);
1152 mq = get_mq (peer_map, peer);
1153 GNUNET_MQ_send (mq, ev);
1160 /* Send PULL requests */
1161 //permut = GNUNET_CRYPTO_random_permute (GNUNET_CRYPTO_QUALITY_STRONG, (unsigned int) sampler_list->size);
1162 if (0 != gossip_list_size)
1164 n_peers = round (beta * gossip_list_size);
1167 LOG (GNUNET_ERROR_TYPE_DEBUG, "Going to send pulls to %u (%f * %u) peers.\n",
1168 n_peers, beta, gossip_list_size);
1169 for ( i = 0 ; i < n_peers ; i++ )
1171 peer = get_rand_peer_ignore_list (gossip_list, gossip_list_size,
1172 pending_pull_reply_list, pending_pull_reply_list_size);
1175 GNUNET_array_append (pending_pull_reply_list, pending_pull_reply_list_size, *peer);
1177 if (0 != GNUNET_CRYPTO_cmp_peer_identity (&own_identity, peer))
1178 { // FIXME if this fails schedule/loop this for later
1179 LOG (GNUNET_ERROR_TYPE_DEBUG, "Sending PULL request to peer %s of gossiped list.\n", GNUNET_i2s (peer));
1181 ev = GNUNET_MQ_msg_header (GNUNET_MESSAGE_TYPE_RPS_PP_PULL_REQUEST);
1183 mq = get_mq (peer_map, peer);
1184 GNUNET_MQ_send (mq, ev);
1191 /* Update gossip list */
1194 if ( push_list_size <= alpha * gossip_list_size &&
1195 push_list_size != 0 &&
1196 pull_list_size != 0 )
1198 LOG (GNUNET_ERROR_TYPE_DEBUG, "Update of the gossip list.\n");
1200 uint32_t first_border;
1201 uint32_t second_border;
1203 first_border = round (alpha * sampler_size_est_need);
1204 second_border = first_border + round (beta * sampler_size_est_need);
1206 GNUNET_array_grow (gossip_list, gossip_list_size, second_border);
1208 for ( i = 0 ; i < first_border ; i++ )
1209 { // TODO use RPS_sampler_get_n_rand_peers
1210 /* Update gossip list with peers received through PUSHes */
1211 r_index = GNUNET_CRYPTO_random_u64 (GNUNET_CRYPTO_QUALITY_STRONG,
1213 gossip_list[i] = push_list[r_index];
1214 // TODO change the peer_flags accordingly
1217 for ( i = first_border ; i < second_border ; i++ )
1219 /* Update gossip list with peers received through PULLs */
1220 r_index = GNUNET_CRYPTO_random_u64 (GNUNET_CRYPTO_QUALITY_STRONG,
1222 gossip_list[i] = pull_list[r_index];
1223 // TODO change the peer_flags accordingly
1226 for ( i = second_border ; i < gossip_list_size ; i++ )
1228 /* Update gossip list with peers from history */
1229 RPS_sampler_get_n_rand_peers (hist_update, NULL, 1, GNUNET_NO);
1230 num_hist_update_tasks++;
1231 // TODO change the peer_flags accordingly
1237 LOG (GNUNET_ERROR_TYPE_DEBUG, "No update of the gossip list. ()\n");
1239 // TODO independent of that also get some peers from CADET_get_peers()?
1242 /* Update samplers */
1244 for ( i = 0 ; i < push_list_size ; i++ )
1246 RPS_sampler_update_list (&push_list[i]);
1247 // TODO set in_flag?
1250 for ( i = 0 ; i < pull_list_size ; i++ )
1252 RPS_sampler_update_list (&pull_list[i]);
1253 // TODO set in_flag?
1257 /* Empty push/pull lists */
1258 GNUNET_array_grow (push_list, push_list_size, 0);
1259 GNUNET_array_grow (pull_list, pull_list_size, 0);
1261 struct GNUNET_TIME_Relative time_next_round;
1262 struct GNUNET_TIME_Relative half_round_interval;
1263 unsigned int rand_delay;
1265 /* Compute random time value between .5 * round_interval and 1.5 *round_interval */
1266 half_round_interval = GNUNET_TIME_relative_divide (round_interval, 2);
1270 * Compute random value between (0 and 1) * round_interval
1271 * via multiplying round_interval with a 'fraction' (0 to value)/value
1273 rand_delay = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK, UINT_MAX/10);
1274 time_next_round = GNUNET_TIME_relative_multiply (round_interval, rand_delay);
1275 time_next_round = GNUNET_TIME_relative_divide (time_next_round, UINT_MAX/10);
1276 time_next_round = GNUNET_TIME_relative_add (time_next_round, half_round_interval);
1277 } while (GNUNET_TIME_UNIT_FOREVER_REL.rel_value_us == time_next_round.rel_value_us);
1279 /* Schedule next round */
1280 do_round_task = GNUNET_SCHEDULER_add_delayed (round_interval, &do_round, NULL);
1281 LOG (GNUNET_ERROR_TYPE_DEBUG, "Finished round\n");
1286 * Open a connection to given peer and store channel and mq.
1289 insertCB (void *cls, const struct GNUNET_PeerIdentity *id)
1291 // We open a channel to be notified when this peer goes down.
1292 (void) get_channel (peer_map, id);
1297 * Close the connection to given peer and delete channel and mq.
1300 removeCB (void *cls, const struct GNUNET_PeerIdentity *id)
1303 struct PeerContext *ctx;
1305 s = RPS_sampler_count_id (id);
1308 if (GNUNET_YES == GNUNET_CONTAINER_multipeermap_contains (peer_map, id))
1310 ctx = GNUNET_CONTAINER_multipeermap_get (peer_map, id);
1311 if (NULL != ctx->send_channel)
1313 if (NULL != ctx->mq)
1315 GNUNET_MQ_destroy (ctx->mq);
1317 // may already be freed at shutdown of cadet
1318 //GNUNET_CADET_channel_destroy (ctx->send_channel);
1320 // TODO cleanup peer
1321 (void) GNUNET_CONTAINER_multipeermap_remove_all (peer_map, id);
1327 rps_start (struct GNUNET_SERVER_Handle *server);
1330 * This is called from GNUNET_CADET_get_peers().
1332 * It is called on every peer(ID) that cadet somehow has contact with.
1333 * We use those to initialise the sampler.
1336 init_peer_cb (void *cls,
1337 const struct GNUNET_PeerIdentity *peer,
1338 int tunnel, // "Do we have a tunnel towards this peer?"
1339 unsigned int n_paths, // "Number of known paths towards this peer"
1340 unsigned int best_path) // "How long is the best path?
1341 // (0 = unknown, 1 = ourselves, 2 = neighbor)"
1343 struct GNUNET_SERVER_Handle *server;
1344 struct PeerOutstandingOp out_op;
1345 struct PeerContext *peer_ctx;
1347 server = (struct GNUNET_SERVER_Handle *) cls;
1350 LOG (GNUNET_ERROR_TYPE_DEBUG,
1351 "Got peer %s (at %p) from CADET (gossip_list_size: %u)\n",
1352 GNUNET_i2s (peer), peer, gossip_list_size);
1354 // maybe create a function for that
1355 peer_ctx = get_peer_ctx (peer_map, peer);
1356 if (GNUNET_NO == insert_in_sampler_scheduled (peer_ctx))
1358 out_op.op = insert_in_sampler;
1359 GNUNET_array_append (peer_ctx->outstanding_ops, peer_ctx->num_outstanding_ops, out_op);
1362 if (GNUNET_NO == insert_in_gossip_list_scheduled (peer_ctx))
1364 out_op.op = insert_in_gossip_list;
1365 GNUNET_array_append (peer_ctx->outstanding_ops, peer_ctx->num_outstanding_ops, out_op);
1368 /* Issue livelyness test on peer */
1369 (void) get_channel (peer_map, peer);
1371 // send push/pull to each of those peers?
1379 * Callback used to clean the multipeermap.
1382 peer_remove_cb (void *cls, const struct GNUNET_PeerIdentity *key, void *value)
1384 struct PeerContext *peer_ctx;
1386 peer_ctx = (struct PeerContext *) value;
1388 if ( NULL != peer_ctx->mq)
1389 GNUNET_MQ_destroy (peer_ctx->mq);
1391 if ( NULL != peer_ctx->is_live_task)
1393 GNUNET_CADET_notify_transmit_ready_cancel (peer_ctx->is_live_task);
1394 peer_ctx->is_live_task = NULL;
1397 if ( NULL != peer_ctx->send_channel)
1398 GNUNET_CADET_channel_destroy (peer_ctx->send_channel);
1400 if ( NULL != peer_ctx->recv_channel)
1401 GNUNET_CADET_channel_destroy (peer_ctx->recv_channel);
1403 if (GNUNET_NO == GNUNET_CONTAINER_multipeermap_remove_all (peer_map, key))
1404 LOG (GNUNET_ERROR_TYPE_WARNING, "removing peer from peer_map failed\n");
1411 * Task run during shutdown.
1417 shutdown_task (void *cls,
1418 const struct GNUNET_SCHEDULER_TaskContext *tc)
1420 LOG (GNUNET_ERROR_TYPE_DEBUG, "RPS is going down\n");
1422 if ( NULL != do_round_task )
1424 GNUNET_SCHEDULER_cancel (do_round_task);
1425 do_round_task = NULL;
1429 if (GNUNET_SYSERR == GNUNET_CONTAINER_multipeermap_iterate (peer_map, peer_remove_cb, NULL))
1430 LOG (GNUNET_ERROR_TYPE_WARNING,
1431 "Iterating over peers to disconnect from them was cancelled\n");
1433 GNUNET_CONTAINER_multipeermap_destroy (peer_map);
1435 GNUNET_NSE_disconnect (nse);
1436 GNUNET_CADET_disconnect (cadet_handle);
1437 RPS_sampler_destroy ();
1438 GNUNET_array_grow (request_deltas, request_deltas_size, 0);
1439 GNUNET_array_grow (gossip_list, gossip_list_size, 0);
1440 GNUNET_array_grow (push_list, push_list_size, 0);
1441 GNUNET_array_grow (pull_list, pull_list_size, 0);
1446 * A client disconnected. Remove all of its data structure entries.
1448 * @param cls closure, NULL
1449 * @param client identification of the client
1452 handle_client_disconnect (void *cls,
1453 struct GNUNET_SERVER_Client * client)
1459 * Handle the channel a peer opens to us.
1461 * @param cls The closure
1462 * @param channel The channel the peer wants to establish
1463 * @param initiator The peer's peer ID
1464 * @param port The port the channel is being established over
1465 * @param options Further options
1468 handle_inbound_channel (void *cls,
1469 struct GNUNET_CADET_Channel *channel,
1470 const struct GNUNET_PeerIdentity *initiator,
1472 enum GNUNET_CADET_ChannelOption options)
1474 struct PeerContext *ctx;
1476 LOG (GNUNET_ERROR_TYPE_DEBUG,
1477 "New channel was established to us (Peer %s).\n",
1478 GNUNET_i2s (initiator));
1480 GNUNET_assert (NULL != channel);
1482 // we might not even store the recv_channel
1484 ctx = get_peer_ctx (peer_map, initiator);
1485 if (NULL != ctx->recv_channel)
1487 ctx->recv_channel = channel;
1490 ctx->peer_flags |= LIVING;
1492 //ctx->peer_flags = IN_OTHER_GOSSIP_LIST;
1495 (void) GNUNET_CONTAINER_multipeermap_put (peer_map, initiator, ctx,
1496 GNUNET_CONTAINER_MULTIHASHMAPOPTION_REPLACE);
1498 return NULL; // TODO
1503 * This is called when a remote peer destroys a channel.
1505 * @param cls The closure
1506 * @param channel The channel being closed
1507 * @param channel_ctx The context associated with this channel
1510 cleanup_channel (void *cls,
1511 const struct GNUNET_CADET_Channel *channel,
1514 struct GNUNET_PeerIdentity *peer;
1515 struct PeerContext *peer_ctx;
1517 LOG (GNUNET_ERROR_TYPE_DEBUG, "Channel to remote peer was destroyed.\n");
1519 peer = (struct GNUNET_PeerIdentity *) GNUNET_CADET_channel_get_info (
1520 (struct GNUNET_CADET_Channel *) channel, GNUNET_CADET_OPTION_PEER);
1521 // Guess simply casting isn't the nicest way...
1522 // FIXME wait for cadet to change this function
1523 RPS_sampler_reinitialise_by_value (peer);
1525 peer_ctx = GNUNET_CONTAINER_multipeermap_get (peer_map, peer);
1526 /* Somwewhat {ab,re}use the iterator function */
1527 (void) peer_remove_cb (peer, peer, peer_ctx);
1532 * Actually start the service.
1535 rps_start (struct GNUNET_SERVER_Handle *server)
1537 static const struct GNUNET_SERVER_MessageHandler handlers[] = {
1538 {&handle_client_request, NULL, GNUNET_MESSAGE_TYPE_RPS_CS_REQUEST,
1539 sizeof (struct GNUNET_RPS_CS_RequestMessage)},
1540 {&handle_client_seed, NULL, GNUNET_MESSAGE_TYPE_RPS_CS_SEED, 0},
1544 GNUNET_SERVER_add_handlers (server, handlers);
1545 GNUNET_SERVER_disconnect_notify (server,
1546 &handle_client_disconnect,
1548 LOG (GNUNET_ERROR_TYPE_DEBUG, "Ready to receive requests from clients\n");
1551 num_hist_update_tasks = 0;
1553 do_round_task = GNUNET_SCHEDULER_add_now (&do_round, NULL);
1554 LOG (GNUNET_ERROR_TYPE_DEBUG, "Scheduled first round\n");
1556 GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_FOREVER_REL,
1563 * Process statistics requests.
1565 * @param cls closure
1566 * @param server the initialized server
1567 * @param c configuration to use
1571 struct GNUNET_SERVER_Handle *server,
1572 const struct GNUNET_CONFIGURATION_Handle *c)
1574 // TODO check what this does -- copied from gnunet-boss
1575 // - seems to work as expected
1576 GNUNET_log_setup ("rps", GNUNET_error_type_to_string (GNUNET_ERROR_TYPE_DEBUG), NULL);
1581 GNUNET_CRYPTO_get_peer_identity (cfg, &own_identity); // TODO check return value
1582 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1583 "STARTING SERVICE (rps) for peer [%s]\n",
1584 GNUNET_i2s (&own_identity));
1587 /* Get time interval from the configuration */
1588 if (GNUNET_OK != GNUNET_CONFIGURATION_get_value_time (cfg, "RPS",
1592 LOG (GNUNET_ERROR_TYPE_DEBUG, "Failed to read ROUNDINTERVAL from config\n");
1593 GNUNET_SCHEDULER_shutdown ();
1597 /* Get initial size of sampler/gossip list from the configuration */
1598 if (GNUNET_OK != GNUNET_CONFIGURATION_get_value_number (cfg, "RPS",
1600 (long long unsigned int *) &sampler_size_est_need))
1602 LOG (GNUNET_ERROR_TYPE_DEBUG, "Failed to read INITSIZE from config\n");
1603 GNUNET_SCHEDULER_shutdown ();
1606 LOG (GNUNET_ERROR_TYPE_DEBUG, "INITSIZE is %" PRIu64 "\n", sampler_size_est_need);
1612 /* connect to NSE */
1613 nse = GNUNET_NSE_connect (cfg, nse_callback, NULL);
1614 // TODO check whether that was successful
1615 LOG (GNUNET_ERROR_TYPE_DEBUG, "Connected to NSE\n");
1621 peer_map = GNUNET_CONTAINER_multipeermap_create (sampler_size_est_need, GNUNET_NO);
1624 /* Initialise cadet */
1625 static const struct GNUNET_CADET_MessageHandler cadet_handlers[] = {
1626 {&handle_peer_push , GNUNET_MESSAGE_TYPE_RPS_PP_PUSH ,
1627 sizeof (struct GNUNET_MessageHeader)},
1628 {&handle_peer_pull_request, GNUNET_MESSAGE_TYPE_RPS_PP_PULL_REQUEST,
1629 sizeof (struct GNUNET_MessageHeader)},
1630 {&handle_peer_pull_reply , GNUNET_MESSAGE_TYPE_RPS_PP_PULL_REPLY , 0},
1634 const uint32_t ports[] = {GNUNET_RPS_CADET_PORT, 0}; // _PORT specified in src/rps/rps.h
1635 cadet_handle = GNUNET_CADET_connect (cfg,
1637 &handle_inbound_channel,
1641 LOG (GNUNET_ERROR_TYPE_DEBUG, "Connected to CADET\n");
1644 /* Initialise sampler */
1645 struct GNUNET_TIME_Relative half_round_interval;
1646 struct GNUNET_TIME_Relative max_round_interval;
1648 half_round_interval = GNUNET_TIME_relative_multiply (round_interval, .5);
1649 max_round_interval = GNUNET_TIME_relative_add (round_interval, half_round_interval);
1651 RPS_sampler_init (sampler_size_est_need, max_round_interval,
1652 insertCB, NULL, removeCB, NULL);
1653 sampler_size = sampler_size_est_need;
1655 /* Initialise push and pull maps */
1660 pending_pull_reply_list = NULL;
1661 pending_pull_reply_list_size = 0;
1664 LOG (GNUNET_ERROR_TYPE_DEBUG, "Requesting peers from CADET\n");
1665 GNUNET_CADET_get_peers (cadet_handle, &init_peer_cb, server);
1667 // TODO send push/pull to each of those peers?
1672 * The main function for the rps service.
1674 * @param argc number of arguments from the command line
1675 * @param argv command line arguments
1676 * @return 0 ok, 1 on error
1679 main (int argc, char *const *argv)
1681 return (GNUNET_OK ==
1682 GNUNET_SERVICE_run (argc,
1685 GNUNET_SERVICE_OPTION_NONE,
1686 &run, NULL)) ? 0 : 1;
1689 /* end of gnunet-service-rps.c */