messenger_api_message_kind.h File Reference

#include "gnunet_messenger_service.h"
#include "gnunet_reclaim_service.h"
#include "gnunet_util_lib.h"

Include dependency graph for messenger_api_message_kind.h:

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

Go to the source code of this file.

Functions
struct GNUNET_MESSENGER_Message *	create_message_join (const struct GNUNET_CRYPTO_PrivateKey *key)
	Creates and allocates a new join message containing the clients public key. More...
struct GNUNET_MESSENGER_Message *	create_message_leave ()
	Creates and allocates a new leave message. More...
struct GNUNET_MESSENGER_Message *	create_message_name (const char *name)
	Creates and allocates a new name message containing the name to change to. More...
struct GNUNET_MESSENGER_Message *	create_message_key (const struct GNUNET_CRYPTO_PrivateKey *key)
	Creates and allocates a new key message containing the public key to change to derived from its private counterpart. More...
struct GNUNET_MESSENGER_Message *	create_message_id (const struct GNUNET_ShortHashCode *unique_id)
	Creates and allocates a new id message containing the unique member id to change to. More...
struct GNUNET_MESSENGER_Message *	create_message_request (const struct GNUNET_HashCode *hash)
	Creates and allocates a new request message containing the hash of a missing message. More...
struct GNUNET_MESSENGER_Message *	create_message_invite (const struct GNUNET_PeerIdentity *door, const struct GNUNET_HashCode *key)
	Creates and allocates a new invite message containing the peer identity of an entrance peer to a room using a given key as shared secret for communication. More...
struct GNUNET_MESSENGER_Message *	create_message_text (const char *text)
	Creates and allocates a new text message containing a string representing text. More...
struct GNUNET_MESSENGER_Message *	create_message_delete (const struct GNUNET_HashCode *hash, const struct GNUNET_TIME_Relative delay)
	Creates and allocates a new delete message containing the hash of a message to delete after a specific delay. More...
struct GNUNET_MESSENGER_Message *	create_message_ticket (const struct GNUNET_RECLAIM_Ticket *ticket)
	Creates and allocates a new ticket message containing the identifier of a ticket to exchange it with a given audience. More...

Function Documentation

create_message_join()

struct GNUNET_MESSENGER_Message * create_message_join

(

const struct GNUNET_CRYPTO_PrivateKey *

key

)

Creates and allocates a new join message containing the clients public key.

(all values are stored as copy)

Parameters

[in]

key

Private key

Returns

New message

Definition at line 31 of file messenger_api_message_kind.c.

{
  if (! key)
    return NULL;
 
  struct GNUNET_MESSENGER_Message *message = create_message (
    GNUNET_MESSENGER_KIND_JOIN);
 
  if (! message)
    return NULL;
 
  GNUNET_CRYPTO_key_get_public (key, &(message->body.join.key));
  return message;
}

References GNUNET_MESSENGER_Message::body, create_message(), GNUNET_CRYPTO_key_get_public(), GNUNET_MESSENGER_KIND_JOIN, GNUNET_MESSENGER_MessageBody::join, key, and GNUNET_MESSENGER_MessageJoin::key.

Referenced by handle_member_id().

Here is the call graph for this function:

Here is the caller graph for this function:

create_message_leave()

struct GNUNET_MESSENGER_Message * create_message_leave

(

)

Creates and allocates a new leave message.

Returns

New message

Definition at line 48 of file messenger_api_message_kind.c.

{
  return create_message (GNUNET_MESSENGER_KIND_LEAVE);
}

References create_message(), and GNUNET_MESSENGER_KIND_LEAVE.

Referenced by GNUNET_MESSENGER_close_room().

Here is the call graph for this function:

Here is the caller graph for this function:

create_message_name()

struct GNUNET_MESSENGER_Message * create_message_name

(

const char *

name

)

Creates and allocates a new name message containing the name to change to.

(all values are stored as copy)

Parameters

[in]

name

New name

Returns

New message

Definition at line 55 of file messenger_api_message_kind.c.

{
  if (! name)
    return NULL;
 
  struct GNUNET_MESSENGER_Message *message = create_message (
    GNUNET_MESSENGER_KIND_NAME);
 
  if (! message)
    return NULL;
 
  message->body.name.name = GNUNET_strdup (name);
  return message;
}

References GNUNET_MESSENGER_Message::body, create_message(), GNUNET_MESSENGER_KIND_NAME, GNUNET_strdup, name, GNUNET_MESSENGER_MessageName::name, and GNUNET_MESSENGER_MessageBody::name.

Referenced by iterate_send_name_to_room().

Here is the call graph for this function:

Here is the caller graph for this function:

create_message_key()

struct GNUNET_MESSENGER_Message * create_message_key

(

const struct GNUNET_CRYPTO_PrivateKey *

key

)

Creates and allocates a new key message containing the public key to change to derived from its private counterpart.

(all values are stored as copy)

Parameters

[in]

key

Private key

Returns

New message

Definition at line 72 of file messenger_api_message_kind.c.

{
  if (! key)
    return NULL;
 
  struct GNUNET_MESSENGER_Message *message = create_message (
    GNUNET_MESSENGER_KIND_KEY);
 
  if (! message)
    return NULL;
 
  GNUNET_CRYPTO_key_get_public (key, &(message->body.key.key));
  return message;
}

References GNUNET_MESSENGER_Message::body, create_message(), GNUNET_CRYPTO_key_get_public(), GNUNET_MESSENGER_KIND_KEY, key, GNUNET_MESSENGER_MessageKey::key, and GNUNET_MESSENGER_MessageBody::key.

Referenced by iterate_send_key_to_room().

Here is the call graph for this function:

Here is the caller graph for this function:

create_message_id()

struct GNUNET_MESSENGER_Message * create_message_id

(

const struct GNUNET_ShortHashCode *

unique_id

)

Creates and allocates a new id message containing the unique member id to change to.

(all values are stored as copy)

Parameters

[in]

unique_id

Unique member id

Returns

New message

Definition at line 89 of file messenger_api_message_kind.c.

{
  if (! unique_id)
    return NULL;
 
  struct GNUNET_MESSENGER_Message *message = create_message (
    GNUNET_MESSENGER_KIND_ID);
 
  if (! message)
    return NULL;
 
  GNUNET_memcpy (&(message->body.id.id), unique_id, sizeof(struct
                                                           GNUNET_ShortHashCode)
                 );
 
  return message;
}

References GNUNET_MESSENGER_Message::body, create_message(), GNUNET_memcpy, GNUNET_MESSENGER_KIND_ID, GNUNET_MESSENGER_MessageId::id, and GNUNET_MESSENGER_MessageBody::id.

Referenced by handle_member_id().

Here is the call graph for this function:

Here is the caller graph for this function:

create_message_request()

struct GNUNET_MESSENGER_Message * create_message_request

(

const struct GNUNET_HashCode *

hash

)

Creates and allocates a new request message containing the hash of a missing message.

(all values are stored as copy)

Parameters

[in]

hash

Hash of message

Returns

New message

Definition at line 109 of file messenger_api_message_kind.c.

{
  if (! hash)
    return NULL;
 
  struct GNUNET_HashCode zero;
  memset (&zero, 0, sizeof(zero));
 
  if (0 == GNUNET_CRYPTO_hash_cmp (hash, &zero))
    return NULL;
 
  struct GNUNET_MESSENGER_Message *message = create_message (
    GNUNET_MESSENGER_KIND_REQUEST);
 
  if (! message)
    return NULL;
 
  GNUNET_memcpy (&(message->body.request.hash), hash, sizeof(struct
                                                             GNUNET_HashCode));
 
  return message;
}

References GNUNET_MESSENGER_Message::body, create_message(), GNUNET_CRYPTO_hash_cmp(), GNUNET_memcpy, GNUNET_MESSENGER_KIND_REQUEST, GNUNET_MESSENGER_MessageRequest::hash, GNUNET_MESSENGER_MessageBody::request, and zero.

Referenced by handle_miss_message().

Here is the call graph for this function:

Here is the caller graph for this function:

create_message_invite()

struct GNUNET_MESSENGER_Message * create_message_invite	(	const struct GNUNET_PeerIdentity *	door,
		const struct GNUNET_HashCode *	key
	)

Creates and allocates a new invite message containing the peer identity of an entrance peer to a room using a given key as shared secret for communication.

(all values are stored as copy)

Parameters

[in]	door	Peer identity
[in]	key	Shared secret of a room

Returns

New message

Definition at line 134 of file messenger_api_message_kind.c.

{
  if ((! door) || (! key))
    return NULL;
 
  struct GNUNET_MESSENGER_Message *message = create_message (
    GNUNET_MESSENGER_KIND_INVITE);
 
  if (! message)
    return NULL;
 
  GNUNET_memcpy (&(message->body.invite.door), door, sizeof(struct
                                                            GNUNET_PeerIdentity)
                 );
  GNUNET_memcpy (&(message->body.invite.key), key, sizeof(struct
                                                          GNUNET_HashCode));
 
  return message;
}

References GNUNET_MESSENGER_Message::body, create_message(), GNUNET_MESSENGER_MessageInvite::door, GNUNET_memcpy, GNUNET_MESSENGER_KIND_INVITE, GNUNET_MESSENGER_MessageBody::invite, key, and GNUNET_MESSENGER_MessageInvite::key.

Here is the call graph for this function:

create_message_text()

struct GNUNET_MESSENGER_Message * create_message_text

(

const char *

text

)

Creates and allocates a new text message containing a string representing text.

(all values are stored as copy)

Parameters

[in]

text

Text

Returns

New message

Definition at line 157 of file messenger_api_message_kind.c.

{
  if (! text)
    return NULL;
 
  struct GNUNET_MESSENGER_Message *message = create_message (
    GNUNET_MESSENGER_KIND_TEXT);
 
  if (! message)
    return NULL;
 
  message->body.text.text = GNUNET_strdup (text);
  return message;
}

References GNUNET_MESSENGER_Message::body, create_message(), GNUNET_MESSENGER_KIND_TEXT, GNUNET_strdup, GNUNET_MESSENGER_MessageText::text, and GNUNET_MESSENGER_MessageBody::text.

Here is the call graph for this function:

create_message_delete()

struct GNUNET_MESSENGER_Message * create_message_delete	(	const struct GNUNET_HashCode *	hash,
		const struct GNUNET_TIME_Relative	delay
	)

Creates and allocates a new delete message containing the hash of a message to delete after a specific delay.

(all values are stored as copy)

Parameters

[in]	hash	Hash of message
[in]	delay	Delay of deletion

Returns

New message

Definition at line 174 of file messenger_api_message_kind.c.

{
  if (! hash)
    return NULL;
 
  struct GNUNET_MESSENGER_Message *message = create_message (
    GNUNET_MESSENGER_KIND_DELETE);
 
  if (! message)
    return NULL;
 
  GNUNET_memcpy (&(message->body.deletion.hash), hash, sizeof(struct
                                                              GNUNET_HashCode));
  message->body.deletion.delay = GNUNET_TIME_relative_hton (delay);
 
  return message;
}

References GNUNET_MESSENGER_Message::body, create_message(), GNUNET_MESSENGER_MessageDelete::delay, GNUNET_MESSENGER_MessageBody::deletion, GNUNET_memcpy, GNUNET_MESSENGER_KIND_DELETE, GNUNET_TIME_relative_hton(), and GNUNET_MESSENGER_MessageDelete::hash.

Referenced by delete_message_in_room().

Here is the call graph for this function:

Here is the caller graph for this function:

create_message_ticket()

struct GNUNET_MESSENGER_Message * create_message_ticket

(

const struct GNUNET_RECLAIM_Ticket *

ticket

)

Creates and allocates a new ticket message containing the identifier of a ticket to exchange it with a given audience.

(all values are stored as copy)

Parameters

[in]

identifier

Identifier of ticket

Returns

New message

Definition at line 195 of file messenger_api_message_kind.c.

{
  if (! ticket)
    return NULL;
 
  struct GNUNET_MESSENGER_Message *message = create_message (
    GNUNET_MESSENGER_KIND_TICKET);
 
  if (! message)
    return NULL;
 
  message->body.ticket.identifier = GNUNET_strdup (ticket->gns_name);
 
  return message;
}

References GNUNET_MESSENGER_Message::body, create_message(), GNUNET_RECLAIM_Ticket::gns_name, GNUNET_MESSENGER_KIND_TICKET, GNUNET_strdup, GNUNET_MESSENGER_MessageTicket::identifier, ticket, and GNUNET_MESSENGER_MessageBody::ticket.

Here is the call graph for this function: