gnunet-service-nat_helper.h File Reference

runs the gnunet-helper-nat-server More...

#include "platform.h"
#include "gnunet_util_lib.h"

Include dependency graph for gnunet-service-nat_helper.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Typedefs
typedef void(*	GN_ReversalCallback) (void *cls, const struct sockaddr_in *ra)
	Function called whenever we get a connection reversal request from another peer. More...

Functions
struct HelperContext *	GN_start_gnunet_nat_server_ (const struct in_addr *internal_address, GN_ReversalCallback cb, void *cb_cls, const struct GNUNET_CONFIGURATION_Handle *cfg)
	Start the gnunet-helper-nat-server and process incoming requests. More...
void	GN_stop_gnunet_nat_server_ (struct HelperContext *h)
	Start the gnunet-helper-nat-server and process incoming requests. More...
int	GN_request_connection_reversal (const struct in_addr *internal_address, uint16_t internal_port, const struct in_addr *remote_v4, const struct GNUNET_CONFIGURATION_Handle *cfg)
	We want to connect to a peer that is behind NAT. More...

Detailed Description

runs the gnunet-helper-nat-server

Author

Milan Bouchet-Valat

Christian Grothoff

Definition in file gnunet-service-nat_helper.h.

Typedef Documentation

GN_ReversalCallback

typedef void(* GN_ReversalCallback) (void *cls, const struct sockaddr_in *ra)

Function called whenever we get a connection reversal request from another peer.

Parameters

cls	closure
ra	IP address of the peer who wants us to connect to it

Definition at line 44 of file gnunet-service-nat_helper.h.

Function Documentation

GN_start_gnunet_nat_server_()

struct HelperContext* GN_start_gnunet_nat_server_	(	const struct in_addr *	internal_address,
		GN_ReversalCallback	cb,
		void *	cb_cls,
		const struct GNUNET_CONFIGURATION_Handle *	cfg
	)

Start the gnunet-helper-nat-server and process incoming requests.

Parameters

internal_address
cb	function to call if we receive a request
cb_cls	closure for cb
cfg	handle to the GNUnet configuration

Returns

NULL on error

Definition at line 269 of file gnunet-service-nat_helper.c.

{
  struct HelperContext *h;
 
  h = GNUNET_new (struct HelperContext);
  h->cb = cb;
  h->cb_cls = cb_cls;
  h->internal_address = *internal_address;
  h->cfg = cfg;
  restart_nat_server (h);
  if (NULL == h->server_stdout)
  {
    GN_stop_gnunet_nat_server_ (h);
    return NULL;
  }
  return h;
}

References HelperContext::cb, HelperContext::cb_cls, cfg, GNUNET_ARM_Handle::cfg, GN_stop_gnunet_nat_server_(), GNUNET_new, h, HelperContext::internal_address, and restart_nat_server().

Referenced by run_scan().

Here is the call graph for this function:

Here is the caller graph for this function:

GN_stop_gnunet_nat_server_()

void GN_stop_gnunet_nat_server_

(

struct HelperContext *

h

)

Start the gnunet-helper-nat-server and process incoming requests.

Parameters

h	helper context to stop

Definition at line 298 of file gnunet-service-nat_helper.c.

{
  if (NULL != h->server_read_task)
  {
    GNUNET_SCHEDULER_cancel (h->server_read_task);
    h->server_read_task = NULL;
  }
  if (NULL != h->server_proc)
  {
    if (0 != GNUNET_OS_process_kill (h->server_proc, GNUNET_TERM_SIG))
      GNUNET_log_strerror (GNUNET_ERROR_TYPE_WARNING, "kill");
    GNUNET_OS_process_wait (h->server_proc);
    GNUNET_OS_process_destroy (h->server_proc);
    h->server_proc = NULL;
    GNUNET_DISK_pipe_close (h->server_stdout);
    h->server_stdout = NULL;
    h->server_stdout_handle = NULL;
  }
  if (NULL != h->server_stdout)
  {
    GNUNET_DISK_pipe_close (h->server_stdout);
    h->server_stdout = NULL;
    h->server_stdout_handle = NULL;
  }
  GNUNET_free (h);
}

References GNUNET_DISK_pipe_close(), GNUNET_ERROR_TYPE_WARNING, GNUNET_free, GNUNET_log_strerror, GNUNET_OS_process_destroy(), GNUNET_OS_process_kill(), GNUNET_OS_process_wait(), GNUNET_SCHEDULER_cancel(), GNUNET_TERM_SIG, and h.

Referenced by free_lal(), and GN_start_gnunet_nat_server_().

Here is the call graph for this function:

Here is the caller graph for this function:

GN_request_connection_reversal()

int GN_request_connection_reversal	(	const struct in_addr *	internal_address,
		uint16_t	internal_port,
		const struct in_addr *	remote_v4,
		const struct GNUNET_CONFIGURATION_Handle *	cfg
	)

We want to connect to a peer that is behind NAT.

Run the gnunet-helper-nat-client to send dummy ICMP responses to cause that peer to connect to us (connection reversal).

Parameters

internal_address	out internal address to use
internal_port	internal port to use
remote_v4	the address of the peer (IPv4-only)
cfg	handle to the GNUnet configuration

Returns

GNUNET_SYSERR on error, GNUNET_OK otherwise

Run the gnunet-helper-nat-client to send dummy ICMP responses to cause that peer to connect to us (connection reversal).

Parameters

internal_address	out internal address to use
internal_port	port to use
remote_v4	the address of the peer (IPv4-only)
cfg	handle to the GNUnet configuration

Returns

GNUNET_SYSERR on error, GNUNET_OK otherwise

Definition at line 339 of file gnunet-service-nat_helper.c.

{
  char intv4[INET_ADDRSTRLEN];
  char remv4[INET_ADDRSTRLEN];
  char port_as_string[6];
  struct GNUNET_OS_Process *proc;
  char *binary;
 
  if (NULL == inet_ntop (AF_INET, internal_address, intv4, INET_ADDRSTRLEN))
  {
    GNUNET_log_strerror (GNUNET_ERROR_TYPE_WARNING, "inet_ntop");
    return GNUNET_SYSERR;
  }
  if (NULL == inet_ntop (AF_INET, remote_v4, remv4, INET_ADDRSTRLEN))
  {
    GNUNET_log_strerror (GNUNET_ERROR_TYPE_WARNING, "inet_ntop");
    return GNUNET_SYSERR;
  }
  GNUNET_snprintf (port_as_string,
                   sizeof(port_as_string),
                   "%d",
                   internal_port);
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
              "Running gnunet-helper-nat-client %s %s %u\n",
              intv4,
              remv4,
              internal_port);
  binary = GNUNET_OS_get_suid_binary_path (cfg, "gnunet-helper-nat-client");
  proc = GNUNET_OS_start_process (GNUNET_OS_INHERIT_STD_NONE,
                                  NULL,
                                  NULL,
                                  NULL,
                                  binary,
                                  "gnunet-helper-nat-client",
                                  intv4,
                                  remv4,
                                  port_as_string,
                                  NULL);
  GNUNET_free (binary);
  if (NULL == proc)
    return GNUNET_SYSERR;
  /* we know that the gnunet-helper-nat-client will terminate virtually
   * instantly */
  GNUNET_OS_process_wait (proc);
  GNUNET_OS_process_destroy (proc);
  return GNUNET_OK;
}

Referenced by handle_request_connection_reversal().

Here is the caller graph for this function: