Helper library to parse DNS packets. More...

Collaboration diagram for DNS parser library:

Data Structures
struct	GNUNET_DNSPARSER_Query
	A DNS query. More...

struct	GNUNET_DNSPARSER_MxRecord
	Information from MX records (RFC 1035). More...

struct	GNUNET_DNSPARSER_SrvRecord
	Information from SRV records (RFC 2782). More...

struct	GNUNET_DNSPARSER_UriRecord
	Information from URI records (RFC 7553). More...

struct	GNUNET_DNSPARSER_CertRecord
	Information from CERT records (RFC 4034). More...

struct	GNUNET_DNSPARSER_SoaRecord
	Information from SOA records (RFC 1035). More...

struct	GNUNET_DNSPARSER_CaaRecord
	Information from CAA records (RFC 6844). More...

struct	GNUNET_DNSPARSER_RawRecord
	Binary record information (unparsed). More...

struct	GNUNET_DNSPARSER_Record
	A DNS response record. More...

struct	GNUNET_DNSPARSER_Packet
	Easy-to-process, parsed version of a DNS packet. More...

Macros
#define	GNUNET_DNSPARSER_MAX_LABEL_LENGTH 63
	Maximum length of a label in DNS.

#define	GNUNET_DNSPARSER_MAX_NAME_LENGTH 253
	Maximum length of a name in DNS.

#define	GNUNET_DNSPARSER_TYPE_ANY 0
	A few common DNS types.

#define	GNUNET_DNSPARSER_TYPE_A 1

#define	GNUNET_DNSPARSER_TYPE_NS 2

#define	GNUNET_DNSPARSER_TYPE_CNAME 5

#define	GNUNET_DNSPARSER_TYPE_SOA 6

#define	GNUNET_DNSPARSER_TYPE_PTR 12

#define	GNUNET_DNSPARSER_TYPE_MX 15

#define	GNUNET_DNSPARSER_TYPE_TXT 16

#define	GNUNET_DNSPARSER_TYPE_RP 17

#define	GNUNET_DNSPARSER_TYPE_AFSDB 18

#define	GNUNET_DNSPARSER_TYPE_SIG 24

#define	GNUNET_DNSPARSER_TYPE_KEY 25

#define	GNUNET_DNSPARSER_TYPE_AAAA 28

#define	GNUNET_DNSPARSER_TYPE_LOC 29

#define	GNUNET_DNSPARSER_TYPE_SRV 33

#define	GNUNET_DNSPARSER_TYPE_NAPTR 35

#define	GNUNET_DNSPARSER_TYPE_KX 36

#define	GNUNET_DNSPARSER_TYPE_CERT 37

#define	GNUNET_DNSPARSER_TYPE_DNAME 39

#define	GNUNET_DNSPARSER_TYPE_APL 42

#define	GNUNET_DNSPARSER_TYPE_DS 43

#define	GNUNET_DNSPARSER_TYPE_SSHFP 44

#define	GNUNET_DNSPARSER_TYPE_IPSECKEY 45

#define	GNUNET_DNSPARSER_TYPE_RRSIG 46

#define	GNUNET_DNSPARSER_TYPE_NSEC 47

#define	GNUNET_DNSPARSER_TYPE_DNSKEY 48

#define	GNUNET_DNSPARSER_TYPE_DHCID 49

#define	GNUNET_DNSPARSER_TYPE_NSEC3 50

#define	GNUNET_DNSPARSER_TYPE_NSEC3PARAM 51

#define	GNUNET_DNSPARSER_TYPE_TLSA 52

#define	GNUNET_DNSPARSER_TYPE_SMIMEA 53

#define	GNUNET_DNSPARSER_TYPE_HIP 55

#define	GNUNET_DNSPARSER_TYPE_CDS 59

#define	GNUNET_DNSPARSER_TYPE_CDNSKEY 60

#define	GNUNET_DNSPARSER_TYPE_OPENPGPKEY 61

#define	GNUNET_DNSPARSER_TYPE_TKEY 249

#define	GNUNET_DNSPARSER_TYPE_TSIG 250

#define	GNUNET_DNSPARSER_TYPE_ALL 255

#define	GNUNET_DNSPARSER_TYPE_URI 256

#define	GNUNET_DNSPARSER_TYPE_CAA 257

#define	GNUNET_DNSPARSER_TYPE_TA 32768

Enumerations
enum	GNUNET_DNSPARSER_CertType { GNUNET_DNSPARSER_CERTTYPE_RESERVED = 0 , GNUNET_DNSPARSER_CERTTYPE_PKIX = 1 , GNUNET_DNSPARSER_CERTTYPE_SKPI = 2 , GNUNET_DNSPARSER_CERTTYPE_PGP = 3 , GNUNET_DNSPARSER_CERTTYPE_IPKIX = 4 , GNUNET_DNSPARSER_CERTTYPE_ISKPI = 5 , GNUNET_DNSPARSER_CERTTYPE_IPGP = 6 , GNUNET_DNSPARSER_CERTTYPE_ACPKIX = 7 , GNUNET_DNSPARSER_CERTTYPE_IACKPIX = 8 }
	DNS CERT types as defined in RFC 4398. More...

enum	GNUNET_DNSPARSER_CertAlgorithm { GNUNET_DNSPARSER_CERTALGO_UNDEFINED = 0 , GNUNET_DNSPARSER_CERTALGO_RSAMD5 = 1 , GNUNET_DNSPARSER_CERTALGO_DH = 2 , GNUNET_DNSPARSER_CERTALGO_DSASHA = 3 , GNUNET_DNSPARSER_CERTALGO_RSRVD4 = 4 , GNUNET_DNSPARSER_CERTALGO_RSASHA = 5 , GNUNET_DNSPARSER_CERTALGO_DSANSEC3 = 6 , GNUNET_DNSPARSER_CERTALGO_RSANSEC3 = 7 , GNUNET_DNSPARSER_CERTALGO_RSASHA256 = 8 , GNUNET_DNSPARSER_CERTALGO_RSRVD9 = 9 , GNUNET_DNSPARSER_CERTALGO_RSASHA512 = 10 , GNUNET_DNSPARSER_CERTALGO_GOST_R34 = 12 , GNUNET_DNSPARSER_CERTALGO_ECDSA_P256SHA256 = 13 , GNUNET_DNSPARSER_CERTALGO_ECDSA_P384SHA384 = 14 }
	DNSCERT algorithms as defined in http://www.iana.org/assignments/ dns-sec-alg-numbers/dns-sec-alg-numbers.xhtml, under dns-sec-alg-numbers-1. More...

Functions
enum GNUNET_GenericReturnValue	GNUNET_DNSPARSER_check_label (const char *label)
	Check if a label in UTF-8 format can be coded into valid IDNA.

enum GNUNET_GenericReturnValue	GNUNET_DNSPARSER_check_name (const char *name)
	Check if a hostname in UTF-8 format can be coded into valid IDNA.

struct GNUNET_DNSPARSER_Packet *	GNUNET_DNSPARSER_parse (const char *udp_payload, size_t udp_payload_length)
	Parse a UDP payload of a DNS packet in to a nice struct for further processing and manipulation.

void	GNUNET_DNSPARSER_free_packet (struct GNUNET_DNSPARSER_Packet *p)
	Free memory taken by a packet.

int	GNUNET_DNSPARSER_pack (const struct GNUNET_DNSPARSER_Packet p, uint16_t max, char buf, size_t buf_length)
	Given a DNS packet p, generate the corresponding UDP payload.

int	GNUNET_DNSPARSER_builder_add_name (char dst, size_t dst_len, size_t off, const char *name)
	Add a DNS name to the UDP packet at the given location, converting the name to IDNA notation as necessary.

int	GNUNET_DNSPARSER_builder_add_query (char dst, size_t dst_len, size_t off, const struct GNUNET_DNSPARSER_Query *query)
	Add a DNS query to the UDP packet at the given location.

int	GNUNET_DNSPARSER_builder_add_mx (char dst, size_t dst_len, size_t off, const struct GNUNET_DNSPARSER_MxRecord *mx)
	Add an MX record to the UDP packet at the given location.

int	GNUNET_DNSPARSER_builder_add_soa (char dst, size_t dst_len, size_t off, const struct GNUNET_DNSPARSER_SoaRecord *soa)
	Add an SOA record to the UDP packet at the given location.

int	GNUNET_DNSPARSER_builder_add_cert (char dst, size_t dst_len, size_t off, const struct GNUNET_DNSPARSER_CertRecord *cert)
	Add CERT record to the UDP packet at the given location.

int	GNUNET_DNSPARSER_builder_add_srv (char dst, size_t dst_len, size_t off, const struct GNUNET_DNSPARSER_SrvRecord *srv)
	Add an SRV record to the UDP packet at the given location.

int	GNUNET_DNSPARSER_builder_add_uri (char dst, size_t dst_len, size_t off, const struct GNUNET_DNSPARSER_UriRecord *uri)
	Add an URI record to the UDP packet at the given location.

int	GNUNET_DNSPARSER_parse_record (const char udp_payload, size_t udp_payload_length, size_t off, struct GNUNET_DNSPARSER_Record *r)
	Parse a DNS record entry.

char *	GNUNET_DNSPARSER_parse_name (const char udp_payload, size_t udp_payload_length, size_t off)
	Parse name inside of a DNS query or record.

int	GNUNET_DNSPARSER_parse_query (const char udp_payload, size_t udp_payload_length, size_t off, struct GNUNET_DNSPARSER_Query *q)
	Parse a DNS query entry.

struct GNUNET_DNSPARSER_SoaRecord *	GNUNET_DNSPARSER_parse_soa (const char udp_payload, size_t udp_payload_length, size_t off)
	Parse a DNS SOA record.

struct GNUNET_DNSPARSER_CertRecord *	GNUNET_DNSPARSER_parse_cert (const char udp_payload, size_t udp_payload_length, size_t off)
	Parse a DNS CERT record.

struct GNUNET_DNSPARSER_MxRecord *	GNUNET_DNSPARSER_parse_mx (const char udp_payload, size_t udp_payload_length, size_t off)
	Parse a DNS MX record.

struct GNUNET_DNSPARSER_SrvRecord *	GNUNET_DNSPARSER_parse_srv (const char udp_payload, size_t udp_payload_length, size_t off)
	Parse a DNS SRV record.

struct GNUNET_DNSPARSER_UriRecord *	GNUNET_DNSPARSER_parse_uri (const char udp_payload, size_t udp_payload_length, size_t off)
	Parse a DNS URI record.

struct GNUNET_DNSPARSER_Record *	GNUNET_DNSPARSER_duplicate_record (const struct GNUNET_DNSPARSER_Record *r)
	Duplicate (deep-copy) the given DNS record.

struct GNUNET_DNSPARSER_SoaRecord *	GNUNET_DNSPARSER_duplicate_soa_record (const struct GNUNET_DNSPARSER_SoaRecord *r)
	Duplicate (deep-copy) the given DNS record.

struct GNUNET_DNSPARSER_CertRecord *	GNUNET_DNSPARSER_duplicate_cert_record (const struct GNUNET_DNSPARSER_CertRecord *r)
	Duplicate (deep-copy) the given DNS record.

struct GNUNET_DNSPARSER_MxRecord *	GNUNET_DNSPARSER_duplicate_mx_record (const struct GNUNET_DNSPARSER_MxRecord *r)
	Duplicate (deep-copy) the given DNS record.

struct GNUNET_DNSPARSER_SrvRecord *	GNUNET_DNSPARSER_duplicate_srv_record (const struct GNUNET_DNSPARSER_SrvRecord *r)
	Duplicate (deep-copy) the given DNS record.

struct GNUNET_DNSPARSER_UriRecord *	GNUNET_DNSPARSER_duplicate_uri_record (const struct GNUNET_DNSPARSER_UriRecord *r)
	Duplicate (deep-copy) the given DNS record.

void	GNUNET_DNSPARSER_free_record (struct GNUNET_DNSPARSER_Record *r)
	Free the given DNS record.

void	GNUNET_DNSPARSER_free_mx (struct GNUNET_DNSPARSER_MxRecord *mx)
	Free MX information record.

void	GNUNET_DNSPARSER_free_srv (struct GNUNET_DNSPARSER_SrvRecord *srv)
	Free SRV information record.

void	GNUNET_DNSPARSER_free_uri (struct GNUNET_DNSPARSER_UriRecord *uri)
	Free URI information record.

void	GNUNET_DNSPARSER_free_soa (struct GNUNET_DNSPARSER_SoaRecord *soa)
	Free SOA information record.

void	GNUNET_DNSPARSER_free_cert (struct GNUNET_DNSPARSER_CertRecord *cert)
	Free CERT information record.

char *	GNUNET_DNSPARSER_bin_to_hex (const void *data, size_t data_size)
	Convert a block of binary data to HEX.

size_t	GNUNET_DNSPARSER_hex_to_bin (const char hex, void data)
	Convert a HEX string to block of binary data.

Detailed Description

Helper library to parse DNS packets.

Macro Definition Documentation

◆ GNUNET_DNSPARSER_MAX_LABEL_LENGTH

#define GNUNET_DNSPARSER_MAX_LABEL_LENGTH 63

Maximum length of a label in DNS.

Definition at line 46 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_MAX_NAME_LENGTH

#define GNUNET_DNSPARSER_MAX_NAME_LENGTH 253

Maximum length of a name in DNS.

Definition at line 51 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_ANY

#define GNUNET_DNSPARSER_TYPE_ANY 0

A few common DNS types.

Definition at line 57 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_A

#define GNUNET_DNSPARSER_TYPE_A 1

Definition at line 58 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_NS

#define GNUNET_DNSPARSER_TYPE_NS 2

Definition at line 59 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_CNAME

#define GNUNET_DNSPARSER_TYPE_CNAME 5

Definition at line 60 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_SOA

#define GNUNET_DNSPARSER_TYPE_SOA 6

Definition at line 61 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_PTR

#define GNUNET_DNSPARSER_TYPE_PTR 12

Definition at line 62 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_MX

#define GNUNET_DNSPARSER_TYPE_MX 15

Definition at line 63 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_TXT

#define GNUNET_DNSPARSER_TYPE_TXT 16

Definition at line 64 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_RP

#define GNUNET_DNSPARSER_TYPE_RP 17

Definition at line 65 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_AFSDB

#define GNUNET_DNSPARSER_TYPE_AFSDB 18

Definition at line 66 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_SIG

#define GNUNET_DNSPARSER_TYPE_SIG 24

Definition at line 67 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_KEY

#define GNUNET_DNSPARSER_TYPE_KEY 25

Definition at line 68 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_AAAA

#define GNUNET_DNSPARSER_TYPE_AAAA 28

Definition at line 69 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_LOC

#define GNUNET_DNSPARSER_TYPE_LOC 29

Definition at line 70 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_SRV

#define GNUNET_DNSPARSER_TYPE_SRV 33

Definition at line 71 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_NAPTR

#define GNUNET_DNSPARSER_TYPE_NAPTR 35

Definition at line 72 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_KX

#define GNUNET_DNSPARSER_TYPE_KX 36

Definition at line 73 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_CERT

#define GNUNET_DNSPARSER_TYPE_CERT 37

Definition at line 74 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_DNAME

#define GNUNET_DNSPARSER_TYPE_DNAME 39

Definition at line 75 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_APL

#define GNUNET_DNSPARSER_TYPE_APL 42

Definition at line 76 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_DS

#define GNUNET_DNSPARSER_TYPE_DS 43

Definition at line 77 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_SSHFP

#define GNUNET_DNSPARSER_TYPE_SSHFP 44

Definition at line 78 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_IPSECKEY

#define GNUNET_DNSPARSER_TYPE_IPSECKEY 45

Definition at line 79 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_RRSIG

#define GNUNET_DNSPARSER_TYPE_RRSIG 46

Definition at line 80 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_NSEC

#define GNUNET_DNSPARSER_TYPE_NSEC 47

Definition at line 81 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_DNSKEY

#define GNUNET_DNSPARSER_TYPE_DNSKEY 48

Definition at line 82 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_DHCID

#define GNUNET_DNSPARSER_TYPE_DHCID 49

Definition at line 83 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_NSEC3

#define GNUNET_DNSPARSER_TYPE_NSEC3 50

Definition at line 84 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_NSEC3PARAM

#define GNUNET_DNSPARSER_TYPE_NSEC3PARAM 51

Definition at line 85 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_TLSA

#define GNUNET_DNSPARSER_TYPE_TLSA 52

Definition at line 86 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_SMIMEA

#define GNUNET_DNSPARSER_TYPE_SMIMEA 53

Definition at line 87 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_HIP

#define GNUNET_DNSPARSER_TYPE_HIP 55

Definition at line 88 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_CDS

#define GNUNET_DNSPARSER_TYPE_CDS 59

Definition at line 89 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_CDNSKEY

#define GNUNET_DNSPARSER_TYPE_CDNSKEY 60

Definition at line 90 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_OPENPGPKEY

#define GNUNET_DNSPARSER_TYPE_OPENPGPKEY 61

Definition at line 91 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_TKEY

#define GNUNET_DNSPARSER_TYPE_TKEY 249

Definition at line 92 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_TSIG

#define GNUNET_DNSPARSER_TYPE_TSIG 250

Definition at line 93 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_ALL

#define GNUNET_DNSPARSER_TYPE_ALL 255

Definition at line 94 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_URI

#define GNUNET_DNSPARSER_TYPE_URI 256

Definition at line 95 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_CAA

#define GNUNET_DNSPARSER_TYPE_CAA 257

Definition at line 96 of file gnunet_dnsparser_lib.h.

◆ GNUNET_DNSPARSER_TYPE_TA

#define GNUNET_DNSPARSER_TYPE_TA 32768

Definition at line 97 of file gnunet_dnsparser_lib.h.

Enumeration Type Documentation

◆ GNUNET_DNSPARSER_CertType

enum GNUNET_DNSPARSER_CertType

DNS CERT types as defined in RFC 4398.

Enumerator
GNUNET_DNSPARSER_CERTTYPE_RESERVED	Reserved value.
GNUNET_DNSPARSER_CERTTYPE_PKIX	An x509 PKIX certificate.
GNUNET_DNSPARSER_CERTTYPE_SKPI	A SKPI certificate.
GNUNET_DNSPARSER_CERTTYPE_PGP	A PGP certificate.
GNUNET_DNSPARSER_CERTTYPE_IPKIX	An x509 PKIX cert URL.
GNUNET_DNSPARSER_CERTTYPE_ISKPI	A SKPI cert URL.
GNUNET_DNSPARSER_CERTTYPE_IPGP	A PGP cert fingerprint and URL.
GNUNET_DNSPARSER_CERTTYPE_ACPKIX	An attribute Certificate.
GNUNET_DNSPARSER_CERTTYPE_IACKPIX	An attribute cert URL.

Definition at line 211 of file gnunet_dnsparser_lib.h.

{
  GNUNET_DNSPARSER_CERTTYPE_RESERVED = 0,
 
  GNUNET_DNSPARSER_CERTTYPE_PKIX = 1,
 
  GNUNET_DNSPARSER_CERTTYPE_SKPI = 2,
 
  GNUNET_DNSPARSER_CERTTYPE_PGP = 3,
 
  GNUNET_DNSPARSER_CERTTYPE_IPKIX = 4,
 
  GNUNET_DNSPARSER_CERTTYPE_ISKPI = 5,
 
  GNUNET_DNSPARSER_CERTTYPE_IPGP = 6,
 
  GNUNET_DNSPARSER_CERTTYPE_ACPKIX = 7,
 
  GNUNET_DNSPARSER_CERTTYPE_IACKPIX = 8
};

◆ GNUNET_DNSPARSER_CertAlgorithm

enum GNUNET_DNSPARSER_CertAlgorithm

DNSCERT algorithms as defined in http://www.iana.org/assignments/ dns-sec-alg-numbers/dns-sec-alg-numbers.xhtml, under dns-sec-alg-numbers-1.

Enumerator
GNUNET_DNSPARSER_CERTALGO_UNDEFINED	No defined.
GNUNET_DNSPARSER_CERTALGO_RSAMD5	RSA/MD5.
GNUNET_DNSPARSER_CERTALGO_DH	Diffie-Hellman.
GNUNET_DNSPARSER_CERTALGO_DSASHA	DSA/SHA1.
GNUNET_DNSPARSER_CERTALGO_RSRVD4	Reserved.
GNUNET_DNSPARSER_CERTALGO_RSASHA	RSA/SHA1.
GNUNET_DNSPARSER_CERTALGO_DSANSEC3	DSA/NSEC3/SHA.
GNUNET_DNSPARSER_CERTALGO_RSANSEC3	RSA/NSEC3/SHA.
GNUNET_DNSPARSER_CERTALGO_RSASHA256	RSA/SHA256.
GNUNET_DNSPARSER_CERTALGO_RSRVD9	Reserved.
GNUNET_DNSPARSER_CERTALGO_RSASHA512	RSA/SHA512.
GNUNET_DNSPARSER_CERTALGO_GOST_R34	GHOST R 34.10-2001.
GNUNET_DNSPARSER_CERTALGO_ECDSA_P256SHA256	ECDSA Curve P-256/SHA256.
GNUNET_DNSPARSER_CERTALGO_ECDSA_P384SHA384	ECDSA Curve P-384/SHA384.

Definition at line 264 of file gnunet_dnsparser_lib.h.

{
  GNUNET_DNSPARSER_CERTALGO_UNDEFINED = 0,
 
  GNUNET_DNSPARSER_CERTALGO_RSAMD5 = 1,
 
  GNUNET_DNSPARSER_CERTALGO_DH = 2,
 
  GNUNET_DNSPARSER_CERTALGO_DSASHA = 3,
 
  GNUNET_DNSPARSER_CERTALGO_RSRVD4 = 4,
 
  GNUNET_DNSPARSER_CERTALGO_RSASHA = 5,
 
  GNUNET_DNSPARSER_CERTALGO_DSANSEC3 = 6,
 
  GNUNET_DNSPARSER_CERTALGO_RSANSEC3 = 7,
 
  GNUNET_DNSPARSER_CERTALGO_RSASHA256 = 8,
 
  GNUNET_DNSPARSER_CERTALGO_RSRVD9 = 9,
 
  GNUNET_DNSPARSER_CERTALGO_RSASHA512 = 10,
 
  GNUNET_DNSPARSER_CERTALGO_GOST_R34 = 12,
 
  GNUNET_DNSPARSER_CERTALGO_ECDSA_P256SHA256 = 13,
 
  GNUNET_DNSPARSER_CERTALGO_ECDSA_P384SHA384 = 14
};

Function Documentation

◆ GNUNET_DNSPARSER_check_label()

enum GNUNET_GenericReturnValue GNUNET_DNSPARSER_check_label ( const char * label )

Check if a label in UTF-8 format can be coded into valid IDNA.

This can fail if the ASCII-conversion becomes longer than 63 characters.

Parameters

label label to check (UTF-8 string)

Returns: GNUNET_OK if the label can be converted to IDNA, GNUNET_SYSERR if the label is not valid for DNS names

Definition at line 53 of file dnsparser.c.

{
  char *output;
  size_t slen;
 
  if (NULL != strchr (label, '.'))
    return GNUNET_SYSERR; /* not a label! Did you mean GNUNET_DNSPARSER_check_name? */
  if (0 == strcmp (label, "@")) /* '@' is reserved for the empty label, see #GNUNET_GNS_EMPTY_LABEL_AT */
    return GNUNET_SYSERR;
  if (IDNA_SUCCESS != idna_to_ascii_8z (label, &output, IDNA_ALLOW_UNASSIGNED))
    return GNUNET_SYSERR;
  slen = strlen (output);
  free (output);
  return (slen > 63) ? GNUNET_SYSERR : GNUNET_OK;
}

References GNUNET_OK, and GNUNET_SYSERR.

Referenced by GNUNET_DNSPARSER_check_name().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_check_name()

enum GNUNET_GenericReturnValue GNUNET_DNSPARSER_check_name ( const char * name )

Check if a hostname in UTF-8 format can be coded into valid IDNA.

This can fail if a label becomes longer than 63 characters or if the entire name exceeds 253 characters.

Parameters

name	name to check (UTF-8 string)

Returns: GNUNET_OK if the label can be converted to IDNA, GNUNET_SYSERR if the label is not valid for DNS names

Check if a hostname in UTF-8 format can be coded into valid IDNA.

This can fail if the ASCII-conversion becomes longer than 253 characters.

Parameters

name	name to check (UTF-8 string)

Returns: GNUNET_OK if the label can be converted to IDNA, GNUNET_SYSERR if the label is not valid for DNS names

Definition at line 79 of file dnsparser.c.

{
  {
    char *ldup;
    char *saveptr;
 
    ldup = GNUNET_strdup (name);
    for (const char *tok = strtok_r (ldup,
                                     ".",
                                     &saveptr);
         NULL != tok;
         tok = strtok_r (NULL,
                         ".",
                         &saveptr))
    {
      if (GNUNET_OK !=
          GNUNET_DNSPARSER_check_label (tok))
      {
        GNUNET_free (ldup);
        return GNUNET_SYSERR;
      }
    }
    GNUNET_free (ldup);
  }
  {
    char *output;
    size_t slen;
 
    if (IDNA_SUCCESS !=
        idna_to_ascii_8z (name,
                          &output,
                          IDNA_ALLOW_UNASSIGNED))
      return GNUNET_SYSERR;
    slen = strlen (output);
    free (output);
    return (slen > 253) ? GNUNET_SYSERR : GNUNET_OK;
  }
}

References GNUNET_DNSPARSER_check_label(), GNUNET_free, GNUNET_OK, GNUNET_strdup, GNUNET_SYSERR, and name.

Referenced by queue(), queue(), and run().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_parse()

struct GNUNET_DNSPARSER_Packet * GNUNET_DNSPARSER_parse	(	const char *	udp_payload,
		size_t	udp_payload_length
	)

Parse a UDP payload of a DNS packet in to a nice struct for further processing and manipulation.

Parameters

udp_payload	wire-format of the DNS packet
udp_payload_length	number of bytes in udp_payload

Returns: NULL on error, otherwise the parsed packet

Definition at line 756 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_Packet *p;
  const struct GNUNET_TUN_DnsHeader *dns;
  size_t off;
  unsigned int n;
 
  if (udp_payload_length < sizeof(struct GNUNET_TUN_DnsHeader))
    return NULL;
  dns = (const struct GNUNET_TUN_DnsHeader *) udp_payload;
  off = sizeof(struct GNUNET_TUN_DnsHeader);
  p = GNUNET_new (struct GNUNET_DNSPARSER_Packet);
  p->flags = dns->flags;
  p->id = dns->id;
  n = ntohs (dns->query_count);
  if (n > 0)
  {
    p->queries = GNUNET_new_array (n, struct GNUNET_DNSPARSER_Query);
    p->num_queries = n;
    for (unsigned int i = 0; i < n; i++)
      if (GNUNET_OK != GNUNET_DNSPARSER_parse_query (udp_payload,
                                                     udp_payload_length,
                                                     &off,
                                                     &p->queries[i]))
        goto error;
  }
  n = ntohs (dns->answer_rcount);
  if (n > 0)
  {
    p->answers = GNUNET_new_array (n, struct GNUNET_DNSPARSER_Record);
    p->num_answers = n;
    for (unsigned int i = 0; i < n; i++)
      if (GNUNET_OK != GNUNET_DNSPARSER_parse_record (udp_payload,
                                                      udp_payload_length,
                                                      &off,
                                                      &p->answers[i]))
        goto error;
  }
  n = ntohs (dns->authority_rcount);
  if (n > 0)
  {
    p->authority_records = GNUNET_new_array (n, struct GNUNET_DNSPARSER_Record);
    p->num_authority_records = n;
    for (unsigned int i = 0; i < n; i++)
      if (GNUNET_OK != GNUNET_DNSPARSER_parse_record (udp_payload,
                                                      udp_payload_length,
                                                      &off,
                                                      &p->authority_records[i]))
        goto error;
  }
  n = ntohs (dns->additional_rcount);
  if (n > 0)
  {
    p->additional_records =
      GNUNET_new_array (n, struct GNUNET_DNSPARSER_Record);
    p->num_additional_records = n;
    for (unsigned int i = 0; i < n; i++)
    {
      if (GNUNET_OK !=
          GNUNET_DNSPARSER_parse_record (udp_payload,
                                         udp_payload_length,
                                         &off,
                                         &p->additional_records[i]))
        goto error;
    }
  }
  return p;
error:
  GNUNET_break_op (0);
  GNUNET_DNSPARSER_free_packet (p);
  return NULL;
}

References GNUNET_TUN_DnsHeader::additional_rcount, GNUNET_TUN_DnsHeader::answer_rcount, GNUNET_TUN_DnsHeader::authority_rcount, GNUNET_TUN_DnsHeader::flags, GNUNET_break_op, GNUNET_DNSPARSER_free_packet(), GNUNET_DNSPARSER_parse_query(), GNUNET_DNSPARSER_parse_record(), GNUNET_new, GNUNET_new_array, GNUNET_OK, GNUNET_TUN_DnsHeader::id, p, and GNUNET_TUN_DnsHeader::query_count.

Referenced by display_request(), dns_post_request_handler(), dns_result_parser(), dns_result_processor(), handle_dns_request(), handle_request(), handle_resolve_result(), modify_request(), process_result(), and process_result().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_free_packet()

void GNUNET_DNSPARSER_free_packet ( struct GNUNET_DNSPARSER_Packet * p )

Free memory taken by a packet.

Parameters

p	packet to free

Definition at line 978 of file dnsparser.c.

{
  for (unsigned int i = 0; i < p->num_queries; i++)
    GNUNET_free (p->queries[i].name);
  GNUNET_free (p->queries);
  for (unsigned int i = 0; i < p->num_answers; i++)
    GNUNET_DNSPARSER_free_record (&p->answers[i]);
  GNUNET_free (p->answers);
  for (unsigned int i = 0; i < p->num_authority_records; i++)
    GNUNET_DNSPARSER_free_record (&p->authority_records[i]);
  GNUNET_free (p->authority_records);
  for (unsigned int i = 0; i < p->num_additional_records; i++)
    GNUNET_DNSPARSER_free_record (&p->additional_records[i]);
  GNUNET_free (p->additional_records);
  GNUNET_free (p);
}

References GNUNET_DNSPARSER_free_record(), GNUNET_free, and p.

Referenced by display_request(), dns_post_request_handler(), dns_result_parser(), do_timeout(), finish_request(), GNS_interceptor_done(), GNUNET_DNSPARSER_parse(), handle_dns_request(), handle_request(), handle_resolve_result(), modify_request(), process_result(), process_result(), recursive_dns_resolution(), reply_to_dns(), result_processor(), send_response(), and vpn_allocation_callback().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_pack()

int GNUNET_DNSPARSER_pack	(	const struct GNUNET_DNSPARSER_Packet *	p,
		uint16_t	max,
		char **	buf,
		size_t *	buf_length
	)

Given a DNS packet p, generate the corresponding UDP payload.

Note that we do not attempt to pack the strings with pointers as this would complicate the code and this is about being simple and secure, not fast, fancy and broken like bind.

Parameters

p	packet to pack
max	maximum allowed size for the resulting UDP payload
buf	set to a buffer with the packed message
buf_length	set to the length of buf

Returns: GNUNET_SYSERR if p is invalid GNUNET_NO if p was truncated (but there is still a result in buf) GNUNET_OK if p was packed completely into buf

Definition at line 1428 of file dnsparser.c.

{
  struct GNUNET_TUN_DnsHeader dns;
  size_t off;
  char tmp[max];
  int ret;
  int trc;
 
  if ((p->num_queries > UINT16_MAX) || (p->num_answers > UINT16_MAX) ||
      (p->num_authority_records > UINT16_MAX) ||
      (p->num_additional_records > UINT16_MAX))
    return GNUNET_SYSERR;
  dns.id = p->id;
  dns.flags = p->flags;
  dns.query_count = htons (p->num_queries);
  dns.answer_rcount = htons (p->num_answers);
  dns.authority_rcount = htons (p->num_authority_records);
  dns.additional_rcount = htons (p->num_additional_records);
 
  off = sizeof(struct GNUNET_TUN_DnsHeader);
  trc = GNUNET_NO;
  for (unsigned int i = 0; i < p->num_queries; i++)
  {
    ret = GNUNET_DNSPARSER_builder_add_query (tmp,
                                              sizeof(tmp),
                                              &off,
                                              &p->queries[i]);
    if (GNUNET_SYSERR == ret)
      return GNUNET_SYSERR;
    if (GNUNET_NO == ret)
    {
      dns.query_count = htons ((uint16_t) (i - 1));
      trc = GNUNET_YES;
      break;
    }
  }
  for (unsigned int i = 0; i < p->num_answers; i++)
  {
    ret = add_record (tmp, sizeof(tmp), &off, &p->answers[i]);
    if (GNUNET_SYSERR == ret)
      return GNUNET_SYSERR;
    if (GNUNET_NO == ret)
    {
      dns.answer_rcount = htons ((uint16_t) (i - 1));
      trc = GNUNET_YES;
      break;
    }
  }
  for (unsigned int i = 0; i < p->num_authority_records; i++)
  {
    ret = add_record (tmp, sizeof(tmp), &off, &p->authority_records[i]);
    if (GNUNET_SYSERR == ret)
      return GNUNET_SYSERR;
    if (GNUNET_NO == ret)
    {
      dns.authority_rcount = htons ((uint16_t) (i - 1));
      trc = GNUNET_YES;
      break;
    }
  }
  for (unsigned int i = 0; i < p->num_additional_records; i++)
  {
    ret = add_record (tmp, sizeof(tmp), &off, &p->additional_records[i]);
    if (GNUNET_SYSERR == ret)
      return GNUNET_SYSERR;
    if (GNUNET_NO == ret)
    {
      dns.additional_rcount = htons (i - 1);
      trc = GNUNET_YES;
      break;
    }
  }
 
  if (GNUNET_YES == trc)
    dns.flags.message_truncated = 1;
  GNUNET_memcpy (tmp, &dns, sizeof(struct GNUNET_TUN_DnsHeader));
 
  *buf = GNUNET_malloc (off);
  *buf_length = off;
  GNUNET_memcpy (*buf, tmp, off);
  if (GNUNET_YES == trc)
    return GNUNET_NO;
  return GNUNET_OK;
}

References add_record(), GNUNET_TUN_DnsHeader::additional_rcount, GNUNET_TUN_DnsHeader::answer_rcount, GNUNET_TUN_DnsHeader::authority_rcount, GNUNET_TUN_DnsHeader::flags, GNUNET_DNSPARSER_builder_add_query(), GNUNET_malloc, GNUNET_memcpy, GNUNET_NO, GNUNET_OK, GNUNET_SYSERR, GNUNET_YES, GNUNET_TUN_DnsHeader::id, max, GNUNET_TUN_DnsFlags::message_truncated, p, GNUNET_TUN_DnsHeader::query_count, and ret.

Referenced by build_dns_query(), finish_request(), modify_request(), pack(), queue(), recursive_dns_resolution(), reply_to_dns(), and send_response().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_builder_add_name()

int GNUNET_DNSPARSER_builder_add_name	(	char *	dst,
		size_t	dst_len,
		size_t *	off,
		const char *	name
	)

Add a DNS name to the UDP packet at the given location, converting the name to IDNA notation as necessary.

Parameters

dst	where to write the name (UDP packet)
dst_len	number of bytes in dst
off	pointer to offset where to write the name (increment by bytes used) must not be changed if there is an error
name	name to write

Returns: GNUNET_SYSERR if name is invalid GNUNET_NO if name did not fit GNUNET_OK if name was added to dst

Definition at line 1013 of file dnsparser.c.

{
  const char *dot;
  const char *idna_name;
  char *idna_start;
  size_t start;
  size_t pos;
  size_t len;
  Idna_rc rc;
 
  if (NULL == name)
    return GNUNET_SYSERR;
 
  if (IDNA_SUCCESS !=
      (rc = idna_to_ascii_8z (name, &idna_start, IDNA_ALLOW_UNASSIGNED)))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
                _ (
                  "Failed to convert UTF-8 name `%s' to DNS IDNA format: %s\n"),
                name,
                idna_strerror (rc));
    return GNUNET_NO;
  }
  idna_name = idna_start;
  GNUNET_assert (*off <= SIZE_MAX - strlen (idna_name) - 2);
  start = *off;
  if (start + strlen (idna_name) + 2 > dst_len)
    goto fail;
  pos = start;
  do
  {
    dot = strchr (idna_name, '.');
    if (NULL == dot)
      len = strlen (idna_name);
    else
      len = dot - idna_name;
    if (len == 0)
      break;
    if (len >= 64)
    {
      GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                  "Invalid DNS name `%s': label with %u characters encountered\n",
                  name,
                  (unsigned int) len);
      goto fail;     /* label too long or empty */
    }
    dst[pos++] = (char) (uint8_t) len;
    GNUNET_memcpy (&dst[pos], idna_name, len);
    pos += len;
    idna_name += len + 1;   /* also skip dot */
  }
  while (NULL != dot);
  dst[pos++] = '\0'; /* terminator */
  *off = pos;
  free (idna_start);
  return GNUNET_OK;
fail:
  free (idna_start);
  return GNUNET_NO;
}

References _, GNUNET_assert, GNUNET_ERROR_TYPE_ERROR, GNUNET_ERROR_TYPE_WARNING, GNUNET_log, GNUNET_memcpy, GNUNET_NO, GNUNET_OK, GNUNET_SYSERR, idna_name, name, SIZE_MAX, and start.

Referenced by add_record(), dns_result_parser(), dns_string_to_value(), GNUNET_DNSPARSER_builder_add_mx(), GNUNET_DNSPARSER_builder_add_query(), GNUNET_DNSPARSER_builder_add_soa(), GNUNET_DNSPARSER_builder_add_srv(), handle_gns_resolution_result(), and process_record().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_builder_add_query()

int GNUNET_DNSPARSER_builder_add_query	(	char *	dst,
		size_t	dst_len,
		size_t *	off,
		const struct GNUNET_DNSPARSER_Query *	query
	)

Add a DNS query to the UDP packet at the given location.

Parameters

dst	where to write the query
dst_len	number of bytes in dst
off	pointer to offset where to write the query (increment by bytes used) must not be changed if there is an error
query	query to write

Returns: GNUNET_SYSERR if query is invalid GNUNET_NO if query did not fit GNUNET_OK if query was added to dst

Definition at line 1091 of file dnsparser.c.

{
  int ret;
  struct GNUNET_TUN_DnsQueryLine ql;
 
  GNUNET_assert (dst_len >= sizeof (ql));
  ret = GNUNET_DNSPARSER_builder_add_name (dst,
                                           dst_len - sizeof(ql),
                                           off,
                                           query->name);
  if (ret != GNUNET_OK)
    return ret;
  ql.type = htons (query->type);
  ql.dns_traffic_class = htons (query->dns_traffic_class);
  GNUNET_memcpy (&dst[*off], &ql, sizeof(ql));
  (*off) += sizeof(ql);
  return GNUNET_OK;
}

References GNUNET_DNSPARSER_Query::dns_traffic_class, GNUNET_TUN_DnsQueryLine::dns_traffic_class, GNUNET_assert, GNUNET_DNSPARSER_builder_add_name(), GNUNET_memcpy, GNUNET_OK, GNUNET_DNSPARSER_Query::name, ret, GNUNET_DNSPARSER_Query::type, and GNUNET_TUN_DnsQueryLine::type.

Referenced by GNUNET_DNSPARSER_pack().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_builder_add_mx()

int GNUNET_DNSPARSER_builder_add_mx	(	char *	dst,
		size_t	dst_len,
		size_t *	off,
		const struct GNUNET_DNSPARSER_MxRecord *	mx
	)

Add an MX record to the UDP packet at the given location.

Parameters

dst	where to write the mx record
dst_len	number of bytes in dst
off	pointer to offset where to write the mx information (increment by bytes used); can also change if there was an error
mx	mx information to write

Returns: GNUNET_SYSERR if mx is invalid GNUNET_NO if mx did not fit GNUNET_OK if mx was added to dst

Definition at line 1127 of file dnsparser.c.

{
  uint16_t mxpref;
 
  GNUNET_assert (*off <= SIZE_MAX - sizeof (uint16_t));
  if (*off + sizeof(uint16_t) > dst_len)
    return GNUNET_NO;
  mxpref = htons (mx->preference);
  GNUNET_memcpy (&dst[*off], &mxpref, sizeof(mxpref));
  (*off) += sizeof(mxpref);
  return GNUNET_DNSPARSER_builder_add_name (dst, dst_len, off, mx->mxhost);
}

References GNUNET_assert, GNUNET_DNSPARSER_builder_add_name(), GNUNET_memcpy, GNUNET_NO, GNUNET_DNSPARSER_MxRecord::mxhost, GNUNET_DNSPARSER_MxRecord::preference, and SIZE_MAX.

Referenced by add_record(), dns_result_parser(), dns_string_to_value(), handle_gns_resolution_result(), and process_record().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_builder_add_soa()

int GNUNET_DNSPARSER_builder_add_soa	(	char *	dst,
		size_t	dst_len,
		size_t *	off,
		const struct GNUNET_DNSPARSER_SoaRecord *	soa
	)

Add an SOA record to the UDP packet at the given location.

Parameters

dst	where to write the SOA record
dst_len	number of bytes in dst
off	pointer to offset where to write the SOA information (increment by bytes used) can also change if there was an error
soa	SOA information to write

Returns: GNUNET_SYSERR if soa is invalid GNUNET_NO if soa did not fit GNUNET_OK if soa was added to dst

Definition at line 1205 of file dnsparser.c.

{
  struct GNUNET_TUN_DnsSoaRecord sd;
  int ret;
 
  if ((GNUNET_OK !=
       (ret =
          GNUNET_DNSPARSER_builder_add_name (dst, dst_len, off, soa->mname))) ||
      (GNUNET_OK !=
       (ret =
          GNUNET_DNSPARSER_builder_add_name (dst, dst_len, off, soa->rname))))
    return ret;
  if (*off + sizeof(struct GNUNET_TUN_DnsSoaRecord) > dst_len)
    return GNUNET_NO;
  sd.serial = htonl (soa->serial);
  sd.refresh = htonl (soa->refresh);
  sd.retry = htonl (soa->retry);
  sd.expire = htonl (soa->expire);
  sd.minimum = htonl (soa->minimum_ttl);
  GNUNET_memcpy (&dst[*off], &sd, sizeof(sd));
  (*off) += sizeof(sd);
  return GNUNET_OK;
}

References GNUNET_DNSPARSER_SoaRecord::expire, GNUNET_TUN_DnsSoaRecord::expire, GNUNET_DNSPARSER_builder_add_name(), GNUNET_memcpy, GNUNET_NO, GNUNET_OK, GNUNET_TUN_DnsSoaRecord::minimum, GNUNET_DNSPARSER_SoaRecord::minimum_ttl, GNUNET_DNSPARSER_SoaRecord::mname, GNUNET_DNSPARSER_SoaRecord::refresh, GNUNET_TUN_DnsSoaRecord::refresh, ret, GNUNET_DNSPARSER_SoaRecord::retry, GNUNET_TUN_DnsSoaRecord::retry, GNUNET_DNSPARSER_SoaRecord::rname, GNUNET_DNSPARSER_SoaRecord::serial, and GNUNET_TUN_DnsSoaRecord::serial.

Referenced by add_record(), dns_result_parser(), dns_string_to_value(), handle_gns_resolution_result(), and process_record().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_builder_add_cert()

int GNUNET_DNSPARSER_builder_add_cert	(	char *	dst,
		size_t	dst_len,
		size_t *	off,
		const struct GNUNET_DNSPARSER_CertRecord *	cert
	)

Add CERT record to the UDP packet at the given location.

Parameters

dst	where to write the CERT record
dst_len	number of bytes in dst
off	pointer to offset where to write the CERT information (increment by bytes used) can also change if there was an error
cert	CERT information to write

Returns: GNUNET_SYSERR if soa is invalid GNUNET_NO if soa did not fit GNUNET_OK if soa was added to dst

Add CERT record to the UDP packet at the given location.

Parameters

dst	where to write the CERT record
dst_len	number of bytes in dst
off	pointer to offset where to write the CERT information (increment by bytes used); can also change if there was an error
cert	CERT information to write

Returns: GNUNET_SYSERR if cert is invalid GNUNET_NO if cert did not fit GNUNET_OK if cert was added to dst

Definition at line 1157 of file dnsparser.c.

{
  struct GNUNET_TUN_DnsCertRecord dcert;
 
#ifdef __clang__
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wtautological-constant-out-of-range-compare"
#endif
  if ((cert->cert_type > UINT16_MAX) || (cert->algorithm > UINT8_MAX))
  {
    GNUNET_break (0);
    return GNUNET_SYSERR;
  }
#ifdef __clang__
#pragma clang diagnostic pop
#endif
  GNUNET_assert (*off <= SIZE_MAX - sizeof (dcert));
  GNUNET_assert (cert->certificate_size <= SIZE_MAX - *off - sizeof (dcert));
  if (*off + sizeof(dcert) + cert->certificate_size > dst_len)
    return GNUNET_NO;
  dcert.cert_type = htons ((uint16_t) cert->cert_type);
  dcert.cert_tag = htons ((uint16_t) cert->cert_tag);
  dcert.algorithm = (uint8_t) cert->algorithm;
  GNUNET_memcpy (&dst[*off], &dcert, sizeof(dcert));
  (*off) += sizeof(dcert);
  GNUNET_memcpy (&dst[*off], cert->certificate_data, cert->certificate_size);
  (*off) += cert->certificate_size;
  return GNUNET_OK;
}

References GNUNET_DNSPARSER_CertRecord::algorithm, GNUNET_TUN_DnsCertRecord::algorithm, GNUNET_DNSPARSER_CertRecord::cert_tag, GNUNET_TUN_DnsCertRecord::cert_tag, GNUNET_DNSPARSER_CertRecord::cert_type, GNUNET_TUN_DnsCertRecord::cert_type, GNUNET_DNSPARSER_CertRecord::certificate_data, GNUNET_DNSPARSER_CertRecord::certificate_size, GNUNET_assert, GNUNET_break, GNUNET_memcpy, GNUNET_NO, GNUNET_OK, GNUNET_SYSERR, and SIZE_MAX.

Referenced by add_record(), dns_string_to_value(), and process_record().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_builder_add_srv()

int GNUNET_DNSPARSER_builder_add_srv	(	char *	dst,
		size_t	dst_len,
		size_t *	off,
		const struct GNUNET_DNSPARSER_SrvRecord *	srv
	)

Add an SRV record to the UDP packet at the given location.

Parameters

dst	where to write the SRV record
dst_len	number of bytes in dst
off	pointer to offset where to write the SRV information (increment by bytes used) can also change if there was an error
srv	SRV information to write

Returns: GNUNET_SYSERR if srv is invalid GNUNET_NO if srv did not fit GNUNET_OK if srv was added to dst

Definition at line 1246 of file dnsparser.c.

{
  struct GNUNET_TUN_DnsSrvRecord sd;
  int ret;
 
  GNUNET_assert (*off <= SIZE_MAX - sizeof (sd));
  if (*off + sizeof(sd) > dst_len)
    return GNUNET_NO;
  sd.prio = htons (srv->priority);
  sd.weight = htons (srv->weight);
  sd.port = htons (srv->port);
  GNUNET_memcpy (&dst[*off], &sd, sizeof(sd));
  (*off) += sizeof(sd);
  if (GNUNET_OK !=
      (ret =
         GNUNET_DNSPARSER_builder_add_name (dst, dst_len, off, srv->target)))
    return ret;
  return GNUNET_OK;
}

References GNUNET_assert, GNUNET_DNSPARSER_builder_add_name(), GNUNET_memcpy, GNUNET_NO, GNUNET_OK, GNUNET_DNSPARSER_SrvRecord::port, GNUNET_TUN_DnsSrvRecord::port, GNUNET_TUN_DnsSrvRecord::prio, GNUNET_DNSPARSER_SrvRecord::priority, ret, SIZE_MAX, GNUNET_DNSPARSER_SrvRecord::target, GNUNET_DNSPARSER_SrvRecord::weight, and GNUNET_TUN_DnsSrvRecord::weight.

Referenced by add_record(), dns_result_parser(), dns_string_to_value(), handle_gns_resolution_result(), and process_record().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_builder_add_uri()

int GNUNET_DNSPARSER_builder_add_uri	(	char *	dst,
		size_t	dst_len,
		size_t *	off,
		const struct GNUNET_DNSPARSER_UriRecord *	uri
	)

Add an URI record to the UDP packet at the given location.

Parameters

dst	where to write the URI record
dst_len	number of bytes in dst
off	pointer to offset where to write the URI information (increment by bytes used) can also change if there was an error
uri	URI information to write

Returns: GNUNET_SYSERR if uri is invalid GNUNET_NO if uri did not fit GNUNET_OK if uri was added to dst

Definition at line 1283 of file dnsparser.c.

{
  struct GNUNET_TUN_DnsUriRecord sd;
  int written;
  size_t max_target_len;
 
  GNUNET_assert (dst_len > sizeof (sd));
  GNUNET_assert (*off <= SIZE_MAX - sizeof (sd));
  max_target_len = dst_len - sizeof (sd) - 1;
  if (*off + sizeof(sd) > dst_len)
    return GNUNET_NO;
  sd.prio = htons (uri->priority);
  sd.weight = htons (uri->weight);
  GNUNET_memcpy (&dst[*off], &sd, sizeof(sd));
  (*off) += sizeof(sd);
  written = GNUNET_snprintf (&dst[*off], max_target_len, "%s", uri->target);
  (*off) += written;
  dst[*off] = '\0';
  return GNUNET_OK;
}

References GNUNET_assert, GNUNET_memcpy, GNUNET_NO, GNUNET_OK, GNUNET_snprintf(), GNUNET_TUN_DnsUriRecord::prio, SIZE_MAX, uri, and GNUNET_TUN_DnsUriRecord::weight.

Referenced by add_record(), dns_result_parser(), dns_string_to_value(), handle_gns_resolution_result(), and process_record().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_parse_record()

int GNUNET_DNSPARSER_parse_record	(	const char *	udp_payload,
		size_t	udp_payload_length,
		size_t *	off,
		struct GNUNET_DNSPARSER_Record *	r
	)

Parse a DNS record entry.

Parameters

udp_payload	entire UDP payload
udp_payload_length	length of udp_payload
off	pointer to the offset of the record to parse in the udp_payload (to be incremented by the size of the record)
r	where to write the record information

Returns: GNUNET_OK on success, GNUNET_SYSERR if the record is malformed

Definition at line 640 of file dnsparser.c.

{
  char *name;
  struct GNUNET_TUN_DnsRecordLine rl;
  size_t old_off;
  uint16_t data_len;
 
  name = GNUNET_DNSPARSER_parse_name (udp_payload, udp_payload_length, off);
  if (NULL == name)
  {
    GNUNET_break_op (0);
    return GNUNET_SYSERR;
  }
  r->name = name;
  if (*off + sizeof(struct GNUNET_TUN_DnsRecordLine) > udp_payload_length)
  {
    GNUNET_break_op (0);
    return GNUNET_SYSERR;
  }
  GNUNET_memcpy (&rl, &udp_payload[*off], sizeof(rl));
  (*off) += sizeof(rl);
  r->type = ntohs (rl.type);
  r->dns_traffic_class = ntohs (rl.dns_traffic_class);
  r->expiration_time = GNUNET_TIME_relative_to_absolute (
    GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, ntohl (rl.ttl)));
  data_len = ntohs (rl.data_len);
  if (*off + data_len > udp_payload_length)
  {
    GNUNET_break_op (0);
    return GNUNET_SYSERR;
  }
  old_off = *off;
  switch (r->type)
  {
  case GNUNET_DNSPARSER_TYPE_NS:
  case GNUNET_DNSPARSER_TYPE_CNAME:
  case GNUNET_DNSPARSER_TYPE_DNAME:
  case GNUNET_DNSPARSER_TYPE_PTR:
    r->data.hostname =
      GNUNET_DNSPARSER_parse_name (udp_payload, udp_payload_length, off);
    if ((NULL == r->data.hostname) || (old_off + data_len != *off))
      return GNUNET_SYSERR;
    return GNUNET_OK;
 
  case GNUNET_DNSPARSER_TYPE_SOA:
    r->data.soa =
      GNUNET_DNSPARSER_parse_soa (udp_payload, udp_payload_length, off);
    if ((NULL == r->data.soa) || (old_off + data_len != *off))
    {
      GNUNET_break_op (0);
      return GNUNET_SYSERR;
    }
    return GNUNET_OK;
 
  case GNUNET_DNSPARSER_TYPE_MX:
    r->data.mx =
      GNUNET_DNSPARSER_parse_mx (udp_payload, udp_payload_length, off);
    if ((NULL == r->data.mx) || (old_off + data_len != *off))
    {
      GNUNET_break_op (0);
      return GNUNET_SYSERR;
    }
    return GNUNET_OK;
 
  case GNUNET_DNSPARSER_TYPE_SRV:
    r->data.srv =
      GNUNET_DNSPARSER_parse_srv (udp_payload, udp_payload_length, off);
    if ((NULL == r->data.srv) || (old_off + data_len != *off))
    {
      GNUNET_break_op (0);
      return GNUNET_SYSERR;
    }
    return GNUNET_OK;
 
  case GNUNET_DNSPARSER_TYPE_URI:
    r->data.uri =
      GNUNET_DNSPARSER_parse_uri (udp_payload, udp_payload_length, off);
    if ((NULL == r->data.uri) || (old_off + data_len != *off))
    {
      GNUNET_break_op (0);
      return GNUNET_SYSERR;
    }
    return GNUNET_OK;
  case GNUNET_DNSPARSER_TYPE_CERT:
    r->data.cert =
      GNUNET_DNSPARSER_parse_cert (udp_payload,
                                   udp_payload_length,
                                   off);
    if ((NULL == r->data.cert) || (old_off + data_len != *off))
    {
      GNUNET_break_op (0);
      return GNUNET_SYSERR;
    }
  default:
    r->data.raw.data = GNUNET_malloc (data_len);
    r->data.raw.data_len = data_len;
    GNUNET_memcpy (r->data.raw.data, &udp_payload[*off], data_len);
    break;
  }
  (*off) += data_len;
  return GNUNET_OK;
}

Referenced by GNUNET_DNSPARSER_parse().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_parse_name()

char * GNUNET_DNSPARSER_parse_name	(	const char *	udp_payload,
		size_t	udp_payload_length,
		size_t *	off
	)

Parse name inside of a DNS query or record.

Parameters

udp_payload	entire UDP payload
udp_payload_length	length of udp_payload
off	pointer to the offset of the name to parse in the udp_payload (to be incremented by the size of the name)

Returns: name as 0-terminated C string on success, NULL if the payload is malformed

Definition at line 371 of file dnsparser.c.

{
  return parse_name (udp_payload, udp_payload_length, off, 0);
}

References parse_name().

Referenced by dns_value_to_string(), GNUNET_DNSPARSER_parse_mx(), GNUNET_DNSPARSER_parse_query(), GNUNET_DNSPARSER_parse_record(), GNUNET_DNSPARSER_parse_soa(), GNUNET_DNSPARSER_parse_srv(), handle_gns_resolution_result(), recursive_cname_resolution(), and reply_to_dns().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_parse_query()

int GNUNET_DNSPARSER_parse_query	(	const char *	udp_payload,
		size_t	udp_payload_length,
		size_t *	off,
		struct GNUNET_DNSPARSER_Query *	q
	)

Parse a DNS query entry.

Parameters

udp_payload	entire UDP payload
udp_payload_length	length of udp_payload
off	pointer to the offset of the query to parse in the udp_payload (to be incremented by the size of the query)
q	where to write the query information

Returns: GNUNET_OK on success, GNUNET_SYSERR if the query is malformed

Definition at line 390 of file dnsparser.c.

{
  char *name;
  struct GNUNET_TUN_DnsQueryLine ql;
 
  name = GNUNET_DNSPARSER_parse_name (udp_payload, udp_payload_length, off);
  if (NULL == name)
  {
    GNUNET_break_op (0);
    return GNUNET_SYSERR;
  }
  q->name = name;
  if (*off + sizeof(struct GNUNET_TUN_DnsQueryLine) > udp_payload_length)
  {
    GNUNET_break_op (0);
    return GNUNET_SYSERR;
  }
  GNUNET_memcpy (&ql, &udp_payload[*off], sizeof(ql));
  *off += sizeof(ql);
  q->type = ntohs (ql.type);
  q->dns_traffic_class = ntohs (ql.dns_traffic_class);
  return GNUNET_OK;
}

References GNUNET_TUN_DnsQueryLine::dns_traffic_class, GNUNET_break_op, GNUNET_DNSPARSER_parse_name(), GNUNET_memcpy, GNUNET_OK, GNUNET_SYSERR, name, q, and GNUNET_TUN_DnsQueryLine::type.

Referenced by GNUNET_DNSPARSER_parse().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_parse_soa()

struct GNUNET_DNSPARSER_SoaRecord * GNUNET_DNSPARSER_parse_soa	(	const char *	udp_payload,
		size_t	udp_payload_length,
		size_t *	off
	)

Parse a DNS SOA record.

Parameters

udp_payload	reference to UDP packet
udp_payload_length	length of udp_payload
off	pointer to the offset of the query to parse in the SOA record (to be incremented by the size of the record), unchanged on error

Returns: the parsed SOA record, NULL on error

Definition at line 428 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_SoaRecord *soa;
  struct GNUNET_TUN_DnsSoaRecord soa_bin;
  size_t old_off;
 
  old_off = *off;
  soa = GNUNET_new (struct GNUNET_DNSPARSER_SoaRecord);
  soa->mname =
    GNUNET_DNSPARSER_parse_name (udp_payload, udp_payload_length, off);
  soa->rname =
    GNUNET_DNSPARSER_parse_name (udp_payload, udp_payload_length, off);
  if ((NULL == soa->mname) || (NULL == soa->rname) ||
      (*off + sizeof(struct GNUNET_TUN_DnsSoaRecord) > udp_payload_length))
  {
    GNUNET_break_op (0);
    GNUNET_DNSPARSER_free_soa (soa);
    *off = old_off;
    return NULL;
  }
  GNUNET_memcpy (&soa_bin,
                 &udp_payload[*off],
                 sizeof(struct GNUNET_TUN_DnsSoaRecord));
  soa->serial = ntohl (soa_bin.serial);
  soa->refresh = ntohl (soa_bin.refresh);
  soa->retry = ntohl (soa_bin.retry);
  soa->expire = ntohl (soa_bin.expire);
  soa->minimum_ttl = ntohl (soa_bin.minimum);
  (*off) += sizeof(struct GNUNET_TUN_DnsSoaRecord);
  return soa;
}

References GNUNET_DNSPARSER_SoaRecord::expire, GNUNET_TUN_DnsSoaRecord::expire, GNUNET_break_op, GNUNET_DNSPARSER_free_soa(), GNUNET_DNSPARSER_parse_name(), GNUNET_memcpy, GNUNET_new, GNUNET_TUN_DnsSoaRecord::minimum, GNUNET_DNSPARSER_SoaRecord::minimum_ttl, GNUNET_DNSPARSER_SoaRecord::mname, GNUNET_DNSPARSER_SoaRecord::refresh, GNUNET_TUN_DnsSoaRecord::refresh, GNUNET_DNSPARSER_SoaRecord::retry, GNUNET_TUN_DnsSoaRecord::retry, GNUNET_DNSPARSER_SoaRecord::rname, GNUNET_DNSPARSER_SoaRecord::serial, and GNUNET_TUN_DnsSoaRecord::serial.

Referenced by dns_value_to_string(), GNUNET_DNSPARSER_parse_record(), handle_gns_resolution_result(), and reply_to_dns().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_parse_cert()

struct GNUNET_DNSPARSER_CertRecord * GNUNET_DNSPARSER_parse_cert	(	const char *	udp_payload,
		size_t	udp_payload_length,
		size_t *	off
	)

Parse a DNS CERT record.

Parameters

udp_payload	reference to UDP packet
udp_payload_length	length of udp_payload
off	pointer to the offset of the query to parse in the CERT record (to be incremented by the size of the record), unchanged on error

Returns: the parsed CERT record, NULL on error

Definition at line 599 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_CertRecord *cert;
  struct GNUNET_TUN_DnsCertRecord dcert;
 
  if (*off + sizeof(struct GNUNET_TUN_DnsCertRecord) >= udp_payload_length)
  {
    GNUNET_break_op (0);
    return NULL;
  }
  GNUNET_memcpy (&dcert,
                 &udp_payload[*off],
                 sizeof(struct GNUNET_TUN_DnsCertRecord));
  (*off) += sizeof(struct GNUNET_TUN_DnsCertRecord);
  cert = GNUNET_new (struct GNUNET_DNSPARSER_CertRecord);
  cert->cert_type = ntohs (dcert.cert_type);
  cert->cert_tag = ntohs (dcert.cert_tag);
  cert->algorithm = dcert.algorithm;
  cert->certificate_size = udp_payload_length - (*off);
  cert->certificate_data = GNUNET_malloc (cert->certificate_size);
  GNUNET_memcpy (cert->certificate_data,
                 &udp_payload[*off],
                 cert->certificate_size);
  (*off) += cert->certificate_size;
  return cert;
}

References GNUNET_DNSPARSER_CertRecord::algorithm, GNUNET_TUN_DnsCertRecord::algorithm, GNUNET_DNSPARSER_CertRecord::cert_tag, GNUNET_TUN_DnsCertRecord::cert_tag, GNUNET_DNSPARSER_CertRecord::cert_type, GNUNET_TUN_DnsCertRecord::cert_type, GNUNET_DNSPARSER_CertRecord::certificate_data, GNUNET_DNSPARSER_CertRecord::certificate_size, GNUNET_break_op, GNUNET_malloc, GNUNET_memcpy, and GNUNET_new.

Referenced by dns_value_to_string(), and GNUNET_DNSPARSER_parse_record().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_parse_mx()

struct GNUNET_DNSPARSER_MxRecord * GNUNET_DNSPARSER_parse_mx	(	const char *	udp_payload,
		size_t	udp_payload_length,
		size_t *	off
	)

Parse a DNS MX record.

Parameters

udp_payload	reference to UDP packet
udp_payload_length	length of udp_payload
off	pointer to the offset of the query to parse in the MX record (to be incremented by the size of the record), unchanged on error

Returns: the parsed MX record, NULL on error

Definition at line 473 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_MxRecord *mx;
  uint16_t mxpref;
  size_t old_off;
 
  old_off = *off;
  if (*off + sizeof(uint16_t) > udp_payload_length)
  {
    GNUNET_break_op (0);
    return NULL;
  }
  GNUNET_memcpy (&mxpref, &udp_payload[*off], sizeof(uint16_t));
  (*off) += sizeof(uint16_t);
  mx = GNUNET_new (struct GNUNET_DNSPARSER_MxRecord);
  mx->preference = ntohs (mxpref);
  mx->mxhost =
    GNUNET_DNSPARSER_parse_name (udp_payload, udp_payload_length, off);
  if (NULL == mx->mxhost)
  {
    GNUNET_break_op (0);
    GNUNET_DNSPARSER_free_mx (mx);
    *off = old_off;
    return NULL;
  }
  return mx;
}

References GNUNET_break_op, GNUNET_DNSPARSER_free_mx(), GNUNET_DNSPARSER_parse_name(), GNUNET_memcpy, GNUNET_new, GNUNET_DNSPARSER_MxRecord::mxhost, and GNUNET_DNSPARSER_MxRecord::preference.

Referenced by dns_value_to_string(), GNUNET_DNSPARSER_parse_record(), handle_gns_resolution_result(), and reply_to_dns().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_parse_srv()

struct GNUNET_DNSPARSER_SrvRecord * GNUNET_DNSPARSER_parse_srv	(	const char *	udp_payload,
		size_t	udp_payload_length,
		size_t *	off
	)

Parse a DNS SRV record.

Parameters

udp_payload	reference to UDP packet
udp_payload_length	length of udp_payload
off	pointer to the offset of the query to parse in the SRV record (to be incremented by the size of the record), unchanged on error

Returns: the parsed SRV record, NULL on error

Definition at line 514 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_SrvRecord *srv;
  struct GNUNET_TUN_DnsSrvRecord srv_bin;
  size_t old_off;
 
  old_off = *off;
  if (*off + sizeof(struct GNUNET_TUN_DnsSrvRecord) > udp_payload_length)
    return NULL;
  GNUNET_memcpy (&srv_bin,
                 &udp_payload[*off],
                 sizeof(struct GNUNET_TUN_DnsSrvRecord));
  (*off) += sizeof(struct GNUNET_TUN_DnsSrvRecord);
  srv = GNUNET_new (struct GNUNET_DNSPARSER_SrvRecord);
  srv->priority = ntohs (srv_bin.prio);
  srv->weight = ntohs (srv_bin.weight);
  srv->port = ntohs (srv_bin.port);
  srv->target =
    GNUNET_DNSPARSER_parse_name (udp_payload, udp_payload_length, off);
  if (NULL == srv->target)
  {
    GNUNET_DNSPARSER_free_srv (srv);
    *off = old_off;
    return NULL;
  }
  return srv;
}

References GNUNET_DNSPARSER_free_srv(), GNUNET_DNSPARSER_parse_name(), GNUNET_memcpy, GNUNET_new, GNUNET_DNSPARSER_SrvRecord::port, GNUNET_TUN_DnsSrvRecord::port, GNUNET_TUN_DnsSrvRecord::prio, GNUNET_DNSPARSER_SrvRecord::priority, GNUNET_DNSPARSER_SrvRecord::target, GNUNET_DNSPARSER_SrvRecord::weight, and GNUNET_TUN_DnsSrvRecord::weight.

Referenced by dns_value_to_string(), GNUNET_DNSPARSER_parse_record(), and handle_gns_resolution_result().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_parse_uri()

struct GNUNET_DNSPARSER_UriRecord * GNUNET_DNSPARSER_parse_uri	(	const char *	udp_payload,
		size_t	udp_payload_length,
		size_t *	off
	)

Parse a DNS URI record.

Parameters

udp_payload	reference to UDP packet
udp_payload_length	length of udp_payload
off	pointer to the offset of the query to parse in the URI record (to be incremented by the size of the record), unchanged on error

Returns: the parsed URI record, NULL on error

Definition at line 555 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_UriRecord *uri;
  struct GNUNET_TUN_DnsUriRecord uri_bin;
  size_t old_off;
  int max_len;
  int len;
 
  old_off = *off;
  if (*off + sizeof(struct GNUNET_TUN_DnsUriRecord) > udp_payload_length)
    return NULL;
  GNUNET_memcpy (&uri_bin,
                 &udp_payload[*off],
                 sizeof(struct GNUNET_TUN_DnsUriRecord));
  (*off) += sizeof(struct GNUNET_TUN_DnsUriRecord);
  uri = GNUNET_new (struct GNUNET_DNSPARSER_UriRecord);
  uri->priority = ntohs (uri_bin.prio);
  uri->weight = ntohs (uri_bin.weight);
  max_len = udp_payload_length - *off - sizeof(struct GNUNET_TUN_DnsUriRecord);
  len =  GNUNET_asprintf (&(uri->target), "%.*s", max_len,
                          &udp_payload[*off]);
  (*off) += len;
  if (NULL == uri->target)
  {
    GNUNET_DNSPARSER_free_uri (uri);
    *off = old_off;
    return NULL;
  }
  return uri;
}

References GNUNET_asprintf(), GNUNET_DNSPARSER_free_uri(), GNUNET_memcpy, GNUNET_new, GNUNET_TUN_DnsUriRecord::prio, uri, and GNUNET_TUN_DnsUriRecord::weight.

Referenced by dns_value_to_string(), GNUNET_DNSPARSER_parse_record(), handle_gns_resolution_result(), and reply_to_dns().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_duplicate_record()

struct GNUNET_DNSPARSER_Record * GNUNET_DNSPARSER_duplicate_record ( const struct GNUNET_DNSPARSER_Record * r )

Duplicate (deep-copy) the given DNS record.

Parameters

r	the record

Returns: the newly allocated record

Definition at line 837 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_Record *dup = GNUNET_memdup (r, sizeof(*r));
 
  dup->name = GNUNET_strdup (r->name);
  switch (r->type)
  {
  case GNUNET_DNSPARSER_TYPE_NS:
  case GNUNET_DNSPARSER_TYPE_CNAME:
  case GNUNET_DNSPARSER_TYPE_DNAME:
  case GNUNET_DNSPARSER_TYPE_PTR: {
      dup->data.hostname = GNUNET_strdup (r->data.hostname);
      break;
    }
 
  case GNUNET_DNSPARSER_TYPE_SOA: {
      dup->data.soa = GNUNET_DNSPARSER_duplicate_soa_record (r->data.soa);
      break;
    }
 
  case GNUNET_DNSPARSER_TYPE_CERT: {
      dup->data.cert = GNUNET_DNSPARSER_duplicate_cert_record (r->data.cert);
      break;
    }
 
  case GNUNET_DNSPARSER_TYPE_MX: {
      dup->data.mx = GNUNET_DNSPARSER_duplicate_mx_record (r->data.mx);
      break;
    }
 
  case GNUNET_DNSPARSER_TYPE_SRV: {
      dup->data.srv = GNUNET_DNSPARSER_duplicate_srv_record (r->data.srv);
      break;
    }
 
  case GNUNET_DNSPARSER_TYPE_URI: {
      dup->data.uri = GNUNET_DNSPARSER_duplicate_uri_record (r->data.uri);
      break;
    }
 
  default: {
      dup->data.raw.data = GNUNET_memdup (r->data.raw.data,
                                          r->data.raw.data_len);
    }
  }
  return dup;
}

Referenced by cache_answers().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_duplicate_soa_record()

struct GNUNET_DNSPARSER_SoaRecord * GNUNET_DNSPARSER_duplicate_soa_record ( const struct GNUNET_DNSPARSER_SoaRecord * r )

Duplicate (deep-copy) the given DNS record.

Parameters

r	the record

Returns: the newly allocated record

Definition at line 893 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_SoaRecord *dup = GNUNET_memdup (r, sizeof(*r));
 
  dup->mname = GNUNET_strdup (r->mname);
  dup->rname = GNUNET_strdup (r->rname);
  return dup;
}

References GNUNET_memdup, GNUNET_strdup, GNUNET_DNSPARSER_SoaRecord::mname, and GNUNET_DNSPARSER_SoaRecord::rname.

Referenced by GNUNET_DNSPARSER_duplicate_record().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_duplicate_cert_record()

struct GNUNET_DNSPARSER_CertRecord * GNUNET_DNSPARSER_duplicate_cert_record ( const struct GNUNET_DNSPARSER_CertRecord * r )

Duplicate (deep-copy) the given DNS record.

Parameters

r	the record

Returns: the newly allocated record

Definition at line 911 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_CertRecord *dup = GNUNET_memdup (r, sizeof(*r));
 
  dup->certificate_data = GNUNET_memdup (r->certificate_data,
                                         r->certificate_size);
  return dup;
}

References GNUNET_DNSPARSER_CertRecord::certificate_data, GNUNET_DNSPARSER_CertRecord::certificate_size, and GNUNET_memdup.

Referenced by GNUNET_DNSPARSER_duplicate_record().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_duplicate_mx_record()

struct GNUNET_DNSPARSER_MxRecord * GNUNET_DNSPARSER_duplicate_mx_record ( const struct GNUNET_DNSPARSER_MxRecord * r )

Duplicate (deep-copy) the given DNS record.

Parameters

r	the record

Returns: the newly allocated record

Definition at line 929 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_MxRecord *dup = GNUNET_memdup (r, sizeof(*r));
 
  dup->mxhost = GNUNET_strdup (r->mxhost);
  return dup;
}

References GNUNET_memdup, GNUNET_strdup, and GNUNET_DNSPARSER_MxRecord::mxhost.

Referenced by GNUNET_DNSPARSER_duplicate_record().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_duplicate_srv_record()

struct GNUNET_DNSPARSER_SrvRecord * GNUNET_DNSPARSER_duplicate_srv_record ( const struct GNUNET_DNSPARSER_SrvRecord * r )

Duplicate (deep-copy) the given DNS record.

Parameters

r	the record

Returns: the newly allocated record

Definition at line 945 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_SrvRecord *dup = GNUNET_memdup (r, sizeof(*r));
 
  dup->target = GNUNET_strdup (r->target);
  return dup;
}

References GNUNET_memdup, GNUNET_strdup, and GNUNET_DNSPARSER_SrvRecord::target.

Referenced by GNUNET_DNSPARSER_duplicate_record().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_duplicate_uri_record()

struct GNUNET_DNSPARSER_UriRecord * GNUNET_DNSPARSER_duplicate_uri_record ( const struct GNUNET_DNSPARSER_UriRecord * r )

Duplicate (deep-copy) the given DNS record.

Parameters

r	the record

Returns: the newly allocated record

Definition at line 962 of file dnsparser.c.

{
  struct GNUNET_DNSPARSER_UriRecord *dup = GNUNET_memdup (r, sizeof(*r));
 
  dup->target = GNUNET_strdup (r->target);
  return dup;
}

References GNUNET_memdup, GNUNET_strdup, and GNUNET_DNSPARSER_UriRecord::target.

Referenced by GNUNET_DNSPARSER_duplicate_record().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_free_record()

void GNUNET_DNSPARSER_free_record ( struct GNUNET_DNSPARSER_Record * r )

Free the given DNS record.

Parameters

r	record to free

Definition at line 201 of file dnsparser.c.

{
  GNUNET_free (r->name);
  switch (r->type)
  {
  case GNUNET_DNSPARSER_TYPE_MX:
    GNUNET_DNSPARSER_free_mx (r->data.mx);
    break;
 
  case GNUNET_DNSPARSER_TYPE_SOA:
    GNUNET_DNSPARSER_free_soa (r->data.soa);
    break;
 
  case GNUNET_DNSPARSER_TYPE_SRV:
    GNUNET_DNSPARSER_free_srv (r->data.srv);
    break;
 
  case GNUNET_DNSPARSER_TYPE_URI:
    GNUNET_DNSPARSER_free_uri (r->data.uri);
    break;
 
  case GNUNET_DNSPARSER_TYPE_CERT:
    GNUNET_DNSPARSER_free_cert (r->data.cert);
    break;
 
  case GNUNET_DNSPARSER_TYPE_NS:
  case GNUNET_DNSPARSER_TYPE_CNAME:
  case GNUNET_DNSPARSER_TYPE_DNAME:
  case GNUNET_DNSPARSER_TYPE_PTR:
    GNUNET_free (r->data.hostname);
    break;
 
  default:
    GNUNET_free (r->data.raw.data);
    break;
  }
}

Referenced by free_cache_entry(), free_hosts_entry(), GNUNET_DNSPARSER_free_packet(), and remove_expired().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_free_mx()

void GNUNET_DNSPARSER_free_mx ( struct GNUNET_DNSPARSER_MxRecord * mx )

Free MX information record.

Parameters

mx	record to free

Definition at line 186 of file dnsparser.c.

{
  if (NULL == mx)
    return;
  GNUNET_free (mx->mxhost);
  GNUNET_free (mx);
}

References GNUNET_free, and GNUNET_DNSPARSER_MxRecord::mxhost.

Referenced by dns_value_to_string(), GNUNET_DNSPARSER_free_record(), GNUNET_DNSPARSER_parse_mx(), and handle_gns_resolution_result().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_free_srv()

void GNUNET_DNSPARSER_free_srv ( struct GNUNET_DNSPARSER_SrvRecord * srv )

Free SRV information record.

Parameters

srv	record to free

Definition at line 156 of file dnsparser.c.

{
  if (NULL == srv)
    return;
  GNUNET_free (srv->target);
  GNUNET_free (srv);
}

References GNUNET_free, and GNUNET_DNSPARSER_SrvRecord::target.

Referenced by dns_value_to_string(), GNUNET_DNSPARSER_free_record(), GNUNET_DNSPARSER_parse_srv(), and handle_gns_resolution_result().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_free_uri()

void GNUNET_DNSPARSER_free_uri ( struct GNUNET_DNSPARSER_UriRecord * uri )

Free URI information record.

Parameters

uri	record to free

Definition at line 171 of file dnsparser.c.

{
  if (NULL == uri)
    return;
  GNUNET_free (uri->target);
  GNUNET_free (uri);
}

References GNUNET_free, and uri.

Referenced by dns_value_to_string(), GNUNET_DNSPARSER_free_record(), GNUNET_DNSPARSER_parse_uri(), and handle_gns_resolution_result().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_free_soa()

void GNUNET_DNSPARSER_free_soa ( struct GNUNET_DNSPARSER_SoaRecord * soa )

Free SOA information record.

Parameters

soa	record to free

Definition at line 125 of file dnsparser.c.

{
  if (NULL == soa)
    return;
  GNUNET_free (soa->mname);
  GNUNET_free (soa->rname);
  GNUNET_free (soa);
}

References GNUNET_free, GNUNET_DNSPARSER_SoaRecord::mname, and GNUNET_DNSPARSER_SoaRecord::rname.

Referenced by dns_value_to_string(), GNUNET_DNSPARSER_free_record(), GNUNET_DNSPARSER_parse_soa(), and handle_gns_resolution_result().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_free_cert()

void GNUNET_DNSPARSER_free_cert ( struct GNUNET_DNSPARSER_CertRecord * cert )

Free CERT information record.

Parameters

cert	record to free

Definition at line 141 of file dnsparser.c.

{
  if (NULL == cert)
    return;
  GNUNET_free (cert->certificate_data);
  GNUNET_free (cert);
}

References GNUNET_DNSPARSER_CertRecord::certificate_data, and GNUNET_free.

Referenced by dns_value_to_string(), and GNUNET_DNSPARSER_free_record().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_bin_to_hex()

char * GNUNET_DNSPARSER_bin_to_hex	(	const void *	data,
		size_t	data_size
	)

Convert a block of binary data to HEX.

Parameters

data	binary data to convert
data_size	number of bytes in data

Returns: HEX string (lower case)

Definition at line 1525 of file dnsparser.c.

{
  char *ret;
  size_t off;
  const uint8_t *idata;
 
  idata = data;
  ret = GNUNET_malloc (data_size * 2 + 1);
  for (off = 0; off < data_size; off++)
    sprintf (&ret[off * 2], "%02x", idata[off]);
  return ret;
}

References data, data_size, GNUNET_malloc, and ret.

Referenced by dns_value_to_string().

Here is the caller graph for this function:

◆ GNUNET_DNSPARSER_hex_to_bin()

size_t GNUNET_DNSPARSER_hex_to_bin	(	const char *	hex,
		void *	data
	)

Convert a HEX string to block of binary data.

Parameters

hex	HEX string to convert (may contain mixed case)
data	where to write result, must be at least `strlen(hex)/2` bytes long

Returns: number of bytes written to data

Definition at line 1548 of file dnsparser.c.

{
  size_t data_size;
  size_t off;
  uint8_t *idata;
  unsigned int h;
  char in[3];
 
  data_size = strlen (hex) / 2;
  idata = data;
  in[2] = '\0';
  for (off = 0; off < data_size; off++)
  {
    in[0] = tolower ((unsigned char) hex[off * 2]);
    in[1] = tolower ((unsigned char) hex[off * 2 + 1]);
    if (1 != sscanf (in, "%x", &h))
      return off;
    idata[off] = (uint8_t) h;
  }
  return off;
}

References data, data_size, and h.

Referenced by dns_string_to_value().

Here is the caller graph for this function:

Data Structures

Macros

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ GNUNET_DNSPARSER_MAX_LABEL_LENGTH

◆ GNUNET_DNSPARSER_MAX_NAME_LENGTH

◆ GNUNET_DNSPARSER_TYPE_ANY

◆ GNUNET_DNSPARSER_TYPE_A

◆ GNUNET_DNSPARSER_TYPE_NS

◆ GNUNET_DNSPARSER_TYPE_CNAME

◆ GNUNET_DNSPARSER_TYPE_SOA

◆ GNUNET_DNSPARSER_TYPE_PTR

◆ GNUNET_DNSPARSER_TYPE_MX

◆ GNUNET_DNSPARSER_TYPE_TXT

◆ GNUNET_DNSPARSER_TYPE_RP

◆ GNUNET_DNSPARSER_TYPE_AFSDB

◆ GNUNET_DNSPARSER_TYPE_SIG

◆ GNUNET_DNSPARSER_TYPE_KEY

◆ GNUNET_DNSPARSER_TYPE_AAAA

◆ GNUNET_DNSPARSER_TYPE_LOC

◆ GNUNET_DNSPARSER_TYPE_SRV

◆ GNUNET_DNSPARSER_TYPE_NAPTR

◆ GNUNET_DNSPARSER_TYPE_KX

◆ GNUNET_DNSPARSER_TYPE_CERT

◆ GNUNET_DNSPARSER_TYPE_DNAME

◆ GNUNET_DNSPARSER_TYPE_APL

◆ GNUNET_DNSPARSER_TYPE_DS

◆ GNUNET_DNSPARSER_TYPE_SSHFP

◆ GNUNET_DNSPARSER_TYPE_IPSECKEY

◆ GNUNET_DNSPARSER_TYPE_RRSIG

◆ GNUNET_DNSPARSER_TYPE_NSEC

◆ GNUNET_DNSPARSER_TYPE_DNSKEY

◆ GNUNET_DNSPARSER_TYPE_DHCID

◆ GNUNET_DNSPARSER_TYPE_NSEC3

◆ GNUNET_DNSPARSER_TYPE_NSEC3PARAM

◆ GNUNET_DNSPARSER_TYPE_TLSA

◆ GNUNET_DNSPARSER_TYPE_SMIMEA

◆ GNUNET_DNSPARSER_TYPE_HIP

◆ GNUNET_DNSPARSER_TYPE_CDS

◆ GNUNET_DNSPARSER_TYPE_CDNSKEY

◆ GNUNET_DNSPARSER_TYPE_OPENPGPKEY

◆ GNUNET_DNSPARSER_TYPE_TKEY

◆ GNUNET_DNSPARSER_TYPE_TSIG

◆ GNUNET_DNSPARSER_TYPE_ALL

◆ GNUNET_DNSPARSER_TYPE_URI

◆ GNUNET_DNSPARSER_TYPE_CAA

◆ GNUNET_DNSPARSER_TYPE_TA

Enumeration Type Documentation

◆ GNUNET_DNSPARSER_CertType

◆ GNUNET_DNSPARSER_CertAlgorithm

Function Documentation

◆ GNUNET_DNSPARSER_check_label()

◆ GNUNET_DNSPARSER_check_name()

◆ GNUNET_DNSPARSER_parse()

◆ GNUNET_DNSPARSER_free_packet()

◆ GNUNET_DNSPARSER_pack()

◆ GNUNET_DNSPARSER_builder_add_name()

◆ GNUNET_DNSPARSER_builder_add_query()

◆ GNUNET_DNSPARSER_builder_add_mx()

◆ GNUNET_DNSPARSER_builder_add_soa()

◆ GNUNET_DNSPARSER_builder_add_cert()

◆ GNUNET_DNSPARSER_builder_add_srv()

◆ GNUNET_DNSPARSER_builder_add_uri()

◆ GNUNET_DNSPARSER_parse_record()

◆ GNUNET_DNSPARSER_parse_name()

◆ GNUNET_DNSPARSER_parse_query()

◆ GNUNET_DNSPARSER_parse_soa()

◆ GNUNET_DNSPARSER_parse_cert()

◆ GNUNET_DNSPARSER_parse_mx()

◆ GNUNET_DNSPARSER_parse_srv()

◆ GNUNET_DNSPARSER_parse_uri()

◆ GNUNET_DNSPARSER_duplicate_record()

◆ GNUNET_DNSPARSER_duplicate_soa_record()

◆ GNUNET_DNSPARSER_duplicate_cert_record()

◆ GNUNET_DNSPARSER_duplicate_mx_record()

◆ GNUNET_DNSPARSER_duplicate_srv_record()

◆ GNUNET_DNSPARSER_duplicate_uri_record()

◆ GNUNET_DNSPARSER_free_record()