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