packet.h
Go to the documentation of this file.
1 /*
2  * packet.h
3  *
4  * DNS packet definitions
5  *
6  * a Net::DNS like library for C
7  *
8  * (c) NLnet Labs, 2005-2006
9  *
10  * See the file LICENSE for the license
11  */
12 
21 #ifndef LDNS_PACKET_H
22 #define LDNS_PACKET_H
23 
24 #define LDNS_MAX_PACKETLEN 65535
25 
26 /* allow flags to be given to mk_query */
27 #define LDNS_QR 1 /* QueRy - query flag */
28 #define LDNS_AA 2 /* Authoritative Answer - server flag */
29 #define LDNS_TC 4 /* TrunCated - server flag */
30 #define LDNS_RD 8 /* Recursion Desired - query flag */
31 #define LDNS_CD 16 /* Checking Disabled - query flag */
32 #define LDNS_RA 32 /* Recursion Available - server flag */
33 #define LDNS_AD 64 /* Authenticated Data - server flag */
34 
35 #include <ldns/error.h>
36 #include <ldns/common.h>
37 #include <ldns/rr.h>
38 #include <sys/time.h>
39 
40 #ifdef __cplusplus
41 extern "C" {
42 #endif
43 
44 /* opcodes for pkt's */
48  LDNS_PACKET_STATUS = 2, /* there is no 3?? DNS is weird */
51 };
53 
54 /* rcodes for pkts */
67 };
69 
193 {
195  uint16_t _id;
197  bool _qr;
199  bool _aa;
201  bool _tc;
203  bool _rd;
205  bool _cd;
207  bool _ra;
209  bool _ad;
211  ldns_pkt_opcode _opcode; /* XXX 8 bits? */
213  uint8_t _rcode;
215  uint16_t _qdcount;
217  uint16_t _ancount;
219  uint16_t _nscount;
221  uint16_t _arcount;
222 };
223 typedef struct ldns_struct_hdr ldns_hdr;
224 
234 {
237  /* extra items needed in a packet */
241  struct timeval timestamp;
243  uint32_t _querytime;
245  size_t _size;
249  uint16_t _edns_udp_size;
253  uint8_t _edns_version;
255  uint16_t _edns_z;
266 };
267 typedef struct ldns_struct_pkt ldns_pkt;
268 
281 };
283 
294 };
296 
297 /* prototypes */
298 
299 /* read */
300 
306 uint16_t ldns_pkt_id(const ldns_pkt *p);
312 bool ldns_pkt_qr(const ldns_pkt *p);
318 bool ldns_pkt_aa(const ldns_pkt *p);
324 bool ldns_pkt_tc(const ldns_pkt *p);
330 bool ldns_pkt_rd(const ldns_pkt *p);
336 bool ldns_pkt_cd(const ldns_pkt *p);
342 bool ldns_pkt_ra(const ldns_pkt *p);
348 bool ldns_pkt_ad(const ldns_pkt *p);
354 ldns_pkt_opcode ldns_pkt_get_opcode(const ldns_pkt *p);
360 ldns_pkt_rcode ldns_pkt_get_rcode(const ldns_pkt *p);
366 uint16_t ldns_pkt_qdcount(const ldns_pkt *p);
372 uint16_t ldns_pkt_ancount(const ldns_pkt *p);
378 uint16_t ldns_pkt_nscount(const ldns_pkt *p);
384 uint16_t ldns_pkt_arcount(const ldns_pkt *p);
385 
392 
398 struct timeval ldns_pkt_timestamp(const ldns_pkt *p);
404 uint32_t ldns_pkt_querytime(const ldns_pkt *p);
405 
411 size_t ldns_pkt_size(const ldns_pkt *p);
412 
419 
458 
466 ldns_rr_list *ldns_pkt_get_section_clone(const ldns_pkt *p, ldns_pkt_section s);
467 
476 ldns_rr_list *ldns_pkt_rr_list_by_name(ldns_pkt *p, ldns_rdf *r, ldns_pkt_section s);
485 ldns_rr_list *ldns_pkt_rr_list_by_type(const ldns_pkt *p, ldns_rr_type t, ldns_pkt_section s);
495 ldns_rr_list *ldns_pkt_rr_list_by_name_and_type(const ldns_pkt *packet, const ldns_rdf *ownername, ldns_rr_type type, ldns_pkt_section sec);
496 
497 
504 bool ldns_pkt_rr(ldns_pkt *pkt, ldns_pkt_section sec, ldns_rr *rr);
505 
506 
513 bool ldns_pkt_set_flags(ldns_pkt *pkt, uint16_t flags);
514 
520 void ldns_pkt_set_id(ldns_pkt *p, uint16_t id);
531 void ldns_pkt_set_qr(ldns_pkt *p, bool b);
537 void ldns_pkt_set_aa(ldns_pkt *p, bool b);
543 void ldns_pkt_set_tc(ldns_pkt *p, bool b);
549 void ldns_pkt_set_rd(ldns_pkt *p, bool b);
555 void ldns_pkt_set_cd(ldns_pkt *p, bool b);
561 void ldns_pkt_set_ra(ldns_pkt *p, bool b);
567 void ldns_pkt_set_ad(ldns_pkt *p, bool b);
568 
574 void ldns_pkt_set_opcode(ldns_pkt *p, ldns_pkt_opcode c);
580 void ldns_pkt_set_rcode(ldns_pkt *p, uint8_t c);
586 void ldns_pkt_set_qdcount(ldns_pkt *p, uint16_t c);
592 void ldns_pkt_set_ancount(ldns_pkt *p, uint16_t c);
598 void ldns_pkt_set_nscount(ldns_pkt *p, uint16_t c);
604 void ldns_pkt_set_arcount(ldns_pkt *p, uint16_t c);
616 void ldns_pkt_set_querytime(ldns_pkt *p, uint32_t t);
622 void ldns_pkt_set_size(ldns_pkt *p, size_t s);
623 
629 void ldns_pkt_set_timestamp(ldns_pkt *p, struct timeval timeval);
636 void ldns_pkt_set_section_count(ldns_pkt *p, ldns_pkt_section s, uint16_t x);
643 
650 ldns_pkt_type ldns_pkt_reply_type(ldns_pkt *p);
651 
657 uint16_t ldns_pkt_edns_udp_size(const ldns_pkt *packet);
663 uint8_t ldns_pkt_edns_extended_rcode(const ldns_pkt *packet);
669 uint8_t ldns_pkt_edns_version(const ldns_pkt *packet);
675 uint16_t ldns_pkt_edns_z(const ldns_pkt *packet);
681 ldns_rdf *ldns_pkt_edns_data(const ldns_pkt *packet);
682 
688 bool ldns_pkt_edns_do(const ldns_pkt *packet);
694 void ldns_pkt_set_edns_do(ldns_pkt *packet, bool value);
695 
705 bool ldns_pkt_edns(const ldns_pkt *packet);
706 
712 void ldns_pkt_set_edns_udp_size(ldns_pkt *packet, uint16_t s);
718 void ldns_pkt_set_edns_extended_rcode(ldns_pkt *packet, uint8_t c);
724 void ldns_pkt_set_edns_version(ldns_pkt *packet, uint8_t v);
730 void ldns_pkt_set_edns_z(ldns_pkt *packet, uint16_t z);
736 void ldns_pkt_set_edns_data(ldns_pkt *packet, ldns_rdf *data);
737 
743 
749 void ldns_pkt_free(ldns_pkt *packet);
750 
760 ldns_status ldns_pkt_query_new_frm_str(ldns_pkt **p, const char *rr_name, ldns_rr_type rr_type, ldns_rr_class rr_class , uint16_t flags);
761 
770 ldns_pkt *ldns_pkt_query_new(ldns_rdf *rr_name, ldns_rr_type rr_type, ldns_rr_class rr_class, uint16_t flags);
771 
779 
786 
793 
800 
807 
815 bool ldns_pkt_push_rr(ldns_pkt *packet, ldns_pkt_section section, ldns_rr *rr);
816 
824 bool ldns_pkt_safe_push_rr(ldns_pkt *pkt, ldns_pkt_section sec, ldns_rr *rr);
825 
833 bool ldns_pkt_push_rr_list(ldns_pkt *packet, ldns_pkt_section section, ldns_rr_list *list);
834 
842 bool ldns_pkt_safe_push_rr_list(ldns_pkt *pkt, ldns_pkt_section sec, ldns_rr_list *list);
843 
849 bool ldns_pkt_empty(ldns_pkt *p);
850 
851 #ifdef __cplusplus
852 }
853 #endif
854 
855 #endif /* LDNS_PACKET_H */
void ldns_pkt_set_ancount(ldns_pkt *packet, uint16_t ancount)
Set the packet&#39;s an count.
Definition: packet.c:548
void ldns_pkt_set_authority(ldns_pkt *p, ldns_rr_list *rr)
directly set the auhority section
Definition: packet.c:506
enum ldns_enum_pkt_type ldns_pkt_type
Definition: packet.h:295
signed char _qr
Query bit (0=query, 1=answer)
Definition: packet.h:197
uint16_t _nscount
auth sec
Definition: packet.h:219
uint16_t ldns_pkt_arcount(const ldns_pkt *packet)
Return the packet&#39;s ar count.
Definition: packet.c:117
ldns_rdf * _edns_data
Arbitrary EDNS rdata.
Definition: packet.h:257
ldns_rdf * _answerfrom
The size of the wire format of the packet in octets.
Definition: packet.h:239
void ldns_pkt_set_ad(ldns_pkt *packet, bool ad)
Definition: packet.c:524
ldns_rr_list * ldns_pkt_rr_list_by_name_and_type(const ldns_pkt *packet, const ldns_rdf *ownername, ldns_rr_type type, ldns_pkt_section sec)
return all the rr with a specific type and type from a packet.
Definition: packet.c:320
bool ldns_pkt_push_rr(ldns_pkt *packet, ldns_pkt_section section, ldns_rr *rr)
push an rr on a packet
Definition: packet.c:648
void ldns_pkt_set_tc(ldns_pkt *packet, bool tc)
Definition: packet.c:476
ldns_rr_list * ldns_pkt_question(const ldns_pkt *packet)
Return the packet&#39;s question section.
Definition: packet.c:123
ldns_status ldns_pkt_query_new_frm_str(ldns_pkt **p, const char *name, ldns_rr_type rr_type, ldns_rr_class rr_class, uint16_t flags)
creates a query packet for the given name, type, class.
Definition: packet.c:910
enum ldns_enum_rr_class ldns_rr_class
Definition: rr.h:64
void ldns_pkt_set_qdcount(ldns_pkt *packet, uint16_t qdcount)
Set the packet&#39;s qd count.
Definition: packet.c:542
List or Set of Resource Records.
Definition: rr.h:306
bool ldns_pkt_tc(const ldns_pkt *packet)
Read the packet&#39;s tc bit.
Definition: packet.c:57
ldns_pkt_rcode ldns_pkt_get_rcode(const ldns_pkt *packet)
Return the packet&#39;s respons code.
Definition: packet.c:93
ldns_rr_list * _authority
Authority section.
Definition: packet.h:263
struct timeval timestamp
Timestamp of the time the packet was sent or created.
Definition: packet.h:241
uint16_t ldns_pkt_qdcount(const ldns_pkt *packet)
Return the packet&#39;s qd count.
Definition: packet.c:99
uint8_t ldns_pkt_edns_extended_rcode(const ldns_pkt *packet)
return the packet&#39;s edns extended rcode
Definition: packet.c:212
uint16_t ldns_pkt_id(const ldns_pkt *packet)
Read the packet id.
Definition: packet.c:39
ldns_pkt_opcode _opcode
Query type.
Definition: packet.h:211
bool ldns_pkt_edns(const ldns_pkt *pkt)
returns true if this packet needs and EDNS rr to be sent.
Definition: packet.c:720
void ldns_pkt_set_ra(ldns_pkt *packet, bool ra)
Definition: packet.c:518
signed char _ra
Recursion available.
Definition: packet.h:207
ldns_pkt_opcode ldns_pkt_get_opcode(const ldns_pkt *packet)
Read the packet&#39;s code.
Definition: packet.c:87
bool ldns_pkt_aa(const ldns_pkt *packet)
Read the packet&#39;s aa bit.
Definition: packet.c:51
signed char _aa
Authoritative answer.
Definition: packet.h:199
ldns_hdr * _header
Header section.
Definition: packet.h:236
uint32_t ldns_pkt_querytime(const ldns_pkt *packet)
Return the packet&#39;s querytime.
Definition: packet.c:188
ldns_enum_pkt_rcode
Definition: packet.h:55
void ldns_pkt_set_qr(ldns_pkt *packet, bool qr)
Definition: packet.c:464
Contains the definition of ldns_rr and functions to manipulate those.
ldns_pkt * ldns_pkt_new()
allocates and initializes a ldns_pkt structure.
Definition: packet.c:732
void ldns_pkt_set_edns_udp_size(ldns_pkt *packet, uint16_t s)
Set the packet&#39;s edns udp size.
Definition: packet.c:591
ldns_pkt * ldns_pkt_query_new(ldns_rdf *rr_name, ldns_rr_type rr_type, ldns_rr_class rr_class, uint16_t flags)
creates a packet with a query in it for the given name, type and class.
Definition: packet.c:971
ldns_rr_list * ldns_pkt_rr_list_by_type(const ldns_pkt *packet, ldns_rr_type type, ldns_pkt_section sec)
return all the rr with a specific type from a packet.
Definition: packet.c:284
void ldns_pkt_set_tsig(ldns_pkt *pkt, ldns_rr *rr)
Set the packet&#39;s tsig rr.
Definition: packet.c:642
void ldns_pkt_set_rcode(ldns_pkt *packet, uint8_t rcode)
Set the packet&#39;s respons code.
Definition: packet.c:536
Resource Record.
Definition: rr.h:278
void ldns_pkt_set_size(ldns_pkt *packet, size_t s)
Set the packet&#39;s size.
Definition: packet.c:585
void ldns_pkt_set_arcount(ldns_pkt *packet, uint16_t arcount)
Set the packet&#39;s arcount.
Definition: packet.c:560
bool ldns_pkt_safe_push_rr(ldns_pkt *pkt, ldns_pkt_section sec, ldns_rr *rr)
push an rr on a packet, provided the RR is not there.
Definition: packet.c:684
size_t _size
The size of the wire format of the packet in octets.
Definition: packet.h:245
bool ldns_pkt_safe_push_rr_list(ldns_pkt *p, ldns_pkt_section s, ldns_rr_list *list)
push an rr_list to a packet, provided the RRs are not already there.
Definition: packet.c:708
Defines error numbers and functions to translate those to a readable string.
uint16_t ldns_pkt_nscount(const ldns_pkt *packet)
Return the packet&#39;s ns count.
Definition: packet.c:111
signed char _cd
Checking disabled.
Definition: packet.h:205
uint8_t _edns_extended_rcode
EDNS0 Extended rcode.
Definition: packet.h:251
ldns_rr_list * _answer
Answer section.
Definition: packet.h:261
enum ldns_enum_pkt_opcode ldns_pkt_opcode
Definition: packet.h:52
void ldns_pkt_set_edns_z(ldns_pkt *packet, uint16_t z)
Set the packet&#39;s edns z value.
Definition: packet.c:609
bogus section, if not interested
Definition: packet.h:278
uint16_t ldns_pkt_ancount(const ldns_pkt *packet)
Return the packet&#39;s an count.
Definition: packet.c:105
void ldns_pkt_set_edns_version(ldns_pkt *packet, uint8_t v)
Set the packet&#39;s edns version.
Definition: packet.c:603
bool ldns_pkt_cd(const ldns_pkt *packet)
Read the packet&#39;s cd bit.
Definition: packet.c:69
bool ldns_pkt_ra(const ldns_pkt *packet)
Read the packet&#39;s ra bit.
Definition: packet.c:75
uint32_t _querytime
The duration of the query this packet is an answer to.
Definition: packet.h:243
uint16_t _edns_z
Reserved EDNS data bits.
Definition: packet.h:255
bool ldns_pkt_empty(ldns_pkt *p)
check if a packet is empty
Definition: packet.c:409
void ldns_pkt_set_nscount(ldns_pkt *packet, uint16_t nscount)
Set the packet&#39;s ns count.
Definition: packet.c:554
ldns_rr_list * _additional
Additional section.
Definition: packet.h:265
void ldns_pkt_set_edns_data(ldns_pkt *packet, ldns_rdf *data)
Set the packet&#39;s edns data.
Definition: packet.c:615
uint16_t _arcount
add sec
Definition: packet.h:221
uint16_t _ancount
answer sec
Definition: packet.h:217
struct timeval ldns_pkt_timestamp(const ldns_pkt *packet)
Return the packet&#39;s timestamp.
Definition: packet.c:200
uint16_t _edns_udp_size
EDNS0 available buffer size, see RFC2671.
Definition: packet.h:249
ldns_rdf * ldns_pkt_answerfrom(const ldns_pkt *packet)
Return the packet&#39;s answerfrom.
Definition: packet.c:194
enum ldns_enum_pkt_rcode ldns_pkt_rcode
Definition: packet.h:68
void ldns_pkt_set_id(ldns_pkt *packet, uint16_t id)
Set the packet&#39;s id.
Definition: packet.c:450
ldns_rr_list * ldns_pkt_all(const ldns_pkt *packet)
Return the packet&#39;s question, answer, authority and additional sections concatenated, in a new rr_list clone.
Definition: packet.c:148
signed char _tc
Packet truncated.
Definition: packet.h:201
bool ldns_pkt_rd(const ldns_pkt *packet)
Read the packet&#39;s rd bit.
Definition: packet.c:63
uint8_t ldns_pkt_edns_version(const ldns_pkt *packet)
return the packet&#39;s edns version
Definition: packet.c:218
ldns_rr_list * _question
Question section.
Definition: packet.h:259
void ldns_pkt_set_answerfrom(ldns_pkt *packet, ldns_rdf *answerfrom)
Set the packet&#39;s answering server.
Definition: packet.c:572
void ldns_pkt_set_opcode(ldns_pkt *packet, ldns_pkt_opcode opcode)
Set the packet&#39;s opcode.
Definition: packet.c:530
DNS packet.
Definition: packet.h:233
void ldns_pkt_set_additional(ldns_pkt *p, ldns_rr_list *rr)
directly set the additional section
Definition: packet.c:488
signed char _rd
Recursion desired.
Definition: packet.h:203
void ldns_pkt_set_edns_do(ldns_pkt *packet, bool value)
Definition: packet.c:236
signed char _ad
Authentic data.
Definition: packet.h:209
void ldns_pkt_set_edns_extended_rcode(ldns_pkt *packet, uint8_t c)
Set the packet&#39;s edns extended rcode.
Definition: packet.c:597
uint8_t _rcode
Response code.
Definition: packet.h:213
ldns_rr_list * ldns_pkt_rr_list_by_name(ldns_pkt *packet, ldns_rdf *ownername, ldns_pkt_section sec)
return all the rr with a specific name from a packet.
Definition: packet.c:253
void ldns_pkt_set_rd(ldns_pkt *packet, bool rd)
Definition: packet.c:482
ldns_pkt_type ldns_pkt_reply_type(ldns_pkt *p)
looks inside the packet to determine what kind of packet it is, AUTH, NXDOMAIN, REFERRAL, etc.
Definition: packet.c:1018
enum ldns_enum_status ldns_status
Definition: error.h:122
void ldns_pkt_set_answer(ldns_pkt *p, ldns_rr_list *rr)
directly set the answer section
Definition: packet.c:500
void ldns_pkt_set_cd(ldns_pkt *packet, bool cd)
Definition: packet.c:512
bool ldns_pkt_set_flags(ldns_pkt *packet, uint16_t flags)
sets the flags in a packet.
Definition: packet.c:800
void ldns_pkt_set_querytime(ldns_pkt *packet, uint32_t time)
Set the packet&#39;s query time.
Definition: packet.c:566
ldns_pkt * ldns_pkt_clone(ldns_pkt *pkt)
clones the given packet, creating a fully allocated copy
Definition: packet.c:1064
uint16_t ldns_pkt_edns_udp_size(const ldns_pkt *packet)
return the packet&#39;s edns udp size
Definition: packet.c:206
ldns_rdf * ldns_pkt_edns_data(const ldns_pkt *packet)
return the packet&#39;s edns data
Definition: packet.c:246
uint16_t _qdcount
question sec
Definition: packet.h:215
bool ldns_pkt_qr(const ldns_pkt *packet)
Read the packet&#39;s qr bit.
Definition: packet.c:45
Resource record data field.
Definition: rdata.h:138
ldns_rr * ldns_pkt_tsig(const ldns_pkt *pkt)
Return the packet&#39;s tsig pseudo rr&#39;s.
Definition: packet.c:444
Common definitions for LDNS.
ldns_rr_list * ldns_pkt_get_section_clone(const ldns_pkt *packet, ldns_pkt_section s)
return all the rr_list&#39;s in the packet.
Definition: packet.c:423
void ldns_pkt_set_question(ldns_pkt *p, ldns_rr_list *rr)
directly set the question section
Definition: packet.c:494
void ldns_pkt_set_section_count(ldns_pkt *packet, ldns_pkt_section s, uint16_t count)
Set a packet&#39;s section count to x.
Definition: packet.c:621
enum ldns_enum_rr_type ldns_rr_type
Definition: rr.h:215
bool ldns_pkt_ad(const ldns_pkt *packet)
Read the packet&#39;s ad bit.
Definition: packet.c:81
ldns_rr_list * ldns_pkt_authority(const ldns_pkt *packet)
Return the packet&#39;s authority section.
Definition: packet.c:135
size_t ldns_pkt_size(const ldns_pkt *packet)
Return the packet&#39;s size in bytes.
Definition: packet.c:182
bool ldns_pkt_rr(ldns_pkt *pkt, ldns_pkt_section sec, ldns_rr *rr)
check to see if an rr exist in the packet
Definition: packet.c:357
Header of a dns packet.
Definition: packet.h:192
ldns_enum_pkt_opcode
Definition: packet.h:45
void ldns_pkt_set_random_id(ldns_pkt *packet)
Set the packet&#39;s id to a random value.
Definition: packet.c:456
void ldns_pkt_set_aa(ldns_pkt *packet, bool aa)
Definition: packet.c:470
uint16_t _id
Id of a packet.
Definition: packet.h:195
enum ldns_enum_pkt_section ldns_pkt_section
Definition: packet.h:282
used to get all non-question rrs from a packet
Definition: packet.h:280
uint8_t _edns_version
EDNS Version.
Definition: packet.h:253
ldns_rr_list * ldns_pkt_all_noquestion(const ldns_pkt *packet)
Return the packet&#39;s answer, authority and additional sections concatenated, in a new rr_list clone...
Definition: packet.c:167
ldns_rr_list * ldns_pkt_additional(const ldns_pkt *packet)
Return the packet&#39;s additional section.
Definition: packet.c:141
ldns_rr_list * ldns_pkt_answer(const ldns_pkt *packet)
Return the packet&#39;s answer section.
Definition: packet.c:129
uint16_t ldns_pkt_edns_z(const ldns_pkt *packet)
return the packet&#39;s edns z value
Definition: packet.c:224
void ldns_pkt_free(ldns_pkt *packet)
frees the packet structure and all data that it contains.
Definition: packet.c:784
ldns_rr * _tsig_rr
Optional tsig rr.
Definition: packet.h:247
dsa p
Definition: keys.c:683
ldns_enum_pkt_type
The different types of packets.
Definition: packet.h:287
bool ldns_pkt_edns_do(const ldns_pkt *packet)
return the packet&#39;s edns do bit
Definition: packet.c:230
bool ldns_pkt_push_rr_list(ldns_pkt *p, ldns_pkt_section s, ldns_rr_list *list)
push a rr_list on a packet
Definition: packet.c:696
void ldns_pkt_set_timestamp(ldns_pkt *packet, struct timeval timeval)
Set the packet&#39;s timestamp.
Definition: packet.c:578
ldns_enum_pkt_section
The sections of a packet.
Definition: packet.h:272