rr.h File Reference

Contains the definition of ldns_rr and functions to manipulate those. More...

Go to the source code of this file.

Data Structures

struct  ldns_struct_rr
 Resource Record. More...
struct  ldns_struct_rr_list
 List or Set of Resource Records. More...
struct  ldns_struct_rr_descriptor
 Contains all information about resource record types. More...

Defines

#define LDNS_MAX_LABELLEN   63
 Maximum length of a dname label.
#define LDNS_MAX_DOMAINLEN   255
 Maximum length of a complete dname.
#define LDNS_MAX_POINTERS   65535
 Maximum number of pointers in 1 dname.
#define LDNS_RR_OVERHEAD   10
 The bytes TTL, CLASS and length use up in an rr.

Typedefs

typedef enum ldns_enum_rr_class ldns_rr_class
typedef enum ldns_enum_rr_compress ldns_rr_compress
typedef enum ldns_enum_rr_type ldns_rr_type
typedef ldns_struct_rr ldns_rr
typedef ldns_struct_rr_list ldns_rr_list
typedef ldns_struct_rr_descriptor ldns_rr_descriptor

Enumerations

enum  ldns_enum_rr_class {
  LDNS_RR_CLASS_IN = 1, LDNS_RR_CLASS_CH = 3, LDNS_RR_CLASS_HS = 4, LDNS_RR_CLASS_NONE = 254,
  LDNS_RR_CLASS_ANY = 255, LDNS_RR_CLASS_FIRST = 0, LDNS_RR_CLASS_LAST = 65535, LDNS_RR_CLASS_COUNT = LDNS_RR_CLASS_LAST - LDNS_RR_CLASS_FIRST + 1
}
 The different RR classes. More...
enum  ldns_enum_rr_compress { LDNS_RR_COMPRESS, LDNS_RR_NO_COMPRESS }
 Used to specify whether compression is allowed. More...
enum  ldns_enum_rr_type {
  LDNS_RR_TYPE_A = 1, LDNS_RR_TYPE_NS = 2, LDNS_RR_TYPE_MD = 3, LDNS_RR_TYPE_MF = 4,
  LDNS_RR_TYPE_CNAME = 5, LDNS_RR_TYPE_SOA = 6, LDNS_RR_TYPE_MB = 7, LDNS_RR_TYPE_MG = 8,
  LDNS_RR_TYPE_MR = 9, LDNS_RR_TYPE_NULL = 10, LDNS_RR_TYPE_WKS = 11, LDNS_RR_TYPE_PTR = 12,
  LDNS_RR_TYPE_HINFO = 13, LDNS_RR_TYPE_MINFO = 14, LDNS_RR_TYPE_MX = 15, LDNS_RR_TYPE_TXT = 16,
  LDNS_RR_TYPE_RP = 17, LDNS_RR_TYPE_AFSDB = 18, LDNS_RR_TYPE_X25 = 19, LDNS_RR_TYPE_ISDN = 20,
  LDNS_RR_TYPE_RT = 21, LDNS_RR_TYPE_NSAP = 22, LDNS_RR_TYPE_NSAP_PTR = 23, LDNS_RR_TYPE_SIG = 24,
  LDNS_RR_TYPE_KEY = 25, LDNS_RR_TYPE_PX = 26, LDNS_RR_TYPE_GPOS = 27, LDNS_RR_TYPE_AAAA = 28,
  LDNS_RR_TYPE_LOC = 29, LDNS_RR_TYPE_NXT = 30, LDNS_RR_TYPE_EID = 31, LDNS_RR_TYPE_NIMLOC = 32,
  LDNS_RR_TYPE_SRV = 33, LDNS_RR_TYPE_ATMA = 34, LDNS_RR_TYPE_NAPTR = 35, LDNS_RR_TYPE_KX = 36,
  LDNS_RR_TYPE_CERT = 37, LDNS_RR_TYPE_A6 = 38, LDNS_RR_TYPE_DNAME = 39, LDNS_RR_TYPE_SINK = 40,
  LDNS_RR_TYPE_OPT = 41, LDNS_RR_TYPE_APL = 42, LDNS_RR_TYPE_DS = 43, LDNS_RR_TYPE_SSHFP = 44,
  LDNS_RR_TYPE_IPSECKEY = 45, LDNS_RR_TYPE_RRSIG = 46, LDNS_RR_TYPE_NSEC = 47, LDNS_RR_TYPE_DNSKEY = 48,
  LDNS_RR_TYPE_UINFO = 100, LDNS_RR_TYPE_UID = 101, LDNS_RR_TYPE_GID = 102, LDNS_RR_TYPE_UNSPEC = 103,
  LDNS_RR_TYPE_TSIG = 250, LDNS_RR_TYPE_IXFR = 251, LDNS_RR_TYPE_AXFR = 252, LDNS_RR_TYPE_MAILB = 253,
  LDNS_RR_TYPE_MAILA = 254, LDNS_RR_TYPE_ANY = 255, LDNS_RR_TYPE_FIRST = 0, LDNS_RR_TYPE_LAST = 65535,
  LDNS_RR_TYPE_COUNT = LDNS_RR_TYPE_LAST - LDNS_RR_TYPE_FIRST + 1
}
 The different RR types. More...

Functions

ldns_rrldns_rr_new (void)
 creates a new rr structure.
ldns_rrldns_rr_new_frm_type (ldns_rr_type t)
 creates a new rr structure, based on the given type.
void ldns_rr_free (ldns_rr *rr)
 frees an RR structure
ldns_status ldns_rr_new_frm_str (ldns_rr **n, const char *str, uint16_t default_ttl, ldns_rdf *origin, ldns_rdf **prev)
 creates an rr from a string.
ldns_status ldns_rr_new_frm_fp (ldns_rr **rr, FILE *fp, uint16_t *default_ttl, ldns_rdf **origin, ldns_rdf **prev)
 creates a new rr from a file containing a string.
ldns_status ldns_rr_new_frm_fp_l (ldns_rr **rr, FILE *fp, uint16_t *default_ttl, ldns_rdf **origin, ldns_rdf **prev, int *line_nr)
 creates a new rr from a file containing a string.
