GNUnet  0.11.x
Data Structures | Macros | Functions | Variables
gnunet-communicator-unix.c File Reference

Transport plugin using unix domain sockets (!) Clearly, can only be used locally on Unix/Linux hosts... More...

#include "platform.h"
#include "gnunet_util_lib.h"
#include "gnunet_protocols.h"
#include "gnunet_constants.h"
#include "gnunet_nt_lib.h"
#include "gnunet_statistics_service.h"
#include "gnunet_transport_communication_service.h"
Include dependency graph for gnunet-communicator-unix.c:

Go to the source code of this file.

Data Structures

struct  UNIXMessage
 UNIX Message-Packet header. More...
 
struct  Queue
 Handle for a queue. More...
 
struct  LookupCtx
 Closure to lookup_queue_it(). More...
 

Macros

#define DEFAULT_MAX_QUEUE_LENGTH   8
 How many messages do we keep at most in the queue to the transport service before we start to drop (default, can be changed via the configuration file). More...
 
#define COMMUNICATOR_ADDRESS_PREFIX   "unix"
 Address prefix used by the communicator. More...
 
#define COMMUNICATOR_CONFIG_SECTION   "communicator-unix"
 Configuration section used by the communicator. More...
 
#define UNIX_MTU   UINT16_MAX
 Our MTU. More...
 

Functions

static void queue_destroy (struct Queue *queue)
 Functions with this signature are called whenever we need to close a queue due to a disconnect or failure to establish a connection. More...
 
static void queue_timeout (void *cls)
 Queue was idle for too long, so disconnect it. More...
 
static void reschedule_queue_timeout (struct Queue *queue)
 Increment queue timeout due to activity. More...
 
static struct sockaddr_un * unix_address_to_sockaddr (const char *unixpath, socklen_t *sock_len)
 Convert unix path to a struct sockaddr_un * More...
 
static int lookup_queue_it (void *cls, const struct GNUNET_PeerIdentity *key, void *value)
 Function called to find a queue by address. More...
 
static struct Queuelookup_queue (const struct GNUNET_PeerIdentity *peer, const struct sockaddr_un *un, socklen_t un_len)
 Find an existing queue by address. More...
 
static void select_write_cb (void *cls)
 We have been notified that our socket is ready to write. More...
 
static void mq_send (struct GNUNET_MQ_Handle *mq, const struct GNUNET_MessageHeader *msg, void *impl_state)
 Signature of functions implementing the sending functionality of a message queue. More...
 
static void mq_destroy (struct GNUNET_MQ_Handle *mq, void *impl_state)
 Signature of functions implementing the destruction of a message queue. More...
 
static void mq_cancel (struct GNUNET_MQ_Handle *mq, void *impl_state)
 Implementation function that cancels the currently sent message. More...
 
static void mq_error (void *cls, enum GNUNET_MQ_Error error)
 Generic error handler, called with the appropriate error code and the same closure specified at the creation of the message queue. More...
 
static struct Queuesetup_queue (const struct GNUNET_PeerIdentity *target, enum GNUNET_TRANSPORT_ConnectionStatus cs, const struct sockaddr_un *un, socklen_t un_len)
 Creates a new outbound queue the transport service will use to send data to another peer. More...
 
static void select_read_cb (void *cls)
 We have been notified that our socket has something to read. More...
 
static void receive_complete_cb (void *cls, int success)
 Function called when message was successfully passed to transport service. More...
 
static int mq_init (void *cls, const struct GNUNET_PeerIdentity *peer, const char *address)
 Function called by the transport service to initialize a message queue given address information about another peer. More...
 
static int get_queue_delete_it (void *cls, const struct GNUNET_PeerIdentity *target, void *value)
 Iterator over all message queues to clean up. More...
 
static void do_shutdown (void *cls)
 Shutdown the UNIX communicator. More...
 
static void enc_notify_cb (void *cls, const struct GNUNET_PeerIdentity *sender, const struct GNUNET_MessageHeader *msg)
 Function called when the transport service has received an acknowledgement for this communicator (!) via a different return path. More...
 
static void run (void *cls, char *const *args, const char *cfgfile, const struct GNUNET_CONFIGURATION_Handle *cfg)
 Setup communicator and launch network interactions. More...
 
int main (int argc, char *const *argv)
 The main function for the UNIX communicator. More...
 

Variables

static struct GNUNET_SCHEDULER_Taskread_task
 ID of read task. More...
 
static struct GNUNET_SCHEDULER_Taskwrite_task
 ID of write task. More...
 
static unsigned long long delivering_messages
 Number of messages we currently have in our queues towards the transport service. More...
 
static unsigned long long max_queue_length
 Maximum queue length before we stop reading towards the transport service. More...
 
static struct GNUNET_STATISTICS_Handlestats
 For logging statistics. More...
 
static struct GNUNET_TRANSPORT_CommunicatorHandlech
 Our environment. More...
 
static struct GNUNET_CONTAINER_MultiPeerMapqueue_map
 Queues (map from peer identity to struct Queue) More...
 
static struct Queuequeue_head
 Head of queue of messages to transmit. More...
 
static struct Queuequeue_tail
 Tail of queue of messages to transmit. More...
 
static struct GNUNET_NETWORK_Handleunix_sock
 socket that we transmit all data with More...
 
static struct GNUNET_TRANSPORT_AddressIdentifierai
 Handle to the operation that publishes our address. More...
 

Detailed Description

Transport plugin using unix domain sockets (!) Clearly, can only be used locally on Unix/Linux hosts...

ONLY INTENDED FOR TESTING!!!

Author
Christian Grothoff
Nathan Evans

Definition in file gnunet-communicator-unix.c.

Macro Definition Documentation

◆ DEFAULT_MAX_QUEUE_LENGTH

#define DEFAULT_MAX_QUEUE_LENGTH   8

How many messages do we keep at most in the queue to the transport service before we start to drop (default, can be changed via the configuration file).

Should be below the level of the communicator API, as otherwise we may read messages just to have them dropped by the communicator API.

Definition at line 45 of file gnunet-communicator-unix.c.

Referenced by run().

◆ COMMUNICATOR_ADDRESS_PREFIX

#define COMMUNICATOR_ADDRESS_PREFIX   "unix"

Address prefix used by the communicator.

Definition at line 50 of file gnunet-communicator-unix.c.

Referenced by mq_init(), run(), and setup_queue().

◆ COMMUNICATOR_CONFIG_SECTION

#define COMMUNICATOR_CONFIG_SECTION   "communicator-unix"

Configuration section used by the communicator.

Definition at line 55 of file gnunet-communicator-unix.c.

Referenced by run().

◆ UNIX_MTU

#define UNIX_MTU   UINT16_MAX

Our MTU.

Definition at line 60 of file gnunet-communicator-unix.c.

Referenced by setup_queue().

Function Documentation

◆ queue_destroy()

static void queue_destroy ( struct Queue queue)
static

Functions with this signature are called whenever we need to close a queue due to a disconnect or failure to establish a connection.

Parameters
queuequeue to close down

Definition at line 210 of file gnunet-communicator-unix.c.

References Queue::address, Queue::bytes_in_queue, GNUNET_assert, GNUNET_CONTAINER_DLL_remove, GNUNET_CONTAINER_multipeermap_remove(), GNUNET_CONTAINER_multipeermap_size(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_i2s(), GNUNET_log, GNUNET_MQ_destroy(), GNUNET_NO, GNUNET_SCHEDULER_cancel(), GNUNET_STATISTICS_set(), GNUNET_YES, mq, Queue::mq, Queue::target, and Queue::timeout_task.

Referenced by get_queue_delete_it(), mq_destroy(), mq_error(), and queue_timeout().

211 {
212  struct GNUNET_MQ_Handle *mq;
213 
215  "Disconnecting queue for peer `%s'\n",
216  GNUNET_i2s (&queue->target));
217  if (0 != queue->bytes_in_queue)
218  {
220  queue->bytes_in_queue = 0;
221  }
222  if (NULL != (mq = queue->mq))
223  {
224  queue->mq = NULL;
225  GNUNET_MQ_destroy (mq);
226  }
227  GNUNET_assert (
228  GNUNET_YES ==
231  "# queues active",
233  GNUNET_NO);
234  if (NULL != queue->timeout_task)
235  {
237  queue->timeout_task = NULL;
238  }
239  GNUNET_free (queue->address);
240  GNUNET_free (queue);
241 }
#define GNUNET_CONTAINER_DLL_remove(head, tail, element)
Remove an element from a DLL.
struct GNUNET_PeerIdentity target
To whom are we talking to.
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
int GNUNET_CONTAINER_multipeermap_remove(struct GNUNET_CONTAINER_MultiPeerMap *map, const struct GNUNET_PeerIdentity *key, const void *value)
Remove the given key-value pair from the map.
#define GNUNET_NO
Definition: gnunet_common.h:78
struct GNUNET_MQ_Handle * mq
Message queue we are providing for the ch.
struct GNUNET_SCHEDULER_Task * timeout_task
Queue timeout task.
unsigned long long bytes_in_queue
Number of bytes we currently have in our write queue.
static struct Queue * queue_head
Head of queue of messages to transmit.
static struct GNUNET_STATISTICS_Handle * stats
For logging statistics.
void GNUNET_STATISTICS_set(struct GNUNET_STATISTICS_Handle *handle, const char *name, uint64_t value, int make_persistent)
Set statistic value for the peer.
Handle to a message queue.
Definition: mq.c:85
struct sockaddr * address
Address of the other peer.
static struct GNUNET_CONTAINER_MultiPeerMap * queue_map
Queues (map from peer identity to struct Queue)
struct GNUNET_MQ_Handle * mq
Definition: 003.c:5
#define GNUNET_log(kind,...)
void GNUNET_MQ_destroy(struct GNUNET_MQ_Handle *mq)
Destroy the message queue.
Definition: mq.c:824
#define GNUNET_YES
Definition: gnunet_common.h:77
unsigned int GNUNET_CONTAINER_multipeermap_size(const struct GNUNET_CONTAINER_MultiPeerMap *map)
Get the number of key-value pairs in the map.
static struct Queue * queue_tail
Tail of queue of messages to transmit.
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
#define GNUNET_free(ptr)
Wrapper around free.
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:966
Here is the call graph for this function:
Here is the caller graph for this function:

◆ queue_timeout()

static void queue_timeout ( void *  cls)
static

Queue was idle for too long, so disconnect it.

Parameters
clsthe struct Queue * to disconnect

Definition at line 250 of file gnunet-communicator-unix.c.

References GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT, GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, GNUNET_SCHEDULER_add_delayed(), GNUNET_STRINGS_relative_time_to_string(), GNUNET_TIME_absolute_get_remaining(), GNUNET_YES, queue(), queue_destroy(), GNUNET_TIME_Relative::rel_value_us, Queue::timeout, and Queue::timeout_task.

Referenced by setup_queue().

251 {
252  struct Queue *queue = cls;
253  struct GNUNET_TIME_Relative left;
254 
255  queue->timeout_task = NULL;
257  if (0 != left.rel_value_us)
258  {
259  /* not actually our turn yet, but let's at least update
260  the monitor, it may think we're about to die ... */
261  queue->timeout_task =
263  return;
264  }
266  "Queue %p was idle for %s, disconnecting\n",
267  queue,
270  GNUNET_YES));
271  queue_destroy (queue);
272 }
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
static void queue_destroy(struct Queue *queue)
Functions with this signature are called whenever we need to close a queue due to a disconnect or fai...
struct GNUNET_SCHEDULER_Task * timeout_task
Queue timeout task.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1253
Handle for a queue.
const char * GNUNET_STRINGS_relative_time_to_string(struct GNUNET_TIME_Relative delta, int do_round)
Give relative time in human-readable fancy format.
Definition: strings.c:687
static void queue_timeout(void *cls)
Queue was idle for too long, so disconnect it.
#define GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT
After how long do we consider a connection to a peer dead if we don't receive messages from the peer...
#define GNUNET_log(kind,...)
struct GNUNET_TIME_Relative GNUNET_TIME_absolute_get_remaining(struct GNUNET_TIME_Absolute future)
Given a timestamp in the future, how much time remains until then?
Definition: time.c:331
#define GNUNET_YES
Definition: gnunet_common.h:77
struct GNUNET_TIME_Absolute timeout
Timeout for this queue.
Time for relative time used by GNUnet, in microseconds.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ reschedule_queue_timeout()

static void reschedule_queue_timeout ( struct Queue queue)
static

Increment queue timeout due to activity.

We do not immediately notify the monitor here as that might generate excessive signalling.

Parameters
queuequeue for which the timeout should be rescheduled

Definition at line 283 of file gnunet-communicator-unix.c.

References GNUNET_assert, GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT, GNUNET_TIME_relative_to_absolute(), Queue::timeout, and Queue::timeout_task.

Referenced by select_read_cb(), and select_write_cb().

284 {
285  GNUNET_assert (NULL != queue->timeout_task);
286  queue->timeout =
288 }
struct GNUNET_TIME_Absolute GNUNET_TIME_relative_to_absolute(struct GNUNET_TIME_Relative rel)
Convert relative time to an absolute time in the future.
Definition: time.c:246
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
struct GNUNET_SCHEDULER_Task * timeout_task
Queue timeout task.
#define GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT
After how long do we consider a connection to a peer dead if we don't receive messages from the peer...
struct GNUNET_TIME_Absolute timeout
Timeout for this queue.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ unix_address_to_sockaddr()

static struct sockaddr_un* unix_address_to_sockaddr ( const char *  unixpath,
socklen_t *  sock_len 
)
static

Convert unix path to a struct sockaddr_un *

Parameters
unixpathpath to convert
[out]sock_lenset to the length of the address
is_abstractis this an abstract unixpath
Returns
converted unix path

Definition at line 300 of file gnunet-communicator-unix.c.

References GNUNET_assert, GNUNET_memcpy, and GNUNET_new.

Referenced by mq_init(), and run().

301 {
302  struct sockaddr_un *un;
303  size_t slen;
304 
305  GNUNET_assert (0 < strlen (unixpath)); /* sanity check */
306  un = GNUNET_new (struct sockaddr_un);
307  un->sun_family = AF_UNIX;
308  slen = strlen (unixpath);
309  if (slen >= sizeof(un->sun_path))
310  slen = sizeof(un->sun_path) - 1;
311  GNUNET_memcpy (un->sun_path, unixpath, slen);
312  un->sun_path[slen] = '\0';
313  slen = sizeof(struct sockaddr_un);
314 #if HAVE_SOCKADDR_UN_SUN_LEN
315  un->sun_len = (u_char) slen;
316 #endif
317  (*sock_len) = slen;
318  if ('@' == un->sun_path[0])
319  un->sun_path[0] = '\0';
320  return un;
321 }
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
#define GNUNET_memcpy(dst, src, n)
Call memcpy() but check for n being 0 first.
#define GNUNET_new(type)
Allocate a struct or union of the given type.
Here is the caller graph for this function:

◆ lookup_queue_it()

static int lookup_queue_it ( void *  cls,
const struct GNUNET_PeerIdentity key,
void *  value 
)
static

Function called to find a queue by address.

Parameters
clsthe struct LookupCtx *
keypeer we are looking for (unused)
valuea queue
Returns
GNUNET_YES if not found (continue looking), GNUNET_NO on success

Definition at line 355 of file gnunet-communicator-unix.c.

References Queue::address, Queue::address_len, GNUNET_NO, GNUNET_YES, queue(), LookupCtx::res, LookupCtx::un, LookupCtx::un_len, and value.

Referenced by lookup_queue().

356 {
357  struct LookupCtx *lctx = cls;
358  struct Queue *queue = value;
359 
360  if ((queue->address_len = lctx->un_len) &&
361  (0 == memcmp (lctx->un, queue->address, queue->address_len)))
362  {
363  lctx->res = queue;
364  return GNUNET_NO;
365  }
366  return GNUNET_YES;
367 }
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
socklen_t un_len
Number of bytes in un.
socklen_t address_len
Length of the address.
Closure to lookup_queue_it().
#define GNUNET_NO
Definition: gnunet_common.h:78
static char * value
Value of the record to add/remove.
Handle for a queue.
const struct sockaddr_un * un
Address we are looking for.
struct sockaddr * address
Address of the other peer.
struct Queue * res
Location to store the queue, if found.
#define GNUNET_YES
Definition: gnunet_common.h:77
Here is the call graph for this function:
Here is the caller graph for this function:

◆ lookup_queue()

static struct Queue* lookup_queue ( const struct GNUNET_PeerIdentity peer,
const struct sockaddr_un *  un,
socklen_t  un_len 
)
static

Find an existing queue by address.

Parameters
pluginthe plugin
addressthe address to find
Returns
NULL if queue was not found

Definition at line 378 of file gnunet-communicator-unix.c.

References GNUNET_CONTAINER_multipeermap_get_multiple(), lookup_queue_it(), LookupCtx::res, LookupCtx::un, and LookupCtx::un_len.

Referenced by mq_init(), and select_read_cb().

381 {
382  struct LookupCtx lctx;
383 
384  lctx.un = un;
385  lctx.un_len = un_len;
387  peer,
389  &lctx);
390  return lctx.res;
391 }
static int lookup_queue_it(void *cls, const struct GNUNET_PeerIdentity *key, void *value)
Function called to find a queue by address.
socklen_t un_len
Number of bytes in un.
Closure to lookup_queue_it().
const struct sockaddr_un * un
Address we are looking for.
static struct GNUNET_CONTAINER_MultiPeerMap * queue_map
Queues (map from peer identity to struct Queue)
int GNUNET_CONTAINER_multipeermap_get_multiple(struct GNUNET_CONTAINER_MultiPeerMap *map, const struct GNUNET_PeerIdentity *key, GNUNET_CONTAINER_PeerMapIterator it, void *it_cls)
Iterate over all entries in the map that match a particular key.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ select_write_cb()

static void select_write_cb ( void *  cls)
static

We have been notified that our socket is ready to write.

Then reschedule this function to be called again once more is available.

Parameters
clsNULL

Definition at line 401 of file gnunet-communicator-unix.c.

References Queue::address, Queue::address_len, GNUNET_break, GNUNET_CONTAINER_DLL_remove, GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_ERROR, GNUNET_i2s(), GNUNET_log, GNUNET_log_strerror, GNUNET_MQ_impl_send_continue(), GNUNET_NETWORK_socket_getsockopt(), GNUNET_NETWORK_socket_sendto(), GNUNET_NETWORK_socket_setsockopt(), GNUNET_NO, GNUNET_OK, GNUNET_SCHEDULER_add_write_net(), GNUNET_STATISTICS_update(), GNUNET_TIME_UNIT_FOREVER_REL, len, Queue::mq, msg, Queue::msg, queue(), queue_tail, reschedule_queue_timeout(), size, GNUNET_MessageHeader::size, and Queue::target.

Referenced by mq_send().

402 {
403  struct Queue *queue = queue_tail;
404  const struct GNUNET_MessageHeader *msg = queue->msg;
405  size_t msg_size = ntohs (msg->size);
406  ssize_t sent;
407 
408  /* take queue of the ready list */
409  write_task = NULL;
411  if (NULL != queue_head)
413  unix_sock,
415  NULL);
416 
417  /* send 'msg' */
418  queue->msg = NULL;
420 resend:
421  /* Send the data */
423  msg,
424  msg_size,
425  (const struct sockaddr *) queue->address,
426  queue->address_len);
428  "UNIX transmitted message to %s (%d/%u: %s)\n",
429  GNUNET_i2s (&queue->target),
430  (int) sent,
431  (unsigned int) msg_size,
432  (sent < 0) ? strerror (errno) : "ok");
433  if (-1 != sent)
434  {
436  "# bytes sent",
437  (long long) sent,
438  GNUNET_NO);
439  reschedule_queue_timeout (queue);
440  return; /* all good */
441  }
443  "# network transmission failures",
444  1,
445  GNUNET_NO);
446  switch (errno)
447  {
448  case EAGAIN:
449  case ENOBUFS:
450  /* We should retry later... */
452  return;
453 
454  case EMSGSIZE: {
455  socklen_t size = 0;
456  socklen_t len = sizeof(size);
457 
459  SOL_SOCKET,
460  SO_SNDBUF,
461  &size,
462  &len);
463  if (size > ntohs (msg->size))
464  {
465  /* Buffer is bigger than message: error, no retry
466  * This should never happen!*/
467  GNUNET_break (0);
468  return;
469  }
470  GNUNET_log (
472  "Trying to increase socket buffer size from %u to %u for message size %u\n",
473  (unsigned int) size,
474  (unsigned int) ((msg_size / 1000) + 2) * 1000,
475  (unsigned int) msg_size);
476  size = ((msg_size / 1000) + 2) * 1000;
478  SOL_SOCKET,
479  SO_SNDBUF,
480  &size,
481  sizeof(size)))
482  goto resend; /* Increased buffer size, retry sending */
483  /* Ok, then just try very modest increase */
484  size = msg_size;
486  SOL_SOCKET,
487  SO_SNDBUF,
488  &size,
489  sizeof(size)))
490  goto resend; /* Increased buffer size, retry sending */
491  /* Could not increase buffer size: error, no retry */
493  return;
494  }
495 
496  default:
498  return;
499  }
500 }
#define GNUNET_CONTAINER_DLL_remove(head, tail, element)
Remove an element from a DLL.
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
int GNUNET_NETWORK_socket_setsockopt(struct GNUNET_NETWORK_Handle *fd, int level, int option_name, const void *option_value, socklen_t option_len)
Set socket option.
Definition: network.c:883
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
struct GNUNET_PeerIdentity target
To whom are we talking to.
socklen_t address_len
Length of the address.
static struct GNUNET_SCHEDULER_Task * write_task
ID of write task.
int GNUNET_NETWORK_socket_getsockopt(const struct GNUNET_NETWORK_Handle *desc, int level, int optname, void *optval, socklen_t *optlen)
Get socket options.
Definition: network.c:683
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_write_net(struct GNUNET_TIME_Relative delay, struct GNUNET_NETWORK_Handle *wfd, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay or when the specified file descriptor is ready f...
Definition: scheduler.c:1557
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
static void reschedule_queue_timeout(struct Queue *queue)
Increment queue timeout due to activity.
struct GNUNET_MQ_Handle * mq
Message queue we are providing for the ch.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
#define GNUNET_log_strerror(level, cmd)
Log an error message at log-level &#39;level&#39; that indicates a failure of the command &#39;cmd&#39; with the mess...
static struct Queue * queue_head
Head of queue of messages to transmit.
static struct GNUNET_STATISTICS_Handle * stats
For logging statistics.
Handle for a queue.
ssize_t GNUNET_NETWORK_socket_sendto(const struct GNUNET_NETWORK_Handle *desc, const void *message, size_t length, const struct sockaddr *dest_addr, socklen_t dest_len)
Send data to a particular destination (always non-blocking).
Definition: network.c:850
#define GNUNET_TIME_UNIT_FOREVER_REL
Constant used to specify "forever".
static void select_write_cb(void *cls)
We have been notified that our socket is ready to write.
static unsigned int size
Size of the "table".
Definition: peer.c:67
const struct GNUNET_MessageHeader * msg
Message currently scheduled for transmission, non-NULL if and only if this queue is in the queue_head...
struct sockaddr * address
Address of the other peer.
static struct GNUNET_NETWORK_Handle * unix_sock
socket that we transmit all data with
#define GNUNET_log(kind,...)
Header for all communications.
static struct Queue * queue_tail
Tail of queue of messages to transmit.
void GNUNET_MQ_impl_send_continue(struct GNUNET_MQ_Handle *mq)
Call the send implementation for the next queued message, if any.
Definition: mq.c:486
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
uint16_t len
length of data (which is always a uint32_t, but presumably this can be used to specify that fewer byt...
Here is the call graph for this function:
Here is the caller graph for this function:

◆ mq_send()

static void mq_send ( struct GNUNET_MQ_Handle mq,
const struct GNUNET_MessageHeader msg,
void *  impl_state 
)
static

Signature of functions implementing the sending functionality of a message queue.

Parameters
mqthe message queue
msgthe message to send
impl_stateour struct Queue

Definition at line 512 of file gnunet-communicator-unix.c.

References GNUNET_assert, GNUNET_CONTAINER_DLL_insert, GNUNET_SCHEDULER_add_write_net(), GNUNET_TIME_UNIT_FOREVER_REL, Queue::mq, msg, Queue::msg, queue(), and select_write_cb().

Referenced by setup_queue().

515 {
516  struct Queue *queue = impl_state;
517 
518  GNUNET_assert (mq == queue->mq);
519  GNUNET_assert (NULL == queue->msg);
520  queue->msg = msg;
522  GNUNET_assert (NULL != unix_sock);
523  if (NULL == write_task)
525  unix_sock,
527  NULL);
528 }
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
#define GNUNET_CONTAINER_DLL_insert(head, tail, element)
Insert an element at the head of a DLL.
static struct GNUNET_SCHEDULER_Task * write_task
ID of write task.
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_write_net(struct GNUNET_TIME_Relative delay, struct GNUNET_NETWORK_Handle *wfd, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay or when the specified file descriptor is ready f...
Definition: scheduler.c:1557
struct GNUNET_MQ_Handle * mq
Message queue we are providing for the ch.
static struct Queue * queue_head
Head of queue of messages to transmit.
Handle for a queue.
#define GNUNET_TIME_UNIT_FOREVER_REL
Constant used to specify "forever".
static void select_write_cb(void *cls)
We have been notified that our socket is ready to write.
const struct GNUNET_MessageHeader * msg
Message currently scheduled for transmission, non-NULL if and only if this queue is in the queue_head...
static struct GNUNET_NETWORK_Handle * unix_sock
socket that we transmit all data with
static struct Queue * queue_tail
Tail of queue of messages to transmit.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ mq_destroy()

static void mq_destroy ( struct GNUNET_MQ_Handle mq,
void *  impl_state 
)
static

Signature of functions implementing the destruction of a message queue.

Implementations must not free mq, but should take care of impl_state.

Parameters
mqthe message queue to destroy
impl_stateour struct Queue

Definition at line 540 of file gnunet-communicator-unix.c.

References Queue::mq, queue(), and queue_destroy().

Referenced by setup_queue().

541 {
542  struct Queue *queue = impl_state;
543 
544  if (mq == queue->mq)
545  {
546  queue->mq = NULL;
547  queue_destroy (queue);
548  }
549 }
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
static void queue_destroy(struct Queue *queue)
Functions with this signature are called whenever we need to close a queue due to a disconnect or fai...
struct GNUNET_MQ_Handle * mq
Message queue we are providing for the ch.
Handle for a queue.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ mq_cancel()

static void mq_cancel ( struct GNUNET_MQ_Handle mq,
void *  impl_state 
)
static

Implementation function that cancels the currently sent message.

Parameters
mqmessage queue
impl_stateour struct Queue

Definition at line 559 of file gnunet-communicator-unix.c.

References GNUNET_assert, GNUNET_CONTAINER_DLL_remove, GNUNET_SCHEDULER_cancel(), Queue::msg, and queue().

Referenced by setup_queue().

560 {
561  struct Queue *queue = impl_state;
562 
563  GNUNET_assert (NULL != queue->msg);
564  queue->msg = NULL;
566  GNUNET_assert (NULL != write_task);
567  if (NULL == queue_head)
568  {
570  write_task = NULL;
571  }
572 }
#define GNUNET_CONTAINER_DLL_remove(head, tail, element)
Remove an element from a DLL.
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
static struct GNUNET_SCHEDULER_Task * write_task
ID of write task.
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
static struct Queue * queue_head
Head of queue of messages to transmit.
Handle for a queue.
const struct GNUNET_MessageHeader * msg
Message currently scheduled for transmission, non-NULL if and only if this queue is in the queue_head...
static struct Queue * queue_tail
Tail of queue of messages to transmit.
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:966
Here is the call graph for this function:
Here is the caller graph for this function:

◆ mq_error()

static void mq_error ( void *  cls,
enum GNUNET_MQ_Error  error 
)
static

Generic error handler, called with the appropriate error code and the same closure specified at the creation of the message queue.

Not every message queue implementation supports an error handler.

Parameters
clsour struct Queue
errorerror code

Definition at line 585 of file gnunet-communicator-unix.c.

References GNUNET_ERROR_TYPE_ERROR, GNUNET_i2s(), GNUNET_log, queue(), queue_destroy(), and Queue::target.

Referenced by setup_queue().

586 {
587  struct Queue *queue = cls;
588 
590  "UNIX MQ error in queue to %s: %d\n",
591  GNUNET_i2s (&queue->target),
592  (int) error);
593  queue_destroy (queue);
594 }
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
struct GNUNET_PeerIdentity target
To whom are we talking to.
static void queue_destroy(struct Queue *queue)
Functions with this signature are called whenever we need to close a queue due to a disconnect or fai...
Handle for a queue.
#define GNUNET_log(kind,...)
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
Here is the call graph for this function:
Here is the caller graph for this function:

◆ setup_queue()

static struct Queue* setup_queue ( const struct GNUNET_PeerIdentity target,
enum GNUNET_TRANSPORT_ConnectionStatus  cs,
const struct sockaddr_un *  un,
socklen_t  un_len 
)
static

Creates a new outbound queue the transport service will use to send data to another peer.

Parameters
peerthe target peer
csinbound or outbound queue
unthe address
un_lennumber of bytes in un
Returns
the queue or NULL of max connections exceeded

Definition at line 608 of file gnunet-communicator-unix.c.

References Queue::address, Queue::address_len, COMMUNICATOR_ADDRESS_PREFIX, GNUNET_asprintf(), GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT, GNUNET_CONTAINER_MULTIHASHMAPOPTION_MULTIPLE, GNUNET_CONTAINER_multipeermap_put(), GNUNET_CONTAINER_multipeermap_size(), GNUNET_free, GNUNET_memdup, GNUNET_MQ_queue_for_callbacks(), GNUNET_new, GNUNET_NO, GNUNET_NT_LOOPBACK, GNUNET_SCHEDULER_add_delayed(), GNUNET_STATISTICS_set(), GNUNET_TIME_relative_to_absolute(), GNUNET_TRANSPORT_communicator_mq_add(), Queue::mq, mq_cancel(), mq_destroy(), mq_error(), mq_send(), Queue::qh, queue(), queue_timeout(), select_read_cb(), Queue::target, Queue::timeout, Queue::timeout_task, and UNIX_MTU.

Referenced by mq_init(), and select_read_cb().

612 {
613  struct Queue *queue;
614 
615  queue = GNUNET_new (struct Queue);
616  queue->target = *target;
617  queue->address = GNUNET_memdup (un, un_len);
618  queue->address_len = un_len;
620  queue_map,
621  &queue->target,
622  queue,
625  "# queues active",
627  GNUNET_NO);
628  queue->timeout =
630  queue->timeout_task =
632  &queue_timeout,
633  queue);
635  &mq_destroy,
636  &mq_cancel,
637  queue,
638  NULL,
639  &mq_error,
640  queue);
641  {
642  char *foreign_addr;
643 
644  if ('\0' == un->sun_path[0])
645  GNUNET_asprintf (&foreign_addr,
646  "%s-@%s",
648  &un->sun_path[1]);
649  else
650  GNUNET_asprintf (&foreign_addr,
651  "%s-%s",
653  un->sun_path);
655  &queue->target,
656  foreign_addr,
657  UNIX_MTU,
659  cs,
660  queue->mq);
661  GNUNET_free (foreign_addr);
662  }
663  return queue;
664 }
static void mq_send(struct GNUNET_MQ_Handle *mq, const struct GNUNET_MessageHeader *msg, void *impl_state)
Signature of functions implementing the sending functionality of a message queue. ...
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
struct GNUNET_PeerIdentity target
To whom are we talking to.
socklen_t address_len
Length of the address.
static struct GNUNET_TRANSPORT_CommunicatorHandle * ch
Our environment.
struct GNUNET_TIME_Absolute GNUNET_TIME_relative_to_absolute(struct GNUNET_TIME_Relative rel)
Convert relative time to an absolute time in the future.
Definition: time.c:246
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_memdup(buf, size)
Allocate and initialize a block of memory.
#define GNUNET_new(type)
Allocate a struct or union of the given type.
struct GNUNET_MQ_Handle * mq
Message queue we are providing for the ch.
struct GNUNET_SCHEDULER_Task * timeout_task
Queue timeout task.
#define UNIX_MTU
Our MTU.
int GNUNET_asprintf(char **buf, const char *format,...)
Like asprintf, just portable.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1253
#define COMMUNICATOR_ADDRESS_PREFIX
Address prefix used by the communicator.
struct GNUNET_MQ_Handle * GNUNET_MQ_queue_for_callbacks(GNUNET_MQ_SendImpl send, GNUNET_MQ_DestroyImpl destroy, GNUNET_MQ_CancelImpl cancel, void *impl_state, const struct GNUNET_MQ_MessageHandler *handlers, GNUNET_MQ_ErrorHandler error_handler, void *cls)
Create a message queue for the specified handlers.
Definition: mq.c:552
static struct GNUNET_STATISTICS_Handle * stats
For logging statistics.
Handle for a queue.
void GNUNET_STATISTICS_set(struct GNUNET_STATISTICS_Handle *handle, const char *name, uint64_t value, int make_persistent)
Set statistic value for the peer.
static void mq_destroy(struct GNUNET_MQ_Handle *mq, void *impl_state)
Signature of functions implementing the destruction of a message queue.
static void mq_cancel(struct GNUNET_MQ_Handle *mq, void *impl_state)
Implementation function that cancels the currently sent message.
Loopback (same host).
Definition: gnunet_nt_lib.h:45
static void queue_timeout(void *cls)
Queue was idle for too long, so disconnect it.
Allow multiple values with the same key.
#define GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT
After how long do we consider a connection to a peer dead if we don&#39;t receive messages from the peer...
int GNUNET_CONTAINER_multipeermap_put(struct GNUNET_CONTAINER_MultiPeerMap *map, const struct GNUNET_PeerIdentity *key, void *value, enum GNUNET_CONTAINER_MultiHashMapOption opt)
Store a key-value pair in the map.
struct sockaddr * address
Address of the other peer.
static struct GNUNET_CONTAINER_MultiPeerMap * queue_map
Queues (map from peer identity to struct Queue)
enum GNUNET_TRANSPORT_ConnectionStatus cs
Connection status for this queue.
static void mq_error(void *cls, enum GNUNET_MQ_Error error)
Generic error handler, called with the appropriate error code and the same closure specified at the c...
struct GNUNET_TRANSPORT_QueueHandle * GNUNET_TRANSPORT_communicator_mq_add(struct GNUNET_TRANSPORT_CommunicatorHandle *ch, const struct GNUNET_PeerIdentity *peer, const char *address, uint32_t mtu, enum GNUNET_NetworkType nt, enum GNUNET_TRANSPORT_ConnectionStatus cs, struct GNUNET_MQ_Handle *mq)
Notify transport service that a MQ became available due to an "inbound" connection or because the com...
unsigned int GNUNET_CONTAINER_multipeermap_size(const struct GNUNET_CONTAINER_MultiPeerMap *map)
Get the number of key-value pairs in the map.
struct GNUNET_TIME_Absolute timeout
Timeout for this queue.
struct GNUNET_TRANSPORT_QueueHandle * qh
handle for this queue with the ch.
#define GNUNET_free(ptr)
Wrapper around free.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ select_read_cb()

static void select_read_cb ( void *  cls)
static

We have been notified that our socket has something to read.

Do the read and reschedule this function to be called again once more is available.

Parameters
clsNULL

Definition at line 712 of file gnunet-communicator-unix.c.

References _, buf, csize, delivering_messages, GNUNET_ALIGN, GNUNET_assert, GNUNET_break_op, GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_ERROR, GNUNET_ERROR_TYPE_WARNING, GNUNET_log, GNUNET_log_strerror, GNUNET_NETWORK_socket_recvfrom(), GNUNET_NO, GNUNET_SCHEDULER_add_read_net(), GNUNET_SCHEDULER_cancel(), GNUNET_SYSERR, GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_TRANSPORT_communicator_receive(), GNUNET_TRANSPORT_CS_INBOUND, UNIXMessage::header, lookup_queue(), max_queue_length, msg, queue(), receive_complete_cb(), reschedule_queue_timeout(), ret, UNIXMessage::sender, setup_queue(), and GNUNET_MessageHeader::size.

Referenced by receive_complete_cb(), run(), and setup_queue().

713 {
714  char buf[65536] GNUNET_ALIGN;
715  struct Queue *queue;
716  const struct UNIXMessage *msg;
717  struct sockaddr_un un;
718  socklen_t addrlen;
719  ssize_t ret;
720  uint16_t msize;
721 
722  GNUNET_assert (NULL != unix_sock);
724  unix_sock,
726  NULL);
727  addrlen = sizeof(un);
728  memset (&un, 0, sizeof(un));
730  buf,
731  sizeof(buf),
732  (struct sockaddr *) &un,
733  &addrlen);
734  if ((-1 == ret) && ((EAGAIN == errno) || (ENOBUFS == errno)))
735  return;
736  if (-1 == ret)
737  {
739  return;
740  }
742  "Read %d bytes from socket %s\n",
743  (int) ret,
744  un.sun_path);
745  GNUNET_assert (AF_UNIX == (un.sun_family));
746  msg = (struct UNIXMessage *) buf;
747  msize = ntohs (msg->header.size);
748  if ((msize < sizeof(struct UNIXMessage)) || (msize > ret))
749  {
750  GNUNET_break_op (0);
751  return;
752  }
753  queue = lookup_queue (&msg->sender, &un, addrlen);
754  if (NULL == queue)
755  queue =
756  setup_queue (&msg->sender, GNUNET_TRANSPORT_CS_INBOUND, &un, addrlen);
757  else
758  reschedule_queue_timeout (queue);
759  if (NULL == queue)
760  {
761  GNUNET_log (
763  _ (
764  "Maximum number of UNIX connections exceeded, dropping incoming message\n"));
765  return;
766  }
767 
768  {
769  uint16_t offset = 0;
770  uint16_t tsize = msize - sizeof(struct UNIXMessage);
771  const char *msgbuf = (const char *) &msg[1];
772 
773  while (offset + sizeof(struct GNUNET_MessageHeader) <= tsize)
774  {
775  const struct GNUNET_MessageHeader *currhdr;
776  struct GNUNET_MessageHeader al_hdr;
777  uint16_t csize;
778 
779  currhdr = (const struct GNUNET_MessageHeader *) &msgbuf[offset];
780  /* ensure aligned access */
781  memcpy (&al_hdr, currhdr, sizeof(al_hdr));
782  csize = ntohs (al_hdr.size);
783  if ((csize < sizeof(struct GNUNET_MessageHeader)) ||
784  (csize > tsize - offset))
785  {
786  GNUNET_break_op (0);
787  break;
788  }
790  &msg->sender,
791  currhdr,
794  NULL);
795  if (GNUNET_SYSERR == ret)
796  return; /* transport not up */
797  if (GNUNET_NO == ret)
798  break;
800  offset += csize;
801  }
802  }
804  {
805  /* we should try to apply 'back pressure' */
807  read_task = NULL;
808  }
809 }
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
static struct GNUNET_SCHEDULER_Task * read_task
ID of read task.
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
static struct GNUNET_TRANSPORT_CommunicatorHandle * ch
Our environment.
struct GNUNET_MessageHeader header
Message header.
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
static int ret
Return value of the commandline.
Definition: gnunet-abd.c:81
#define GNUNET_NO
Definition: gnunet_common.h:78
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
static void reschedule_queue_timeout(struct Queue *queue)
Increment queue timeout due to activity.
#define _(String)
GNU gettext support macro.
Definition: platform.h:181
#define GNUNET_log_strerror(level, cmd)
Log an error message at log-level &#39;level&#39; that indicates a failure of the command &#39;cmd&#39; with the mess...
UNIX Message-Packet header.
static unsigned int csize
Handle for a queue.
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
static unsigned long long max_queue_length
Maximum queue length before we stop reading towards the transport service.
static void select_read_cb(void *cls)
We have been notified that our socket has something to read.
static char buf[2048]
this is an inbound connection (communicator initiated)
#define GNUNET_TIME_UNIT_FOREVER_REL
Constant used to specify "forever".
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
int GNUNET_TRANSPORT_communicator_receive(struct GNUNET_TRANSPORT_CommunicatorHandle *handle, const struct GNUNET_PeerIdentity *sender, const struct GNUNET_MessageHeader *msg, struct GNUNET_TIME_Relative expected_addr_validity, GNUNET_TRANSPORT_MessageCompletedCallback cb, void *cb_cls)
Notify transport service that the communicator has received a message.
static struct Queue * setup_queue(const struct GNUNET_PeerIdentity *target, enum GNUNET_TRANSPORT_ConnectionStatus cs, const struct sockaddr_un *un, socklen_t un_len)
Creates a new outbound queue the transport service will use to send data to another peer...
#define GNUNET_ALIGN
gcc-ism to force alignment; we use this to align char-arrays that may then be cast to &#39;struct&#39;s...
static struct GNUNET_NETWORK_Handle * unix_sock
socket that we transmit all data with
#define GNUNET_log(kind,...)
Header for all communications.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_read_net(struct GNUNET_TIME_Relative delay, struct GNUNET_NETWORK_Handle *rfd, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay or when the specified file descriptor is ready f...
Definition: scheduler.c:1486
ssize_t GNUNET_NETWORK_socket_recvfrom(const struct GNUNET_NETWORK_Handle *desc, void *buffer, size_t length, struct sockaddr *src_addr, socklen_t *addrlen)
Read data from a socket (always non-blocking).
Definition: network.c:754
struct GNUNET_PeerIdentity sender
What is the identity of the sender (GNUNET_hash of public key)
static void receive_complete_cb(void *cls, int success)
Function called when message was successfully passed to transport service.
static unsigned long long delivering_messages
Number of messages we currently have in our queues towards the transport service. ...
static struct Queue * lookup_queue(const struct GNUNET_PeerIdentity *peer, const struct sockaddr_un *un, socklen_t un_len)
Find an existing queue by address.
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:966
Here is the call graph for this function:
Here is the caller graph for this function:

◆ receive_complete_cb()

static void receive_complete_cb ( void *  cls,
int  success 
)
static

Function called when message was successfully passed to transport service.

Continue read activity.

Parameters
clsNULL
successGNUNET_OK on success

Definition at line 686 of file gnunet-communicator-unix.c.

References delivering_messages, GNUNET_assert, GNUNET_NO, GNUNET_OK, GNUNET_SCHEDULER_add_read_net(), GNUNET_STATISTICS_update(), GNUNET_TIME_UNIT_FOREVER_REL, max_queue_length, and select_read_cb().

Referenced by select_read_cb().

687 {
688  (void) cls;
690  if (GNUNET_OK != success)
692  "# transport transmission failures",
693  1,
694  GNUNET_NO);
695  GNUNET_assert (NULL != unix_sock);
696  if ((NULL == read_task) && (delivering_messages < max_queue_length))
698  unix_sock,
700  NULL);
701 }
static struct GNUNET_SCHEDULER_Task * read_task
ID of read task.
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
static struct GNUNET_STATISTICS_Handle * stats
For logging statistics.
static unsigned long long max_queue_length
Maximum queue length before we stop reading towards the transport service.
static void select_read_cb(void *cls)
We have been notified that our socket has something to read.
#define GNUNET_TIME_UNIT_FOREVER_REL
Constant used to specify "forever".
static struct GNUNET_NETWORK_Handle * unix_sock
socket that we transmit all data with
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_read_net(struct GNUNET_TIME_Relative delay, struct GNUNET_NETWORK_Handle *rfd, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay or when the specified file descriptor is ready f...
Definition: scheduler.c:1486
static unsigned long long delivering_messages
Number of messages we currently have in our queues towards the transport service. ...
Here is the call graph for this function:
Here is the caller graph for this function:

◆ mq_init()

static int mq_init ( void *  cls,
const struct GNUNET_PeerIdentity peer,
const char *  address 
)
static

Function called by the transport service to initialize a message queue given address information about another peer.

If and when the communication channel is established, the communicator must call GNUNET_TRANSPORT_communicator_mq_add() to notify the service that the channel is now up. It is the responsibility of the communicator to manage sane retries and timeouts for any peer/address combination provided by the transport service. Timeouts and retries do not need to be signalled to the transport service.

Parameters
clsclosure
peeridentity of the other peer
addresswhere to send the message, human-readable communicator-specific format, 0-terminated, UTF-8
Returns
GNUNET_OK on success, GNUNET_SYSERR if the provided address is invalid

Definition at line 830 of file gnunet-communicator-unix.c.

References COMMUNICATOR_ADDRESS_PREFIX, GNUNET_break_op, GNUNET_ERROR_TYPE_INFO, GNUNET_free, GNUNET_i2s(), GNUNET_log, GNUNET_NO, GNUNET_OK, GNUNET_SYSERR, GNUNET_TRANSPORT_CS_OUTBOUND, lookup_queue(), queue(), setup_queue(), and unix_address_to_sockaddr().

Referenced by run().

831 {
832  struct Queue *queue;
833  const char *path;
834  struct sockaddr_un *un;
835  socklen_t un_len;
836 
837  (void) cls;
838  if (0 != strncmp (address,
840  strlen (COMMUNICATOR_ADDRESS_PREFIX "-")))
841  {
842  GNUNET_break_op (0);
843  return GNUNET_SYSERR;
844  }
845  path = &address[strlen (COMMUNICATOR_ADDRESS_PREFIX "-")];
846  un = unix_address_to_sockaddr (path, &un_len);
847  queue = lookup_queue (peer, un, un_len);
848  if (NULL != queue)
849  {
851  "Address `%s' for %s ignored, queue exists\n",
852  path,
853  GNUNET_i2s (peer));
854  GNUNET_free (un);
855  return GNUNET_OK;
856  }
857  queue = setup_queue (peer, GNUNET_TRANSPORT_CS_OUTBOUND, un, un_len);
858  GNUNET_free (un);
859  if (NULL == queue)
860  {
862  "Failed to setup queue to %s at `%s'\n",
863  GNUNET_i2s (peer),
864  path);
865  return GNUNET_NO;
866  }
867  return GNUNET_OK;
868 }
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
#define COMMUNICATOR_ADDRESS_PREFIX
Address prefix used by the communicator.
Handle for a queue.
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
static struct sockaddr_un * unix_address_to_sockaddr(const char *unixpath, socklen_t *sock_len)
Convert unix path to a struct sockaddr_un *
static struct Queue * setup_queue(const struct GNUNET_PeerIdentity *target, enum GNUNET_TRANSPORT_ConnectionStatus cs, const struct sockaddr_un *un, socklen_t un_len)
Creates a new outbound queue the transport service will use to send data to another peer...
this is an outbound connection (transport initiated)
#define GNUNET_log(kind,...)
static char * address
GNS address for this phone.
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
static struct Queue * lookup_queue(const struct GNUNET_PeerIdentity *peer, const struct sockaddr_un *un, socklen_t un_len)
Find an existing queue by address.
#define GNUNET_free(ptr)
Wrapper around free.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ get_queue_delete_it()

static int get_queue_delete_it ( void *  cls,
const struct GNUNET_PeerIdentity target,
void *  value 
)
static

Iterator over all message queues to clean up.

Parameters
clsNULL
targetunused
valuethe queue to destroy
Returns
GNUNET_OK to continue to iterate

Definition at line 880 of file gnunet-communicator-unix.c.

References GNUNET_OK, queue(), queue_destroy(), and value.

Referenced by do_shutdown().

883 {
884  struct Queue *queue = value;
885 
886  (void) cls;
887  (void) target;
888  queue_destroy (queue);
889  return GNUNET_OK;
890 }
static void queue(const char *hostname)
Add hostname to the list of requests to be made.
static void queue_destroy(struct Queue *queue)
Functions with this signature are called whenever we need to close a queue due to a disconnect or fai...
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
static char * value
Value of the record to add/remove.
Handle for a queue.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ do_shutdown()

static void do_shutdown ( void *  cls)
static

Shutdown the UNIX communicator.

Parameters
clsNULL (always)

Definition at line 899 of file gnunet-communicator-unix.c.

References get_queue_delete_it(), GNUNET_break, GNUNET_CONTAINER_multipeermap_destroy(), GNUNET_CONTAINER_multipeermap_iterate(), GNUNET_NETWORK_socket_close(), GNUNET_NO, GNUNET_OK, GNUNET_SCHEDULER_cancel(), GNUNET_STATISTICS_destroy(), GNUNET_TRANSPORT_communicator_address_remove(), and GNUNET_TRANSPORT_communicator_disconnect().

Referenced by run().

900 {
901  if (NULL != read_task)
902  {
904  read_task = NULL;
905  }
906  if (NULL != write_task)
907  {
909  write_task = NULL;
910  }
911  if (NULL != unix_sock)
912  {
914  unix_sock = NULL;
915  }
918  if (NULL != ai)
919  {
921  ai = NULL;
922  }
923  if (NULL != ch)
924  {
926  ch = NULL;
927  }
928  if (NULL != stats)
929  {
931  stats = NULL;
932  }
933 }
static struct GNUNET_SCHEDULER_Task * read_task
ID of read task.
static struct GNUNET_TRANSPORT_CommunicatorHandle * ch
Our environment.
static int get_queue_delete_it(void *cls, const struct GNUNET_PeerIdentity *target, void *value)
Iterator over all message queues to clean up.
static struct GNUNET_SCHEDULER_Task * write_task
ID of write task.
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
void GNUNET_STATISTICS_destroy(struct GNUNET_STATISTICS_Handle *h, int sync_first)
Destroy a handle (free all state associated with it).
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
void GNUNET_CONTAINER_multipeermap_destroy(struct GNUNET_CONTAINER_MultiPeerMap *map)
Destroy a hash map.
void GNUNET_TRANSPORT_communicator_disconnect(struct GNUNET_TRANSPORT_CommunicatorHandle *ch)
Disconnect from the transport service.
static struct GNUNET_STATISTICS_Handle * stats
For logging statistics.
void GNUNET_TRANSPORT_communicator_address_remove(struct GNUNET_TRANSPORT_AddressIdentifier *ai)
Notify transport service about an address that this communicator no longer provides for this peer...
static struct GNUNET_TRANSPORT_AddressIdentifier * ai
Handle to the operation that publishes our address.
int GNUNET_CONTAINER_multipeermap_iterate(struct GNUNET_CONTAINER_MultiPeerMap *map, GNUNET_CONTAINER_PeerMapIterator it, void *it_cls)
Iterate over all entries in the map.
static struct GNUNET_CONTAINER_MultiPeerMap * queue_map
Queues (map from peer identity to struct Queue)
static struct GNUNET_NETWORK_Handle * unix_sock
socket that we transmit all data with
int GNUNET_NETWORK_socket_close(struct GNUNET_NETWORK_Handle *desc)
Close a socket.
Definition: network.c:560
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:966
Here is the call graph for this function:
Here is the caller graph for this function:

◆ enc_notify_cb()

static void enc_notify_cb ( void *  cls,
const struct GNUNET_PeerIdentity sender,
const struct GNUNET_MessageHeader msg 
)
static

Function called when the transport service has received an acknowledgement for this communicator (!) via a different return path.

Not applicable for UNIX.

Parameters
clsclosure
senderwhich peer sent the notification
msgpayload

Definition at line 948 of file gnunet-communicator-unix.c.

References GNUNET_break_op.

Referenced by run().

951 {
952  (void) cls;
953  (void) sender;
954  (void) msg;
955  GNUNET_break_op (0);
956 }
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
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

Setup communicator and launch network interactions.

Parameters
clsNULL (always)
argsremaining command-line arguments
cfgfilename of the configuration file used (for saving, can be NULL!)
cfgconfiguration

Definition at line 968 of file gnunet-communicator-unix.c.

