sdns
low-level DNS library
Loading...
Searching...
No Matches
sdns_api.h
Go to the documentation of this file.
1
3#include <sdns.h>
4
5// mostly high-level functions to do basic stuff, each to check and easy to code wrappers!
6
7#ifndef SDNS_API_H
8#define SDNS_API_H
9
10
25sdns_context * sdns_from_network(char * buff, uint16_t buff_len);
26
27
38char * sdns_to_network(sdns_context * dns, int * err, uint16_t * buff_len);
39
40
55int sdns_add_rr_answer_A(sdns_context * dns, char * name, uint32_t ttl, char * ip);
56
62int sdns_add_rr_additional_A(sdns_context * dns, char * name, uint32_t ttl, char * ip);
63
64
70int sdns_add_rr_authority_A(sdns_context * dns, char * name, uint32_t ttl, char * ip);
71
72
84int sdns_add_rr_answer_NS(sdns_context * dns, char * name, uint32_t ttl, char * nsname);
85
86
92int sdns_add_rr_additional_NS(sdns_context * dns, char * name, uint32_t ttl, char * nsname);
93
94
100int sdns_add_rr_authority_NS(sdns_context * dns, char * name, uint32_t ttl, char * nsname);
101
102
116int sdns_add_rr_answer_TXT(sdns_context * dns, char * name, uint32_t ttl, char * text, uint16_t text_len);
117
118
124int sdns_add_rr_authority_TXT(sdns_context * dns, char * name, uint32_t ttl, char * text, uint16_t text_len);
125
131int sdns_add_rr_additional_TXT(sdns_context * dns, char * name, uint32_t ttl, char * text, uint16_t text_len);
132
133
145sdns_context * sdns_create_query(char * name, char * type, char * cls);
146
163int sdns_add_rr_answer_SOA(sdns_context * dns, char * name, uint32_t ttl, char * mname, char * rname,
164 uint32_t expire, uint32_t minimum, uint32_t refresh, uint32_t retry, uint32_t serial);
165
166
167
173int sdns_add_rr_authority_SOA(sdns_context * dns, char * name, uint32_t ttl, char * mname, char * rname,
174 uint32_t expire, uint32_t minimum, uint32_t refresh, uint32_t retry, uint32_t serial);
175
181int sdns_add_rr_additional_SOA(sdns_context * dns, char * name, uint32_t ttl, char * mname, char * rname,
182 uint32_t expire, uint32_t minimum, uint32_t refresh, uint32_t retry, uint32_t serial);
183
195int sdns_add_rr_answer_CNAME(sdns_context * dns, char * name, uint32_t ttl, char * cname);
196
197
203int sdns_add_rr_authority_CNAME(sdns_context * dns, char * name, uint32_t ttl, char * cname);
204
205
209int sdns_add_rr_additional_CNAME(sdns_context * dns, char * name, uint32_t ttl, char * cname);
210
211
224int sdns_add_rr_answer_MX(sdns_context * dns, char * name, uint32_t ttl, uint16_t preference, char * exchange);
225
226
232int sdns_add_rr_additional_MX(sdns_context * dns, char * name, uint32_t ttl, uint16_t preference, char * exchange);
233
234
240int sdns_add_rr_authority_MX(sdns_context * dns, char * name, uint32_t ttl, uint16_t preference, char * exchange);
241
242
254int sdns_add_rr_answer_PTR(sdns_context * dns, char * name, uint32_t ttl, char * ptrdname);
255
256
262int sdns_add_rr_authority_PTR(sdns_context * dns, char * name, uint32_t ttl, char * ptrdname);
263
269int sdns_add_rr_additional_PTR(sdns_context * dns, char * name, uint32_t ttl, char * ptrdname);
270
271
286int sdns_add_rr_answer_SRV(sdns_context * dns, char * name, uint32_t ttl,
287 uint16_t priority, uint16_t weight, uint16_t port, char * target);
288
294int sdns_add_rr_authority_SRV(sdns_context * dns, char * name, uint32_t ttl,
295 uint16_t priority, uint16_t weight, uint16_t port, char * target);
296
302int sdns_add_rr_additional_SRV(sdns_context * dns, char * name, uint32_t ttl,
303 uint16_t priority, uint16_t weight, uint16_t port, char * target);
304
305
306
324int sdns_add_rr_answer_HINFO(sdns_context * dns, char * name, uint32_t ttl,
325 char * os, uint8_t os_len, char * cpu, uint8_t cpu_len);
326
327
333int sdns_add_rr_authority_HINFO(sdns_context * dns, char * name, uint32_t ttl,
334 char * os, uint8_t os_len, char * cpu, uint8_t cpu_len);
335
336
342int sdns_add_rr_additional_HINFO(sdns_context * dns, char * name, uint32_t ttl,
343 char * os, uint8_t os_len, char * cpu, uint8_t cpu_len);
344
345
346
369int sdns_add_cookie(sdns_context * dns, char * client_cookie, char * server_cookie);
370
393int sdns_add_nsid(sdns_context * dns, char * nsid);
394
409int sdns_add_ede(sdns_context * dns, uint16_t ede_code, char * ede_text);
410
411
423int sdns_set_do(sdns_context * dns, uint8_t do_bit);
424
425
436int sdns_set_rcode(sdns_context * dns, uint8_t rcode);
437
438
439
447int sdns_set_qr(sdns_context * dns, uint8_t qr_bit);
448
456int sdns_set_tc(sdns_context * dns, uint8_t tc_bit);
457
458
466int sdns_set_id(sdns_context * dns, uint16_t dns_id);
467
468
476int sdns_set_rd(sdns_context * dns, uint8_t rd_bit);
477
478
486int sdns_set_ra(sdns_context * dns, uint8_t ra_bit);
487
488
489
497int sdns_set_aa(sdns_context * dns, uint8_t aa_bit);
498
499
507int sdns_set_cd(sdns_context * dns, uint8_t cd_bit);
508
509
510
511
529char * sdns_get_value_nsid(sdns_context * dns, int * err, uint16_t *nsid_len);
530
531
548char * sdns_get_value_cookie_client(sdns_context * dns, int * err);
549
550
559int sdns_remove_edns(sdns_context * dns);
560
576sdns_rr * sdns_get_answer(sdns_context * dns, int * err, uint16_t num);
577
583sdns_rr * sdns_get_authority(sdns_context * dns, int * err, uint16_t num);
584
585
594sdns_rr * sdns_get_additional(sdns_context * dns, int * err, uint16_t num);
595
596
613int sdns_add_rr_answer_AAAA(sdns_context * dns, char * name, uint32_t ttl, const char * ipv6);
614
615
616
622int sdns_add_rr_authority_AAAA(sdns_context * dns, char * name, uint32_t ttl, const char * ipv6);
623
624
630int sdns_add_rr_additional_AAAA(sdns_context * dns, char * name, uint32_t ttl, const char * ipv6);
631
632
633
648int sdns_add_rr_answer_NID(sdns_context * dns, char * name, uint32_t ttl, uint16_t preference, char * nodeid);
649
650
656int sdns_add_rr_authority_NID(sdns_context * dns, char * name, uint32_t ttl, uint16_t preference, char * nodeid);
657
658
664int sdns_add_rr_additional_NID(sdns_context * dns, char * name, uint32_t ttl, uint16_t preference, char * nodeid);
665
666
682int sdns_add_rr_answer_CAA(sdns_context * dns, char * name, uint32_t ttl, uint8_t flag, char * tag, char * value);
683
689int sdns_add_rr_authority_CAA(sdns_context * dns, char * name, uint32_t ttl, uint8_t flag, char * tag, char * value);
690
696int sdns_add_rr_additional_CAA(sdns_context * dns, char * name, uint32_t ttl, uint8_t flag, char * tag, char * value);
697
706sdns_question * sdns_get_question(sdns_context * dns);
707
723sdns_context * sdns_create_response_from_query(sdns_context * query);
724
725
726
727
728#endif
sdns_add_cookie
int sdns_add_cookie(sdns_context *dns, char *client_cookie, char *server_cookie)
Adds cookie to DNS packet.
sdns_add_rr_additional_CNAME
int sdns_add_rr_additional_CNAME(sdns_context *dns, char *name, uint32_t ttl, char *cname)
sdns_add_rr_authority_MX
int sdns_add_rr_authority_MX(sdns_context *dns, char *name, uint32_t ttl, uint16_t preference, char *exchange)
Adds MX record to the authority section of the DNS.
sdns_add_rr_answer_MX
int sdns_add_rr_answer_MX(sdns_context *dns, char *name, uint32_t ttl, uint16_t preference, char *exchange)
Adds a MX record to the answer section of the DNS context.
sdns_add_rr_answer_HINFO
int sdns_add_rr_answer_HINFO(sdns_context *dns, char *name, uint32_t ttl, char *os, uint8_t os_len, char *cpu, uint8_t cpu_len)
Adds a HINFO record to the answer section of the DNS context.
sdns_get_authority
sdns_rr * sdns_get_authority(sdns_context *dns, int *err, uint16_t num)
Returns the authority section of the DNS context.
sdns_add_rr_additional_PTR
int sdns_add_rr_additional_PTR(sdns_context *dns, char *name, uint32_t ttl, char *ptrdname)
Adds PTR record to the additional section of the DNS.
sdns_add_rr_additional_CAA
int sdns_add_rr_additional_CAA(sdns_context *dns, char *name, uint32_t ttl, uint8_t flag, char *tag, char *value)
Adds CAA record to the asnwer section of the DNS context.
sdns_add_rr_answer_TXT
int sdns_add_rr_answer_TXT(sdns_context *dns, char *name, uint32_t ttl, char *text, uint16_t text_len)
Adds a new TXT record to the DNS packet in answer section.
sdns_to_network
char * sdns_to_network(sdns_context *dns, int *err, uint16_t *buff_len)
Converts the dns packet to the binary form ready to be sent by the socket.
sdns_add_rr_additional_SRV
int sdns_add_rr_additional_SRV(sdns_context *dns, char *name, uint32_t ttl, uint16_t priority, uint16_t weight, uint16_t port, char *target)
Add a SRV record to the additional section of the DNS packet.
sdns_create_query
sdns_context * sdns_create_query(char *name, char *type, char *cls)
Creates a dns context with the given query and ends0 enabled.
sdns_set_cd
int sdns_set_cd(sdns_context *dns, uint8_t cd_bit)
Sets or resets the check disabled bit of the DNS header.
sdns_add_rr_answer_CNAME
int sdns_add_rr_answer_CNAME(sdns_context *dns, char *name, uint32_t ttl, char *cname)
Adds a CNAME record to the answer section of the DNS context.
sdns_add_rr_additional_AAAA
int sdns_add_rr_additional_AAAA(sdns_context *dns, char *name, uint32_t ttl, const char *ipv6)
Adds AAAA record to the additional section of the DNS.
sdns_set_tc
int sdns_set_tc(sdns_context *dns, uint8_t tc_bit)
Sets or resets the truncation bit of the DNS header.
sdns_add_rr_authority_A
int sdns_add_rr_authority_A(sdns_context *dns, char *name, uint32_t ttl, char *ip)
Adds A record to the authority section of the DNS packet.
sdns_add_rr_authority_AAAA
int sdns_add_rr_authority_AAAA(sdns_context *dns, char *name, uint32_t ttl, const char *ipv6)
Adds AAAA record to the authority section of the DNS.
sdns_set_rd
int sdns_set_rd(sdns_context *dns, uint8_t rd_bit)
Sets or resets the recursion desired bit of the DNS header.
sdns_set_aa
int sdns_set_aa(sdns_context *dns, uint8_t aa_bit)
Sets or resets the athoritative answer bit of the DNS header.
sdns_add_rr_additional_TXT
int sdns_add_rr_additional_TXT(sdns_context *dns, char *name, uint32_t ttl, char *text, uint16_t text_len)
Adds TXT record to the additional section of the DNS.
sdns_set_qr
int sdns_set_qr(sdns_context *dns, uint8_t qr_bit)
Sets or resets the query-response bit of the DNS header.
sdns_add_rr_authority_NS
int sdns_add_rr_authority_NS(sdns_context *dns, char *name, uint32_t ttl, char *nsname)
Adds NS record to the authority section of the DNS packet.
sdns_get_question
sdns_question * sdns_get_question(sdns_context *dns)
Returns a copy of the question section of the DNS context.
sdns_get_value_nsid
char * sdns_get_value_nsid(sdns_context *dns, int *err, uint16_t *nsid_len)
Get NSID value from the DNS context.
sdns_add_rr_answer_AAAA
int sdns_add_rr_answer_AAAA(sdns_context *dns, char *name, uint32_t ttl, const char *ipv6)
Adds AAAA record to the asnwer section of the DNS context.
sdns_add_rr_additional_A
int sdns_add_rr_additional_A(sdns_context *dns, char *name, uint32_t ttl, char *ip)
Adds A record to the additional section of the DNS packet.
sdns_get_value_cookie_client
char * sdns_get_value_cookie_client(sdns_context *dns, int *err)
Returns the client cookie of the packet (if there is any)
sdns_add_ede
int sdns_add_ede(sdns_context *dns, uint16_t ede_code, char *ede_text)
Add extended DNS error to the packet.
sdns_add_rr_additional_SOA
int sdns_add_rr_additional_SOA(sdns_context *dns, char *name, uint32_t ttl, char *mname, char *rname, uint32_t expire, uint32_t minimum, uint32_t refresh, uint32_t retry, uint32_t serial)
Adds SOA record to the additional section of the DNS record.
sdns_add_rr_additional_NS
int sdns_add_rr_additional_NS(sdns_context *dns, char *name, uint32_t ttl, char *nsname)
Adds NS record to the additional section of the DNS.
sdns_add_rr_answer_SRV
int sdns_add_rr_answer_SRV(sdns_context *dns, char *name, uint32_t ttl, uint16_t priority, uint16_t weight, uint16_t port, char *target)
Adds a SRV record to the answer section of the DNS context.
sdns_remove_edns
int sdns_remove_edns(sdns_context *dns)
Revemos EDNS0 option from a DNS context.
sdns_add_rr_additional_NID
int sdns_add_rr_additional_NID(sdns_context *dns, char *name, uint32_t ttl, uint16_t preference, char *nodeid)
Adds NID record to the asnwer section of the DNS context.
sdns_add_rr_authority_CAA
int sdns_add_rr_authority_CAA(sdns_context *dns, char *name, uint32_t ttl, uint8_t flag, char *tag, char *value)
Adds CAA record to the asnwer section of the DNS context.
sdns_set_rcode
int sdns_set_rcode(sdns_context *dns, uint8_t rcode)
Sets the rcode of the DNS context.
sdns_add_rr_answer_SOA
int sdns_add_rr_answer_SOA(sdns_context *dns, char *name, uint32_t ttl, char *mname, char *rname, uint32_t expire, uint32_t minimum, uint32_t refresh, uint32_t retry, uint32_t serial)
Adds a new SOA record to the DNS packet in answer section.
sdns_add_rr_authority_SOA
int sdns_add_rr_authority_SOA(sdns_context *dns, char *name, uint32_t ttl, char *mname, char *rname, uint32_t expire, uint32_t minimum, uint32_t refresh, uint32_t retry, uint32_t serial)
Adds SOA record to the authority section of the DNS.
sdns_add_rr_authority_PTR
int sdns_add_rr_authority_PTR(sdns_context *dns, char *name, uint32_t ttl, char *ptrdname)
Adds PTR record to the authority section of the DNS.
sdns_add_nsid
int sdns_add_nsid(sdns_context *dns, char *nsid)
Adds NSID to the DNS packet.
sdns_add_rr_authority_NID
int sdns_add_rr_authority_NID(sdns_context *dns, char *name, uint32_t ttl, uint16_t preference, char *nodeid)
Adds NID record to the asnwer section of the DNS context.
sdns_add_rr_authority_HINFO
int sdns_add_rr_authority_HINFO(sdns_context *dns, char *name, uint32_t ttl, char *os, uint8_t os_len, char *cpu, uint8_t cpu_len)
Add a HINFO record to the authority section of the DNS packet.
sdns_add_rr_answer_CAA
int sdns_add_rr_answer_CAA(sdns_context *dns, char *name, uint32_t ttl, uint8_t flag, char *tag, char *value)
Adds CAA record to the asnwer section of the DNS context.
sdns_add_rr_additional_HINFO
int sdns_add_rr_additional_HINFO(sdns_context *dns, char *name, uint32_t ttl, char *os, uint8_t os_len, char *cpu, uint8_t cpu_len)
Add a HINFO record to the additional section of the DNS packet.
sdns_add_rr_authority_TXT
int sdns_add_rr_authority_TXT(sdns_context *dns, char *name, uint32_t ttl, char *text, uint16_t text_len)
Adds TXT record to the authority section of the DNS packet.
sdns_get_additional
sdns_rr * sdns_get_additional(sdns_context *dns, int *err, uint16_t num)
Returns the additional section of the DNS context.
sdns_add_rr_answer_NS
int sdns_add_rr_answer_NS(sdns_context *dns, char *name, uint32_t ttl, char *nsname)
Adds a NS record to the dns context in the answer section.
sdns_add_rr_additional_MX
int sdns_add_rr_additional_MX(sdns_context *dns, char *name, uint32_t ttl, uint16_t preference, char *exchange)
Adds MX record to the additional section of the DNS.
sdns_set_do
int sdns_set_do(sdns_context *dns, uint8_t do_bit)
Sets or resets DNSSEC OK bit in EDNS0 part of the DNS packet.
sdns_set_ra
int sdns_set_ra(sdns_context *dns, uint8_t ra_bit)
Sets or resets the recursion available bit of the DNS header.
sdns_add_rr_authority_CNAME
int sdns_add_rr_authority_CNAME(sdns_context *dns, char *name, uint32_t ttl, char *cname)
Adds CNAME record to the authority section of the DNS record.
sdns_create_response_from_query
sdns_context * sdns_create_response_from_query(sdns_context *query)
Creates a response DNS context from the query packet.
sdns_add_rr_answer_A
int sdns_add_rr_answer_A(sdns_context *dns, char *name, uint32_t ttl, char *ip)
Adds an A record to the dns context in the answer section.
sdns_from_network
sdns_context * sdns_from_network(char *buff, uint16_t buff_len)
Converts the received binary data from the socket to a DNS packet.
sdns_add_rr_answer_PTR
int sdns_add_rr_answer_PTR(sdns_context *dns, char *name, uint32_t ttl, char *ptrdname)
Adds a PTR record to the answer section of the DNS context.
sdns_add_rr_answer_NID
int sdns_add_rr_answer_NID(sdns_context *dns, char *name, uint32_t ttl, uint16_t preference, char *nodeid)
Adds NID record to the asnwer section of the DNS context.
sdns_set_id
int sdns_set_id(sdns_context *dns, uint16_t dns_id)
Sets the ID of the DNS header.
sdns_add_rr_authority_SRV
int sdns_add_rr_authority_SRV(sdns_context *dns, char *name, uint32_t ttl, uint16_t priority, uint16_t weight, uint16_t port, char *target)
Adds a SRV record to the authority section of the DNS packet.
sdns_get_answer
sdns_rr * sdns_get_answer(sdns_context *dns, int *err, uint16_t num)
Returns the answer section of the dns context.
_sdns_rr
Definition sdns.h:229
sdns_context
Definition sdns.h:688
sdns_question
Definition sdns.h:121
Generated by doxygen 1.9.8