gnunet-rps.c File Reference

random peer sampling More...

#include "platform.h"
#include "gnunet_util_lib.h"
#include "gnunet_rps_service.h"
#include <inttypes.h>

Include dependency graph for gnunet-rps.c:

Go to the source code of this file.

Functions
static void	do_shutdown (void *cls)
	Task run when user presses CTRL-C to abort. More...
static void	reply_handle (void *cls, uint64_t n, const struct GNUNET_PeerIdentity *recv_peers)
	Callback called on receipt of reply. More...
static void	view_update_handle (void *cls, uint64_t n, const struct GNUNET_PeerIdentity *recv_peers)
	Callback called on receipt view update. More...
static void	stream_input_handle (void *cls, uint64_t num_peers, const struct GNUNET_PeerIdentity *recv_peers)
	Callback called on receipt of peer from biased stream. More...
static void	run (void *cls, char *const *args, const char *cfgfile, const struct GNUNET_CONFIGURATION_Handle *cfg)
	Main function that will be run by the scheduler. More...
int	main (int argc, char *const *argv)
	The main function to rps. More...

Variables
static int	ret
static struct GNUNET_RPS_Handle *	rps_handle
	RPS handle. More...
static struct GNUNET_RPS_Request_Handle *	req_handle
	Request handle. More...
static struct GNUNET_PeerIdentity	peer_id
	PeerID (Option –seed) More...
static int	view_update
	Do we want to receive updates of the view? (Option –view) More...
static int	stream_input
	Do we want to receive updates of the view? (Option –view) More...
static uint64_t	num_view_updates
	Number of updates we want to receive. More...

Detailed Description

random peer sampling

Author

Julius Bünger

Definition in file gnunet-rps.c.

Function Documentation

do_shutdown()

static void do_shutdown ( void *  cls )

static

Task run when user presses CTRL-C to abort.

Cancels pending request and disconnects.

Parameters

cls

NULL

Definition at line 71 of file gnunet-rps.c.

{
  (void) cls;
 
  if (NULL != req_handle)
    GNUNET_RPS_request_cancel (req_handle);
  GNUNET_RPS_disconnect (rps_handle);
}

References GNUNET_RPS_disconnect(), GNUNET_RPS_request_cancel(), req_handle, and rps_handle.

Referenced by run().

Here is the call graph for this function:

Here is the caller graph for this function:

reply_handle()

static void reply_handle ( void *  cls, uint64_t  n, const struct GNUNET_PeerIdentity *  recv_peers  )

static

Callback called on receipt of reply.

Prints replied PeerIDs.

Parameters

cls	closure
n	number of peers
recv_peers	the received peers

Definition at line 90 of file gnunet-rps.c.

{
  uint64_t i;
 
  (void) cls;
 
  req_handle = NULL;
  for (i = 0; i < n; i++)
  {
    fprintf (stdout, "%s\n",
             GNUNET_i2s_full (&recv_peers[i]));
  }
  ret = 0;
 
  GNUNET_SCHEDULER_shutdown ();
}

References GNUNET_i2s_full(), GNUNET_SCHEDULER_shutdown(), req_handle, and ret.

Referenced by run().

Here is the call graph for this function:

Here is the caller graph for this function:

view_update_handle()

static void view_update_handle ( void *  cls, uint64_t  n, const struct GNUNET_PeerIdentity *  recv_peers  )

static

Callback called on receipt view update.

Prints view.

Parameters

n	number of peers
recv_peers	the received peers

Definition at line 118 of file gnunet-rps.c.

{
  uint64_t i;
 
  (void) cls;
 
  if (0 == n)
  {
    fprintf (stdout, "Empty view\n");
  }
  req_handle = NULL;
  for (i = 0; i < n; i++)
  {
    fprintf (stdout, "%s\n",
             GNUNET_i2s_full (&recv_peers[i]));
  }
 
  if (1 == num_view_updates)
  {
    ret = 0;
    GNUNET_SCHEDULER_shutdown ();
  }
  else if (1 < num_view_updates)
  {
    num_view_updates--;
  }
}

References GNUNET_i2s_full(), GNUNET_SCHEDULER_shutdown(), num_view_updates, req_handle, and ret.

Referenced by run().

Here is the call graph for this function:

Here is the caller graph for this function:

stream_input_handle()

static void stream_input_handle ( void *  cls, uint64_t  num_peers, const struct GNUNET_PeerIdentity *  recv_peers  )

static

Callback called on receipt of peer from biased stream.

Parameters

num_peers	number of peers
recv_peers	the received peers

Definition at line 156 of file gnunet-rps.c.

{
  uint64_t i;
 
  (void) cls;
 
  if (0 == num_peers)
  {
    fprintf (stdout, "No peer was returned\n");
  }
  req_handle = NULL;
  for (i = 0; i < num_peers; i++)
  {
    fprintf (stdout, "%s\n",
             GNUNET_i2s_full (&recv_peers[i]));
  }
}

References GNUNET_i2s_full(), num_peers, and req_handle.

Referenced by run().

Here is the call graph for this function:

Here is the caller graph for this function:

run()

static void run ( void *  cls, char *const *  args, const char *  cfgfile, const struct GNUNET_CONFIGURATION_Handle *  cfg  )

static

Main function that will be run by the scheduler.

Parameters

cls	closure
args	remaining command-line arguments
cfgfile	name of the configuration file used (for saving, can be NULL!)
cfg	configuration

Definition at line 186 of file gnunet-rps.c.

{
  static uint64_t num_peers;
  static struct GNUNET_PeerIdentity zero_pid;
 
  (void) cls;
  (void) cfgfile;
 
  rps_handle = GNUNET_RPS_connect (cfg);
  if (NULL == rps_handle)
  {
    fprintf (stderr, "Failed to connect to the rps service\n");
    return;
  }
 
  if ((0 == memcmp (&zero_pid, &peer_id, sizeof(peer_id))) &&
      (! view_update) &&
      (! stream_input))
  {   /* Request n PeerIDs */
      /* If number was specified use it, else request single peer. */
    if ((NULL == args[0]) ||
        (0 == sscanf (args[0], "%lu", &num_peers)) )
    {
      num_peers = 1;
    }
    GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
                "Requesting %" PRIu64 " PeerIDs\n", num_peers);
    req_handle = GNUNET_RPS_request_peers (rps_handle, num_peers, reply_handle,
                                           NULL);
    GNUNET_SCHEDULER_add_shutdown (&do_shutdown, NULL);
  }
  else if (view_update)
  {
    /* Get updates of view */
    if ((NULL == args[0]) ||
        (0 == sscanf (args[0], "%lu", &num_view_updates)) )
    {
      num_view_updates = 0;
    }
    GNUNET_RPS_view_request (rps_handle, num_view_updates, view_update_handle,
                             NULL);
    if (0 != num_view_updates)
      GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
                  "Requesting %" PRIu64 " view updates\n", num_view_updates);
    else
      GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
                  "Requesting continuous view updates\n");
    GNUNET_SCHEDULER_add_shutdown (&do_shutdown, NULL);
  }
  else if (stream_input)
  {
    /* Get updates of view */
    GNUNET_RPS_stream_request (rps_handle, stream_input_handle, NULL);
    GNUNET_SCHEDULER_add_shutdown (&do_shutdown, NULL);
  }
  else
  {   /* Seed PeerID */
    GNUNET_RPS_seed_ids (rps_handle, 1, &peer_id);
    fprintf (stdout, "Seeded PeerID %s\n", GNUNET_i2s_full (&peer_id));
    ret = 0;
    GNUNET_SCHEDULER_add_now (&do_shutdown, NULL);
  }
}

References consensus-simulation::args, cfg, do_shutdown(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_i2s_full(), GNUNET_log, GNUNET_RPS_connect(), GNUNET_RPS_request_peers(), GNUNET_RPS_seed_ids(), GNUNET_RPS_stream_request(), GNUNET_RPS_view_request(), GNUNET_SCHEDULER_add_now(), GNUNET_SCHEDULER_add_shutdown(), num_peers, num_view_updates, peer_id, reply_handle(), req_handle, ret, rps_handle, stream_input, stream_input_handle(), view_update, and view_update_handle().

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

main()

int main	(	int	argc,
		char *const *	argv
	)

The main function to rps.

Parameters

argc	number of arguments from the command line
argv	command line arguments

Returns

0 ok, 1 on error

Definition at line 262 of file gnunet-rps.c.

{
  const char helpstr[] =
    "Get random GNUnet peers. If none is specified a single is requested.";
  struct GNUNET_GETOPT_CommandLineOption options[] = {
    GNUNET_GETOPT_option_base32_auto ('s',
                                      "seed",
                                      "PEER_ID",
                                      gettext_noop ("Seed a PeerID"),
                                      &peer_id),
    GNUNET_GETOPT_option_flag ('V',
                               "view",
                               gettext_noop (
                                 "Get updates of view (0 for infinite updates)"),
                               &view_update),
    GNUNET_GETOPT_option_flag ('S',
                               "stream",
                               gettext_noop ("Get peers from biased stream"),
                               &stream_input),
    GNUNET_GETOPT_OPTION_END
  };
 
  return (GNUNET_OK ==
          GNUNET_PROGRAM_run (GNUNET_OS_project_data_gnunet(),
                              argc,
                              argv,
                              "gnunet-rps [NUMBER_OF_PEERS]",
                              gettext_noop
                                (helpstr),
                              options, &run, NULL)) ? ret : 1;
}

References gettext_noop, GNUNET_GETOPT_option_base32_auto, GNUNET_GETOPT_OPTION_END, GNUNET_GETOPT_option_flag(), GNUNET_OK, GNUNET_OS_project_data_gnunet(), GNUNET_PROGRAM_run(), options, peer_id, ret, run(), stream_input, and view_update.

Here is the call graph for this function:

Variable Documentation

ret

int ret

static

Definition at line 31 of file gnunet-rps.c.

Referenced by main(), reply_handle(), run(), and view_update_handle().

rps_handle

struct GNUNET_RPS_Handle* rps_handle

static

RPS handle.

Definition at line 36 of file gnunet-rps.c.

Referenced by cancel_stream(), do_shutdown(), GNUNET_RPS_request_peer_info(), GNUNET_RPS_request_peers(), GNUNET_RPS_stream_cancel(), GNUNET_RPS_stream_request(), GNUNET_RPS_view_request(), GNUNET_RPS_view_request_cancel(), new_stream_request(), remove_stream_request(), and run().

req_handle

struct GNUNET_RPS_Request_Handle* req_handle

static

Request handle.

Definition at line 41 of file gnunet-rps.c.

Referenced by check_n_peers_ready(), check_peer_info_ready(), do_shutdown(), reply_handle(), RPS_sampler_get_n_rand_peers(), RPS_sampler_get_rand_peer_info(), RPS_sampler_request_cancel(), run(), stream_input_handle(), and view_update_handle().

peer_id

struct GNUNET_PeerIdentity peer_id

static

PeerID (Option –seed)

Definition at line 46 of file gnunet-rps.c.

Referenced by main(), and run().

view_update

int view_update

static

Do we want to receive updates of the view? (Option –view)

Definition at line 51 of file gnunet-rps.c.

Referenced by main(), reconnect(), and run().

stream_input

int stream_input

static

Do we want to receive updates of the view? (Option –view)

Definition at line 56 of file gnunet-rps.c.

Referenced by main(), reconnect(), and run().

num_view_updates

uint64_t num_view_updates

static

Number of updates we want to receive.

Definition at line 61 of file gnunet-rps.c.

Referenced by run(), and view_update_handle().