GNUnet  0.19.3
identity_api_suffix_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_suffix_lookup.c:

Go to the source code of this file.

Data Structures

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

Detailed Description

api to lookup an ego

Author
Christian Grothoff

Definition in file identity_api_suffix_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_suffix_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
clsclosure
rcmresult message received
Returns
GNUNET_OK if the message is well-formed

Definition at line 70 of file identity_api_suffix_lookup.c.

71 {
72  (void) cls;
73  if (sizeof(*rcm) != htons (rcm->header.size))
75  return GNUNET_OK;
76 }
@ GNUNET_OK
#define GNUNET_MQ_check_zero_termination(m)
Insert code for a "check_" function that verifies that a given variable-length message received over ...
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format.
struct GNUNET_MessageHeader header
Type: GNUNET_MESSAGE_TYPE_IDENTITY_RESULT_CODE.
Definition: identity.h:85

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
clsclosure
rcmresult message received

Definition at line 86 of file identity_api_suffix_lookup.c.

87 {
88  struct GNUNET_IDENTITY_EgoSuffixLookup *el = cls;
89 
90  (void) rcm;
91  el->cb (el->cb_cls, NULL, NULL);
93 }
static struct GNUNET_IDENTITY_EgoLookup * el
EgoLookup.
Definition: gnunet-abd.c:51
void GNUNET_IDENTITY_ego_lookup_by_suffix_cancel(struct GNUNET_IDENTITY_EgoSuffixLookup *el)
Abort ego lookup attempt.
void * cb_cls
Closure for cb.
GNUNET_IDENTITY_EgoCallback cb
Function to call with the result.

References GNUNET_IDENTITY_EgoLookup::cb, GNUNET_IDENTITY_EgoLookup::cb_cls, el, and GNUNET_IDENTITY_ego_lookup_by_suffix_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
clsclosure
ummessage received
Returns
GNUNET_OK if the message is well-formed

Definition at line 104 of file identity_api_suffix_lookup.c.

105 {
106  uint16_t size = ntohs (um->header.size);
107  uint16_t name_len = ntohs (um->name_len);
108  const char *str = (const char *) &um[1];
109 
110  (void) cls;
111  if ((size < name_len + sizeof(struct UpdateMessage)) ||
112  ((0 != name_len) && ('\0' != str[name_len - 1])))
113  {
114  GNUNET_break (0);
115  return GNUNET_SYSERR;
116  }
117  return GNUNET_OK;
118 }
@ GNUNET_SYSERR
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur.
static unsigned int size
Size of the "table".
Definition: peer.c:68
Service informs client about status of a pseudonym.
Definition: identity.h:114
uint16_t name_len
Number of bytes in ego name string including 0-termination, in NBO; 0 if the ego was deleted.
Definition: identity.h:124
struct GNUNET_MessageHeader header
Type: GNUNET_MESSAGE_TYPE_IDENTITY_UPDATE.
Definition: identity.h:118

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

◆ handle_identity_update()

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

Handle identity update message.

Parameters
clsclosure
ummessage received

Definition at line 128 of file identity_api_suffix_lookup.c.

129 {
130  struct GNUNET_IDENTITY_EgoSuffixLookup *el = cls;
131  uint16_t name_len = ntohs (um->name_len);
132  const char *str;
133  size_t key_len;
134  size_t kb_read;
135  struct GNUNET_IDENTITY_PrivateKey private_key;
136  const char *tmp;
137 
138  tmp = (const char*) &um[1];
139  str = (0 == name_len) ? NULL : tmp;
140  memset (&private_key, 0, sizeof (private_key));
141  key_len = ntohs (um->header.size) - name_len - sizeof (*um);
142  if (0 < key_len)
143  {
146  key_len,
147  &private_key,
148  &kb_read));
149  GNUNET_assert (key_len == kb_read);
150  }
151  el->cb (el->cb_cls, &private_key, str);
153 }
enum GNUNET_GenericReturnValue GNUNET_IDENTITY_read_private_key_from_buffer(const void *buffer, size_t len, struct GNUNET_IDENTITY_PrivateKey *key, size_t *kb_read)
Reads a GNUNET_IDENTITY_PrivateKey from a compact buffer.
Definition: identity_api.c:908
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
A private key for an identity as per LSD0001.

References GNUNET_IDENTITY_EgoLookup::cb, GNUNET_IDENTITY_EgoLookup::cb_cls, el, GNUNET_assert, GNUNET_IDENTITY_ego_lookup_by_suffix_cancel(), GNUNET_IDENTITY_read_private_key_from_buffer(), GNUNET_SYSERR, UpdateMessage::header, UpdateMessage::name_len, and GNUNET_MessageHeader::size.

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
clsclosure with the struct GNUNET_IDENTITY_EgoSuffixLookup *
errorerror code

Definition at line 165 of file identity_api_suffix_lookup.c.

166 {
167  struct GNUNET_IDENTITY_EgoSuffixLookup *el = cls;
168 
169  (void) error;
170  el->cb (el->cb_cls, NULL, NULL);
172 }

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

Referenced by GNUNET_IDENTITY_ego_lookup_by_suffix().

Here is the call graph for this function:
Here is the caller graph for this function: