ldns_struct_rr Struct Reference

Resource Record. More...

Data Fields

ldns_rdf_owner
 Owner name, uncompressed.
uint32_t _ttl
 Time to live.
size_t _rd_count
 Number of data fields.
ldns_rr_type _rr_type
 the type of the RR.
ldns_rr_class _rr_class
 Class of the resource record.
ldns_rdf ** _rdata_fields
 The array of rdata's.
bool _rr_question
 question rr [it would be nicer if thous is after _rd_count] ABI change: Fix this in next major release

Detailed Description

Resource Record.

This is the basic DNS element that contains actual data

From RFC1035:

3.2.1. Format
All RRs have the same top level format shown below:
                                    1  1  1  1  1  1
      0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                                               |
    /                                               /
    /                      NAME                     /
    |                                               |
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                      TYPE                     |
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                     CLASS                     |
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                      TTL                      |
    |                                               |
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                   RDLENGTH                    |
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--|
    /                     RDATA                     /
    /                                               /
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
where:
NAME            an owner name, i.e., the name of the node to which this
                resource record pertains.
TYPE            two octets containing one of the RR TYPE codes.
CLASS           two octets containing one of the RR CLASS codes.
TTL             a 32 bit signed integer that specifies the time interval
                that the resource record may be cached before the source
                of the information should again be consulted.  Zero
                values are interpreted to mean that the RR can only be
                used for the transaction in progress, and should not be
                cached.  For example, SOA records are always distributed
                with a zero TTL to prohibit caching.  Zero values can
                also be used for extremely volatile data.
RDLENGTH        an unsigned 16 bit integer that specifies the length in
                octets of the RDATA field.
RDATA           a variable length string of octets that describes the
                resource.  The format of this information varies
                according to the TYPE and CLASS of the resource record.
 

The actual amount and type of rdata fields depend on the RR type of the RR, and can be found by using ldns_rr_descriptor functions.

Definition at line 278 of file rr.h.


Field Documentation

Owner name, uncompressed.

Definition at line 281 of file rr.h.

Time to live.

Definition at line 283 of file rr.h.

Number of data fields.

Definition at line 285 of file rr.h.

the type of the RR.

A, MX etc.

Definition at line 287 of file rr.h.

Class of the resource record.

Definition at line 289 of file rr.h.

The array of rdata's.

Definition at line 292 of file rr.h.

question rr [it would be nicer if thous is after _rd_count] ABI change: Fix this in next major release

Definition at line 296 of file rr.h.


Generated on 11 May 2016 for ldns by  doxygen 1.6.1