J*nSrSSKJr SSKrSSKrSSKrSSKrSSKrSSK J r Sr Sr Sr Sr"SS \5rg) z*Help for building DNS wire format messages)BytesION)longc\rSrSrSrSSjrSrSr\RR4Sjr Sr S r SS jr\RR 4S jr\RR 4S jrS rSrSrSrg)Renderer$aHelper class for building DNS wire-format messages. Most applications can use the higher-level L{dns.message.Message} class and its to_wire() method to generate wire-format messages. This class is for those applications which need finer control over the generation of messages. Typical use:: r = dns.renderer.Renderer(id=1, flags=0x80, max_size=512) r.add_question(qname, qtype, qclass) r.add_rrset(dns.renderer.ANSWER, rrset_1) r.add_rrset(dns.renderer.ANSWER, rrset_2) r.add_rrset(dns.renderer.AUTHORITY, ns_rrset) r.add_edns(0, 0, 4096) r.add_rrset(dns.renderer.ADDTIONAL, ad_rrset_1) r.add_rrset(dns.renderer.ADDTIONAL, ad_rrset_2) r.write_header() r.add_tsig(keyname, secret, 300, 1, 0, '', request_mac) wire = r.get_wire() output, a BytesIO, where rendering is written id: the message id flags: the message flags max_size: the maximum size of the message origin: the origin to use when rendering relative names compress: the compression table section: an int, the section currently being rendered counts: list of the number of RRs in each section mac: the MAC of the rendered message (if TSIG was used) Nc [5UlUc[R"SS5UlOXlX lX0lX@l0Ul[Ul /SQUl URRS5 SUl g)zInitialize a new renderer.Nr)rrrrs )routputrandomrandintidflagsmax_sizeorigincompressQUESTIONsectioncountswritemac)selfrrrrs lib/third_party/dns/renderer.py__init__Renderer.__init__Msfi :nnQ.DGG     "  ,'cURRU5 URR5 /nURR 5Hup4XA:dM UR U5 M UHnURU M g)zTruncate the output buffer at offset *where*, and remove any compression table entries that pointed beyond the truncation point. N)rseektruncateritemsappend)rwherekeys_to_deletekvs r _rollbackRenderer._rollback^so  MM'')DAz%%a(* A a  rcURU:wa1URU:a[RReXlgg)zSet the renderer's current section. Sections must be rendered order: QUESTION, ANSWER, AUTHORITY, ADDITIONAL. Sections may be empty. Raises dns.exception.FormError if an attempt was made to set a section value less than the current section. N)rdns exception FormError)rrs r _set_sectionRenderer._set_sectionms6 <<7 "||g%mm---"L #rcUR[5 URR5nUR URUR UR 5 URR[R"SX#55 URR5nXPR:a+URU5 [RReUR[==S- ss'g)zAdd a question to the message.!HHrN)r/rrtellto_wirerrrstructpackrr)r,r-TooBigr)rqnamerdtyperdclassbeforeafters r add_questionRenderer.add_question|s (#!!# dkk4==$++> &++eV=>   " MM ! NN6 "--&& & H"rc URU5 URR5nUR"URURUR 40UD6nURR5nX`R :a+URU5 [RReURU==U- ss'g)zrAdd the rrset to the specified section. Any keyword arguments are passed on to the rdataset's to_wire() routine. N r/rr3r4rrrr)r,r-r7r)rrrrsetkwr;nr<s r add_rrsetRenderer.add_rrsets '"!!# MM$++t}}dkk HR H   " MM ! NN6 "--&& & G!rc URU5 URR5nUR"X RURUR 40UD6nURR5nXpR :a+URU5 [RReURU==U- ss'g)zAdd the rdataset to the specified section, using the specified name as the owner name. Any keyword arguments are passed on to the rdataset's to_wire() routine. Nr@)rrnamerdatasetrBr;rCr<s r add_rdatasetRenderer.add_rdatasets '"!!#   T;; t{{ #! #   " MM ! NN6 "--&& & G!rc U[S5-nX!S--nUR[5 URR 5nURR [ R"SS[RRUUS55 UGbURR 5nUGHn[ R"SURS5nURR U5 URR 5n URUR5 URR 5n X- S:deURRU S- 5 [ R"S X- 5nURR U5 URRSS5 GM URR 5n X- S:deURRUS- 5 [ R"S X- 5nURR U5 URRSS5 URR 5n XR:a+URU5 [R R"eUR$[==S - ss'g) z&Add an EDNS OPT record to the message.l~z!BHHIHrNr2r!Hr)rr/ ADDITIONALrr3rr5r6r, rdatatypeOPTotyper4r!rr)r-r7r) redns ednsflagspayloadoptionsr;lstartoptstuffstartendlendr<s radd_ednsRenderer.add_ednss  T*%% bj!  *%!!# &++h3==3D3Dg&/4 5  [[%%'F E399a8 !!%( ((* DKK(kk&&({U***   + D#+6 !!%(   A&;;##%D=5( (( KK  VaZ (KKdm4E KK  e $ KK  Q "   " MM ! NN6 "--&& & J1$rc URR5n [RR U UU[ [ R "55UUUUUUS9 uoln URX5 g)z$Add a TSIG signature to the message.) algorithmN rgetvaluer,tsigsigninttimer _write_tsig) rkeynamesecretfudger tsig_error other_data request_macr`s tsig_rdatactxs radd_tsigRenderer.add_tsigsm KK "&)hhmmA4;4:47 4D49464>4>4?>G'4 'I#Xs -rc URR5n [RR U UU[ [ R "55UUUUUUUSLSU S9 uolnURX5 U$)aQAdd a TSIG signature to the message. Unlike add_tsig(), this can be used for a series of consecutive DNS envelopes, e.g. for a zone transfer over TCP [RFC2845, 4.4]. For the first message in the sequence, give ctx=None. For each subsequent message, give the ctx that was returned from the add_multi_tsig() call for the previous message.NT)rpfirstmultir`ra) rrprhrirjrrkrlrmr`rnros radd_multi_tsigRenderer.add_multi_tsigs KK "&)hhmmA4;4:47 4D49464>4>4?8;:=+:>>G'4 'I#Xs - rc vUR[5 URR5nUR URUR UR 5 URR[R"S[RR[RRSS55 URR5nURRU5 URR5nXT- S:deXPR:a+UR!U5 [R"R$eURR'US- 5 URR[R"SXT- 55 UR([==S- ss'URR'S5 URR[R"SUR([55 URR'SS5 g)Nz!HHIHrrMrrNr )r/rOrr3r4rrrr5r6r,rPTSIG rdataclassANYrr)r-r7r!r)rrorhr; rdata_startr<s rrgRenderer._write_tsigs *%!!# T]]DKK@ &++gs}}/A/A&)nn&8&8!Q@ Akk&&(  *%   ""U*** MM ! NN6 "--&& & q) &++dE,?@A J1$  &++dDKK ,CDE Arc lURRS5 URR[R"SUR UR URSURSURSURS55 URRSS5 g)zWrite the DNS message header. Writing the DNS message header is done after all sections have been rendered, but before the optional TSIG signature is added. rz!HHHHHHrrrN)rr!rr5r6rrrrs r write_headerRenderer.write_headers  &++i$**&*kk!ndkk!n&*kk!ndkk!nF G Arc6URR5$)zReturn the wire format message.)rrbrs rget_wireRenderer.get_wire s{{##%%r) rrrrrrrrr)Nrr N)N)__name__ __module__ __qualname____firstlineno____doc__rr)r/r,r{INr=rDrIr]rcdefault_algorithmrqrvrgrr__static_attributes__rrr r $sr&P" ! #36..2C2C #" "$!%H),(B(B.&"%!;!;8. &rr )riorr5rrf dns.exceptionr,dns.tsig_compatrrANSWER AUTHORITYrOobjectr rrrrsC$1     &v&r