GNS Record library

Manipulate GNS record data. More...

Data Structures
struct	GNUNET_GNSRECORD_Data
	A GNS record. More...
struct	GNUNET_GNSRECORD_PlaceData
	Data stored in a PLACE record. More...
struct	GNUNET_GNSRECORD_Block
	Information we have in an encrypted block with record data (i.e. More...
struct	GNUNET_GNSRECORD_BoxRecord
	Record type used to box up SRV and TLSA records. More...
struct	GNUNET_GNSRECORD_ReverseRecord
	Record type used internally to keep track of reverse mappings into a namespace. More...

Macros
#define	GNUNET_GNSRECORD_MAX_BLOCK_SIZE   (63 * 1024)
	Maximum size of a value that can be stored in a GNS block. More...
#define	GNUNET_GNSRECORD_TYPE_ANY   0
	Record type indicating any record/'*'. More...
#define	GNUNET_GNSRECORD_TYPE_PKEY   65536
	Record type for GNS zone transfer ("PKEY"). More...
#define	GNUNET_GNSRECORD_TYPE_NICK   65537
	Record type for GNS nick names ("NICK"). More...
#define	GNUNET_GNSRECORD_TYPE_LEHO   65538
	Record type for GNS legacy hostnames ("LEHO"). More...
#define	GNUNET_GNSRECORD_TYPE_VPN   65539
	Record type for VPN resolution. More...
#define	GNUNET_GNSRECORD_TYPE_GNS2DNS   65540
	Record type for delegation to DNS. More...
#define	GNUNET_GNSRECORD_TYPE_BOX   65541
	Record type for a boxed record (see TLSA/SRV handling in GNS). More...
#define	GNUNET_GNSRECORD_TYPE_PLACE   65542
	Record type for a social place. More...
#define	GNUNET_GNSRECORD_TYPE_PHONE   65543
	Record type for a phone (of CONVERSATION). More...
#define	GNUNET_GNSRECORD_TYPE_RECLAIM_ATTR   65544
	Record type for identity attributes (of RECLAIM). More...
#define	GNUNET_GNSRECORD_TYPE_RECLAIM_TICKET   65545
	Record type for local ticket references. More...
#define	GNUNET_GNSRECORD_TYPE_CREDENTIAL   65547
	65546 reserved More...
#define	GNUNET_GNSRECORD_TYPE_POLICY   65548
	Record type for policies. More...
#define	GNUNET_GNSRECORD_TYPE_ATTRIBUTE   65549
	Record type for reverse lookups. More...
#define	GNUNET_GNSRECORD_TYPE_RECLAIM_ATTR_REF   65550
	Record type for reclaim records. More...
#define	GNUNET_GNSRECORD_TYPE_RECLAIM_MASTER   65551
	Record type for RECLAIM master. More...
#define	GNUNET_GNSRECORD_TYPE_RECLAIM_OIDC_CLIENT   65552
	Record type for reclaim OIDC clients. More...
#define	GNUNET_GNSRECORD_TYPE_RECLAIM_OIDC_REDIRECT   65553
	Record type for reclaim OIDC redirect URIs. More...

Enumerations
enum	GNUNET_GNSRECORD_Flags { GNUNET_GNSRECORD_RF_NONE = 0, GNUNET_GNSRECORD_RF_PRIVATE = 2, GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION = 8, GNUNET_GNSRECORD_RF_SHADOW_RECORD }
	Flags that can be set for a record. More...

Functions
char *	GNUNET_GNSRECORD_value_to_string (uint32_t type, const void *data, size_t data_size)
	Convert the binary value data of a record of type type to a human-readable string. More...
int	GNUNET_GNSRECORD_string_to_value (uint32_t type, const char *s, void **data, size_t *data_size)
	Convert human-readable version of the value s of a record of type type to the respective binary representation. More...
uint32_t	GNUNET_GNSRECORD_typename_to_number (const char *dns_typename)
	Convert a type name (i.e. More...
const char *	GNUNET_GNSRECORD_number_to_typename (uint32_t type)
	Convert a type number (i.e. More...
ssize_t	GNUNET_GNSRECORD_records_get_size (unsigned int rd_count, const struct GNUNET_GNSRECORD_Data *rd)
	Calculate how many bytes we will need to serialize the given records. More...
ssize_t	GNUNET_GNSRECORD_records_serialize (unsigned int rd_count, const struct GNUNET_GNSRECORD_Data *rd, size_t dest_size, char *dest)
	Serialize the given records to the given destination buffer. More...
int	GNUNET_GNSRECORD_records_deserialize (size_t len, const char *src, unsigned int rd_count, struct GNUNET_GNSRECORD_Data *dest)
	Deserialize the given records to the given destination. More...
int	GNUNET_GNSRECORD_is_expired (const struct GNUNET_GNSRECORD_Data *rd)
	Test if a given record is expired. More...
char *	GNUNET_GNSRECORD_string_to_lowercase (const char *src)
	Convert a UTF-8 string to UTF-8 lowercase. More...
const char *	GNUNET_GNSRECORD_z2s (const struct GNUNET_CRYPTO_EcdsaPublicKey *z)
	Convert a zone to a string (for printing debug messages). More...
const char *	GNUNET_GNSRECORD_pkey_to_zkey (const struct GNUNET_CRYPTO_EcdsaPublicKey *pkey)
	Convert public key to the respective absolute domain name in the ".zkey" pTLD. More...
int	GNUNET_GNSRECORD_zkey_to_pkey (const char *zkey, struct GNUNET_CRYPTO_EcdsaPublicKey *pkey)
	Convert an absolute domain name to the respective public key. More...
void	GNUNET_GNSRECORD_query_from_private_key (const struct GNUNET_CRYPTO_EcdsaPrivateKey *zone, const char *label, struct GNUNET_HashCode *query)
	Calculate the DHT query for a given label in a given zone. More...
void	GNUNET_GNSRECORD_query_from_public_key (const struct GNUNET_CRYPTO_EcdsaPublicKey *pub, const char *label, struct GNUNET_HashCode *query)
	Calculate the DHT query for a given label in a given zone. More...
struct GNUNET_GNSRECORD_Block *	GNUNET_GNSRECORD_block_create (const struct GNUNET_CRYPTO_EcdsaPrivateKey *key, struct GNUNET_TIME_Absolute expire, const char *label, const struct GNUNET_GNSRECORD_Data *rd, unsigned int rd_count)
	Sign name and records. More...
struct GNUNET_GNSRECORD_Block *	GNUNET_GNSRECORD_block_create2 (const struct GNUNET_CRYPTO_EcdsaPrivateKey *key, struct GNUNET_TIME_Absolute expire, const char *label, const struct GNUNET_GNSRECORD_Data *rd, unsigned int rd_count)
	Sign name and records, cache derived public key (also keeps the private key in static memory, so do not use this function if keeping the private key in the process'es RAM is a major issue). More...
int	GNUNET_GNSRECORD_block_verify (const struct GNUNET_GNSRECORD_Block *block)
	Check if a signature is valid. More...
int	GNUNET_GNSRECORD_block_decrypt (const struct GNUNET_GNSRECORD_Block *block, const struct GNUNET_CRYPTO_EcdsaPublicKey *zone_key, const char *label, GNUNET_GNSRECORD_RecordCallback proc, void *proc_cls)
	Decrypt block. More...
int	GNUNET_GNSRECORD_records_cmp (const struct GNUNET_GNSRECORD_Data *a, const struct GNUNET_GNSRECORD_Data *b)
	Compares if two records are equal. More...
struct GNUNET_TIME_Absolute	GNUNET_GNSRECORD_record_get_expiration_time (unsigned int rd_count, const struct GNUNET_GNSRECORD_Data *rd)
	Returns the expiration time of the given block of records. More...

Variables
GNUNET_NETWORK_STRUCT_END typedef void(*	GNUNET_GNSRECORD_RecordCallback )(void *cls, unsigned int rd_count, const struct GNUNET_GNSRECORD_Data *rd)
	Process a records that were decrypted from a block. More...

Detailed Description

Manipulate GNS record data.

See also

Documentation

Macro Definition Documentation

GNUNET_GNSRECORD_MAX_BLOCK_SIZE

#define GNUNET_GNSRECORD_MAX_BLOCK_SIZE   (63 * 1024)

Maximum size of a value that can be stored in a GNS block.

Definition at line 47 of file gnunet_gnsrecord_lib.h.

Referenced by block_create().

GNUNET_GNSRECORD_TYPE_ANY

#define GNUNET_GNSRECORD_TYPE_ANY   0

Record type indicating any record/'*'.

Definition at line 53 of file gnunet_gnsrecord_lib.h.

Referenced by del_monitor(), display_record(), get_gns_cont(), GNUNET_GNSRECORD_number_to_typename(), GNUNET_GNSRECORD_typename_to_number(), process_lookup_result(), process_queue(), recursive_gns2dns_resolution(), and run().

GNUNET_GNSRECORD_TYPE_PKEY

#define GNUNET_GNSRECORD_TYPE_PKEY   65536

Record type for GNS zone transfer ("PKEY").

Definition at line 58 of file gnunet_gnsrecord_lib.h.

Referenced by check_pkey(), get_existing_record(), gns_string_to_value(), gns_value_to_string(), GNUNET_GNSRECORD_records_get_size(), handle_gns_resolution_result(), iterate_cb(), namestore_postgres_store_records(), namestore_sqlite_store_records(), run_with_zone_pkey(), zone_to_name(), and zone_to_name_cb().

GNUNET_GNSRECORD_TYPE_NICK

#define GNUNET_GNSRECORD_TYPE_NICK   65537

Record type for GNS nick names ("NICK").

Definition at line 63 of file gnunet_gnsrecord_lib.h.

Referenced by display_record(), gns_string_to_value(), gns_value_to_string(), GNUNET_NAMESTORE_set_nick(), handle_gns_resolution_result(), handle_record_store(), and lookup_nick_it().

GNUNET_GNSRECORD_TYPE_LEHO

#define GNUNET_GNSRECORD_TYPE_LEHO   65538

Record type for GNS legacy hostnames ("LEHO").

Definition at line 68 of file gnunet_gnsrecord_lib.h.

Referenced by dns_result_parser(), gns_string_to_value(), gns_value_to_string(), and handle_gns_result().

GNUNET_GNSRECORD_TYPE_VPN

#define GNUNET_GNSRECORD_TYPE_VPN   65539

Record type for VPN resolution.

Definition at line 73 of file gnunet_gnsrecord_lib.h.

Referenced by gns_string_to_value(), gns_value_to_string(), handle_gns_resolution_result(), handle_gns_result(), and vpn_allocation_cb().

GNUNET_GNSRECORD_TYPE_GNS2DNS

#define GNUNET_GNSRECORD_TYPE_GNS2DNS   65540

Record type for delegation to DNS.

Definition at line 78 of file gnunet_gnsrecord_lib.h.

Referenced by check_for_glue(), get_existing_record(), gns_string_to_value(), gns_value_to_string(), handle_gns_resolution_result(), process_queue(), process_record(), and recursive_gns2dns_resolution().

GNUNET_GNSRECORD_TYPE_BOX

#define GNUNET_GNSRECORD_TYPE_BOX   65541

Record type for a boxed record (see TLSA/SRV handling in GNS).

Definition at line 83 of file gnunet_gnsrecord_lib.h.

Referenced by gns_string_to_value(), gns_value_to_string(), handle_gns_resolution_result(), and handle_gns_result().

GNUNET_GNSRECORD_TYPE_PLACE

#define GNUNET_GNSRECORD_TYPE_PLACE   65542

Record type for a social place.

Definition at line 88 of file gnunet_gnsrecord_lib.h.

GNUNET_GNSRECORD_TYPE_PHONE

#define GNUNET_GNSRECORD_TYPE_PHONE   65543

Record type for a phone (of CONVERSATION).

Definition at line 93 of file gnunet_gnsrecord_lib.h.

Referenced by conversation_string_to_value(), conversation_value_to_string(), GNUNET_CONVERSATION_call_start(), GNUNET_CONVERSATION_phone_get_record(), and handle_gns_response().

GNUNET_GNSRECORD_TYPE_RECLAIM_ATTR

#define GNUNET_GNSRECORD_TYPE_RECLAIM_ATTR   65544

Record type for identity attributes (of RECLAIM).

Definition at line 98 of file gnunet_gnsrecord_lib.h.

Referenced by attr_iter_cb(), attr_store_task(), lookup_authz_cb(), process_parallel_lookup_result(), string_to_value(), and value_to_string().

GNUNET_GNSRECORD_TYPE_RECLAIM_TICKET

#define GNUNET_GNSRECORD_TYPE_RECLAIM_TICKET   65545

Record type for local ticket references.

Definition at line 103 of file gnunet_gnsrecord_lib.h.

Referenced by collect_tickets_cb(), filter_tickets_cb(), issue_ticket(), string_to_value(), and value_to_string().

GNUNET_GNSRECORD_TYPE_CREDENTIAL

#define GNUNET_GNSRECORD_TYPE_CREDENTIAL   65547

65546 reserved

Record type for credential

Definition at line 112 of file gnunet_gnsrecord_lib.h.

Referenced by credential_string_to_value(), credential_value_to_string(), and handle_cred_collection_cb().

GNUNET_GNSRECORD_TYPE_POLICY

#define GNUNET_GNSRECORD_TYPE_POLICY   65548

Record type for policies.

Definition at line 117 of file gnunet_gnsrecord_lib.h.

Referenced by credential_string_to_value(), and credential_value_to_string().

GNUNET_GNSRECORD_TYPE_ATTRIBUTE

#define GNUNET_GNSRECORD_TYPE_ATTRIBUTE   65549

Record type for reverse lookups.

Definition at line 122 of file gnunet_gnsrecord_lib.h.

Referenced by backward_resolution(), credential_string_to_value(), credential_value_to_string(), and delegation_chain_resolution_start().

GNUNET_GNSRECORD_TYPE_RECLAIM_ATTR_REF

#define GNUNET_GNSRECORD_TYPE_RECLAIM_ATTR_REF   65550

Record type for reclaim records.

Definition at line 127 of file gnunet_gnsrecord_lib.h.

Referenced by filter_tickets_cb(), issue_ticket(), lookup_authz_cb(), process_tickets(), RECLAIM_TICKETS_consume(), revoke_attrs_cb(), rvk_ticket_update(), string_to_value(), ticket_iter(), update_tickets(), and value_to_string().

GNUNET_GNSRECORD_TYPE_RECLAIM_MASTER

#define GNUNET_GNSRECORD_TYPE_RECLAIM_MASTER   65551

Record type for RECLAIM master.

Definition at line 132 of file gnunet_gnsrecord_lib.h.

Referenced by string_to_value(), and value_to_string().

GNUNET_GNSRECORD_TYPE_RECLAIM_OIDC_CLIENT

#define GNUNET_GNSRECORD_TYPE_RECLAIM_OIDC_CLIENT   65552

Record type for reclaim OIDC clients.

Definition at line 137 of file gnunet_gnsrecord_lib.h.

Referenced by string_to_value(), and value_to_string().

GNUNET_GNSRECORD_TYPE_RECLAIM_OIDC_REDIRECT

#define GNUNET_GNSRECORD_TYPE_RECLAIM_OIDC_REDIRECT   65553

Record type for reclaim OIDC redirect URIs.

Definition at line 142 of file gnunet_gnsrecord_lib.h.

Referenced by client_redirect(), lookup_redirect_uri_result(), string_to_value(), and value_to_string().

Enumeration Type Documentation

GNUNET_GNSRECORD_Flags

enum GNUNET_GNSRECORD_Flags

Flags that can be set for a record.

Enumerator
GNUNET_GNSRECORD_RF_NONE	No special options.
GNUNET_GNSRECORD_RF_PRIVATE	This is a private record of this peer and it should thus not be handed out to other peers.
GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION	This flag is currently unused; former RF_PENDING flag. GNUNET_GNSRECORD_RF_UNUSED = 4, This expiration time of the record is a relative time (not an absolute time).
GNUNET_GNSRECORD_RF_SHADOW_RECORD	This record should not be used unless all (other) records with an absolute expiration time have expired.

Definition at line 147 of file gnunet_gnsrecord_lib.h.

                            {

  GNUNET_GNSRECORD_RF_NONE = 0,

  GNUNET_GNSRECORD_RF_PRIVATE = 2,

  GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION = 8,

  GNUNET_GNSRECORD_RF_SHADOW_RECORD = 16

#define GNUNET_GNSRECORD_RF_RCMP_FLAGS (GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION)
};

Function Documentation

GNUNET_GNSRECORD_value_to_string()

char* GNUNET_GNSRECORD_value_to_string	(	uint32_t	type,
		const void *	data,
		size_t	data_size
	)

Convert the binary value data of a record of type type to a human-readable string.

Parameters

type	type of the record
data	value in binary encoding
data_size	number of bytes in data

Returns

NULL on error, otherwise human-readable representation of the value

Convert the binary value data of a record of type type to a human-readable string.

Parameters

type	type of the record
data	value in binary encoding
data_size	number of bytes in data

Returns

NULL on error, otherwise human-readable representation of the value

Definition at line 143 of file gnsrecord.c.

References Plugin::api, GNUNET_BLOCK_PluginFunctions::cls, init(), num_plugins, plugin, and ret.

Referenced by check_pkey(), del_monitor(), display_record(), display_records_from_block(), gns_value_to_string(), GNUNET_GNSRECORD_records_deserialize(), GNUNET_GNSRECORD_records_get_size(), GNUNET_GNSRECORD_records_serialize(), GNUNET_JSON_from_gnsrecord(), iterate_cb(), process_lookup_result(), and start_phone().

{
  struct Plugin *plugin;
  char *ret;

  init ();
  for (unsigned int i = 0; i < num_plugins; i++)
  {
    plugin = gns_plugins[i];
    if (NULL != (ret = plugin->api->value_to_string (plugin->api->cls,
                                                     type,
                                                     data,
                                                     data_size)))
      return ret;
  }
  return NULL;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_string_to_value()

int GNUNET_GNSRECORD_string_to_value	(	uint32_t	type,
		const char *	s,
		void **	data,
		size_t *	data_size
	)

Convert human-readable version of the value s of a record of type type to the respective binary representation.

Parameters

type	type of the record
s	human-readable string
data	set to value in binary encoding (will be allocated)
data_size	set to number of bytes in data

Returns

GNUNET_OK on success

Convert human-readable version of the value s of a record of type type to the respective binary representation.

Parameters

type	type of the record
s	human-readable string
data	set to value in binary encoding (will be allocated)
data_size	set to number of bytes in data

Returns

GNUNET_OK on success

Definition at line 175 of file gnsrecord.c.

References Plugin::api, GNUNET_BLOCK_PluginFunctions::cls, GNUNET_OK, GNUNET_SYSERR, init(), num_plugins, and plugin.

Referenced by gns_string_to_value(), multirecord_process(), parse_record(), and run_with_zone_pkey().

{
  struct Plugin *plugin;

  init ();
  for (unsigned int i = 0; i < num_plugins; i++)
  {
    plugin = gns_plugins[i];
    if (GNUNET_OK == plugin->api->string_to_value (plugin->api->cls,
                                                   type,
                                                   s,
                                                   data,
                                                   data_size))
      return GNUNET_OK;
  }
  return GNUNET_SYSERR;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_typename_to_number()

uint32_t GNUNET_GNSRECORD_typename_to_number

(

const char *

dns_typename

)

Convert a type name (i.e.

"AAAA") to the corresponding number.

Parameters

dns_typename

name to convert

Returns

corresponding number, UINT32_MAX on error

Definition at line 204 of file gnsrecord.c.

References Plugin::api, GNUNET_BLOCK_PluginFunctions::cls, GNUNET_GNSRECORD_TYPE_ANY, init(), num_plugins, plugin, and ret.

Referenced by del_monitor(), display_record(), get_gns_cont(), multirecord_process(), parse_record(), run(), and run_with_zone_pkey().

{
  struct Plugin *plugin;
  uint32_t ret;

  if (0 == strcasecmp (dns_typename,
                       "ANY"))
    return GNUNET_GNSRECORD_TYPE_ANY;
  init ();
  for (unsigned int i = 0; i < num_plugins; i++)
  {
    plugin = gns_plugins[i];
    if (UINT32_MAX != (ret = plugin->api->typename_to_number (plugin->api->cls,
                                                              dns_typename)))
      return ret;
  }
  return UINT32_MAX;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_number_to_typename()

const char* GNUNET_GNSRECORD_number_to_typename

(

uint32_t

type

)

Convert a type number (i.e.

1) to the corresponding type string (i.e. "A")

Parameters

type	number of a type to convert

Returns

corresponding typestring, NULL on error

Definition at line 231 of file gnsrecord.c.

References Plugin::api, GNUNET_BLOCK_PluginFunctions::cls, GNUNET_GNSRECORD_TYPE_ANY, init(), num_plugins, plugin, and ret.

Referenced by display_record(), display_records_from_block(), GNUNET_JSON_from_gnsrecord(), multirecord_process(), and process_lookup_result().

{
  struct Plugin *plugin;
  const char * ret;

  if (GNUNET_GNSRECORD_TYPE_ANY == type)
    return "ANY";
  init ();
  for (unsigned int i = 0; i < num_plugins; i++)
  {
    plugin = gns_plugins[i];
    if (NULL != (ret = plugin->api->number_to_typename (plugin->api->cls,
                                                        type)))
      return ret;
  }
  return NULL;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_records_get_size()

ssize_t GNUNET_GNSRECORD_records_get_size	(	unsigned int	rd_count,
		const struct GNUNET_GNSRECORD_Data *	rd
	)

Calculate how many bytes we will need to serialize the given records.

Parameters

rd_count	number of records in the rd array
rd	array of GNUNET_GNSRECORD_Data with rd_count elements

Returns

the required size to serialize, -1 on error

Parameters

rd_count	number of records in the rd array
rd	array of GNUNET_GNSRECORD_Data with rd_count elements

Returns

the required size to serialize, -1 on error

Efficiently round up to the next power of 2 for padding https://graphics.stanford.edu/~seander/bithacks.html#RoundUpPowerOf2

Definition at line 90 of file gnsrecord_serialization.c.

References data, NetworkRecord::data_size, GNUNET_GNSRECORD_Data::data_size, GNUNET_break, GNUNET_break_op, GNUNET_free, GNUNET_GNSRECORD_TYPE_PKEY, GNUNET_GNSRECORD_value_to_string(), NetworkRecord::record_type, GNUNET_GNSRECORD_Data::record_type, and ret.

Referenced by block_create(), GNUNET_NAMESTORE_records_store(), handle_gns_resolution_result(), handle_zone_to_name_it(), lookup_it(), namestore_postgres_store_records(), namestore_sqlite_store_records(), rvk_ticket_update(), send_lookup_response(), store_and_free_entries(), and ticket_iter().

{
  size_t ret;

  if (0 == rd_count)
    return 0;
  
  ret = sizeof (struct NetworkRecord) * rd_count;
  for (unsigned int i=0;i<rd_count;i++)
  {
    if ((ret + rd[i].data_size) < ret)
    {
      GNUNET_break (0);
      return -1;
    }
    ret += rd[i].data_size;
#if DEBUG_GNSRECORDS
    {
      char *str;

      str = GNUNET_GNSRECORD_value_to_string (rd[i].record_type,
                                              rd[i].data,
                                              rd[i].data_size);
      if (NULL == str)
      {
        GNUNET_break_op (0);
        return -1;
      }
      GNUNET_free (str);
    }
#endif
  }
  if (ret > SSIZE_MAX)
  {
    GNUNET_break (0);
    return -1;
  }
  //Do not pad PKEY
  if (GNUNET_GNSRECORD_TYPE_PKEY == rd->record_type)
    return ret;
  ret--;
  ret |= ret >> 1;
  ret |= ret >> 2;
  ret |= ret >> 4;
  ret |= ret >> 8;
  ret |= ret >> 16;
  ret++;
  return (ssize_t) ret;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_records_serialize()

ssize_t GNUNET_GNSRECORD_records_serialize	(	unsigned int	rd_count,
		const struct GNUNET_GNSRECORD_Data *	rd,
		size_t	dest_size,
		char *	dest
	)

Serialize the given records to the given destination buffer.

Parameters

rd_count	number of records in the rd array
rd	array of GNUNET_GNSRECORD_Data with rd_count elements
dest_size	size of the destination array dst
dest	where to write the result

Returns

the size of serialized records, -1 if records do not fit

Parameters

rd_count	number of records in the rd array
rd	array of GNUNET_GNSRECORD_Data with rd_count elements
dest_size	size of the destination array
dest	where to write the result

Returns

the size of serialized records, -1 if records do not fit

Definition at line 157 of file gnsrecord_serialization.c.

References data, NetworkRecord::data_size, GNUNET_GNSRECORD_Data::data_size, NetworkRecord::expiration_time, NetworkRecord::flags, GNUNET_break, GNUNET_break_op, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_GNSRECORD_value_to_string(), GNUNET_htonll(), GNUNET_memcpy, LOG, and NetworkRecord::record_type.

Referenced by block_create(), GNUNET_NAMESTORE_records_store(), handle_gns_resolution_result(), handle_zone_to_name_it(), lookup_it(), namestore_postgres_store_records(), namestore_sqlite_store_records(), rvk_ticket_update(), send_lookup_response(), store_and_free_entries(), and ticket_iter().

{
  struct NetworkRecord rec;
  size_t off;

  off = 0;
  for (unsigned int i=0;i<rd_count;i++)
  {
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Serializing record %u with flags %d and expiration time %llu\n",
         i,
         rd[i].flags,
         (unsigned long long) rd[i].expiration_time);
    rec.expiration_time = GNUNET_htonll (rd[i].expiration_time);
    rec.data_size = htonl ((uint32_t) rd[i].data_size);
    rec.record_type = htonl (rd[i].record_type);
    rec.flags = htonl (rd[i].flags);
    if ( (off + sizeof (rec) > dest_size) ||
         (off + sizeof (rec) < off) )
    {
      GNUNET_break (0);
      return -1;
    }
    GNUNET_memcpy (&dest[off],
                   &rec,
                   sizeof (rec));
    off += sizeof (rec);
    if ( (off + rd[i].data_size > dest_size) ||
         (off + rd[i].data_size < off) )
    {
      GNUNET_break (0);
      return -1;
    }
    GNUNET_memcpy (&dest[off],
                   rd[i].data,
                   rd[i].data_size);
    off += rd[i].data_size;
#if DEBUG_GNSRECORDS
    {
      char *str;

      str = GNUNET_GNSRECORD_value_to_string (rd[i].record_type,
                                              rd[i].data,
                                              rd[i].data_size);
      if (NULL == str)
      {
        GNUNET_break_op (0);
        return -1;
      }
      GNUNET_free (str);
    }
#endif
  }
  memset (&dest[off],
          0,
          dest_size-off);
  return dest_size;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_records_deserialize()

int GNUNET_GNSRECORD_records_deserialize	(	size_t	len,
		const char *	src,
		unsigned int	rd_count,
		struct GNUNET_GNSRECORD_Data *	dest
	)

Deserialize the given records to the given destination.

Parameters

len	size of the serialized record data
src	the serialized record data
rd_count	number of records in the dest array
dest	where to put the data

Returns

GNUNET_OK on success, GNUNET_SYSERR on error

Parameters

len	size of the serialized record data
src	the serialized record data
rd_count	number of records in the rd array
dest	where to put the data

Returns

GNUNET_OK on success, GNUNET_SYSERR on error

Definition at line 230 of file gnsrecord_serialization.c.

References data, GNUNET_GNSRECORD_Data::data, NetworkRecord::data_size, GNUNET_GNSRECORD_Data::data_size, NetworkRecord::expiration_time, GNUNET_GNSRECORD_Data::expiration_time, NetworkRecord::flags, GNUNET_GNSRECORD_Data::flags, GNUNET_break_op, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_GNSRECORD_value_to_string(), GNUNET_memcpy, GNUNET_ntohll(), GNUNET_OK, GNUNET_SYSERR, LOG, NetworkRecord::record_type, and GNUNET_GNSRECORD_Data::record_type.

Referenced by check_rd(), check_result(), continue_store_activity(), database_setup(), get_records_and_call_iterator(), GNUNET_GNSRECORD_block_decrypt(), handle_lookup_result(), handle_record_result(), handle_record_store(), handle_result(), handle_zone_to_name_response(), parse_result_call_iterator(), process_tickets(), update_tickets(), and vpn_allocation_cb().

{
  struct NetworkRecord rec;
  size_t off;

  off = 0;
  for (unsigned int i=0;i<rd_count;i++)
  {
    if ( (off + sizeof (rec) > len) ||
         (off + sizeof (rec) < off) )
    {
      GNUNET_break_op (0);
      return GNUNET_SYSERR;
    }
    GNUNET_memcpy (&rec,
                   &src[off],
                   sizeof (rec));
    dest[i].expiration_time = GNUNET_ntohll (rec.expiration_time);
    dest[i].data_size = ntohl ((uint32_t) rec.data_size);
    dest[i].record_type = ntohl (rec.record_type);
    dest[i].flags = ntohl (rec.flags);
    off += sizeof (rec);
    if ( (off + dest[i].data_size > len) ||
         (off + dest[i].data_size < off) )
    {
      GNUNET_break_op (0);
      return GNUNET_SYSERR;
    }
    dest[i].data = &src[off];
    off += dest[i].data_size;
#if GNUNET_EXTRA_LOGGING
    {
      char *str;

      str = GNUNET_GNSRECORD_value_to_string (dest[i].record_type,
                                              dest[i].data,
                                              dest[i].data_size);
      if (NULL == str)
      {
        GNUNET_break_op (0);
        return GNUNET_SYSERR;
      }
      GNUNET_free (str);
    }
#endif
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Deserialized record %u with flags %d and expiration time %llu\n",
         i,
         dest[i].flags,
         (unsigned long long) dest[i].expiration_time);
  }
  return GNUNET_OK;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_is_expired()

int GNUNET_GNSRECORD_is_expired

(

const struct GNUNET_GNSRECORD_Data *

rd

)

Test if a given record is expired.

Parameters

rd	record to test

Returns

GNUNET_YES if the record is expired, GNUNET_NO if not

GNUNET_YES if the record is expired, GNUNET_NO if not

Definition at line 214 of file gnsrecord_misc.c.

References GNUNET_TIME_Absolute::abs_value_us, GNUNET_GNSRECORD_Data::expiration_time, GNUNET_GNSRECORD_Data::flags, GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION, GNUNET_NO, GNUNET_TIME_absolute_get_remaining(), and GNUNET_YES.

{
  struct GNUNET_TIME_Absolute at;

  if (0 != (rd->flags & GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION))
    return GNUNET_NO;
  at.abs_value_us = rd->expiration_time;
  return (0 == GNUNET_TIME_absolute_get_remaining (at).rel_value_us) ? GNUNET_YES : GNUNET_NO;
}

Here is the call graph for this function:

GNUNET_GNSRECORD_string_to_lowercase()

char* GNUNET_GNSRECORD_string_to_lowercase

(

const char *

src

)

Convert a UTF-8 string to UTF-8 lowercase.

Parameters

src	source string

Returns

converted result

Definition at line 46 of file gnsrecord_misc.c.

References GNUNET_strdup, GNUNET_STRINGS_utf8_tolower(), and res.

Referenced by handle_record_lookup(), and handle_record_store().

{
  char *res;

  res = GNUNET_strdup (src);
  GNUNET_STRINGS_utf8_tolower (src, res);
  return res;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_z2s()

const char* GNUNET_GNSRECORD_z2s

(

const struct GNUNET_CRYPTO_EcdsaPublicKey *

z

)

Convert a zone to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters

z	public key of a zone

Returns

string form; will be overwritten by next call to GNUNET_GNSRECORD_z2s.

Convert a zone to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters

z	the zone key

Returns

string form; will be overwritten by next call to GNUNET_GNSRECORD_z2s

Definition at line 65 of file gnsrecord_misc.c.

References buf, end, GNUNET_break, and GNUNET_STRINGS_data_to_string().

Referenced by get_nick_record(), handle_gns_resolution_result(), handle_namecache_block_response(), handle_revocation_result(), namestore_flat_zone_to_name(), namestore_sqlite_zone_to_name(), recursive_gns_resolution_namecache(), recursive_gns_resolution_revocation(), and refresh_block().

{
  static char buf[sizeof (struct GNUNET_CRYPTO_EcdsaPublicKey) * 8];
  char *end;

  end = GNUNET_STRINGS_data_to_string ((const unsigned char *) z,
                                       sizeof (struct GNUNET_CRYPTO_EcdsaPublicKey),
                                       buf, sizeof (buf));
  if (NULL == end)
  {
    GNUNET_break (0);
    return NULL;
  }
  *end = '\0';
  return buf;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_pkey_to_zkey()

const char* GNUNET_GNSRECORD_pkey_to_zkey

(

const struct GNUNET_CRYPTO_EcdsaPublicKey *

pkey

)

Convert public key to the respective absolute domain name in the ".zkey" pTLD.

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters

pkey	a public key with a point on the eliptic curve

Returns

string "X.zkey" where X is the coordinates of the public key in an encoding suitable for DNS labels.

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters

pkey	a public key with a point on the eliptic curve

Returns

string "X.zkey" where X is the public key in an encoding suitable for DNS labels.

Definition at line 236 of file gnsrecord_misc.c.

References GNUNET_CRYPTO_ecdsa_public_key_to_string(), GNUNET_free, GNUNET_snprintf(), and ret.

Referenced by caller_event_handler(), do_accept(), do_call(), do_resume(), do_status(), handle_phone_hangup(), phone_event_handler(), and translate_dot_plus().

{
  static char ret[128];
  char *pkeys;

  pkeys = GNUNET_CRYPTO_ecdsa_public_key_to_string (pkey);
  GNUNET_snprintf (ret,
                   sizeof (ret),
                   "%s",
                   pkeys);
  GNUNET_free (pkeys);
  return ret;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_zkey_to_pkey()

int GNUNET_GNSRECORD_zkey_to_pkey	(	const char *	zkey,
		struct GNUNET_CRYPTO_EcdsaPublicKey *	pkey
	)

Convert an absolute domain name to the respective public key.

Parameters

zkey	string "X" where X is the public key in an encoding suitable for DNS labels.
pkey	set to a public key on the eliptic curve

Returns

GNUNET_SYSERR if zkey has the wrong syntax

Parameters

zkey	string encoding the coordinates of the public key in an encoding suitable for DNS labels.
pkey	set to a public key on the eliptic curve

Returns

GNUNET_SYSERR if zkey has the wrong syntax

Definition at line 261 of file gnsrecord_misc.c.

References GNUNET_CRYPTO_ecdsa_public_key_from_string(), GNUNET_OK, and GNUNET_SYSERR.

Referenced by GNS_find_tld(), and recursive_gns2dns_resolution().

{
  if (GNUNET_OK !=
      GNUNET_CRYPTO_ecdsa_public_key_from_string (zkey,
                                                  strlen (zkey),
                                                  pkey))
    return GNUNET_SYSERR;
  return GNUNET_OK;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_query_from_private_key()

void GNUNET_GNSRECORD_query_from_private_key	(	const struct GNUNET_CRYPTO_EcdsaPrivateKey *	zone,
		const char *	label,
		struct GNUNET_HashCode *	query
	)

Calculate the DHT query for a given label in a given zone.

Parameters

zone	private key of the zone
label	label of the record
query	hash to use for the query

Definition at line 432 of file gnsrecord_crypto.c.

References GNUNET_CRYPTO_ecdsa_key_get_public(), and GNUNET_GNSRECORD_query_from_public_key().

Referenced by perform_dht_put().

{
  struct GNUNET_CRYPTO_EcdsaPublicKey pub;

  GNUNET_CRYPTO_ecdsa_key_get_public (zone,
                                      &pub);
  GNUNET_GNSRECORD_query_from_public_key (&pub,
                                          label,
                                          query);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_query_from_public_key()

void GNUNET_GNSRECORD_query_from_public_key	(	const struct GNUNET_CRYPTO_EcdsaPublicKey *	pub,
		const char *	label,
		struct GNUNET_HashCode *	query
	)

Calculate the DHT query for a given label in a given zone.

Parameters

pub	public key of the zone
label	label of the record
query	hash to use for the query

Definition at line 454 of file gnsrecord_crypto.c.

References GNUNET_CRYPTO_ecdsa_public_key_derive(), and GNUNET_CRYPTO_hash().

Referenced by GNUNET_GNSRECORD_query_from_private_key(), handle_namecache_block_response(), recursive_gns_resolution_namecache(), and run().

{
  struct GNUNET_CRYPTO_EcdsaPublicKey pd;

  GNUNET_CRYPTO_ecdsa_public_key_derive (pub,
                                         label,
                                         "gns",
                                         &pd);
  GNUNET_CRYPTO_hash (&pd,
                      sizeof (pd),
                      query);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_block_create()

struct GNUNET_GNSRECORD_Block* GNUNET_GNSRECORD_block_create	(	const struct GNUNET_CRYPTO_EcdsaPrivateKey *	key,
		struct GNUNET_TIME_Absolute	expire,
		const char *	label,
		const struct GNUNET_GNSRECORD_Data *	rd,
		unsigned int	rd_count
	)

Sign name and records.

Parameters

key	the private key
expire	block expiration
label	the name for the records
rd	record data
rd_count	number of records in rd
key	the private key
expire	block expiration
label	the name for the records
rd	record data
rd_count	number of records

Returns

NULL on error (block too large)

Definition at line 190 of file gnsrecord_crypto.c.

References block_create(), and GNUNET_CRYPTO_ecdsa_key_get_public().

Referenced by perform_dht_put(), and refresh_block().

{
  struct GNUNET_CRYPTO_EcdsaPublicKey pkey;

  GNUNET_CRYPTO_ecdsa_key_get_public (key,
                                      &pkey);
  return block_create (key,
                       &pkey,
                       expire,
                       label,
                       rd,
                       rd_count);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_block_create2()

struct GNUNET_GNSRECORD_Block* GNUNET_GNSRECORD_block_create2	(	const struct GNUNET_CRYPTO_EcdsaPrivateKey *	key,
		struct GNUNET_TIME_Absolute	expire,
		const char *	label,
		const struct GNUNET_GNSRECORD_Data *	rd,
		unsigned int	rd_count
	)

Sign name and records, cache derived public key (also keeps the private key in static memory, so do not use this function if keeping the private key in the process'es RAM is a major issue).

Parameters

key	the private key
expire	block expiration
label	the name for the records
rd	record data
rd_count	number of records in rd
key	the private key
expire	block expiration
label	the name for the records
rd	record data
rd_count	number of records

Returns

NULL on error (block too large)

Definition at line 240 of file gnsrecord_crypto.c.

References block_create(), CSIZE, GNUNET_CRYPTO_ecdsa_key_get_public(), KeyCacheLine::key, line, and KeyCacheLine::pkey.

Referenced by perform_dht_put(), and refresh_block().

{
#define CSIZE 64
  static struct KeyCacheLine cache[CSIZE];
  struct KeyCacheLine *line;

  line = &cache[(*(unsigned int *) key) % CSIZE];
  if (0 != memcmp (&line->key,
                   key,
                   sizeof (*key)))
  {
    /* cache miss, recompute */
    line->key = *key;
    GNUNET_CRYPTO_ecdsa_key_get_public (key,
                                        &line->pkey);
  }
#undef CSIZE
  return block_create (key,
                       &line->pkey,
                       expire,
                       label,
                       rd,
                       rd_count);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_block_verify()

int GNUNET_GNSRECORD_block_verify

(

const struct GNUNET_GNSRECORD_Block *

block

)

Check if a signature is valid.

This API is used by the GNS Block to validate signatures received from the network.

Parameters

block

block to verify

Returns

GNUNET_OK if the signature is valid

Definition at line 279 of file gnsrecord_crypto.c.

References GNUNET_GNSRECORD_Block::derived_key, GNUNET_CRYPTO_ecdsa_verify(), GNUNET_SIGNATURE_PURPOSE_GNS_RECORD_SIGN, GNUNET_GNSRECORD_Block::purpose, and GNUNET_GNSRECORD_Block::signature.

Referenced by block_plugin_gns_evaluate(), and handle_lookup_block_response().

{
  return GNUNET_CRYPTO_ecdsa_verify (GNUNET_SIGNATURE_PURPOSE_GNS_RECORD_SIGN,
                                     &block->purpose,
                                     &block->signature,
                                     &block->derived_key);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_block_decrypt()

int GNUNET_GNSRECORD_block_decrypt	(	const struct GNUNET_GNSRECORD_Block *	block,
		const struct GNUNET_CRYPTO_EcdsaPublicKey *	zone_key,
		const char *	label,
		GNUNET_GNSRECORD_RecordCallback	proc,
		void *	proc_cls
	)

Decrypt block.

Parameters

block	block to decrypt
zone_key	public key of the zone
label	the name for the records
proc	function to call with the result
proc_cls	closure for proc

Returns

GNUNET_OK on success, GNUNET_SYSERR if the block was not well-formed

Parameters

block	block to decrypt
zone_key	public key of the zone
label	the name for the records
proc	function to call with the result
proc_cls	closure for proc

Returns

GNUNET_OK on success, GNUNET_SYSERR if the block was not well-formed

Definition at line 300 of file gnsrecord_crypto.c.

References GNUNET_TIME_Absolute::abs_value_us, derive_block_aes_key(), GNUNET_GNSRECORD_Data::expiration_time, GNUNET_GNSRECORD_Data::flags, GNUNET_break, GNUNET_break_op, GNUNET_CRYPTO_symmetric_decrypt(), GNUNET_ERROR_TYPE_INFO, GNUNET_GNSRECORD_records_deserialize(), GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION, GNUNET_GNSRECORD_RF_SHADOW_RECORD, GNUNET_log, GNUNET_memcpy, GNUNET_NO, GNUNET_OK, GNUNET_STRINGS_absolute_time_to_string(), GNUNET_SYSERR, GNUNET_TIME_absolute_get(), GNUNET_YES, payload, GNUNET_GNSRECORD_Block::purpose, and GNUNET_CRYPTO_EccSignaturePurpose::size.

Referenced by handle_block(), handle_dht_response(), and handle_namecache_block_response().

{
  size_t payload_len = ntohl (block->purpose.size) -
    sizeof (struct GNUNET_CRYPTO_EccSignaturePurpose) -
    sizeof (struct GNUNET_TIME_AbsoluteNBO);
  struct GNUNET_CRYPTO_SymmetricInitializationVector iv;
  struct GNUNET_CRYPTO_SymmetricSessionKey skey;

  if (ntohl (block->purpose.size) <
      sizeof (struct GNUNET_CRYPTO_EccSignaturePurpose) +
      sizeof (struct GNUNET_TIME_AbsoluteNBO))
  {
    GNUNET_break_op (0);
    return GNUNET_SYSERR;
  }
  derive_block_aes_key (&iv,
                        &skey,
                        label,
                        zone_key);
  {
    char payload[payload_len];
    uint32_t rd_count;

    GNUNET_break (payload_len ==
                  GNUNET_CRYPTO_symmetric_decrypt (&block[1], payload_len,
                                                   &skey, &iv,
                                                   payload));
    GNUNET_memcpy (&rd_count,
                   payload,
                   sizeof (uint32_t));
    rd_count = ntohl (rd_count);
    if (rd_count > 2048)
    {
      /* limit to sane value */
      GNUNET_break_op (0);
      return GNUNET_SYSERR;
    }
    {
      struct GNUNET_GNSRECORD_Data rd[GNUNET_NZL(rd_count)];
      unsigned int j;
      struct GNUNET_TIME_Absolute now;

      if (GNUNET_OK !=
          GNUNET_GNSRECORD_records_deserialize (payload_len - sizeof (uint32_t),
                                                &payload[sizeof (uint32_t)],
                                                rd_count,
                                                rd))
      {
        GNUNET_break_op (0);
        return GNUNET_SYSERR;
      }
      /* hide expired records */
      now = GNUNET_TIME_absolute_get ();
      j = 0;
      for (unsigned int i=0;i<rd_count;i++)
      {
        if (0 != (rd[i].flags & GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION))
        {
          /* encrypted blocks must never have relative expiration times, skip! */
          GNUNET_break_op (0);
          continue;
        }

        if (0 != (rd[i].flags & GNUNET_GNSRECORD_RF_SHADOW_RECORD))
        {
          int include_record = GNUNET_YES;
          /* Shadow record, figure out if we have a not expired active record */
          for (unsigned int k=0;k<rd_count;k++)
          {
            if (k == i)
              continue;
            if (rd[i].expiration_time < now.abs_value_us)
              include_record = GNUNET_NO; /* Shadow record is expired */
            if ( (rd[k].record_type == rd[i].record_type) &&
                 (rd[k].expiration_time >= now.abs_value_us) &&
                 (0 == (rd[k].flags & GNUNET_GNSRECORD_RF_SHADOW_RECORD)) )
            {
              include_record = GNUNET_NO; /* We have a non-expired, non-shadow record of the same type */
              GNUNET_log (GNUNET_ERROR_TYPE_INFO,
                          "Ignoring shadow record\n");
              break;
            }
          }
          if (GNUNET_YES == include_record)
          {
            rd[i].flags ^= GNUNET_GNSRECORD_RF_SHADOW_RECORD; /* Remove Flag */
            if (j != i)
              rd[j] = rd[i];
            j++;
          }
        }
        else if (rd[i].expiration_time >= now.abs_value_us)
        {
          /* Include this record */
          if (j != i)
            rd[j] = rd[i];
          j++;
        }
        else
        {
          struct GNUNET_TIME_Absolute at;

          at.abs_value_us = rd[i].expiration_time;
          GNUNET_log (GNUNET_ERROR_TYPE_INFO,
                      "Excluding record that expired %s (%llu ago)\n",
                      GNUNET_STRINGS_absolute_time_to_string (at),
                      (unsigned long long) rd[i].expiration_time - now.abs_value_us);
        }
      }
      rd_count = j;
      if (NULL != proc)
        proc (proc_cls,
              rd_count,
              (0 != rd_count) ? rd : NULL);
    }
  }
  return GNUNET_OK;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_records_cmp()

int GNUNET_GNSRECORD_records_cmp	(	const struct GNUNET_GNSRECORD_Data *	a,
		const struct GNUNET_GNSRECORD_Data *	b
	)

Compares if two records are equal.

Parameters

a	a record
b	another record

Returns

GNUNET_YES if the records are equal, or GNUNET_NO if not.

Compares if two records are equal.

absolute expiration time).

Parameters

a	record
b	record

Returns

GNUNET_YES if the records are equal or GNUNET_NO if they are not

Definition at line 93 of file gnsrecord_misc.c.

References GNUNET_GNSRECORD_Data::data, GNUNET_GNSRECORD_Data::data_size, GNUNET_GNSRECORD_Data::expiration_time, GNUNET_GNSRECORD_Data::flags, GNUNET_ERROR_TYPE_DEBUG, GNUNET_GNSRECORD_RF_RCMP_FLAGS, GNUNET_NO, GNUNET_YES, LOG, and GNUNET_GNSRECORD_Data::record_type.

{
  LOG (GNUNET_ERROR_TYPE_DEBUG,
       "Comparing records\n");
  if (a->record_type != b->record_type)
  {
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Record type %lu != %lu\n", a->record_type, b->record_type);
    return GNUNET_NO;
  }
  if ((a->expiration_time != b->expiration_time) &&
      ((a->expiration_time != 0) && (b->expiration_time != 0)))
  {
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Expiration time %llu != %llu\n",
         a->expiration_time,
         b->expiration_time);
    return GNUNET_NO;
  }
  if ((a->flags & GNUNET_GNSRECORD_RF_RCMP_FLAGS)
       != (b->flags & GNUNET_GNSRECORD_RF_RCMP_FLAGS))
  {
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Flags %lu (%lu) != %lu (%lu)\n", a->flags,
         a->flags & GNUNET_GNSRECORD_RF_RCMP_FLAGS, b->flags,
         b->flags & GNUNET_GNSRECORD_RF_RCMP_FLAGS);
    return GNUNET_NO;
  }
  if (a->data_size != b->data_size)
  {
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Data size %lu != %lu\n",
         a->data_size,
         b->data_size);
    return GNUNET_NO;
  }
  if (0 != memcmp (a->data, b->data, a->data_size))
  {
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Data contents do not match\n");
    return GNUNET_NO;
  }
  LOG (GNUNET_ERROR_TYPE_DEBUG,
       "Records are equal\n");
  return GNUNET_YES;
}

GNUNET_GNSRECORD_record_get_expiration_time()

struct GNUNET_TIME_Absolute GNUNET_GNSRECORD_record_get_expiration_time	(	unsigned int	rd_count,
		const struct GNUNET_GNSRECORD_Data *	rd
	)

Returns the expiration time of the given block of records.

The block expiration time is the expiration time of the record with smallest expiration time.

Parameters

rd_count	number of records given in rd
rd	array of records

Returns

absolute expiration time

Definition at line 152 of file gnsrecord_misc.c.

References GNUNET_TIME_Absolute::abs_value_us, expire(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION, GNUNET_GNSRECORD_RF_SHADOW_RECORD, GNUNET_STRINGS_absolute_time_to_string(), GNUNET_TIME_absolute_max(), GNUNET_TIME_absolute_min(), GNUNET_TIME_relative_to_absolute(), GNUNET_TIME_UNIT_FOREVER_ABS, GNUNET_TIME_UNIT_ZERO_ABS, LOG, and GNUNET_TIME_Relative::rel_value_us.

Referenced by GNUNET_JSON_from_gnsrecord(), perform_dht_put(), and refresh_block().

{
  struct GNUNET_TIME_Absolute expire;
  struct GNUNET_TIME_Absolute at;
  struct GNUNET_TIME_Relative rt;
  struct GNUNET_TIME_Absolute at_shadow;
  struct GNUNET_TIME_Relative rt_shadow;

  if (NULL == rd)
    return GNUNET_TIME_UNIT_ZERO_ABS;
  expire = GNUNET_TIME_UNIT_FOREVER_ABS;
  for (unsigned int c = 0; c < rd_count; c++)
  {
    if (0 != (rd[c].flags & GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION))
    {
      rt.rel_value_us = rd[c].expiration_time;
      at = GNUNET_TIME_relative_to_absolute (rt);
    }
    else
    {
      at.abs_value_us = rd[c].expiration_time;
    }

    for (unsigned int c2 = 0; c2 < rd_count; c2++)
    {
      /* Check for shadow record */
      if ( (c == c2) ||
           (rd[c].record_type != rd[c2].record_type) ||
           (0 == (rd[c2].flags & GNUNET_GNSRECORD_RF_SHADOW_RECORD)) )
          continue;
      /* We have a shadow record */
      if (0 != (rd[c2].flags & GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION))
      {
        rt_shadow.rel_value_us = rd[c2].expiration_time;
        at_shadow = GNUNET_TIME_relative_to_absolute (rt_shadow);
      }
      else
      {
        at_shadow.abs_value_us = rd[c2].expiration_time;
      }
      at = GNUNET_TIME_absolute_max (at,
                                     at_shadow);
    }
    expire = GNUNET_TIME_absolute_min (at, 
                                       expire);
  }
  LOG (GNUNET_ERROR_TYPE_DEBUG,
       "Determined expiration time for block with %u records to be %s\n",
       rd_count,
       GNUNET_STRINGS_absolute_time_to_string (expire));
  return expire;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

GNUNET_GNSRECORD_RecordCallback

GNUNET_NETWORK_STRUCT_END typedef void(* GNUNET_GNSRECORD_RecordCallback) (void *cls, unsigned int rd_count, const struct GNUNET_GNSRECORD_Data *rd)

Process a records that were decrypted from a block.

Parameters

cls	closure
rd_count	number of entries in rd array
rd	array of records with data to store

Definition at line 346 of file gnunet_gnsrecord_lib.h.