Peer library

Helper library for interning of peer identifiers. More...

Collaboration diagram for Peer library:

Typedefs
typedef unsigned int	GNUNET_PEER_Id
	A GNUNET_PEER_Id is simply a shorter version of a "struct GNUNET_PeerIdentifier" that can be used inside of a GNUnet peer to save memory when the same identifier needs to be used over and over again. More...

Functions
GNUNET_PEER_Id	GNUNET_PEER_search (const struct GNUNET_PeerIdentity *pid)
	Search for a peer identity. More...
GNUNET_PEER_Id	GNUNET_PEER_intern (const struct GNUNET_PeerIdentity *pid)
	Intern an peer identity. More...
void	GNUNET_PEER_change_rc (GNUNET_PEER_Id id, int delta)
	Change the reference counter of an interned PID. More...
void	GNUNET_PEER_decrement_rcs (const GNUNET_PEER_Id *ids, unsigned int count)
	Decrement multiple RCs of peer identities by one. More...
void	GNUNET_PEER_resolve (GNUNET_PEER_Id id, struct GNUNET_PeerIdentity *pid)
	Convert an interned PID to a normal peer identity. More...
const struct GNUNET_PeerIdentity *	GNUNET_PEER_resolve2 (GNUNET_PEER_Id id)
	Convert an interned PID to a normal peer identity. More...

Detailed Description

Helper library for interning of peer identifiers.

Typedef Documentation

GNUNET_PEER_Id

typedef unsigned int GNUNET_PEER_Id

A GNUNET_PEER_Id is simply a shorter version of a "struct GNUNET_PeerIdentifier" that can be used inside of a GNUnet peer to save memory when the same identifier needs to be used over and over again.

Definition at line 60 of file gnunet_peer_lib.h.

Function Documentation

GNUNET_PEER_search()

GNUNET_PEER_Id GNUNET_PEER_search

(

const struct GNUNET_PeerIdentity *

pid

)

Search for a peer identity.

The reference counter is not changed.

Parameters

pid	identity to find

Returns

the interned identity or 0.

Definition at line 84 of file peer.c.

{
  struct PeerEntry *e;
 
  if (NULL == pid)
    return 0;
  if (NULL == map)
    return 0;
  e = GNUNET_CONTAINER_multipeermap_get (map, pid);
  if (NULL == e)
    return 0;
  GNUNET_assert (e->rc > 0);
  return e->pid;
}

References GNUNET_assert, GNUNET_CONTAINER_multipeermap_get(), map, PeerEntry::pid, pid, and PeerEntry::rc.

Here is the call graph for this function:

GNUNET_PEER_intern()

GNUNET_PEER_Id GNUNET_PEER_intern

(

const struct GNUNET_PeerIdentity *

pid

)

Intern an peer identity.

If the identity is already known, its reference counter will be increased by one.

Parameters

pid	identity to intern

Returns

the interned identity.

Definition at line 108 of file peer.c.

{
  GNUNET_PEER_Id ret;
  struct PeerEntry *e;
 
  if (NULL == pid)
    return 0;
  if (NULL == map)
    map = GNUNET_CONTAINER_multipeermap_create (32, GNUNET_YES);
  e = GNUNET_CONTAINER_multipeermap_get (map, pid);
  if (NULL != e)
  {
    GNUNET_assert (e->rc > 0);
    e->rc++;
    return e->pid;
  }
  ret = free_list_start;
  if (ret == size)
  {
    GNUNET_array_grow (table, size, size + 16);
    for (unsigned int i = ret; i < size; i++)
    {
      table[i] = GNUNET_new (struct PeerEntry);
      table[i]->pid = i + 1;
    }
  }
  if (0 == ret)
  {
    memset (&table[0]->id, 0, sizeof(struct GNUNET_PeerIdentity));
    table[0]->pid = 0;
    table[0]->rc = 1;
    ret = 1;
  }
  GNUNET_assert (ret < size);
  GNUNET_assert (0 == table[ret]->rc);
  free_list_start = table[ret]->pid;
  table[ret]->id = *pid;
  table[ret]->rc = 1;
  table[ret]->pid = ret;
  GNUNET_break (GNUNET_OK ==
                GNUNET_CONTAINER_multipeermap_put (map,
                                                   &table[ret]->id,
                                                   table[ret],
                                                   GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_ONLY));
  return ret;
}

References free_list_start, GNUNET_array_grow, GNUNET_assert, GNUNET_break, GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_ONLY, GNUNET_CONTAINER_multipeermap_create(), GNUNET_CONTAINER_multipeermap_get(), GNUNET_CONTAINER_multipeermap_put(), GNUNET_new, GNUNET_OK, GNUNET_YES, PeerEntry::id, map, PeerEntry::pid, pid, PeerEntry::rc, ret, size, and table.

Referenced by add_to_list_tunnels(), create_tunnel(), GSF_peer_connect_handler(), and handle_p2p_get().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_PEER_change_rc()

void GNUNET_PEER_change_rc	(	GNUNET_PEER_Id	id,
		int	delta
	)

Change the reference counter of an interned PID.

Parameters

id	identity to change the RC of
delta	how much to change the RC

Definition at line 192 of file peer.c.

{
  if (0 == id)
    return;
  GNUNET_assert (id < size);
  GNUNET_assert (table[id]->rc > 0);
  GNUNET_assert ((delta >= 0) ||
                 (table[id]->rc >= (unsigned int) (-delta)));
  table[id]->rc += delta;
  if (0 == table[id]->rc)
  {
    GNUNET_break (GNUNET_OK ==
                  GNUNET_CONTAINER_multipeermap_remove (map,
                                                        &table[id]->id,
                                                        table[id]));
    table[id]->pid = free_list_start;
    free_list_start = id;
  }
}

References delta, free_list_start, GNUNET_assert, GNUNET_break, GNUNET_CONTAINER_multipeermap_remove(), GNUNET_OK, id, map, PeerEntry::pid, PeerEntry::rc, size, and table.

Referenced by clean_request(), destroy_tunnel(), GSF_peer_disconnect_handler(), GSF_peer_update_responder_peer_(), remove_from_list_tunnels(), and transmit_content().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_PEER_decrement_rcs()

void GNUNET_PEER_decrement_rcs	(	const GNUNET_PEER_Id *	ids,
		unsigned int	count
	)

Decrement multiple RCs of peer identities by one.

Parameters

ids	array of PIDs to decrement the RCs of
count	size of the ids array

Definition at line 157 of file peer.c.

{
  int i;
  GNUNET_PEER_Id id;
 
  if (0 == count)
    return;
  for (i = count - 1; i >= 0; i--)
  {
    id = ids[i];
    if (0 == id)
      continue;
    GNUNET_assert (id < size);
    GNUNET_assert (table[id]->rc > 0);
    table[id]->rc--;
    if (0 == table[id]->rc)
    {
      GNUNET_break (GNUNET_OK ==
                    GNUNET_CONTAINER_multipeermap_remove (map,
                                                          &table[id]->id,
                                                          table[id]));
      table[id]->pid = free_list_start;
      free_list_start = id;
    }
  }
}

References free_list_start, GNUNET_assert, GNUNET_break, GNUNET_CONTAINER_multipeermap_remove(), GNUNET_OK, id, map, PeerEntry::pid, PeerEntry::rc, size, and table.

Referenced by delete_migration_block(), and GSF_peer_disconnect_handler().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_PEER_resolve()

void GNUNET_PEER_resolve	(	GNUNET_PEER_Id	id,
		struct GNUNET_PeerIdentity *	pid
	)

Convert an interned PID to a normal peer identity.

Parameters

id	interned PID to convert
pid	where to write the normal peer identity

Definition at line 220 of file peer.c.

{
  if (0 == id)
  {
    memset (pid, 0, sizeof(struct GNUNET_PeerIdentity));
    return;
  }
  GNUNET_assert (id < size);
  GNUNET_assert (table[id]->rc > 0);
  *pid = table[id]->id;
}

References GNUNET_assert, id, PeerEntry::id, pid, PeerEntry::rc, size, and table.

Referenced by callback_tunnel_disconnect(), compare_list_tunnels(), find_list_tunnels(), find_list_tunnels_alternate(), flush_respect(), get_tunnel_peer_identity(), GSF_connected_peer_get_identity_(), GSF_dht_lookup_(), GSF_pending_request_get_message_(), GSF_pending_request_test_target_(), handle_p2p_put(), iterate_reset_room(), rebuild_srv_room_basement_structure(), recv_message_peer(), save_list_tunnels(), schedule_transmission(), score_content(), and verify_list_tunnels_flag_token().

Here is the caller graph for this function:

GNUNET_PEER_resolve2()

const struct GNUNET_PeerIdentity * GNUNET_PEER_resolve2

(

GNUNET_PEER_Id

id

)

Convert an interned PID to a normal peer identity.

Parameters

id	interned PID to convert

Returns

pointer to peer identity, valid as long id is valid

Definition at line 234 of file peer.c.

{
  GNUNET_assert (id < size);
  GNUNET_assert (table[id]->rc > 0);
  return &table[id]->id;
}

References GNUNET_assert, id, PeerEntry::id, size, and table.

Referenced by connect_tunnel(), and GSF_connected_peer_get_identity2_().

Here is the caller graph for this function: