a k#dc@sdZddlmZddlmZddlmZddlZddlZddlZddl Z ddl Z ddl Z ddl m Z mZmZmZmZmZmZmZmZmZmZmZddlmZmZddlmZmZmZdd l m!Z!m"Z"m#Z#m$Z$m%Z%dd l&m'Z'dd l(m)Z)m*Z*dd l+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1dd l2m3Z3m4Z4m5Z5ddl6m7Z7ddl8m9m:Z:ddlm;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHz ddlIZIWneJyYn0eEde=eKe;feAe=eKe;fZLGddde:Me$e!e%ZNGdddeNZOGdddeNZPGdddePZQePe_ReQe_SejTdur(ePe_Td1ddZUd2ddZVejWjXd3ddZYd4dd ZZd5d!d"Z[ejWjXd6d#d$Z\ejWjXd7d%d&Z]d8d(d)Z^ejWjXd9d*d+Z_ejWjXd:d-d.Z`ejWjXd;d/d0ZadS)d?Z6d@dAZ7dBdCZ8dDdEZ9dFdGZ:e;j<rdHdIZ=ndJdIZ=dKdLZ>dMdNZ?e?Z@dOdPZAeAZBdQdRZCdSdTZDdUdVZEeEZFdWdXZGdYdZZHd[d\ZId]d^ZJd_d`ZKdadbZLdcddZMdedfZNdgdhZOdidjZPdkdlZQdmdnZRddodpZSddqdrZTdsdtZUdudvZVdwdxZWdydzZXd{d|ZYd}d~ZZddZ[ddZ\ddZ]dddZ^ddZ_ddZ`ddZaddZbddZcddZddZeddZfddZgddZhdddZidddZjddZkddZlddZmddZnddZoddZpddZqddZrdddZsdddZtdddZudddZvddZwddZxdddZydddZzddZ{dd„Z|dS)Packet)time sent_timenamedefault_fieldsfields fieldtypeoverload_fieldsoverloaded_fields packetfieldsoriginalexplicitraw_packet_cacheraw_packet_cache_fields_pktpost_transformspayload underlayerparentr:Z _answered direction sniffed_onwirelencommentNTFcCs |tSN)r)clsrQC/var/www/html/gsl.tools/lib/python3.9/site-packages/scapy/packet.py from_hexcapqszPacket.from_hexcapc Cs<|jD]0\}}td|jdddt|DfqdS)N %-20s %s, css|]}dd|VqdSz%-12sz%s=%rNrQ.0irQrQrR zz%Packet.upper_bonds..) payload_guessprint__name__joinsix iteritems)selffvalupperrQrQrR upper_bondsvszPacket.upper_bondsc CsBt|jD]0\}}td|jdddt|Dfq dS)NrTrUcss|]}dd|VqdSrVrQrWrQrQrRrZr[z%Packet.lower_bonds..)r`ra_overload_fieldsr]r^r_)rblowerrcrQrQrR lower_bonds|szPacket.lower_bondsr[rc Kst|_d|_|jdur"|jjn|j|_i|_|j|_i|_ i|_ i|_ g|_ t |_|||_||_t|tr~t|}||_d|_d|_d|_d|_d|_d|_d|_|r|||s|||jD]X}|j}z| |} Wnt!yYqYn0t| t"r| n|#|$|| |j |<q|D]X}||j%vr|||} |&|}t| t"r`| n|#|$|| |j |<q.t'|q.t|t(r||_)n|durg|_)n|g|_)dSNr)*r8r9_name __class__r^r:r;rfr>r?r<r=r@ NoPayloadrG init_fieldsrHrI isinstance bytearraybytesrArBrCrDrLrJrKrMdissectdissection_done fields_descpopKeyErrorr get_fieldany2ideprecated_fields_resolve_aliasAttributeErrorlistrF) rbrEZpost_transform _internal _underlayer_parentr<fieldfnamevaluerQrQrR__init__sj              zPacket.__init__cCs*|j|f|j|j|j|j|j|jffS)zUsed by pickling methods)rkbuildr8r9rJrKrLrMrbrQrQrR __reduce__s zPacket.__reduce__cCs@|d|_|d|_|d|_|d|_|d|_|d|_|S)z$Rebuild state using pickable methodsrrN)r8r9rJrKrLrM)rbstaterQrQrR __setstate__s      zPacket.__setstate__cCs|S)zUsed by copy.deepcopy)copy)rbmemorQrQrR __deepcopy__szPacket.__deepcopy__cCs*|j|jdr||jn|dS)@ Initialize each fields of the fields_desc dict FN)class_dont_cachegetrkdo_init_fieldsrsdo_init_cached_fieldsrrQrQrRrmszPacket.init_fieldscCsHi}|D]4}t|j||j<||j|j<|jr|j|q||_dS)rN) rdeepcopydefaultr:r= holds_packetsr@appendr;)rbflistr;frQrQrRrs zPacket.do_init_fieldsc Cs|j}tj|ddur$||jtj|d}|r||_tj||_tj ||_ tj |D]F}|j|}z| |j |<Wq^ty|dd|j |<Yq^0q^dS)zn Initialize each fields of the fields_desc dict, or use the cached fields information N)rkr7class_default_fieldsrprepare_cached_fieldsrsr;class_fieldtyper=class_packetfieldsr@class_default_fields_refrr<rz)rbcls_namer;rrrQrQrRrs     zPacket.do_init_cached_fieldsc Cs|j}|sdSt}t}t}t}|D]|}t|trTd|j|<||jdSt |j }|||j <|||j <|j r| |t|j tttttfr*| |j q*|tj|<|tj|<|tj|<|tj|<dS)zC Prepare the cached fields of the fields_desc dict NT)rkdictr{rnr rrrsrrrr:rrsetrr7rrrr) rbrrrrrrrZtmp_copyrQrQrRr#s.          zPacket.prepare_cached_fieldscCs|||j|dS)z3DEV: will be called after a dissection is completedN)post_dissectionrGrrrbpktrQrQrRrrMs zPacket.dissection_donecCsdS)z7DEV: is called after the dissection of the whole packetNrQrrQrQrRrSszPacket.post_dissectioncCs |j|S)z:DEV: returns the field instance from the name of the field)r=)rbfldrQrQrRrvXszPacket.get_fieldcCs|dur dSt|jts&|j|nxt|trh||_|||jD]}||jvrF|j||_qqFn6t|t t t t frt jt|d|_ntdt|dS)NloadzPpayload must be 'Packet', 'bytes', 'str', 'bytearray', or 'memoryview', not [%s])rnrGrl add_payloadr7add_underlayer aliastypesr>r?rpstrro memoryviewr raw_layerr TypeErrorrepr)rbrGtrQrQrRr]s      zPacket.add_payloadcCs|j|t|_i|_dSrO)rGremove_underlayerrlr?rrQrQrRremove_payloadps zPacket.remove_payloadcCs ||_dSrOrHrbrHrQrQrRrvszPacket.add_underlayercCs d|_dSrOrrbotherrQrQrRrzszPacket.remove_underlayercCs ||_dS)zSet packet parent. When packet is an element in PacketListField, parent field would point to the list owner packet.NrIrbrIrQrQrR add_parent~szPacket.add_parentcCs d|_dS)zRemove packet parent. When packet is an element in PacketListField, parent field would point to the list owner packet.NrrrQrQrR remove_parentszPacket.remove_parentcCs|}||j|_||j|_|j|_|j|_|j|_|j|_|j |_ ||j |_ |j |_ |j dd|_ |j |_ |j ||j|_|j|_|S)z$Returns a deep copy of the instance.N)rkcopy_fields_dictr<r;r?rrHrIrBrCrDrLrFrGrr8rM)rbclonerQrQrRrs$   z Packet.copycCs(|j|\}}td|||ft|S)Nz0%s has been deprecated in favor of %s since %s !)rxwarningswarnDeprecationWarning)rbattrnew_attrversionrQrQrRryszPacket._resolve_aliascCsb|jr||jvr||}||jvr.|j|S||jvrB|j|S||jvrV|j|S|j|SrO)rxryr<r?r;rG getfieldvalrbrrQrQrRrs       zPacket.getfieldvalcCs||jr||jvr||}||jvr8|||j|fS||jvrV|||j|fS||jvrt|||j|fStdSrO)rxryr<rvr?r; ValueErrorrrQrQrRgetfield_and_vals    zPacket.getfield_and_valcCsXz||\}}Wnty0|j|YS0|durTt|trH|S|||S|SrO)rrrG __getattr__rnri2h)rbrrvrQrQrRrs zPacket.__getattr__cCs|jr||jvr||}||jvr~||}|dur@dd}n|j}t|trT|n||||j|<d|_d|_ d|_ d|_ n*|dkr| | |n|j||dS)NcSs|SrOrQ)xyrQrQrRr[z$Packet.setfieldval..rrG)rxryr;rvrwrnrr<rBrCrDrLrrrG setfieldval)rbrvalrrwrQrQrRrs$     zPacket.setfieldvalcCsH||jvrt|||Sz|||WSty8Yn0t|||SrO) __all_slots__object __setattr__rrzrbrrrQrQrRrs  zPacket.__setattr__cCsZ||jvr,|j|=d|_d|_d|_d|_n*||jvr8n|dkrJ|n |j|dS)NrrG) r<rBrCrDrLr;rrG delfieldvalrrQrQrRrs   zPacket.delfieldvalcCsR|dkr|S||jvr&t||Sz ||WStyDYn0t||SNrG)rrr __delattr__rrzrrQrQrRrs    zPacket.__delattr__cCsHt}|j}t|dr"||j|jD]}t|dr(||jq(|S)zV Return a list of slots and methods, including those from subclasses. r__dict__)rrkhasattrupdater__mro__r)rbattrsrPZbclsrQrQrR _superdir s    zPacket._superdircCstt||jS)z4 Add fields to tab completion list. )sorted itertoolschainrr;rrQrQrR__dir__szPacket.__dir__c Cs<d}tj}|jD]}t|tr*||s*q|j|jvrn|j|j}t|tt t fr`t |dkr`q| ||}nF|j|j vr|j |j}t|tt t frt |dkrq| ||}nqt|ts|tjvr|j}|j}n |j}|j}|d||j|d||f7}qd|d||jj||dt|j|dfS) Nrz %s%s%s=z%s%s %s %s%s%s<|>)r color_themersrnr _evalcondr:r<r{rrleni2reprr?remphemph_field_nameemph_field_value field_name field_valuepunct layer_namerkr^rrG) rbsctrrcrZfoverncolvcolrQrQrR__repr__s@         zPacket.__repr__cCs|SrOrrrQrQrR__str__CszPacket.__str__cCs|SrO)summaryrrQrQrRrGscCs|SrOrrrQrQrR __bytes__KszPacket.__bytes__cCs\t|tr(|}|}|||St|ttttfrN|tj t |dS| |SdSNr) rnr7rrrprrorrrr__rdiv__)rbrZcloneAZcloneBrQrQrR__div__Os  zPacket.__div__cCs.t|ttttfr&tjt|d|StdSr) rnrprrorrrrrrrQrQrRr\szPacket.__rdiv__cCst|tr|g|StdSrO)rnintrrrQrQrR__mul__ds  zPacket.__mul__cCs ||SrO)rrrQrQrR__rmul__kszPacket.__rmul__cCsdS)NTrQrrQrQrR __nonzero__oszPacket.__nonzero__cCs t|SrO)rrrrQrQrR__len__tszPacket.__len__cCs|||SrO)rvdo_copy)rb fieldnamerrQrQrRcopy_field_valuexszPacket.copy_field_valuecs$|dur dSfddt|DS)Ncsi|]\}}|||qSrQ)r)rXrrcrrQrR sz+Packet.copy_fields_dict..)r`ra)rbr<rQrrRr|s  zPacket.copy_fields_dictcCsjd|_t|jD]H\}}||}|jrt|tr>|qt|t r|D] }|qLq|j dS)z>Clear the raw packet cache for the field and all its subfieldsN) rCr`rar<rvrrnr7 clear_cacher{rG)rbrrcZfsubvalrQrQrRrs     zPacket.clear_cachec Cs |jdurTt|jD],\}}|||krd|_d|_d|_qDq|jdurT|jSd}|jD]}||j}t|t r|t |7}q^z| |||}Wq^t y}zRz*d|j|j df|j dd|_ WnttfyYn0|WYd}~q^d}~00q^|S)ze Create the default layer regarding fields_desc dict :param field_pos_list: Nr[zWhile dissecting field '%s': rrN)rCr`rarDrrLrsr:rnrrpaddfield Exceptionargsrz IndexError)rbrrcprrexrQrQrR self_builds8      zPacket.self_buildcCs |jS)zm Create the default version of the payload layer :return: a string of payload layer )rGdo_buildrrQrQrRdo_build_payloadszPacket.do_build_payloadcCsX|jstt|}|}|jD] }||}q |}|jdurL|||S||SdS)zs Create the default version of the layer :return: a string of the packet with the payload N)rBnextiterr rFrrC post_build)rbrrpayrQrQrRr s     zPacket.do_buildcCs |jSrO)rG build_paddingrrQrQrRrszPacket.build_paddingcCs"|}||7}||}|S)zb Create the current layer :return: string of the packet with the payload )r r build_donerbr rQrQrRrs  z Packet.buildcCs||S)a DEV: called right after the current layer is build. :param str pkt: the current packet (build by self_build function) :param str pay: the packet payload (build by do_build_payload function) :return: a string of the packet with the payload rQ)rbrrrQrQrRrs zPacket.post_buildcCs |j|SrO)rGrrrQrQrRrszPacket.build_donec Csd}g}d}|jD]t}t|tr,||s,q|||||j}t|trb|t|d}|}nd}| || |||j|fq|j j dd\}}||7}| ||f||fS)Nr[rN)internal) rsrnrrrrr:rprrrrGbuild_ps)rbr plqrrrlstrQrQrR do_build_pss   "zPacket.do_build_pscCs|\}}||fSrO)r)rbrr rrQrQrRrs zPacket.build_psc& stdkrtdtj}|r6|t|\}}n |\}}t|}|D]\}}|t|7}qNt|}|d} dd} d} ddt dd d tj j d } t d d d tj j d } ddfdddd}ddd+fdd }d\}}|rt | }| \}}| d 7} tj| || dtt|jtjjjg}| d7} |}|tjjd||tj j jtj|gg|||D]\}}}t | }tj| || dt|j}t|trd|j}n dt|}t |drd|j!jj"dd vs.d|jj"dd vr6d!|}tj| d"|| d#|tjj#j$g}t|trt|d$kr|dd$d%}nd&}tj| d'|| dt|}| d 7} |rz||||||\}} }}| }!|}"||"}#||!}$|!tjjz8| dkr&tj%j&|#|$dd(d)}%ntj%j&|#|$dd*d)}%Wnt'yPYn 0||%tj(j)j*tjj+j,|g||||||||q||7}q|S),Nrz*PyX and its dependencies must be installedrN g?g?g333333?g?g?)Ztransg??cSsddd|DS)N css|]}dt|VqdS)z%02xN)r)rXcrQrQrRrZ,r[z5Packet.canvas_dump..hexstr..)r_rrQrQrRhexstr*sz"Packet.canvas_dump..hexstrcs2tj||d|tjjjgS)Nz\tt{%s})pyxtextsizeLarge)rrtxt)XDSTARTXMULYDUMPYMULr#rQrR make_dump_txt.s     z)Packet.canvas_dump..make_dump_txtcSs&tjj||||ddS)N)rr)Z relcenter)r$boxrectleftbottomwidthheight)orQrQrRmake_box7sz$Packet.canvas_dump..make_boxcSs4t|dkr.|d}|tjj|S|d}|tjj|d}|tjjt|dkr,||kr,tjtj || tj || tj || tj || tj || tj || tj || tj || S|d}||krP|tjj|d}||kr~||kr~|tjjtjtj || tj || tj || tj || tj || tj || tj || tj || tj SdS)NrNrr)rbboxenlarger$unitu_ptpathr0rightZmovetotopZlinetor1Z closepath)rbZfbZlbgbkbrQrQrR make_frame>sD        z&Packet.canvas_dump..make_framec stj}g}|rl|d|||||d}}|||} || |t|7}|dkrd}|d7}q|dur~tjjj}|durtjjj}|||tj |gtj j j g|D]} || q||d||fS)NrCrrNr6)r$canvasrrcolorrgbredwhitestrokedecofilledstyle linewidthZThickinsertr8) rshiftrcolbkcolZlarger!ZtlistZdmpr()r-rBrQrR make_dumpds$ "      & z%Packet.canvas_dump..make_dump)rrz"\font\cmssfont=cmss10\cmssfont{%s}rz%sbz%sBrZLErz$\scriptstyle\langle$g333333 @z/\font\cmbxfont=cmssbx10 scaled 600\cmbxfont{%s}z[...]rg @i)Z absangle1Z absangle2Z)rrNNrC)-r' ImportErrorr$rDrkrrrfloatr rErFrrtr%rrr:r&r'r8r9r:r;rIr<blackrJrKrNrnrrrr^ZhalignZboxrightZ connectorZcurverrLrMZthinZearrowZsmall)&rbZ layer_shiftZrebuildrD_rZYTXTIlZYTXTZXSTARTrZydZ backcolorZ forecolorr5rRZ last_shiftZlast_yrQprotor<ptZptbbrrcZfdumprPftfsizestvtdttargetZdtbZvtbZbxvtZbxdtZcnxrQ)r)r*r+r,r#r-rBrR canvas_dumps    '   $ "    * $     zPacket.canvas_dumpcCs|dfS)z DEV: to be overloaded to extract current layer's padding. :param str s: the current layer :return: a couple of strings (actual layer, padding) NrQrbrrQrQrRextract_paddingszPacket.extract_paddingcCs|S)z?DEV: is called right after the current layer has been dissectedrQrcrQrQrR post_dissectszPacket.post_dissectcCs|S)z:DEV: is called right before the current layer is dissectedrQrcrQrQrR pre_dissectszPacket.pre_dissectcCs|}i|_|jD]`}|sqr|||\}}t|tr@|dur@q|jsR|jsR|jrd|||j|j <||j |j <q|r|dt | n||_ d|_ |SNrN)rDrsZgetfieldrnrislistrZ ismutablerr:r<rrCrB)rbr_rawrrcrQrQrR do_dissects zPacket.do_dissectc Cs|r||}z||d|d}Wntty4Ynbtytjrt|tr`td|j ntd|j j t ||durtj |d|d}Yn0| |dS)zd Perform the dissection of the layer's payload :param str s: the raw layer rNr|r}z%s dissector failedz&%s.guess_payload_class() returned [%s]N)guess_payload_classKeyboardInterruptrrZdebug_dissectorr!r7r%errorr^rkrrr)rbrrPr rQrQrRdo_dissect_payloads"     zPacket.do_dissect_payloadcCsT||}||}||}||\}}|||rPtjrP|t|dSrO) rfrjrerdrorpaddingr padding_layer)rbrpaylpadrQrQrRrqs     zPacket.dissectc shjD]V}|jD]J\}}z.tfddt|DrD|WSWqtyXYq0qq|S)z DEV: Guesses the next payload class from layer bonds. Can be overloaded to use a different mechanism. :param str payload: the layer's payload :return: the payload class c3s |]\}}||kVqdSrOrrXkrrrQrRrZsz-Packet.guess_payload_class..)rr\allr`rarzdefault_payload_class)rbrGrrcrPrQrrRrls    zPacket.guess_payload_classcCstjS)a DEV: Returns the default payload class if nothing has been found by the guess_payload_class() method. :param str payload: the layer's payload :return: the default payload class define inside the configuration file )rrrbrGrQrQrRrx!s zPacket.default_payload_classcCsRtt|jD]2\}}|j|}||jvr|j||kr|j|=q|jdS)z;Removes fields' values that are the same as default values.N)r{r`rar<r;rG hide_defaults)rbrvrrQrQrRrz,s    zPacket.hide_defaultscKs|}d|_||_||j|_|j|_|j|_|j|_|j |_ |j |_ |j |_ ||j |_ |j |_ |j|_|dur|||Srg)rkrBr<rr;r?rr8rHrIrFrCrDrLrMr)rbrGkargsrrQrQrR clone_with7s$  zPacket.clone_withcsj|ffdd |js |jdur,g}|j}n4ddtt|jt|jDt |j}i}||S)z:Iterates through all sub-packets generated by this Packet.c 3s|rr|}||}t|ts@||jr8t|g}nt|}|D]*}|||<|dd|D] }|VqbqDnrt|jtrtdg}n|j}|D]N}| } | D]"} t| | t r| |  | | <q|j fd|i| } | VqdSr) rtrrnrrvrhrrGrlrr_fixr|) tododonerbZeltnameelterZpayloadsrrZdone2rvrlooprQrRrOs*       zPacket.__iter__..loopNcSsg|]\}}t|tr|qSrQ)rnrrurQrQrR os  z#Packet.__iter__..) rBrCr<rrr`rar;r?r{)rbr~rrQrrR__iter__Ls zPacket.__iter__ccs"|V|}|jr|j}|Vq dS)zfUsed to iter through the payloads of a Packet. Useful for DNS or 802.11 for instance. N)rG)rbcurrentrQrQrR iterpayloadsus zPacket.iterpayloadscCs0t|tr||kSt|tr dSt||fdS)z6True if other is an answer from self (self ==> other).rNN)rnr7rprrrQrQrR__gt__s   z Packet.__gt__cCs2t|tr||St|tr"dSt||fdS)z6True if self is an answer from other (other ==> self).rNN)rnr7answersrprrrQrQrR__lt__s    z Packet.__lt__cCsVt||jsdS|jD]2}||jvr*dS||j||jkrdSq|j|jkSNF)rnrkrsrr:rG)rbrrrQrQrR__eq__s   z Packet.__eq__cCs || SrO)rrrQrQrR__ne__sz Packet.__ne__cCs |jS)zSDEV: returns a string that has the same value for a request and its answer.)rGhashretrrQrQrRrszPacket.hashretcCs|j|jkr|j|jSdS)z)DEV: true if self is an answer from otherr)rkrGrrrQrQrRrs zPacket.answerscCs.g}|}|r*||j|jjddd}q|S)zEreturns a list of layer classes (including subclasses) in this packetrT _subclass)rrkrGgetlayer)rblayersZlyrrQrQrRrs  z Packet.layerscCs|dur|jpd}|rt}ndd}|dusJ||j|sJ||jj|jfvrNdS|jD]^}||j}|durnqT|jst |dd}|D],}t |t r|j ||d}|r|SqqT|j j ||dS)zr true if self has a layer that is an instance of cls. Superseded by "cls in self" syntax. NcSs t||kSrOboolZcls1Zcls2rQrQrRrr[z!Packet.haslayer..TrZ _iterpacketr)match_subclassr!rkr^rjr@rr:rhrrnr7haslayerrG)rbrPrmatchr fvalue_genfvalueretrQrQrRrs*     zPacket.haslayerc s|durjpd}|rt}ndd}t|tr<|d}d}n|}d}d} t|trld|vrl|dd\}} n |d}} |r|j|s|jjjfvrt fddt |Dr|dkr| durȈS | Sn|d8}j D]} | j} | durq| jst| d d } | D]N} t| trg} | j|f|| |d |}|durZ|S| d }qqjj|f|||d |S) zPReturn the nb^th layer that is an instance of cls, matching flt values. NcSs t||kSrOrrrQrQrRrr[z!Packet.getlayer..rNr.c3s |]\}}||kVqdSrOrt)rXZfldnameZfldvaluerrQrRrZsz"Packet.getlayer..rr)nb_trackr)rr!rnrrsplitrkr^rjrwr`rarr@r:rhrr7rrG)rbrPrrrfltrZstring_class_name class_namerrrrtrackrrQrrRrs^              zPacket.getlayercCs|}|jdur|j}q|SrOr)rbrrQrQrR firstlayers zPacket.firstlayercCst|trT|j}|jr8|j|jfd|ji|jp0i}qb|j|jfi|jpLi}n|}||}|durt|tr||j}nt|tst |}n t t |}t d||S)NrzLayer [%s] not found) rnslicestartstoprsteptyper^rprr5rr )rbrPlnamerr:rQrQrR __getitem__s "      zPacket.__getitem__cCs||j`dSrOrHrGrbrPrQrQrR __delitem__2szPacket.__delitem__cCs|||j_dSrOr)rbrPrrQrQrR __setitem__6szPacket.__setitem__cCs ||S)ze "cls in self" returns true if self has a layer which is an instance of cls. )rrrQrQrR __contains__:szPacket.__contains__cCs |jSrO)rGrouterrQrQrRrBsz Packet.routecOs|jj|i|SrO)rGfragmentrbrr{rQrQrRrFszPacket.fragmentcOs|j|i|dS)zDeprecated. Use show() method.N)showrrQrQrRdisplayJszPacket.displayrrc Cs|rddlm}|}ntj}d||d||j|df}|jD]x} t| t rd| |sdqHt| t sx| tj vr|j } |j} n |j} |j} || j} t| ts| jr0| jr0t| tr0tddt| jd} |d||| | j| f7}t| dd }|D]$} || j||||d d d 7}qqHtddt| jd} d ||| | j| |df}| || }t|tr|dddt|t|t| jd}|d|| |f7}qH|jr||jj|||d||j|d d7}|r |s t|dS|SdS)a Internal method that shows or dumps a hierarchical view of a packet. Called by show. :param dump: determine if it prints or returns the string value :param int indent: the size of indentation for each layer :param str lvl: additional information about the layer lvl :param str label_lvl: additional information about the layer fields :param first_call: determine if the current function is the first :return: return a hierarchical view if dump, else print it r)AnsiColorThemez %s%s %s %s z###[z]###rr z %s \%s%s\ rz |F)dumpindent label_lvl first_callz %s %s%s%s r rz%s%s )rrlvlrrN) Z scapy.themesrrrrrr:rsrnrrrrrrrrrr7rhrr{maxrr _show_or_dumprrreplacerG show_indentr])rbrrrrrrrrrrrrrsrZbegnZreprvalrQrQrRrOsn    &$    zPacket._show_or_dumpcCs|||||S)a Prints or returns (when "dump" is true) a hierarchical view of the packet. :param dump: determine if it prints or returns the string value :param int indent: the size of indentation for each layer :param str lvl: additional information about the layer lvl :param str label_lvl: additional information about the layer fields :return: return a hierarchical view if dump, else print it )rrbrrrrrQrQrRrs z Packet.showcCs|t|||||S)a Prints or returns (when "dump" is true) a hierarchical view of an assembled version of the packet, so that automatic fields are calculated (checksums, etc.) :param dump: determine if it prints or returns the string value :param int indent: the size of indentation for each layer :param str lvl: additional information about the layer lvl :param str label_lvl: additional information about the layer fields :return: return a hierarchical view if dump, else print it )rkrrrrQrQrRshow2s z Packet.show2c Csndddd}d|vr|d}||ddd}||d||d}|d}|dkrjtd ||d|||dd}}d } |dd krd } |dd}||r| } | sd }|d|||||dd}q d } d|vrb|d}| |d|7} ||dd}|rP|d|vrP| ||d7} |dd}qz|d}|d|} | d} t| dkrd} | d}nt| dkr| \} }ntd|vr|d\}}n |jj}|}d}d|vr|d\}}t |}||dd}Wn:t y@td|dd|ddo4dfYq0|dkr~t dt t|j t |j t |j d}n||jjkr:t||r:|dkr|jd| ||d|f|}d} nrz||}Wntyt||}Yn0| ddkr| dd} | s8d} n||jvrP|j|||}n|jd| |}d} | d| |7} q| |7} | S)ag sprintf(format, [relax=1]) -> str Where format is a string that can include directives. A directive begins and ends by % and has the following format: ``%[fmt[r],][cls[:nb].]field%`` :param fmt: is a classic printf directive, "r" can be appended for raw substitution: (ex: IP.flags=0x18 instead of SA), nb is the number of the layer (ex: for IP/IP packets, IP:2.src is the src of the upper IP layer). Special case : "%.time%" is the creation time. Ex:: p.sprintf( "%.time% %-15s,IP.src% -> %-15s,IP.dst% %IP.chksum% " "%03xr,IP.proto% %r,TCP.flags%" ) Moreover, the format string can include conditional statements. A conditional statement looks like : {layer:string} where layer is a layer name, and string is the string to insert in place of the condition if it is true, i.e. if layer is present. If layer is preceded by a "!", the result is inverted. Conditions can be imbricated. A valid statement can be:: p.sprintf("This is a{TCP: TCP}{UDP: UDP}{ICMP:n ICMP} packet") p.sprintf("{IP:%IP.dst% {ICMP:%ICMP.type%}{TCP:%TCP.dport%}}") A side effect is that, to obtain "{" and "}" characters, you must use "%(" and "%)". %{})r()rNN:rz8Bad condition in format string: [%s] (read sprintf doc!)F!Trr,rrzBad format string [%%%s%s]z...r8z%H:%M:%S.%%06ii@Bz%%%s,%s:%s.%s%%r6rz%%%s%%)rindexindexfindr$rrrrkr^rrr8strftime localtimerVrrGsprintfrrzgetattrr=r)rbfmtrelaxescaperYjZcondrvZformat_resrZsfclsfldZfclsfldrZclsfldrPrnumZsnumrrQrQrRrs#      &          ,    zPacket.sprintfcCsdS)aODEV: can be overloaded to return a string that summarizes the layer. Only one mysummary() is used in a whole packet summary: the one of the upper layer, # noqa: E501 except if a mysummary() also returns (as a couple) a list of layers whose # noqa: E501 mysummary() must be called if they are present.rrQrrQrQrR mysummary1szPacket.mysummaryc Cs|j\}}}d}|r"|j|vrD|}t|trD|\}}||7}|sL|rPd}|sf|jrb|jjnd}|jtj vrg}|j D]2}|tj vr|| d|j | |||j fq|d|d|f}|r|rd||f}n d||f}|||fS)NrrN%s=%sz%s [%s]r z%s / %sz%s%s)rG _do_summaryrkrrntuple show_summaryr^rrrsrr:rrr_)rbfoundrneededrnZimpfrrQrQrRr9s*    & zPacket._do_summarycCs |dS)z&Prints a one line summary of a packet.rN)r)rbinternrQrQrRrRszPacket.summarycCs |j|S)z&Returns the uppest layer of the packet)rG lastlayerrblayerrQrQrRrWszPacket.lastlayercCs@t|j}||d|d|_|}|jdur0|j}q|j|dS)z@Reassembles the payload and decode it using another packet classrNrkN)rrGrHrr)rbrPrpprQrQrRdecode_payload_as\s   zPacket.decode_payload_ascCs4g}t|jD]\}}||}t|tttfr@t|dkr@qt|t rT| }n|j r|j rt|trdd tt j |}nh|j rt|trdd dd|D}n>t|trt|}n*tt|ddr| }nt|||}|d ||fqd |jjd |f}|j }|r0|d |7}|S) zn Returns a string representing the command you have to type to obtain the same packet rz[%s]rrUc3s$|]tdfddVqdS)commandcstSrO)rrQr"rQrRrwr[z*Packet.command...N)r)rXrQr"rRrZvsz!Packet.command..rNrz%s(%s)/)r`rar<rvrnr{rrrr7rrhrr_mapr rcallablerrrrrkr^rG)rbrfnZfvrr!ZpcrQrQrRrfs0          zPacket.command)r[NrNN)r)rrN)N)N)rNNN)FrrrT)Frrr)Frrr)rN)r)N)}r^ __module__ __qualname__ __slots__r:rsrxr>r\rrrrrrrr classmethodrSrerhrr0r3r#rVr.rrrpZ _PickleTyperrrrmrrrrrrrvrrrrrrrryrrrrrrrrrrr`PY2rrr __truediv__r __rtruediv__rrr__bool__rrrrr rr rrrrrrrbrdrerfrjrorqrlrxrzr|rrrrrr__hash__rrrrrrrrrrrrrrrrrrrrrrrrQrQrQrRr7Os    B     *      $  #    0    )      < L   y   r7c@sTeZdZddZddZddZddZd d Zd d Zd dZ ddZ ddZ ddZ ddZ ddZddZddZddZeZdd Zd!d"Zd#d$Zd%d&ZdUd(d)Zd*d+Zd,d-Zd.d/Zd0d1Zd2d3Zd4d5Zd6d7Zd8d9Zd:d;Z dVd=d>Z!dWd@dAZ"dBdCZ#dXdGdHZ$dYdIdJZ%dKdLZ&dMdNZ'dZdOdPZ(dQdRZ)dSdTZ*deZdZdZeddgZd fdd ZddZddZZ S) Rawrr[cs8|rt|tst|}tt|j|g|Ri|dSrO)rnrprsuperrr)rbrErkwargsrkrQrRrAsz Raw.__init__cCsdSrgrQrrQrQrRrGsz Raw.answerscCs4tj}|r*t|r d||jSd|jSt|S)NzRaw %szRaw %r)rZ raw_summaryrrr7r)rbcsrQrQrRrKs  z Raw.mysummary)r[) r^rrr:rrsrrr __classcell__rQrQrrRr=s  rc@s"eZdZdZdddZddZdS)PaddingNcCsdSrrQ)rbZfield_pos_listrQrQrRr YszPadding.self_buildcCs$|jdurt|jn|j|jSrO)rCrrrGrrrQrQrRr]szPadding.build_padding)N)r^rrr:r rrQrQrQrRrVs rcKs6|dur|||jdd|_|j||fdS)aBind 2 layers for dissection. The upper layer will be chosen for dissection on top of the lower layer, if ALL the passed arguments are validated. If multiple calls are made with the same layers, the last one will be used as default. ex: >>> bind_bottom_up(Ether, SNAP, type=0x1234) >>> Ether(b'\xff\xff\xff\xff\xff\xff\xd0P\x99V\xdd\xf9\x124\x00\x00\x00\x00\x00') # noqa: E501 > # noqa: E501 N)rr\rrgrdZ__fvalrcrQrQrRbind_bottom_upos rcKs,|dur|||j|_||j|<dS)aBind 2 layers for building. When the upper layer is added as a payload of the lower layer, all the arguments will be applied to them. ex: >>> bind_top_down(Ether, SNAP, type=0x1234) >>> Ether()/SNAP() > N)rrfrrrQrQrR bind_top_downs  rcKs:|dur||t||fi|t||fi|dS)aHBind 2 layers on some specific fields' values. It makes the packet being built and dissected when the arguments are present. This function calls both bind_bottom_up and bind_top_down, with all passed arguments. Please have a look at their docs: - help(bind_bottom_up) - help(bind_top_down) N)rrrrrQrQrR bind_layerss rc s:|dur|fddfdd|jD|_dS)zrThis call un-links an association that was made using bind_bottom_up. Have a look at help(bind_bottom_up) Ncs(tfddtD}|kp&|S)Nc3s&|]\}}|vp||kVqdSrOrQruparamsrQrRrZsz5split_bottom_up..do_filter..)anyr`ra)rrPZparams_is_invalid)rcrdrrR do_filters z"split_bottom_up..do_filtercsg|]}|r|qSrQrQrXr)r rQrRrr[z#split_bottom_up..)rr\rrQ)r rcrdrRsplit_bottom_ups  r c s^|dur||||jvrZ|j|tfddt|DrFdS|j|_|j|=dS)zpThis call un-links an association that was made using bind_top_down. Have a look at help(bind_top_down) Nc3s&|]\}}|vp||kVqdSrOrQruZofvalrQrRrZr[z!split_top_down..)rrfrr`rarrrQr rRsplit_top_downs     r cKs:|dur||t||fi|t||fi|dS)zSplit 2 layers previously bound. This call un-links calls bind_top_down and bind_bottom_up. It is the opposite of # noqa: E501 bind_layers. Please have a look at their docs: - help(split_bottom_up) - help(split_top_down) N)rr r rrQrQrR split_layerss rcCs|durhtjstdz ddl}Wnty>tdYn0t|dsRtdddlm}m}ddl m }d d }t|d rd d }|t d tj |t dt ddft ddft ddfgd}||}|dkrtj}dd|D} nT|dkrJddlm} tttttf| dd} dd| D} dd| D} ndSt jrddd| D} |dkrtt} | D]\} }d| vr| d}| }|ddD](}||vri||<||}||d <qd!|vrg|d!<|d!|d|fn| d!| |fqzn|dkr$d!| i} | }g}t|}d"d|D|d!g}d#}|rdtd$d%|d&dD|d f}d'||rd|nd#}||t d tj |t d(||rd)ndd*}||}|dur|r|}q,ndS| d+r&||||d&d}n|r@|d|}q@q,|dkrdd,lm!}||d-|}nt"|t#j$r||j%}t"|tr| d.r|}nr| d-r|&d-d#}dd,lm!}||d/|d0|}}|tjj'vr|}n |tjj'vr|}n td1|n t(d2dSztjj'|}Wn t)yJtd1|Yn0t*tj+,d3|g}d4d|D}t*t-|d5gdd6dS)7aCFunction used to discover the Scapy layers and protocols. It helps to see which packets exists in contrib or layer files. params: - layer: If specified, the function will explore the layer. If not, the GUI mode will be activated, to browse the available layers examples: >>> explore() # Launches the GUI >>> explore("dns") # Explore scapy.layers.dns >>> explore("http2") # Explore scapy.contrib.http2 >>> explore(scapy.layers.bluetooth4LE) Note: to search a packet by name, use ls("name") rather than explore. NzZexplore() GUI-mode cannot be run in interactive mode. Please provide a 'layer' parameter !rzgprompt_toolkit is not installed ! You may install IPython, which contains it, via `pip install ipython`)rrz%prompt_toolkit >= 2.0.0 is required !)radiolist_dialog button_dialog)HTMLcSs tt|SrO)r5rr"rQrQrRrr[zexplore..)rrcSs|SrO)runr"rQrQrRrr[z Scapy v%szQZLayersrZContribsZcontribsZCancelcancel)titler%ZbuttonscSs4g|],}d|dvs,d|dvs,d|dvr|qS)rrpacketZasn1rQr rQrQrRr,s  zexplore..) list_contribT)rcSsg|]}|d|dfqS)r: descriptionrQr rQrQrRr3scSsg|]}d|dvr|qS)ZcanrrQr rQrQrRr6r[cSs$g|]\}}t|t|fqSrQ)r` text_type)rXrrrQrQrRr<srr6rjZ_lcSs0g|](}|dsd|td|fqS)rX$z[+] ) startswithr`r capitalize)rXr:rQrQrRr\s rcss|]}|dVqdS)rjNrQr rQrQrRrZdr[zexplore..rNz0 znZBack)valuesrr%Z cancel_textr) load_contribzscapy.contrib.z scapy.layers.zscapy.layers.%szscapy.contrib.%szUnknown scapy module '%s'z%Wrong usage ! Check out help(explore)zPackets contained in %s:cSs g|]}|jpd|jpdfqS)r)r^rj)rXZlayrQrQrRrr[)ClassName)Zborders).r interactiver$prompt_toolkitrUrZ prompt_toolkit.shortcuts.dialogsrrZprompt_toolkit.formatted_textrr`rrrZ scapy.mainrr5r,r*rrrr{rrkeysrr_rrrtrrrntypes ModuleTyper^rZldictr&rur]rrr")rr!rrrZcall_ptkZbtn_diagactionZlvaluesrrZcvaluestreer:descpartsZsubtreeparpreviousfoldersZ _radio_valuesZcur_pathZ extra_textZrd_diagresultrZ result_layerZresult_contrib all_layersZrtlstrQrQrRexplores                                     r.Fc Cs&t|t}t|ts|stg}|jD]}|}g}g}t|ttfrnt|trf||jj dd|j }q8|j }|j } |rt|t rt|drt|jpgdkr|ddtt|jDnt|trT|tt|r|n|} |d| |r|j|tt|r|n|i} t| dkr|ddtt| Dnh|r~t|tr~|j} |d | n>t|tr|jj } |d d dt |j!|jfgD|j} |rd d |nd }t|t"r|d |j#|j#dkrdnd f7}||| |t$| |fq&|S)zInternal function used to resolve `fields_desc` to display it. :param obj: a packet object or class :returns: a list containing tuples [(name, clsname, clsname_extras, default, long_attrs)] Nri2s2css|]\}}d||fVqdSz%s: %dNrQrXZnumvalstrvalrQrQrRrZsz_pkt_ls..z Depends on %scss|]\}}d||fVqdSr1rQr2rQrQrRrZsrUcss|]}|djjVqdS)rN)rkr^r rQrQrRrZsz(%s)rz (%d bit%s)rNr)%rnr7r!rrsrrrrkr^rr:rr rrr/extendrr`rar Z depends_onr5Z i2s_multirr namesr_r dfltrrfldsrr&r)objverboseis_pktr<rZcur_fldr long_attrsr:rZ fld_dependZcur_i2sr5rPZclass_name_extrasrQrQrR_pkt_lss           r<cstt}dus|rd}dur:d}ttjddd}n^ttt|rNdntj|rhfdd}n fd d}tfd d tjD|d}|D]}t d |j |j fq|rtj rt d nzt|d}tt} |D]x\} } } } }| j d| }t d| |fdd| r4t dt| fddt d| f|D]}t dd|fqFq| rtttjtrWdSt dtjWntyt dYn0dS)zList available layers, or infos on a given layer class or name. :param obj: Packet / packet name to use :param case_sensitive: if obj is a string, is it case sensitive? :param verbose: NFTcSs|jSrO)r^r"rQrQrRr r[zls..)keyrcs|jt|jfSrO)r^rrr"r8rQrRr r[cs|jt|jfSrO)r^rgrrr"r>rQrRr sc3sB|]:}t|jtr|js6t|jtr|jr|VqdSrO)rnr^rsearchr:)rXr)patternrQrRrZ" s     zls..z %-10s : %szL TIP: You may use explore() to navigate through all layers using a clear GUI)r9r z%-10s : %-35s =)endz%-15rz(%r)z%-15s%srz--z?Not a packet class or name. Type 'ls()' to list packet classes.)rnrrrrrecompiler5Irgr]r^rjr r<r7rrGrllsr)r8case_sensitiver9 is_stringZtipr-Zsorterrr<r:rrPZclsner6r;ZclsinforrQ)r8r@rRrE sV        rETcCst|tstdd}g}g}dd}d}|jD]}t|jd} || 7}|d7}|jdd} t d|d } || | } | | d | | |f|d kr| || }} d } g}| sq0qdq0qdq0|r| |g} | d t t |dD]}d }||||d}}|d d|ddkrt dd|d d Dt |d d d}|dd}||kr||d}|d d|d|||d|d }| |qd }|ddddt dDd7}|ddddt d Dd7}t|| D]@\}}||7}|D] \}} }|d|| d7}q|d7}q|d|pVd d7}|r|dd|jdd7}|r|St|d S)a Generate an RFC-like representation of a packet def. :param cls: the Packet class :param ret: return the result instead of printing (def. False) :param legend: show text under the diagram (default True) Ex:: >>> rfc(Ether) zPacket class expectedrcSs d|dS)NrrNrQr"rQrQrRr^ r[zrfc..rNrXr  NrzB+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ r6rcss|]}|dVqdS)rNNrQr rQrQrRrZ r[zrfc..z css|]}t|VqdSrOrr rQrQrRrZ srrcss|]}t|dVqdS)rNrJr rQrQrRrZ srz| z+-z+ zFig. B) issubclassr7rrsrszr:rdrrrrangersumr_zipcenterr^r])rPrZlegendcur_lencur_linelinesZclsizeidentrZflenrZoverZlen1sepsrYsepZaboveZbelowZ pos_aboveZ pos_belowr,linerrXrQrQrRrfcH s      .      rYc Cs |s |}|}t|tsi}g}|jD]~}t|trXt||jD]}t|ddqDq*t|trp| |jq*|j dur*t|t r| |r*| }|dur*|||j<q*|rddt|D}|j||D]2}tt||} | | }|dur|||<q|j||j}q|S)z Transform a layer into a fuzzy layer by replacing some default values by random objects. :param p: the Packet instance to fuzz :return: the fuzzed packet. rN)_inplaceNcSs(i|] \}}|t|tr |n|qSrQ)rnrr})rXr=rrQrQrRr szfuzz..)rrnrlrsrrr:fuzzr rrrrZrandvalr`rar;rr5rvZ _find_fld_pktrG) r rZrZnew_default_fieldsZmultiple_type_fieldsrrZrndr:rrQrQrRr[ s<          r[)N)N)N)N)N)N)N)F)NFF)FT)r)b__doc__ __future__rr collectionsrrBr8rrr#rZ scapy.fieldsrrrrr r r r r rrrZ scapy.configrrZ scapy.compatrrrZscapy.base_classesrrrrrZscapy.interfacesrZscapy.volatilerrZ scapy.utilsrrr r!r"r#Z scapy.errorr$r%r&Zscapy.libs.test_pyxr'Zscapy.libs.sixZlibsr`r(r)r*r+r,r-r.r/r0r1r2r3r4r5r$rUrr6with_metaclassr7rlrrrrqZ default_l2rrcommandsregisterrr r rr.r<rErYr[rQrQrQrRs   8   @  E6        F N D m