m�
�XQc@sg
dZd
k
lZ
dkZdkZdkZdkZdkZdk	Zdk
ZdkZdkZdk
ZdkZdkZdeiif
d��YZdef
d��YZdef
d��YZd	ef
d
��YZdef
d��YZd
ef
d��YZeeiieeeeed�Zeeiieeeeed�Zeeed�Z dS(s
DNS Zones.(
s
generatorsNtBadZonec
BstZ
dZRS(
sThe zone is malformed.(t__name__t
__module__t__doc__(((t,/usr/lib/python2.4/site-packages/dns/zone.pyR#s
tNoSOAc
BstZ
dZRS(
s%The zone has no SOA RR at its origin.(R
RR(((RR's
tNoNSc
BstZ
dZRS(
s'The zone has no NS RRset at its origin.(R
RR(((RR+s
t
UnknownOriginc
BstZ
dZRS(
sThe zone's origin is unknown.(R
RR(((RR/s
tZonecBs�
tZ
dZeiiZd
dddgZeii	e
d�Zd�Zd�Z
d�Zd	�Zd
�Zd�Zd�Zd
�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Zed�
Zed�
Zd�Zeii ed�Z!eii ed�Z"eii d�
Z#d�Z$eii d�
Z%eii d�
Z&eii'eii d�Z(eii'eii d�Z)e
e
e*d �Z+d!�Z,RS("sZA DNS zone.

    A Zone is a mapping from names to nodes.  The zone object may be
    treated like a Python dictionary, e.g. zone[name] will retrieve
    the node associated with that name.  The I{name} may be a
    dns.name.Name object, or it may be a string.  In the either case,
    if the name is relative it is treated as relative to the origin of
    the zone.

    @ivar rdclass: The zone's rdata class; the default is class IN.
    @type rdclass: int
    @ivar origin: The origin of the zone.
    @type origin: dns.name.Name object
    @ivar nodes: A dictionary mapping the names of nodes in the zone to the
    nodes themselves.
    @type nodes: dict
    @ivar relativize: should names in the zone be relativized?
    @type relativize: bool
    @cvar node_factory: the factory used to create a new node
    @type node_factory: class or callable
    trdclasstorigintnodest
relativizecCs(||_|
|_h|_||_d
S(s�Initialize a zone object.

        @param origin: The origin of the zone.
        @type origin: dns.name.Name object
        @param rdclass: The zone's rdata class; the default is class IN.
        @type rdclass: intN(R	tselfR
RR(R
R
R	R((Rt__init__Ns
	
	
	
cCs]t|
t�p
tSn

|i|
ijp&
|i|
ijp
|i|
ijo
tSn

tS(siTwo zones are equal if they have the same origin, class, and
        nodes.
        @rtype: bool
        N(	t
isinstancetotherRtFalseR
R	R
RtTrue(R
R((Rt__eq__[s

9
cCs|i
|
�
S(s6Are two zones not equal?
        @rtype: bool
        N(R
RR(R
R((Rt__ne__iscCs�t|
ttf�o
ti
i|
d�}
n'
t|
ti
i�p
td
�
�
n

|
i	�oG
|
i
|i�
p
td�
�
n

|i
o
|
i
|i�
}
q�
n

|
S(Ns0name parameter must be convertable to a DNS names5name parameter must be a subdomain of the zone origin(Rtnametstrtunicodetdnst	from_texttNonetNametKeyErrortis_absolutetis_subdomainR
R
R(R
R((Rt_validate_nameps











cCs|i
|
�
}
|i|
S(
N(R
RtkeyR(R
R ((Rt__getitem__|s

cCs |i
|
�
}
||i|
<dS(
N(R
RR tvalueR(R
R R"((Rt__setitem__�s

cCs|i
|
�
}
|i|
=dS(
N(R
RR R(R
R ((Rt__delitem__�s

c


Cs
|i
i�S(
N(R
Rtiterkeys(
R
((Rt__iter__�s
c


Cs
|i
i�S(
N(R
RR%(
R
((RR%�s
c


Cs
|i
i�S(
N(R
Rtkeys(
R
((RR'�s
c


Cs
|i
i�S(
N(R
Rt
itervalues(
R
((RR(�s
c


Cs
|i
i�S(
N(R
Rtvalues(
R
((RR)�s
c


Cs
|i
i�S(
N(R
Rt	iteritems(
R
((RR*�s
c


Cs
|i
i�S(
N(R
Rtitems(
R
((RR+�s
cCs|i
|
�
}
|ii|
�
S(
N(R
RR Rtget(R
R ((RR,�s

cCs
|
|ijS(
N(RR
R(R
R((Rt__contains__�s
cCs`|i
|
�
}
|ii|
�
}|d
jo.
|p

t�
n

|i	�}||i|
<n

|S(sr
Find a node in the zone, possibly creating it.

        @param name: the name of the node to find
        @type name: dns.name.Name object or string
        @param create: should the node be created if it doesn't exist?
        @type create: bool
        @raises KeyError: the name is not known and create was not specified.
        @rtype: dns.node.Node object
        N(
R
RRRR,tnodeRtcreateRtnode_factory(R
RR/R.((Rt	find_node�s	








cCs6y|i
|
|�}Wntj
o




d
}n
X|S(s�
Get a node in the zone, possibly creating it.

        This method is like L{find_node}, except it returns None instead
        of raising an exception if the node does not exist and creation
        has not been requested.

        @param name: the name of the node to find
        @type name: dns.name.Name object or string
        @param create: should the node be created if it doesn't exist?
        @type create: bool
        @rtype: dns.node.Node object or None
        N(R
R1RR/R.RR(R
RR/R.((Rtget_node�s



cCs4|i
|
�
}
|ii|
�
o
|i|
=n

d
S(shDelete the specified node if it exists.

        It is not an error if the node does not exist.
        N(R
RRRthas_key(R
R((Rtdelete_node�s

cCs�|i
|
�
}
t|ttf�o
tii	|�
}n

t|ttf�o
tii	|�
}n

|i|
|�}|i|i|||�S(s�Look for rdata with the specified name and type in the zone,
        and return an rdataset encapsulating it.

        The I{name}, I{rdtype}, and I{covers} parameters may be
        strings, in which case they will be converted to their proper
        type.

        The rdataset returned is not a copy; changes to it will change
        the zone.

        KeyError is raised if the name or type are not found.
        Use L{get_rdataset} if you want to have None returned instead.

        @param name: the owner name to look for
        @type name: DNS.name.Name object or string
        @param rdtype: the rdata type desired
        @type rdtype: int or string
        @param covers: the covered type (defaults to None)
        @type covers: int or string
        @param create: should the node and rdataset be created if they do not
        exist?
        @type create: bool
        @raises KeyError: the node or rdata could not be found
        @rtype: dns.rrset.RRset object
        N(R
RRRtrdtypeRRRt	rdatatypeRtcoversR1R/R.t
find_rdatasetR	(R
RR5R7R/R.((RR8�s





cCs<y|i
|
|||�}Wntj
o




d
}n
X|S(s�Look for rdata with the specified name and type in the zone,
        and return an rdataset encapsulating it.

        The I{name}, I{rdtype}, and I{covers} parameters may be
        strings, in which case they will be converted to their proper
        type.

        The rdataset returned is not a copy; changes to it will change
        the zone.

        None is returned if the name or type are not found.
        Use L{find_rdataset} if you want to have KeyError raised instead.

        @param name: the owner name to look for
        @type name: DNS.name.Name object or string
        @param rdtype: the rdata type desired
        @type rdtype: int or string
        @param covers: the covered type (defaults to None)
        @type covers: int or string
        @param create: should the node and rdataset be created if they do not
        exist?
        @type create: bool
        @rtype: dns.rrset.RRset object
        N(	R
R8RR5R7R/trdatasetRR(R
RR5R7R/R9((Rtget_rdataset�s



cCs�|i
|
�
}
t|ttf�o
tii	|�
}n

t|ttf�o
tii	|�
}n

|i|
�
}|dj	o>
|i|i||�
t|�
d
jo
|i|
�

q�
n

dS(s�Delete the rdataset matching I{rdtype} and I{covers}, if it
        exists at the node specified by I{name}.

        The I{name}, I{rdtype}, and I{covers} parameters may be
        strings, in which case they will be converted to their proper
        type.

        It is not an error if the node does not exist, or if there is no
        matching rdataset at the node.

        If the node has no rdatasets after the deletion, it will itself
        be deleted.

        @param name: the owner name to look for
        @type name: DNS.name.Name object or string
        @param rdtype: the rdata type desired
        @type rdtype: int or string
        @param covers: the covered type (defaults to None)
        @type covers: int or string
        iN(R
RRRR5RRRR6RR7R2R.Rtdelete_rdatasetR	tlenR4(R
RR5R7R.((RR;
s









cCsF|i
|i
jo
td
�
�
n

|i|
t�}|i|�

dS(s:Replace an rdataset at name.

        It is not an error if there is no rdataset matching I{replacement}.

        Ownership of the I{replacement} object is transferred to the zone;
        in other words, this method does not store a copy of I{replacement}
        at the node, it stores I{replacement} itself.

        If the I{name} node does not exist, it is created.

        @param name: the owner name
        @type name: DNS.name.Name object or string
        @param replacement: the replacement rdataset
        @type replacement: dns.rdataset.Rdataset
        s#replacement.rdclass != zone.rdclassN(	treplacementR	R
t
ValueErrorR1RRR.treplace_rdataset(R
RR=R.((RR?<
s



cCs�|i
|
�
}
t|ttf�o
tii	|�
}n

t|ttf�o
tii	|�
}n

|i|
i|i
||�}tii|
|i
||�}|i|�

|S(s�Look for rdata with the specified name and type in the zone,
        and return an RRset encapsulating it.

        The I{name}, I{rdtype}, and I{covers} parameters may be
        strings, in which case they will be converted to their proper
        type.

        This method is less efficient than the similar
        L{find_rdataset} because it creates an RRset instead of
        returning the matching rdataset.  It may be more convenient
        for some uses since it returns an object which binds the owner
        name to the rdata.

        This method may not be used to create new nodes or rdatasets;
        use L{find_rdataset} instead.

        KeyError is raised if the name or type are not found.
        Use L{get_rrset} if you want to have None returned instead.

        @param name: the owner name to look for
        @type name: DNS.name.Name object or string
        @param rdtype: the rdata type desired
        @type rdtype: int or string
        @param covers: the covered type (defaults to None)
        @type covers: int or string
        @raises KeyError: the node or rdata could not be found
        @rtype: dns.rrset.RRset object
        N(R
RRRR5RRRR6RR7RR8R	R9trrsettRRsettupdate(R
RR5R7R9R@((Rt
find_rrsetR
s








cCs9y|i
|
||�}Wntj
o




d
}n
X|S(sJLook for rdata with the specified name and type in the zone,
        and return an RRset encapsulating it.

        The I{name}, I{rdtype}, and I{covers} parameters may be
        strings, in which case they will be converted to their proper
        type.

        This method is less efficient than the similar L{get_rdataset}
        because it creates an RRset instead of returning the matching
        rdataset.  It may be more convenient for some uses since it
        returns an object which binds the owner name to the rdata.

        This method may not be used to create new nodes or rdatasets;
        use L{find_rdataset} instead.

        None is returned if the name or type are not found.
        Use L{find_rrset} if you want to have KeyError raised instead.

        @param name: the owner name to look for
        @type name: DNS.name.Name object or string
        @param rdtype: the rdata type desired
        @type rdtype: int or string
        @param covers: the covered type (defaults to None)
        @type covers: int or string
        @rtype: dns.rrset.RRset object
        N(R
RCRR5R7R@RR(R
RR5R7R@((Rt	get_rrsetz
s



ccs�t|
ttf�o
tii|
�
}
n

t|ttf�o
tii|�
}n

xl|i	�D]^\}}xO|D]G}|
tii
jp 
|i
|
jo
|i|jo
||fVqx
qxWqeWd
S(s�
Return a generator which yields (name, rdataset) tuples for
        all rdatasets in the zone which have the specified I{rdtype}
        and I{covers}.  If I{rdtype} is dns.rdatatype.ANY, the default,
        then all rdatasets will be matched.

        @param rdtype: int or string
        @type rdtype: int or string
        @param covers: the covered type (defaults to None)
        @type covers: int or string
        N(RR5RRRR6RR7R
R*RR.trdstANY(R
R5R7R.RER((Rtiterate_rdatasets�
s






3ccs�t|
ttf�o
tii|
�
}
n

t|ttf�o
tii|�
}n

x�|i	�D]u\}}xf|D]^}|
tii
jp 
|i
|
jo5
|i|jo%
x"|D]}||i|fVq�Wqx
qxWqeWd
S(s�
Return a generator which yields (name, ttl, rdata) tuples for
        all rdatas in the zone which have the specified I{rdtype}
        and I{covers}.  If I{rdtype} is dns.rdatatype.ANY, the default,
        then all rdatas will be matched.

        @param rdtype: int or string
        @type rdtype: int or string
        @param covers: the covered type (defaults to None)
        @type covers: int or string
        N(RR5RRRR6RR7R
R*RR.RERFtrdatatttl(R
R5R7R.RERHR((Rtiterate_rdatas�
s






3
cCs"
ti
d
jo

t}n
t}|djo

d}	n
d}	t|
|�o
t
|
|	�}
t}n
t
}z�|o
|i�}|i�
n

|i�}xe|D]]}||i|d|id|�
}
|djo
|
|
IJq�
|
i|
�

|
i|�

q�WWd|o
|
i�
n

XdS(sWrite a zone to a file.

        @param f: file or string.  If I{f} is a string, it is treated
        as the name of a file to open.
        @param sorted: if True, the file will be written with the
        names sorted in DNSSEC order from least to greatest.  Otherwise
        the names will be written in whatever order they happen to have
        in the zone's dictionary.
        @param relativize: if True, domain names in the output will be
        relativized to the zone's origin (if possible).
        @type relativize: bool
        @param nl: The end of line string.  If not specified, the
        output will use the platform's native end-of-line marker (i.e.
        LF on POSIX, CRLF on Windows, CR on Macintosh).
        @type nl: string or None
        it
wtwbR
RN(tsyst
hexversiont
basestringtstr_typeRtnlRtoptsRt
ftfileRt
want_closeRtsortedR
R'tnamestsortR%t
ntto_textR
Rt
ltwritetclose(R
RSRVRRQRPRYRURWRRR[((Rtto_file�
s6























c
Csy|i
o
tii}
n

|i}
|i|
tii�d
jo

t
�
n

|i|
tii�d
jo

t�
n

d
S(s�Do some simple checking of the zone's origin.

        @raises dns.zone.NoSOA: there is no SOA RR
        @raises dns.zone.NoNS: there is no NS RRset
        @raises KeyError: there is no origin node
        N(
R
RRRtemptyR
R:R6tSOARRtNSR(R
R((Rtcheck_origin�
s


	




(-R
RRRR.tNodeR0t	__slots__t
rdataclasstINRRRRRR!R#R$R&R%R'R(R)R*R+R,R-RR1R2R4R6tNONER8R:R;R?RCRDRFRGRJRR^Rb(((RR3s@
																
$!!	("2t
_MasterReadercBsMtZ
dZeeed
�Zd�Zd�Zd�Z	d�Z
d�ZRS(s�Read a DNS master file

    @ivar tok: The tokenizer
    @type tok: dns.tokenizer.Tokenizer object
    @ivar ttl: The default TTL
    @type ttl: int
    @ivar last_name: The last name read
    @type last_name: dns.name.Name object
    @ivar current_origin: The current origin
    @type current_origin: dns.name.Name object
    @ivar relativize: should names in the zone be relativized?
    @type relativize: bool
    @ivar zone: the zone
    @type zone: dns.zone.Zone object
    @ivar saved_state: saved reader state (used when processing $INCLUDE)
    @type saved_state: list of (tokenizer, current_origin, last_name, file)
    tuples.
    @ivar current_file: the file object of the $INCLUDed file being parsed
    (None if no $INCLUDE is active).
    @ivar allow_include: is $INCLUDE allowed?
    @type allow_include: bool
    @ivar check_origin: should sanity checks of the origin node be done?
    The default is True.
    @type check_origin: bool
    cCs�t|ttf�o
tii|�
}n

|
|_||_	||_
d
|_d|_
|||d|�
|_g|_d|_||_||_dS(NiR(RR
RRRRRttokR
tcurrent_originRRIRt	last_nametzone_factoryR	tzonetsaved_statetcurrent_filet
allow_includeRb(R
RiR
R	RRlRpRb((RR)s

	
	
	
	
	

	
	
	
c

Cs-x&|i
i�}
|
i�o
Pq
q
WdS(Ni
(R
RiR,ttokent
is_eol_or_eof(R
Rq((Rt	_eat_line8s





c
Cs�|i
djo

t�
n

|iid
t�
}|i�p"
t	i
i|i|i
�|_
n5
|ii�}|i�o
dSn

|ii|�

|i
}|i|ii�
p
|i�
dSn

|io
|i|ii�
}n

|ii�}|i�p
t	ii�
n

yEt	ii|i�
}	|ii�}|i�p
t	ii�
n

Wn"t	iij
o



|i}	n
XyEt	ii|i�
}|ii�}|i�p
t	ii�
n

Wn7t	iij
o



t	ii�
n



|ii}n
X||iijo
t	iid�
�
n

yt	ii|i�
}
Wn 


t	iid|i�
�
n
X|iii|�
}|djo#
|ii �}||ii|<n

y(t	i!i||
|i|i
t"�}Wnyt	iij
o#



t$i%�d \}}
|
�
nF



t$i%�d \}}
t	iidt(|�
t(|
�
f�
�
n
X|i)|ii|i�
|i*�}|i+||
|t�}|i-||	�
dS(s(Process one line from a DNS master file.twant_leadingNsRR class is not zone's classsunknown rdatatype '%s'iscaught exception %s: %s(.R
RjRRRiR,RRqt
is_whitespaceRRRR"RkRrtungetRRmR
RsRt
is_identifiert	exceptiontSyntaxErrorRItBadTTLReR	R6R5RRYR0RHRtrdRMtexc_infottytvaRtchoose_relativityR7R8REtadd(R
R5RRER}R7RYR{RqRIR~R	((Rt_rr_line>st






"



	












































,


c
Cs�
ti
d
�
}ti
d�
}
ti
d�
}|i|
�
}|o6
|i�\}	}}}}|djo

d}qy
n

|
i|
�
}|o<
|i�\}	}}|djo

d}n

d}d}n

|i|
�
}|oI
|i�\}	}}}|djo

d}n

|i�d}d}n

|p
|p
|p"
d}	d}d}d}d}n

|djo

t�
n

|	||||fS(	Ns"^.*\$({(\+|-?)(\d+),(\d+),(.)}).*$s^.*\$({(\+|-?)(\d+)}).*$s^.*\$({(\+|-?)(\d+),(\d+)}).*$tt
+it
di(tretcompiletis_generate1tis_generate2tis_generate3tmatchtsidetg1tgroupstmodtsigntoffsettwidthtbasetg2tg3tNotImplemented(
R
R�R�R�R�R�R�R�R�R�R�R�R�((Rt
_parse_modify�s>



































c
!Csb|i
djo

t�
n

|ii�}yNtii	|i
�
\}}}|ii�}|i�p
tii�
n

Wn


tii�
n
Xy9|i
}|ii�}|i�p
tii�
n

Wn


tii�
n
XyEtii	|i
�
}|ii�}|i�p
tii�
n

Wn"tiij
o



|i}n
XyEtii	|i
�
}|ii�}|i�p
tii�
n

Wn7tiij
o



tii�
n



|ii}n
X||iijo
tiid
�
�
n

yEtii	|i
�
}	|ii�}|i�p
tii�
n

Wn 


tiid|i
�
�
n
Xy
|i
}Wn


tii�
n
X|i|�
\}}}}} |i|�
\}}}}}x�t%||d|�D]�}|djo
|t'|�
}n"
|djo
|t'|�
}n

|djo
|t'|�
}n"
|djo
|t'|�
}n

t*|�
i+t'|�
�
}t*|�
i+t'|�
�
}|i.d||�}|i.d||�}ti/i	||i
�|_1|i1}|i2|ii3�
p
|i4�
dSn

|i5o
|i5|ii3�
}n

|ii6i|�
}|djo#
|ii8�}||ii6|<n

y%ti0i	||	||i
t9�}
Wnytiij
o#



t;i<�d \}
}
|
�
nF



t;i<�d \}
}
tiid	t*|
�
t*|
�
f�
�
n
X|
i?|ii3|i5�
|
i@�}|iA||	|tB�}|iD|
|�
q�WdS(
sRProcess one line containing the GENERATE statement from a DNS
        master file.sRR class is not zone's classsunknown rdatatype '%s'i
R�t
-s$%sNiscaught exception %s: %s(ER
RjRRRiR,RqRtgrangeRR"tstarttstoptstepRwRxRytlhsRIRzReR	RmR6R5trhsR�tlmodtlsigntloffsettlwidthtlbasetrmodtrsigntroffsettrwidthtrbasetranget
itinttlindextrindexRtzfilltlzfindextrzfindextreplaceRRHRkRR
RsRRRYR0RR{RMR|R}R~RR7R8RRER�(!R
R~R�R�R�R7R�RIR�R5R}R�R�R{R�R�R�R�R�R�R�RHRR�R�R	RER�R�RYRqR�R�((Rt_generate_line�s�










	

















































	


















,


c
Cs�yx|i
itt�i�}|i�os
|idj	o
|ii	�
n

t
|i�
djo7
|iid�
\|_
|_
|_|_|_qn

Pn^
|i�o
qnJ
|i�o
|i
i�
qn)
|iddjo
|ii�}|djo[
|i
i�}|i�p
tiid�
�
n

tii|i�
|_|i
i�
q
|djoI
|i
i�|_
|i
i�
|iidjo
|i
|i_q�
q
|djo�
|io�
|i
i�}|i}|i
i�}|i�o,
ti i|i|i
�}|i
i�
n-
|i"�p
tiid	�
�
n

|i
}|ii#|i
|i
|i|i|if�

t$|d
�|_ti%i&|i|�|_
||_
q
|djo
|i'�
q
tiid|d
�
�
qn

|i
i(|�

|i)�
q
WWnftiij
oT

}
|i
i+�\}}
|djo

d}n

tiid||
|f�
�
n
X|i-o
|ii-�
n

dS(s�Read a DNS master file and build a zone object.

        @raises dns.zone.NoSOA: No SOA RR was found at the zone origin
        @raises dns.zone.NoNS: No NS RRset was found at the zone origin
        i
ii����t
$s$TTLsbad $TTLs$ORIGINs$INCLUDEsbad origin in $INCLUDEt
rs	$GENERATEsUnknown master file directive 't
'ssyntax errors	%s:%d: %sN(.R
RiR,RtunescapeRqtis_eofRoRR]R<RntpopRjRkRItis_eolt
is_commenttget_eolR"tuppert
uRwRRxRyRtget_nameRmR
RptfilenameRt
new_originRrtappendRTt	tokenizert	TokenizerR�RvR�tdetailtwheretline_numberRb(R
R�R�R�R�RqR�((Rtread'sv







0




























	








	
.
















$

(R
RRRRRRRsR�R�R�R�(((RRhs		I	)	wc

Csa|djo

d
}n

tii||�}t||
|||d|d|�}	|	i�
|	iS(srBuild a zone object from a master file format string.

    @param text: the master file format input
    @type text: string.
    @param origin: The origin of the zone; if not specified, the first
    $ORIGIN statement in the master file will determine the origin of the
    zone.
    @type origin: dns.name.Name object or string
    @param rdclass: The zone's rdata class; the default is class IN.
    @type rdclass: int
    @param relativize: should names be relativized?  The default is True
    @type relativize: bool
    @param zone_factory: The zone factory to use
    @type zone_factory: function returning a Zone
    @param filename: The filename to emit when describing where an error
    occurred; the default is '<string>'.
    @type filename: string
    @param allow_include: is $INCLUDE allowed?
    @type allow_include: bool
    @param check_origin: should sanity checks of the origin node be done?
    The default is True.
    @type check_origin: bool
    @raises dns.zone.NoSOA: No SOA RR was found at the zone origin
    @raises dns.zone.NoNS: No NS RRset was found at the zone origin
    @rtype: dns.zone.Zone object
    s<string>RpRbN(R�RRR�R�ttextRiRhR
R	RRlRpRbtreaderR�Rm(
R�R
R	RRlR�RpRbRiR�((RRts









c	Cs�ti
d
jo
t}
d}n

t}
d}t||
�o0
|djo

|}n

t
||�}t}	n
|djo

d}n

t
}	z%t||
||||||�}Wd|	o
|i�
n

X|S(s�Read a master file and build a zone object.

    @param f: file or string.  If I{f} is a string, it is treated
    as the name of a file to open.
    @param origin: The origin of the zone; if not specified, the first
    $ORIGIN statement in the master file will determine the origin of the
    zone.
    @type origin: dns.name.Name object or string
    @param rdclass: The zone's rdata class; the default is class IN.
    @type rdclass: int
    @param relativize: should names be relativized?  The default is True
    @type relativize: bool
    @param zone_factory: The zone factory to use
    @type zone_factory: function returning a Zone
    @param filename: The filename to emit when describing where an error
    occurred; the default is '<file>', or the value of I{f} if I{f} is a
    string.
    @type filename: string
    @param allow_include: is $INCLUDE allowed?
    @type allow_include: bool
    @param check_origin: should sanity checks of the origin node be done?
    The default is True.
    @type check_origin: bool
    @raises dns.zone.NoSOA: No SOA RR was found at the zone origin
    @raises dns.zone.NoNS: No NS RRset was found at the zone origin
    @rtype: dns.zone.Zone object
    itrUR�s<file>N(RMRNRORPRRRRRSR�RRTRRURRR
R	RRlRpRbt
zR](RSR
R	RRlR�RpRbR�RURPRR((Rt	from_file�s*




















cCs<
d}x
|D]
}
|djoM
|o

|
i}n
|
id
i}|
id
i}|
||d|�
}n

x�|
iD]�}|ii|i�
}|p 
|i�}||i|i<n

|i|i|i|it�}|i|i�

x.|D]&}	|	i|i|�
|i|	�

q�WqwWq
W|o
|i�
n

|S(s�Convert the output of a zone transfer generator into a zone object.

    @param xfr: The xfr generator
    @type xfr: generator of dns.message.Message objects
    @param relativize: should names be relativized?  The default is True.
    It is essential that the relativize setting matches the one specified
    to dns.query.xfr().
    @type relativize: bool
    @param check_origin: should sanity checks of the origin node be done?
    The default is True.
    @type check_origin: bool
    @raises dns.zone.NoSOA: No SOA RR was found at the zone origin
    @raises dns.zone.NoNS: No NS RRset was found at the zone origin
    @rtype: dns.zone.Zone object
    iRN(RR�txfrR�RR
tanswerRR	RlR@RR,tznodeR0R8R5R7Rtzrdst
update_ttlRIR{RR�Rb(R�RlRRbR
R�R	R�R�R{R�R@((Rtfrom_xfr�s4






















(!Rt
__future__t
generatorsRMR�t
dns.exceptionRtdns.nametdns.nodetdns.rdataclasst
dns.rdatatypet	dns.rdatat	dns.rrsett
dns.tokenizertdns.ttlt
dns.grangeRxtDNSExceptionRRRRtobjectRRhRReRfRRRR�R�(
R�RhRR�RRMR�RRRRR�R((Rt
?s0
	
		
	
	
	
	
	
	
	
	
	���g$+$8