Na}{

File Content: `rcode.py`

# Copyright (C) 2001-2007, 2009-2011 Nominum, Inc.
#
# Permission to use, copy, modify, and distribute this software and its
# documentation for any purpose with or without fee is hereby granted,
# provided that the above copyright notice and this permission notice
# appear in all copies.
#
# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES
# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR
# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
# OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

"""DNS Result Codes."""

import dns.exception
from ._compat import long


NOERROR = 0
FORMERR = 1
SERVFAIL = 2
NXDOMAIN = 3
NOTIMP = 4
REFUSED = 5
YXDOMAIN = 6
YXRRSET = 7
NXRRSET = 8
NOTAUTH = 9
NOTZONE = 10
BADVERS = 16

_by_text = {
    'NOERROR': NOERROR,
    'FORMERR': FORMERR,
    'SERVFAIL': SERVFAIL,
    'NXDOMAIN': NXDOMAIN,
    'NOTIMP': NOTIMP,
    'REFUSED': REFUSED,
    'YXDOMAIN': YXDOMAIN,
    'YXRRSET': YXRRSET,
    'NXRRSET': NXRRSET,
    'NOTAUTH': NOTAUTH,
    'NOTZONE': NOTZONE,
    'BADVERS': BADVERS
}

# We construct the inverse mapping programmatically to ensure that we
# cannot make any mistakes (e.g. omissions, cut-and-paste errors) that
# would cause the mapping not to be a true inverse.

_by_value = dict((y, x) for x, y in _by_text.items())


class UnknownRcode(dns.exception.DNSException):

    """A DNS rcode is unknown."""


def from_text(text):
    """Convert text into an rcode.

    @param text: the textual rcode
    @type text: string
    @raises UnknownRcode: the rcode is unknown
    @rtype: int
    """

    if text.isdigit():
        v = int(text)
        if v >= 0 and v <= 4095:
            return v
    v = _by_text.get(text.upper())
    if v is None:
        raise UnknownRcode
    return v


def from_flags(flags, ednsflags):
    """Return the rcode value encoded by flags and ednsflags.

    @param flags: the DNS flags
    @type flags: int
    @param ednsflags: the EDNS flags
    @type ednsflags: int
    @raises ValueError: rcode is < 0 or > 4095
    @rtype: int
    """

    value = (flags & 0x000f) | ((ednsflags >> 20) & 0xff0)
    if value < 0 or value > 4095:
        raise ValueError('rcode must be >= 0 and <= 4095')
    return value


def to_flags(value):
    """Return a (flags, ednsflags) tuple which encodes the rcode.

    @param value: the rcode
    @type value: int
    @raises ValueError: rcode is < 0 or > 4095
    @rtype: (int, int) tuple
    """

    if value < 0 or value > 4095:
        raise ValueError('rcode must be >= 0 and <= 4095')
    v = value & 0xf
    ev = long(value & 0xff0) << 20
    return (v, ev)


def to_text(value):
    """Convert rcode into text.

    @param value: the rcode
    @type value: int
    @rtype: string
    """

    text = _by_value.get(value)
    if text is None:
        text = str(value)
    return text

Name	Size	Permission
__pycache__	---	0755
rdtypes	---	0755
__init__.py	1327 bytes	0644
_compat.py	1313 bytes	0644
dnssec.py	14791 bytes	0644
e164.py	3147 bytes	0644
edns.py	4384 bytes	0644
entropy.py	4465 bytes	0644
exception.py	4626 bytes	0644
flags.py	2664 bytes	0644
grange.py	1973 bytes	0644
hash.py	1100 bytes	0644
inet.py	3242 bytes	0644
ipv4.py	2031 bytes	0644
ipv6.py	5293 bytes	0644
message.py	43129 bytes	0644
name.py	29425 bytes	0644
namedict.py	3677 bytes	0644
node.py	6056 bytes	0644
opcode.py	2538 bytes	0644
query.py	19645 bytes	0644
rcode.py	3104 bytes	0644
rdata.py	14997 bytes	0644
rdataclass.py	3258 bytes	0644
rdataset.py	11556 bytes	0644
rdatatype.py	5339 bytes	0644
renderer.py	11923 bytes	0644
resolver.py	52105 bytes	0644
reversename.py	3311 bytes	0644
rrset.py	5995 bytes	0644
set.py	7715 bytes	0644
tokenizer.py	18313 bytes	0644
tsig.py	7718 bytes	0644
tsigkeyring.py	1737 bytes	0644
ttl.py	2283 bytes	0644
update.py	10012 bytes	0644
version.py	1258 bytes	0644
wiredata.py	3731 bytes	0644
zone.py	40026 bytes	0644

File Content: rcode.py

File Content: `rcode.py`