-Phj dZddlZddlZddlZddlZdZdZdZdZdZ da dZ d Z d Z d Zd Zd ZdZdZdZdZdZejZdZdZdZGddeZdZdZdZ ej Z!n#e"$rdZ!YnwxYwGddeZ#GddZ$Gd d!Z%Gd"d#e%Z&Gd$d%Z'd&Z(Gd'd(Z)d)Z*de*_+Gd*d+e%Z,Gd,d-e-Z.Gd.d/e%Z/Gd0d1e%Z0Gd2d3Z1Gd4d5Z2Gd6d7e%Z3Gd8d9e%Z4Gd:d;e%Z5Gd<d=e%Z6Gd>d?e%Z7Gd@dAe7Z8GdBdCe%Z9GdDdEe%Z:GdFdGe%Z;GdHdIe%Z<GdJdKe%Z=GdLdMe%Z>dNZ?GdOdPe%Z@GdQdRe%ZAdSZBdTZCGdUdVZDdWZE dXZFeFejGGdYdZZHGd[d\ejIZJeJd]ZKGd^d_ejIZLGd`daejIZMeNejHdbreLeMGdcddejIZOeOGdedfejIZPePGdgdhejIZQeQGdidjejIZReRddlSZSddlTZTddlUZUddlVZVddlWZWddlXZXddlYZYdkZZGdldmejIZ[e[dnZ\Gdodpej]Z^e^dqGdrdse^Z_e_dtGdudvejIZ`e`dwejaejbGdxdyZcdd{ZdejdZeede_decZfd|Zgdd}Zhd~ZidZjGddejIZkGddZlGddelZmGddZnGddekenZoGddeoZpGddekZqGddekZrGddekZsdZtdZudZvGddZwGddewZxGddejIZydZzGddejIZ{ejddeNedreodemZ|epdemZ}eieqdemZ~erdemZesdemZeyddZe{dejejbZdSeTjddS)a- From gdb 7 onwards, gdb's build can be configured --with-python, allowing gdb to be extended with Python code e.g. for library-specific data visualizations, such as for the C++ STL types. Documentation on this API can be seen at: http://sourceware.org/gdb/current/onlinedocs/gdb/Python-API.html This python module deals with the case when the process being debugged (the "inferior process" in gdb parlance) is itself python, or more specifically, linked against libpython. In this situation, almost every item of data is a (PyObject*), and having the debugger merely print their addresses is not very enlightening. This module embeds knowledge about the implementation details of libpython so that we can emit useful visualizations e.g. a string, a list, a dict, a frame giving file/line information and the state of local variables In particular, given a gdb.Value corresponding to a PyObject* in the inferior process, we can generate a "proxy value" within the gdb process. For example, given a PyObject* in the inferior process that is in fact a PyListObject* holding three PyObject* that turn out to be PyBytesObject* instances, we can generate a proxy value within the gdb process that is a list of bytes instances: [b"foo", b"bar", b"baz"] Doing so can be expensive for complicated graphs of objects, and could take some time, so we also have a "write_repr" method that writes a representation of the data to a file-like object. This allows us to stop the traversal by having the file-like object raise an exception if it gets too much data. With both "proxyval" and "write_repr" we keep track of the set of all addresses visited so far in the traversal, to avoid infinite recursion due to cycles in the graph of object references. We try to defer gdb.lookup_type() invocations for python types until as late as possible: for a dynamically linked python binary, when the process starts in the debugger, the libpython.so hasn't been dynamically loaded yet, so none of the type names are known to the debugger The module also extends gdb with some python-specific commands. NcNtjdS)Nchargdb lookup_typepointerY/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/Cython/Debugger/libpython.py_type_char_ptrr ?s ?6 " " * * , ,,r cNtjdS)Nz unsigned charrr r r _type_unsigned_char_ptrrCs ?? + + 3 3 5 55r cNtjdS)Nzunsigned shortrr r r _type_unsigned_short_ptrrGs ?+ , , 4 4 6 66r cNtjdS)Nz unsigned intrr r r _type_unsigned_int_ptrrKs ?> * * 2 2 4 44r cXtjdjS)Nvoid)rrrsizeofr r r _sizeof_void_prOs! ?6 " " * * , , 33r iiiiiii i@li0123456789abcdefz!(frame information optimized out)z*Unable to read information on python frame_PyEval_EvalFrameDefaultceZdZdS)NullPyObjectPtrN__name__ __module__ __qualname__r r r rrkDr rc"t|dS)Ni)minvals r safety_limitr$os sD>>r cTttt|SN)ranger$intr"s r safe_ranger)vs  c#hh'' ( ((r c0||dSr&)write)filetexts r write_unicoder.{sJJtr ct|ts|Stj}|dkr||Sg}|D]i}dt |cxkrdkr#nn t t |dz }n||}||jd|S)Nmbcsii) isinstanceunicodesysgetfilesystemencodingencodeordchrappendjoin)filenameencodingencodedrbytes r os_fsencoder@s(G,, O,.. v  ??8,, , ! !DT,,,,f,,,,,3t99v-..{{8,, NN4 wwwr ceZdZdS)StringTruncatedNrr r r rBrBrr rBc&eZdZdZddZdZdZdS)TruncatedStringIOz^Similar to io.StringIO, but can truncate the output by raising a StringTruncated exceptionNc"d|_||_dS)Nr2)_valmaxlen)selfrGs r __init__zTruncatedStringIO.__init__s  r c|jrmt|t|jz|jkr@|xj|d|jt|jz z c_t|xj|z c_dSNr)rGlenrFrB)rHdatas r r+zTruncatedStringIO.writesu ; (4yy3ty>>)DK77 T!DK#di..$@"@AA %''' T r c|jSr&)rFrHs r getvaluezTruncatedStringIO.getvalue yr r&)rrr__doc__rIr+rPr r r rDrDsP!!r rDceZdZdZdZddZdZdZdZdZ d Z d Z d Z d Z d ZdZedZedZedZdZdS) PyObjectPtrak Class wrapping a gdb.Value that's either a (PyObject*) within the inferior process, or some subclass pointer e.g. (PyBytesObject*) There will be a subclass for every refined PyObject type that we care about. Note that at every stage the underlying pointer could be NULL, point to corrupt data, etc; this is the debugger, after all. PyObjectNcP|r|||_dS||_dSr&)cast_gdbvalrHgdbvalcast_tos r rIzPyObjectPtr.__init__s,  "!;;w//DLLL!DLLLr c|rt||dkrK|jt}||S|dkrK|jt}||S|j|S)a Get the gdb.Value for the given field within the PyObject, coping with some python 2 versus python 3 differences. Various libpython types are defined using the "PyObject_HEAD" and "PyObject_VAR_HEAD" macros. In Python 2, this these are defined so that "ob_type" and (for a var object) "ob_size" are fields of the type in question. In Python 3, this is defined as an embedded PyVarObject type thus: PyVarObject ob_base; so that the "ob_size" field is located insize the "ob_base" field, and the "ob_type" is most easily accessed by casting back to a (PyObject*). ob_typeob_size)is_nullrrXrWrT get_gdb_type dereferencePyVarObjectPtr)rHnamepyo_ptrs r fieldzPyObjectPtr.fields <<>> (!$'' ' 9  l'' (@(@(B(BCCG&&((. . 9  l''(C(C(E(EFFG&&((. .|''))$//r c\t||S)z Get a PyObjectPtr for the given PyObject* field within this PyObject, coping with some python 2 versus python 3 differences. )rTfrom_pyobject_ptrrerHrcs r pyop_fieldzPyObjectPtr.pyop_fields$ ,,TZZ-=-=>>>r c\||}|||dS)zz Extract the PyObject* field named "name", and write its representation to file-like object "out" N)ri write_repr)rHrcoutvisited field_objs r write_field_reprzPyObjectPtr.write_field_reprs1 OOD)) S'*****r ct|} ||tn'#t$r|dzcYSwxYw|S)z Get a repr-like string for the data, but truncate it at "maxlen" bytes (ending the object graph traversal as soon as you do) z...(truncated))rDrksetrBrP)rHrGrls r get_truncated_reprzPyObjectPtr.get_truncated_reprsv  '' 5 OOC ' ' ' ' 5 5 5<<>>$44 4 4 4 5 ||~~s"4!AAcFt|dS)Nr])PyTypeObjectPtrrerOs r typezPyObjectPtr.typestzz)44555r c2dt|jkSrKr(rXrOs r r_zPyObjectPtr.is_nullsC %%%%r c|jjS)a< Is the value of the underlying PyObject* visible to the debugger? This can vary with the precise version of the compiler used to build Python, and the precise version of gdb. See e.g. https://bugzilla.redhat.com/show_bug.cgi?id=556975 with PyEval_EvalFrameEx's "f" )rXis_optimized_outrOs r ryzPyObjectPtr.is_optimized_outs|,,r c |}|d}|S#ttt f$rYdSwxYw)Ntp_nameunknown)rurestringr RuntimeErrorUnicodeDecodeError)rHr]r{s r safe_tp_namezPyObjectPtr.safe_tp_name sa iikkGmmI..G>>## # /AB   99 s.FakeReprz Class representing a non-descript PyObject* value in the inferior process for when we don't have a custom scraper, intended to have a sane repr(). c"||_||_dSr&)r{address)rHr{rs r rIz/PyObjectPtr.proxyval..FakeRepr.__init__,s& & r c>|jdkrdSd|j|jfzS)Nr0x0<%s at remote 0x%x>)rr{rOs r __repr__z/PyObjectPtr.proxyval..FakeRepr.__repr__0s*<1$$ 5, dl/KKKr NrrrrRrIrr r r FakeReprr%sA    ' ' ' L L L L Lr r)rr(rX)rHrmrs r proxyvalzPyObjectPtr.proxyvalsc" L L L L L L L L&x))++DL))++ +r cl|t||S)z Write a string representation of the value scraped from the inferior process to "out", a file-like object. )r+reprrrHrlrms r rkzPyObjectPtr.write_repr;s*yydmmG4455666r c \ |d}t|d}n#ttf$r|cYSwxYwt t ttttttd}||vr||S|tzrtS|tzrtS|t zrt"S|t$zrt&S|t(zrt*S|t,zrt.S|t0zrt2S|t4zrt6S|S)a Given a PyTypeObjectPtr instance wrapping a gdb.Value that's a (PyTypeObject*), determine the corresponding subclass of PyObjectPtr to use Ideally, we would look up the symbols for the global types, but that isn't working yet: (gdb) python print gdb.lookup_symbol('PyList_Type')[0].value Traceback (most recent call last): File "", line 1, in NotImplementedError: Symbol type not yet supported in Python scripts. Error while executing Python code. For now, we use tp_flags, after doing some string comparisons on the tp_name for some special-cases that don't seem to be visible through flags r{tp_flags)boolclassobjNoneTypeframerq frozensetbuiltin_function_or_methodzmethod-wrapper)rer}r(r~rPyBoolObjectPtrPyClassObjectPtrPyNoneStructPtrPyFrameObjectPtrPySetObjectPtrPyCFunctionObjectPtr wrapperobjectPy_TPFLAGS_HEAPTYPEHeapTypeObjectPtrPy_TPFLAGS_LONG_SUBCLASSPyLongObjectPtrPy_TPFLAGS_LIST_SUBCLASSPyListObjectPtrPy_TPFLAGS_TUPLE_SUBCLASSPyTupleObjectPtrPy_TPFLAGS_BYTES_SUBCLASSPyBytesObjectPtrPy_TPFLAGS_UNICODE_SUBCLASSPyUnicodeObjectPtrPy_TPFLAGS_DICT_SUBCLASSPyDictObjectPtrPy_TPFLAGS_BASE_EXC_SUBCLASSPyBaseExceptionObjectPtr)clstr{rname_maps r subclass_from_typezPyObjectPtr.subclass_from_typeEsR& ggi((//11G177:..//HH01   JJJ , 0 /-*"03G&3 h  G$ $ ) ) %$ $ . . #" " . . #" " / / $# # / / $# # 1 1 &% % . . #" " 2 2 ,+ +  sA A A"!A"c t|}||}|||S#t$rYnwxYw||S)zt Try to locate the appropriate derived class dynamically, and cast the pointer accordingly. )r[)rTrrur`r~)rrZps r rgzPyObjectPtr.from_pyobject_ptrs  F##A((22C3vs'7'7'9'9::: :    D s6{{sAA A$#A$cXtj|jSr&)rr _typenamer)rs r r`zPyObjectPtr.get_gdb_types s}--55777r c*t|jSr&rwrOs r as_addresszPyObjectPtr.as_addresss4<   r r&)rrrrRrrIrerirorrrur_ryrrrk classmethodrrgr`rr r r rTrTs4  I"""" 000<???+++   666&&& - - -   %+%+%+N777@@[@D  [ 88[8!!!!!r rTceZdZdZdS)rb PyVarObjectNrrrrr r r rbrbsIIIr rbceZdZdZdZdZdS)ProxyAlreadyVisitedz Placeholder proxy to use when protecting against infinite recursion due to loops in the object graph. Analogous to the values emitted by the users of Py_ReprEnter and Py_ReprLeave c||_dSr&_rep)rHreps r rIzProxyAlreadyVisited.__init__s  r c|jSr&rrOs r rzProxyAlreadyVisited.__repr__rQr Nrr r r rrs< r rc|d||t|tr|dd}|D]q\}}|s|dd}||||d|||r|d|d|zd S) zXShared code for use by all classes: write a representation to file-like object "out"<(T, F=)z at remote 0x%x>N)r+r3r iteritemsrrk)rlrmrc pyop_attrdictrfirstpyop_argpyop_vals r _write_instance_reprrsIIcNNNIIdOOO-11  #"/"9"9";"; . . Hh  $E IIh''00 1 1 1 IIcNNN   W - - - - #II 7*+++++r ceZdZdZdZdS) InstanceProxyc0||_||_||_dSr&)cl_nameattrdictr)rHrrrs r rIzInstanceProxy.__init__s    r ct|jtrHdd|jD}d|j||jfzSd|j|jfzS)Nrc"g|] \}}|d| S)rr ).0argr#s r z*InstanceProxy.__repr__..s= K K K$,C,/33 4 K K Kr z<%s(%s) at remote 0x%x>r)r3rdictr;rrr)rHkwargss r rzInstanceProxy.__repr__s dmT * * :YY K K04 0G0G0I0I K K KLLF, 06 0FF F)DL,0L,:: :r NrrrrIrr r r rrs2 :::::r rc6tjtjdt_|d||dzzt dz zt dz ztjS)Nsize_t tp_basicsize tp_itemsize)_PyObject_VAR_SIZE _type_size_trrrerrW)typeobjnitemss r rrs&.*-/(*C*C'}}^,, m4445  1$&"##a'()T$1 2 2 3r c$eZdZdZdZdZdZdS)rrUc |}t|d}|dkr+|dkrtjd}t|j|d}|dkr| }t||}||z }|dksJ|tzdksJ|jt|z}t }||}t |Sn#t$rYnwxYwdS)zw Get the PyDictObject ptr representing the attribute dictionary (or None if there's a problem) tp_dictoffsetrrr^N)ru int_from_intrerrrrXrWrrr rTr`rgrar~)rHr dictoffsettype_PyVarObject_ptrtsizesizedictptrPyObjectPtrPtrs r get_attr_dictzHeapTypeObjectPtr.get_attr_dictsm  iikkG%gmmO&D&DEEJQ>>+.?=+I+I+Q+Q+S+S(():):;O)P)PQZ)[\\Eqyy!&-gu==D$&J%>>>>%(8(88A====,++N,<,<== J!,!9!9!;!;!C!C!E!E!,,~66"44W5H5H5J5JKKK    D  tsE'E++ E87E8cd||vrtdS|||}|r||}ni}|}t ||t|jS)z Support for classes. Currently we just locate the dictionary using a transliteration to python of _PyObject_GetDictPtr, ignoring descriptors <...>) rraddrrrrr(rX)rHrmpyop_attr_dict attr_dictr{s r rzHeapTypeObjectPtr.proxyvals ??   ' '&w// / DOO%%&&&++--  &//88III##%%WiT\1B1BCCCr cD||vr|ddS|||}t |||||dS)Nr)rr+rrrr)rHrlrmrs r rkzHeapTypeObjectPtr.write_reprs ??   ' ' IIg    F DOO%%&&&**,, S'!..00-ARAR T T T T Tr N)rrrrrrrkr r r rrsNI<DDD, T T T T Tr rceZdZdZdZdS)ProxyExceptionc"||_||_dSr&r{args)rHr{rs r rIzProxyException.__init__$s  r c"|j|jSr&rrOs r rzProxyException.__repr__(styy11r Nrr r r rr#s222222r rc"eZdZdZdZdZdZdS)rz} Class wrapping a gdb.Value that's a PyBaseExceptionObject* i.e. an exception within the process being debugged. PyBaseExceptionObjectc.||vrtdS|||d|}t ||SN(...)r)rrrrirrr)rHrm arg_proxys r rz!PyBaseExceptionObjectPtr.proxyval2s ??   ' '&w// / DOO%%&&&OOF++44W== d//11')) )r c*||vr|ddS|||||d||dSr)rr+rrrors r rkz#PyBaseExceptionObjectPtr.write_repr;s ??   ' ' IIg    F DOO%%&&& $##%%&&& fc733333r N)rrrrRrrrkr r r rr+sC(I)))44444r rceZdZdZdZdS)rz~ Class wrapping a gdb.Value that's a PyClassObject* i.e. a instance within the process being debugged. PyClassObjectN)rrrrRrr r r rrEs IIIr rceZdZdZdZdS)BuiltInFunctionProxyc||_dSr&ml_name)rHr s r rIzBuiltInFunctionProxy.__init__Ns  r cd|jzS)Nzr rOs r rzBuiltInFunctionProxy.__repr__Qs'$,66r Nrr r r rrMs277777r rceZdZdZdZdS)BuiltInMethodProxyc"||_||_dSr&)r  pyop_m_self)rHr rs r rIzBuiltInMethodProxy.__init__Us &r cxd|j|j|jfzS)Nz0)r rrrrOs r rzBuiltInMethodProxy.__repr__Ys=B<#0022#..0022 r Nrr r r r r Ts2'''r r ceZdZdZdZdZdS)rz| Class wrapping a gdb.Value that's a PyCFunctionObject* (see Include/methodobject.h and Objects/methodobject.c) PyCFunctionObjectc|d} |d}n#t$rd}YnwxYw|d}|rt |St ||S)Nm_mlr zm_self)rer}rrir_rr )rHrmrr rs r rzPyCFunctionObjectPtr.proxyvalgszz&!! 59o,,..GG! 5 5 54GGG 5ooh//     <'00 0%g{;; ;s2 AANrrrrRrrr r r rr`s4$I < < < <  instance within the process being debugged. PyCodeObjectcb|dt}t|d}d}t |ddd|dddD]3\}}|t |z }||kr|cS|t |z }4|S)z Get the line number for a given bytecode offset Analogous to PyCode_Addr2Line; translated from pseudocode in Objects/lnotab_notes.txt co_lnotabco_firstlinenorNr)rirrqrrezipr8)rHaddrqrlinenoaddr addr_incr line_incrs r addr2linezPyCodeObjectPtr.addr2line|sOOK0099#%%@@ djj)9::;;$' ##A# !$Q$$H$H % % Iy C NN "De|| c)nn $FF r N)rrrrRrr$r r r rrus4Ir rc.eZdZdZdZdZdZdZdZdS)rzw Class wrapping a gdb.Value that's a PyDictObject* i.e. a dict instance within the process being debugged. PyDictObjectc#K|d}|d}||\}}t|D]}||}t|r!t||}n t|d}|s&t|d}||fVdS)zx Yields a sequence of (PyObjectPtr key, PyObjectPtr value) pairs, analogous to dict.iteritems() ma_keys ma_valuesme_valueme_keyN)re _get_entriesr)r(rTrgr_) rHkeysvaluesentriesnentriesiep pyop_valuepyop_keys r rzPyDictObjectPtr.iteritemss zz)$$K(( --d33H%% - -AB6{{ K(::6!9EE (::2j>JJ %%'' -&88HFF,,,, - -r c4||vrtdS||i}|D]4\}}||}||}|||<5|S)N{...})rrrrr)rHrmresultr4r3 proxy_key proxy_values r rzPyDictObjectPtr.proxyvals ??   ' '&w// / DOO%%&&&$(NN$4$4 , , Hj ))'22I$--g66K +F9   r c||vr|ddS|||dd}|D]_\}}|s|dd}||||d|||`|ddS)Nr6{TrF: })rr+rrrk)rHrlrmrr4r3s r rkzPyDictObjectPtr.write_reprs ??   ' ' IIg    F DOO%%&&& #$(NN$4$4 0 0 Hj  $E   W - - - IIdOOO  ! !#w / / / / #r ct|d}t|d} |d|fS#t$rYnwxYw|dkr|}n|dkrd|z}n|dkrd|z}nd |z}|d j}|t |z}t jd }||}||fS) N dk_nentriesdk_size dk_entriesirl dk_indicesPyDictKeyEntry)r(r~rrWrrrr)rHr-r?r@offsetent_addr ent_ptr_ts r r,zPyDictObjectPtr._get_entriess$}-.. d9o&&  %w. .    D  d??FF   [FF  " "[FF[F %-==!8!:!:;;fDO$455==?? ==++$$s 6 AAN) rrrrRrrrrkr,r r r rrsaI---$   $%%%%%r rc$eZdZdZdZdZdZdS)r PyListObjectc<|d}||SNob_itemrerHr1 field_ob_items r __getitem__zPyListObjectPtr.__getitem__ 9-- Qr cvrtdSfdtt dD}|S)N[...]cvg|]5}t|6Sr rTrgrrr1rHrms r rz,PyListObjectPtr.proxyval..sOLLL//Q88AA'JJLLLr r^)rrrr)rrerHrmr7s`` r rzPyListObjectPtr.proxyvals ??   ' '&w// / DOO%%&&&LLLLL%l4::i3H3H&I&IJJLLL r c||vr|ddS|||dtt |dD]S}|dkr|dt ||}|||T|ddS)NrU[r^rr] rr+rr)rrerTrgrkrHrlrmr1elements r rkzPyListObjectPtr.write_reprs ??   ' ' IIg    F DOO%%&&& #LI)>)>??@@ - -A1uu $!33DG<.&sB555hqk""Qq\1555r )r(rerrrr)abssum)rHrmr^digitsr7rjrds @@r rzPyLongObjectPtr.proxyval s$djj++,, a<<1::j)) ?7 # # *a / /EEE55555%c'll33555V Q;;WF r c`||}|d|zdS)Nz%srr+rHrlrmproxys r rkzPyLongObjectPtr.write_repr-s/ g&& $,r N)rrrrrrkr r r rrs8I"""H     r rceZdZdZdZdS)rz Class wrapping a gdb.Value that's a PyBoolObject* i.e. one of the two instances (Py_True/Py_False) within the process being debugged. c@t||rdSdS)NTF)rrrHrms r rzPyBoolObjectPtr.proxyval8s$  # #D' 2 2 45r N)rrrrRrr r r rr3s-r rceZdZdZdZdZdS)rz Class wrapping a gdb.Value that's a PyObject* pointing to the singleton (we hope) _Py_NoneStruct with ob_type PyNone_Type rUcdSr&r rts r rzPyNoneStructPtr.proxyvalEstr Nrr r r rr>s4Ir rcPeZdZdZd dZdZdZdZdZdZ d Z d Z d Z d Z dS)r PyFrameObjectNct||||s#t|d|_|jd|_|jd|_ t|d|_ t|d|_ t|jd|_ t|jd|_dSdS)Nf_codeco_name co_filenamef_linenof_lasti co_nlocals co_varnames)rTrIryrrgrecorir{r|rr}r~rrrrYs r rIzPyFrameObjectPtr.__init__Ls T67333$$&& `%77 88L8LMMDG7--i88DL#w11-@@D (J)?)?@@DM' 9(=(=>>DL*47==+F+FGGDO/AA$'--P]B^B^__D    ` `r c#LK|rdS|d}t|jD]a}t||}|s+t|j|}||fVbdS)z Yield a sequence of (name,value) pairs of PyObjectPtr instances, for the local variables of this frame N f_localsplus)ryrer)rrTrgr_r)rHrr1r3 pyop_names r iter_localszPyFrameObjectPtr.iter_localsYs  " "  Fzz.11 DO,, . .A$66|AGGJ%%'' .'99$:J1:MNN  *----  . .r c|rdS|d}|S)z Yield a sequence of (name,value) pairs of PyObjectPtr instances, for the global variables of this frame r f_globalsryrir)rH pyop_globalss r iter_globalszPyFrameObjectPtr.iter_globalshs@  " " 2{33 %%'''r c|rdS|d}|S)zt Yield a sequence of (name,value) pairs of PyObjectPtr instances, for the builtin variables r f_builtinsr)rH pyop_builtinss r iter_builtinszPyFrameObjectPtr.iter_builtinsss@  " " 2 55 &&(((r c|D]0\}}||tkr|dfcS1|D]0\}}||tkr|dfcS1|D]0\}}||tkr|dfcS1dS)z Look for the named local variable, returning a (PyObjectPtr, scope) pair where scope is a string 'local', 'global', 'builtin' If not found, return (None, None) localglobalbuiltinNN)rrrqrr)rHrcrr3s r get_var_by_namez PyFrameObjectPtr.get_var_by_name~s&*%5%5%7%7 + + !Izy))#%%0000!7****1%)%6%6%8%8 , , !Izy))#%%0000!8++++1%)%7%7%9%9 - - !Izy))#%%0000!9,,,,1zr c|rtS|jt S)z;Get the path of the current Python source file, as a string)ryFRAME_INFO_OPTIMIZED_OUTr|rrqrOs r r<zPyFrameObjectPtr.filenames7  " " ,+ +((///r c|rdS|d}t|dkr|jS |j|jS#t$rYdSwxYw)zGet current line number as an integer (1-based) Translated from PyFrame_GetLineNumber and PyCode_Addr2Line See Objects/lnotab_notes.txt Nf_tracer)ryrer(r}rr$r~ Exception)rHrs r current_line_numz!PyFrameObjectPtr.current_line_nums  " " 4**Y'' w<<1  =  7$$T\22 2    44  sA&& A43A4c|rtS|}|dS|} t t |5}|}dddn #1swxYwYn#t$rYdSwxYw ||dz S#t$rYdSwxYw)z^Get the text of the current source line as a string, with a trailing newline characterNz!(failed to get frame line number)r) ryrrr<openr@ readlinesOSError IndexError)rHr r<fpliness r current_linezPyFrameObjectPtr.current_lines  " " ,+ +&&(( >66==?? k(++,, '  ' ' ' ' ' ' ' ' ' ' ' ' ' ' '   44  !$ $   44 sH B%B: BB  B B B B B $ B// B=<B=c |r|tdS|}|t |nd}|d||j|||j|fzd}| D]q\}}|s|dd}||||d| ||r|ddS)N?z)Frame 0x%x, for file %s, line %s, in %s (TrFrr) ryr+rrstrrr|rr{rrk)rHrlrmr rrr3s r rkzPyFrameObjectPtr.write_reprsK  " "  II. / / / F&&(( & 2V =__&&%..w77\**73355 6 6 6 %)%5%5%7%7 0 0 !Iz  $E IIi((11 2 2 2 IIcNNN  ! !#w / / / / #r c |r)tjdtzdSt }|}|t|nd}tjd|j |d|d|j |ddS)N %s rz File "z", line z, in  ) ryr5stdoutr+rrqrrr|rr{)rHrmr s r print_tracebackz PyFrameObjectPtr.print_tracebacks  " "  J  X(@@ A A A F%%&&(( & 2V %..w7777VV\**733335 6 6 6 6 6r r&)rrrrrIrrrrr<rrrkrr r r rrIsI ` ` ` ` . . . ( ( ( ) ) )$000 0.. 6 6 6 6 6r rc:eZdZdZedZdZdZdZdS)r PySetObjectcNtjdS)N _PySet_Dummy)rlookup_global_symbolvaluerOs r _dummy_keyzPySetObjectPtr._dummy_keys'77==???r c#K|}|d}t|ddzD]:}||}|d}|dkr"||krt|V;dS)Ntablemaskrkeyr)rrer)rTrg)rH dummy_ptrrr1setentryrs r __iter__zPySetObjectPtr.__iter__sOO%%  7##DJJv..233 9 9AQxH5/CaxxC9,,!33C88888  9 9r cN|vr$td|zS|fd|D}|dkrt |St |S)Nz%s(...)c3BK|]}|VdSr&)r)rrrms r z*PySetObjectPtr.proxyval..s/99S3<<((999999r r)rrrrrrq)rHrmmemberss ` r rzPySetObjectPtr.proxyvals ??   ' '&y43D3D3F3F'FGG G DOO%%&&&9999D999     + - -W%% %w<< r c|}||vr|ddS|||ds,|||ddS|dkr*|||d|dd}|D]1}|s|dd }|||2|d |dkr|d dSdS) Nrusedz()rqrr;TrFr=r)rrr+rrerk)rHrlrmr{rrs r rkzPySetObjectPtr.write_reprsR##%% ??   ' ' IIg    F DOO%%&&&zz&!!  IIg    IIdOOO F e   IIg    IIcNNN # ) )C  $E NN3 ( ( ( ( # e   IIcNNNNN  r N) rrrrrrrrrkr r r rrsbI@@[@999    r rc$eZdZdZdZdZdZdS)r PyBytesObjectc|d}|d}|jtdfdt |DS)Nr^ob_svalr2c:g|]}t|Sr r9)rr1char_ptrs r rz,PyBytesObjectPtr.__str__..-s%LLLQHQK((LLLr )rerrWrr;r))rH field_ob_size field_ob_svalrs @r __str__zPyBytesObjectPtr.__str__)sq 9--  9--  (--.E.G.GHHwwLLLL*]2K2KLLLMMMr c t|Sr&)rrts r rzPyBytesObjectPtr.proxyval/s4yyr c:||}d}d|vrd|vrd}|d|||D]6}||ks|dkr+|d||:|dkr|dV|dkr|dr|d kr|d |d kst|d krz|d |tt|dzdz |tt|dz!||8||dS)N'"b\ \tr\n \r \xrCrf)rr+r8 hexdigits)rHrlrmrqquoter?s r rkzPyBytesObjectPtr.write_repr2s g&& %<<u E # %  Du}}  $ $ %     %     %    s4yyD00 %    )SYY%5!$;<=== )CIIO45555 $ %r N)rrrrrrrkr r r rr&sIINNN r rc$eZdZdZdZdZdZdS)r PyTupleObjectc<|d}||SrMrOrPs r rRzPyTupleObjectPtr.__getitem__TrSr c 4vrtdStfdt t dD}|S)Nrc3~K|]7}t|V8dSr&rWrXs r rz,PyTupleObjectPtr.proxyval.._s_QQ#44T!W==FFwOOQQQQQQr r^)rrrtupler)rrerYs`` r rzPyTupleObjectPtr.proxyvalYs ??   ' '&w// / DOO%%&&&QQQQQ *< 98M8M+N+N O OQQQQQ r ch||vr|ddS|||dtt |dD]S}|dkr|dt ||}|||T|ddkr|ddS|ddS) Nrrr^rrrz,)rr]r^s r rkzPyTupleObjectPtr.write_reprcs  ??   ' ' IIg    F DOO%%&&& #LI)>)>??@@ - -A1uu $!33DG<.s#;#;#;qAF#;#;#;r F_basestateasciicompactready wstr_lengthTwstrlengthranykindrrCrc:g|]}t|Sr ri)rr1 field_strs r rz/PyUnicodeObjectPtr.proxyval..s%OOO3y|,,OOOr rr1 r2c<g|]}|dkrt|ndS)iu�r)rucss r rz/PyUnicodeObjectPtr.proxyval..s:$$$SXXXh$$$r ) _is_pep393rrfieldsrer(rrWrrrrr)r$r:r;)rHrmrmay_have_surrogatesrrris_compact_ascii field_length repr_kind Py_UNICODEsr1limitrucs2coder7rs @r rzPyUnicodeObjectPtr.proxyvals,  _%677>>@@F#;#;F#;#;#;;J  9"' jj))GG$E'NE #E'N 3 3 ME)> )/F/H/H I III!^^ )/G/I/I J JII!^^ )/E/G/G H HItzz(3344L 5))I"&//"3"3q"8 # OOOOj6N6NOOOKKKA ..Ee)))A,''Q<<3&==A4E4E&&s+++9Q<((&==D6MMf +v % """4(((Qe))&$$"$$$%% r c ||}d|vrd|vrd}nd}||d}|t|kr||}|dz }||ks|dkr,|d||n|dkr|dnm|dkr|d nP|d kr|d n3|d ks|d krz|d|tt |dz dz|tt |dznt |d kr||n|}d}t jdkre|t|krRdt |cxkrdkr8nn5dt ||cxkrdkrnn||}||z}|dz }t|} | r. |tn#t$rd} YnwxYw| s|0t |dzdz} | t |dzz} | dz } nt |} | dkr`|d|t| dz dz|t| dzn!| dkrC|d|t| dz dz|t| dz dz|t| dz dz|t| dz dz|t| dz dz|t| dz dz|t| dz dz|t| dzn|d |t| dz dz|t| dz dz|t| dz dz|t| dzn,||||||t|k||dS)!NrrrrrrrrrrrrrrrCrfrrr1rFrrrBz\U rDz\u) rr+rLrr8r5 maxunicoderr7ENCODINGUnicodeEncodeError) rHrlrmrqrr1chrch2 printablers r rkzPyUnicodeObjectPtr.write_reprs( g&& %<G++CJJ &#b'' : : : :F : : : : : &#eAh-- A A A A6 A A A A A#Ah 3hQ155 ** 8,,,,-***$) * !%'!$B& 0R7C6 11 *"3xxt|| %((( )TQY&,@"ABBB )D6M":;;;; %((( )TRZ:,E"FGGG )TRZ:,E"FGGG )TRZ:,E"FGGG )TRZ:,E"FGGG )TRZ:,E"FGGG )TQY*,D"EFFF )TQY*,D"EFFF )D:,=">???? %((( )TRZ6,A"BCCC )TQY&,@"ABBB )TQY&,@"ABBB )D6M":;;;;IIbMMM #s#e**nnv %s%I IIN)rrrrrrrkr r r rrsO!I'''FFFPjjjjjr rc0eZdZdZdZdZdZdZdZdS)rc |ddd}t|S#ttt f$rYdSwxYw)Ndescrd_basercz)rer}rrr~rrhs r safe_namezwrapperobject.safe_name@sf $::g&&x08??AAD:: /AB $ $ $### $sAAAAc |dddS#tttf$rYdSwxYw)NrHr]r{z)rer}rr~rrOs r rzwrapperobject.safe_tp_nameGs[ '::f%%i0;BBDD D/AB ' ' '&&& 's25AAc t|d}d|zS#ttf$rYdSwxYw)NrHz%#xz)r(rerr~)rHrs r safe_self_addresssz wrapperobject.safe_self_addresssMsS 2$**V,,--G7? ". 2 2 2111 2s &)>>c|}|}|}d|d|d|dS)Nz)rrr")rHrmrcr{ self_addresss r rzwrapperobject.proxyvalTsR~~##%%..00 44,,,0 1r cZ||}||dSr&rorps r rkzwrapperobject.write_repr[s+ g&& %r N) rrrrrrr"rrkr r r rr=sdI$$$''' 222111r rc t|Sr&rirZs r rr`s v;;r c" t|Sr&)rpprintpformat)r#r+s r stringifyr,dsCyyr ceZdZdZdZdZdS)PyObjectPtrPrinterzPrints a (PyObject*)c||_dSr&r()rHrZs r rIzPyObjectPtrPrinter.__init__qs  r cvt|j} |tSr&)rTrgrZrrMAX_OUTPUT_LENrrqr,)rHpyoprs r to_stringzPyObjectPtrPrinter.to_stringts0,,T[99 '**>:: :r N)rrrrRrIr3r r r r.r.ns8'''''r r.c|j}|jtjkrdS|}t |}|dvrt|SdS)N)rUrxrr)ru unqualifiedrr TYPE_CODE_PTRtargetrr.)rZrurs r pretty_printer_lookupr8~sq ; " " $ $D yC%%%t ;;== $ $ & &D D A MMM!&)))NMr cV|t}|jtdSr&)rpretty_printersr:r8)objs r registerr<s, {455555r ceZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zed ZedZedZdZdZdS)Framez7 Wrapper for gdb.Frame, adding various methods c||_dSr&) _gdbframe)rHgdbframes r rIzFrame.__init__s !r cZ|j}|rt|SdSr&)r@olderr>)rHrCs r rCz Frame.older.$$&&  << 4r cZ|j}|rt|SdSr&)r@newerr>)rHrFs r rFz Frame.newerrDr ct|jdstddS|jdS)zIf supported, select this frame and return True; return False if unsupported Not all builds have a gdb.Frame.select method; seems to be present on Fedora 12 onwards, but absent on Ubuntu buildbotselectzSUnable to select frame: this build of gdb does not expose a gdb.Frame.select methodFT)hasattrr@printrHrOs r rHz Frame.selectsQ t~x00  Q R R R5 tr cd}|}|r-|dz }|}|-|S)zWCalculate index of frame, starting at 0 for the newest frame within this threadrr)rF)rHindex iter_frames r get_indexzFrame.get_indexsY    , QJE#))++J   , r c^|rdS|rdSdS)zIs this a _PyEval_EvalFrameDefault frame, or some other important frame? (see is_other_python_frame for what "important" means in this context)TF) is_evalframeis_other_python_framerOs r is_python_framezFrame.is_python_frames;      4  % % ' ' 4ur c|jtkr* |jtjkrdSdS)z)Is this a _PyEval_EvalFrameDefault frame?TF)r@rc EVALFRAMErur NORMAL_FRAMErOs r rPzFrame.is_evalframesH >   I - - ~""$$(888tur c|rdS|rdS|j}|}|sdS|ds|dkrLd} ||}t |S#t$rd|zcYSt$rd|zcYSwxYw|d krLd } ||}t |S#t$rd |zcYSt$rd |zcYSwxYwdS) aIs this frame worth displaying in python backtraces? Examples: - waiting on the GIL - garbage-collecting - within a CFunction If it is, return a descriptive string For other frames, return False zWaiting for the GILzGarbage-collectingFcfunction_vectorcall_cfunction_callfuncz?PyCFunction invocation (unable to read %s: missing debuginfos?)z*PyCFunction invocation (unable to read %s) wrapper_callwpzBz-) is_waiting_for_gil is_gc_collectr@rc startswithread_varr ValueErrorr~)rHrcallerarg_namerYs r rQzFrame.is_other_python_frames  " " $ $ )((      ('' 5   5 6 6 O & & &H  O~~h//4yy  ; ; ;/19:;;; O O OChNNNN O ^ # #H R~~h//4yy  < < <02:;<<< R R RFQQQQ Rus0*#BB0B0/B0<#C D1DDcH|j}|r|dkSdS)z!Is this frame waiting on the GIL?take_gilNr@rcrhs r r\zFrame.is_waiting_for_gil,s4~""$$  (J& ' ( (r c<|jdkS)z5Is this frame "collect" within the garbage-collector?collectrerOs r r]zFrame.is_gc_collect3s~""$$ 11r c |jd}t|}|s|S|}|j}|rE|d}t|}|s|S|S#t $rYdSwxYw)Nr)r@r_rrgryrCr`)rHrr orig_frameras r get_pyopzFrame.get_pyop7s '',,A$66q99E))++  J^))++F !OOC(((::1==--//! L    44 sA B0 A!B0.B00 B>=B>cNtj}|rt|SdSr&)rselected_framer>)rr@s r get_selected_framezFrame.get_selected_frameKs+&((  $## #tr c |}n#tj$rYdSwxYw|r,|r|S|}|,dS)zZTry to obtain the Frame for the python-related code in the selected frame, or NoneN)rmrerrorrRrCrrs r get_selected_python_framezFrame.get_selected_python_frameRs **,,EEy   44  "$$&&  KKMME " ts **c|}|r,|r|S|}|,dS)zfTry to obtain the Frame for the python bytecode interpreter in the selected GDB frame, or NoneN)rmrPrCrps r get_selected_bytecode_framez!Frame.get_selected_bytecode_framedsT&&(( "!!##  KKMME " tr c(|r|}|r|t}t t jd||fz|sL| }|8t j d| zdSdSdSt j d|zdS| }|r8t j d||fzdSt j d|zdS)Nz#%i %s  %s z.#%i (unable to read python frame information) z#%i ) rPrjrrr1r.r5rrNryrr+striprQrHr2lineinfos r print_summaryzFrame.print_summaryrsq      ===??D g..~>>cj*8H8H$7O*OPPP,,..D,,..D' ((djjll)BCCCCCDD''   !RUYUcUcUeUe!efffff--//D =   t~~/?/?.F!FGGGGG   4>>+;+;!;<<<<|r|}|rx||sL|}|8t jd|zdSdSdSt jddS| }|r$t jd|zdSt jddS)Nruz, (unable to read python frame information) rz (not a python frame) ) rPrjrryrr5rr+rvrQrws r rzFrame.print_tracebacks      ===??D R$$&&&,,..D,,..D' ((djjll)BCCCCCDD''   !PQQQQQ--//D =   D11111   !;<<<<r>s3"""      $ 333j(((222([ ["  [ ===&=====r r>ceZdZdZdZdZdS)PyListzList the current Python source code, if any Use py-list START to list at a different line number within the python source. Use py-list START, END to list a specific range of lines within the python source. crtj|dtjtjdS)Nzpy-list)rCommandrI COMMAND_FILES COMPLETE_NONErOs r rIzPyList.__init__7 d'!/!/ 1 1 1 1 1r c\ddl}d}d}|jd|}|r't|d}|dz}|jd|}|r*t t|\}}t }|stddS| }|r| rttdS| } | } | tddS| | dz }| dz}|dkrd} tt| } n>#t $r1} t"jd | d | d Yd} ~ dSd} ~ wwxYw| 5| } t+| |dz |D]J\}}t-||z}||z| krd |z}t"j|d d|K ddddS#1swxYwYdS)Nrz \s*(\d+)\s*rz\s*(\d+)\s*,\s*(\d+)\s*z:Unable to locate gdb frame for python bytecode interpreterz'Unable to read python frame line numberrzUnable to open r<rr$z>4z )rematchr(groupmapgroupsr>rsrJrjryUNABLE_READ_INFO_PYTHON_FRAMEr<rrr@rr5rr+r enumerater)rHrfrom_ttyrstartendmrr2r<r rerr all_linesr1rxlinestrs r invokez PyList.invokes  BH^T * *   OOE"*C BH/ 6 6  .S!((**--JE31133  N O O O F~~ t,,..  / 0 0 0 F==??&&(( > ; < < < F =QJE1*C 77E [**++AA    J    (###/ 0 0 0 FFFFF  @ @ I%YuQws{%;<< @ @4ag,,u9&&!GmG   !>????  @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @s+<E F#&FFA:H!!H%(H%NrrrrRrIrr r r r}r}sA  1117@7@7@7@7@r r}ct}|stddS|rp|r|}n|}|snB|r*|r|dS|}|p|rtddStddS)z9Move up or down the stack (for the py-up/py-down command)Unable to locate python frameNz$Unable to find an older python framez#Unable to find a newer python frame)r>rqrJrCrFrRrHrz)move_uprrMs r move_in_stackrs  + + - -E  -...   'JJJ    % % ' '   "" +((*** F "5 455555 344444r ceZdZdZdZdZdS)PyUpzESelect and print the python stack frame that called this one (if any)crtj|dtjtjdS)Nzpy-uprrrI COMMAND_STACKrrOs r rIz PyUp.__init__7 d%!/!/ 1 1 1 1 1r c&tddS)NTrrrHrrs r rz PyUp.invoke sd######r Nrr r r rrs8KK111$$$$$r rceZdZdZdZdZdS)PyDownzCSelect and print the python stack frame called by this one (if any)crtj|dtjtjdS)Nzpy-downrrOs r rIzPyDown.__init__rr c&tddS)NFrrrs r rz PyDown.invokese$$$$$$r Nrr r r rrs8II111%%%%%r rrHceZdZdZdZdZdS)PyBacktraceFullRDisplay the current python frame and all the frames within its call stack (if any)crtj|dtjtjdS)Nz py-bt-fullrrOs r rIzPyBacktraceFull.__init__#s7 d*!/!/ 1 1 1 1 1r ct}|stddS|r@|r||}|>dSdS)Nr)r>rqrJrRrzrCrHrrrs r rzPyBacktraceFull.invoke*s//11  1 2 2 2 F "$$&& &##%%%KKMME " " " " "r Nrr r r rr!s8XX111 " " " " "r rceZdZdZdZdZdS) PyBacktracercrtj|dtjtjdS)Nzpy-btrrOs r rIzPyBacktrace.__init__9rr c t}|stddStjd|r@|r||}|>dSdS)Nrz$Traceback (most recent call first): ) r>rqrJr5rr+rRrrCrs r rzPyBacktrace.invoke@s//11  1 2 2 2 F @AAA "$$&& (%%'''KKMME " " " " "r Nrr r r rr7s8XX111 " " " " "r rceZdZdZdZdZdS)PyPrint4Look up the given python variable name, and print itcrtj|dtjtjdS)Nzpy-printrrrI COMMAND_DATArrOs r rIzPyPrint.__init__Ps7 d(!.!/ 1 1 1 1 1r c t|}t}|stddS|}|stt dS||\}}|r1t|d|d|tdStd|zdS)Nrr = z %r not found) rr>rqrJrjrrrrr1)rHrrrcr pyop_framepyop_varscopes r rzPyPrint.invokeWs4yy//11  1 2 2 2 F^^%%   / 0 0 0 F$44T::%  ) eedd11.AAAC D D D D D .4' ( ( ( ( (r Nrr r r rrNs8::111)))))r rceZdZdZdZdZdS)PyLocalsrcrtj|dtjtjdS)Nz py-localsrrOs r rIzPyLocals.__init__rs7 d)!.!/ 1 1 1 1 1r ct|}t}|stddS|}|stt dS|D]P\}}t|td| tQdSNrr rr>rqrJrjrrrrqrrr1rHrrrcrrrr3s r rzPyLocals.invokeys4yy//11  1 2 2 2 F^^%%   / 0 0 0 F%/%;%;%=%=   !Iz ""355))))--n===      r Nrr r r rrps8::111r rcFtjfd}|S)z*sigh*, readlinecZ |i|S#t$rtjwxYwr&)r traceback print_exc)rrfunctions r wrapperz%dont_suppress_errors..wrappersJ 8T,V,, ,      ! ! !  s *) functoolswraps)rrs` r dont_suppress_errorsrs8_X Nr c4eZdZdZdZedZdZdS) PyGlobalsz9List all the globals in the currently select Python framecrtj|dtjtjdS)Nz py-globalsrrOs r rIzPyGlobals.__init__s7 d*!.!/ 1 1 1 1 1r ct|}t}|stddS|}|stt dS|D]P\}}t|td| tQdSrrrs r rzPyGlobals.invokes4yy//11  1 2 2 2 F^^%%   / 0 0 0 F%/%;%;%=%= F F !Iz ((//// 33NCCCE F F F F F Fr c*|Sr&)r)rHrs r get_namespacezPyGlobals.get_namespaces&&(((r N)rrrrRrIrrrr r r rrsW??111 FFF$)))))r rc|jdkr* |jtjkrdSdS)z#Is this a PyEval_EvalFrameEx frame?PyEval_EvalFrameExTF)r@rcrurrU)rs r is_evalframeexrsI !555  ?   ! !S%5 5 54 5r c*eZdZdZedZdS) PyNameEqualscttj}t|r[|}|t jddSt||tSdS)NzBUse a Python debug build, Python breakpoints won't work otherwise.) r>rrlrrjwarningswarngetattrrrq)rHattrrpyframes r _get_pycurframe_attrz!PyNameEquals._get_pycurframe_attrsc(**++ %  :nn&&G 6777t7D))2235599 9tr cd|d}|duo||kS)Nr{)rr})rHfuncnamers r rzPyNameEquals.invokes4((334=DHOO,=,=$==r N)rrrrrrr r r rrs?   >>>>>r r pyname_equalsc$eZdZedZdS) PyModEqualsc|d}|Wtjtj|\}}||kSdS)Nr|F)rospathsplitextbasenamer})rHmodnamerr<exts r rzPyModEquals.invokes^((77  G,,RW-=-=d-C-CDDMHcw~~/// /ur N)rrrrrr r r rrs.r r pymod_equalsc(eZdZdZedZdS)PyBreakz Set a Python breakpoint. Examples: Break on any function or method named 'func' in module 'modname' py-break modname.func Break on any function or method named 'func' py-break func cd|vr#|d\}}}d|d|d}nd|z}tjd|zdS)N.z$pyname_equals("z") && $pymod_equals("z")z$pyname_equals("%s")zbreak PyEval_EvalFrameEx if ) rpartitionrexecute)rHrrrdotconds r rzPyBreak.invoke sg (??%-%8%8%=%= "GS((DLHHDKGGMDD*H4D 2T9:::::r N)rrrrRrrr r r rrs:  ;;;;;r rzpy-breakc*eZdZdZdZdZdZdZdS) _LoggingStatezI State that helps to provide a reentrant gdb.execute() function. ctjd}||_|j|_||_td|jzg|_dS)Nzr+zset logging file %s) tempfileNamedTemporaryFiler,rcr<filenofd_executefile_position_stack)rHrs r rIz_LoggingState.__init__sU  ' - -  ((**&6777#%   r c|js-tdtdtd|jtj|jj|S)Nzset logging redirect onzset logging onzset pagination off)rrr:rfstatrst_sizerOs r __enter__z_LoggingState.__enter__'se' + . / / / % & & & ) * * *  ''(9(9(ABBB r ctj|j|jd|j}|S)N)rflushr,seekrread)rHr7s r getoutputz_LoggingState.getoutput0s?  t/3444!! r c |j}|j||j|js/t dt dt ddSdS)Nzset logging offzset logging redirect offzset pagination on)rpopr,rtruncater)rHexc_typeexc_valtbstartposs r __exit__z_LoggingState.__exit__6s+//11 x    ' * & ' ' ' / 0 0 0 ( ) ) ) ) ) * *r N)rrrrRrIrrr r r r rrsZ&&& *****r rFc|rEt5}t|||cdddS#1swxYwYdSt||dS)z Replace gdb.execute() with this function and have it accept a 'to_string' argument (new in 7.2). Have it properly capture stderr also. Ensure reentrancy. N)_logging_staterr)commandrr3rs r rr@s $  %u Wh ' ' '??$$ % % % % % % % % % % % % % % % % % % (#####s $;??c4tjdS)z. Return the selected inferior in gdb. r)r inferiorsselected_threadthreads)rinferiorthreads r get_selected_inferiorrSs =??1 r ctj\}}tj|d}|||t jd|z|tj|dS)a Source a gdb script with script_contents passed as a string. This is useful to provide defines for py-step and py-next to make them repeatable (this is not possible with gdb.execute()). See http://sourceware.org/bugzilla/show_bug.cgi?id=12216 wz source %sr3N) rmkstemprfdopenr+closerrremove)script_contentsr3rr<rs r source_gdb_scriptr csv#%%LB "cAGGOGGIIIK h&)<<<<Ihr czttjdtjt jfzdS)Nz define py-step -py-step end define py-next -py-next end document py-step %s end document py-next %s end )r textwrapdedentPySteprRPyNextr r r register_definesr&rsDho'  NFN +!,-----r cDd}|r|}|dz }||S)z$Tells the stackdepth of a gdb frame.rr)rC)rdepths r stackdepthr)s6 E      Lr cfeZdZdZfdZdZdZdZdZdZ dZ d Z d Z dd Z d ZdZxZS)ExecutionControlCommandBasez Superclass for language specific execution control. Language specific features should be implemented by lang_info using the LanguageInfo interface. 'name' is the name of the command. ct|tjtj||_dSr&)superrIrCOMMAND_RUNNINGr lang_info)rHrcr/ __class__s r rIz$ExecutionControlCommandBase.__init__s:  $c&93;L N N N"r c# Ktj|j|j}|D]E}t jd|zd}tjd| dVFdS)Nzbreak %sTrBreakpoint (\d+)r) itertoolschainr/static_break_functionsruntime_break_functionsrrrsearchr)rH all_locationslocationr7s r install_breakpointsz/ExecutionControlCommandBase.install_breakpointss! N 1 1 3 3 N 2 2 4 466 & B BH[h!6$GGGF)/88>>qAA A A A A B Br c>|D]}tjd|zdS)N delete %s)rr)rHbreakpoint_listbps r delete_breakpointsz.ExecutionControlCommandBase.delete_breakpointss3! * *B K b( ) ) ) ) * *r ctj}d|tjzfdd|fg}d|fd|fg}fd}tjdtj}|rd|d z}nd }|||||zfS) Nz^Program received signal .*)z.*[Ww]arning.*rz^Program exited .*z^(Old|New) value = .*z^\d+: \w+ = .*cg}|D]F\}}tj||D]*}||d+Gd|S)Nrr)rfinditerr:rr;)regexesoutputregexflagsrr7s r filter_outputz@ExecutionControlCommandBase.filter_output..filter_outputspF ' 2 2 u[>>22EMM%++a..1111299V$$ $r z^Value returned is \$\d+ = (.*)zValue returned: %s rr2)r MULTILINEDOTALLr7r)rHr7reflagsoutput_on_halt output_alwaysrG match_finish finish_outputs ` r rGz)ExecutionControlCommandBase.filter_outputs,,WRY-> ? " "G , &w /  (   % % % % %y!CV!#//  2\5G5G5J5JJMMM n-- m < <<> >r c0tjdkSrK)rpidrOs r stoppedz#ExecutionControlCommandBase.stoppeds$&&*a//r c0||\}}|r t|t|dStj}|j|}|j|r+|j|}|rt||rF| r!t| t|dSt|dS)z After doing some kind of code running in the inferior, print the line of source code or the result of the last executed gdb command (passed in as the `result` argument). N) rGrQrJrrlr/get_source_lineis_relevant_functionexc_inforstrip)rHr7rKrLr source_lineraised_exceptions r finish_executingz,ExecutionControlCommandBase.finish_executings )-(:(:6(B(B% <<>>  - . ! ! ! ! !&((E.88??K~22599 ,#'>#:#:5#A#A #,*+++  ''))2-..00111k"""""f r ctjtjddStjddS)zd Execute until the function returns (or until something else makes it stop) NfinishTrcont)rrlrCrrOs r _finishz#ExecutionControlCommandBase._finishsK     % % ' ' 3;x4888 8;v666 6r c  |} tj}n#t$rYnMwxYwt jd|}|j|}|s|s|rn|S)zJ Execute until the function returns to a relevant caller. Tr2) r]rrlr~rr7r/rTrQ)rHr7rhitbp is_relevants r _finish_framez)ExecutionControlCommandBase._finish_frames \\^^F *,,    I16::E.==eDDK   t||~~   s + 88cX|}||dS)zImplements the finish command.N)rarY)rHrr7s r r[z"ExecutionControlCommandBase.finish s-##%% f%%%%%r nextc|r!t|}tj}|j|r+|j|}|st|}|} |j|rtj|d}n| }| rntj}|j|} | } n#t$rd} YnwxYwtjd|} | r| r| d|vrnH||kr|st|} | |ko| } | rn&n#|j|} | r| |krn(|r||||dS)a Do a single step or step-over. Returns the result of the last gdb command that made execution stop. This implementation, for stepping, sets (conditional) breakpoints for all functions that are deemed relevant. It then does a step over until either something halts execution, or until the next line is reached. If, however, stepover_command is given, it should be a string gdb command that continues execution in some way. The idea is that the caller has set a (conditional) breakpoint or watchpoint that can work more efficiently than the step-over loop. For Python this means setting a watchpoint for f->f_lasti, which means we can then subsequently "finish" frames. We want f->f_lasti instead of f->f_lineno, because the latter only works properly with local trace functions, see PyFrameObjectPtr.current_line_num and PyFrameObjectPtr.addr2line. TrNr2r)listr:rrlr/rTr r)rrarQrcr~rr7rr?rY)rHstepintostepover_commandr= beginframe beginliner(newframer7rT framenamernewdepthr s r stepz ExecutionControlCommandBase.step s#&  ?"4#;#;#=#=>>O')) > . .z : : / --j99I /":..( ~228<< .%5FFF++--||~~ )++H#'>#F#Fx#P#P  !$MMOO  ! ! !  ! -v66A 'AGGAJJ/,I,I:%% B)(33H,4u,<-A,@)( ..x88f 11Q( T  5  # #O 4 4 4 f%%%%%sD D+*D+c^|tjd|zddS)Nzrun TrrYrrrs r runzExecutionControlCommandBase.run_ s/ ck&4-4HHHIIIIIr cX|tjdddS)Nr\Trro)rHrs r r\z ExecutionControlCommandBase.contb s+ ck&DAAABBBBBr )rc)rrrrRrIr:r?rGrQrYr]rar[rmrpr\ __classcell__r0s@r r+r+s ##### BBB***!>!>!>F0004 7 7 7&&&& Q&Q&Q&Q&fJJJCCCCCCCr r+ceZdZdZdZdZdS) LanguageInfoa This class defines the interface that ExecutionControlCommandBase needs to provide language-specific execution control. Classes that implement this interface should implement: lineno(frame) Tells the current line number (only called for a relevant frame). If lineno is a false value it is not checked for a difference. is_relevant_function(frame) tells whether we care about frame 'frame' get_source_line(frame) get the line of source code for the current line (only called for a relevant frame). If the source code cannot be retrieved this function should return None exc_info(frame) -- optional tells whether an exception was raised, if so, it should return a string representation of the exception value, None otherwise. static_break_functions() returns an iterable of function names that are considered relevant and should halt step-into execution. This is needed to provide a performing step-into runtime_break_functions() -- optional list of functions that we should break into depending on the context cdS)zSee this class' docstring.Nr rHrs r rUzLanguageInfo.exc_info sr cdS)zc Implement this if the list of step-into functions depends on the context. r r rOs r r6z$LanguageInfo.runtime_break_functions s rr N)rrrrRrUr6r r r ruruf s=@%%%r ruc2eZdZdZdZdZdZdZdZdS) PythonInfoctt|}|r|Stjd)NzuUnable to find the Python frame, run your code with a debug build (configure with --with-pydebug or compile with -g).)r>rjrr~rHrrs r rzPythonInfo.pyframe sE,,''))  MN"LMM Mr cP||Sr&)rrrws r r zPythonInfo.lineno s ||E""33555r cDt|Sr&)r>rrws r rTzPythonInfo.is_relevant_function sU||**,,,r c ||}d||fzS#t$rYdSwxYw)Nz %4d %s)rrrrVrr|s r rSzPythonInfo.get_source_line sx ll5))G'":":"<"<")"6"6"8"8"?"?"A"A"CC C   44 sAA A"!A"c |d}tjdr2tjdkr |dx}}n|d}|d}|rd|SdSdS#t tf$rYdSwxYw)Ntstateztstate->frame == f)rralphacurrent_exception curexc_type curexc_valuezAn exception was raised: )r_rarparse_and_evalr5 version_infor`r~)rHrrinf_type inf_values r rUzPythonInfo.exc_info s ^^H--99;;F!"677 H#'===+12E+FFHyy%m4H &~ 6IHHf_lastiTrz[Ww]atchpoint (\d+):rr[)rfrgr<N)rrr(rr7rrm)rHrfrD watchpoints r python_stepzPythonStepperMixin.python_step sr /4@@@#:FCCII!LLMM  8h ??? K*,-----r N)rrrrRrr r r rr s- .....r rc,eZdZdZdZedZdS)r$zStep through Python code.Tc<||jdS)N)rf)rrfrs r rz PyStep.invoke s! $-00000r N)rrrrRrfrrr r r r$r$ s9H11111r r$ceZdZdZdZdS)r%zStep-over Python code.FN)rrrrRrfr r r r%r% sHHHr r%c2eZdZdZeejZdS)PyFinishz+Execute until function returns to a caller.N)rrrrRrr+r[rr r r rr s(11 ! !"="D E EFFFr rc2eZdZdZeejZdS)PyRunzRun the program.N)rrrrRrr+rprr r r rr s( ! !"="A B BFFFr rc.eZdZeejZdS)PyContN)rrrrr+r\rr r r rr s" ! !"="B C CFFFr rcV|jt|jSt|S)zb Return the value of the pointer as a Python int. gdbval.type must be a pointer type )rr(r(s r _pointervaluer s*~!6>"""6{{r c|t|} |dkrtjdn#t$rYnwxYw|S)Nrz:Negative pointer value, presumably a bug in gdb, aborting.)rrGdbErrorr~)rZrs r pointervaluer sfF##G Q;;, 344 4       Ns , 99c tjddS#t$r+ tjdYdS#t$rYYdSwxYwwxYw)NPyUnicode_FromEncodedObjectr2PyUnicodeUCS2_FromEncodedObjectUCS2UCS4)rrr~r r r get_inferior_unicode_postfixr s  8999r    @ A A A66   666 s$ A : A A A  A cFeZdZdZdZdZdZdZdZdZ dZ d Z d d Z d S) PythonCodeExecutoriictjd|z}t|}|dkrtjd|S)Nz(void *) malloc((size_t) %d)rz-No memory could be allocated in the inferior.)rrrr)rHrchunkrs r malloczPythonCodeExecutor.malloc# sD#$BT$IJJu%% a<<,NOO Or c|t|}t|||Sr&)rrLr write_memory)rHr}rs r alloc_stringzPythonCodeExecutor.alloc_string, s:++c&kk**,,Wf===r c||}d} tj|n"#t$rdt d}YnwxYw tjd||t |fz}||n#||wxYwt|}|dkrtjd|S)NPyString_FromStringAndSize PyUnicode_FromStringAndSizez)(PyObject *) %s((char *) %d, (size_t) %d)rz1Unable to allocate Python string in the inferior.) rrrr~rrLfreerr)rHr}stringprr7rs r alloc_pystringz!PythonCodeExecutor.alloc_pystring2 s##F++%A" R  9 : : : : R R R R1M0N0N0N0N+Q & & & R  ';6V?NNOOF IIg    DIIg    v&& a<<, /00 0s.A  A 'BB%c4tjd|zdS)Nz(void) free((void *) %d)rrrHrs r rzPythonCodeExecutor.freeK s 5?@@@@@r c4tjd|zdS)zAIncrement the reference count of a Python object in the inferior.zPy_IncRef((PyObject *) %d)Nrrs r increfzPythonCodeExecutor.increfN s 7'ABBBBBr c4tjd|zdS)zADecrement the reference count of a Python object in the inferior.zPy_DecRef((PyObject *) %d)Nrrs r xdecrefzPythonCodeExecutor.xdecrefR s! 7'ABBBBBr Ncd|vrtjd|dz }||}t|}t|}|dks|dkrtjddt ||||z}t 5 tj|}||n#||wxYw dddn #1swxYwY|S)aH Evaluate python code `code` given as a string in the inferior and return the result as a gdb.Value. Returns a new reference in the inferior. Of course, executing any code in the inferior may be dangerous and may leave the debuggee in an unsafe state or terminate it altogether. zString contains NUL byte.rz-Unable to obtain or create locals or globals.z PyRun_String( (char *) %(code)d, (int) %(start)d, (PyObject *) %(globals)s, (PyObject *) %(locals)d) )rrglobalslocalsN)rrrrrFetchAndRestoreErrorrr) rHr input_type global_dict local_dictrglobalsplocalsppyobject_return_values r evalcodezPythonCodeExecutor.evalcodeY sP 4<<,:;; ;  ##D)) ,,z** q==GqLL,NOO O z#G555 5" # # # # #(+(:4(@(@% '"""" '"""""  # # # # # # # # # # # # # # # %$s*C(C+C(CC((C,/C,r) rrrPy_single_input Py_file_input Py_eval_inputrrrrrrrr r r rr sOMM 2AAACCCCCC%%%%%%%%%%%%r rc$eZdZdZdZdZdZdS)rzg Context manager that fetches the error indicator in the inferior and restores it on exit. ctjdj|_||jdz|_|j}|j|jz}|j|jdzz}|||f|_dS)NrUrr)rrrrsizeof_PyObjectPtrrerrstate)rHrurrs r rIzFetchAndRestoreError.__init__ sz"%/*"="="E"E"G"G"N{{4#:Q#>?? | t66L4#:Q#>> eY. r c>tjd|jzdS)NzPyErr_Fetch(%d, %d, %d))rrrrOs r rzFetchAndRestoreError.__enter__ s! 4t}DEEEEEr ctjdrtjdd} tj||jz||jdS#||jwxYw)Nz(int) PyErr_Occurred()z PyErr_Print()zAPyErr_Restore((PyObject *) *%d,(PyObject *) *%d,(PyObject *) *%d))rrrrr)rHr pyerr_restores r r zFetchAndRestoreError.__exit__ s  6 7 7 0   / / /0  $  }t}< = = = IIdl # # # # #DIIdl # # # #s A$$BN)rrrrRrIrr r r r rr sN ///FFF $ $ $ $ $r rc:eZdZfdZdZedZxZS) FixGdbCommandct|tjtj||_dSr&)r-rIrrractual_command)rHrrr0s r rIzFixGdbCommand.__init__ s: #"2,/,= ? ? ?,r ctjddttjt  t tjddkdS#t$rYdSwxYw)a It seems that invoking either 'cy exec' and 'py-exec' work perfectly fine, but after this gdb's python API is entirely broken. Maybe some uncleared exception value is still set? sys.exc_clear() didn't help. A demonstration: (gdb) cy exec 'hello' 'hello' (gdb) python gdb.execute('cont') RuntimeError: Cannot convert value to int. Error while executing Python code. (gdb) python gdb.execute('cont') [15148 refs] Program exited normally. ignorez.*z (void *) 0rN) rfilterwarningsRuntimeWarningrescaperr(rrr~rOs r fix_gdbzFixGdbCommand.fix_gdb sw" % " ( 3 3 5 5 5  "<00 1 1Q 6 6 6 6    DD s%A A*)A*c| tj|jd|n3#t$r&}tjt |d}~wwxYw|dS)Nr)rrrrr~rr)rHrres r rzFixGdbCommand.invoke s}  ' K4#6#6#6= > > > > ' ' ',s1vv&& & ' s5 A%!A  A%)rrrrIrrrrrrss@r rr sc----- 2r rctjd}tjd}t|dkst|dkrtjd|||||S)z= Execute Python code in the most recent stack frame. zPyEval_GetGlobals()zPyEval_GetLocals()rziUnable to find the locals or globals of the most recent Python function (relative to the selected frame).)rrrrr)executorrrrrs r _evalcode_pythonr s$%:;;K#$899J[!!Q&&,z*B*Ba*G*Gl.// /   T:{J G GGr c*eZdZdZedZdS)PyExecc |r|tjfSg} td}|dkrn'||n#t $rYnwxYwPd|tjfS)NTr$rr)rrinputrVr:EOFErrorr;r)rHexprrrxs r readcodezPyExec.readcode s  F+;; ;E '' ::D{{}}--LL&&&&  E '99U##%7%EE EsA A A c||\}}t}|t||tt dSr&)rrrrrr)rHrrrrs r rz PyExec.invoke sL==..j%'')(J ZXXYYYYYr N)rrrrrrr r r rr sGFFF$ZZZZZr rzset breakpoint pending onrz-py-stepz-py-nextz py-finishzpy-runzpy-contzpy-execz-py-execz1Use gdb 7.2 or higher to use the py-exec command.)FF)F)rRrrlocaler5r rrrrrrrrrrrrrPy_TPFLAGS_TYPE_SUBCLASSr1rgetpreferredencodingrrrrTr~rr$r)r.fsencoder@AttributeErrorrBrDrTrbrrrrrrrrrrrr rrrrrrrrrrrrtrrrrr,r.r8r<current_objfiler>rr}rrrrIrrrrrrrrr"r3rrrrFunctionrrrr.rrrrrrr r&r)r+rurzrr$r%rrrrrrrrrrrpy_steppy_next py_finishpy_runpy_contpy_execr_py_execrr r r rsD((Z ---666777555444   ' ' ' ' ' ' ' '  &6 & ( (> L &      l   )))  +KK         $     l   &u!u!u!u!u!u!u!u!n[        ,,,*::::::::"333#'@T@T@T@T@T @T@T@TD22222Y22244444{4444     {   77777777        <<<<<;<<<*k:P%P%P%P%P%kP%P%P%fkB* * * * * k* * * Z     o   k]6]6]6]6]6{]6]6]6~;;;;;[;;;|))))){)))V"""""{"""Hk888yyyyyyyyx     K   F'''''''' ***&666  #  !!!k=k=k=k=k=k=k=k=ZJ@J@J@J@J@S[J@J@J@\555: $ $ $ $ $3; $ $ $ % % % % %S[ % % % 739h DFFF FHHH"""""ck"""("""""#+"""* )))))ck)))@ s{8      ))))) )))>  >>>>>3<>>>( _, N;;;;;ck;;;0 C'):;;;#*#*#*#*#*#*#*#*L $ $ $ $ ;        ---(SCSCSCSCSC#+SCSCSCl))))))))X+#+#+#+#+#+#+#+#\........"11111 (*<111V FFFFF*FFF CCCCC 'CCC DDDDD (DDD         a%a%a%a%a%a%a%a%H$$$$$-$$$D'''''CK'''T H H HZZZZZS[ZZZ6  '((( 73  GfZ..GfZ..Gjjll33I U8ZZ\\ * *FfY --GmIz22Gvj#"2C4EFFHHHHMEFFFFFs'A//A:9A: