#include "gnunet_cadet_service.h"
#include "gnunet_util_lib.h"
#include "gnunet-service-messenger_room.h"
#include "gnunet-service-messenger_message_state.h"

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

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

Data Structures
struct	GNUNET_MESSENGER_SrvTunnel

Functions
struct GNUNET_MESSENGER_SrvTunnel *	create_tunnel (struct GNUNET_MESSENGER_SrvRoom room, const struct GNUNET_PeerIdentity door)
	Creates and allocates a tunnel of a room to a specific peer identity (called door). More...

void	destroy_tunnel (struct GNUNET_MESSENGER_SrvTunnel *tunnel)
	Destroys a tunnel and frees its memory fully. More...

void	bind_tunnel (struct GNUNET_MESSENGER_SrvTunnel tunnel, struct GNUNET_CADET_Channel channel)
	Binds a CADET channel to a tunnel and replaces its channel the tunnel is currently bound to if necessary. More...

enum GNUNET_GenericReturnValue	check_tunnel_message (void cls, const struct GNUNET_MessageHeader header)
	Callback for message verification via header in a tunnel that is provided as a closure from a CADET channel. More...

void	handle_tunnel_message (void cls, const struct GNUNET_MessageHeader header)
	Callback for message handling via header in a tunnel that is provided as a closure from a CADET channel. More...

void	callback_tunnel_disconnect (void cls, const struct GNUNET_CADET_Channel channel)
	Callback for a CADET channel disconnecting to manage this event as a proper tunnel provided as its closure. More...

enum GNUNET_GenericReturnValue	connect_tunnel (struct GNUNET_MESSENGER_SrvTunnel *tunnel)
	Tries to connect a tunnel by creating a new CADET channel and binding it. More...

void	disconnect_tunnel (struct GNUNET_MESSENGER_SrvTunnel *tunnel)
	Disconnects and unbinds a channel from a tunnel. More...

enum GNUNET_GenericReturnValue	is_tunnel_connected (const struct GNUNET_MESSENGER_SrvTunnel *tunnel)
	Returns the status of a currently bound channel of a tunnel. More...

void	send_tunnel_envelope (struct GNUNET_MESSENGER_SrvTunnel tunnel, struct GNUNET_MQ_Envelope env, const struct GNUNET_HashCode *hash)
	Sends an envelope containing a message with a given hash through a tunnel. More...

enum GNUNET_GenericReturnValue	send_tunnel_message (struct GNUNET_MESSENGER_SrvTunnel tunnel, void handle, struct GNUNET_MESSENGER_Message *message)
	Sends a message by packing it automatically into an envelope and passing it through the tunnel. More...

void	forward_tunnel_message (struct GNUNET_MESSENGER_SrvTunnel tunnel, const struct GNUNET_MESSENGER_Message message, const struct GNUNET_HashCode *hash)
	Forwards a given message with a known hash through a tunnel. More...

const struct GNUNET_HashCode *	get_tunnel_peer_message (const struct GNUNET_MESSENGER_SrvTunnel *tunnel)
	Returns the hash of the latest peer message published through a given tunnel and matching the tunnels peer identity. More...

void	get_tunnel_peer_identity (const struct GNUNET_MESSENGER_SrvTunnel tunnel, struct GNUNET_PeerIdentity peer)
	Writes the peer identity of the peer connected via tunnel to this peer into the peer parameter. More...

uint32_t	get_tunnel_messenger_version (const struct GNUNET_MESSENGER_SrvTunnel *tunnel)
	Returns the current messenger version the peer connected via a given tunnel has reported to be using if it was compatible during updating. More...

enum GNUNET_GenericReturnValue	update_tunnel_messenger_version (struct GNUNET_MESSENGER_SrvTunnel *tunnel, uint32_t version)
	Updates the messenger version of the tunnel to a given version if it is compatible to the running peer of the service. More...

Function Documentation

◆ create_tunnel()

struct GNUNET_MESSENGER_SrvTunnel * create_tunnel	(	struct GNUNET_MESSENGER_SrvRoom *	room,
		const struct GNUNET_PeerIdentity *	door
	)

Creates and allocates a tunnel of a room to a specific peer identity (called door).

Parameters

[in,out]	room	Room
[in]	door	Peer identity

Returns: New tunnel

Definition at line 39 of file gnunet-service-messenger_tunnel.c.

{
  struct GNUNET_MESSENGER_SrvTunnel *tunnel;
 
  GNUNET_assert ((room) && (door));
 
  tunnel = GNUNET_new (struct GNUNET_MESSENGER_SrvTunnel);
 
  tunnel->room = room;
  tunnel->channel = NULL;
 
  tunnel->peer = GNUNET_PEER_intern (door);
 
  tunnel->messenger_version = 0;
 
  tunnel->peer_message = NULL;
 
  init_message_state (&(tunnel->state));
 
  return tunnel;
}

References GNUNET_MESSENGER_SrvTunnel::channel, GNUNET_assert, GNUNET_new, GNUNET_PEER_intern(), init_message_state(), GNUNET_MESSENGER_SrvTunnel::messenger_version, GNUNET_MESSENGER_SrvTunnel::peer, GNUNET_MESSENGER_SrvTunnel::peer_message, GNUNET_MESSENGER_SrvTunnel::room, and GNUNET_MESSENGER_SrvTunnel::state.

Referenced by callback_room_connect(), and enter_srv_room_at().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ destroy_tunnel()

void destroy_tunnel ( struct GNUNET_MESSENGER_SrvTunnel * tunnel )

Destroys a tunnel and frees its memory fully.

Parameters

[in,out] tunnel

Definition at line 64 of file gnunet-service-messenger_tunnel.c.

{
  GNUNET_assert (tunnel);
 
  if (tunnel->channel)
    GNUNET_CADET_channel_destroy (tunnel->channel);
 
  GNUNET_PEER_change_rc (tunnel->peer, -1);
 
  if (tunnel->peer_message)
    GNUNET_free (tunnel->peer_message);
 
  clear_message_state (&(tunnel->state));
 
  GNUNET_free (tunnel);
}

References GNUNET_MESSENGER_SrvTunnel::channel, clear_message_state(), GNUNET_assert, GNUNET_CADET_channel_destroy(), GNUNET_free, GNUNET_PEER_change_rc(), GNUNET_MESSENGER_SrvTunnel::peer, GNUNET_MESSENGER_SrvTunnel::peer_message, and GNUNET_MESSENGER_SrvTunnel::state.

Here is the call graph for this function:

◆ bind_tunnel()

void bind_tunnel	(	struct GNUNET_MESSENGER_SrvTunnel *	tunnel,
		struct GNUNET_CADET_Channel *	channel
	)

Binds a CADET channel to a tunnel and replaces its channel the tunnel is currently bound to if necessary.

Parameters

[in,out]	tunnel	Tunnel
[in,out]	channel	CADET channel

Definition at line 83 of file gnunet-service-messenger_tunnel.c.

{
  GNUNET_assert (tunnel);
 
  if (tunnel->channel)
    delayed_disconnect_channel (tunnel->channel);
 
  tunnel->channel = channel;
}

References GNUNET_MESSENGER_SrvTunnel::channel, delayed_disconnect_channel(), and GNUNET_assert.

Referenced by callback_room_connect().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ check_tunnel_message()

enum GNUNET_GenericReturnValue check_tunnel_message	(	void *	cls,
		const struct GNUNET_MessageHeader *	header
	)

Callback for message verification via header in a tunnel that is provided as a closure from a CADET channel.

Parameters

[in,out]	cls	Closure
[in]	header	Message header

Definition at line 198 of file gnunet-service-messenger_tunnel.c.

