dnsjit.core.object.dns.label(3)

NAME
dnsjit.core.object.dns.label - Container of a DNS label

DESCRIPTION
The object that describes a DNS label. To extract a domain name label first check that have_dn is set, then use offset + 1 to indicate where in the payload the label start and length for how many bytes long it is.

  Attributes

is_end

have_length
    Set if there is a length.

have_offset
    Set if there is an offset.

have_extension_bits
    Set if there is extension bits.

have_dn
    Set if the label contained a domain name.

extension_bits
    The extension bits.

length
    The length of the domain name.

offset
    If have_dn is set then this contains the offset within the payload to where this label start otherwise it contains the offset to another label.

  Functions

Label.new(size)
    Create a new array of labels.

Label.tostring(dns, labels, num_labels, offset_labels)
    Returns labels as a string and an offset to the next label. Takes argument labels, an array of labels returned by any of the parse functions, and num_labels, number of labels in the array. Optional offset_labels can be used to skip labels at the start. The return string may be nil if the first label was an offset. The return offset may be nil if the last label was an extension bits or end marker.

Label.torfc1035(dns, labels, num_labels, offset_labels)
    Returns a RFC1035 domain name of the labels and an offset to the next label. Takes argument labels, an array of labels returned by any of the parse functions, and num_labels, number of labels in the array. Optional offset_labels can be used to skip labels at the start. The return string may be nil if the first label was an offset. The return offset may be nil if the last label was an extension bits or end marker.

Label.tooffstr(dns, labels, num_labels, offset_labels)
    Returns labels as a string which also includes a textual notation of the offset in the form of <offset>label. Takes argument labels, an array of labels returned by any of the parse functions, and num_labels, number of labels in the array. Optional offset_labels can be used to skip labels at the start.

SEE ALSO
dnsjit.core.object.dns(3)

AUTHORS and CONTRIBUTORS
Jerry Lundström (DNS-OARC), Tomáš Křížek (CZ.NIC), Petr Špaček (ISC)

Maintained by DNS-OARC

    https://www.dns-oarc.net/

BUGS
For issues and feature requests please use:

    https://github.com/DNS-OARC/dnsjit/issues

For question and help please use:

    admin@dns-oarc.net