File: //usr/lib/python2.4/site-packages/dns/message.pyc
m
ڈOc @ s d Z d k Z d k Z d k Z d k Z d k Z d k Z d k Z d k Z d k
Z d k Z d k Z d k
Z d k Z d k Z d k Z d k Z d k Z d k Z d k Z d e i i f d YZ d e i i f d YZ d e i i f d YZ d e i i f d YZ d
e i i f d YZ d e i i f d
YZ d e f d YZ d e f d YZ e! d e" e! e! e" e# e" e" e" d
Z$ d e f d YZ% d Z& d Z' e i( i) e! e" d d e! e! d Z* e" d d Z+ d S( s DNS MessagesNt ShortHeaderc B s t Z d Z RS( s< Raised if the DNS packet passed to from_wire() is too short.( t __name__t
__module__t __doc__( ( ( t/ /usr/lib/python2.4/site-packages/dns/message.pyR ' s t TrailingJunkc B s t Z d Z RS( sS Raised if the DNS packet passed to from_wire() has extra junk
at the end of it.( R R R ( ( ( R R + s t UnknownHeaderFieldc B s t Z d Z RS( s] Raised if a header field name is not recognized when converting from
text into a message.( R R R ( ( ( R R 0 s t BadEDNSc B s t Z d Z RS( sa Raised if an OPT record occurs somewhere other than the start of
the additional data section.( R R R ( ( ( R R 5 s t BadTSIGc B s t Z d Z RS( s_ Raised if a TSIG record occurs somewhere other than the end of
the additional data section.( R R R ( ( ( R R : s t UnknownTSIGKeyc B s t Z d Z RS( s/ Raised if we got a TSIG but don't know the key.( R R R ( ( ( R R ? s t Messagec B s
t Z d Z e d Z d Z d Z e e d Z d Z d Z
d Z d Z e
i i e e e d Z e
i i e e e d
Z e d d Z e d
e d d e
i i d Z d d d e e d Z e d Z d Z d Z d Z d Z RS( s,
A DNS message.
@ivar id: The query id; the default is a randomly chosen id.
@type id: int
@ivar flags: The DNS flags of the message. @see: RFC 1035 for an
explanation of these flags.
@type flags: int
@ivar question: The question section.
@type question: list of dns.rrset.RRset objects
@ivar answer: The answer section.
@type answer: list of dns.rrset.RRset objects
@ivar authority: The authority section.
@type authority: list of dns.rrset.RRset objects
@ivar additional: The additional data section.
@type additional: list of dns.rrset.RRset objects
@ivar edns: The EDNS level to use. The default is -1, no Edns.
@type edns: int
@ivar ednsflags: The EDNS flags
@type ednsflags: long
@ivar payload: The EDNS payload size. The default is 0.
@type payload: int
@ivar options: The EDNS options
@type options: list of dns.edns.Option objects
@ivar request_payload: The associated request's EDNS payload size.
@type request_payload: int
@ivar keyring: The TSIG keyring to use. The default is None.
@type keyring: dict
@ivar keyname: The TSIG keyname to use. The default is None.
@type keyname: dns.name.Name object
@ivar keyalgorithm: The TSIG algorithm to use; defaults to
dns.tsig.default_algorithm. Constants for TSIG algorithms are defined
in dns.tsig, and the currently implemented algorithms are
HMAC_MD5, HMAC_SHA1, HMAC_SHA224, HMAC_SHA256, HMAC_SHA384, and
HMAC_SHA512.
@type keyalgorithm: string
@ivar request_mac: The TSIG MAC of the request message associated with
this message; used when validating TSIG signatures. @see: RFC 2845 for
more information on TSIG fields.
@type request_mac: string
@ivar fudge: TSIG time fudge; default is 300 seconds.
@type fudge: int
@ivar original_id: TSIG original id; defaults to the message's id
@type original_id: int
@ivar tsig_error: TSIG error code; default is 0.
@type tsig_error: int
@ivar other_data: TSIG other data.
@type other_data: string
@ivar mac: The TSIG MAC for this message.
@type mac: string
@ivar xfr: Is the message being used to contain the results of a DNS
zone transfer? The default is False.
@type xfr: bool
@ivar origin: The origin of the zone in messages which are used for
zone transfers or for DNS dynamic updates. The default is None.
@type origin: dns.name.Name object
@ivar tsig_ctx: The TSIG signature context associated with this
message. The default is None.
@type tsig_ctx: hmac.HMAC object
@ivar had_tsig: Did the message decoded from wire format have a TSIG
signature?
@type had_tsig: bool
@ivar multi: Is this message part of a multi-message sequence? The
default is false. This variable is used when validating TSIG signatures
on messages which are part of a zone transfer.
@type multi: bool
@ivar first: Is this message standalone, or the first of a multi
message sequence? This variable is used when validating TSIG signatures
on messages which are part of a zone transfer.
@type first: bool
@ivar index: An index of rrsets in the message. The index key is
(section, name, rdclass, rdtype, covers, deleting). Indexing can be
disabled by setting the index to None.
@type index: dict
c C s# | d j o t i i | _ n
| | _ d | _ g | _ g | _ g | _ g | _
d | _ d | _ d | _
g | _ d | _ d | _ d | _ t i i | _ d | _ d | _ d | _ d | _ | i | _ d | _ t | _ d | _ d | _ t | _ t | _ t! | _" h | _# d S( Ni it i, ($ t idt Nonet dnst entropyt random_16t selft flagst questiont answert authorityt
additionalt ednst ednsflagst payloadt optionst request_payloadt keyringt keynamet tsigt default_algorithmt keyalgorithmt request_mact
other_datat
tsig_errort fudget original_idt mact Falset xfrt origint tsig_ctxt had_tsigt multit Truet firstt index( R R ( ( R t __init__ s:
c C s d | i
d S( Ns <DNS message, ID t >( R R ( R ( ( R t __repr__ s c C s
| i S( N( R t to_text( R ( ( R t __str__ s c K s? t i } | d | i IJ| d t i i t i i | i IJt i
i | i | i } | d t i
i | IJ| d t i i | i IJ| i
d j oY | d | i
IJ| i d j o! | d t i i | i IJn | d I| i IJn t i i | i } | o | d IJn | d
IJx* | i D] } | | i | | | IJq?W| o | d IJn | d IJx* | i D] } | | i | | | IJqW| o | d
IJn | d IJx* | i D] } | | i | | | IJqW| d IJx* | i D] } | | i | | | IJqW| i d S( s Convert the message to text.
The I{origin}, I{relativize}, and any other keyword
arguments are passed to the rrset to_wire() method.
@rtype: string
s id %ds opcode %ss rcode %ss flags %si s edns %ss eflags %sR s ;ZONEs ;QUESTIONs ;PREREQs ;ANSWERs ;UPDATEs
;AUTHORITYs ;ADDITIONALiN( t cStringIOt StringIOt sR R R t opcodeR3 t
from_flagsR t rcodeR t rcR t edns_to_textR t is_updateR t rrsetR) t
relativizet kwR R R t getvalue( R R) R? R@ R= R7 R; R> ( ( R R3 sH ) !
c C sZ t | t p t Sn | i | i j o t Sn | i | i j o t Sn x) | i D] } | | i j o t SqX qX Wx) | i D] } | | i j o t Sq q Wx) | i D] } | | i j o t Sq q Wx) | i D] } | | i j o t Sq q Wx) | i
D] } | | i
j o t SqqWx) | i
D] } | | i
j o t Sq4q4Wt S( s Two messages are equal if they have the same content in the
header, question, answer, and authority sections.
@rtype: boolN( t
isinstancet otherR
R' R R R R t nR R R- ( R RC RD ( ( R t __eq__ s@
c C s | i | S( s0 Are two messages not equal?
@rtype: boolN( R RE RC ( R RC ( ( R t __ne__ s c C s
| i t i i @d j p> | i | i j p+ t i i | i t i i | i j o t Sn t i i | i | i
t i i j o t Sn t i i
| i o t Sn x) | i D] } | | i j o t Sq q Wx) | i D] } | | i j o t Sq q Wt S( s1 Is other a response to self?
@rtype: booli N( RC R R t QRR R R8 R9 R' R: R t NOERRORR- R= R RD ( R RC RD ( ( R t is_response s X(
c C sp | | i j o d SnU | | i j o d Sn= | | i j o d Sn% | | i j o d Sn
t d d S( Ni i i i s unknown section( t sectionR R R R R t
ValueError( R RJ ( ( R t section_number s c C s | i | | | | | | f } | pt | i
d j o+ | i
i | }
|
d j o |
Sq q x6 | D]* }
|
i | | | | | o |
Sqj qj Wn | p
t n t i
i | | | | | }
| i |
| i
d j o |
| i
| <n |
S( s Find the RRset with the given attributes in the specified section.
@param section: the section of the message to look in, e.g.
self.answer.
@type section: list of dns.rrset.RRset objects
@param name: the name of the RRset
@type name: dns.name.Name object
@param rdclass: the class of the RRset
@type rdclass: int
@param rdtype: the type of the RRset
@type rdtype: int
@param covers: the covers value of the RRset
@type covers: int
@param deleting: the deleting value of the RRset
@type deleting: int
@param create: If True, create the RRset if it is not found.
The created RRset is appended to I{section}.
@type create: bool
@param force_unique: If True and create is also True, create a
new RRset regardless of whether a matching RRset exists already.
@type force_unique: bool
@raises KeyError: the RRset was not found and create was False
@rtype: dns.rrset.RRset objectN( R RL RJ t namet rdclasst rdtypet coverst deletingt keyt force_uniqueR/ R
t getR> t matcht createt KeyErrorR t RRsett append( R RJ RM RN RO RP RQ RV RS RR R> ( ( R t
find_rrset, s$ !
c
C sH y( | i | | | | | | | | } Wn t j
o
d } n X| S( s Get the RRset with the given attributes in the specified section.
If the RRset is not found, None is returned.
@param section: the section of the message to look in, e.g.
self.answer.
@type section: list of dns.rrset.RRset objects
@param name: the name of the RRset
@type name: dns.name.Name object
@param rdclass: the class of the RRset
@type rdclass: int
@param rdtype: the type of the RRset
@type rdtype: int
@param covers: the covers value of the RRset
@type covers: int
@param deleting: the deleting value of the RRset
@type deleting: int
@param create: If True, create the RRset if it is not found.
The created RRset is appended to I{section}.
@type create: bool
@param force_unique: If True and create is also True, create a
new RRset regardless of whether a matching RRset exists already.
@type force_unique: bool
@rtype: dns.rrset.RRset object or NoneN(
R RZ RJ RM RN RO RP RQ RV RS R> RW R
(
R RJ RM RN RO RP RQ RV RS R> ( ( R t get_rrsetZ s i c K s | d j o' | i d j o
| i } q4 d } n | d j o
d } n | d j o
d } n t i i | i | i | | } x- | i
D]" } | i | i
| i | i q Wx* | i D] } | i t i i | | q Wx* | i D] } | i t i i | | q W| i d j o& | i | i | i | i | i n x* | i D] } | i t i i | | qMW| i | i d j oQ | i | i | i! | i | i" | i# | i$ | i% | i& | i' | i( | _( n | i) S( s7 Return a string containing the message in DNS compressed wire
format.
Additional keyword arguments are passed to the rrset to_wire()
method.
@param origin: The origin to be appended to any relative names.
@type origin: dns.name.Name object
@param max_size: The maximum size of the wire format output; default
is 0, which means 'the message's request payload, if nonzero, or
65536'.
@type max_size: int
@raises dns.exception.TooBig: max_size was exceeded
@rtype: string
i i i N(* t max_sizeR R R t renderert RendererR R R) t rR R> t add_questionRM RO RN R t add_rrsett ANSWERR@ R t AUTHORITYR t add_ednsR R R R t
ADDITIONALt write_headerR R
t add_tsigR R$ R% R# R" R! R R& t get_wire( R R) R\ R@ R_ R> ( ( R t to_wire} s@
!
&
i, R c C s | | _ | d j o | i i d | _ n6 t | t t f o t i i
| } n | | _ | | _ | | _
| d j o | i | _ n
| | _ | | _ | | _ d S( sw When sending, a TSIG signature using the specified keyring
and keyname should be added.
@param keyring: The TSIG keyring to use; defaults to None.
@type keyring: dict
@param keyname: The name of the TSIG key to use; defaults to None.
The key must be defined in the keyring. If a keyring is specified
but a keyname is not, then the key used will be the first key in the
keyring. Note that the order of keys in a dictionary is not defined,
so applications should supply a keyname when a keyring is used, unless
they know the keyring contains only one key.
@type keyname: dns.name.Name or string
@param fudge: TSIG time fudge; default is 300 seconds.
@type fudge: int
@param original_id: TSIG original id; defaults to the message's id
@type original_id: int
@param tsig_error: TSIG error code; default is 0.
@type tsig_error: int
@param other_data: TSIG other data.
@type other_data: string
@param algorithm: The TSIG algorithm to use; defaults to
dns.tsig.default_algorithm
i N( R R R R
t keysRB t strt unicodeR RM t from_textt algorithmR R$ R% R R# R" ( R R R R$ R% R# R" Rn ( ( R t use_tsig s
i c C s | d j p
| t j o
d } n | t j o
d } n | d j o
| } n | d j o d } d } d } g } n0 | d M} | | d >O} | d j o
g } n | | _ | | _ | | _ | | _ | | _ d S( s_ Configure EDNS behavior.
@param edns: The EDNS level to use. Specifying None, False, or -1
means 'do not use EDNS', and in this case the other parameters are
ignored. Specifying True is equivalent to specifying 0, i.e. 'use
EDNS0'.
@type edns: int or bool or None
@param ednsflags: EDNS flag values.
@type ednsflags: int
@param payload: The EDNS sender's payload field, which is the maximum
size of UDP datagram the sender can handle.
@type payload: int
@param request_payload: The EDNS payload size to use when sending
this message. If not specified, defaults to the value of payload.
@type request_payload: int or None
@param options: The EDNS options
@type options: None or list of dns.edns.Option objects
@see: RFC 2671
ii l ~ i N( R R
R' R- R R R R R ( R R R R R R ( ( R t use_edns s*
c C sl | o7 | i d j o | i n | i t i i O_ n+ | i d j o | i t i i M_ n d S( s
Enable or disable 'DNSSEC desired' flag in requests.
@param wanted: Is DNSSEC desired? If True, EDNS is enabled if
required, and then the DO bit is set. If False, the DO bit is
cleared if EDNS is enabled.
@type wanted: bool
i N( t wantedR R Rp R R R t DO( R Rq ( ( R t want_dnssec s c C s t i i | i | i S( s. Return the rcode.
@rtype: int
N( R R: R9 R R R ( R ( ( R R: s c C s t i i | \ } } | i d M_ | i | O_ | i d M_ | i | O_ | i d j o | i d j o
d | _ n d S( sP Set the rcode.
@param rcode: the rcode
@type rcode: int
i l i N( R R: t to_flagst valuet evalueR R R R ( R R: Rv Ru ( ( R t set_rcode s c C s t i i | i S( s/ Return the opcode.
@rtype: int
N( R R8 R9 R R ( R ( ( R R8 ! s c C s. | i d M_ | i t i i | O_ d S( sT Set the opcode.
@param opcode: the opcode
@type opcode: int
i N( R R R R8 Rt ( R R8 ( ( R t
set_opcode' s ( R R R R
R0 R2 R4 R- R3 RE RF RI RL R t rdatatypet NONER' RZ R[ Ri R R Ro Rp Rs R: Rw R8 Rx ( ( ( R R
C s& J 3 .#.!+*
t _WireReaderc B s; t Z d Z e e e d Z d Z d Z d Z RS( s Wire format reader.
@ivar wire: the wire-format message.
@type wire: string
@ivar message: The message object being built
@type message: dns.message.Message object
@ivar current: When building a message object from wire format, this
variable contains the offset from the beginning of wire of the next octet
to be read.
@type current: int
@ivar updating: Is the message a dynamic update?
@type updating: bool
@ivar one_rr_per_rrset: Put each RR into its own RRset?
@type one_rr_per_rrset: bool
@ivar ignore_trailing: Ignore trailing junk at end of request?
@type ignore_trailing: bool
@ivar zone_rdclass: The class of the zone in messages which are
DNS dynamic updates.
@type zone_rdclass: int
c C s^ t i i | | _ | | _ d | _ t | _ t i i
| _ | | _ | | _
| | _ d S( Ni ( R t wiredatat
maybe_wrapt wireR t messaget currentR' t updatingt
rdataclasst INt zone_rdclasst
question_onlyt one_rr_per_rrsett ignore_trailing( R R~ R R R R ( ( R R0 E s c
C s | i o | d j o t i i n x t d | D] } t i i | i
| i \ } } | i i d j o | i | i i } n | i | | _ t i d | i
| i | i d ! \ } } | i d | _ | i i | i i | | | d t d t | i o
| | _ q7 q7 Wd S( s Read the next I{qcount} records from the wire data and add them to
the question section.
@param qcount: the number of questions in the message
@type qcount: inti i s !HHi RV RS N( R R t qcountR t exceptiont FormErrort xranget iRM t from_wireR~ R t qnamet usedR R) R
R? t structt unpackRO RN RZ R R- R ( R R R RO RN R R ( ( R t
_get_questionP s" ! #
c
C s | i p
| i o
t } n t } t } xOt d | D]>} | i
} t i
i | i | i
\ } } | }
| i i d j o | i | i i } n | i
| | _
t i d | i | i
| i
d ! \ } } } } | i
d | _
| t i i j o| | i i j p | o
t n | | i _! | | i _" | d @d ?| i _# g | i _$ | i
} | } x | d j o} t i d | i | | d ! \ } } | d } t i# i( | | i | | } | i i$ i* | | | } | d | } qoWt } ne| t i i+ j o | | i i j o | | d j p
t, n | i i- d j o t. d n | i i- i/ |
}
|
d j o t. d
| n t i1 i2 | i |
|
t3 t4 i4 | i i5 | | i
| | i i6 | i i7 | i i8 | i _6 t | i _9 n[| d j o
d } n | i o9 | t i: i; j p | t i: i< j o | } | i> } n d } | t i: i; j p& | t i: i< j o) | | i i? j o t i i< } d } n: t iB i | | | i | i
| | i i } | i@ } | i iC o | t i iD j o
t } n | i iE | | | | | | t | } | d j o | iG | | n | i
| | _
q: Wd S( s/ Read the next I{count} records from the wire data and add them to
the specified section.
@param section: the section of the message to which to add records
@type section: list of dns.rrset.RRset objects
@param count: the number of records to read
@type count: inti s !HHIHi
i i s !HHi i s" got signed message without keyrings key '%s' unknownN(H R R R R- RS R' t seen_optR t countR R t rr_startR RM R R~ R t
absolute_nameR R) R
R? R R RO RN t ttlt rdlenRy t OPTRJ R R R R R R t optslent otypet olent option_from_wiret optRY t TSIGR R R RT t secretR t validatet intt timeR! R* R, R. R+ R t ANYRz RQ R R RP t rdt rdataR( t SOARZ R> t add( R RJ R R R R RP R R> R R RO R R R R RS R RM RN R R R RQ ( ( R t _get_sectionh s
! )
$
0
9
c C sX t | i } | d j o
t n t i d | i d \ | i _ | i _ } } } } d | _ t i i | i i o
t | _ n | i | | i o d Sn | i | i i | | i | i i | | i | i i | | i o | i | j o
t n | i i o5 | i i o( | i i o | i i i | i n d S( sN Read a wire format DNS message and build a dns.message.Message
object.i s !HHHHHHN( t lenR R~ t lR R R R R R R t ancountt aucountt adcountR R R8 R= R- R R R R R R R R R R, R* R+ t update( R R R R R R ( ( R t read s$
7
(( R R R R' R0 R R R ( ( ( R R{ / s
^R c
C st t d d } | | _ | | _ | | _ | | _ | | _ | | _ | | _ t | | | | |
} | i | S( s) Convert a DNS wire format message into a message
object.
@param keyring: The keyring to use if the message is signed.
@type keyring: dict
@param request_mac: If the message is a response to a TSIG-signed request,
I{request_mac} should be set to the MAC of that request.
@type request_mac: string
@param xfr: Is this message part of a zone transfer?
@type xfr: bool
@param origin: If the message is part of a zone transfer, I{origin}
should be the origin name of the zone.
@type origin: dns.name.Name object
@param tsig_ctx: The ongoing TSIG context, used when validating zone
transfers.
@type tsig_ctx: hmac.HMAC object
@param multi: Is this message part of a multiple message sequence?
@type multi: bool
@param first: Is this message standalone, or the first of a multi
message sequence?
@type first: bool
@param question_only: Read only up to the end of the question section?
@type question_only: bool
@param one_rr_per_rrset: Put each RR into its own RRset
@type one_rr_per_rrset: bool
@param ignore_trailing: Ignore trailing junk at end of request?
@type ignore_trailing: bool
@raises ShortHeader: The message is less than 12 octets long.
@raises TrailingJunk: There were octets in the message past the end
of the proper DNS message.
@raises BadEDNS: An OPT record was in the wrong section, or occurred more
than once.
@raises BadTSIG: A TSIG record was not the last record of the additional
data section.
@rtype: dns.message.Message objectR i N( R
t mR R! R( R) R* R, R. R{ R~ R R R t readerR (
R~ R R! R( R) R* R, R. R R R R R ( ( R R s &
t _TextReaderc B s; t Z d Z d Z d Z d Z d Z d Z RS( s Text format reader.
@ivar tok: the tokenizer
@type tok: dns.tokenizer.Tokenizer object
@ivar message: The message object being built
@type message: dns.message.Message object
@ivar updating: Is the message a dynamic update?
@type updating: bool
@ivar zone_rdclass: The class of the zone in messages which are
DNS dynamic updates.
@type zone_rdclass: int
@ivar last_name: The most recently read name when building a message object
from text format.
@type last_name: dns.name.Name object
c C sC | | _ t i i | | _ d | _ t i i
| _ t | _
d S( N( R R R t tokenizert Tokenizert textt tokR
t last_nameR R R R' R ( R R R ( ( R R0 ( s
c C s | i i } | i } | d j o | i i | i _ nU| d j o xb t oZ | i i } | i
p | i i | Pn | i i t
i i | i B| i _ qN Wt
i i | i i o
t | _ qn| d j o9 | i i | i _ | i i | i i d >B| i _ ns| d j o | i i d j o d | i _ n x?t oZ | i i } | i
p | i i | Pn | i i t
i i | i B| i _ qSWn | d j o< | i i | i _ | i i d j o d | i _ qn | d j oA | i i } | i i t
i i t
i i | B| i _ nC | d j o/ | i i } | i i t
i i | n t | i i d
S( s5 Process one line from the text format header section.R R R i t eflagsi R R8 R: N( R R RT t tokenRu t whatt get_intR R R- t
is_identifiert ungetR R Rm R8 R= R R R t edns_from_textR t
get_stringR Rt Rw R: R t get_eol( R RJ R R R ( ( R t _header_line/ sP
*
$
.
2
c C s] | i i d t } | i p t i i | i d | _ n | i } | i i } | i p t i
i n yE t i i | i } | i i } | i p t i
i n Wn7 t i
i j
o t i
i n t i i } n Xt i i | i } | i i | i i | | | d t d t | i o
| | _ n | i i d S( s7 Process one line from the text format question section.t want_leadingRV RS N( R R RT R- R t
is_whitespaceR RM Rm Ru R
R R R t SyntaxErrorR RN R Ry RO R RZ R R R R ( R RJ RO RM R RN ( ( R t _question_line] s0
c C sz d } | i i d t } | i p t i i
| i d | _ n | i } | i i } | i
p t i i n yB t | i d } | i i } | i
p t i i n Wn1 t i i j
o t i i n d } n Xy~ t i i
| i }
| i i } | i
p t i i n |
t i i j p |
t i i j o |
} | i }
n Wn7 t i i j
o t i i n t i i }
n Xt i i
| i } | i i } | i p> | i i | t i i
|
| | i d } | i } n d } t i i } | i i | | |
| | | t | i" } | d j o | i$ | | n d S( sf Process one line from the text format answer, authority, or
additional data sections.
R i N(% R
RQ R R RT R- R R R RM Rm Ru R R R R R R R RN R Rz R R Ry RO t
is_eol_or_eofR R R RP R RZ RJ R R> R ( R RJ RO RM RQ RP R R R R> RN ( ( R t _rr_linez sV
&
c C se | i } d
} xO| i i t t } | i o Pn | i
o | i i } | d j o
| i } n | d j p
| d j o | i } | i i } n | d j p
| d j o | i } | i i } nZ | d j p
| d j o | i } | i i } n' | d j o | i } | i i } n | i i q n | i i | | | q Wd
S( sN Read a text format DNS message and build a dns.message.Message
object.i t HEADERt QUESTIONt ZONERb t PREREQRc t UPDATERe N( R R t line_methodR
RJ R RT R- R R t
is_commentRu t uppert uR R R R R R R R R ( R R R R RJ ( ( R R s8
( R R R R0 R R R R ( ( ( R R s . 5c C s& t } t | | } | i | S( s Convert the text format message into a message object.
@param text: The text format message.
@type text: string
@raises UnknownHeaderField:
@raises dns.exception.SyntaxError:
@rtype: dns.message.Message objectN( R
R R R R R ( R R R ( ( R Rm s
c C s t i d j o t } d } n
t } d } t | | o t | | } t } n t } z t | } Wd | o | i n X| S( s Read the next text format message from the specified file.
@param f: file or string. If I{f} is a string, it is treated
as the name of a file to open.
@raises UnknownHeaderField:
@raises dns.exception.SyntaxError:
@rtype: dns.message.Message objecti t rUR_ N( t syst
hexversiont
basestringt str_typet optsRk RB t ft fileR- t
want_closeR' Rm R t close( R R R R R ( ( R t from_file s
i i c
C s t | t t f o t i i | } n t | t t f o t i i | } n t | t t f o t i
i | } n t } | i
t i
i O_
| i | i | | | d t d t | i | | | | | | i | | S( sW Make a query message.
The query name, type, and class may all be specified either
as objects of the appropriate type, or as strings.
The query will have a randomly choosen query id, and its DNS flags
will be set to dns.flags.RD.
@param qname: The query name.
@type qname: dns.name.Name object or string
@param rdtype: The desired rdata type.
@type rdtype: int
@param rdclass: The desired rdata class; the default is class IN.
@type rdclass: int
@param use_edns: The EDNS level to use; the default is None (no EDNS).
See the description of dns.message.Message.use_edns() for the possible
values for use_edns and their meanings.
@type use_edns: int or bool or None
@param want_dnssec: Should the query indicate that DNSSEC is desired?
@type want_dnssec: bool
@param ednsflags: EDNS flag values.
@type ednsflags: int
@param payload: The EDNS sender's payload field, which is the maximum
size of UDP datagram the sender can handle.
@type payload: int
@param request_payload: The EDNS payload size to use when sending
this message. If not specified, defaults to the value of payload.
@type request_payload: int or None
@param options: The EDNS options
@type options: None or list of dns.edns.Option objects
@see: RFC 2671
@rtype: dns.message.Message objectRV RS N( RB R Rk Rl R RM Rm RO Ry RN R R
R R t RDRZ R R- Rp R R R R Rs (
R RO RN Rp Rs R R R R R ( ( R t
make_query s "
i c C s
| i t i i @o t i i d n t i i | i } t i i | i t i i
@B| _ | o | i t i i O_ n | i
| i t | i | _ | i d j o | i d d | | i n | i d j o( | i | _ | i | _ | i | _ n | S( s Make a message which is a response for the specified query.
The message returned is really a response skeleton; it has all
of the infrastructure required of a response, but none of the
content.
The response's question section is a shallow copy of the query's
question section, so the query's question RRsets should not be
changed.
@param query: the query to respond to
@type query: dns.message.Message object
@param recursion_available: should RA be set in the response?
@type recursion_available: bool
@param our_payload: payload size to advertise in EDNS responses; default
is 8192.
@type our_payload: int
@rtype: dns.message.Message objects& specified query message is not a queryi N( t queryR R RG R R R R
R t responseR t recursion_availablet RARx R8 t listR R Rp t our_payloadR R R
R R& R! ( R R R R ( ( R t
make_response2 s (, R R5 t randomR R R t dns.ednsR t
dns.exceptiont dns.flagst dns.namet
dns.opcodet dns.entropyt dns.rcodet dns.rdatat dns.rdataclasst
dns.rdatatypet dns.rrsett dns.renderert dns.tsigt dns.wiredataR R R R t DNSExceptionR R R R t objectR
R{ R
R' R- R R Rm R R R R R ( R5 R R R R R R R R R Rm R R R R{ R R R R R
( ( R t ? sD '8 $2