{
  struct GNUNET_MESSENGER_SrvTunnel *tunnel;
  struct GNUNET_MESSENGER_Message message;
  struct GNUNET_HashCode hash;
  uint16_t length;
  const char *buffer;
 
  GNUNET_assert (header);
  
  tunnel = cls;
 
  if (! tunnel)
    return GNUNET_SYSERR;
 
  length = ntohs (header->size) - sizeof(*header);
  buffer = (const char*) &header[1];
 
  if (length < get_message_kind_size (GNUNET_MESSENGER_KIND_UNKNOWN,
                                      GNUNET_YES))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
                "Tunnel error: Message too short! (%d)\n", length);
    return GNUNET_SYSERR;
  }
 
  {
    uint16_t padding;
    padding = 0;
 
    if (GNUNET_YES != decode_message (&message, length, buffer, GNUNET_YES,
                                      &padding))
    {
      GNUNET_log (GNUNET_ERROR_TYPE_WARNING, "Tunnel error: Decoding failed!\n");
      return GNUNET_SYSERR;
    }
 
    hash_message (&message, length - padding, buffer, &hash);
  }
 
  return verify_tunnel_message (tunnel->room, &message, &hash);
}

References decode_message(), get_message_kind_size(), GNUNET_assert, GNUNET_ERROR_TYPE_WARNING, GNUNET_log, GNUNET_MESSENGER_KIND_UNKNOWN, GNUNET_SYSERR, GNUNET_YES, hash_message(), GNUNET_MESSENGER_SrvTunnel::room, GNUNET_MessageHeader::size, and verify_tunnel_message().

Here is the call graph for this function:

◆ handle_tunnel_message()

void handle_tunnel_message	(	void *	cls,
		const struct GNUNET_MessageHeader *	header
	)

Callback for message handling via header in a tunnel that is provided as a closure from a CADET channel.

Parameters

[in,out]	cls	Closure
[in]	header	Message header

Definition at line 284 of file gnunet-service-messenger_tunnel.c.

{
  struct GNUNET_MESSENGER_SrvTunnel *tunnel;
  struct GNUNET_MESSENGER_Message message;
  struct GNUNET_HashCode hash;
  uint16_t length;
  const char *buffer;
 
  GNUNET_assert (header);
  
  tunnel = cls;
 
  if (! tunnel)
    return;
 
  length = ntohs (header->size) - sizeof(*header);
  buffer = (const char*) &header[1];
 
  {
    uint16_t padding;
    padding = 0;
 
    decode_message (&message, length, buffer, GNUNET_YES, &padding);
    hash_message (&message, length - padding, buffer, &hash);
  }
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Got message of kind: %s!\n",
              GNUNET_MESSENGER_name_of_kind (message.header.kind));
 
  {
    enum GNUNET_GenericReturnValue new_message;
    new_message = update_room_message (tunnel->room,
                                      copy_message (&message),
                                      &hash);
 
    if (GNUNET_YES != new_message)
      goto receive_done;
  }
 
  update_tunnel_last_message (tunnel, &hash);
 
  {
    enum GNUNET_GenericReturnValue forward_message;
    forward_message = GNUNET_YES;
 
    switch (message.header.kind)
    {
    case GNUNET_MESSENGER_KIND_INFO:
      forward_message = recv_message_info (tunnel->room, tunnel, &message, &hash);
      break;
    case GNUNET_MESSENGER_KIND_PEER:
      forward_message = recv_message_peer (tunnel->room, tunnel, &message, &hash);
      break;
    case GNUNET_MESSENGER_KIND_MISS:
      forward_message = recv_message_miss (tunnel->room, tunnel, &message, &hash);
      break;
    case GNUNET_MESSENGER_KIND_REQUEST:
      forward_message = recv_message_request (tunnel->room, tunnel, &message,
                                              &hash);
      break;
    default:
      break;
    }
 
    if (GNUNET_YES == forward_message)
    {
      forward_srv_room_message (tunnel->room, tunnel, &message, &hash);
      callback_room_handle_message (tunnel->room, &message, &hash);
    }
  }
 
receive_done:
  cleanup_message (&message);
 
  GNUNET_CADET_receive_done (tunnel->channel);
}

References callback_room_handle_message(), GNUNET_MESSENGER_SrvTunnel::channel, cleanup_message(), copy_message(), decode_message(), forward_srv_room_message(), GNUNET_assert, GNUNET_CADET_receive_done(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, GNUNET_MESSENGER_KIND_INFO, GNUNET_MESSENGER_KIND_MISS, GNUNET_MESSENGER_KIND_PEER, GNUNET_MESSENGER_KIND_REQUEST, GNUNET_MESSENGER_name_of_kind(), GNUNET_YES, hash_message(), GNUNET_MESSENGER_Message::header, GNUNET_MESSENGER_MessageHeader::kind, recv_message_info(), recv_message_miss(), recv_message_peer(), recv_message_request(), GNUNET_MESSENGER_SrvTunnel::room, GNUNET_MessageHeader::size, update_room_message(), and update_tunnel_last_message().

Here is the call graph for this function:

◆ callback_tunnel_disconnect()

void callback_tunnel_disconnect	(	void *	cls,
		const struct GNUNET_CADET_Channel *	channel
	)

Callback for a CADET channel disconnecting to manage this event as a proper tunnel provided as its closure.

Parameters

[in,out]	cls	Closure
[in]	channel	CADET channel

Definition at line 96 of file gnunet-service-messenger_tunnel.c.

{
  struct GNUNET_MESSENGER_SrvTunnel *tunnel;
  struct GNUNET_MESSENGER_SrvRoom *room;
  struct GNUNET_PeerIdentity identity;
  
  tunnel = cls;
 
  if (! tunnel)
    return;
  
  tunnel->channel = NULL;
 
  GNUNET_assert (tunnel->room);
 
  room = tunnel->room;
 
  if (! room->host)
    return;
 
  get_tunnel_peer_identity (tunnel, &identity);
 
  if ((GNUNET_YES != GNUNET_CONTAINER_multipeermap_remove (room->tunnels,
                                                           &identity,
                                                           tunnel)) ||
      (GNUNET_YES == GNUNET_CONTAINER_multipeermap_contains (room->tunnels,
                                                             &identity)))
    return;
 
  if (GNUNET_YES == contains_list_tunnels (&(room->basement), &identity))
    send_srv_room_message (room, room->host, create_message_miss (&identity));
 
  if ((0 < GNUNET_CONTAINER_multipeermap_size (room->tunnels)) ||
      (GNUNET_NO == room->service->auto_connecting))
    return;
 
  {
    struct GNUNET_MESSENGER_ListTunnel *element;
    element = find_list_tunnels_alternate (&(room->basement), &identity);
 
    if (! element)
      return;
 
    GNUNET_PEER_resolve (element->peer, &identity);
  }
 
  enter_srv_room_at (room, room->host, &identity);
}

References GNUNET_MESSENGER_Service::auto_connecting, GNUNET_MESSENGER_SrvRoom::basement, GNUNET_MESSENGER_SrvTunnel::channel, contains_list_tunnels(), create_message_miss(), enter_srv_room_at(), find_list_tunnels_alternate(), get_tunnel_peer_identity(), GNUNET_assert, GNUNET_CONTAINER_multipeermap_contains(), GNUNET_CONTAINER_multipeermap_remove(), GNUNET_CONTAINER_multipeermap_size(), GNUNET_NO, GNUNET_PEER_resolve(), GNUNET_YES, GNUNET_MESSENGER_SrvRoom::host, identity, GNUNET_MESSENGER_ListTunnel::peer, GNUNET_MESSENGER_SrvTunnel::room, send_srv_room_message(), GNUNET_MESSENGER_SrvRoom::service, and GNUNET_MESSENGER_SrvRoom::tunnels.

Referenced by connect_tunnel(), and open_srv_room().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ connect_tunnel()

enum GNUNET_GenericReturnValue connect_tunnel ( struct GNUNET_MESSENGER_SrvTunnel * tunnel )

Tries to connect a tunnel by creating a new CADET channel and binding it.

The function returns GNUNET_YES on success, otherwise GNUNET_NO.

Parameters

[in,out] tunnel Tunnel

Returns: GNUNET_YES on success, otherwise GNUNET_NO

Definition at line 363 of file gnunet-service-messenger_tunnel.c.

{
  const struct GNUNET_PeerIdentity *door;
  struct GNUNET_CADET_Handle *cadet;
  const struct GNUNET_HashCode *key;
 
 
  GNUNET_assert (tunnel);
 
  if (tunnel->channel)
    return GNUNET_NO;
 
  door = GNUNET_PEER_resolve2 (tunnel->peer);
  cadet = get_srv_room_cadet (tunnel->room);
  key = get_srv_room_key (tunnel->room);
 
  {
    struct GNUNET_HashCode port;
    struct GNUNET_MQ_MessageHandler handlers[] = { GNUNET_MQ_hd_var_size (
                                                    tunnel_message,
                                                    GNUNET_MESSAGE_TYPE_CADET_CLI,
                                                    struct
                                                    GNUNET_MessageHeader, NULL),
                                                  GNUNET_MQ_handler_end () };
    
    convert_messenger_key_to_port (key, &port);
    tunnel->channel = GNUNET_CADET_channel_create (cadet, tunnel, door, &port,
                                                  NULL,
                                                  callback_tunnel_disconnect,
                                                  handlers);
  }
 
  return GNUNET_YES;
}

References cadet, callback_tunnel_disconnect(), GNUNET_MESSENGER_SrvTunnel::channel, convert_messenger_key_to_port(), get_srv_room_cadet(), get_srv_room_key(), GNUNET_assert, GNUNET_CADET_channel_create(), GNUNET_MESSAGE_TYPE_CADET_CLI, GNUNET_MQ_handler_end, GNUNET_MQ_hd_var_size, GNUNET_NO, GNUNET_PEER_resolve2(), GNUNET_YES, handlers, key, GNUNET_MESSENGER_SrvTunnel::peer, port, and GNUNET_MESSENGER_SrvTunnel::room.

Referenced by enter_srv_room_at(), and rebuild_srv_room_basement_structure().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ disconnect_tunnel()

void disconnect_tunnel ( struct GNUNET_MESSENGER_SrvTunnel * tunnel )

Disconnects and unbinds a channel from a tunnel.

The actual disconnection will be asynchronous.

Parameters

[in,out] tunnel Tunnel

Definition at line 400 of file gnunet-service-messenger_tunnel.c.

{
  GNUNET_assert (tunnel);
 
  if (tunnel->channel)
  {
    delayed_disconnect_channel (tunnel->channel);
 
    tunnel->channel = NULL;
  }
}

References GNUNET_MESSENGER_SrvTunnel::channel, delayed_disconnect_channel(), and GNUNET_assert.

Referenced by callback_room_connect(), rebuild_srv_room_basement_structure(), and recv_message_info().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ is_tunnel_connected()

enum GNUNET_GenericReturnValue is_tunnel_connected ( const struct GNUNET_MESSENGER_SrvTunnel * tunnel )

Returns the status of a currently bound channel of a tunnel.

Parameters

[in] tunnel Tunnel

Returns: GNUNET_YES or GNUNET_NO

Definition at line 414 of file gnunet-service-messenger_tunnel.c.

{
  GNUNET_assert (tunnel);
 
  return (tunnel->channel ? GNUNET_YES : GNUNET_NO);
}

References GNUNET_MESSENGER_SrvTunnel::channel, GNUNET_assert, GNUNET_NO, and GNUNET_YES.

Referenced by iterate_send_room_message(), and send_room_info().

Here is the caller graph for this function:

◆ send_tunnel_envelope()

void send_tunnel_envelope	(	struct GNUNET_MESSENGER_SrvTunnel *	tunnel,
		struct GNUNET_MQ_Envelope *	env,
		const struct GNUNET_HashCode *	hash
	)

Sends an envelope containing a message with a given hash through a tunnel.

Parameters

[in,out]	tunnel	Tunnel
[in,out]	env	Envelope
[in]	hash	Hash of message

Definition at line 445 of file gnunet-service-messenger_tunnel.c.

{
  struct GNUNET_MQ_Handle *mq;
  struct GNUNET_MESSENGER_MessageSent *sent;
 
  GNUNET_assert ((tunnel) && (env) && (hash));
 
  mq = GNUNET_CADET_get_mq (tunnel->channel);
  sent = GNUNET_new (struct GNUNET_MESSENGER_MessageSent);
 
  GNUNET_memcpy (&(sent->hash), hash, sizeof(struct GNUNET_HashCode));
 
  sent->tunnel = tunnel;
 
  GNUNET_MQ_notify_sent (env, callback_tunnel_sent, sent);
  GNUNET_MQ_send (mq, env);
}

References callback_tunnel_sent(), GNUNET_MESSENGER_SrvTunnel::channel, env, GNUNET_assert, GNUNET_CADET_get_mq(), GNUNET_memcpy, GNUNET_MQ_notify_sent(), GNUNET_MQ_send(), GNUNET_new, GNUNET_MESSENGER_MessageSent::hash, mq, and GNUNET_MESSENGER_MessageSent::tunnel.

Referenced by forward_tunnel_message(), iterate_send_room_message(), and send_tunnel_message().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ send_tunnel_message()

enum GNUNET_GenericReturnValue send_tunnel_message	(	struct GNUNET_MESSENGER_SrvTunnel *	tunnel,
		void *	handle,
		struct GNUNET_MESSENGER_Message *	message
	)

Sends a message by packing it automatically into an envelope and passing it through the tunnel.

The used handle will sign the message and the hash will be calculated and stored.

Parameters

[in,out]	tunnel	Tunnel
[in,out]	handle	Handle
[in,out]	message	Message

Returns: GNUNET_YES on success, GNUNET_NO otherwise

Definition at line 467 of file gnunet-service-messenger_tunnel.c.

{
  struct GNUNET_HashCode hash;
  struct GNUNET_MQ_Envelope *env;
 
  GNUNET_assert ((tunnel) && (handle));
 
  if (! message)
    return GNUNET_NO;
 
  env = pack_srv_room_message (
    tunnel->room, (struct GNUNET_MESSENGER_SrvHandle*) handle,
    message, &hash, GNUNET_MESSENGER_PACK_MODE_ENVELOPE
    );
 
  destroy_message (message);
 
  if (! env)
    return GNUNET_NO;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Sending tunnel message: %s\n",
              GNUNET_h2s (&hash));
 
  send_tunnel_envelope (tunnel, env, &hash);
  return GNUNET_YES;
}

References destroy_message(), env, GNUNET_assert, GNUNET_ERROR_TYPE_DEBUG, GNUNET_h2s(), GNUNET_log, GNUNET_MESSENGER_PACK_MODE_ENVELOPE, GNUNET_NO, GNUNET_YES, handle, pack_srv_room_message(), GNUNET_MESSENGER_SrvTunnel::room, and send_tunnel_envelope().

Referenced by recv_message_info(), and send_room_info().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ forward_tunnel_message()

void forward_tunnel_message	(	struct GNUNET_MESSENGER_SrvTunnel *	tunnel,
		const struct GNUNET_MESSENGER_Message *	message,
		const struct GNUNET_HashCode *	hash
	)

Forwards a given message with a known hash through a tunnel.

Parameters

[in,out]	tunnel	Tunnel
[in]	message	Message
[in]	hash	Hash of message

Definition at line 498 of file gnunet-service-messenger_tunnel.c.

{
  struct GNUNET_MESSENGER_Message *copy;
  struct GNUNET_MQ_Envelope *env;
 
  GNUNET_assert ((tunnel) && (message) && (hash));
 
  copy = copy_message (message);
  env = pack_message (copy, NULL, NULL, GNUNET_MESSENGER_PACK_MODE_ENVELOPE,
                      NULL);
 
  destroy_message (copy);
 
  if (! env)
    return;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Forwarding tunnel message: %s\n",
              GNUNET_h2s (hash));
 
  send_tunnel_envelope (tunnel, env, hash);
}

References copy_message(), destroy_message(), env, GNUNET_assert, GNUNET_ERROR_TYPE_DEBUG, GNUNET_h2s(), GNUNET_log, GNUNET_MESSENGER_PACK_MODE_ENVELOPE, pack_message(), and send_tunnel_envelope().

Referenced by callback_found_message(), check_srv_room_peer_status(), forward_about_members(), and recv_message_info().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get_tunnel_peer_message()

const struct GNUNET_HashCode * get_tunnel_peer_message ( const struct GNUNET_MESSENGER_SrvTunnel * tunnel )

Returns the hash of the latest peer message published through a given tunnel and matching the tunnels peer identity.

If no peer message has been linked to the tunnel yet, NULL gets returned.

Parameters

[in] tunnel Tunnel

Returns: Hash of peer message or NULL

Definition at line 524 of file gnunet-service-messenger_tunnel.c.

{
  GNUNET_assert (tunnel);
 
  return tunnel->peer_message;
}

References GNUNET_assert, and GNUNET_MESSENGER_SrvTunnel::peer_message.

◆ get_tunnel_peer_identity()

void get_tunnel_peer_identity	(	const struct GNUNET_MESSENGER_SrvTunnel *	tunnel,
		struct GNUNET_PeerIdentity *	peer
	)

Writes the peer identity of the peer connected via tunnel to this peer into the peer parameter.

Parameters

[in]	tunnel	Tunnel
[out]	peer	Peer identity

Definition at line 533 of file gnunet-service-messenger_tunnel.c.

{
  GNUNET_assert (tunnel);
 
  GNUNET_PEER_resolve (tunnel->peer, peer);
}

References GNUNET_assert, GNUNET_PEER_resolve(), and GNUNET_MESSENGER_SrvTunnel::peer.

Referenced by callback_tunnel_disconnect(), and recv_message_info().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get_tunnel_messenger_version()

uint32_t get_tunnel_messenger_version ( const struct GNUNET_MESSENGER_SrvTunnel * tunnel )

Returns the current messenger version the peer connected via a given tunnel has reported to be using if it was compatible during updating.

See also: update_tunnel_messenger_version

Parameters

[in] tunnel Tunnel

Returns: Version of messenger

Definition at line 543 of file gnunet-service-messenger_tunnel.c.

{
  GNUNET_assert (tunnel);
 
  return tunnel->messenger_version;
}

References GNUNET_assert, and GNUNET_MESSENGER_SrvTunnel::messenger_version.

Referenced by iterate_send_room_message(), and recv_message_info().

Here is the caller graph for this function:

◆ update_tunnel_messenger_version()

enum GNUNET_GenericReturnValue update_tunnel_messenger_version	(	struct GNUNET_MESSENGER_SrvTunnel *	tunnel,
		uint32_t	version
	)

Updates the messenger version of the tunnel to a given version if it is compatible to the running peer of the service.

Depending on success it returns GNUNET_OK or GNUNET_SYSERR on failure.

Parameters

[in,out]	tunnel	Tunnel
[in]	version	Version of messenger

Returns: GNUNET_OK on success, otherwise GNUNET_SYSERR

Definition at line 552 of file gnunet-service-messenger_tunnel.c.

{
  GNUNET_assert (tunnel);
 
  if (version != GNUNET_MESSENGER_VERSION)
    return GNUNET_SYSERR;
 
  if (version > tunnel->messenger_version)
    tunnel->messenger_version = version;
 
  return GNUNET_OK;
}

References GNUNET_assert, GNUNET_MESSENGER_VERSION, GNUNET_OK, GNUNET_SYSERR, and GNUNET_MESSENGER_SrvTunnel::messenger_version.

Referenced by recv_message_info().

Here is the caller graph for this function:

Data Structures

Functions

Function Documentation

◆ create_tunnel()

◆ destroy_tunnel()

◆ bind_tunnel()

◆ check_tunnel_message()

◆ handle_tunnel_message()

◆ callback_tunnel_disconnect()

◆ connect_tunnel()

◆ disconnect_tunnel()

◆ is_tunnel_connected()

◆ send_tunnel_envelope()

◆ send_tunnel_message()

◆ forward_tunnel_message()

◆ get_tunnel_peer_message()

◆ get_tunnel_peer_identity()

◆ get_tunnel_messenger_version()

◆ update_tunnel_messenger_version()