void ldns_rr_set_owner (ldns_rr *rr, ldns_rdf *owner)
 sets the owner in the rr structure.
void ldns_rr_set_ttl (ldns_rr *rr, uint32_t ttl)
 sets the ttl in the rr structure.
void ldns_rr_set_rd_count (ldns_rr *rr, size_t count)
 sets the rd_count in the rr.
void ldns_rr_set_type (ldns_rr *rr, ldns_rr_type rr_type)
 sets the type in the rr.
void ldns_rr_set_class (ldns_rr *rr, ldns_rr_class rr_class)
 sets the class in the rr.
ldns_rdfldns_rr_set_rdf (ldns_rr *rr, const ldns_rdf *f, size_t position)
 sets a rdf member, it will be set on the position given.
bool ldns_rr_push_rdf (ldns_rr *rr, const ldns_rdf *f)
 sets rd_field member, it will be placed in the next available spot.
ldns_rdfldns_rr_pop_rdf (ldns_rr *rr)
 removes a rd_field member, it will be popped from the last position.
ldns_rdfldns_rr_rdf (const ldns_rr *rr, size_t nr)
 returns the rdata field member counter.
ldns_rdfldns_rr_owner (const ldns_rr *rr)
 returns the owner name of an rr structure.
uint32_t ldns_rr_ttl (const ldns_rr *rr)
 returns the ttl of an rr structure.
size_t ldns_rr_rd_count (const ldns_rr *rr)
 returns the rd_count of an rr structure.
ldns_rr_type ldns_rr_get_type (const ldns_rr *rr)
 returns the type of the rr.
ldns_rr_class ldns_rr_get_class (const ldns_rr *rr)
 returns the class of the rr.
size_t ldns_rr_list_rr_count (const ldns_rr_list *rr_list)
 returns the number of rr's in an rr_list.
void ldns_rr_list_set_rr_count (ldns_rr_list *rr_list, size_t count)
 sets the number of rr's in an rr_list.
ldns_rrldns_rr_list_set_rr (ldns_rr_list *rr_list, const ldns_rr *r, size_t count)
 set a rr on a specific index in a ldns_rr_list
ldns_rrldns_rr_list_rr (const ldns_rr_list *rr_list, size_t nr)
 returns a specific rr of an rrlist.
ldns_rr_listldns_rr_list_new ()
 creates a new rr_list structure.
void ldns_rr_list_free (ldns_rr_list *rr_list)
 frees an rr_list structure.
void ldns_rr_list_deep_free (ldns_rr_list *rr_list)
 frees an rr_list structure and all rrs contained therein.
bool ldns_rr_list_cat (ldns_rr_list *left, ldns_rr_list *right)
 concatenates two ldns_rr_lists together.
ldns_rr_listldns_rr_list_cat_clone (ldns_rr_list *left, ldns_rr_list *right)
 concatenates two ldns_rr_lists together, but makes clones of the rr's (instead of pointer copying).
bool ldns_rr_list_push_rr (ldns_rr_list *rr_list, const ldns_rr *rr)
 pushes an rr to an rrlist.
bool ldns_rr_list_push_rr_list (ldns_rr_list *rr_list, const ldns_rr_list *push_list)
 pushes an rr_list to an rrlist.
ldns_rrldns_rr_list_pop_rr (ldns_rr_list *rr_list)
 pops the last rr from an rrlist.
ldns_rr_listldns_rr_list_pop_rr_list (ldns_rr_list *rr_list, size_t size)
 pops an rr_list of size s from an rrlist.
bool ldns_rr_list_contains_rr (ldns_rr_list *rr_list, ldns_rr *rr)
 returns true if the given rr is one of the rrs in the list, or if it is equal to one
bool ldns_is_rrset (ldns_rr_list *rr_list)
 checks if an rr_list is a rrset.
bool ldns_rr_set_push_rr (ldns_rr_list *rr_list, ldns_rr *rr)
 pushes an rr to an rrset (which really are rr_list's).
ldns_rrldns_rr_set_pop_rr (ldns_rr_list *rr_list)
 pops the last rr from an rrset.
ldns_rr_listldns_rr_list_pop_rrset (ldns_rr_list *rr_list)
 pops the first rrset from the list, the list must be sorted, so that all rr's from each rrset are next to each other
ldns_rr_type ldns_get_rr_type_by_name (const char *name)
 retrieves a rrtype by looking up its name.
ldns_rr_class ldns_get_rr_class_by_name (const char *name)
 retrieves a class by looking up its name.
ldns_rrldns_rr_clone (const ldns_rr *rr)
 clones a rr and all its data
ldns_rr_listldns_rr_list_clone (ldns_rr_list *rrlist)
 clones an rrlist.
void ldns_rr_list_sort (ldns_rr_list *unsorted)
 sorts an rr_list (canonical wire format).
int ldns_rr_compare (const ldns_rr *rr1, const ldns_rr *rr2)
 compares two rrs.
int ldns_rr_compare_no_rdata (const ldns_rr *rr1, const ldns_rr *rr2)
 compares two rrs, up to the rdata.
int ldns_rr_compare_wire (ldns_buffer *rr1_buf, ldns_buffer *rr2_buf)
 compares the wireformat of two rrs, contained in the given buffers.
bool ldns_rr_compare_ds (const ldns_rr *rr1, const ldns_rr *rr2)
 returns true of the given rr's are equal.
int ldns_rr_list_compare (const ldns_rr_list *rrl1, const ldns_rr_list *rrl2)
 compares two rr listss.
size_t ldns_rr_uncompressed_size (const ldns_rr *r)
 calculates the uncompressed size of an RR.
void ldns_rr2canonical (ldns_rr *rr)
 converts each dname in a rr to its canonical form.
void ldns_rr_list2canonical (ldns_rr_list *rr_list)
 converts each dname in each rr in a rr_list to its canonical form.
uint8_t ldns_rr_label_count (ldns_rr *rr)
 counts the number of labels of the ownername.
const ldns_rr_descriptorldns_rr_descript (uint16_t type)
 returns the resource record descriptor for the given rr type.
size_t ldns_rr_descriptor_minimum (const ldns_rr_descriptor *descriptor)
 returns the minimum number of rdata fields of the rr type this descriptor describes.
size_t ldns_rr_descriptor_maximum (const ldns_rr_descriptor *descriptor)
 returns the maximum number of rdata fields of the rr type this descriptor describes.
ldns_rdf_type ldns_rr_descriptor_field_type (const ldns_rr_descriptor *descriptor, size_t field)
 returns the rdf type for the given rdata field number of the rr type for the given descriptor.
ldns_rr_listldns_rr_list_subtype_by_rdf (ldns_rr_list *l, ldns_rdf *r, size_t pos)
 Return the rr_list which matches the rdf at position field.
ldns_rr_type ldns_rdf2rr_type (const ldns_rdf *rd)
 convert an rdf of type LDNS_RDF_TYPE_TYPE to an actual LDNS_RR_TYPE.


Detailed Description

Contains the definition of ldns_rr and functions to manipulate those.

Definition in file rr.h.


Define Documentation

#define LDNS_MAX_LABELLEN   63

Maximum length of a dname label.

Definition at line 27 of file rr.h.

#define LDNS_MAX_DOMAINLEN   255

Maximum length of a complete dname.

Definition at line 29 of file rr.h.

#define LDNS_MAX_POINTERS   65535

Maximum number of pointers in 1 dname.

Definition at line 31 of file rr.h.

#define LDNS_RR_OVERHEAD   10

The bytes TTL, CLASS and length use up in an rr.

Definition at line 33 of file rr.h.


Typedef Documentation

typedef enum ldns_enum_rr_class ldns_rr_class

Definition at line 56 of file rr.h.

typedef enum ldns_enum_rr_compress ldns_rr_compress

Definition at line 67 of file rr.h.

typedef enum ldns_enum_rr_type ldns_rr_type

Definition at line 188 of file rr.h.

typedef struct ldns_struct_rr ldns_rr

Definition at line 267 of file rr.h.

typedef struct ldns_struct_rr_list ldns_rr_list

Definition at line 281 of file rr.h.

typedef struct ldns_struct_rr_descriptor ldns_rr_descriptor

Definition at line 305 of file rr.h.


Enumeration Type Documentation

enum ldns_enum_rr_class

The different RR classes.

Enumerator:
LDNS_RR_CLASS_IN  the Internet
LDNS_RR_CLASS_CH  Chaos class.
LDNS_RR_CLASS_HS  Hesiod (Dyer 87).
LDNS_RR_CLASS_NONE  None class, dynmaic update.
LDNS_RR_CLASS_ANY  Any class.
LDNS_RR_CLASS_FIRST 
LDNS_RR_CLASS_LAST 
LDNS_RR_CLASS_COUNT 

Definition at line 39 of file rr.h.

enum ldns_enum_rr_compress

Used to specify whether compression is allowed.

Enumerator:
LDNS_RR_COMPRESS  compression is allowed
LDNS_RR_NO_COMPRESS 

Definition at line 61 of file rr.h.

enum ldns_enum_rr_type

The different RR types.

Enumerator:
LDNS_RR_TYPE_A  a host address
LDNS_RR_TYPE_NS  an authoritative name server
LDNS_RR_TYPE_MD  a mail destination (Obsolete - use MX)
LDNS_RR_TYPE_MF  a mail forwarder (Obsolete - use MX)
LDNS_RR_TYPE_CNAME  the canonical name for an alias
LDNS_RR_TYPE_SOA  marks the start of a zone of authority
LDNS_RR_TYPE_MB  a mailbox domain name (EXPERIMENTAL)
LDNS_RR_TYPE_MG  a mail group member (EXPERIMENTAL)
LDNS_RR_TYPE_MR  a mail rename domain name (EXPERIMENTAL)
LDNS_RR_TYPE_NULL  a null RR (EXPERIMENTAL)
LDNS_RR_TYPE_WKS  a well known service description
LDNS_RR_TYPE_PTR  a domain name pointer
LDNS_RR_TYPE_HINFO  host information
LDNS_RR_TYPE_MINFO  mailbox or mail list information
LDNS_RR_TYPE_MX  mail exchange
LDNS_RR_TYPE_TXT  text strings
LDNS_RR_TYPE_RP  RFC1183.
LDNS_RR_TYPE_AFSDB  RFC1183.
LDNS_RR_TYPE_X25  RFC1183.
LDNS_RR_TYPE_ISDN  RFC1183.
LDNS_RR_TYPE_RT  RFC1183.
LDNS_RR_TYPE_NSAP  RFC1706.
LDNS_RR_TYPE_NSAP_PTR  RFC1348.
LDNS_RR_TYPE_SIG  2535typecode
LDNS_RR_TYPE_KEY  2535typecode
LDNS_RR_TYPE_PX  RFC2163.
LDNS_RR_TYPE_GPOS  RFC1712.
LDNS_RR_TYPE_AAAA  ipv6 address
LDNS_RR_TYPE_LOC  LOC record RFC1876.
LDNS_RR_TYPE_NXT  2535typecode
LDNS_RR_TYPE_EID  draft-ietf-nimrod-dns-01.txt
LDNS_RR_TYPE_NIMLOC  draft-ietf-nimrod-dns-01.txt
LDNS_RR_TYPE_SRV  SRV record RFC2782.
LDNS_RR_TYPE_ATMA  http://www.jhsoft.com/rfc/af-saa-0069.000.rtf
LDNS_RR_TYPE_NAPTR  RFC2915.
LDNS_RR_TYPE_KX  RFC2230.
LDNS_RR_TYPE_CERT  RFC2538.
LDNS_RR_TYPE_A6  RFC2874.
LDNS_RR_TYPE_DNAME  RFC2672.
LDNS_RR_TYPE_SINK  dnsind-kitchen-sink-02.txt
LDNS_RR_TYPE_OPT  Pseudo OPT record.

..

LDNS_RR_TYPE_APL  RFC3123.
LDNS_RR_TYPE_DS  draft-ietf-dnsext-delegation
LDNS_RR_TYPE_SSHFP  SSH Key Fingerprint.
LDNS_RR_TYPE_IPSECKEY  draft-richardson-ipseckey-rr-11.txt
LDNS_RR_TYPE_RRSIG  draft-ietf-dnsext-dnssec-25
LDNS_RR_TYPE_NSEC 
LDNS_RR_TYPE_DNSKEY 
LDNS_RR_TYPE_UINFO 
LDNS_RR_TYPE_UID 
LDNS_RR_TYPE_GID 
LDNS_RR_TYPE_UNSPEC 
LDNS_RR_TYPE_TSIG 
LDNS_RR_TYPE_IXFR 
LDNS_RR_TYPE_AXFR 
LDNS_RR_TYPE_MAILB  A request for mailbox-related records (MB, MG or MR).
LDNS_RR_TYPE_MAILA  A request for mail agent RRs (Obsolete - see MX).
LDNS_RR_TYPE_ANY  any type (wildcard)
LDNS_RR_TYPE_FIRST 
LDNS_RR_TYPE_LAST 
LDNS_RR_TYPE_COUNT 

Definition at line 72 of file rr.h.


Function Documentation

ldns_rr* ldns_rr_new ( void   ) 

creates a new rr structure.

Returns:
ldns_rr *

Definition at line 24 of file rr.c.

References ldns_struct_rr::_rdata_fields, LDNS_DEFAULT_TTL, LDNS_MALLOC, LDNS_RR_CLASS_IN, ldns_rr_set_class(), ldns_rr_set_owner(), ldns_rr_set_rd_count(), and ldns_rr_set_ttl().

ldns_rr* ldns_rr_new_frm_type ( ldns_rr_type  t  ) 

creates a new rr structure, based on the given type.

alloc enough space to hold all the rdf's

Definition at line 41 of file rr.c.

References ldns_struct_rr::_rdata_fields, LDNS_DEFAULT_TTL, LDNS_MALLOC, LDNS_RR_CLASS_IN, ldns_rr_descript(), ldns_rr_descriptor_minimum(), ldns_rr_set_class(), ldns_rr_set_rd_count(), ldns_rr_set_ttl(), ldns_rr_set_type(), and LDNS_XMALLOC.

void ldns_rr_free ( ldns_rr rr  ) 

frees an RR structure

Parameters:
[in] *rr the RR to be freed
Returns:
void

Definition at line 68 of file rr.c.

References LDNS_FREE, ldns_rdf_deep_free(), ldns_rr_owner(), ldns_rr_rd_count(), and ldns_rr_rdf().

ldns_status ldns_rr_new_frm_str ( ldns_rr **  n,
const char *  str,
uint16_t  default_ttl,
ldns_rdf origin,
ldns_rdf **  prev 
)

creates an rr from a string.

The string should be a fully filled-in rr, like ownername <space> TTL <space> CLASS <space> TYPE <space> RDATA.

Parameters:
[out] n the rr to return
[in] str the string to convert
[in] default_ttl pointer to a default ttl for the rr. If 0 DEF_TTL will be used
[in] origin when the owner is relative add this. The caller must ldns_rdf_deep_free it.
prev the previous ownername. the function overwrite this with the current found ownername. The caller must ldns_rdf_deep_free it.
Returns:
a status msg describing an error or LDNS_STATUS_OK

Definition at line 97 of file rr.c.

References ldns_bget_token(), ldns_buffer_free(), ldns_buffer_new_frm_data(), LDNS_DEFAULT_TTL, ldns_dname_cat(), ldns_dname_new_frm_str(), ldns_dname_str_absolute(), LDNS_FREE, ldns_get_rr_class_by_name(), ldns_get_rr_type_by_name(), LDNS_MALLOC, LDNS_MAX_DOMAINLEN, LDNS_MAX_PACKETLEN, LDNS_MAX_RDFLEN, ldns_rdf_clone(), ldns_rdf_data(), ldns_rdf_deep_free(), ldns_rdf_new_frm_str(), ldns_rdf_set_type(), LDNS_RDF_TYPE_B64, LDNS_RDF_TYPE_DNAME, LDNS_RDF_TYPE_HEX, LDNS_RDF_TYPE_LOC, LDNS_RDF_TYPE_NSEC, LDNS_RDF_TYPE_STR, LDNS_RDF_TYPE_WKS, LDNS_RR_CLASS_IN, ldns_rr_descript(), ldns_rr_descriptor_field_type(), ldns_rr_descriptor_maximum(), ldns_rr_descriptor_minimum(), ldns_rr_free(), ldns_rr_new(), ldns_rr_owner(), ldns_rr_push_rdf(), ldns_rr_set_class(), ldns_rr_set_owner(), ldns_rr_set_ttl(), ldns_rr_set_type(), LDNS_RR_TYPE_SOA, LDNS_STATUS_ERR, LDNS_STATUS_MEM_ERR, LDNS_STATUS_OK, LDNS_STATUS_SYNTAX_CLASS_ERR, LDNS_STATUS_SYNTAX_ERR, LDNS_STATUS_SYNTAX_RDATA_ERR, LDNS_STATUS_SYNTAX_TTL_ERR, LDNS_STATUS_SYNTAX_TYPE_ERR, LDNS_SYNTAX_DATALEN, LDNS_TTL_DATALEN, and LDNS_XMALLOC.

ldns_status ldns_rr_new_frm_fp ( ldns_rr **  rr,
FILE *  fp,
uint16_t *  default_ttl,
ldns_rdf **  origin,
ldns_rdf **  prev 
)

creates a new rr from a file containing a string.

Parameters:
[out] rr the new rr
[in] fp the file pointer to use
[in] default_ttl pointer to a default ttl for the rr. If NULL DEF_TTL will be used the pointer will be updated if the file contains a $TTL directive
[in] origin when the owner is relative add this the pointer will be updated if the file contains a $ORIGIN directive The caller must ldns_rdf_deep_free it.
[in] prev when the owner is whitespaces use this as the * ownername the pointer will be updated after the call The caller must ldns_rdf_deep_free it.
Returns:
a ldns_status with an error or LDNS_STATUS_OK

Definition at line 483 of file rr.c.

References ldns_rr_new_frm_fp_l().

ldns_status ldns_rr_new_frm_fp_l ( ldns_rr **  rr,
FILE *  fp,
uint16_t *  default_ttl,
ldns_rdf **  origin,
ldns_rdf **  prev,
int *  line_nr 
)

creates a new rr from a file containing a string.

Parameters:
[out] rr the new rr
[in] fp the file pointer to use
[in] fp the file pointer to use
[in] default_ttl a default ttl for the rr. If 0 DEF_TTL will be used the pointer will be updated if the file contains a $TTL directive The caller must ldns_rdf_deep_free it.
[in] origin when the owner is relative add this the pointer will be updated if the file contains a $ORIGIN directive The caller must ldns_rdf_deep_free it.
[in] line_nr pointer to an integer containing the current line number (for debugging purposes)
[in] prev when the owner is whitespaces use this as the * ownername the pointer will be updated after the call
Returns:
a ldns_status with an error or LDNS_STATUS_OK

Definition at line 489 of file rr.c.

References ldns_fget_token_l(), LDNS_FREE, LDNS_MAX_LINELEN, LDNS_PARSE_SKIP_SPACE, ldns_rdf_deep_free(), ldns_rdf_new_frm_str(), LDNS_RDF_TYPE_DNAME, ldns_rr_new_frm_str(), LDNS_STATUS_ERR, LDNS_STATUS_MEM_ERR, LDNS_STATUS_OK, LDNS_STATUS_SYNTAX_DNAME_ERR, LDNS_STATUS_SYNTAX_EMPTY, LDNS_STATUS_SYNTAX_ERR, LDNS_STATUS_SYNTAX_ORIGIN, LDNS_STATUS_SYNTAX_TTL, ldns_str2period(), and LDNS_XMALLOC.

void ldns_rr_set_owner ( ldns_rr rr,
ldns_rdf owner 
)

sets the owner in the rr structure.

Parameters:
[in] *rr rr to operate on
[in] *owner set to this owner
Returns:
void

Definition at line 564 of file rr.c.

References ldns_struct_rr::_owner.

void ldns_rr_set_ttl ( ldns_rr rr,
uint32_t  ttl 
)

sets the ttl in the rr structure.

Parameters:
[in] *rr rr to operate on
[in] ttl set to this ttl
Returns:
void

Definition at line 570 of file rr.c.

References ldns_struct_rr::_ttl.

void ldns_rr_set_rd_count ( ldns_rr rr,
size_t  count 
)

sets the rd_count in the rr.

Parameters:
[in] *rr rr to operate on
[in] count set to this count
Returns:
void

Definition at line 576 of file rr.c.

References ldns_struct_rr::_rd_count.

void ldns_rr_set_type ( ldns_rr rr,
ldns_rr_type  rr_type 
)

sets the type in the rr.

Parameters:
[in] *rr rr to operate on
[in] rr_type set to this type
Returns:
void

Definition at line 582 of file rr.c.

References ldns_struct_rr::_rr_type.

void ldns_rr_set_class ( ldns_rr rr,
ldns_rr_class  rr_class 
)

sets the class in the rr.

Parameters:
[in] *rr rr to operate on
[in] rr_class set to this class
Returns:
void

Definition at line 588 of file rr.c.

References ldns_struct_rr::_rr_class.

ldns_rdf* ldns_rr_set_rdf ( ldns_rr rr,
const ldns_rdf f,
size_t  position 
)

sets a rdf member, it will be set on the position given.

The old value is returned, like pop.

Parameters:
[in] *rr the rr to operate on
[in] *f the rdf to set
[in] position the position the set the rdf
Returns:
the old value in the rr, NULL on failyre

Definition at line 594 of file rr.c.

References ldns_struct_rr::_rdata_fields, and ldns_rr_rd_count().

bool ldns_rr_push_rdf ( ldns_rr rr,
const ldns_rdf f 
)

sets rd_field member, it will be placed in the next available spot.

Parameters:
[in] *rr rr to operate on
[in] *f the data field member to set
Returns:
bool

Definition at line 613 of file rr.c.

References ldns_struct_rr::_rdata_fields, ldns_rr_rd_count(), ldns_rr_set_rd_count(), and LDNS_XREALLOC.

ldns_rdf* ldns_rr_pop_rdf ( ldns_rr rr  ) 

removes a rd_field member, it will be popped from the last position.

Parameters:
[in] *rr rr to operate on
Returns:
rdf which was popped (null if nothing)

Definition at line 636 of file rr.c.

References ldns_struct_rr::_rdata_fields, ldns_rr_rd_count(), ldns_rr_set_rd_count(), and LDNS_XREALLOC.

ldns_rdf* ldns_rr_rdf ( const ldns_rr rr,
size_t  nr 
)

returns the rdata field member counter.

Parameters:
[in] *rr rr to operate on
[in] nr the number of the rdf to return
Returns:
ldns_rdf *

Definition at line 658 of file rr.c.

References ldns_struct_rr::_rdata_fields, and ldns_rr_rd_count().

ldns_rdf* ldns_rr_owner ( const ldns_rr rr  ) 

returns the owner name of an rr structure.

Parameters:
[in] *rr rr to operate on
Returns:
ldns_rdf *

Definition at line 668 of file rr.c.

References ldns_struct_rr::_owner.

uint32_t ldns_rr_ttl ( const ldns_rr rr  ) 

returns the ttl of an rr structure.

Parameters:
[in] *rr the rr to read from
Returns:
the ttl of the rr

Definition at line 674 of file rr.c.

References ldns_struct_rr::_ttl.

size_t ldns_rr_rd_count ( const ldns_rr rr  ) 

returns the rd_count of an rr structure.

Parameters:
[in] *rr the rr to read from
Returns:
the rd count of the rr

Definition at line 680 of file rr.c.

References ldns_struct_rr::_rd_count.

ldns_rr_type ldns_rr_get_type ( const ldns_rr rr  ) 

returns the type of the rr.

Parameters:
[in] *rr the rr to read from
Returns:
the type of the rr

Definition at line 686 of file rr.c.

References ldns_struct_rr::_rr_type.

ldns_rr_class ldns_rr_get_class ( const ldns_rr rr  ) 

returns the class of the rr.

Parameters:
[in] *rr the rr to read from
Returns:
the class of the rr

Definition at line 692 of file rr.c.

References ldns_struct_rr::_rr_class.

size_t ldns_rr_list_rr_count ( const ldns_rr_list rr_list  ) 

returns the number of rr's in an rr_list.

Parameters:
[in] rr_list the rr_list to read from
Returns:
the number of rr's

Definition at line 700 of file rr.c.

References ldns_struct_rr_list::_rr_count.

void ldns_rr_list_set_rr_count ( ldns_rr_list rr_list,
size_t  count 
)

sets the number of rr's in an rr_list.

Parameters:
[in] rr_list the rr_list to set the count on
[in] count the number of rr in this list
Returns:
void

Definition at line 726 of file rr.c.

References ldns_struct_rr_list::_rr_count.

ldns_rr* ldns_rr_list_set_rr ( ldns_rr_list rr_list,
const ldns_rr r,
size_t  count 
)

set a rr on a specific index in a ldns_rr_list

Parameters:
[in] rr_list the rr_list to use
[in] r the rr to set
[in] count index into the rr_list
Returns:
the old rr which was stored in the rr_list, or NULL is the index was too large set a specific rr

Definition at line 710 of file rr.c.

References ldns_struct_rr_list::_rrs, ldns_rr_list_rr(), and ldns_rr_list_rr_count().

ldns_rr* ldns_rr_list_rr ( const ldns_rr_list rr_list,
size_t  nr 
)

returns a specific rr of an rrlist.

Parameters:
[in] rr_list the rr_list to read from
[in] nr return this rr
Returns:
the rr at position nr

Definition at line 733 of file rr.c.

References ldns_struct_rr_list::_rrs, and ldns_rr_list_rr_count().

ldns_rr_list* ldns_rr_list_new (  ) 

creates a new rr_list structure.

Returns:
a new rr_list structure

Definition at line 743 of file rr.c.

References ldns_struct_rr_list::_rr_capacity, ldns_struct_rr_list::_rr_count, ldns_struct_rr_list::_rrs, and LDNS_MALLOC.

void ldns_rr_list_free ( ldns_rr_list rr_list  ) 

frees an rr_list structure.

Parameters:
[in] rr_list the list to free

Definition at line 753 of file rr.c.

References ldns_struct_rr_list::_rrs, and LDNS_FREE.

void ldns_rr_list_deep_free ( ldns_rr_list rr_list  ) 

frees an rr_list structure and all rrs contained therein.

Parameters:
[in] rr_list the list to free

Definition at line 762 of file rr.c.

References ldns_struct_rr_list::_rrs, LDNS_FREE, ldns_rr_free(), ldns_rr_list_rr(), and ldns_rr_list_rr_count().

bool ldns_rr_list_cat ( ldns_rr_list left,
ldns_rr_list right 
)

concatenates two ldns_rr_lists together.

This modifies *left (to extend it and add the pointers from *right).

Parameters:
[in] left the leftside
[in] right the rightside
Returns:
a left with right concatenated to it

Definition at line 778 of file rr.c.

References ldns_rr_list_push_rr(), ldns_rr_list_rr(), and ldns_rr_list_rr_count().

ldns_rr_list* ldns_rr_list_cat_clone ( ldns_rr_list left,
ldns_rr_list right 
)

concatenates two ldns_rr_lists together, but makes clones of the rr's (instead of pointer copying).

Parameters:
[in] left the leftside
[in] right the rightside
Returns:
a new rr_list with leftside/rightside concatenated

Definition at line 804 of file rr.c.

References ldns_rr_clone(), ldns_rr_list_clone(), ldns_rr_list_new(), ldns_rr_list_push_rr(), ldns_rr_list_rr(), and ldns_rr_list_rr_count().

bool ldns_rr_list_push_rr ( ldns_rr_list rr_list,
const ldns_rr rr 
)

pushes an rr to an rrlist.

Parameters:
[in] rr_list the rr_list to push to
[in] rr the rr to push
Returns:
false on error, otherwise true

Definition at line 877 of file rr.c.

References ldns_struct_rr_list::_rr_capacity, ldns_struct_rr_list::_rrs, ldns_rr_list_rr_count(), ldns_rr_list_set_rr_count(), LDNS_RRLIST_INIT, and LDNS_XREALLOC.

bool ldns_rr_list_push_rr_list ( ldns_rr_list rr_list,
const ldns_rr_list push_list 
)

pushes an rr_list to an rrlist.

Parameters:
[in] rr_list the rr_list to push to
[in] push_list the rr_list to push
Returns:
false on error, otherwise true

Definition at line 908 of file rr.c.

References ldns_rr_list_push_rr(), ldns_rr_list_rr(), and ldns_rr_list_rr_count().

ldns_rr* ldns_rr_list_pop_rr ( ldns_rr_list rr_list  ) 

pops the last rr from an rrlist.

Parameters:
[in] rr_list the rr_list to pop from
Returns:
NULL if nothing to pop. Otherwise the popped RR

Definition at line 922 of file rr.c.

References ldns_struct_rr_list::_rr_capacity, ldns_struct_rr_list::_rrs, ldns_rr_list_rr(), ldns_rr_list_rr_count(), ldns_rr_list_set_rr_count(), LDNS_RRLIST_INIT, and LDNS_XREALLOC.

ldns_rr_list* ldns_rr_list_pop_rr_list ( ldns_rr_list rr_list,
size_t  size 
)

pops an rr_list of size s from an rrlist.

Parameters:
[in] rr_list the rr_list to pop from
[in] size the number of rr's to pop
Returns:
NULL if nothing to pop. Otherwise the popped rr_list

Definition at line 950 of file rr.c.

References ldns_rr_list_new(), ldns_rr_list_pop_rr(), and ldns_rr_list_push_rr().

bool ldns_rr_list_contains_rr ( ldns_rr_list rr_list,
ldns_rr rr 
)

returns true if the given rr is one of the rrs in the list, or if it is equal to one

Parameters:
[in] rr_list the rr_list to check
[in] rr the rr to check
Returns:
true if rr_list contains rr, false otherwise

Definition at line 979 of file rr.c.

References ldns_rr_compare(), ldns_rr_list_rr(), and ldns_rr_list_rr_count().

bool ldns_is_rrset ( ldns_rr_list rr_list  ) 

checks if an rr_list is a rrset.

Parameters:
[in] rr_list the rr_list to check
Returns:
true if it is an rrset otherwise false

Definition at line 998 of file rr.c.

References ldns_rdf_compare(), ldns_rr_get_class(), ldns_rr_get_type(), ldns_rr_list_rr(), ldns_rr_list_rr_count(), and ldns_rr_owner().

bool ldns_rr_set_push_rr ( ldns_rr_list rr_list,
ldns_rr rr 
)

pushes an rr to an rrset (which really are rr_list's).

Parameters:
[in] *rr_list the rrset to push the rr to
[in] *rr the rr to push
Returns:
true if the push succeeded otherwise false

Definition at line 1033 of file rr.c.

References ldns_rdf_compare(), ldns_rr_compare(), ldns_rr_get_class(), ldns_rr_get_type(), ldns_rr_list_push_rr(), ldns_rr_list_rr(), ldns_rr_list_rr_count(), ldns_rr_owner(), ldns_rr_ttl(), and LDNS_RR_TYPE_RRSIG.

ldns_rr* ldns_rr_set_pop_rr ( ldns_rr_list rr_list  ) 

pops the last rr from an rrset.

This function is there only for the symmetry.

Parameters:
[in] rr_list the rr_list to pop from
Returns:
NULL if nothing to pop. Otherwise the popped RR

Definition at line 1081 of file rr.c.

References ldns_rr_list_pop_rr().

ldns_rr_list* ldns_rr_list_pop_rrset ( ldns_rr_list rr_list  ) 

pops the first rrset from the list, the list must be sorted, so that all rr's from each rrset are next to each other

Definition at line 1087 of file rr.c.

References ldns_rdf_compare(), ldns_rr_get_class(), ldns_rr_get_type(), ldns_rr_list_free(), ldns_rr_list_new(), ldns_rr_list_pop_rr(), ldns_rr_list_push_rr(), ldns_rr_list_rr(), ldns_rr_list_rr_count(), and ldns_rr_owner().

ldns_rr_type ldns_get_rr_type_by_name ( const char *  name  ) 

retrieves a rrtype by looking up its name.

Parameters:
[in] name a string with the name
Returns:
the type which corresponds with the name

Definition at line 2048 of file rr.c.

References ldns_struct_rr_descriptor::_name, LDNS_RDATA_FIELD_DESCRIPTORS_COUNT, and ldns_rr_descript().

ldns_rr_class ldns_get_rr_class_by_name ( const char *  name  ) 

retrieves a class by looking up its name.

Parameters:
[in] name string with the name
Returns:
the cass which corresponds with the name

Definition at line 2087 of file rr.c.

References ldns_struct_lookup_table::id, ldns_lookup_by_name(), and ldns_rr_classes.

ldns_rr* ldns_rr_clone ( const ldns_rr rr  ) 

clones a rr and all its data

Parameters:
[in] rr the rr to clone
Returns:
the new rr or NULL on failure

Definition at line 1139 of file rr.c.

References ldns_rdf_clone(), ldns_rr_get_class(), ldns_rr_get_type(), ldns_rr_new(), ldns_rr_owner(), ldns_rr_push_rdf(), ldns_rr_rd_count(), ldns_rr_rdf(), ldns_rr_set_class(), ldns_rr_set_owner(), ldns_rr_set_ttl(), ldns_rr_set_type(), and ldns_rr_ttl().

ldns_rr_list* ldns_rr_list_clone ( ldns_rr_list rrlist  ) 

clones an rrlist.

Parameters:
[in] rrlist the rrlist to clone
Returns:
the cloned rr list

Definition at line 1167 of file rr.c.

References ldns_rr_clone(), ldns_rr_list_free(), ldns_rr_list_new(), ldns_rr_list_push_rr(), ldns_rr_list_rr(), and ldns_rr_list_rr_count().

void ldns_rr_list_sort ( ldns_rr_list unsorted  ) 

sorts an rr_list (canonical wire format).

the sorting is done inband.

Parameters:
[in] unsorted the rr_list to be sorted
Returns:
void

Definition at line 1267 of file rr.c.

References ldns_struct_rr_list::_rrs, ldns_buffer_free(), LDNS_FREE, ldns_rr_list_rr(), ldns_rr_list_rr_count(), LDNS_XMALLOC, ldns_schwartzian_compare_struct::original_object, qsort_schwartz_rr_compare(), and ldns_schwartzian_compare_struct::transformed_object.

int ldns_rr_compare ( const ldns_rr rr1,
const ldns_rr rr2 
)

compares two rrs.

Parameters:
[in] rr1 the first one
[in] rr2 the second one
Returns:
0 if equal -1 if rr1 comes before rr2 +1 if rr2 comes before rr1

Definition at line 1376 of file rr.c.

References ldns_buffer_free(), ldns_buffer_new(), ldns_rr2buffer_wire(), ldns_rr_compare_no_rdata(), ldns_rr_compare_wire(), ldns_rr_uncompressed_size(), LDNS_SECTION_ANY, and LDNS_STATUS_OK.

int ldns_rr_compare_no_rdata ( const ldns_rr rr1,
const ldns_rr rr2 
)

compares two rrs, up to the rdata.

Parameters:
[in] rr1 the first one
[in] rr2 the second one
Returns:
0 if equal -1 if rr1 comes before rr2 +1 if rr2 comes before rr1

Definition at line 1299 of file rr.c.

References ldns_dname_compare(), ldns_rdf_size(), ldns_rr_get_class(), ldns_rr_get_type(), ldns_rr_owner(), and ldns_rr_uncompressed_size().

int ldns_rr_compare_wire ( ldns_buffer rr1_buf,
ldns_buffer rr2_buf 
)

compares the wireformat of two rrs, contained in the given buffers.

Parameters:
[in] rr1_buf the first one
[in] rr2_buf the second one
Returns:
0 if equal -1 if rr1_buf comes before rr2_buf +1 if rr2_buf comes before rr1_buf

Definition at line 1338 of file rr.c.

bool ldns_rr_compare_ds ( const ldns_rr rr1,
const ldns_rr rr2 
)

returns true of the given rr's are equal.

Also returns true if one record is a DS that represents the same DNSKEY record as the other record

Parameters:
[in] rr1 the first rr
[in] rr2 the second rr
Returns:
true if equal otherwise false

Definition at line 1413 of file rr.c.

References ldns_key_rr2ds(), ldns_rr_clone(), ldns_rr_compare(), ldns_rr_free(), ldns_rr_get_type(), ldns_rr_set_ttl(), LDNS_RR_TYPE_DNSKEY, LDNS_RR_TYPE_DS, and LDNS_SHA1.

int ldns_rr_list_compare ( const ldns_rr_list rrl1,
const ldns_rr_list rrl2 
)

compares two rr listss.

Parameters:
[in] rrl1 the first one
[in] rrl2 the second one
Returns:
0 if equal -1 if rrl1 comes before rrl2 +1 if rrl2 comes before rrl1

Definition at line 1452 of file rr.c.

References ldns_rr_compare(), ldns_rr_list_rr(), and ldns_rr_list_rr_count().

size_t ldns_rr_uncompressed_size ( const ldns_rr r  ) 

calculates the uncompressed size of an RR.

Parameters:
[in] r the rr to operate on
Returns:
size of the rr

Definition at line 1479 of file rr.c.

References ldns_rdf_size(), LDNS_RR_OVERHEAD, ldns_rr_owner(), ldns_rr_rd_count(), and ldns_rr_rdf().

void ldns_rr2canonical ( ldns_rr rr  ) 

converts each dname in a rr to its canonical form.

Parameters:
[in] rr the rr to work on
Returns:
void

Definition at line 1496 of file rr.c.

References ldns_dname2canonical(), ldns_rr_get_type(), ldns_rr_owner(), ldns_rr_rd_count(), ldns_rr_rdf(), LDNS_RR_TYPE_A6, LDNS_RR_TYPE_AFSDB, LDNS_RR_TYPE_CNAME, LDNS_RR_TYPE_DNAME, LDNS_RR_TYPE_HINFO, LDNS_RR_TYPE_KX, LDNS_RR_TYPE_MB, LDNS_RR_TYPE_MD, LDNS_RR_TYPE_MF, LDNS_RR_TYPE_MG, LDNS_RR_TYPE_MINFO, LDNS_RR_TYPE_MR, LDNS_RR_TYPE_MX, LDNS_RR_TYPE_NAPTR, LDNS_RR_TYPE_NS, LDNS_RR_TYPE_NXT, LDNS_RR_TYPE_PTR, LDNS_RR_TYPE_PX, LDNS_RR_TYPE_RP, LDNS_RR_TYPE_RT, LDNS_RR_TYPE_SIG, LDNS_RR_TYPE_SOA, and LDNS_RR_TYPE_SRV.

void ldns_rr_list2canonical ( ldns_rr_list rr_list  ) 

converts each dname in each rr in a rr_list to its canonical form.

Parameters:
[in] rr_list the rr_list to work on
Returns:
void

Definition at line 1545 of file rr.c.

References ldns_rr2canonical(), ldns_rr_list_rr(), and ldns_rr_list_rr_count().

uint8_t ldns_rr_label_count ( ldns_rr rr  ) 

counts the number of labels of the ownername.

Parameters:
[in] rr count the labels of this rr
Returns:
the number of labels

Definition at line 1554 of file rr.c.

References ldns_dname_label_count(), and ldns_rr_owner().

const ldns_rr_descriptor* ldns_rr_descript ( uint16_t  type  ) 

returns the resource record descriptor for the given rr type.

Parameters:
[in] type the type value of the rr type
Returns:
the ldns_rr_descriptor for this type

Definition at line 2007 of file rr.c.

References LDNS_RDATA_FIELD_DESCRIPTORS_COUNT.

size_t ldns_rr_descriptor_minimum ( const ldns_rr_descriptor descriptor  ) 

returns the minimum number of rdata fields of the rr type this descriptor describes.

Parameters:
[in] descriptor for an rr type
Returns:
the minimum number of rdata fields

Definition at line 2017 of file rr.c.

References ldns_struct_rr_descriptor::_minimum.

size_t ldns_rr_descriptor_maximum ( const ldns_rr_descriptor descriptor  ) 

returns the maximum number of rdata fields of the rr type this descriptor describes.

Parameters:
[in] descriptor for an rr type
Returns:
the maximum number of rdata fields

Definition at line 2023 of file rr.c.

References ldns_struct_rr_descriptor::_maximum, ldns_struct_rr_descriptor::_variable, and LDNS_RDF_TYPE_NONE.

ldns_rdf_type ldns_rr_descriptor_field_type ( const ldns_rr_descriptor descriptor,
size_t  field 
)

returns the rdf type for the given rdata field number of the rr type for the given descriptor.

Parameters:
[in] descriptor for an rr type
[in] field the field number
Returns:
the rdf type for the field

Definition at line 2034 of file rr.c.

References ldns_struct_rr_descriptor::_variable, ldns_struct_rr_descriptor::_wireformat, and LDNS_RDF_TYPE_NONE.

ldns_rr_list* ldns_rr_list_subtype_by_rdf ( ldns_rr_list l,
ldns_rdf r,
size_t  pos 
)

Return the rr_list which matches the rdf at position field.

Think type-covered stuff for RRSIG

Parameters:
[in] l the rr_list to look in
[in] r the rdf to use for the comparison
[in] pos at which position can we find the rdf
Returns:
a new rr list with only the RRs that match

Definition at line 845 of file rr.c.

References ldns_rdf_compare(), ldns_rr_list_new(), ldns_rr_list_push_rr(), ldns_rr_list_rr(), ldns_rr_list_rr_count(), and ldns_rr_rdf().

ldns_rr_type ldns_rdf2rr_type ( const ldns_rdf rd  ) 

convert an rdf of type LDNS_RDF_TYPE_TYPE to an actual LDNS_RR_TYPE.

This is usefull in the case when inspecting the rrtype covered field of an RRSIG.

Parameters:
[in] rd the rdf to look at
Returns:
a ldns_rr_type with equivalent LDNS_RR_TYPE

Definition at line 2107 of file rr.c.

References ldns_rdf2native_int16(), ldns_rdf_get_type(), and LDNS_RDF_TYPE_TYPE.


Generated on Sun Dec 2 07:36:03 2007 for ldns by  doxygen 1.4.7