identity_api_lookup.c File Reference

api to lookup an ego More...

#include "platform.h"
#include "gnunet_util_lib.h"
#include "gnunet_identity_service.h"
#include "identity.h"

Include dependency graph for identity_api_lookup.c:

Go to the source code of this file.

Data Structures
struct	GNUNET_IDENTITY_EgoLookup
	Handle for ego lookup. More...

Macros
#define	LOG(kind, ...)   GNUNET_log_from (kind, "identity-api", __VA_ARGS__)

Functions
static int	check_identity_result_code (void *cls, const struct ResultCodeMessage *rcm)
	We received a result code from the service.
static void	handle_identity_result_code (void *cls, const struct ResultCodeMessage *rcm)
	We received a result code from the service.
static int	check_identity_update (void *cls, const struct UpdateMessage *um)
	Check validity of identity update message.
static void	handle_identity_update (void *cls, const struct UpdateMessage *um)
	Handle identity update message.
static void	mq_error_handler (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.
struct GNUNET_IDENTITY_EgoLookup *	GNUNET_IDENTITY_ego_lookup (const struct GNUNET_CONFIGURATION_Handle *cfg, const char *name, GNUNET_IDENTITY_EgoCallback cb, void *cb_cls)
	Lookup an ego by name.
void	GNUNET_IDENTITY_ego_lookup_cancel (struct GNUNET_IDENTITY_EgoLookup *el)
	Abort ego lookup attempt.

Detailed Description

api to lookup an ego

Author

Christian Grothoff

Definition in file identity_api_lookup.c.

Macro Definition Documentation

LOG

#define LOG	(		kind,
			...
	)		GNUNET_log_from (kind, "identity-api", __VA_ARGS__)

Definition at line 31 of file identity_api_lookup.c.

Function Documentation

check_identity_result_code()

static int check_identity_result_code ( void *  cls, const struct ResultCodeMessage *  rcm  )

static

We received a result code from the service.

Check the message is well-formed.

Parameters

cls	closure
rcm	result message received

Returns

GNUNET_OK if the message is well-formed

Definition at line 70 of file identity_api_lookup.c.

{
  if (sizeof(*rcm) != htons (rcm->header.size))
    GNUNET_MQ_check_zero_termination (rcm);
  return GNUNET_OK;
}

References GNUNET_MQ_check_zero_termination, GNUNET_OK, ResultCodeMessage::header, and GNUNET_MessageHeader::size.

handle_identity_result_code()

static void handle_identity_result_code ( void *  cls, const struct ResultCodeMessage *  rcm  )

static

We received a result code from the service.

Parameters

cls	closure
rcm	result message received

Definition at line 85 of file identity_api_lookup.c.

{
  struct GNUNET_IDENTITY_EgoLookup *el = cls;
 
  el->cb (el->cb_cls, NULL);
  GNUNET_IDENTITY_ego_lookup_cancel (el);
}

References GNUNET_IDENTITY_EgoLookup::cb, GNUNET_IDENTITY_EgoLookup::cb_cls, el, and GNUNET_IDENTITY_ego_lookup_cancel().

Here is the call graph for this function:

check_identity_update()

static int check_identity_update ( void *  cls, const struct UpdateMessage *  um  )

static

Check validity of identity update message.

Parameters

cls	closure
um	message received

Returns

GNUNET_OK if the message is well-formed

Definition at line 102 of file identity_api_lookup.c.

{
  uint16_t size = ntohs (um->header.size);
  uint16_t name_len = ntohs (um->name_len);
  const char *str = (const char *) &um[1];
 
  if ((size < name_len + sizeof(struct UpdateMessage)) ||
      ((0 != name_len) && ('\0' != str[name_len - 1])))
  {
    GNUNET_break (0);
    return GNUNET_SYSERR;
  }
  return GNUNET_OK;
}

References GNUNET_break, GNUNET_OK, GNUNET_SYSERR, UpdateMessage::header, UpdateMessage::name_len, GNUNET_MessageHeader::size, size, and str.

handle_identity_update()

static void handle_identity_update ( void *  cls, const struct UpdateMessage *  um  )

static

Handle identity update message.

Parameters

cls	closure
um	message received

Definition at line 125 of file identity_api_lookup.c.

{
  struct GNUNET_IDENTITY_EgoLookup *el = cls;
  uint16_t name_len = ntohs (um->name_len);
  const char *str;
  size_t key_len;
  size_t kb_read;
  struct GNUNET_HashCode id;
  struct GNUNET_IDENTITY_Ego ego;
  struct GNUNET_CRYPTO_BlindablePrivateKey private_key;
  const char *tmp;
 
  memset (&ego, 0, sizeof (ego));
 
  GNUNET_break (GNUNET_YES != ntohs (um->end_of_list));
  tmp = (const char*) &um[1];
  str = (0 == name_len) ? NULL : tmp;
  memset (&private_key, 0, sizeof (private_key));
  key_len = ntohs (um->header.size) - sizeof (*um) - name_len;
  GNUNET_assert (GNUNET_SYSERR !=
                 GNUNET_CRYPTO_read_private_key_from_buffer (tmp + name_len,
                                                             key_len,
                                                             &private_key,
                                                             &kb_read));
  GNUNET_assert (key_len == kb_read);
  GNUNET_CRYPTO_hash (&private_key, sizeof (private_key), &id);
  ego.pk = private_key;
  ego.name = (char *) str;
  ego.id = id;
  el->cb (el->cb_cls, &ego);
  GNUNET_IDENTITY_ego_lookup_cancel (el);
}

References GNUNET_IDENTITY_EgoLookup::cb, GNUNET_IDENTITY_EgoLookup::cb_cls, el, UpdateMessage::end_of_list, GNUNET_assert, GNUNET_break, GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_read_private_key_from_buffer(), GNUNET_IDENTITY_ego_lookup_cancel(), GNUNET_SYSERR, GNUNET_YES, UpdateMessage::header, id, GNUNET_IDENTITY_Ego::id, GNUNET_IDENTITY_Ego::name, UpdateMessage::name_len, GNUNET_IDENTITY_Ego::pk, GNUNET_MessageHeader::size, and str.

Here is the call graph for this function:

mq_error_handler()

static void mq_error_handler ( 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

cls	closure with the struct GNUNET_IDENTITY_EgoLookup *
error	error code

Definition at line 168 of file identity_api_lookup.c.

{
  struct GNUNET_IDENTITY_EgoLookup *el = cls;
 
  el->cb (el->cb_cls, NULL);
}

References GNUNET_IDENTITY_EgoLookup::cb, GNUNET_IDENTITY_EgoLookup::cb_cls, and el.

Referenced by GNUNET_IDENTITY_ego_lookup().

Here is the caller graph for this function: