1cef7893435aa41160dd1255c43cb8498279738ccChris Craik# Copyright (C) 2003-2007, 2009, 2010 Nominum, Inc.
2cef7893435aa41160dd1255c43cb8498279738ccChris Craik#
3cef7893435aa41160dd1255c43cb8498279738ccChris Craik# Permission to use, copy, modify, and distribute this software and its
4cef7893435aa41160dd1255c43cb8498279738ccChris Craik# documentation for any purpose with or without fee is hereby granted,
5cef7893435aa41160dd1255c43cb8498279738ccChris Craik# provided that the above copyright notice and this permission notice
6cef7893435aa41160dd1255c43cb8498279738ccChris Craik# appear in all copies.
7cef7893435aa41160dd1255c43cb8498279738ccChris Craik#
8cef7893435aa41160dd1255c43cb8498279738ccChris Craik# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES
9cef7893435aa41160dd1255c43cb8498279738ccChris Craik# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10cef7893435aa41160dd1255c43cb8498279738ccChris Craik# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR
11cef7893435aa41160dd1255c43cb8498279738ccChris Craik# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12cef7893435aa41160dd1255c43cb8498279738ccChris Craik# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13cef7893435aa41160dd1255c43cb8498279738ccChris Craik# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
14cef7893435aa41160dd1255c43cb8498279738ccChris Craik# OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15cef7893435aa41160dd1255c43cb8498279738ccChris Craik
16cef7893435aa41160dd1255c43cb8498279738ccChris Craikimport struct
17cef7893435aa41160dd1255c43cb8498279738ccChris Craik
18cef7893435aa41160dd1255c43cb8498279738ccChris Craikimport dns.exception
19cef7893435aa41160dd1255c43cb8498279738ccChris Craikimport dns.rdata
20cef7893435aa41160dd1255c43cb8498279738ccChris Craikimport dns.name
21cef7893435aa41160dd1255c43cb8498279738ccChris Craik
22cef7893435aa41160dd1255c43cb8498279738ccChris Craikclass SOA(dns.rdata.Rdata):
23cef7893435aa41160dd1255c43cb8498279738ccChris Craik    """SOA record
24cef7893435aa41160dd1255c43cb8498279738ccChris Craik
25cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @ivar mname: the SOA MNAME (master name) field
26cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @type mname: dns.name.Name object
27cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @ivar rname: the SOA RNAME (responsible name) field
28cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @type rname: dns.name.Name object
29cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @ivar serial: The zone's serial number
30cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @type serial: int
31cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @ivar refresh: The zone's refresh value (in seconds)
32cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @type refresh: int
33cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @ivar retry: The zone's retry value (in seconds)
34cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @type retry: int
35cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @ivar expire: The zone's expiration value (in seconds)
36cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @type expire: int
37cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @ivar minimum: The zone's negative caching time (in seconds, called
38cef7893435aa41160dd1255c43cb8498279738ccChris Craik    "minimum" for historical reasons)
39cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @type minimum: int
40cef7893435aa41160dd1255c43cb8498279738ccChris Craik    @see: RFC 1035"""
41cef7893435aa41160dd1255c43cb8498279738ccChris Craik
42cef7893435aa41160dd1255c43cb8498279738ccChris Craik    __slots__ = ['mname', 'rname', 'serial', 'refresh', 'retry', 'expire',
43cef7893435aa41160dd1255c43cb8498279738ccChris Craik                 'minimum']
44cef7893435aa41160dd1255c43cb8498279738ccChris Craik
45cef7893435aa41160dd1255c43cb8498279738ccChris Craik    def __init__(self, rdclass, rdtype, mname, rname, serial, refresh, retry,
46cef7893435aa41160dd1255c43cb8498279738ccChris Craik                 expire, minimum):
47cef7893435aa41160dd1255c43cb8498279738ccChris Craik        super(SOA, self).__init__(rdclass, rdtype)
48cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.mname = mname
49cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.rname = rname
50cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.serial = serial
51cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.refresh = refresh
52cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.retry = retry
53cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.expire = expire
54cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.minimum = minimum
55cef7893435aa41160dd1255c43cb8498279738ccChris Craik
56cef7893435aa41160dd1255c43cb8498279738ccChris Craik    def to_text(self, origin=None, relativize=True, **kw):
57cef7893435aa41160dd1255c43cb8498279738ccChris Craik        mname = self.mname.choose_relativity(origin, relativize)
58cef7893435aa41160dd1255c43cb8498279738ccChris Craik        rname = self.rname.choose_relativity(origin, relativize)
59cef7893435aa41160dd1255c43cb8498279738ccChris Craik        return '%s %s %d %d %d %d %d' % (
60cef7893435aa41160dd1255c43cb8498279738ccChris Craik            mname, rname, self.serial, self.refresh, self.retry,
61cef7893435aa41160dd1255c43cb8498279738ccChris Craik            self.expire, self.minimum )
62cef7893435aa41160dd1255c43cb8498279738ccChris Craik
63cef7893435aa41160dd1255c43cb8498279738ccChris Craik    def from_text(cls, rdclass, rdtype, tok, origin = None, relativize = True):
64cef7893435aa41160dd1255c43cb8498279738ccChris Craik        mname = tok.get_name()
65cef7893435aa41160dd1255c43cb8498279738ccChris Craik        rname = tok.get_name()
66cef7893435aa41160dd1255c43cb8498279738ccChris Craik        mname = mname.choose_relativity(origin, relativize)
67cef7893435aa41160dd1255c43cb8498279738ccChris Craik        rname = rname.choose_relativity(origin, relativize)
68cef7893435aa41160dd1255c43cb8498279738ccChris Craik        serial = tok.get_uint32()
69cef7893435aa41160dd1255c43cb8498279738ccChris Craik        refresh = tok.get_ttl()
70cef7893435aa41160dd1255c43cb8498279738ccChris Craik        retry = tok.get_ttl()
71cef7893435aa41160dd1255c43cb8498279738ccChris Craik        expire = tok.get_ttl()
72cef7893435aa41160dd1255c43cb8498279738ccChris Craik        minimum = tok.get_ttl()
73cef7893435aa41160dd1255c43cb8498279738ccChris Craik        tok.get_eol()
74cef7893435aa41160dd1255c43cb8498279738ccChris Craik        return cls(rdclass, rdtype, mname, rname, serial, refresh, retry,
75cef7893435aa41160dd1255c43cb8498279738ccChris Craik                   expire, minimum )
76cef7893435aa41160dd1255c43cb8498279738ccChris Craik
77cef7893435aa41160dd1255c43cb8498279738ccChris Craik    from_text = classmethod(from_text)
78cef7893435aa41160dd1255c43cb8498279738ccChris Craik
79cef7893435aa41160dd1255c43cb8498279738ccChris Craik    def to_wire(self, file, compress = None, origin = None):
80cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.mname.to_wire(file, compress, origin)
81cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.rname.to_wire(file, compress, origin)
82cef7893435aa41160dd1255c43cb8498279738ccChris Craik        five_ints = struct.pack('!IIIII', self.serial, self.refresh,
83cef7893435aa41160dd1255c43cb8498279738ccChris Craik                                self.retry, self.expire, self.minimum)
84cef7893435aa41160dd1255c43cb8498279738ccChris Craik        file.write(five_ints)
85cef7893435aa41160dd1255c43cb8498279738ccChris Craik
86cef7893435aa41160dd1255c43cb8498279738ccChris Craik    def to_digestable(self, origin = None):
87cef7893435aa41160dd1255c43cb8498279738ccChris Craik        return self.mname.to_digestable(origin) + \
88cef7893435aa41160dd1255c43cb8498279738ccChris Craik            self.rname.to_digestable(origin) + \
89cef7893435aa41160dd1255c43cb8498279738ccChris Craik            struct.pack('!IIIII', self.serial, self.refresh,
90cef7893435aa41160dd1255c43cb8498279738ccChris Craik                        self.retry, self.expire, self.minimum)
91cef7893435aa41160dd1255c43cb8498279738ccChris Craik
92cef7893435aa41160dd1255c43cb8498279738ccChris Craik    def from_wire(cls, rdclass, rdtype, wire, current, rdlen, origin = None):
93cef7893435aa41160dd1255c43cb8498279738ccChris Craik        (mname, cused) = dns.name.from_wire(wire[: current + rdlen], current)
94cef7893435aa41160dd1255c43cb8498279738ccChris Craik        current += cused
95cef7893435aa41160dd1255c43cb8498279738ccChris Craik        rdlen -= cused
96cef7893435aa41160dd1255c43cb8498279738ccChris Craik        (rname, cused) = dns.name.from_wire(wire[: current + rdlen], current)
97cef7893435aa41160dd1255c43cb8498279738ccChris Craik        current += cused
98cef7893435aa41160dd1255c43cb8498279738ccChris Craik        rdlen -= cused
99cef7893435aa41160dd1255c43cb8498279738ccChris Craik        if rdlen != 20:
100cef7893435aa41160dd1255c43cb8498279738ccChris Craik            raise dns.exception.FormError
101cef7893435aa41160dd1255c43cb8498279738ccChris Craik        five_ints = struct.unpack('!IIIII',
102cef7893435aa41160dd1255c43cb8498279738ccChris Craik                                  wire[current : current + rdlen])
103cef7893435aa41160dd1255c43cb8498279738ccChris Craik        if not origin is None:
104cef7893435aa41160dd1255c43cb8498279738ccChris Craik            mname = mname.relativize(origin)
105cef7893435aa41160dd1255c43cb8498279738ccChris Craik            rname = rname.relativize(origin)
106cef7893435aa41160dd1255c43cb8498279738ccChris Craik        return cls(rdclass, rdtype, mname, rname,
107cef7893435aa41160dd1255c43cb8498279738ccChris Craik                   five_ints[0], five_ints[1], five_ints[2], five_ints[3],
108cef7893435aa41160dd1255c43cb8498279738ccChris Craik                   five_ints[4])
109cef7893435aa41160dd1255c43cb8498279738ccChris Craik
110cef7893435aa41160dd1255c43cb8498279738ccChris Craik    from_wire = classmethod(from_wire)
111cef7893435aa41160dd1255c43cb8498279738ccChris Craik
112cef7893435aa41160dd1255c43cb8498279738ccChris Craik    def choose_relativity(self, origin = None, relativize = True):
113cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.mname = self.mname.choose_relativity(origin, relativize)
114cef7893435aa41160dd1255c43cb8498279738ccChris Craik        self.rname = self.rname.choose_relativity(origin, relativize)
115cef7893435aa41160dd1255c43cb8498279738ccChris Craik
116cef7893435aa41160dd1255c43cb8498279738ccChris Craik    def _cmp(self, other):
117cef7893435aa41160dd1255c43cb8498279738ccChris Craik        v = cmp(self.mname, other.mname)
118cef7893435aa41160dd1255c43cb8498279738ccChris Craik        if v == 0:
119cef7893435aa41160dd1255c43cb8498279738ccChris Craik            v = cmp(self.rname, other.rname)
120cef7893435aa41160dd1255c43cb8498279738ccChris Craik            if v == 0:
121cef7893435aa41160dd1255c43cb8498279738ccChris Craik                self_ints = struct.pack('!IIIII', self.serial, self.refresh,
122cef7893435aa41160dd1255c43cb8498279738ccChris Craik                                        self.retry, self.expire, self.minimum)
123cef7893435aa41160dd1255c43cb8498279738ccChris Craik                other_ints = struct.pack('!IIIII', other.serial, other.refresh,
124cef7893435aa41160dd1255c43cb8498279738ccChris Craik                                         other.retry, other.expire,
125cef7893435aa41160dd1255c43cb8498279738ccChris Craik                                         other.minimum)
126cef7893435aa41160dd1255c43cb8498279738ccChris Craik                v = cmp(self_ints, other_ints)
127cef7893435aa41160dd1255c43cb8498279738ccChris Craik        return v
128