gnunet_json_lib.h File Reference

functions to parse JSON objects into GNUnet objects More...

#include "gnunet_util_lib.h"
#include <jansson.h>

Include dependency graph for gnunet_json_lib.h:

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

Go to the source code of this file.

Data Structures
struct	GNUNET_JSON_Specification
	Entry in parser specification for GNUNET_JSON_parse(). More...
struct	GNUNET_JSON_PackSpec
	Element in the array to give to the packer. More...

Macros
#define	GNUNET_JSON_spec_fixed_auto(name, obj)    GNUNET_JSON_spec_fixed (name, (obj), sizeof(*(obj)))
	Fixed size object (in network byte order, encoded using Crockford Base32hex encoding).
#define	GNUNET_JSON_spec_fixed64_auto(name, obj)    GNUNET_JSON_spec_fixed (name, (obj), sizeof(*(obj)))
	Fixed size object (in network byte order, encoded using base64 encoding).
#define	GNUNET_JSON_from_data_auto(ptr)    GNUNET_JSON_from_data (ptr, sizeof(*(ptr)))
	Convert binary data to a JSON string with the base32crockford encoding.
#define	GNUNET_JSON_from_data64_auto(ptr)    GNUNET_JSON_from_data64 (ptr, sizeof(*(ptr)))
	Convert binary data to a JSON string with base64 encoding.
#define	GNUNET_JSON_PACK(...)
	Pack a JSON object from a spec.
#define	GNUNET_JSON_pack_data_auto(name, blob)    GNUNET_JSON_pack_data_varsize (name, (blob), sizeof (*(blob)))
	Generate packer instruction for a JSON field where the size is automatically determined from the argument.
#define	GNUNET_JSON_pack_data64_auto(name, blob)    GNUNET_JSON_pack_data64_varsize (name, (blob), sizeof (*(blob)))
	Generate packer instruction for a JSON field where the size is automatically determined from the argument.

Typedefs
typedef enum GNUNET_GenericReturnValue(*	GNUNET_JSON_Parser) (void *cls, json_t *root, struct GNUNET_JSON_Specification *spec)
	Function called to parse JSON argument.
typedef void(*	GNUNET_JSON_Cleaner) (void *cls, struct GNUNET_JSON_Specification *spec)
	Function called to clean up data from earlier parsing.
typedef json_t *(*	GNUNET_JSON_PackCallback) (const struct GNUNET_JSON_PackSpec *se)
	Function called to pack an element into the JSON object as part of GNUNET_JSON_pack_().

Functions
enum GNUNET_GenericReturnValue	GNUNET_JSON_parse (const json_t *root, struct GNUNET_JSON_Specification *spec, const char **error_json_name, unsigned int *error_line)
	Navigate and parse data in a JSON tree.
void	GNUNET_JSON_parse_free (struct GNUNET_JSON_Specification *spec)
	Frees all elements allocated during a GNUNET_JSON_parse() operation.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_end (void)
	End of a parser specification.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_mark_optional (struct GNUNET_JSON_Specification spec, bool *missing)
	Set the "optional" flag for a parser specification entry.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_fixed (const char *name, void *obj, size_t size)
	Variable size object (in network byte order, encoded using Crockford Base32hex encoding).
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_fixed64 (const char *name, void *obj, size_t size)
	Variable size object (in network byte order, encoded using base64 encoding).
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_varsize (const char *name, void **obj, size_t *size)
	Variable size object (in network byte order, encoded using Crockford Base32hex encoding).
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_string (const char *name, const char **strptr)
	The expected field stores a string.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_string_copy (const char *name, char **strptr)
	The expected field stores a string.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_json (const char *name, json_t **jsonp)
	JSON object or array.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_object_copy (const char *name, json_t **jsonp)
	JSON object, reference counter incremented.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_array_copy (const char *name, json_t **jsonp)
	JSON array, reference counter incremented.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_object_const (const char *name, const json_t **jsonp)
	JSON object, reference counter not incremented.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_array_const (const char *name, const json_t **jsonp)
	JSON array, reference counter not incremented.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_bool (const char *name, bool *b)
	boolean.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_double (const char *name, double *f)
	double.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_uint8 (const char *name, uint8_t *u8)
	8-bit integer.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_uint16 (const char *name, uint16_t *u16)
	16-bit integer.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_uint32 (const char *name, uint32_t *u32)
	32-bit integer.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_uint (const char *name, unsigned int *ui)
	Unsigned integer.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_ull (const char *name, unsigned long long *ull)
	Unsigned long long.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_uint64 (const char *name, uint64_t *u64)
	64-bit integer.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_int16 (const char *name, int16_t *i16)
	16-bit signed integer.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_int64 (const char *name, int64_t *i64)
	64-bit signed integer.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_boolean (const char *name, int *boolean)
	Boolean (true mapped to GNUNET_YES, false mapped to GNUNET_NO).
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_timestamp (const char *name, struct GNUNET_TIME_Timestamp *t)
	Timestamp.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_timestamp_nbo (const char *name, struct GNUNET_TIME_TimestampNBO *tn)
	Timestamp in network byte order.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_relative_time (const char *name, struct GNUNET_TIME_Relative *rt)
	Relative time.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_rsa_public_key (const char *name, struct GNUNET_CRYPTO_RsaPublicKey **pk)
	Specification for parsing an RSA public key.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_rsa_signature (const char *name, struct GNUNET_CRYPTO_RsaSignature **sig)
	Specification for parsing an RSA signature.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_blinded_message (const char *name, struct GNUNET_CRYPTO_BlindedMessage **msg)
	Specification for parsing a blinded message.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_blinded_signature (const char *field, struct GNUNET_CRYPTO_BlindedSignature **b_sig)
	Specification for parsing a blinded signature.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_unblinded_signature (const char *field, struct GNUNET_CRYPTO_UnblindedSignature **ub_sig)
	Specification for parsing an unblinded signature.
json_t *	GNUNET_JSON_from_data (const void *data, size_t size)
	Convert binary data to a JSON string with the base32crockford encoding.
json_t *	GNUNET_JSON_from_data64 (const void *data, size_t size)
	Convert binary data to a JSON string with base64 encoding.
json_t *	GNUNET_JSON_from_timestamp (struct GNUNET_TIME_Timestamp stamp)
	Convert timestamp to a json string.
json_t *	GNUNET_JSON_from_timestamp_nbo (struct GNUNET_TIME_TimestampNBO stamp)
	Convert timestamp to a json string.
json_t *	GNUNET_JSON_from_time_rel (struct GNUNET_TIME_Relative stamp)
	Convert relative timestamp to a json string.
json_t *	GNUNET_JSON_from_rsa_public_key (const struct GNUNET_CRYPTO_RsaPublicKey *pk)
	Convert RSA public key to JSON.
json_t *	GNUNET_JSON_from_rsa_signature (const struct GNUNET_CRYPTO_RsaSignature *sig)
	Convert RSA signature to JSON.
struct GNUNET_GETOPT_CommandLineOption	GNUNET_JSON_getopt (char shortName, const char *name, const char *argumentHelp, const char *description, json_t **json)
	Allow user to specify a JSON input value.
json_t *	GNUNET_JSON_pack_ (struct GNUNET_JSON_PackSpec spec[])
	Pack a JSON object from a spec.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_end_ (void)
	Do not use directly.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_allow_null (struct GNUNET_JSON_PackSpec in)
	Modify packer instruction to allow NULL as a value.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_bool (const char *name, bool b)
	Generate packer instruction for a JSON field of type bool.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_double (const char *name, double f)
	Generate packer instruction for a JSON field of type double.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_string (const char *name, const char *s)
	Generate packer instruction for a JSON field of type string.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_uint64 (const char *name, uint64_t num)
	Generate packer instruction for a JSON field of type unsigned integer.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_int64 (const char *name, int64_t num)
	Generate packer instruction for a JSON field of type signed integer.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_object_steal (const char *name, json_t *o)
	Generate packer instruction for a JSON field of type JSON object where the reference is taken over by the packer.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_object_incref (const char *name, json_t *o)
	Generate packer instruction for a JSON field of type JSON object where the reference counter is incremented by the packer.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_array_steal (const char *name, json_t *a)
	Generate packer instruction for a JSON field of type JSON array where the reference is taken over by the packer.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_array_incref (const char *name, json_t *a)
	Generate packer instruction for a JSON field of type JSON array where the reference counter is incremented by the packer.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_data_varsize (const char *name, const void *blob, size_t blob_size)
	Generate packer instruction for a JSON field of type variable size binary blob.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_data64_varsize (const char *name, const void *blob, size_t blob_size)
	Generate packer instruction for a JSON field of type variable size binary blob.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_time_rounder_interval (const char *name, enum GNUNET_TIME_RounderInterval ri)
	Generate packer instruction of a time rounder interval.
struct GNUNET_JSON_Specification	GNUNET_JSON_spec_time_rounder_interval (const char *name, enum GNUNET_TIME_RounderInterval *ri)
	Provide specification to parse a time rounder interval.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_timestamp (const char *name, struct GNUNET_TIME_Timestamp at)
	Generate packer instruction for a JSON field of type timestamp.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_timestamp_nbo (const char *name, struct GNUNET_TIME_TimestampNBO at)
	Generate packer instruction for a JSON field of type timestamp in network byte order.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_time_rel (const char *name, struct GNUNET_TIME_Relative rt)
	Generate packer instruction for a JSON field of type relative time.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_time_rel_nbo (const char *name, struct GNUNET_TIME_RelativeNBO rt)
	Generate packer instruction for a JSON field of type relative time in network byte order.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_rsa_public_key (const char *name, const struct GNUNET_CRYPTO_RsaPublicKey *pk)
	Generate packer instruction for a JSON field of type RSA public key.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_rsa_signature (const char *name, const struct GNUNET_CRYPTO_RsaSignature *sig)
	Generate packer instruction for a JSON field of type RSA signature.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_unblinded_signature (const char *name, const struct GNUNET_CRYPTO_UnblindedSignature *sig)
	Generate packer instruction for a JSON field of type unblinded signature.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_blinded_message (const char *name, const struct GNUNET_CRYPTO_BlindedMessage *msg)
	Generate packer instruction for a JSON field of type blinded message.
struct GNUNET_JSON_PackSpec	GNUNET_JSON_pack_blinded_sig (const char *name, const struct GNUNET_CRYPTO_BlindedSignature *sig)
	Generate packer instruction for a JSON field of type blinded signature.

Detailed Description

functions to parse JSON objects into GNUnet objects

Author

Florian Dold

Benedikt Mueller

Christian Grothoff

Definition in file gnunet_json_lib.h.

Macro Definition Documentation

GNUNET_JSON_spec_fixed_auto

#define GNUNET_JSON_spec_fixed_auto	(		name,
			obj
	)		GNUNET_JSON_spec_fixed (name, (obj), sizeof(*(obj)))

Fixed size object (in network byte order, encoded using Crockford Base32hex encoding).

Parameters

name	name of the JSON field
obj	pointer where to write the data (type of *obj will determine size)

Definition at line 200 of file gnunet_json_lib.h.

{
  const char *field_name;
 
  json_t *object;
 
  bool allow_null;
 
  bool final;
};
 
 
json_t *
GNUNET_JSON_pack_ (struct GNUNET_JSON_PackSpec spec[]);
 
 
#define GNUNET_JSON_PACK(...) \
        GNUNET_JSON_pack_ ((struct GNUNET_JSON_PackSpec[]) {__VA_ARGS__, \
                                                            GNUNET_JSON_pack_end_ ()})
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_end_ (void);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_allow_null (struct GNUNET_JSON_PackSpec in);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_bool (const char *name,
                       bool b);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_double (const char *name,
                         double f);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_string (const char *name,
                         const char *s);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_uint64 (const char *name,
                         uint64_t num);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_int64 (const char *name,
                        int64_t num);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_object_steal (const char *name,
                               json_t *o);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_object_incref (const char *name,
                                json_t *o);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_array_steal (const char *name,
                              json_t *a);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_array_incref (const char *name,
                               json_t *a);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_data_varsize (const char *name,
                               const void *blob,
                               size_t blob_size);
 
 
#define GNUNET_JSON_pack_data_auto(name,blob) \
        GNUNET_JSON_pack_data_varsize (name, (blob), sizeof (*(blob)))
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_data64_varsize (const char *name,
                                 const void *blob,
                                 size_t blob_size);
 
 
#define GNUNET_JSON_pack_data64_auto(name,blob) \
        GNUNET_JSON_pack_data64_varsize (name, (blob), sizeof (*(blob)))
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_time_rounder_interval (const char *name,
                                        enum GNUNET_TIME_RounderInterval ri);
 
 
struct GNUNET_JSON_Specification
GNUNET_JSON_spec_time_rounder_interval (
  const char *name,
  enum GNUNET_TIME_RounderInterval *ri);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_timestamp (const char *name,
                            struct GNUNET_TIME_Timestamp at);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_timestamp_nbo (const char *name,
                                struct GNUNET_TIME_TimestampNBO at);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_time_rel (const char *name,
                           struct GNUNET_TIME_Relative rt);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_time_rel_nbo (const char *name,
                               struct GNUNET_TIME_RelativeNBO rt);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_rsa_public_key (const char *name,
                                 const struct GNUNET_CRYPTO_RsaPublicKey *pk);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_rsa_signature (const char *name,
                                const struct GNUNET_CRYPTO_RsaSignature *sig);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_unblinded_signature (
  const char *name,
  const struct GNUNET_CRYPTO_UnblindedSignature *sig);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_blinded_message (
  const char *name,
  const struct GNUNET_CRYPTO_BlindedMessage *msg);
 
 
struct GNUNET_JSON_PackSpec
GNUNET_JSON_pack_blinded_sig (const char *name,
                              const struct GNUNET_CRYPTO_BlindedSignature *sig);
 
#endif
 
/* end of gnunet_json_lib.h */

GNUNET_JSON_spec_fixed64_auto

#define GNUNET_JSON_spec_fixed64_auto	(		name,
			obj
	)		GNUNET_JSON_spec_fixed (name, (obj), sizeof(*(obj)))

Fixed size object (in network byte order, encoded using base64 encoding).

Parameters

name	name of the JSON field
obj	pointer where to write the data (type of *obj will determine size)

Definition at line 223 of file gnunet_json_lib.h.

GNUNET_JSON_from_data_auto

#define GNUNET_JSON_from_data_auto

(

ptr

)

GNUNET_JSON_from_data (ptr, sizeof(*(ptr)))

Convert binary data to a JSON string with the base32crockford encoding.

Parameters

ptr	binary data, sizeof (*ptr) must yield correct size

Returns

json string that encodes data

Definition at line 566 of file gnunet_json_lib.h.

GNUNET_JSON_from_data64_auto

#define GNUNET_JSON_from_data64_auto

(

ptr

)

GNUNET_JSON_from_data64 (ptr, sizeof(*(ptr)))

Convert binary data to a JSON string with base64 encoding.

Parameters

ptr	binary data, sizeof (*ptr) must yield correct size

Returns

json string that encodes data

Definition at line 577 of file gnunet_json_lib.h.

GNUNET_JSON_PACK

#define GNUNET_JSON_PACK

(

...

)

Value:

        GNUNET_JSON_pack_ ((struct GNUNET_JSON_PackSpec[]) {__VA_ARGS__, \
                                                            GNUNET_JSON_pack_end_ ()})

Pack a JSON object from a spec.

Aborts if packing fails.

Parameters

...	list of specification objects

Returns

JSON object

Definition at line 720 of file gnunet_json_lib.h.

                                                           {__VA_ARGS__, \
                                                            GNUNET_JSON_pack_end_ ()})

GNUNET_JSON_pack_data_auto

#define GNUNET_JSON_pack_data_auto	(		name,
			blob
	)		GNUNET_JSON_pack_data_varsize (name, (blob), sizeof (*(blob)))

Generate packer instruction for a JSON field where the size is automatically determined from the argument.

Parameters

name	name of the field to add to the object
blob	data to pack, must not be an array

Returns

json pack specification

Definition at line 891 of file gnunet_json_lib.h.

GNUNET_JSON_pack_data64_auto

#define GNUNET_JSON_pack_data64_auto	(		name,
			blob
	)		GNUNET_JSON_pack_data64_varsize (name, (blob), sizeof (*(blob)))

Generate packer instruction for a JSON field where the size is automatically determined from the argument.

Use base64-encoding, instead of the more common Crockford base32-encoding.

Parameters

name	name of the field to add to the object
blob	data to pack, must not be an array

Returns

json pack specification

Definition at line 922 of file gnunet_json_lib.h.

Typedef Documentation

GNUNET_JSON_Parser

typedef enum GNUNET_GenericReturnValue(* GNUNET_JSON_Parser) (void *cls, json_t *root, struct GNUNET_JSON_Specification *spec)

Function called to parse JSON argument.

Parameters

cls	closure
root	JSON to parse
spec	our specification entry with further details

Returns

GNUNET_SYSERR on error, GNUNET_OK on success

Definition at line 1 of file gnunet_json_lib.h.

GNUNET_JSON_Cleaner

typedef void(* GNUNET_JSON_Cleaner) (void *cls, struct GNUNET_JSON_Specification *spec)

Function called to clean up data from earlier parsing.

Parameters

cls	closure
spec	our specification entry with data to clean.

Definition at line 62 of file gnunet_json_lib.h.

GNUNET_JSON_PackCallback

typedef json_t *(* GNUNET_JSON_PackCallback) (const struct GNUNET_JSON_PackSpec *se)

Function called to pack an element into the JSON object as part of GNUNET_JSON_pack_().

Parameters

se	pack specification to execute

Returns

json object to pack, NULL to pack nothing

Definition at line 666 of file gnunet_json_lib.h.

Function Documentation

GNUNET_JSON_parse()

enum GNUNET_GenericReturnValue GNUNET_JSON_parse	(	const json_t *	root,
		struct GNUNET_JSON_Specification *	spec,
		const char **	error_json_name,
		unsigned int *	error_line
	)

Navigate and parse data in a JSON tree.

Tries to parse the root to find all of the values given in the spec. If one of the entries in spec cannot be found or parsed, the name of the JSON field is returned in error_json_name, and the offset of the entry in spec is returned in error_line.

Parameters

	root	the JSON node to start the navigation at.
[in,out]	spec	parse specification array
[out]	error_json_name	which JSON field was problematic
[out]	error_line	which index into spec did we encounter an error

Returns

GNUNET_OK on success, GNUNET_SYSERR on error

Definition at line 32 of file json.c.

{
  if (NULL == root)
  {
    if (NULL != error_json_name)
      *error_json_name = "root is NULL";
    if (NULL != error_line)
      *error_line = 0;
    return GNUNET_SYSERR;
  }
  for (unsigned int i = 0; NULL != spec[i].parser; i++)
  {
    json_t *pos;
 
    if (NULL == spec[i].field)
      pos = (json_t *) root;
    else
      pos = json_object_get (root,
                             spec[i].field);
    if ( ( (NULL == pos) ||
           (json_is_null (pos) ) ) &&
         (spec[i].is_optional) )
    {
      if (NULL != spec[i].missing)
        *spec[i].missing = true;
      continue;
    }
    if ( (NULL == pos) ||
         (GNUNET_OK !=
          spec[i].parser (spec[i].cls,
                          pos,
                          &spec[i])) )
    {
      if (NULL != error_json_name)
        *error_json_name = spec[i].field;
      else
        GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
                    "Parsing failed for field `%s:%u`\n",
                    spec[i].field,
                    i);
      if (NULL != error_line)
        *error_line = i;
      GNUNET_JSON_parse_free (spec);
      return GNUNET_SYSERR;
    }
    if (NULL != spec[i].missing)
      *spec[i].missing = false;
  }
  return GNUNET_OK; /* all OK! */
}

References GNUNET_JSON_Specification::field, GNUNET_ERROR_TYPE_WARNING, GNUNET_JSON_parse_free(), GNUNET_log, GNUNET_OK, GNUNET_SYSERR, GNUNET_JSON_Specification::missing, and GNUNET_JSON_Specification::parser.

Referenced by add_attribute_cont(), add_credential_cont(), bulk_tx_start(), consume_ticket_cont(), namestore_add_or_update(), parse_blinded_message(), parse_blinded_sig(), parse_unblinded_sig(), and revoke_ticket_cont().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_parse_free()

void GNUNET_JSON_parse_free

(

struct GNUNET_JSON_Specification *

spec

)

Frees all elements allocated during a GNUNET_JSON_parse() operation.

Convenience function to be called if cleaning up all heap-allocated data from a GNUNET_JSON_parse() is desired. The function does not have to be called if no data was heap-allocated (e.g. only integers, strings and fixed-sized data was used), or if the application calls the respective code to free the heap (not always GNUNET_free(), depends on the data type!) on the returned heap-allocated data itself.

Parameters

[in,out]

spec

specification of the parse operation

Definition at line 100 of file json.c.

{
  for (unsigned int i = 0; NULL != spec[i].parser; i++)
    if (NULL != spec[i].cleaner)
      spec[i].cleaner (spec[i].cls,
                       &spec[i]);
}

References GNUNET_JSON_Specification::cleaner, GNUNET_JSON_Specification::cls, and GNUNET_JSON_Specification::parser.

Referenced by add_attribute_cont(), add_credential_cont(), consume_ticket_cont(), GNUNET_JSON_parse(), namestore_add_or_update(), and revoke_ticket_cont().

Here is the caller graph for this function:

GNUNET_JSON_spec_end()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_end

(

void

)

End of a parser specification.

Definition at line 34 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = NULL,
  };
 
  return ret;
}

References GNUNET_JSON_Specification::parser, and ret.

Referenced by add_attribute_cont(), add_credential_cont(), bulk_tx_start(), consume_ticket_cont(), namestore_add_or_update(), parse_blinded_message(), parse_blinded_sig(), parse_unblinded_sig(), and revoke_ticket_cont().

Here is the caller graph for this function:

GNUNET_JSON_spec_mark_optional()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_mark_optional	(	struct GNUNET_JSON_Specification	spec,
		bool *	missing
	)

Set the "optional" flag for a parser specification entry.

Parameters

	spec	specification to modify
[out]	missing	set to true if the argument is missing, NULL is allowed.

Returns

spec copy of spec with optional bit set

Definition at line 88 of file json.c.

{
  struct GNUNET_JSON_Specification ret = spec;
 
  ret.is_optional = true;
  ret.missing = missing;
  return ret;
}

References GNUNET_JSON_Specification::is_optional, GNUNET_JSON_Specification::missing, and ret.

GNUNET_JSON_spec_fixed()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_fixed	(	const char *	name,
		void *	obj,
		size_t	size
	)

Variable size object (in network byte order, encoded using Crockford Base32hex encoding).

Parameters

	name	name of the JSON field
[out]	obj	pointer where to write the data, must have size bytes
	size	number of bytes expected in obj

Definition at line 116 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_fixed_data,
    .field = name,
    .ptr = obj,
    .ptr_size = size,
  };
 
  return ret;
}

References name, parse_fixed_data(), GNUNET_JSON_Specification::parser, ret, and size.

Here is the call graph for this function:

GNUNET_JSON_spec_fixed64()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_fixed64	(	const char *	name,
		void *	obj,
		size_t	size
	)

Variable size object (in network byte order, encoded using base64 encoding).

Parameters

	name	name of the JSON field
[out]	obj	pointer where to write the data, must have size bytes
	size	number of bytes expected in obj

Definition at line 177 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_fixed64_data,
    .field = name,
    .ptr = obj,
    .ptr_size = size,
  };
 
  return ret;
}

References name, parse_fixed64_data(), GNUNET_JSON_Specification::parser, ret, and size.

Here is the call graph for this function:

GNUNET_JSON_spec_varsize()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_varsize	(	const char *	name,
		void **	obj,
		size_t *	size
	)

Variable size object (in network byte order, encoded using Crockford Base32hex encoding).

Parameters

	name	name of the JSON field
[out]	obj	pointer where to write the data, will be allocated
[out]	size	where to store the number of bytes allocated for obj

Definition at line 251 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_variable_data,
    .cleaner = &clean_variable_data,
    .field = name,
    .ptr = obj,
    .size_ptr = size
  };
 
  *obj = NULL;
  *size = 0;
  return ret;
}

References clean_variable_data(), name, parse_variable_data(), GNUNET_JSON_Specification::parser, ret, and size.

Referenced by parse_blinded_message().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_spec_string()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_string	(	const char *	name,
		const char **	strptr
	)

The expected field stores a string.

Parameters

name	name of the JSON field
strptr	where to store a pointer to the field

Definition at line 297 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_string,
    .field = name,
    .ptr = strptr
  };
 
  *strptr = NULL;
  return ret;
}

References name, parse_string(), GNUNET_JSON_Specification::parser, and ret.

Referenced by consume_ticket_cont(), parse_blinded_message(), parse_blinded_sig(), and parse_unblinded_sig().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_spec_string_copy()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_string_copy	(	const char *	name,
		char **	strptr
	)

The expected field stores a string.

Parameters

name	name of the JSON field
strptr	where to store a pointer to the field

Definition at line 339 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_string_copy,
    .field = name,
    .ptr = strptr
  };
 
  *strptr = NULL;
  return ret;
}

References name, parse_string_copy(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_json()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_json	(	const char *	name,
		json_t **	jsonp
	)

JSON object or array.

Reference counter is incremented.

Parameters

	name	name of the JSON field
[out]	jsonp	where to store the JSON found under name

Definition at line 397 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_json,
    .cleaner = &clean_json,
    .field = name,
    .ptr = jsonp,
  };
 
  *jsonp = NULL;
  return ret;
}

References clean_json(), name, parse_json(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_object_copy()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_object_copy	(	const char *	name,
		json_t **	jsonp
	)

JSON object, reference counter incremented.

Parameters

	name	name of the JSON field
[out]	jsonp	where to store the JSON found under name

Definition at line 478 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_object_copy,
    .cls = &clean_json,
    .field = name,
    .ptr = jsonp,
  };
 
  *jsonp = NULL;
  return ret;
}

References clean_json(), name, parse_object_copy(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_array_copy()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_array_copy	(	const char *	name,
		json_t **	jsonp
	)

JSON array, reference counter incremented.

Parameters

	name	name of the JSON field
[out]	jsonp	where to store the JSON found under name

Definition at line 559 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_array_copy,
    .cleaner = &clean_json,
    .field = name,
    .ptr = jsonp
  };
 
  *jsonp = NULL;
  return ret;
}

References clean_json(), name, parse_array_copy(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_object_const()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_object_const	(	const char *	name,
		const json_t **	jsonp
	)

JSON object, reference counter not incremented.

Parameters

	name	name of the JSON field
[out]	jsonp	where to store the JSON found under name

Definition at line 438 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_object_const,
    .field = name,
    .ptr = jsonp,
  };
 
  *jsonp = NULL;
  return ret;
}

References name, parse_object_const(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_array_const()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_array_const	(	const char *	name,
		const json_t **	jsonp
	)

JSON array, reference counter not incremented.

Parameters

	name	name of the JSON field
[out]	jsonp	where to store the JSON found under name

Definition at line 519 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_array_const,
    .field = name,
    .ptr = jsonp
  };
 
  *jsonp = NULL;
  return ret;
}

References name, parse_array_const(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_bool()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_bool	(	const char *	name,
		bool *	b
	)

boolean.

Parameters

	name	name of the JSON field
[out]	b	where to store the boolean found under name

Definition at line 605 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_bool,
    .field = name,
    .ptr = b,
    .ptr_size = sizeof(bool),
  };
 
  return ret;
}

References name, parse_bool(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_double()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_double	(	const char *	name,
		double *	f
	)

double.

Parameters

	name	name of the JSON field
[out]	f	where to store the double found under name

Definition at line 645 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_double,
    .field = name,
    .ptr = f,
    .ptr_size = sizeof(double),
  };
 
  return ret;
}

References name, parse_double(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_uint8()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_uint8	(	const char *	name,
		uint8_t *	u8
	)

8-bit integer.

Parameters

	name	name of the JSON field
[out]	u8	where to store the integer found under name

Definition at line 692 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_u8,
    .field = name,
    .ptr = u8,
    .ptr_size = sizeof(uint8_t),
  };
 
  return ret;
}

References name, parse_u8(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_uint16()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_uint16	(	const char *	name,
		uint16_t *	u16
	)

16-bit integer.

Parameters

	name	name of the JSON field
[out]	u16	where to store the integer found under name

Definition at line 739 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_u16,
    .field = name,
    .ptr = u16,
    .ptr_size = sizeof(uint16_t),
  };
 
  return ret;
}

References name, parse_u16(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_uint32()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_uint32	(	const char *	name,
		uint32_t *	u32
	)

32-bit integer.

Parameters

	name	name of the JSON field
[out]	u32	where to store the integer found under name

Definition at line 786 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_u32,
    .field = name,
    .ptr = u32,
    .ptr_size = sizeof(uint32_t),
  };
 
  return ret;
}

References name, parse_u32(), GNUNET_JSON_Specification::parser, and ret.

Referenced by parse_blinded_sig().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_spec_uint()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_uint	(	const char *	name,
		unsigned int *	ui
	)

Unsigned integer.

Parameters

	name	name of the JSON field
[out]	ui	where to store the integer found under name

Definition at line 833 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_ui,
    .field = name,
    .ptr = ui,
    .ptr_size = sizeof(unsigned int),
  };
 
  return ret;
}

References name, parse_ui(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_ull()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_ull	(	const char *	name,
		unsigned long long *	ull
	)

Unsigned long long.

Parameters

	name	name of the JSON field
[out]	ull	where to store the unsigned long long found under name

Definition at line 880 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_ull,
    .field = name,
    .ptr = ull,
    .ptr_size = sizeof(unsigned long long),
  };
 
  return ret;
}

References name, parse_ull(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_uint64()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_uint64	(	const char *	name,
		uint64_t *	u64
	)

64-bit integer.

Parameters

	name	name of the JSON field
[out]	u64	where to store the integer found under name

Definition at line 922 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_u64,
    .field = name,
    .ptr = u64,
    .ptr_size = sizeof(uint64_t),
  };
 
  return ret;
}

References name, parse_u64(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_int16()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_int16	(	const char *	name,
		int16_t *	i16
	)

16-bit signed integer.

Parameters

	name	name of the JSON field
[out]	i16	where to store the integer found under name

Definition at line 970 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_i16,
    .field = name,
    .ptr = i16,
    .ptr_size = sizeof(int16_t),
  };
 
  return ret;
}

References name, parse_i16(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_int64()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_int64	(	const char *	name,
		int64_t *	i64
	)

64-bit signed integer.

Parameters

	name	name of the JSON field
[out]	i64	where to store the integer found under name

Definition at line 1012 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_i64,
    .field = name,
    .ptr = i64,
    .ptr_size = sizeof(int64_t),
  };
 
  return ret;
}

References name, parse_i64(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_boolean()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_boolean	(	const char *	name,
		int *	boolean
	)

Boolean (true mapped to GNUNET_YES, false mapped to GNUNET_NO).

Parameters

	name	name of the JSON field
[out]	boolean	where to store the boolean found under name

Definition at line 1416 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_boolean,
    .field = name,
    .ptr = boolean,
    .ptr_size = sizeof(int),
  };
 
  return ret;
}

References name, parse_boolean(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_timestamp()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_timestamp	(	const char *	name,
		struct GNUNET_TIME_Timestamp *	t
	)

Timestamp.

Parameters

	name	name of the JSON field
[out]	t	at where to store the absolute time found under name

Definition at line 1088 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_timestamp,
    .field = name,
    .ptr = t,
    .ptr_size = sizeof(struct GNUNET_TIME_Timestamp)
  };
 
  return ret;
}

References name, parse_timestamp(), GNUNET_JSON_Specification::parser, ret, and t.

Here is the call graph for this function:

GNUNET_JSON_spec_timestamp_nbo()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_timestamp_nbo	(	const char *	name,
		struct GNUNET_TIME_TimestampNBO *	tn
	)

Timestamp in network byte order.

Parameters

	name	name of the JSON field
[out]	tn	where to store the absolute time found under name

Definition at line 1133 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_timestamp_nbo,
    .field = name,
    .ptr = at,
    .ptr_size = sizeof(struct GNUNET_TIME_TimestampNBO)
  };
 
  return ret;
}

References name, parse_timestamp_nbo(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_relative_time()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_relative_time	(	const char *	name,
		struct GNUNET_TIME_Relative *	rt
	)

Relative time.

Parameters

	name	name of the JSON field
[out]	rt	where to store the relative time found under name

Definition at line 1203 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_rel_time,
    .field = name,
    .ptr = rt,
    .ptr_size = sizeof(struct GNUNET_TIME_Relative)
  };
 
  return ret;
}

References name, parse_rel_time(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_rsa_public_key()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_rsa_public_key	(	const char *	name,
		struct GNUNET_CRYPTO_RsaPublicKey **	pk
	)

Specification for parsing an RSA public key.

Parameters

name	name of the JSON field
pk	where to store the RSA key found under name

Definition at line 1287 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_rsa_public_key,
    .cleaner = &clean_rsa_public_key,
    .field = name,
    .ptr = pk
  };
 
  *pk = NULL;
  return ret;
}

References clean_rsa_public_key(), name, parse_rsa_public_key(), GNUNET_JSON_Specification::parser, pk, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_rsa_signature()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_rsa_signature	(	const char *	name,
		struct GNUNET_CRYPTO_RsaSignature **	sig
	)

Specification for parsing an RSA signature.

Parameters

name	name of the JSON field
sig	where to store the RSA signature found under name

Definition at line 1372 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_rsa_signature,
    .cleaner = &clean_rsa_signature,
    .cls = NULL,
    .field = name,
    .ptr = sig,
    .ptr_size = 0,
    .size_ptr = NULL
  };
 
  *sig = NULL;
  return ret;
}

References clean_rsa_signature(), name, parse_rsa_signature(), GNUNET_JSON_Specification::parser, and ret.

Referenced by parse_blinded_sig(), and parse_unblinded_sig().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_spec_blinded_message()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_blinded_message	(	const char *	name,
		struct GNUNET_CRYPTO_BlindedMessage **	msg
	)

Specification for parsing a blinded message.

Parameters

name	name of the JSON field
sig	where to store the blinded message found under name

Definition at line 1553 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_blinded_message,
    .cleaner = &clean_blinded_message,
    .cls = NULL,
    .field = name,
    .ptr = msg,
    .ptr_size = 0,
    .size_ptr = NULL
  };
 
  *msg = NULL;
  return ret;
}

References clean_blinded_message(), msg, name, parse_blinded_message(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_blinded_signature()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_blinded_signature	(	const char *	field,
		struct GNUNET_CRYPTO_BlindedSignature **	b_sig
	)

Specification for parsing a blinded signature.

Parameters

name	name of the JSON field
sig	where to store the blinded signature found under name

Definition at line 1688 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_blinded_sig,
    .cleaner = &clean_blinded_sig,
    .field = field,
    .ptr = b_sig
  };
 
  *b_sig = NULL;
  return ret;
}

References clean_blinded_sig(), GNUNET_JSON_Specification::field, parse_blinded_sig(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_spec_unblinded_signature()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_unblinded_signature	(	const char *	field,
		struct GNUNET_CRYPTO_UnblindedSignature **	ub_sig
	)

Specification for parsing an unblinded signature.

Parameters

name	name of the JSON field
sig	where to store the unblinded signature found under name

Definition at line 1821 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_unblinded_sig,
    .cleaner = &clean_unblinded_sig,
    .field = field,
    .ptr = ub_sig
  };
 
  *ub_sig = NULL;
  return ret;
}

References clean_unblinded_sig(), GNUNET_JSON_Specification::field, parse_unblinded_sig(), GNUNET_JSON_Specification::parser, and ret.

Here is the call graph for this function:

GNUNET_JSON_from_data()

json_t * GNUNET_JSON_from_data	(	const void *	data,
		size_t	size
	)

Convert binary data to a JSON string with the base32crockford encoding.

Parameters

data	binary data
size	size of data in bytes

Returns

json string that encodes data

Definition at line 31 of file json_generator.c.

{
  char *buf;
  json_t *json;
 
  if (size >= ( (GNUNET_MAX_MALLOC_CHECKED - 1) * 5) - 4 / 8)
  {
    GNUNET_break (0);
    return NULL;
  }
  buf = GNUNET_STRINGS_data_to_string_alloc (data,
                                             size);
  json = json_string (buf);
  GNUNET_free (buf);
  GNUNET_break (NULL != json);
  return json;
}

References data, GNUNET_break, GNUNET_free, GNUNET_MAX_MALLOC_CHECKED, GNUNET_STRINGS_data_to_string_alloc(), and size.

Referenced by GNUNET_JSON_from_rsa_public_key(), GNUNET_JSON_from_rsa_signature(), and GNUNET_JSON_pack_data_varsize().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_from_data64()

json_t * GNUNET_JSON_from_data64	(	const void *	data,
		size_t	size
	)

Convert binary data to a JSON string with base64 encoding.

Parameters

data	binary data
size	size of data in bytes

Returns

json string that encodes data

Definition at line 52 of file json_generator.c.

{
  char *buf = NULL;
  json_t *json;
  size_t len;
 
  if (size >= ( ( (GNUNET_MAX_MALLOC_CHECKED - 1) * 6) - 5) / 8)
  {
    GNUNET_break (0);
    return NULL;
  }
  len = GNUNET_STRINGS_base64_encode (data,
                                      size,
                                      &buf);
  if (NULL == buf)
  {
    GNUNET_break (0);
    return NULL;
  }
  json = json_stringn (buf,
                       len);
  GNUNET_free (buf);
  GNUNET_break (NULL != json);
  return json;
}

References data, GNUNET_break, GNUNET_free, GNUNET_MAX_MALLOC_CHECKED, GNUNET_STRINGS_base64_encode(), and size.

Referenced by GNUNET_JSON_pack_data64_varsize().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_from_timestamp()

json_t * GNUNET_JSON_from_timestamp

(

struct GNUNET_TIME_Timestamp

stamp

)

Convert timestamp to a json string.

Parameters

stamp

the time stamp

Returns

a json string with the timestamp in stamp

Definition at line 81 of file json_generator.c.

{
  json_t *j;
 
  j = json_object ();
  if (NULL == j)
  {
    GNUNET_break (0);
    return NULL;
  }
  if (GNUNET_TIME_absolute_is_never (stamp.abs_time))
  {
    if (0 !=
        json_object_set_new (j,
                             "t_s",
                             json_string ("never")))
    {
      GNUNET_break (0);
      json_decref (j);
      return NULL;
    }
    return j;
  }
  GNUNET_assert (
    0 ==
    (stamp.abs_time.abs_value_us
     % GNUNET_TIME_UNIT_SECONDS.rel_value_us));
  if (0 !=
      json_object_set_new (
        j,
        "t_s",
        json_integer (
          (json_int_t) (stamp.abs_time.abs_value_us
                        / GNUNET_TIME_UNIT_SECONDS.rel_value_us))))
  {
    GNUNET_break (0);
    json_decref (j);
    return NULL;
  }
  return j;
}

References GNUNET_TIME_Timestamp::abs_time, GNUNET_TIME_Absolute::abs_value_us, GNUNET_assert, GNUNET_break, GNUNET_TIME_absolute_is_never(), and GNUNET_TIME_UNIT_SECONDS.

Referenced by GNUNET_JSON_from_timestamp_nbo(), and GNUNET_JSON_pack_timestamp().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_from_timestamp_nbo()

json_t * GNUNET_JSON_from_timestamp_nbo

(

struct GNUNET_TIME_TimestampNBO

stamp

)

Convert timestamp to a json string.

Parameters

stamp

the time stamp

Returns

a json string with the timestamp in stamp

Definition at line 125 of file json_generator.c.

{
  return GNUNET_JSON_from_timestamp (GNUNET_TIME_timestamp_ntoh (stamp));
}

References GNUNET_JSON_from_timestamp(), and GNUNET_TIME_timestamp_ntoh().

Here is the call graph for this function:

GNUNET_JSON_from_time_rel()

json_t * GNUNET_JSON_from_time_rel

(

struct GNUNET_TIME_Relative

stamp

)

Convert relative timestamp to a json string.

Parameters

stamp

the time stamp

Returns

a json string with the timestamp in stamp

Definition at line 132 of file json_generator.c.

{
  json_t *j;
 
  j = json_object ();
  if (NULL == j)
  {
    GNUNET_break (0);
    return NULL;
  }
  if (GNUNET_TIME_relative_is_forever (stamp))
  {
    if (0 !=
        json_object_set_new (j,
                             "d_us",
                             json_string ("forever")))
    {
      GNUNET_break (0);
      json_decref (j);
      return NULL;
    }
    return j;
  }
  if (stamp.rel_value_us >= (1LLU << 53))
  {
    /* value is larger than allowed */
    GNUNET_break (0);
    return NULL;
  }
  if (0 !=
      json_object_set_new (
        j,
        "d_us",
        json_integer ((json_int_t) stamp.rel_value_us)))
  {
    GNUNET_break (0);
    json_decref (j);
    return NULL;
  }
  return j;
}

References GNUNET_break, GNUNET_TIME_relative_is_forever(), and GNUNET_TIME_Relative::rel_value_us.

Referenced by GNUNET_JSON_pack_time_rel().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_from_rsa_public_key()

json_t * GNUNET_JSON_from_rsa_public_key

(

const struct GNUNET_CRYPTO_RsaPublicKey *

pk

)

Convert RSA public key to JSON.

Parameters

pk	public key to convert

Returns

corresponding JSON encoding

Definition at line 176 of file json_generator.c.

{
  void *buf;
  size_t buf_len;
  json_t *ret;
 
  buf_len = GNUNET_CRYPTO_rsa_public_key_encode (pk,
                                                 &buf);
  ret = GNUNET_JSON_from_data (buf,
                               buf_len);
  GNUNET_free (buf);
  return ret;
}

References GNUNET_CRYPTO_rsa_public_key_encode(), GNUNET_free, GNUNET_JSON_from_data(), pk, and ret.

Referenced by GNUNET_JSON_pack_rsa_public_key().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_from_rsa_signature()

json_t * GNUNET_JSON_from_rsa_signature

(

const struct GNUNET_CRYPTO_RsaSignature *

sig

)

Convert RSA signature to JSON.

Parameters

sig	signature to convert

Returns

corresponding JSON encoding

Definition at line 192 of file json_generator.c.

{
  void *buf;
  size_t buf_len;
  json_t *ret;
 
  buf_len = GNUNET_CRYPTO_rsa_signature_encode (sig,
                                                &buf);
  ret = GNUNET_JSON_from_data (buf,
                               buf_len);
  GNUNET_free (buf);
  return ret;
}

References GNUNET_CRYPTO_rsa_signature_encode(), GNUNET_free, GNUNET_JSON_from_data(), and ret.

Referenced by GNUNET_JSON_pack_rsa_signature().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_getopt()

struct GNUNET_GETOPT_CommandLineOption GNUNET_JSON_getopt	(	char	shortName,
		const char *	name,
		const char *	argumentHelp,
		const char *	description,
		json_t **	json
	)

Allow user to specify a JSON input value.

Parameters

	shortName	short name of the option
	name	long name of the option
	argumentHelp	help text for the option argument
	description	long help text for the option
[out]	val	set to the JSON specified at the command line

Definition at line 147 of file json.c.

{
  struct GNUNET_GETOPT_CommandLineOption clo = {
    .shortName = shortName,
    .name = name,
    .argumentHelp = argumentHelp,
    .description = description,
    .require_argument = 1,
    .processor = &set_json,
    .scls = (void *) json
  };
 
  return clo;
}

References GNUNET_GETOPT_CommandLineOption::argumentHelp, GNUNET_GETOPT_CommandLineOption::description, name, set_json(), and GNUNET_GETOPT_CommandLineOption::shortName.

Here is the call graph for this function:

GNUNET_JSON_pack_()

json_t * GNUNET_JSON_pack_

(

struct GNUNET_JSON_PackSpec

spec[]

)

Pack a JSON object from a spec.

Aborts if packing fails.

Parameters

spec	specification object

Returns

JSON object

Definition at line 30 of file json_pack.c.

{
  json_t *ret;
 
  if (NULL == spec[0].field_name)
  {
    ret = spec[0].object;
    spec[0].object = NULL;
    return ret;
  }
  ret = json_object ();
  GNUNET_assert (NULL != ret);
  for (unsigned int i = 0;
       ! spec[i].final;
       i++)
  {
    if (NULL == spec[i].object)
    {
      if (! spec[i].allow_null)
      {
        GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                    "NULL not allowed for `%s'\n",
                    spec[i].field_name);
        GNUNET_assert (0);
      }
    }
    else
    {
      if (NULL == spec[i].field_name)
        GNUNET_assert (0 ==
                       json_object_update_new (ret,
                                               spec[i].object));
      else
        GNUNET_assert (0 ==
                       json_object_set_new (ret,
                                            spec[i].field_name,
                                            spec[i].object));
 
      spec[i].object = NULL;
    }
  }
  return ret;
}

References GNUNET_JSON_PackSpec::final, GNUNET_assert, GNUNET_ERROR_TYPE_ERROR, GNUNET_log, GNUNET_JSON_PackSpec::object, and ret.

GNUNET_JSON_pack_end_()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_end_

(

void

)

Do not use directly.

Use GNUNET_JSON_PACK.

Returns

array terminator

Definition at line 76 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .final = true
  };
 
  return ps;
}

References ps.

GNUNET_JSON_pack_allow_null()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_allow_null

(

struct GNUNET_JSON_PackSpec

in

)

Modify packer instruction to allow NULL as a value.

Parameters

in	json pack specification to modify

Returns

json pack specification

Definition at line 87 of file json_pack.c.

{
  in.allow_null = true;
  return in;
}

References GNUNET_JSON_PackSpec::allow_null.

GNUNET_JSON_pack_bool()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_bool	(	const char *	name,
		bool	b
	)

Generate packer instruction for a JSON field of type bool.

Parameters

name	name of the field to add to the object
b	boolean value

Returns

json pack specification

Definition at line 95 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = json_boolean (b)
  };
 
  GNUNET_assert (NULL != name);
  return ps;
}

References GNUNET_assert, name, and ps.

GNUNET_JSON_pack_double()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_double	(	const char *	name,
		double	f
	)

Generate packer instruction for a JSON field of type double.

Parameters

name	name of the field to add to the object
f	double value

Returns

json pack specification

Definition at line 109 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = json_real (f)
  };
 
  GNUNET_assert (NULL != name);
  return ps;
}

References GNUNET_assert, name, and ps.

GNUNET_JSON_pack_string()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_string	(	const char *	name,
		const char *	s
	)

Generate packer instruction for a JSON field of type string.

Parameters

name	name of the field to add to the object
s	string value

Returns

json pack specification

Definition at line 123 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = json_string (s)
  };
 
  GNUNET_assert (NULL != name);
  return ps;
}

References GNUNET_assert, name, and ps.

Referenced by GNUNET_JSON_pack_blinded_message(), GNUNET_JSON_pack_blinded_sig(), GNUNET_JSON_pack_time_rounder_interval(), and GNUNET_JSON_pack_unblinded_signature().

Here is the caller graph for this function:

GNUNET_JSON_pack_uint64()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_uint64	(	const char *	name,
		uint64_t	num
	)

Generate packer instruction for a JSON field of type unsigned integer.

Note that the maximum allowed value is still limited by JSON and not UINT64_MAX.

Parameters

name	name of the field to add to the object
num	numeric value

Returns

json pack specification

Definition at line 137 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = json_integer ((json_int_t) num)
  };
 
  GNUNET_assert (NULL != name);
#if JSON_INTEGER_IS_LONG_LONG
  GNUNET_assert (num <= LLONG_MAX);
#else
  GNUNET_assert (num <= LONG_MAX);
#endif
  return ps;
}

References GNUNET_assert, name, and ps.

Referenced by GNUNET_JSON_pack_blinded_sig().

Here is the caller graph for this function:

GNUNET_JSON_pack_int64()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_int64	(	const char *	name,
		int64_t	num
	)

Generate packer instruction for a JSON field of type signed integer.

Parameters

name	name of the field to add to the object
num	numeric value

Returns

json pack specification

Definition at line 156 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = json_integer ((json_int_t) num)
  };
 
  GNUNET_assert (NULL != name);
#if JSON_INTEGER_IS_LONG_LONG
  GNUNET_assert (num <= LLONG_MAX);
  GNUNET_assert (num >= LLONG_MIN);
#else
  GNUNET_assert (num <= LONG_MAX);
  GNUNET_assert (num >= LONG_MIN);
#endif
  return ps;
}

References GNUNET_assert, name, and ps.

GNUNET_JSON_pack_object_steal()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_object_steal	(	const char *	name,
		json_t *	o
	)

Generate packer instruction for a JSON field of type JSON object where the reference is taken over by the packer.

Parameters

name	name of the field to add to the object, if NULL, the keys of o will be placed in the top level of the resulting object
o	object to steal

Returns

json pack specification

Definition at line 177 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = o
  };
 
  if (NULL == o)
    return ps;
  if (! json_is_object (o))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Expected JSON object for field `%s'\n",
                name);
    GNUNET_assert (0);
  }
  return ps;
}

References GNUNET_assert, GNUNET_ERROR_TYPE_ERROR, GNUNET_log, name, and ps.

Referenced by GNUNET_JSON_pack_time_rel().

Here is the caller graph for this function:

GNUNET_JSON_pack_object_incref()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_object_incref	(	const char *	name,
		json_t *	o
	)

Generate packer instruction for a JSON field of type JSON object where the reference counter is incremented by the packer.

Note that a deep copy is not performed.

Parameters

name	name of the field to add to the object, if NULL, the keys of o will be placed in the top level of the resulting object
o	object to increment reference counter of

Returns

json pack specification

Definition at line 199 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = o
  };
 
  if (NULL == o)
    return ps;
  (void) json_incref (o);
  if (! json_is_object (o))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Expected JSON object for field `%s'\n",
                name);
    GNUNET_assert (0);
  }
  return ps;
}

References GNUNET_assert, GNUNET_ERROR_TYPE_ERROR, GNUNET_log, name, and ps.

GNUNET_JSON_pack_array_steal()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_array_steal	(	const char *	name,
		json_t *	a
	)

Generate packer instruction for a JSON field of type JSON array where the reference is taken over by the packer.

Parameters

name	name of the field to add to the object
a	array to steal

Returns

json pack specification

Definition at line 222 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = a
  };
 
  GNUNET_assert (NULL != name);
  if (NULL == a)
    return ps;
  if (! json_is_array (a))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Expected JSON array for field `%s'\n",
                name);
    GNUNET_assert (0);
  }
  return ps;
}

References GNUNET_assert, GNUNET_ERROR_TYPE_ERROR, GNUNET_log, name, and ps.

GNUNET_JSON_pack_array_incref()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_array_incref	(	const char *	name,
		json_t *	a
	)

Generate packer instruction for a JSON field of type JSON array where the reference counter is incremented by the packer.

Note that a deep copy is not performed.

Parameters

name	name of the field to add to the object
a	array to increment reference counter of

Returns

json pack specification

Definition at line 245 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = a
  };
 
  GNUNET_assert (NULL != name);
  if (NULL == a)
    return ps;
  (void) json_incref (a);
  if (! json_is_array (a))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Expected JSON array for field `%s'\n",
                name);
    GNUNET_assert (0);
  }
  return ps;
}

References GNUNET_assert, GNUNET_ERROR_TYPE_ERROR, GNUNET_log, name, and ps.

GNUNET_JSON_pack_data_varsize()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_data_varsize	(	const char *	name,
		const void *	blob,
		size_t	blob_size
	)

Generate packer instruction for a JSON field of type variable size binary blob.

Parameters

name	name of the field to add to the object
blob	binary data to pack
blob_size	number of bytes in blob

Returns

json pack specification

Definition at line 269 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = (NULL != blob)
    ? GNUNET_JSON_from_data (blob,
                             blob_size)
    : NULL
  };
 
  GNUNET_assert (NULL != name);
  return ps;
}

References GNUNET_assert, GNUNET_JSON_from_data(), name, and ps.

Referenced by GNUNET_JSON_pack_blinded_message().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_pack_data64_varsize()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_data64_varsize	(	const char *	name,
		const void *	blob,
		size_t	blob_size
	)

Generate packer instruction for a JSON field of type variable size binary blob.

Use base64-encoding, instead of the more common Crockford base32-encoding.

Parameters

name	name of the field to add to the object
blob	binary data to pack
blob_size	number of bytes in blob

Returns

json pack specification

Definition at line 287 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = (NULL != blob)
    ? GNUNET_JSON_from_data64 (blob,
                               blob_size)
    : NULL
  };
 
  GNUNET_assert (NULL != name);
  return ps;
}

References GNUNET_assert, GNUNET_JSON_from_data64(), name, and ps.

Here is the call graph for this function:

GNUNET_JSON_pack_time_rounder_interval()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_time_rounder_interval	(	const char *	name,
		enum GNUNET_TIME_RounderInterval	ri
	)

Generate packer instruction of a time rounder interval.

Parameters

name	name of the field to add to the object
ri	rounder interval to add

Returns

json pack specification

Definition at line 502 of file json_pack.c.

{
  const char *str = "INVALID";
 
  str = GNUNET_TIME_round_interval2s (ri);
  if (NULL == str)
  {
    GNUNET_break (0);
    str = "INVALID";
  }
  return GNUNET_JSON_pack_string (name,
                                  str);
}

References GNUNET_break, GNUNET_JSON_pack_string(), GNUNET_TIME_round_interval2s(), name, ri, and str.

Here is the call graph for this function:

GNUNET_JSON_spec_time_rounder_interval()

struct GNUNET_JSON_Specification GNUNET_JSON_spec_time_rounder_interval	(	const char *	name,
		enum GNUNET_TIME_RounderInterval *	ri
	)

Provide specification to parse a time rounder interval.

The value must be provided as a descriptive string.

Parameters

	name	name of the time rounder interval type in the JSON
[out]	ri	where to store the time rounder interval

Returns

spec for parsing trigger event type

Definition at line 1878 of file json_helper.c.

{
  struct GNUNET_JSON_Specification ret = {
    .parser = &parse_tri,
    .field = name,
    .ptr = ri
  };
 
  *ri = GNUNET_TIME_RI_NONE;
  return ret;
 
}

References GNUNET_TIME_RI_NONE, name, parse_tri(), GNUNET_JSON_Specification::parser, ret, and ri.

Here is the call graph for this function:

GNUNET_JSON_pack_timestamp()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_timestamp	(	const char *	name,
		struct GNUNET_TIME_Timestamp	at
	)

Generate packer instruction for a JSON field of type timestamp.

Parameters

name	name of the field to add to the object
at	timestamp pack, a value of 0 is only allowed with GNUNET_JSON_pack_allow_null()!

Returns

json pack specification

Definition at line 305 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name
  };
 
  GNUNET_assert (NULL != name);
  if (! GNUNET_TIME_absolute_is_zero (t.abs_time))
  {
    ps.object = GNUNET_JSON_from_timestamp (t);
    GNUNET_assert (NULL != ps.object);
  }
  else
  {
    ps.object = NULL;
  }
  return ps;
}

References GNUNET_assert, GNUNET_JSON_from_timestamp(), GNUNET_TIME_absolute_is_zero(), name, ps, and t.

Referenced by GNUNET_JSON_pack_timestamp_nbo().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_pack_timestamp_nbo()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_timestamp_nbo	(	const char *	name,
		struct GNUNET_TIME_TimestampNBO	at
	)

Generate packer instruction for a JSON field of type timestamp in network byte order.

Parameters

name	name of the field to add to the object
at	timestamp to pack, a value of 0 is only allowed with GNUNET_JSON_pack_allow_null()!

Returns

json pack specification

Definition at line 327 of file json_pack.c.

{
  return GNUNET_JSON_pack_timestamp (name,
                                     GNUNET_TIME_timestamp_ntoh (at));
}

References GNUNET_JSON_pack_timestamp(), GNUNET_TIME_timestamp_ntoh(), and name.

Here is the call graph for this function:

GNUNET_JSON_pack_time_rel()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_time_rel	(	const char *	name,
		struct GNUNET_TIME_Relative	rt
	)

Generate packer instruction for a JSON field of type relative time.

Parameters

name	name of the field to add to the object
rt	relative time to pack

Returns

json pack specification

Definition at line 336 of file json_pack.c.

{
  json_t *json;
 
  GNUNET_assert (NULL != name);
  json = GNUNET_JSON_from_time_rel (rt);
  GNUNET_assert (NULL != json);
  return GNUNET_JSON_pack_object_steal (name,
                                        json);
}

References GNUNET_assert, GNUNET_JSON_from_time_rel(), GNUNET_JSON_pack_object_steal(), and name.

Referenced by GNUNET_JSON_pack_time_rel_nbo().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_pack_time_rel_nbo()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_time_rel_nbo	(	const char *	name,
		struct GNUNET_TIME_RelativeNBO	rt
	)

Generate packer instruction for a JSON field of type relative time in network byte order.

Parameters

name	name of the field to add to the object
rt	relative time to pack

Returns

json pack specification

Definition at line 350 of file json_pack.c.

{
  return GNUNET_JSON_pack_time_rel (name,
                                    GNUNET_TIME_relative_ntoh (rt));
}

References GNUNET_JSON_pack_time_rel(), GNUNET_TIME_relative_ntoh(), and name.

Here is the call graph for this function:

GNUNET_JSON_pack_rsa_public_key()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_rsa_public_key	(	const char *	name,
		const struct GNUNET_CRYPTO_RsaPublicKey *	pk
	)

Generate packer instruction for a JSON field of type RSA public key.

Parameters

name	name of the field to add to the object
pk	RSA public key

Returns

json pack specification

Definition at line 359 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = GNUNET_JSON_from_rsa_public_key (pk)
  };
 
  return ps;
}

References GNUNET_JSON_from_rsa_public_key(), name, pk, and ps.

Here is the call graph for this function:

GNUNET_JSON_pack_rsa_signature()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_rsa_signature	(	const char *	name,
		const struct GNUNET_CRYPTO_RsaSignature *	sig
	)

Generate packer instruction for a JSON field of type RSA signature.

Parameters

name	name of the field to add to the object
sig	RSA signature

Returns

json pack specification

Definition at line 372 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
    .object = GNUNET_JSON_from_rsa_signature (sig)
  };
 
  return ps;
}

References GNUNET_JSON_from_rsa_signature(), name, and ps.

Referenced by GNUNET_JSON_pack_blinded_sig(), and GNUNET_JSON_pack_unblinded_signature().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_JSON_pack_unblinded_signature()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_unblinded_signature	(	const char *	name,
		const struct GNUNET_CRYPTO_UnblindedSignature *	sig
	)

Generate packer instruction for a JSON field of type unblinded signature.

Parameters

name	name of the field to add to the object
sig	unblinded signature

Returns

json pack specification

Definition at line 385 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name
  };
 
  if (NULL == sig)
    return ps;
 
  switch (sig->cipher)
  {
  case GNUNET_CRYPTO_BSA_INVALID:
    break;
  case GNUNET_CRYPTO_BSA_RSA:
    ps.object = GNUNET_JSON_PACK (
      GNUNET_JSON_pack_string ("cipher",
                               "RSA"),
      GNUNET_JSON_pack_rsa_signature ("rsa_signature",
                                      sig->details.rsa_signature));
    return ps;
  case GNUNET_CRYPTO_BSA_CS:
    ps.object = GNUNET_JSON_PACK (
      GNUNET_JSON_pack_string ("cipher",
                               "CS"),
      GNUNET_JSON_pack_data_auto ("cs_signature_r",
                                  &sig->details.cs_signature.r_point),
      GNUNET_JSON_pack_data_auto ("cs_signature_s",
                                  &sig->details.cs_signature.s_scalar));
    return ps;
  }
  GNUNET_assert (0);
  return ps;
}

References GNUNET_assert, GNUNET_CRYPTO_BSA_CS, GNUNET_CRYPTO_BSA_INVALID, GNUNET_CRYPTO_BSA_RSA, GNUNET_JSON_PACK, GNUNET_JSON_pack_data_auto, GNUNET_JSON_pack_rsa_signature(), GNUNET_JSON_pack_string(), name, and ps.

Here is the call graph for this function:

GNUNET_JSON_pack_blinded_message()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_blinded_message	(	const char *	name,
		const struct GNUNET_CRYPTO_BlindedMessage *	msg
	)

Generate packer instruction for a JSON field of type blinded message.

Parameters

name	name of the field to add to the object
msg	blinded message

Returns

json pack specification

Definition at line 423 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
  };
 
  switch (msg->cipher)
  {
  case GNUNET_CRYPTO_BSA_INVALID:
    break;
  case GNUNET_CRYPTO_BSA_RSA:
    ps.object = GNUNET_JSON_PACK (
      GNUNET_JSON_pack_string ("cipher",
                               "RSA"),
      GNUNET_JSON_pack_data_varsize (
        "rsa_blinded_planchet",
        msg->details.rsa_blinded_message.blinded_msg,
        msg->details.rsa_blinded_message.blinded_msg_size));
    return ps;
  case GNUNET_CRYPTO_BSA_CS:
    ps.object = GNUNET_JSON_PACK (
      GNUNET_JSON_pack_string ("cipher",
                               "CS"),
      GNUNET_JSON_pack_data_auto (
        "cs_nonce",
        &msg->details.cs_blinded_message.nonce),
      GNUNET_JSON_pack_data_auto (
        "cs_blinded_c0",
        &msg->details.cs_blinded_message.c[0]),
      GNUNET_JSON_pack_data_auto (
        "cs_blinded_c1",
        &msg->details.cs_blinded_message.c[1]));
    return ps;
  }
  GNUNET_assert (0);
  return ps;
}

References GNUNET_assert, GNUNET_CRYPTO_BSA_CS, GNUNET_CRYPTO_BSA_INVALID, GNUNET_CRYPTO_BSA_RSA, GNUNET_JSON_PACK, GNUNET_JSON_pack_data_auto, GNUNET_JSON_pack_data_varsize(), GNUNET_JSON_pack_string(), msg, name, and ps.

Here is the call graph for this function:

GNUNET_JSON_pack_blinded_sig()

struct GNUNET_JSON_PackSpec GNUNET_JSON_pack_blinded_sig	(	const char *	name,
		const struct GNUNET_CRYPTO_BlindedSignature *	sig
	)

Generate packer instruction for a JSON field of type blinded signature.

Parameters

name	name of the field to add to the object
sig	blinded signature

Returns

json pack specification

Definition at line 465 of file json_pack.c.

{
  struct GNUNET_JSON_PackSpec ps = {
    .field_name = name,
  };
 
  if (NULL == sig)
    return ps;
  switch (sig->cipher)
  {
  case GNUNET_CRYPTO_BSA_INVALID:
    break;
  case GNUNET_CRYPTO_BSA_RSA:
    ps.object = GNUNET_JSON_PACK (
      GNUNET_JSON_pack_string ("cipher",
                               "RSA"),
      GNUNET_JSON_pack_rsa_signature ("blinded_rsa_signature",
                                      sig->details.blinded_rsa_signature));
    return ps;
  case GNUNET_CRYPTO_BSA_CS:
    ps.object = GNUNET_JSON_PACK (
      GNUNET_JSON_pack_string ("cipher",
                               "CS"),
      GNUNET_JSON_pack_uint64 ("b",
                               sig->details.blinded_cs_answer.b),
      GNUNET_JSON_pack_data_auto ("s",
                                  &sig->details.blinded_cs_answer.s_scalar));
    return ps;
  }
  GNUNET_assert (0);
  return ps;
}

References GNUNET_assert, GNUNET_CRYPTO_BSA_CS, GNUNET_CRYPTO_BSA_INVALID, GNUNET_CRYPTO_BSA_RSA, GNUNET_JSON_PACK, GNUNET_JSON_pack_data_auto, GNUNET_JSON_pack_rsa_signature(), GNUNET_JSON_pack_string(), GNUNET_JSON_pack_uint64(), name, and ps.

Here is the call graph for this function: