Contains functions that translate dns data from the wire format (as sent by servers and clients) to the internal structures. More...

Macros
#define	LDNS_HEADER_SIZE 12

#define	LDNS_RD_MASK 0x01U

#define	LDNS_RD_SHIFT 0

#define	LDNS_RD_WIRE(wirebuf) (*(wirebuf+2) & LDNS_RD_MASK)

#define	LDNS_RD_SET(wirebuf) (*(wirebuf+2) \|= LDNS_RD_MASK)

#define	LDNS_RD_CLR(wirebuf) (*(wirebuf+2) &= ~LDNS_RD_MASK)

#define	LDNS_TC_MASK 0x02U

#define	LDNS_TC_SHIFT 1

#define	LDNS_TC_WIRE(wirebuf) (*(wirebuf+2) & LDNS_TC_MASK)

#define	LDNS_TC_SET(wirebuf) (*(wirebuf+2) \|= LDNS_TC_MASK)

#define	LDNS_TC_CLR(wirebuf) (*(wirebuf+2) &= ~LDNS_TC_MASK)

#define	LDNS_AA_MASK 0x04U

#define	LDNS_AA_SHIFT 2

#define	LDNS_AA_WIRE(wirebuf) (*(wirebuf+2) & LDNS_AA_MASK)

#define	LDNS_AA_SET(wirebuf) (*(wirebuf+2) \|= LDNS_AA_MASK)

#define	LDNS_AA_CLR(wirebuf) (*(wirebuf+2) &= ~LDNS_AA_MASK)

#define	LDNS_OPCODE_MASK 0x78U

#define	LDNS_OPCODE_SHIFT 3

#define	LDNS_OPCODE_WIRE(wirebuf) ((*(wirebuf+2) & LDNS_OPCODE_MASK) >> LDNS_OPCODE_SHIFT)

#define	LDNS_OPCODE_SET(wirebuf, opcode) ((wirebuf+2) = (((wirebuf+2)) & ~LDNS_OPCODE_MASK) \| ((opcode) << LDNS_OPCODE_SHIFT))

#define	LDNS_QR_MASK 0x80U

#define	LDNS_QR_SHIFT 7

#define	LDNS_QR_WIRE(wirebuf) (*(wirebuf+2) & LDNS_QR_MASK)

#define	LDNS_QR_SET(wirebuf) (*(wirebuf+2) \|= LDNS_QR_MASK)

#define	LDNS_QR_CLR(wirebuf) (*(wirebuf+2) &= ~LDNS_QR_MASK)

#define	LDNS_RCODE_MASK 0x0fU

#define	LDNS_RCODE_SHIFT 0

#define	LDNS_RCODE_WIRE(wirebuf) (*(wirebuf+3) & LDNS_RCODE_MASK)

#define	LDNS_RCODE_SET(wirebuf, rcode) ((wirebuf+3) = (((wirebuf+3)) & ~LDNS_RCODE_MASK) \| (rcode))

#define	LDNS_CD_MASK 0x10U

#define	LDNS_CD_SHIFT 4

#define	LDNS_CD_WIRE(wirebuf) (*(wirebuf+3) & LDNS_CD_MASK)

#define	LDNS_CD_SET(wirebuf) (*(wirebuf+3) \|= LDNS_CD_MASK)

#define	LDNS_CD_CLR(wirebuf) (*(wirebuf+3) &= ~LDNS_CD_MASK)

#define	LDNS_AD_MASK 0x20U

#define	LDNS_AD_SHIFT 5

#define	LDNS_AD_WIRE(wirebuf) (*(wirebuf+3) & LDNS_AD_MASK)

#define	LDNS_AD_SET(wirebuf) (*(wirebuf+3) \|= LDNS_AD_MASK)

#define	LDNS_AD_CLR(wirebuf) (*(wirebuf+3) &= ~LDNS_AD_MASK)

#define	LDNS_Z_MASK 0x40U

#define	LDNS_Z_SHIFT 6

#define	LDNS_Z_WIRE(wirebuf) (*(wirebuf+3) & LDNS_Z_MASK)

#define	LDNS_Z_SET(wirebuf) (*(wirebuf+3) \|= LDNS_Z_MASK)

#define	LDNS_Z_CLR(wirebuf) (*(wirebuf+3) &= ~LDNS_Z_MASK)

#define	LDNS_RA_MASK 0x80U

#define	LDNS_RA_SHIFT 7

#define	LDNS_RA_WIRE(wirebuf) (*(wirebuf+3) & LDNS_RA_MASK)

#define	LDNS_RA_SET(wirebuf) (*(wirebuf+3) \|= LDNS_RA_MASK)

#define	LDNS_RA_CLR(wirebuf) (*(wirebuf+3) &= ~LDNS_RA_MASK)

#define	LDNS_ID_WIRE(wirebuf) (ldns_read_uint16(wirebuf))

#define	LDNS_ID_SET(wirebuf, id) (ldns_write_uint16(wirebuf, id))

#define	LDNS_QDCOUNT_OFF 4

#define	LDNS_QDCOUNT(wirebuf) (ldns_read_uint16(wirebuf+LDNS_QDCOUNT_OFF))

#define	LDNS_ANCOUNT_OFF 6

#define	LDNS_ANCOUNT(wirebuf) (ldns_read_uint16(wirebuf+LDNS_ANCOUNT_OFF))

#define	LDNS_NSCOUNT_OFF 8

#define	LDNS_NSCOUNT(wirebuf) (ldns_read_uint16(wirebuf+LDNS_NSCOUNT_OFF))

#define	LDNS_ARCOUNT_OFF 10

#define	LDNS_ARCOUNT(wirebuf) (ldns_read_uint16(wirebuf+LDNS_ARCOUNT_OFF))

Functions
ldns_status	ldns_wire2pkt (ldns_pkt *packet, const uint8_t data, size_t len)
	converts the data on the uint8_t bytearray (in wire format) to a DNS packet. More...

ldns_status	ldns_buffer2pkt_wire (ldns_pkt *packet, const ldns_buffer buffer)
	converts the data in the ldns_buffer (in wire format) to a DNS packet. More...

ldns_status	ldns_wire2dname (ldns_rdf *dname, const uint8_t wire, size_t max, size_t *pos)
	converts the data on the uint8_t bytearray (in wire format) to a DNS dname rdata field. More...

ldns_status	ldns_wire2rdf (ldns_rr rr, const uint8_t wire, size_t max, size_t *pos)
	converts the data on the uint8_t bytearray (in wire format) to DNS rdata fields, and adds them to the list of rdfs of the given rr. More...

ldns_status	ldns_wire2rr (ldns_rr *rr, const uint8_t wire, size_t max, size_t *pos, ldns_pkt_section section)
	converts the data on the uint8_t bytearray (in wire format) to a DNS resource record. More...

Detailed Description

Contains functions that translate dns data from the wire format (as sent by servers and clients) to the internal structures.

Definition in file wire2host.h.

Macro Definition Documentation

◆ LDNS_HEADER_SIZE

#define LDNS_HEADER_SIZE 12

Definition at line 32 of file wire2host.h.

◆ LDNS_RD_MASK

#define LDNS_RD_MASK 0x01U

Definition at line 35 of file wire2host.h.

◆ LDNS_RD_SHIFT

#define LDNS_RD_SHIFT 0

Definition at line 36 of file wire2host.h.

◆ LDNS_RD_WIRE

#define LDNS_RD_WIRE ( wirebuf ) (*(wirebuf+2) & LDNS_RD_MASK)

Definition at line 37 of file wire2host.h.

◆ LDNS_RD_SET

#define LDNS_RD_SET ( wirebuf ) (*(wirebuf+2) |= LDNS_RD_MASK)

Definition at line 38 of file wire2host.h.

◆ LDNS_RD_CLR

#define LDNS_RD_CLR ( wirebuf ) (*(wirebuf+2) &= ~LDNS_RD_MASK)

Definition at line 39 of file wire2host.h.

◆ LDNS_TC_MASK

#define LDNS_TC_MASK 0x02U

Definition at line 41 of file wire2host.h.

◆ LDNS_TC_SHIFT

#define LDNS_TC_SHIFT 1

Definition at line 42 of file wire2host.h.

◆ LDNS_TC_WIRE

#define LDNS_TC_WIRE ( wirebuf ) (*(wirebuf+2) & LDNS_TC_MASK)

Definition at line 43 of file wire2host.h.

◆ LDNS_TC_SET

#define LDNS_TC_SET ( wirebuf ) (*(wirebuf+2) |= LDNS_TC_MASK)

Definition at line 44 of file wire2host.h.

◆ LDNS_TC_CLR

#define LDNS_TC_CLR ( wirebuf ) (*(wirebuf+2) &= ~LDNS_TC_MASK)

Definition at line 45 of file wire2host.h.

◆ LDNS_AA_MASK

#define LDNS_AA_MASK 0x04U

Definition at line 47 of file wire2host.h.

◆ LDNS_AA_SHIFT

#define LDNS_AA_SHIFT 2

Definition at line 48 of file wire2host.h.

◆ LDNS_AA_WIRE

#define LDNS_AA_WIRE ( wirebuf ) (*(wirebuf+2) & LDNS_AA_MASK)

Definition at line 49 of file wire2host.h.

◆ LDNS_AA_SET

#define LDNS_AA_SET ( wirebuf ) (*(wirebuf+2) |= LDNS_AA_MASK)

Definition at line 50 of file wire2host.h.

◆ LDNS_AA_CLR

#define LDNS_AA_CLR ( wirebuf ) (*(wirebuf+2) &= ~LDNS_AA_MASK)

Definition at line 51 of file wire2host.h.

◆ LDNS_OPCODE_MASK

#define LDNS_OPCODE_MASK 0x78U

Definition at line 53 of file wire2host.h.

◆ LDNS_OPCODE_SHIFT

#define LDNS_OPCODE_SHIFT 3

Definition at line 54 of file wire2host.h.

◆ LDNS_OPCODE_WIRE

#define LDNS_OPCODE_WIRE ( wirebuf ) ((*(wirebuf+2) & LDNS_OPCODE_MASK) >> LDNS_OPCODE_SHIFT)

Definition at line 55 of file wire2host.h.

◆ LDNS_OPCODE_SET

#define LDNS_OPCODE_SET	(	wirebuf,
		opcode
	)	((wirebuf+2) = (((wirebuf+2)) & ~LDNS_OPCODE_MASK) \| ((opcode) << LDNS_OPCODE_SHIFT))

Definition at line 56 of file wire2host.h.

◆ LDNS_QR_MASK

#define LDNS_QR_MASK 0x80U

Definition at line 59 of file wire2host.h.

◆ LDNS_QR_SHIFT

#define LDNS_QR_SHIFT 7

Definition at line 60 of file wire2host.h.

◆ LDNS_QR_WIRE

#define LDNS_QR_WIRE ( wirebuf ) (*(wirebuf+2) & LDNS_QR_MASK)

Definition at line 61 of file wire2host.h.

◆ LDNS_QR_SET

#define LDNS_QR_SET ( wirebuf ) (*(wirebuf+2) |= LDNS_QR_MASK)

Definition at line 62 of file wire2host.h.

◆ LDNS_QR_CLR

#define LDNS_QR_CLR ( wirebuf ) (*(wirebuf+2) &= ~LDNS_QR_MASK)

Definition at line 63 of file wire2host.h.

◆ LDNS_RCODE_MASK

#define LDNS_RCODE_MASK 0x0fU

Definition at line 66 of file wire2host.h.

◆ LDNS_RCODE_SHIFT

#define LDNS_RCODE_SHIFT 0

Definition at line 67 of file wire2host.h.

◆ LDNS_RCODE_WIRE

#define LDNS_RCODE_WIRE ( wirebuf ) (*(wirebuf+3) & LDNS_RCODE_MASK)

Definition at line 68 of file wire2host.h.

◆ LDNS_RCODE_SET

#define LDNS_RCODE_SET	(	wirebuf,
		rcode
	)	((wirebuf+3) = (((wirebuf+3)) & ~LDNS_RCODE_MASK) \| (rcode))

Definition at line 69 of file wire2host.h.

◆ LDNS_CD_MASK

#define LDNS_CD_MASK 0x10U

Definition at line 72 of file wire2host.h.

◆ LDNS_CD_SHIFT

#define LDNS_CD_SHIFT 4

Definition at line 73 of file wire2host.h.

◆ LDNS_CD_WIRE

#define LDNS_CD_WIRE ( wirebuf ) (*(wirebuf+3) & LDNS_CD_MASK)

Definition at line 74 of file wire2host.h.

◆ LDNS_CD_SET

#define LDNS_CD_SET ( wirebuf ) (*(wirebuf+3) |= LDNS_CD_MASK)

Definition at line 75 of file wire2host.h.

◆ LDNS_CD_CLR

#define LDNS_CD_CLR ( wirebuf ) (*(wirebuf+3) &= ~LDNS_CD_MASK)

Definition at line 76 of file wire2host.h.

◆ LDNS_AD_MASK

#define LDNS_AD_MASK 0x20U

Definition at line 78 of file wire2host.h.

◆ LDNS_AD_SHIFT

#define LDNS_AD_SHIFT 5

Definition at line 79 of file wire2host.h.

◆ LDNS_AD_WIRE

#define LDNS_AD_WIRE ( wirebuf ) (*(wirebuf+3) & LDNS_AD_MASK)

Definition at line 80 of file wire2host.h.

◆ LDNS_AD_SET

#define LDNS_AD_SET ( wirebuf ) (*(wirebuf+3) |= LDNS_AD_MASK)

Definition at line 81 of file wire2host.h.

◆ LDNS_AD_CLR

#define LDNS_AD_CLR ( wirebuf ) (*(wirebuf+3) &= ~LDNS_AD_MASK)

Definition at line 82 of file wire2host.h.

◆ LDNS_Z_MASK

#define LDNS_Z_MASK 0x40U

Definition at line 84 of file wire2host.h.

◆ LDNS_Z_SHIFT

#define LDNS_Z_SHIFT 6

Definition at line 85 of file wire2host.h.

◆ LDNS_Z_WIRE

#define LDNS_Z_WIRE ( wirebuf ) (*(wirebuf+3) & LDNS_Z_MASK)

Definition at line 86 of file wire2host.h.

◆ LDNS_Z_SET

#define LDNS_Z_SET ( wirebuf ) (*(wirebuf+3) |= LDNS_Z_MASK)

Definition at line 87 of file wire2host.h.

◆ LDNS_Z_CLR

#define LDNS_Z_CLR ( wirebuf ) (*(wirebuf+3) &= ~LDNS_Z_MASK)

Definition at line 88 of file wire2host.h.

◆ LDNS_RA_MASK

#define LDNS_RA_MASK 0x80U

Definition at line 90 of file wire2host.h.

◆ LDNS_RA_SHIFT

#define LDNS_RA_SHIFT 7

Definition at line 91 of file wire2host.h.

◆ LDNS_RA_WIRE

#define LDNS_RA_WIRE ( wirebuf ) (*(wirebuf+3) & LDNS_RA_MASK)

Definition at line 92 of file wire2host.h.

◆ LDNS_RA_SET

#define LDNS_RA_SET ( wirebuf ) (*(wirebuf+3) |= LDNS_RA_MASK)

Definition at line 93 of file wire2host.h.

◆ LDNS_RA_CLR

#define LDNS_RA_CLR ( wirebuf ) (*(wirebuf+3) &= ~LDNS_RA_MASK)

Definition at line 94 of file wire2host.h.

◆ LDNS_ID_WIRE

#define LDNS_ID_WIRE ( wirebuf ) (ldns_read_uint16(wirebuf))

Definition at line 97 of file wire2host.h.

◆ LDNS_ID_SET

#define LDNS_ID_SET	(	wirebuf,
		id
	)	(ldns_write_uint16(wirebuf, id))

Definition at line 98 of file wire2host.h.

◆ LDNS_QDCOUNT_OFF

#define LDNS_QDCOUNT_OFF 4

Definition at line 101 of file wire2host.h.

◆ LDNS_QDCOUNT

#define LDNS_QDCOUNT ( wirebuf ) (ldns_read_uint16(wirebuf+LDNS_QDCOUNT_OFF))

Definition at line 102 of file wire2host.h.

◆ LDNS_ANCOUNT_OFF

#define LDNS_ANCOUNT_OFF 6

Definition at line 105 of file wire2host.h.

◆ LDNS_ANCOUNT

#define LDNS_ANCOUNT ( wirebuf ) (ldns_read_uint16(wirebuf+LDNS_ANCOUNT_OFF))

Definition at line 106 of file wire2host.h.

◆ LDNS_NSCOUNT_OFF

#define LDNS_NSCOUNT_OFF 8

Definition at line 109 of file wire2host.h.

◆ LDNS_NSCOUNT

#define LDNS_NSCOUNT ( wirebuf ) (ldns_read_uint16(wirebuf+LDNS_NSCOUNT_OFF))

Definition at line 110 of file wire2host.h.

◆ LDNS_ARCOUNT_OFF

#define LDNS_ARCOUNT_OFF 10

Definition at line 113 of file wire2host.h.

◆ LDNS_ARCOUNT

#define LDNS_ARCOUNT ( wirebuf ) (ldns_read_uint16(wirebuf+LDNS_ARCOUNT_OFF))

Definition at line 114 of file wire2host.h.

Function Documentation

◆ ldns_wire2pkt()

ldns_status ldns_wire2pkt	(	ldns_pkt **	packet,
		const uint8_t *	data,
		size_t	len
	)

converts the data on the uint8_t bytearray (in wire format) to a DNS packet.

This function will initialize and allocate memory space for the packet structure.

Parameters

[out]	packet	pointer to the structure to hold the packet
[in]	data	pointer to the buffer with the data
[in]	len	the length of the data buffer (in bytes)

Returns: LDNS_STATUS_OK if everything succeeds, error otherwise

Definition at line 403 of file wire2host.c.

References ldns_pkt_new(), LDNS_STATUS_MEM_ERR, and LDNS_STATUS_OK.

◆ ldns_buffer2pkt_wire()

ldns_status ldns_buffer2pkt_wire	(	ldns_pkt **	packet,
		const ldns_buffer *	buffer
	)

converts the data in the ldns_buffer (in wire format) to a DNS packet.

This function will initialize and allocate memory space for the packet structure.

Parameters

[out]	packet	pointer to the structure to hold the packet
[in]	buffer	the buffer with the data

Returns: LDNS_STATUS_OK if everything succeeds, error otherwise

Definition at line 394 of file wire2host.c.

References ldns_wire2pkt().

◆ ldns_wire2dname()

ldns_status ldns_wire2dname	(	ldns_rdf **	dname,
		const uint8_t *	wire,
		size_t	max,
		size_t *	pos
	)

converts the data on the uint8_t bytearray (in wire format) to a DNS dname rdata field.

This function will initialize and allocate memory space for the dname structure. The length of the wiredata of this rdf is added to the *pos value.

Parameters

[out]	dname	pointer to the structure to hold the rdata value
[in]	wire	pointer to the buffer with the data
[in]	max	the length of the data buffer (in bytes)
[in]	pos	the position of the rdf in the buffer (ie. the number of bytes from the start of the buffer)

Returns: LDNS_STATUS_OK if everything succeeds, error otherwise

Definition at line 56 of file wire2host.c.

References LDNS_MAX_DOMAINLEN, LDNS_STATUS_PACKET_OVERFLOW, and LDNS_STATUS_WIRE_RDATA_ERR.

◆ ldns_wire2rdf()

ldns_status ldns_wire2rdf	(	ldns_rr *	rr,
		const uint8_t *	wire,
		size_t	max,
		size_t *	pos
	)

converts the data on the uint8_t bytearray (in wire format) to DNS rdata fields, and adds them to the list of rdfs of the given rr.

This function will initialize and allocate memory space for the dname structures. The length of the wiredata of these rdfs is added to the *pos value.

All rdfs belonging to the RR are read; the rr should have no rdfs yet. An error is returned if the format cannot be parsed.

Parameters

[in]	rr	pointer to the ldns_rr structure to hold the rdata value
[in]	wire	pointer to the buffer with the data
[in]	max	the length of the data buffer (in bytes)
[in]	pos	the position of the rdf in the buffer (ie. the number of bytes from the start of the buffer)

Returns: LDNS_STATUS_OK if everything succeeds, error otherwise

Definition at line 156 of file wire2host.c.

References ldns_rr_descript(), ldns_rr_get_type(), and LDNS_STATUS_PACKET_OVERFLOW.

◆ ldns_wire2rr()

ldns_status ldns_wire2rr	(	ldns_rr **	rr,
		const uint8_t *	wire,
		size_t	max,
		size_t *	pos,
		ldns_pkt_section	section
	)

converts the data on the uint8_t bytearray (in wire format) to a DNS resource record.

This function will initialize and allocate memory space for the rr structure. The length of the wiredata of this rr is added to the *pos value.

Parameters

[out]	rr	pointer to the structure to hold the rdata value
[in]	wire	pointer to the buffer with the data
[in]	max	the length of the data buffer (in bytes)
[in]	pos	the position of the rr in the buffer (ie. the number of bytes from the start of the buffer)
[in]	section	the section in the packet the rr is meant for

Returns: LDNS_STATUS_OK if everything succeeds, error otherwise

Definition at line 318 of file wire2host.c.

References ldns_rr_new(), ldns_rr_set_owner(), ldns_rr_set_type(), LDNS_STATUS_CHECK_GOTO, LDNS_STATUS_PACKET_OVERFLOW, and ldns_wire2dname().

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ LDNS_HEADER_SIZE

◆ LDNS_RD_MASK

◆ LDNS_RD_SHIFT

◆ LDNS_RD_WIRE

◆ LDNS_RD_SET

◆ LDNS_RD_CLR

◆ LDNS_TC_MASK

◆ LDNS_TC_SHIFT

◆ LDNS_TC_WIRE

◆ LDNS_TC_SET

◆ LDNS_TC_CLR

◆ LDNS_AA_MASK

◆ LDNS_AA_SHIFT

◆ LDNS_AA_WIRE

◆ LDNS_AA_SET

◆ LDNS_AA_CLR

◆ LDNS_OPCODE_MASK

◆ LDNS_OPCODE_SHIFT

◆ LDNS_OPCODE_WIRE

◆ LDNS_OPCODE_SET

◆ LDNS_QR_MASK

◆ LDNS_QR_SHIFT

◆ LDNS_QR_WIRE

◆ LDNS_QR_SET

◆ LDNS_QR_CLR

◆ LDNS_RCODE_MASK

◆ LDNS_RCODE_SHIFT

◆ LDNS_RCODE_WIRE

◆ LDNS_RCODE_SET

◆ LDNS_CD_MASK

◆ LDNS_CD_SHIFT

◆ LDNS_CD_WIRE

◆ LDNS_CD_SET

◆ LDNS_CD_CLR

◆ LDNS_AD_MASK

◆ LDNS_AD_SHIFT

◆ LDNS_AD_WIRE

◆ LDNS_AD_SET

◆ LDNS_AD_CLR

◆ LDNS_Z_MASK

◆ LDNS_Z_SHIFT

◆ LDNS_Z_WIRE

◆ LDNS_Z_SET

◆ LDNS_Z_CLR

◆ LDNS_RA_MASK

◆ LDNS_RA_SHIFT

◆ LDNS_RA_WIRE

◆ LDNS_RA_SET

◆ LDNS_RA_CLR

◆ LDNS_ID_WIRE

◆ LDNS_ID_SET

◆ LDNS_QDCOUNT_OFF

◆ LDNS_QDCOUNT

◆ LDNS_ANCOUNT_OFF

◆ LDNS_ANCOUNT

◆ LDNS_NSCOUNT_OFF

◆ LDNS_NSCOUNT

◆ LDNS_ARCOUNT_OFF

◆ LDNS_ARCOUNT

Function Documentation

◆ ldns_wire2pkt()

◆ ldns_buffer2pkt_wire()

◆ ldns_wire2dname()

◆ ldns_wire2rdf()

◆ ldns_wire2rr()