References _, COMMUNICATOR_ADDRESS_PREFIX, COMMUNICATOR_CONFIG_SECTION, DEFAULT_MAX_QUEUE_LENGTH, do_shutdown(), enc_notify_cb(), GNUNET_asprintf(), GNUNET_break, GNUNET_CONFIGURATION_get_value_filename(), GNUNET_CONFIGURATION_get_value_number(), GNUNET_CONTAINER_multipeermap_create(), GNUNET_DISK_directory_create_for_file(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_ERROR, GNUNET_free, GNUNET_log, GNUNET_log_config_missing(), GNUNET_log_strerror, GNUNET_log_strerror_file, GNUNET_NETWORK_socket_bind(), GNUNET_NETWORK_socket_close(), GNUNET_NETWORK_socket_create(), GNUNET_NO, GNUNET_NT_LOOPBACK, GNUNET_OK, GNUNET_SCHEDULER_add_read_net(), GNUNET_SCHEDULER_add_shutdown(), GNUNET_SCHEDULER_shutdown(), GNUNET_STATISTICS_create(), GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_TRANSPORT_CC_RELIABLE, GNUNET_TRANSPORT_communicator_address_add(), GNUNET_TRANSPORT_communicator_connect(), max_queue_length, mq_init(), select_read_cb(), and unix_address_to_sockaddr().

Referenced by main().

972 {
973  char *unix_socket_path;
974  struct sockaddr_un *un;
975  socklen_t un_len;
976  char *my_addr;
977 
978  (void) cls;
979 
980  if (GNUNET_OK !=
983  "UNIXPATH",
984  &unix_socket_path))
985  {
988  "UNIXPATH");
989  return;
990  }
991  if (GNUNET_OK !=
994  "MAX_QUEUE_LENGTH",
997 
998  un = unix_address_to_sockaddr (unix_socket_path, &un_len);
999  if (NULL == un)
1000  {
1002  "Failed to setup UNIX domain socket address with path `%s'\n",
1003  unix_socket_path);
1004  GNUNET_free (unix_socket_path);
1005  return;
1006  }
1007  unix_sock = GNUNET_NETWORK_socket_create (AF_UNIX, SOCK_DGRAM, 0);
1008  if (NULL == unix_sock)
1009  {
1011  GNUNET_free (un);
1012  GNUNET_free (unix_socket_path);
1013  return;
1014  }
1015  if (('\0' != un->sun_path[0]) &&
1017  {
1019  _ ("Cannot create path to `%s'\n"),
1020  un->sun_path);
1022  unix_sock = NULL;
1023  GNUNET_free (un);
1024  GNUNET_free (unix_socket_path);
1025  return;
1026  }
1028  (const struct sockaddr *) un,
1029  un_len))
1030  {
1031  GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_ERROR, "bind", un->sun_path);
1033  unix_sock = NULL;
1034  GNUNET_free (un);
1035  GNUNET_free (unix_socket_path);
1036  return;
1037  }
1038  GNUNET_free (un);
1039  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Bound to `%s'\n", unix_socket_path);
1040  stats = GNUNET_STATISTICS_create ("C-UNIX", cfg);
1043  unix_sock,
1044  &select_read_cb,
1045  NULL);
1051  &mq_init,
1052  NULL,
1053  &enc_notify_cb,
1054  NULL);
1055  if (NULL == ch)
1056  {
1057  GNUNET_break (0);
1059  GNUNET_free (unix_socket_path);
1060  return;
1061  }
1062  GNUNET_asprintf (&my_addr,
1063  "%s-%s",
1065  unix_socket_path);
1066  GNUNET_free (unix_socket_path);
1068  my_addr,
1071  GNUNET_free (my_addr);
1072 }
Transmission is reliabile (with ACKs), i.e.
static void do_shutdown(void *cls)
Shutdown the UNIX communicator.
static struct GNUNET_SCHEDULER_Task * read_task
ID of read task.
int GNUNET_CONFIGURATION_get_value_number(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option, unsigned long long *number)
Get a configuration value that should be a number.
static struct GNUNET_TRANSPORT_CommunicatorHandle * ch
Our environment.
struct GNUNET_TRANSPORT_AddressIdentifier * GNUNET_TRANSPORT_communicator_address_add(struct GNUNET_TRANSPORT_CommunicatorHandle *ch, const char *address, enum GNUNET_NetworkType nt, struct GNUNET_TIME_Relative expiration)
Notify transport service about an address that this communicator provides for this peer...
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_shutdown(GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run on shutdown, that is when a CTRL-C signal is received, or when GNUNET_SCHEDULER_shutdown() is being invoked.
Definition: scheduler.c:1300
#define COMMUNICATOR_CONFIG_SECTION
Configuration section used by the communicator.
static int mq_init(void *cls, const struct GNUNET_PeerIdentity *peer, const char *address)
Function called by the transport service to initialize a message queue given address information abou...
struct GNUNET_STATISTICS_Handle * GNUNET_STATISTICS_create(const char *subsystem, const struct GNUNET_CONFIGURATION_Handle *cfg)
Get handle for the statistics service.
int GNUNET_NETWORK_socket_bind(struct GNUNET_NETWORK_Handle *desc, const struct sockaddr *address, socklen_t address_len)
Bind a socket to a particular address.
Definition: network.c:485
int GNUNET_DISK_directory_create_for_file(const char *filename)
Create the directory structure for storing a file.
Definition: disk.c:684
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
void GNUNET_SCHEDULER_shutdown(void)
Request the shutdown of a scheduler.
Definition: scheduler.c:526
struct GNUNET_CONTAINER_MultiPeerMap * GNUNET_CONTAINER_multipeermap_create(unsigned int len, int do_not_copy_keys)
Create a multi peer map (hash map for public keys of peers).
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
#define _(String)
GNU gettext support macro.
Definition: platform.h:181
#define GNUNET_log_strerror(level, cmd)
Log an error message at log-level &#39;level&#39; that indicates a failure of the command &#39;cmd&#39; with the mess...
static void enc_notify_cb(void *cls, const struct GNUNET_PeerIdentity *sender, const struct GNUNET_MessageHeader *msg)
Function called when the transport service has received an acknowledgement for this communicator (!) ...
int GNUNET_asprintf(char **buf, const char *format,...)
Like asprintf, just portable.
#define COMMUNICATOR_ADDRESS_PREFIX
Address prefix used by the communicator.
void GNUNET_log_config_missing(enum GNUNET_ErrorType kind, const char *section, const char *option)
Log error message about missing configuration option.
static struct GNUNET_STATISTICS_Handle * stats
For logging statistics.
#define GNUNET_log_strerror_file(level, cmd, filename)
Log an error message at log-level &#39;level&#39; that indicates a failure of the command &#39;cmd&#39; with the mess...
static unsigned long long max_queue_length
Maximum queue length before we stop reading towards the transport service.
static void select_read_cb(void *cls)
We have been notified that our socket has something to read.
struct GNUNET_TRANSPORT_CommunicatorHandle * GNUNET_TRANSPORT_communicator_connect(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *config_section_name, const char *addr_prefix, enum GNUNET_TRANSPORT_CommunicatorCharacteristics cc, GNUNET_TRANSPORT_CommunicatorMqInit mq_init, void *mq_init_cls, GNUNET_TRANSPORT_CommunicatorNotify notify_cb, void *notify_cb_cls)
Connect to the transport service.
#define GNUNET_TIME_UNIT_FOREVER_REL
Constant used to specify "forever".
static struct GNUNET_TRANSPORT_AddressIdentifier * ai
Handle to the operation that publishes our address.
static struct sockaddr_un * unix_address_to_sockaddr(const char *unixpath, socklen_t *sock_len)
Convert unix path to a struct sockaddr_un *
Loopback (same host).
Definition: gnunet_nt_lib.h:45
static struct GNUNET_CONTAINER_MultiPeerMap * queue_map
Queues (map from peer identity to struct Queue)
static struct GNUNET_NETWORK_Handle * unix_sock
socket that we transmit all data with
#define GNUNET_log(kind,...)
int GNUNET_CONFIGURATION_get_value_filename(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option, char **value)
Get a configuration value that should be the name of a file or directory.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_read_net(struct GNUNET_TIME_Relative delay, struct GNUNET_NETWORK_Handle *rfd, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay or when the specified file descriptor is ready f...
Definition: scheduler.c:1486
#define DEFAULT_MAX_QUEUE_LENGTH
How many messages do we keep at most in the queue to the transport service before we start to drop (d...
int GNUNET_NETWORK_socket_close(struct GNUNET_NETWORK_Handle *desc)
Close a socket.
Definition: network.c:560
#define GNUNET_free(ptr)
Wrapper around free.
struct GNUNET_NETWORK_Handle * GNUNET_NETWORK_socket_create(int domain, int type, int protocol)
Create a new socket.
Definition: network.c:912
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 for the UNIX communicator.

Parameters
argcnumber of arguments from the command line
argvcommand line arguments
Returns
0 ok, 1 on error

Definition at line 1083 of file gnunet-communicator-unix.c.

References _, __attribute__, GNUNET_free, GNUNET_GETOPT_OPTION_END, GNUNET_OK, GNUNET_PROGRAM_run(), GNUNET_STRINGS_get_utf8_args(), ret, and run().

1084 {
1085  static const struct GNUNET_GETOPT_CommandLineOption options[] = {
1087  };
1088  int ret;
1089 
1090  if (GNUNET_OK != GNUNET_STRINGS_get_utf8_args (argc, argv, &argc, &argv))
1091  return 2;
1092 
1093  ret = (GNUNET_OK ==
1094  GNUNET_PROGRAM_run (argc,
1095  argv,
1096  "gnunet-communicator-unix",
1097  _ ("GNUnet UNIX domain socket communicator"),
1098  options,
1099  &run,
1100  NULL))
1101  ? 0
1102  : 1;
1103  GNUNET_free ((void *) argv);
1104  return ret;
1105 }
struct GNUNET_GETOPT_CommandLineOption options[]
Definition: 002.c:5
int GNUNET_STRINGS_get_utf8_args(int argc, char *const *argv, int *u8argc, char *const **u8argv)
Returns utf-8 encoded arguments.
Definition: strings.c:1438
static void run(void *cls, char *const *args, const char *cfgfile, const struct GNUNET_CONFIGURATION_Handle *cfg)
Setup communicator and launch network interactions.
static int ret
Return value of the commandline.
Definition: gnunet-abd.c:81
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
Definition of a command line option.
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_OPTION_END
Definition: 002.c:13
#define _(String)
GNU gettext support macro.
Definition: platform.h:181
int GNUNET_PROGRAM_run(int argc, char *const *argv, const char *binaryName, const char *binaryHelp, const struct GNUNET_GETOPT_CommandLineOption *options, GNUNET_PROGRAM_Main task, void *task_cls)
Run a standard GNUnet command startup sequence (initialize loggers and configuration, parse options).
Definition: program.c:367
#define GNUNET_free(ptr)
Wrapper around free.
Here is the call graph for this function:

Variable Documentation

◆ read_task

struct GNUNET_SCHEDULER_Task* read_task
static

ID of read task.

Definition at line 149 of file gnunet-communicator-unix.c.

◆ write_task

struct GNUNET_SCHEDULER_Task* write_task
static

ID of write task.

Definition at line 154 of file gnunet-communicator-unix.c.

◆ delivering_messages

unsigned long long delivering_messages
static

Number of messages we currently have in our queues towards the transport service.

Definition at line 159 of file gnunet-communicator-unix.c.

Referenced by receive_complete_cb(), and select_read_cb().

◆ max_queue_length

unsigned long long max_queue_length
static

Maximum queue length before we stop reading towards the transport service.

Definition at line 164 of file gnunet-communicator-unix.c.

Referenced by receive_complete_cb(), run(), and select_read_cb().

◆ stats

struct GNUNET_STATISTICS_Handle* stats
static

For logging statistics.

Definition at line 169 of file gnunet-communicator-unix.c.

◆ ch

Our environment.

Definition at line 174 of file gnunet-communicator-unix.c.

◆ queue_map

struct GNUNET_CONTAINER_MultiPeerMap* queue_map
static

Queues (map from peer identity to struct Queue)

Definition at line 179 of file gnunet-communicator-unix.c.

◆ queue_head

struct Queue* queue_head
static

Head of queue of messages to transmit.

Definition at line 184 of file gnunet-communicator-unix.c.

◆ queue_tail

struct Queue* queue_tail
static

Tail of queue of messages to transmit.

Definition at line 189 of file gnunet-communicator-unix.c.

Referenced by select_write_cb().

◆ unix_sock

struct GNUNET_NETWORK_Handle* unix_sock
static

socket that we transmit all data with

Definition at line 194 of file gnunet-communicator-unix.c.

◆ ai