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_EcdsaBlock
	Information we have in an encrypted block with record data (i.e. More...
struct	GNUNET_GNSRECORD_Block
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   GNUNET_IDENTITY_TYPE_ECDSA
	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_ATTRIBUTE   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_DELEGATE   65548
	65546 reserved More...
#define	GNUNET_GNSRECORD_TYPE_ATTRIBUTE   65549
	Record type for reverse lookups. More...
#define	GNUNET_GNSRECORD_TYPE_RECLAIM_ATTRIBUTE_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...
#define	GNUNET_GNSRECORD_TYPE_RECLAIM_CREDENTIAL   65554
	Record type for an attribute attestation. More...
#define	GNUNET_GNSRECORD_TYPE_RECLAIM_PRESENTATION   65555
	Record type for a presentation of a credential (used in a ticket record set) More...
#define	GNUNET_GNSRECORD_TYPE_EDKEY   GNUNET_IDENTITY_TYPE_EDDSA
	Record type for EDKEY delegations. More...

Typedefs
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...

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

Functions
struct GNUNET_JSON_Specification	GNUNET_GNSRECORD_JSON_spec_gnsrecord (struct GNUNET_GNSRECORD_Data **rd, unsigned int *rd_count, char **name)
	JSON Specification for GNS Records. More...
json_t *	GNUNET_GNSRECORD_JSON_from_gnsrecord (const char *rname, const struct GNUNET_GNSRECORD_Data *rd, unsigned int rd_count)
	Convert GNS record to JSON. More...
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_IDENTITY_PublicKey *z)
	Convert a zone to a string (for printing debug messages). More...
const char *	GNUNET_GNSRECORD_pkey_to_zkey (const struct GNUNET_IDENTITY_PublicKey *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_IDENTITY_PublicKey *pkey)
	Convert an absolute domain name to the respective public key. More...
void	GNUNET_GNSRECORD_query_from_private_key (const struct GNUNET_IDENTITY_PrivateKey *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_IDENTITY_PublicKey *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_IDENTITY_PrivateKey *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_IDENTITY_PrivateKey *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_IDENTITY_PublicKey *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...
size_t	GNUNET_GNSRECORD_block_get_size (const struct GNUNET_GNSRECORD_Block *block)
	Returns the length of this block in bytes. More...
struct GNUNET_TIME_Absolute	GNUNET_GNSRECORD_block_get_expiration (const struct GNUNET_GNSRECORD_Block *block)
	Returns the expiration of a block. More...
enum GNUNET_GenericReturnValue	GNUNET_GNSRECORD_query_from_block (const struct GNUNET_GNSRECORD_Block *block, struct GNUNET_HashCode *query)
	Builds the query hash from a block. More...
enum GNUNET_GenericReturnValue	GNUNET_GNSRECORD_identity_from_data (const char *data, size_t data_size, uint32_t type, struct GNUNET_IDENTITY_PublicKey *key)
	Build a #GNUNET_GNSRECORD_PublicKey from zone delegation resource record data. More...
enum GNUNET_GenericReturnValue	GNUNET_GNSRECORD_data_from_identity (const struct GNUNET_IDENTITY_PublicKey *key, char **data, size_t *data_size, uint32_t *type)
	Create record data and size from an identity key. More...
enum GNUNET_GenericReturnValue	GNUNET_GNSRECORD_is_zonekey_type (uint32_t type)
	Check if this type is one of the supported GNS zone types. 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 49 of file gnunet_gnsrecord_lib.h.

Referenced by block_create_ecdsa().

GNUNET_GNSRECORD_TYPE_ANY

#define GNUNET_GNSRECORD_TYPE_ANY   0

Record type indicating any record/'*'.

Definition at line 55 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(), lookup_authz_cb(), namestore_get(), namestore_list_iteration(), ns_get_lookup_cb(), process_lookup_result(), process_queue(), recursive_gns2dns_resolution(), and run().

GNUNET_GNSRECORD_TYPE_PKEY

#define GNUNET_GNSRECORD_TYPE_PKEY   GNUNET_IDENTITY_TYPE_ECDSA

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

Definition at line 60 of file gnunet_gnsrecord_lib.h.

Referenced by block_create_ecdsa(), get_existing_record(), gns_string_to_value(), gns_value_to_string(), GNUNET_GNSRECORD_block_create(), GNUNET_GNSRECORD_block_get_expiration(), GNUNET_GNSRECORD_block_get_size(), GNUNET_GNSRECORD_block_verify(), GNUNET_GNSRECORD_is_zonekey_type(), GNUNET_GNSRECORD_query_from_block(), GNUNET_GNSRECORD_query_from_private_key(), GNUNET_GNSRECORD_query_from_public_key(), GNUNET_GNSRECORD_record_to_identity_key(), GNUNET_GNSRECORD_records_get_size(), handle_gns_resolution_result(), iterate_cb(), and run().

GNUNET_GNSRECORD_TYPE_NICK

#define GNUNET_GNSRECORD_TYPE_NICK   65537

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

Definition at line 65 of file gnunet_gnsrecord_lib.h.

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

GNUNET_GNSRECORD_TYPE_LEHO

#define GNUNET_GNSRECORD_TYPE_LEHO   65538

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

Definition at line 70 of file gnunet_gnsrecord_lib.h.

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

GNUNET_GNSRECORD_TYPE_VPN

#define GNUNET_GNSRECORD_TYPE_VPN   65539

Record type for VPN resolution.

Definition at line 75 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 80 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 85 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 90 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 95 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_ATTRIBUTE

#define GNUNET_GNSRECORD_TYPE_RECLAIM_ATTRIBUTE   65544

Record type for identity attributes (of RECLAIM).

Definition at line 100 of file gnunet_gnsrecord_lib.h.

Referenced by attr_iter_cb(), attr_store_task(), consistency_iter(), process_parallel_lookup_result(), rvk_move_attr_cb(), 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 105 of file gnunet_gnsrecord_lib.h.

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

GNUNET_GNSRECORD_TYPE_DELEGATE

#define GNUNET_GNSRECORD_TYPE_DELEGATE   65548

65546 reserved

65547 deleted, free to use Record type for policies

Definition at line 118 of file gnunet_gnsrecord_lib.h.

Referenced by abd_string_to_value(), abd_value_to_string(), delegation_chain_fw_resolution_start(), forward_resolution(), handle_delegate_collection_cb(), run(), and store_cb().

GNUNET_GNSRECORD_TYPE_ATTRIBUTE

#define GNUNET_GNSRECORD_TYPE_ATTRIBUTE   65549

Record type for reverse lookups.

Definition at line 123 of file gnunet_gnsrecord_lib.h.

Referenced by abd_string_to_value(), abd_value_to_string(), backward_resolution(), delegation_chain_bw_resolution_start(), and run().

GNUNET_GNSRECORD_TYPE_RECLAIM_ATTRIBUTE_REF

#define GNUNET_GNSRECORD_TYPE_RECLAIM_ATTRIBUTE_REF   65550

Record type for reclaim records.

Definition at line 128 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(), 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 133 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 138 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 143 of file gnunet_gnsrecord_lib.h.

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

GNUNET_GNSRECORD_TYPE_RECLAIM_CREDENTIAL

#define GNUNET_GNSRECORD_TYPE_RECLAIM_CREDENTIAL   65554

Record type for an attribute attestation.

Definition at line 148 of file gnunet_gnsrecord_lib.h.

Referenced by consistency_iter(), cred_add_cb(), cred_iter_cb(), filter_tickets_cb(), rvk_move_attr_cb(), string_to_value(), and value_to_string().

GNUNET_GNSRECORD_TYPE_RECLAIM_PRESENTATION

#define GNUNET_GNSRECORD_TYPE_RECLAIM_PRESENTATION   65555

Record type for a presentation of a credential (used in a ticket record set)

Definition at line 154 of file gnunet_gnsrecord_lib.h.

Referenced by filter_tickets_cb(), issue_ticket(), lookup_authz_cb(), string_to_value(), update_tickets(), and value_to_string().

GNUNET_GNSRECORD_TYPE_EDKEY

#define GNUNET_GNSRECORD_TYPE_EDKEY   GNUNET_IDENTITY_TYPE_EDDSA

Record type for EDKEY delegations.

Definition at line 159 of file gnunet_gnsrecord_lib.h.

Referenced by get_existing_record(), gns_string_to_value(), gns_value_to_string(), GNUNET_GNSRECORD_is_zonekey_type(), handle_gns_resolution_result(), and iterate_cb().

Typedef Documentation

GNUNET_GNSRECORD_RecordCallback

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 375 of file gnunet_gnsrecord_lib.h.

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_SUPPLEMENTAL	This is a supplemental record.
GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION	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 165 of file gnunet_gnsrecord_lib.h.

{
  GNUNET_GNSRECORD_RF_NONE = 0,

  GNUNET_GNSRECORD_RF_PRIVATE = 2,

  GNUNET_GNSRECORD_RF_SUPPLEMENTAL = 4,

  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_JSON_spec_gnsrecord()

struct GNUNET_JSON_Specification GNUNET_GNSRECORD_JSON_spec_gnsrecord	(	struct GNUNET_GNSRECORD_Data **	rd,
		unsigned int *	rd_count,
		char **	name
	)

JSON Specification for GNS Records.

Parameters

gnsrecord_object

struct of GNUNET_GNSRECORD_Data to fill

Returns

JSON Specification

Definition at line 262 of file json_gnsrecord.c.

References clean_gnsrecordobject(), GNUNET_new, GnsRecordInfo::name, parse_gnsrecordobject(), GNUNET_JSON_Specification::parser, GnsRecordInfo::rd, GnsRecordInfo::rd_count, and ret.

Referenced by namestore_add_or_update().

{
  struct GnsRecordInfo *gnsrecord_info = GNUNET_new (struct GnsRecordInfo);

  gnsrecord_info->rd = rd;
  gnsrecord_info->name = name;
  gnsrecord_info->rd_count = rd_count;
  struct GNUNET_JSON_Specification ret = { .parser = &parse_gnsrecordobject,
                                           .cleaner = &clean_gnsrecordobject,
                                           .cls = NULL,
                                           .field = NULL,
                                           .ptr = (struct GnsRecordInfo *)
                                                  gnsrecord_info,
                                           .ptr_size = 0,
                                           .size_ptr = NULL };
  return ret;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_JSON_from_gnsrecord()

json_t* GNUNET_GNSRECORD_JSON_from_gnsrecord	(	const char *	rname,
		const struct GNUNET_GNSRECORD_Data *	rd,
		unsigned int	rd_count
	)

Convert GNS record to JSON.

Parameters

rname	name of record
rd	record data

Returns

corresponding JSON encoding

Definition at line 291 of file json_gnsrecord.c.

References GNUNET_TIME_Absolute::abs_value_us, data, data_size, GNUNET_GNSRECORD_Data::expiration_time, GNUNET_break, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_GNSRECORD_number_to_typename(), GNUNET_GNSRECORD_RF_PRIVATE, GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION, GNUNET_GNSRECORD_RF_SHADOW_RECORD, GNUNET_GNSRECORD_RF_SUPPLEMENTAL, GNUNET_GNSRECORD_value_to_string(), GNUNET_log, GNUNET_NO, GNUNET_STRINGS_absolute_time_to_string(), GNUNET_STRINGS_relative_time_to_string(), GnsRecordInfo::rd_count, record(), records, and GNUNET_TIME_Relative::rel_value_us.

Referenced by handle_gns_response(), namestore_list_iteration(), and ns_get_lookup_cb().

{
  struct GNUNET_TIME_Absolute abs_exp;
  struct GNUNET_TIME_Relative rel_exp;
  const char *expiration_time_str;
  const char *record_type_str;
  char *value_str;
  json_t *data;
  json_t *record;
  json_t *records;

  data = json_object ();
  if (NULL == data)
  {
    GNUNET_break (0);
    return NULL;
  }
  if (0 !=
      json_object_set_new (data,
                           "record_name",
                           json_string (rname)))
  {
    GNUNET_break (0);
    json_decref (data);
    return NULL;
  }
  records = json_array ();
  if (NULL == records)
  {
    GNUNET_break (0);
    json_decref (data);
    return NULL;
  }
  for (int i = 0; i < rd_count; i++)
  {
    value_str = GNUNET_GNSRECORD_value_to_string (rd[i].record_type,
                                                  rd[i].data,
                                                  rd[i].data_size);
    if (GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION & rd[i].flags)
    {
      rel_exp.rel_value_us = rd[i].expiration_time;
      expiration_time_str = GNUNET_STRINGS_relative_time_to_string (rel_exp,
                                                                    GNUNET_NO);
    }
    else
    {
      abs_exp.abs_value_us = rd[i].expiration_time;
      expiration_time_str = GNUNET_STRINGS_absolute_time_to_string (abs_exp);
    }
    record_type_str = GNUNET_GNSRECORD_number_to_typename (rd[i].record_type);
    GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
                "Packing %s %s %s %d\n",
                value_str, record_type_str, expiration_time_str, rd[i].flags);
    record = json_pack ("{s:s,s:s,s:s,s:b,s:b,s:b,s:b}",
                        "value",
                        value_str,
                        "record_type",
                        record_type_str,
                        "expiration_time",
                        expiration_time_str,
                        "private",
                        rd[i].flags & GNUNET_GNSRECORD_RF_PRIVATE,
                        "relative_expiration",
                        rd[i].flags & GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION,
                        "supplemental",
                        rd[i].flags & GNUNET_GNSRECORD_RF_SUPPLEMENTAL,
                        "shadow",
                        rd[i].flags & GNUNET_GNSRECORD_RF_SHADOW_RECORD);
    GNUNET_free (value_str);
    if (NULL == record)
    {
      GNUNET_break (0);
      json_decref (records);
      json_decref (data);
      return NULL;
    }
    if (0 !=
        json_array_append_new (records,
                               record))
    {
      GNUNET_break (0);
      json_decref (records);
      json_decref (data);
      return NULL;
    }
  }
  if (0 !=
      json_object_set_new (data,
                           "data",
                           records))
  {
    GNUNET_break (0);
    json_decref (data);
    return NULL;
  }
  return data;
}

Here is the call graph for this function:

Here is the caller graph for this function:

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 159 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_JSON_from_gnsrecord(), GNUNET_GNSRECORD_records_deserialize(), GNUNET_GNSRECORD_records_get_size(), GNUNET_GNSRECORD_records_serialize(), 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 191 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(), run(), run_with_zone_pkey(), and store_cb().

{
  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 220 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(), namestore_get(), 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 247 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_GNSRECORD_JSON_from_gnsrecord(), multirecord_process(), process_lookup_result(), and run_with_zone_pkey().

{
  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 88 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_ecdsa(), consistency_iter(), GNUNET_NAMESTORE_records_store(), handle_gns_resolution_result(), handle_zone_to_name_it(), lookup_it(), namestore_postgres_store_records(), namestore_sqlite_store_records(), run(), rvk_ticket_update(), send_lookup_response(), and store_and_free_entries().

{
  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 154 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_ecdsa(), consistency_iter(), GNUNET_NAMESTORE_records_store(), handle_gns_resolution_result(), handle_zone_to_name_it(), lookup_it(), namestore_postgres_store_records(), namestore_sqlite_store_records(), run(), rvk_ticket_update(), send_lookup_response(), and store_and_free_entries().

{
  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 227 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 block_decrypt_ecdsa(), check_rd(), check_result(), continue_store_activity(), database_setup(), get_records_and_call_iterator(), 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 216 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_IDENTITY_PublicKey *

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_IDENTITY_PublicKey) * 8];
  char *end;

  end = GNUNET_STRINGS_data_to_string ((const unsigned char *) z,
                                       sizeof(struct
                                              GNUNET_IDENTITY_PublicKey),
                                       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_IDENTITY_PublicKey *

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 239 of file gnsrecord_misc.c.

References GNUNET_free, GNUNET_IDENTITY_public_key_to_string(), 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_IDENTITY_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_IDENTITY_PublicKey *	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 264 of file gnsrecord_misc.c.

References GNUNET_IDENTITY_public_key_from_string(), GNUNET_OK, and GNUNET_SYSERR.

Referenced by GNS_find_tld(), handle_gns_cname_result(), and recursive_gns2dns_resolution().

{
  if (GNUNET_OK !=
      GNUNET_IDENTITY_public_key_from_string (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_IDENTITY_PrivateKey *	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 549 of file gnsrecord_crypto.c.

References GNUNET_assert, GNUNET_GNSRECORD_query_from_public_key(), GNUNET_GNSRECORD_TYPE_PKEY, GNUNET_IDENTITY_key_get_public(), and GNUNET_IDENTITY_PrivateKey::type.

Referenced by perform_dht_put().

{
  struct GNUNET_IDENTITY_PublicKey pub;
  switch (ntohl (zone->type))
  {
  case GNUNET_GNSRECORD_TYPE_PKEY:

    GNUNET_IDENTITY_key_get_public (zone,
                                    &pub);
    GNUNET_GNSRECORD_query_from_public_key (&pub,
                                            label,
                                            query);
    break;
  default:
    GNUNET_assert (0);
  }
}

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_IDENTITY_PublicKey *	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 579 of file gnsrecord_crypto.c.

References GNUNET_IDENTITY_PublicKey::ecdsa_key, GNUNET_assert, GNUNET_CRYPTO_ecdsa_public_key_derive(), GNUNET_CRYPTO_hash(), GNUNET_GNSRECORD_TYPE_PKEY, and GNUNET_IDENTITY_PublicKey::type.

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

{
  struct GNUNET_IDENTITY_PublicKey pd;

  switch (ntohl (pub->type))
  {
  case GNUNET_GNSRECORD_TYPE_PKEY:
    pd.type = pub->type;
    GNUNET_CRYPTO_ecdsa_public_key_derive (&pub->ecdsa_key,
                                           label,
                                           "gns",
                                           &pd.ecdsa_key);
    GNUNET_CRYPTO_hash (&pd.ecdsa_key,
                        sizeof (pd.ecdsa_key),
                        query);
    break;
  default:
    GNUNET_assert (0);
  }
}

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_IDENTITY_PrivateKey *	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 259 of file gnsrecord_crypto.c.

References block_create_ecdsa(), GNUNET_IDENTITY_PrivateKey::ecdsa_key, GNUNET_assert, GNUNET_CRYPTO_ecdsa_key_get_public(), GNUNET_GNSRECORD_TYPE_PKEY, and GNUNET_IDENTITY_PrivateKey::type.

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

{
  struct GNUNET_CRYPTO_EcdsaPublicKey pkey;

  switch (ntohl (key->type))
  {
  case GNUNET_GNSRECORD_TYPE_PKEY:
    GNUNET_CRYPTO_ecdsa_key_get_public (&key->ecdsa_key,
                                        &pkey);
    return block_create_ecdsa (&key->ecdsa_key,
                               &pkey,
                               expire,
                               label,
                               rd,
                               rd_count);
  default:
    GNUNET_assert (0);
  }
  return NULL;
}

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_IDENTITY_PrivateKey *	pkey,
		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 315 of file gnsrecord_crypto.c.

References block_create_ecdsa(), CSIZE, GNUNET_IDENTITY_PrivateKey::ecdsa_key, GNUNET_CRYPTO_ecdsa_key_get_public(), GNUNET_IDENTITY_TYPE_ECDSA, KeyCacheLine::key, line, KeyCacheLine::pkey, and GNUNET_IDENTITY_PrivateKey::type.

Referenced by perform_dht_put(), and refresh_block().

{
  const struct GNUNET_CRYPTO_EcdsaPrivateKey *key;

  if (GNUNET_IDENTITY_TYPE_ECDSA != ntohl (pkey->type))
  {
    return NULL; // FIXME
  }
  key = &pkey->ecdsa_key;
#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_ecdsa (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 360 of file gnsrecord_crypto.c.

References GNUNET_GNSRECORD_EcdsaBlock::derived_key, GNUNET_GNSRECORD_Block::ecdsa_block, GNUNET_break, GNUNET_CRYPTO_ecdsa_verify_(), GNUNET_GNSRECORD_TYPE_PKEY, GNUNET_NO, GNUNET_SIGNATURE_PURPOSE_GNS_RECORD_SIGN, KeyCacheLine::key, GNUNET_GNSRECORD_EcdsaBlock::purpose, GNUNET_GNSRECORD_EcdsaBlock::signature, and GNUNET_GNSRECORD_Block::type.

Referenced by block_plugin_gns_evaluate(), and handle_lookup_block_response().

{
  const struct GNUNET_CRYPTO_EcdsaPublicKey *key;
  const struct GNUNET_GNSRECORD_EcdsaBlock *ecblock;

  if (GNUNET_GNSRECORD_TYPE_PKEY != ntohl (block->type))
  {
    GNUNET_break (0);
    return GNUNET_NO;
  }
  ecblock = &block->ecdsa_block;
  key = &ecblock->derived_key;

  return GNUNET_CRYPTO_ecdsa_verify_ (GNUNET_SIGNATURE_PURPOSE_GNS_RECORD_SIGN,
                                      &ecblock->purpose,
                                      &ecblock->signature,
                                      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_IDENTITY_PublicKey *	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 520 of file gnsrecord_crypto.c.

References block_decrypt_ecdsa(), GNUNET_GNSRECORD_Block::ecdsa_block, GNUNET_IDENTITY_PublicKey::ecdsa_key, GNUNET_IDENTITY_TYPE_ECDSA, GNUNET_NO, KeyCacheLine::key, and GNUNET_IDENTITY_PublicKey::type.

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

{
  const struct GNUNET_CRYPTO_EcdsaPublicKey *key;

  if (GNUNET_IDENTITY_TYPE_ECDSA != ntohl (zone_key->type))
  {
    return GNUNET_NO;
  }
  key = &zone_key->ecdsa_key;

  return block_decrypt_ecdsa (&block->ecdsa_block,
                              key, label, proc, proc_cls);

}

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 94 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 %u != %u\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",
         (unsigned long long) a->expiration_time,
         (unsigned long long) 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 %u (%u) != %u (%u)\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 153 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 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:

GNUNET_GNSRECORD_block_get_size()

size_t GNUNET_GNSRECORD_block_get_size

(

const struct GNUNET_GNSRECORD_Block *

block

)

Returns the length of this block in bytes.

Block length strongly depends on the zone type.

Parameters

block

the block.

Returns

the length of this block in bytes

Definition at line 326 of file gnsrecord_misc.c.

References GNUNET_GNSRECORD_Block::ecdsa_block, GNUNET_GNSRECORD_TYPE_PKEY, GNUNET_GNSRECORD_EcdsaBlock::purpose, GNUNET_CRYPTO_EccSignaturePurpose::size, and GNUNET_GNSRECORD_Block::type.

Referenced by block_plugin_gns_evaluate(), GNUNET_NAMECACHE_block_cache(), handle_dht_response(), handle_lookup_block_it(), namecache_cache_block(), namecache_postgres_cache_block(), namecache_sqlite_cache_block(), perform_dht_put(), and store_and_free_entries().

{
  switch (ntohl (block->type))
  {
  case GNUNET_GNSRECORD_TYPE_PKEY:
    return sizeof (uint32_t)   /* zone type */
           + sizeof (block->ecdsa_block)   /* EcdsaBlock */
           + ntohl (block->ecdsa_block.purpose.size)   /* Length of signed data */
           - sizeof (block->ecdsa_block.purpose);   /* Purpose already in EcdsaBlock */
    break;
  default:
    return 0;
  }
  return 0;
}

Here is the caller graph for this function:

GNUNET_GNSRECORD_block_get_expiration()

struct GNUNET_TIME_Absolute GNUNET_GNSRECORD_block_get_expiration

(

const struct GNUNET_GNSRECORD_Block *

block

)

Returns the expiration of a block.

Parameters

block

the block.

Returns

the block expiration.

Definition at line 344 of file gnsrecord_misc.c.

References GNUNET_GNSRECORD_TYPE_PKEY, GNUNET_TIME_absolute_get_zero_(), and GNUNET_TIME_absolute_ntoh().

Referenced by expire_blocks(), handle_dht_response(), handle_lookup_block_it(), handle_namecache_block_response(), namecache_postgres_cache_block(), and namecache_sqlite_cache_block().

{

  switch (ntohl (block->type))
  {
  case GNUNET_GNSRECORD_TYPE_PKEY:
    return GNUNET_TIME_absolute_ntoh (block->ecdsa_block.expiration_time);
  default:
    return GNUNET_TIME_absolute_get_zero_ ();
  }
  return GNUNET_TIME_absolute_get_zero_ ();

}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_query_from_block()

enum GNUNET_GenericReturnValue GNUNET_GNSRECORD_query_from_block	(	const struct GNUNET_GNSRECORD_Block *	block,
		struct GNUNET_HashCode *	query
	)

Builds the query hash from a block.

Parameters

block	the block.
query	where to write the query hash.

Returns

GNUNET_SYSERR on error.

Definition at line 361 of file gnsrecord_misc.c.

References GNUNET_GNSRECORD_EcdsaBlock::derived_key, GNUNET_GNSRECORD_Block::ecdsa_block, GNUNET_CRYPTO_hash(), GNUNET_GNSRECORD_TYPE_PKEY, GNUNET_OK, GNUNET_SYSERR, and GNUNET_GNSRECORD_Block::type.

Referenced by block_plugin_gns_evaluate(), block_plugin_gns_get_key(), namecache_cache_block(), namecache_postgres_cache_block(), and namecache_sqlite_cache_block().

{
  switch (ntohl (block->type))
  {
  case GNUNET_GNSRECORD_TYPE_PKEY:
    GNUNET_CRYPTO_hash (&block->ecdsa_block.derived_key,
                        sizeof (block->ecdsa_block.derived_key),
                        query);
    return GNUNET_OK;
  default:
    return GNUNET_SYSERR;
  }
  return GNUNET_SYSERR;

}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_identity_from_data()

enum GNUNET_GenericReturnValue GNUNET_GNSRECORD_identity_from_data	(	const char *	data,
		size_t	data_size,
		uint32_t	type,
		struct GNUNET_IDENTITY_PublicKey *	key
	)

Build a #GNUNET_GNSRECORD_PublicKey from zone delegation resource record data.

Parameters

data	the record data-
data_size	the data size.
type	the record type
key	the identity key to store the data in (must be allocated).

Returns

GNUNET_OK if successful.

Definition at line 276 of file gnsrecord_misc.c.

References GNUNET_GNSRECORD_is_zonekey_type(), GNUNET_IDENTITY_read_key_from_buffer(), GNUNET_NO, GNUNET_OK, and GNUNET_SYSERR.

Referenced by check_pkey(), gns_value_to_string(), handle_gns_resolution_result(), namestore_postgres_store_records(), namestore_sqlite_store_records(), and recursive_pkey_resolution().

{
  if (GNUNET_NO == GNUNET_GNSRECORD_is_zonekey_type (type))
    return GNUNET_SYSERR;
  if (data_size > sizeof (struct GNUNET_IDENTITY_PublicKey))
    return GNUNET_SYSERR;
  return (GNUNET_IDENTITY_read_key_from_buffer (key, data, data_size) ==
          data_size?
          GNUNET_OK :
          GNUNET_SYSERR);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_data_from_identity()

enum GNUNET_GenericReturnValue GNUNET_GNSRECORD_data_from_identity	(	const struct GNUNET_IDENTITY_PublicKey *	key,
		char **	data,
		size_t *	data_size,
		uint32_t *	type
	)

Create record data and size from an identity key.

Parameters

key	the identity key to use.
data	the record data (will be allocated)
data_size	the allocated data size.
type	the resulting record type

Returns

GNUNET_OK if successful.

Definition at line 293 of file gnsrecord_misc.c.

References GNUNET_IDENTITY_key_get_length(), GNUNET_IDENTITY_write_key_to_buffer(), GNUNET_malloc, GNUNET_OK, GNUNET_SYSERR, and GNUNET_IDENTITY_PublicKey::type.

Referenced by gns_string_to_value(), and zone_to_name_cb().

{
  *type = ntohl (key->type);
  *data_size = GNUNET_IDENTITY_key_get_length (key);
  if (0 == *data_size)
    return GNUNET_SYSERR;
  *data = GNUNET_malloc (*data_size);
  return (GNUNET_IDENTITY_write_key_to_buffer (key, *data, *data_size) ==
          *data_size?
          GNUNET_OK :
          GNUNET_SYSERR);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_GNSRECORD_is_zonekey_type()

enum GNUNET_GenericReturnValue GNUNET_GNSRECORD_is_zonekey_type

(

uint32_t

type

)

Check if this type is one of the supported GNS zone types.

Parameters

type	the type to check

Returns

GNUNET_YES if it is one of the supported types.

Definition at line 312 of file gnsrecord_misc.c.

References GNUNET_GNSRECORD_TYPE_EDKEY, GNUNET_GNSRECORD_TYPE_PKEY, GNUNET_NO, and GNUNET_YES.

Referenced by GNUNET_GNSRECORD_identity_from_data(), namestore_postgres_store_records(), namestore_sqlite_store_records(), and zone_to_name().

{
  switch (type)
  {
  case GNUNET_GNSRECORD_TYPE_PKEY:
  case GNUNET_GNSRECORD_TYPE_EDKEY:
    return GNUNET_YES;
  default:
    return GNUNET_NO;
  }
}

Here is the caller graph for this function: