hj SrSSKrSSKrSSKrSSKrSrSrSrSrSr Sq Sr S r S r S rS rS rSrSrSrSrSr\R,"5rSrSrSr"SS\5rSrSrSr\R@r!"SS\5r#"SS5r$"S S!5r%"S"S#\%5r&"S$S%5r'S&r("S'S(5r)S)r*S\*l+"S*S+\%5r,"S,S-\-5r."S.S/\%5r/"S0S1\%5r0"S2S35r1"S4S55r2"S6S7\%5r3"S8S9\%5r4"S:S;\%5r5"S<S=\%5r6"S>S?\%5r7"S@SA\75r8"SBSC\%5r9"SDSE\%5r:"SFSG\%5r;"SHSI\%5r<"SJSK\%5r="SLSM\%5r>SNr?"SOSP\%5r@"SQSR\%5rASSrBSTrC"SUSV5rDSWrESXrF\F"\R"55 "SYSZ5rH"S[S\\R5rJ\J"5 S]rK"S^S_\R5rL"S`Sa\R5rM\N"\RSb5(a\L"5 \M"5 "ScSd\R5rO\O"5 "SeSf\R5rP\P"5 "SgSh\R5rQ\Q"5 "SiSj\R5rR\R"5 SSKSrSSSKTrTSSKUrUSSKVrVSSKWrWSSKXrXSSKYrYSkrZ"SlSm\R5r[\["5 Snr\"SoSp\R5r^\^"Sq5 "SrSs\^5r_\_"St5 "SuSv\R5r`\`"Sw\R\R5 "SxSy5rcSSzjrd\Rre\d\ld\c"5rfS{rgSS|jrhS}riS~rj"SS\R5rk"SS5rl"SS\l5rm"SS5rn"SS\k\n5ro"SS\o5rp"SS\k5rq"SS\k5rr"SS\k5rsSrtSruSrv"SS5rw"SS\w5rx"SS\R5rySrz"SS\R5r{\R"S5 \N"\S5(av\o"S\m"55r|\p"S\m"55r}\i"5 \q"S\m"55r~\r"S\m"55r\s"S\m"55r\y"SS5r\{"S\GR\R5rg\TGR"S5 g!\"a Sr!GNf=f)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. NcJ[R"S5R5$)Nchargdb lookup_typepointerS/var/www/fran/franai/venv/lib/python3.13/site-packages/Cython/Debugger/libpython.py_type_char_ptrr ?s ??6 " * * ,,r cJ[R"S5R5$)Nz unsigned charrr r r _type_unsigned_char_ptrrCs ??? + 3 3 55r cJ[R"S5R5$)Nzunsigned shortrr r r _type_unsigned_short_ptrrGs ??+ , 4 4 66r cJ[R"S5R5$)Nz unsigned intrr r r _type_unsigned_int_ptrrKs ??> * 2 2 44r c^[R"S5R5R$)Nvoid)rrrsizeofr r r _sizeof_void_prOs ??6 " * * , 3 33r iiiiiii i@li0123456789abcdefz!(frame information optimized out)z*Unable to read information on python frame_PyEval_EvalFrameDefaultc\rSrSrSrg)NullPyObjectPtrkr N__name__ __module__ __qualname____firstlineno____static_attributes__r r r rrkr rc[US5$)N)minvals r safety_limitr(os sD>r c<[[[U555$N)ranger(intr&s r safe_ranger-vs c#h' ((r c&URU5 gr*)write)filetexts r write_unicoder2{sJJtr cf[U[5(dU$[R"5nUS:XaUR U5$/nUHVnS[ U5s=::aS::aO O[ [ U5S- 5nOUR U5nURU5 MX SRU5$)Nmbcsii) isinstanceunicodesysgetfilesystemencodingencodeordchrappendjoin)filenameencodingencodedrbytes r os_fsencoderDs(G,,O,,. v ??8, ,DT,f,3t9v-.{{8, NN4 wwwr c\rSrSrSrg)StringTruncatedr Nrr r r rFrFr"r rFc.\rSrSrSrSSjrSrSrSrg) TruncatedStringIOzZSimilar to io.StringIO, but can truncate the output by raising a StringTruncated exceptionNcSUlXlg)Nr6_valmaxlen)selfrNs r __init__TruncatedStringIO.__init__s  r c2UR(aq[U5[UR5-UR:aBU=RUSUR[UR5- - sl[5eU=RU- slgNr)rNlenrMrF)rOdatas r r/TruncatedStringIO.writesc ;;4y3tyy>)DKK7 T!DKK#dii.$@AA %'' T r cUR$r*)rMrOs r getvalueTruncatedStringIO.getvalue yyr rLr*) rrrr __doc__rPr/rYr!r r r rIrIs!r rIc\rSrSrSrSrSSjrSrSrSr S r S r S r S r S rSrSr\S5r\S5r\S5rSrSrg) PyObjectPtraO 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. PyObjectNcLU(aURU5UlgXlgr*)cast_gdbvalrOgdbvalcast_tos r rPPyObjectPtr.__init__s !;;w/DL!Lr cUR5(a [U5eUS:Xa@URR[R 55nUR 5U$US:Xa@URR[R 55nUR 5U$URR 5U$)a9 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_nullrrcrbr^ get_gdb_type dereferencePyVarObjectPtr)rOnamepyo_ptrs r fieldPyObjectPtr.fields <<>>!$' ' 9 ll'' (@(@(BCG&&(. . 9 ll''(C(C(EFG&&(. .||'')$//r cJ[RURU55$)z~ Get a PyObjectPtr for the given PyObject* field within this PyObject, coping with some python 2 versus python 3 differences. )r^from_pyobject_ptrrqrOros r pyop_fieldPyObjectPtr.pyop_fields ,,TZZ-=>>r cHURU5nURX#5 g)zb Extract the PyObject* field named "name", and write its representation to file-like object "out" N)rv write_repr)rOrooutvisited field_objs r write_field_reprPyObjectPtr.write_field_reprs OOD) S*r c[U5nURU[55 UR 5$![a UR 5S-s$f=f)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))rIrysetrFrY)rOrNrzs r get_truncated_reprPyObjectPtr.get_truncated_reprsT  ' 5 OOC ' ||~  5<<>$44 4 5s7AAc6[URS55$)Nri)PyTypeObjectPtrrqrXs r typePyObjectPtr.typestzz)455r c2S[UR5:H$rSr,rcrXs r rkPyObjectPtr.is_nullsC %%%r c.URR$)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" )rcis_optimized_outrXs r rPyObjectPtr.is_optimized_outs||,,,r cUR5nURS5nUR5$![[[ 4a gf=f)Ntp_nameunknown)rrqstringr RuntimeErrorUnicodeDecodeError)rOrirs r safe_tp_namePyObjectPtr.safe_tp_name sI iikGmmI.G>># # /AB  s03A  A cj"SS5nU"UR5[UR55$)a Scrape a value from the inferior process, and try to represent it within the gdb process, whilst (hopefully) avoiding crashes when the remote data is corrupt. Derived classes will override this. For example, a PyIntObject* with ob_ival 42 in the inferior process should result in an int(42) in this process. visited: a set of all gdb.Value pyobject pointers already visited whilst generating this value (to guard against infinite recursion when visiting object graphs with loops). Analogous to Py_ReprEnter and Py_ReprLeave c$\rSrSrSrSrSrSrg)&PyObjectPtr.proxyval..FakeRepri%z 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(). cXlX lgr*)raddress)rOrrs r rP/PyObjectPtr.proxyval..FakeRepr.__init__,s & & r cZURS:XagSURUR4-$)Nr0x0<%s at remote 0x%x>rrrXs r __repr__/PyObjectPtr.proxyval..FakeRepr.__repr__0s+<<1$ , dll/KKKr rNrrrr r\rPrr!r r r FakeReprr%s   ' Lr r)rr,rc)rOr{rs r proxyvalPyObjectPtr.proxyvals4" L L&))+DLL)+ +r cTUR[URU555$)zl Write a string representation of the value scraped from the inferior process to "out", a file-like object. )r/reprrrOrzr{s r ryPyObjectPtr.write_repr;s!yydmmG4566r c RURS5R5n[URS55n[ [ [[[[[[S.nX$;aXB$U[-(a[$U[-(a[$U[ -(a["$U[$-(a[&$U[(-(a[*$U[,-(a[.$U[0-(a[2$U[4-(a[6$U$![[4a Us$f=f)ap 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 rtp_flags)boolclassobjNoneTypeframer frozensetbuiltin_function_or_methodzmethod-wrapper)rqrr,rrPyBoolObjectPtrPyClassObjectPtrPyNoneStructPtrPyFrameObjectPtrPySetObjectPtrPyCFunctionObjectPtr 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)clstrrname_maps r subclass_from_typePyObjectPtr.subclass_from_typeEs& ggi(//1G177:./H, 0 /-*"03G&3  $ $ ) )$ $ . ." " . ." " / /# # / /# # 1 1% % . ." " 2 2+ +  S01 J s9DD&%D&c[U5nURUR55nU"XR5S9$![a Of=fU"U5$)z\ Try to locate the appropriate derived class dynamically, and cast the pointer accordingly. )rf)r^rrrlr)rreps r rtPyObjectPtr.from_pyobject_ptrs[  F#A((2Cv'7'7'9: :   6{s=A A  A c^[R"UR5R5$r*)rr _typenamer)rs r rlPyObjectPtr.get_gdb_typess}}-5577r c,[UR5$r*rrXs r as_addressPyObjectPtr.as_addresss4<<  r )rcr*)rrrr r\rrPrqrvr}rrrkrrrry classmethodrrtrlrr!r r r r^r^s I" 0<?+ 6& - %+N7@@D  88!r r^c\rSrSrSrSrg)rni PyVarObjectr Nrrrr rr!r r r rnrnsIr rnc$\rSrSrSrSrSrSrg)ProxyAlreadyVisitediz 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 cXlgr*_rep)rOreps r rPProxyAlreadyVisited.__init__s r cUR$r*rrXs r rProxyAlreadyVisited.__repr__r[r rNrr r r rrs r rcURS5 URU5 [U[5(aURS5 SnUR5HaupgU(dURS5 SnURUR U55 URS5 UR X5 Mc URS5 URSU-5 g ) zTShared code for use by all classes: write a representation to file-like object "out"<(T, F=)z at remote 0x%x>N)r/r7r iteritemsrry)rzr{ro pyop_attrdictrfirstpyop_argpyop_vals r _write_instance_reprrsIIcNIIdO-11 #"/"9"9"; H $E IIh''0 1 IIcN    - #< #II 7*+r c \rSrSrSrSrSrg) InstanceProxyic(XlX lX0lgr*)cl_nameattrdictr)rOrrrs r rPInstanceProxy.__init__s   r c B[UR[5(a`SRURR 5VVs/sHupU<SU<3PM snn5nSUR X0R 4-$SUR UR 4-$s snnf)Nrrz<%s(%s) at remote 0x%x>r)r7rdictr?rrr)rOargr'kwargss r rInstanceProxy.__repr__s dmmT * *YY04 0G0G0I K0IHC,/ 40I KLF, 06 0FF F)DLL,0LL,:: :  KsB )rrrNrrrr rPrr!r r r rrs  :r rc [Rc[R"S5[lUR S5XR S5--[ 5S- -[ 5S- )-R [R5$)Nsize_t tp_basicsize tp_itemsize)_PyObject_VAR_SIZE _type_size_trrrqrrb)typeobjnitemss r rrs}&&.*-//(*C'}}^, m445 1$&"#a'()T$11 2 3r c*\rSrSrSrSrSrSrSrg)rir`cUR5n[URS55nUS:wGaUS:a~[R"S5R 5n[UR RU5S5nUS:aU*n[X5nX%- nUS:deU[5-S:XdeUR R[55U-n[R5R 5nURU5n[RUR55$g![a gf=f)z_ Get the PyDictObject ptr representing the attribute dictionary (or None if there's a problem) tp_dictoffsetrrrjN)r int_from_intrqrrrrcrbrrr r^rlrtrmr)rOr dictoffsettype_PyVarObject_ptrtsizesizedictptrPyObjectPtrPtrs r get_attr_dictHeapTypeObjectPtr.get_attr_dicts+  iikG%gmmO&DEJQ>+.??=+I+Q+Q+S(():):;O)PQZ)[\Eqy!&-g=D&J%>)>%(88A===,,++N,<= J!,!9!9!;!C!C!E!,,~6"44W5H5H5JKK(     sD0D55 EEc2UR5U;a [S5$URUR55 UR5nU(aUR U5nO0nUR 5n[ XC[UR55$)z Support for classes. Currently we just locate the dictionary using a transliteration to python of _PyObject_GetDictPtr, ignoring descriptors <...>) rraddrrrrr,rc)rOr{pyop_attr_dict attr_dictrs r rHeapTypeObjectPtr.proxyvals} ??  '&w/ / DOO%&++- &//8II##%WT\\1BCCr cUR5U;aURS5 gURUR55 UR5n[ XUR 5X0R55 g)Nr)rr/rrrr)rOrzr{rs r ryHeapTypeObjectPtr.write_reprsa ??  ' IIg   DOO%&**, S!..0-AR Tr r N) rrrr rrrryr!r r r rrsI<D, Tr rc \rSrSrSrSrSrg)ProxyExceptioni#cXlX lgr*rargs)rOrrs r rPProxyException.__init__$s   r c:UR<UR<3$r*rrXs r rProxyException.__repr__(styy11r )rrNrr r r rr#s 2r rc(\rSrSrSrSrSrSrSrg)ri+zq Class wrapping a gdb.Value that's a PyBaseExceptionObject* i.e. an exception within the process being debugged. PyBaseExceptionObjectcUR5U;a [S5$URUR55 URS5R U5n[ UR 5U5$N(...)r)rrrrvrrr)rOr{ arg_proxys r r!PyBaseExceptionObjectPtr.proxyval2sc ??  '&w/ / DOO%&OOF+44W= d//1') )r cUR5U;aURS5 gURUR55 URUR55 UR SX5 gr#)rr/rrr}rs r ry#PyBaseExceptionObjectPtr.write_repr;sX ??  ' IIg   DOO%& $##%& fc3r r N) rrrr r\rrryr!r r r rr+s(I)4r rc\rSrSrSrSrSrg)riEzr Class wrapping a gdb.Value that's a PyClassObject* i.e. a instance within the process being debugged. PyClassObjectr N)rrrr r\rr!r r r rrEs Ir rc \rSrSrSrSrSrg)BuiltInFunctionProxyiMcXlgr*ml_name)rOr/s r rPBuiltInFunctionProxy.__init__Ns r c SUR-$)Nzr.rXs r rBuiltInFunctionProxy.__repr__Qs'$,,66r r.Nrr r r r,r,Ms 7r r,c \rSrSrSrSrSrg)BuiltInMethodProxyiTcXlX lgr*r/ pyop_m_self)rOr/r7s r rPBuiltInMethodProxy.__init__Us  &r cSURURR5URR54-$)Nz0)r/r7rrrXs r rBuiltInMethodProxy.__repr__Ys?B<<##002##..022 r r6Nrr r r r4r4Ts 'r r4c"\rSrSrSrSrSrSrg)ri`zp Class wrapping a gdb.Value that's a PyCFunctionObject* (see Include/methodobject.h and Objects/methodobject.c) PyCFunctionObjectcURS5nUSR5nURS5nUR 5(a [ U5$[ X45$![a SnNJf=f)Nm_mlr/zm_self)rqrrrvrkr,r4)rOr{r>r/r7s r rPyCFunctionObjectPtr.proxyvalgsrzz&! 59o,,.Gooh/    '0 0%g; ;" 54G 5sA"" A10A1r Nrrrr r\rrr!r r r rr`s$I  instance within the process being debugged. PyCodeObjectcURS5R[55n[UR S55nSn[ USSS2USSS25H*upVU[ U5- nXA:aUs $U[ U5- nM, U$)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)rvrrrrqzipr<)rOaddrqrFlinenoaddr addr_incr line_incrs r addr2linePyCodeObjectPtr.addr2line|sOOK099#%@ djj)9:;$' #A# !$Q$$H I C N "D| c)n $F %I  r r N)rrrr r\rrOr!r r r rCrCusIr rCc4\rSrSrSrSrSrSrSrSr Sr g ) rizk Class wrapping a gdb.Value that's a PyDictObject* i.e. a dict instance within the process being debugged. PyDictObjectc## URS5nURS5nURU5up4[U5H{nX5n[U5(a[R X%5nO[R US5nUR 5(aM^[R US5nX4v M} g7f)z` Yields a sequence of (PyObjectPtr key, PyObjectPtr value) pairs, analogous to dict.iteritems() ma_keys ma_valuesme_valueme_keyN)rq _get_entriesr-r,r^rtrk) rOkeysvaluesentriesnentriesiep pyop_valuepyop_keys r rPyDictObjectPtr.iteritemss zz)$K( --d3H%AB6{{(::69E (::2j>J %%''&88HF,,&s BC!"CcUR5U;a [S5$URUR55 0nUR5H+up4UR U5nUR U5nXbU'M- U$)N{...})rrrrr)rOr{resultr`r_ proxy_key proxy_values r rPyDictObjectPtr.proxyvalsw ??  '&w/ / DOO%&$(NN$4 H ))'2I$--g6K +9 %5 r cUR5U;aURS5 gURUR55 URS5 SnUR5HRupEU(dURS5 SnUR X5 URS5 UR X5 MT URS5 g)Nrc{TrF: })rr/rrry)rOrzr{rr`r_s r ryPyDictObjectPtr.write_reprs ??  ' IIg   DOO%& #$(NN$4 H $E    - IIdO  ! !# / %5 #r c|[US5n[US5nUSU4$![a Of=fUS::aUnOUS::aSU-nOUS::aSU-nOS U-nUS RnUR[ 55U-n[ R "S 5R5nURU5nXR4$) N dk_nentriesdk_size dk_entriesirHl dk_indicesPyDictKeyEntry)r,rrrbrrrr)rOrYrnrooffsetent_addr ent_ptr_ts r rXPyDictObjectPtr._get_entriess$}-. d9o&  %w. .    d?F  [F  "[F[F %--==!8!:;fDOO$45==? ==+$$s % 22r N) rrrr r\rrrryrXr!r r r rrs"I-$ $%r rc*\rSrSrSrSrSrSrSrg)ri PyListObjectc,URS5nX!$Nob_itemrqrOr] field_ob_items r __getitem__PyListObjectPtr.__getitem__ 9- r c:UR5U;a [S5$URUR55 [[ UR S555Vs/sH)n[ RX5RU5PM+ nnU$s snf)N[...]rj) rrrr-rrqr^rtr)rOr{r]rds r rPyListObjectPtr.proxyvals ??  '&w/ / DOO%&&l4::i3H&IJLJa//8AA'JJ L Ls$0BcUR5U;aURS5 gURUR55 URS5 [[ UR S555HBnUS:aURS5 [ RX5nURX5 MD URS5 g)Nr[rjrr] rr/rr-rrqr^rtryrOrzr{r]elements r ryPyListObjectPtr.write_reprs ??  ' IIg   DOO%& #LI)>?@A1u $!33DG instances (Py_True/Py_False) within the process being debugged. c:[RX5(agg)NTF)rrrOr{s r rPyBoolObjectPtr.proxyval8s  # #D 2 2r r N)rrrr r\rr!r r r rr3s r rc"\rSrSrSrSrSrSrg)ri>z{ Class wrapping a gdb.Value that's a PyObject* pointing to the singleton (we hope) _Py_NoneStruct with ob_type PyNone_Type r`cgr*r rs r rPyNoneStructPtr.proxyvalEsr r NrAr r r rr>sIr rcX\rSrSrSrSSjrSrSrSrSr S r S r S r S r S rSrg)riI PyFrameObjectNcd[RXU5 UR5(Gd[R UR S55UlUR RS5UlUR RS5Ul [UR S55Ul [UR S55Ul [UR R S55Ul [R UR R S55Ulgg)Nf_codeco_name co_filenamef_linenof_lasti co_nlocals co_varnames)r^rPrrCrtrqcorvrrrrrrrrrds r rPPyFrameObjectPtr.__init__LsT73$$&&%77 88LMDG77--i8DL#ww11-@D (J)?@DM' 9(=>DL*477==+FGDO/AA$''--P]B^_D 'r c#<# UR5(agURS5n[UR5HXn[R X5nUR 5(aM1[R URU5nXC4v MZ g7f)zh Yield a sequence of (name,value) pairs of PyObjectPtr instances, for the local variables of this frame N f_localsplus)rrqr-rr^rtrkr)rOrr]r_ pyop_names r iter_localsPyFrameObjectPtr.iter_localsYs  " " zz.1 DOO,A$66|GJ%%'''99$:J:J1:MN  -- -s A*B0,BcpUR5(agURS5nUR5$)zi Yield a sequence of (name,value) pairs of PyObjectPtr instances, for the global variables of this frame r f_globalsrrvr)rO pyop_globalss r iter_globalsPyFrameObjectPtr.iter_globalshs3  " "{3 %%''r cpUR5(agURS5nUR5$)z\ Yield a sequence of (name,value) pairs of PyObjectPtr instances, for the builtin variables r f_builtinsr)rO pyop_builtinss r iter_builtinsPyFrameObjectPtr.iter_builtinsss3  " " 5 &&((r cfUR5H'up#XR[55:XdM#US4s $ UR5H'up#XR[55:XdM#US4s $ UR 5H'up#XR[55:XdM#US4s $ g)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)rrrrr)rOrorr_s r get_var_by_name PyFrameObjectPtr.get_var_by_name~s&*%5%5%7 !I))#%00!7**&8&*%6%6%8 !I))#%00!8++&9&*%7%7%9 !I))#%00!9,,&:r c~UR5(a[$URR[ 55$)z;Get the path of the current Python source file, as a string)rFRAME_INFO_OPTIMIZED_OUTrrrrXs r r@PyFrameObjectPtr.filenames0  " "+ +((//r cUR5(agURS5n[U5S:wa UR$URR UR 5$![a gf=f)zGet current line number as an integer (1-based) Translated from PyFrame_GetLineNumber and PyCode_Addr2Line See Objects/lnotab_notes.txt Nf_tracer)rrqr,rrrOr Exception)rOrs r current_line_num!PyFrameObjectPtr.current_line_numsl  " "**Y' w<1 ==  77$$T\\2 2    s$A)) A65A6cPUR5(a[$UR5nUcgUR5n[ [ U55nUR 5nSSS5 WUS- $!,(df  N=f![a gf=f![a gf=f)zVGet the text of the current source line as a string, with a trailing newline characterNz!(failed to get frame line number)r) rrrr@openrD readlinesOSError IndexError)rOrKr@fpliness r current_linePyFrameObjectPtr.current_lines  " "+ +&&( >6==? k(+, -  !$ $-,     sBBA7&B/B7 BBB BB B%$B%c ZUR5(aUR[5 gUR5nUb [ U5OSnURSUR 5UR RU5UURRU54-5 SnUR5HaupVU(dURS5 SnURURU55 URS5 URX5 Mc URS5 g)N?z)Frame 0x%x, for file %s, line %s, in %s (TrFrr) rr/rrstrrrrrrry)rOrzr{rKrrr_s r ryPyFrameObjectPtr.write_reprs  " " II. / &&( & 2V =__&%%..w7\\**7355 6 %)%5%5%7 !I $E IIi((1 2 IIcN  ! !# /&8 #r c UR5(a'[RRS[-5 g[ 5nUR 5nUb [U5OSn[RRSURRU5<SU<SURRU5<S35 g)N %s rz File "z", line z, in  ) rr9stdoutr/rrrrrrr)rOr{rKs r print_traceback PyFrameObjectPtr.print_tracebacks  " " JJ  X(@@ A %&&( & 2V %%..w7\\**735 6r )rrrrrrrr*)rrrr rrPrrrrr@rrryrr!r r r rrIs:I ` . ( )$0 0.. 6r rc:\rSrSrSr\S5rSrSrSr Sr g) rr$ PySetObjectcJ[R"S5R5$)N _PySet_Dummy)rlookup_global_symbolvaluerXs r _dummy_keyPySetObjectPtr._dummy_keys''7==??r c## UR5nURS5n[URS5S-5H2nX#nUSnUS:wdMXQ:wdM[R U5v M4 g7f)Ntablemaskrkeyr)rrqr-r^rt)rO dummy_ptrrr]setentryrs r __iter__PySetObjectPtr.__iter__siOO%  7#DJJv.23AxH5/CaxC,!33C88 4sAA8A8A8c^UR5T;a[SUR5-5$TRUR55 U4SjU5nUR5S:Xa [ U5$[ U5$)Nz%s(...)c3D># UHoRT5v M g7fr*)r).0rr{s r *PySetObjectPtr.proxyval..s9DS<<((Ds r)rrrrrr)rOr{memberss ` r rPySetObjectPtr.proxyvalsn ??  '&y43D3D3F'FG G DOO%&9D9    + -W% %w< r cPUR5nUR5U;aURS5 gURUR55 UR S5(d#URU5 URS5 gUS:wa"URU5 URS5 URS5 SnUH.nU(dURS5 S nUR X5 M0 URS 5 US:waURS 5 gg) Nr$usedz()rrriTrFrkr)rrr/rrqry)rOrzr{rrrs r ryPySetObjectPtr.write_reprs##% ??  ' IIg   DOO%&zz&!! IIg  IIdO  e  IIg  IIcN #C $E NN3 (  # e  IIcN r r N) rrrr rrrrrryr!r r r rrs*I@@9  r rc*\rSrSrSrSrSrSrSrg)ri& PyBytesObjectc URS5nURS5nURR[55nSR [ U5Vs/sHn[ X45PM sn5$s snf)Nrjob_svalr6)rqrrbrr?r-r=)rO field_ob_size field_ob_svalchar_ptrr]s r __str__PyBytesObjectPtr.__str__)sg 9-  9-  ((--.E.GHww*]2KL2KQHK(2KLMMLsA<c[U5$r*)rrs r rPyBytesObjectPtr.proxyval/s 4yr cURU5nSnSU;aSU;aSnURS5 URU5 UGHnXT:XdUS:Xa$URS5 URU5 M3US:XaURS5 MLUS:XaURS5 MeUS :XaURS 5 M~US :d[U5S :a^URS 5 UR[[U5S-S- 5 UR[[U5S-5 MURU5 GM URU5 g)N'"b\ \tr\n \r \xrrr)rr/r< hexdigits)rOrzr{rquoterCs r ryPyBytesObjectPtr.write_repr2s g& %<u E # %D}  $ $ %  %  % s4yD0 %  )SY%5!$;<= )CIO45 $ %r r N) rrrr rrrryr!r r r rr&sIN r rc*\rSrSrSrSrSrSrSrg)riQ PyTupleObjectc,URS5nX!$r}rrs r rPyTupleObjectPtr.__getitem__Trr c ^^TR5T;a [S5$TRTR55 [UU4Sj[ [ TR S55555nU$)Nr$c3r># UH,n[RTU5RT5v M. g7fr*)r^rtr)rr]rOr{s r r,PyTupleObjectPtr.proxyval.._s6Q O1#44T!W=FFwOO Os47rj)rrrtupler-rrq)rOr{rds`` r rPyTupleObjectPtr.proxyvalYsb ??  '&w/ / DOO%&Q *< 98M+N OQQ r cUR5U;aURS5 gURUR55 URS5 [[ UR S555HBnUS:aURS5 [ RX5nURX5 MD UR S5S:XaURS5 gURS5 g) Nr$rrjrrrz,)rrrs r ryPyTupleObjectPtr.write_reprcs ??  ' IIg   DOO%& #LI)>?@A1u $!33DG[ UR S 55n UR S5n UR5S:HnU(d'[U 5V s/sHn [ X5PM n n O/n Sn [U 5nX:a[ X5nU S - n US:d US:dX:XaU RU5 M;[ X5nUS:dUS:aMVUS-S-nUUS--nUS- nU RU5 U S - n X:aMSR!U Vs/sHnUS::a [#U5OSPM sn5nU$s snfs sn fs snf)Nr0rUF_basestateasciicompactready wstr_lengthTwstrlengthranykindrHrrrrr5 r6iu�) _is_pep393rrfieldsrorqr,rrbrrrr4r-r(r>r?r=)rOr{rGfmay_have_surrogatesr:r9r8is_compact_ascii field_length field_str repr_kindr] Py_UNICODEslimitucsucs2coderds r rPyUnicodeObjectPtr.proxyvals  __%67>>@FF#;FqFFF#;;J :"' jj)GG$E'NE #E'N 3 ME) )/F/H II!^ )/G/I JI!^ )/E/G HItzz(34L 5)I"&//"3q"8 #6@6NO6N3y|,6NKOKKA .E)),'Q<3&=A4E&&s+9<(&=D6Mf +v % """4(Q)&"$"SXh 6"$% E$>G+CJ &#b' :F : &#eh- A6 A#h hQ15 * 8, !!$B& 0R7C6 11 *"3xt| %( )TQY&,@"AB )D6M":; %( )TRZ:,E"FG )TRZ:,E"FG )TRZ:,E"FG )TRZ:,E"FG )TRZ:,E"FG )TQY*,D"EF )TQY*,D"EF )D:,=">? %( )TRZ6,A"BC )TQY&,@"AB )TQY&,@"AB )D6M":;IIbM #s#e*nv %Y.*$) *sQ QQr N) rrrr rr4rryr!r r r rrs!I'FPjr rc6\rSrSrSrSrSrSrSrSr Sr g) ri=cURS5SSR5n[U5$![[[ 4a gf=f)Ndescrd_baseroz)rqrrrrrrus r safe_namewrapperobject.safe_name@sL $::g&x08??AD: /AB $# $s/2A  A cURS5SSR5$![[[4a gf=f)NrOrirz)rqrrrrrXs r rwrapperobject.safe_tp_nameGsC '::f%i0;BBD D/AB '& 's $'??cn[URS55nSU-$![[4a gf=f)NrOz%#xz)r,rqrr)rOrs r safe_self_addresss wrapperobject.safe_self_addresssMs; 2$**V,-G7? ". 21 2s !44cUR5nUR5nUR5nSU<SU<SU<S3$)Nz)rerrj)rOr{ror self_addresss r rwrapperobject.proxyvalTs;~~##%..0 ,0 1r cHURU5nURU5 gr*rrs r rywrapperobject.write_repr[s g& %r r N) rrrr rrerrjrryr!r r r rr=s I$' 21r rc[U5$r*)r,res r rr`s v;r c[U5$r*)rpprintpformat)r'rvs r stringifyrwds Cyr c$\rSrSrSrSrSrSrg)PyObjectPtrPrinterinzPrints a (PyObject*)cXlgr*rs)rOres r rPPyObjectPtrPrinter.__init__qs r cl[RUR5nUR[5$r*)r^rtrerMAX_OUTPUT_LENrrrw)rOpyoprs r to_stringPyObjectPtrPrinter.to_stringts*,,T[[9 **>: :r rsN)rrrr r\rPrr!r r r ryryns'r rycURR5nUR[R:wagUR 5R5n[ U5nUS;a [U5$g)N)r`rr0r)r unqualifiedrRr TYPE_CODE_PTRtargetrry)rerrs r pretty_printer_lookupr~s` ;; " " $D yyC%%% ;;= $ $ &D D A MM!&))Nr cTUc[nURR[5 gr*)rpretty_printersr>r)objs r registerrs# {45r c\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS r\S5r\S5r\S5rSrSrSrg)Frameiz/ Wrapper for gdb.Frame, adding various methods cXlgr* _gdbframe)rOgdbframes r rPFrame.__init__s!r c\URR5nU(a [U5$gr*)rolderr)rOrs r r Frame.older$$$& < r c\URR5nU(a [U5$gr*)rnewerr)rOrs r r Frame.newerrr c[URS5(d [S5 gURR5 g)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)hasattrrprintrrXs r r Frame.selects: t~~x00 Q R r cSnUnUR5(a,US- nUR5nUR5(aM,U$)zOCalculate index of frame, starting at 0 for the newest frame within this threadrr)r)rOindex iter_frames r get_indexFrame.get_indexsL   QJE#))+J   r c\UR5(agUR5(agg)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_framerXs r is_python_frameFrame.is_python_frames+       % % ' 'r cURR5[:Xa.URR5[R :Xagg)z)Is this a _PyEval_EvalFrameDefault frame?TF)rro EVALFRAMErr NORMAL_FRAMErXs r rFrame.is_evalframes? >>   I - ~~""$(8(88r cUR5(agUR5(agURnUR5nU(dgUR S5(dUS:XaSnUR U5n[ U5$US :XaS nUR U5n[ U5$g![a SU-s$[a SU-s$f=f![a S U-s$[a S U-s$f=f) zIs 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_collectrro startswithread_varr ValueErrorr)rOrcallerarg_namers r rFrame.is_other_python_frames#  " " $ $(     '   5 6 6 & &H  O~~h/4y  ^ #H R~~h/4y % ;/19:; OChNN O <02:;< RFQQ Rs00B2C2CCCC9(C98C9cPURR5nU(aUS:H$g)z!Is this frame waiting on the GIL?take_gilNrrorus r rFrame.is_waiting_for_gil,s)~~""$ J& ' r c<URR5S:H$)z5Is this frame "collect" within the garbage-collector?collectrrXs r rFrame.is_gc_collect3s~~""$ 11r cvURRS5n[RU5nUR 5(dU$UnURR 5nU(a=URS5n[RU5nUR 5(dU$U$![ a gf=f)NrH)rrrrtrrr)rOrHr orig_framers r get_pyopFrame.get_pyop7s '',A$66q9E))++ J^^))+FOOC((::1=--// L   sAB+ AB+)B++ B87B8cR[R"5nU(a [U5$gr*)rselected_framer)rrs r get_selected_frameFrame.get_selected_frameKs!&&( # #r cUR5nU(a0UR5(aU$UR 5nU(aM0g![Ra gf=f)zRTry to obtain the Frame for the python-related code in the selected frame, or NoneN)rrerrorrrrrs r get_selected_python_frameFrame.get_selected_python_frameRs] **,E $$&& KKMEe yy  sA A! A!cUR5nU(a0UR5(aU$UR5nU(aM0g)z^Try to obtain the Frame for the python bytecode interpreter in the selected GDB frame, or NoneN)rrrrs r get_selected_bytecode_frame!Frame.get_selected_bytecode_frameds@&&(!!## KKMEe r cUR5(aUR5nU(aUR[5n[ [ R SUR5U4-5 UR5(dEUR5nUb1[ R RSUR5-5 ggg[ R RSUR5-5 gUR5nU(a3[ R RSUR5U4-5 g[ R RSUR5-5 g)Nz#%i %s  %s z.#%i (unable to read python frame information) z#%i ) rrrr}r2r9rrrrr/striprrOr~lineinfos r print_summaryFrame.print_summaryrs     ==?D..~>cjj*8H$7O*OP,,..,,.D' ((djjl)BC(/    !RUYUcUcUe!ef--/D   t~~/?.F!FG   4>>+;!;4z )rematchr,groupmapgroupsrrrrrUNABLE_READ_INFO_PYTHON_FRAMEr@rrrDrr9rr/r enumerater)rOrfrom_ttyrstartendmrr~r@rKrHerr all_linesr]rlinestrs r invoke PyList.invokes HH^T *  OE"*C HH/ 6 S!((*-JE113 N O ~~t,,.. / 0 ==?&&( > ; <  =QJE1*C 7E [*+A  I%YQws%;<ag,9&!GmG   !>? = Q   JJ   (#/ 0  Qs%$F.:A+G-. G*8(G%%G*- G;r Nrrrr r\rPrr!r r r rrs 17@r rc[R5nU(d [S5 gU(avU(aUR5nOUR 5nU(dOFUR 5(a&UR 5(aUR5 gUnU(aMvU(a [S5 g[S5 g)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)rrrrrrrr)move_uprrs r move_in_stackrs  + + -E  -.  JJ   % % ' '  ""((*  %" 45 34r c$\rSrSrSrSrSrSrg)PyUpizESelect and print the python stack frame that called this one (if any)c[RRUS[R[R5 g)Nzpy-uprrrP COMMAND_STACKrrXs r rP PyUp.__init__+ d%!//!// 1r c[SS9 g)NTrrrOrrs r r PyUp.invoke s d#r r Nrr r r rrsK1$r rc$\rSrSrSrSrSrSrg)PyDownizCSelect and print the python stack frame called by this one (if any)c[RRUS[R[R5 g)Nzpy-downrrXs r rPPyDown.__init__rr c[SS9 g)NFrrrs r r PyDown.invokes e$r r Nrr r r rrsI1%r rrc$\rSrSrSrSrSrSrg)PyBacktraceFulli!RDisplay the current python frame and all the frames within its call stack (if any)c[RRUS[R[R5 g)Nz py-bt-fullrrXs r rPPyBacktraceFull.__init__#s+ d*!//!// 1r c[R5nU(d [S5 gU(a?UR5(aUR 5 UR 5nU(aM>gg)Nr)rrrrrrrOrrrs r rPyBacktraceFull.invoke*sO//1 1 2 $$&&##%KKMEer r Nrr r r r r !sX1 "r r c$\rSrSrSrSrSrSrg) PyBacktracei7r c[RRUS[R[R5 g)Nzpy-btrrXs r rPPyBacktrace.__init__9rr c[R5nU(d [S5 g[RR S5 U(a?UR 5(aUR5 UR5nU(aM>gg)Nrz$Traceback (most recent call first): ) rrrr9rr/rrrrs r rPyBacktrace.invoke@sb//1 1 2  @A$$&&%%'KKMEer r Nrr r r rr7sX1 "r rc$\rSrSrSrSrSrSrg)PyPrintiN4Look up the given python variable name, and print itc[RRUS[R[R5 g)Nzpy-printrrrP COMMAND_DATArrXs r rPPyPrint.__init__Ps+ d(!..!// 1r c Z[U5n[R5nU(d [S5 gUR 5nU(d[[ 5 gUR U5upgU(a*[U<SU<SUR[5<35 g[SU-5 g)Nrr = z %r not found) rrrrrrrrr})rOrrror pyop_framepyop_varscopes r rPyPrint.invokeWs4y//1 1 2 ^^%  / 0 $44T:  11.AC D .4' (r r Nrr r r rrNs:1)r rc$\rSrSrSrSrSrSrg)PyLocalsiprc[RRUS[R[R5 g)Nz py-localsrrXs r rPPyLocals.__init__rs+ d)!..!// 1r c`[U5n[R5nU(d [S5 gUR 5nU(d[[ 5 gUR 5HAupg[UR[55<SUR[5<35 MC gNrr! rrrrrrrrrrr}rOrrrorr"rr_s r rPyLocals.invokeys4y//1 1 2 ^^%  / 0 %/%;%;%= !I ""35)--n= &>r r Nrr r r r'r'ps:1r r'cF^[R"T5U4Sj5nU$)z*sigh*, readlinec^>T"U0UD6$![a [R"5 ef=fr*)r traceback print_exc)rrfunctions r wrapper%dont_suppress_errors..wrappers6 T,V, ,     !  s !,) functoolswraps)r3r4s` r dont_suppress_errorsr8s%__X Nr c4\rSrSrSrSr\S5rSrSr g) PyGlobalsiz9List all the globals in the currently select Python framec[RRUS[R[R5 g)Nz py-globalsrrXs r rPPyGlobals.__init__s+ d*!..!// 1r c`[U5n[R5nU(d [S5 gUR 5nU(d[[ 5 gUR 5HAupg[UR[55<SUR[5<35 MC gr+r,r-s r rPyGlobals.invokes4y//1 1 2 ^^%  / 0 %/%;%;%= !I ((/ 33NCE F&>r c"UR5$r*)r)rOr"s r get_namespacePyGlobals.get_namespaces&&((r r N) rrrr r\rPr8rr@r!r r r r:r:s%?1 FF$)r r:cURR5S:Xa.URR5[R:Xagg)z#Is this a PyEval_EvalFrameEx frame?PyEval_EvalFrameExTF)rrorrr)rs r is_evalframeexrDs@ !55  ??   !S%5%5 5 r c*\rSrSrSr\S5rSrg) PyNameEqualsic[[R"55n[U5(aLUR 5nUc[ R "S5 g[X15R[55$g)NzBUse a Python debug build, Python breakpoints won't work otherwise.) rrrrDrwarningswarngetattrrr)rOattrrpyframes r _get_pycurframe_attr!PyNameEquals._get_pycurframe_attrs`c((*+ % nn&G 677)22359 9r c^URS5nUSL=(a X!R5:H$)Nr)rMr)rOfuncnamerKs r rPyNameEquals.invokes,((34=DOO,=$==r r N)rrrr rMr8rr!r r r rFrFs >>r rF pyname_equalsc$\rSrSr\S5rSrg) PyModEqualsicURS5nUbP[RR[RR U55up4X1R 5:H$g)NrF)rMospathsplitextbasenamer)rOmodnamerKr@exts r rPyModEquals.invokesP((7  GG,,RWW-=-=d-CDMH~~// /r r N)rrrr r8rr!r r r rTrTsr rT pymod_equalsc(\rSrSrSr\S5rSrg)PyBreakiz 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 cSU;a URS5up4nSU<SU<S3nOSU-n[R"SU-5 g)N.z$pyname_equals("z") && $pymod_equals("z")z$pyname_equals("%s")zbreak PyEval_EvalFrameEx if ) rpartitionrexecute)rOrPrrZdotconds r rPyBreak.invoke sJ (?%-%8%8%= "G(DLDKMD*H4D 2T9:r r N)rrrr r\r8rr!r r r r_r_s ;;r r_zpy-breakc0\rSrSrSrSrSrSrSrSr g) _LoggingStateizA State that helps to provide a reentrant gdb.execute() function. c[R"S5nXlURUlUR 5Ul[SUR-5 /Ulg)Nzr+zset logging file %s) tempfileNamedTemporaryFiler0ror@filenofd_executefile_position_stack)rOrHs r rP_LoggingState.__init__sI  ' ' -  ((*&67#% r cUR(d![S5 [S5 [S5 URR[R"UR 5R 5 U$)Nzset logging redirect onzset logging onzset pagination off)rornr>rVfstatrmst_sizerXs r __enter___LoggingState.__enter__'sR'' . / % & ) *   ''(9(A(AB r c[R"5 URRURS5 URR 5nU$)N)rflushr0seekroread)rOrds r getoutput_LoggingState.getoutput0s;  t//34! r cURR5nURRU5 URR 5 UR(d"[ S5 [ S5 [ S5 gg)Nzset logging offzset logging redirect offzset pagination on)ropopr0rytruncatern)rOexc_typeexc_valtbstartposs r __exit___LoggingState.__exit__6s_++//1 x  '' & ' / 0 ( )(r )rmr0ror@N) rrrr r\rPrtr{rr!r r r rhrhs& *r rhcU(a+[n[X5 UR5sSSS5 $[X5 g!,(df  g=f)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_staternr{)commandrrr8s r rcrc@s7  u W '??$^ # ^s ? A c2[R"5S$)z& Return the selected inferior in gdb. r)r inferiorsselected_threadthreads)rinferiorthreads r get_selected_inferiorrSs ==?1 r c[R"5up#[R"US5nUR U5 UR 5 [ R"SU-US9 [R"U5 g)z 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 %srN) rjmkstemprVfdopenr/closerrcremove)script_contentsrrmr@rHs r source_gdb_scriptrcsX##%LB "cAGGOGGIKK h&)<IIhr c[[R"S5[R[ R4-5 g)Nz define py-step -py-step end define py-next -py-next end document py-step %s end document py-next %s end )rtextwrapdedentPyStepr\PyNextr r r register_definesrrs1hoo' NNFNN +!,-r cTSnU(aUR5nUS- nU(aMU$)z$Tells the stackdepth of a gdb frame.rr)r)rdepths r stackdepthrs, E     % Lr cr^\rSrSrSrU4SjrSrSrSrSr Sr S r S r S r SS jrS rSrSrU=r$)ExecutionControlCommandBaseiz 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. cl>[TU]U[R[R5 X lgr*)superrPrCOMMAND_RUNNINGr lang_info)rOror __class__s r rP$ExecutionControlCommandBase.__init__s)  $c&9&93;L;L N"r c#,# [R"URR5URR 55nUHCn[ R "SU-SS9n[R"SU5RS5v ME g7f)Nzbreak %sTrBreakpoint (\d+)r) itertoolschainrstatic_break_functionsruntime_break_functionsrrcrsearchr)rO all_locationslocationrds r install_breakpoints/ExecutionControlCommandBase.install_breakpointssq! NN 1 1 3 NN 2 2 46 &H[[h!6$GF))/8>>qA A&sBBcHUHn[R"SU-5 M g)N delete %s)rrc)rObreakpoint_listbps r delete_breakpoints.ExecutionControlCommandBase.delete_breakpointss!B KK b( )"r c ^[RnSU[R-4SSU4/nSU4SU4/nU4Sjn[R"ST[R5nU(aSUR S 5-nOS nU"U5Xu"U5-4$) Nz^Program received signal .*)z.*[Ww]arning.*rz^Program exited .*z^(Old|New) value = .*z^\d+: \w+ = .*c>/nUHDup#[R"UTU5H#nURURS55 M% MF SR U5$)Nrr)rfinditerr>rr?)regexesoutputregexflagsrrds r filter_output@ExecutionControlCommandBase.filter_output..filter_outputsPF ' [[>EMM%++a.1?!(99V$ $r z^Value returned is \$\d+ = (.*)zValue returned: %s rr6)r MULTILINEDOTALLrr)rOrdreflagsoutput_on_halt output_alwaysr match_finish finish_outputs ` r r)ExecutionControlCommandBase.filter_outputs,,,WRYY-> ? " "G , &w /  (   %yy!CV!#/ 2\5G5G5JJMMn- m <<> >r c0[5RS:H$rS)rpidrXs r stopped#ExecutionControlCommandBase.stoppeds$&**a//r cURU5up#UR5(a[U5 [U5 g[R"5nUR R U5nUR RU5(a-UR RU5nU(a [U5 U(a:UR5(a[UR55 [U5 g[U5 g)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) rrrrrrget_source_lineis_relevant_functionexc_inforstrip)rOrdrrr source_lineraised_exceptions r finish_executing,ExecutionControlCommandBase.finish_executings )-(:(:6(B% <<>> - . !&&(E..88?K~~22599#'>>#:#:5#A #*+ ''))-..01k"f r c[R"5R5b[R"SSS9$[R"SSS9$)zL Execute until the function returns (or until something else makes it stop) finishTrcont)rrrrcrXs r _finish#ExecutionControlCommandBase._finishs@     % % ' 3;;x48 8;;v6 6r c&UR5n[R"5n[R "SU5nUR RU5nU(dU(dUR5(aU$M![a U$f=f)z: Execute until the function returns to a relevant caller. r) rrrrrrrrr)rOrdrhitbp is_relevants r _finish_frame)ExecutionControlCommandBase._finish_frames\\^F **,II16:E..==eDK t||~~      sB BBcFUR5nURU5 g)zImplements the finish command.N)rr)rOrrds r r"ExecutionControlCommandBase.finish s##% f%r cU(a[UR55n[R"5nURR U5(a-URR U5nU(d [U5nUnURR U5(a[R"USS9nOUR5nUR5(aO[R"5nURR U5n UR5n [R"SU5n U (aU (aU RS5W;aOZXt:wa)U(d[U5n U W:=(a U n U (aO-O)URR U5n U (aU W:waOGM2U(aUR!W5 UR#U5 g![a Sn Nf=f)aS 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. TrNrr)listrrrrrrKrrcrrrorrrrrr)rOstepintostepover_commandr beginframe beginlinernewframerdr framenamernewdepthrKs r step ExecutionControlCommandBase.step s& "4#;#;#=>O'') >> . .z : : --j9I":.~~228<<%5F++-||~~))+H#'>>#F#Fx#P  !$MMO  -v6A'AGGAJ/,I% )(3H,4u,<-A,@)(( ..x8f 1QT   # #O 4 f%A  !  !sG"" G10G1cRUR[R"SU-SS95 g)Nzrun Trrrrcrs r runExecutionControlCommandBase.run_ s ckk&4-4HIr cLUR[R"SSS95 g)NrTrr)rOrs r r ExecutionControlCommandBase.contb s ckk&DABr )r)next)rrrr r\rPrrrrrrrrrrrr! __classcell__rs@r rrsP # B*!>F04 7&& Q&fJCCr rc$\rSrSrSrSrSrSrg) LanguageInfoif ay 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 cg)zSee this class' docstring.Nr rOrs r rLanguageInfo.exc_info sr cg)zK Implement this if the list of step-into functions depends on the context. r r rXs r r$LanguageInfo.runtime_break_functions s r r N)rrrr r\rrr!r r r rrf s@%r rc8\rSrSrSrSrSrSrSrSr Sr g ) PythonInfoi cr[U5R5nU(aU$[R"S5e)NzuUnable to find the Python frame, run your code with a debug build (configure with --with-pydebug or compile with -g).)rrrrrOrrLs r rLPythonInfo.pyframe s7,'') N""LM Mr c@URU5R5$r*)rLrrs r rKPythonInfo.lineno s||E"3355r c4[U5R5$r*)rrDrs r rPythonInfo.is_relevant_function sU|**,,r cURU5nSUR5UR5R54-$![a gf=f)Nz %4d %s)rLrrrrrs r rPythonInfo.get_source_line s\ ll5)G'":":"<")"6"6"8"?"?"A"CC C  sAA AAc URS5R5n[R"S5(a3[R S:aUS=p4O USnUSnU(aSU<3$gg![ [4a gf=f)Ntstateztstate->frame == f)rYralphacurrent_exception curexc_type curexc_valuezAn exception was raised: )rrmrparse_and_evalr9 version_inforr)rOrr inf_type inf_values r rPythonInfo.exc_info s ^^H-99;F!!"677##'==+12E+FFHy%m4H &~ 6If_lastiTrz[Ww]atchpoint (\d+):rr)rrrN)rrcr,rrrr)rOrr watchpoints r python_stepPythonStepperMixin.python_step sW /4@#:FCII!LM  8h ? K*,-r r N)rrrr r\rr!r r r rr s  .r rc,\rSrSrSrSr\S5rSrg)ri zStep through Python code.Tc6URURS9 g)N)r)rrrs r r PyStep.invoke s $--0r r N) rrrr r\rr8rr!r r r rr sH11r rc\rSrSrSrSrSrg)ri zStep-over Python code.Fr N)rrrr r\rr!r r r rr s Hr rc<\rSrSrSr\"\R5rSr g)PyFinishi z+Execute until function returns to a caller.r N) rrrr r\r8rrrr!r r r r%r% s1 !"="D"D EFr r%c<\rSrSrSr\"\R5rSr g)PyRuni zRun the program.r N) rrrr r\r8rrrr!r r r r'r' s !"="A"A BFr r'c8\rSrSr\"\R 5rSrg)PyConti r N) rrrr r8rrrr!r r r r)r) s !"="B"B CFr r)c\URb[UR5$[U5$)zV Return the value of the pointer as a Python int. gdbval.type must be a pointer type )rr,rss r _pointervaluer+ s)~~!6>>""6{r cz[U5nUS:a[R"S5eU$![a U$f=f)Nrz:Negative pointer value, presumably a bug in gdb, aborting.)r+rGdbErrorr)rers r pointervaluer. sUF#G Q;,, 34 4  N   N  s , ::c[R"S5 g![a+ [R"S5 g![a gf=ff=f)NPyUnicode_FromEncodedObjectr6PyUnicodeUCS2_FromEncodedObjectUCS2UCS4)rrrr r r get_inferior_unicode_postfixr4 sY  89     @ A  s$ A< A A A  AcN\rSrSrSrSrSrSrSrSr Sr S r S r SS jr S rg )PythonCodeExecutori iic[R"SU-5n[U5nUS:Xa[R"S5eU$)Nz(void *) malloc((size_t) %d)rz-No memory could be allocated in the inferior.)rrr.r-)rOr chunkrs r mallocPythonCodeExecutor.malloc# s>##$BT$IJu% a<,,NO Or clUR[U55n[5RX!5 U$r*)r:rTr write_memory)rOrrs r alloc_stringPythonCodeExecutor.alloc_string, s*++c&k*,,W=r c~URU5nSn[R"U5 [R"SX2[ U54-5nUR U5 [U5nUS:Xa[R"S5eU$![a S[ 5<S3nNzf=f!UR U5 f=f)NPyString_FromStringAndSize PyUnicode_FromStringAndSizez)(PyObject *) %s((char *) %d, (size_t) %d)rz1Unable to allocate Python string in the inferior.) r>rrrr4rTfreer.r-)rOrstringprArdrs r alloc_pystring!PythonCodeExecutor.alloc_pystring2 s##F+%A" R   9 :  '';6V?NNOF IIg v& a<,, /0 0# R1M0N+Q & R IIg sB $B) B&%B&)B<c6[R"SU-5 g)Nz(void) free((void *) %d)rrrOrs r rDPythonCodeExecutor.freeK s 5?@r c6[R"SU-5 g)zAIncrement the reference count of a Python object in the inferior.zPy_IncRef((PyObject *) %d)NrIrJs r increfPythonCodeExecutor.increfN s 7'ABr c6[R"SU-5 g)zADecrement the reference count of a Python object in the inferior.zPy_DecRef((PyObject *) %d)NrIrJs r xdecrefPythonCodeExecutor.xdecrefR s 7'ABr NcSU;a[R"S5eUS- nURU5n[U5n[U5nUS:XdUS:Xa[R"S5eS[ XRXgS9-n[ 5 [R "U5nURU5 SSS5 U$!URU5 f=f!,(df  W$=f)a 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) )rRrglobalslocalsN)rr-r>r.rFetchAndRestoreErrorrrD) rOrR input_type global_dict local_dictrglobalsplocalsppyobject_return_values r evalcodePythonCodeExecutor.evalcodeY s 4<,,:; ;  ##D) ,z* q=GqL,,NO O #5 5" # #(+(:(:4(@% '" $ %$ '" $ # %$s$C B6C 6C  C  Cr r)rrrr Py_single_input Py_file_input Py_eval_inputr:r>rFrDrMrPr]r!r r r r6r6 s7OMM 2ACC%%r r6c*\rSrSrSrSrSrSrSrg)rVi z[ Context manager that fetches the error indicator in the inferior and restores it on exit. cD[R"S5R5RUlUR URS-5UlURnURUR-nURURS--nXU4Ulg)Nr`r rH)rrrrsizeof_PyObjectPtrr:errstate)rOrrr1s r rPFetchAndRestoreError.__init__ s"%//*"="E"E"G"N"N{{4#:#:Q#>? || t666LL4#:#:Q#>> Y. r cJ[R"SUR-5 g)NzPyErr_Fetch(%d, %d, %d))rrrerXs r rtFetchAndRestoreError.__enter__ s 4t}}DEr c&[R"S5(a[R"S5 Sn[R"X R-5 URUR5 g!URUR5 f=f)Nz(int) PyErr_Occurred()z PyErr_Print()zAPyErr_Restore((PyObject *) *%d,(PyObject *) *%d,(PyObject *) *%d))rrrerDr)rOr pyerr_restores r rFetchAndRestoreError.__exit__ sd   6 7 7    /0  $   }}}< = IIdll #DIIdll #s "A33B)rerrdN) rrrr r\rPrtrr!r r r rVrV s /F $r rVc>^\rSrSrU4SjrSr\S5rSrU=r $) FixGdbCommandi cl>[TU]U[R[R5 X lgr*)rrPrrractual_command)rOrrors r rPFixGdbCommand.__init__ s) #"2"2,/,=,= ?,r c[R"SS[[R"[ 55 [ [R"S55S:H g![a gf=f)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) rHfilterwarningsRuntimeWarningrescaperr,rrrrXs r fix_gdbFixGdbCommand.fix_gdb sS" % " ( 3 5  ""<0 1Q 6   s"A A'&A'cUR5 [R"UR<SU<35 UR5 g![a$n[R "[ U55eSnAff=f)Nr)rvrrcrorr-r)rOrres r rFixGdbCommand.invoke sW  ' KK4#6#6= >  ',,s1v& & 's'A A8A33A8)ro) rrrr rPrvr8rr!rrs@r rmrm s!- 2r rmc[R"S5n[R"S5n[U5S:Xd[U5S:Xa[R"S5eUR XX45$)z5 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).)rrr.r-r])executorrRrWrXrYs r _evalcode_pythonr} sj$$%:;K##$89J[!Q&,z*Ba*Gll./ /   T{ GGr c*\rSrSrSr\S5rSrg)PyExeci cU(aU[R4$/n[S5nUR5S:XaOUR U5 M4SR U5[R4$![ a M.f=f)Nrmrr)r6r_inputrr>EOFErrorr?r`)rOexprrrs r readcodePyExec.readcode s +;;; ;E' :D{{}-LL&99U#%7%E%EE E s A22 B?BcURU5up[5nUR[XC[[ 55 gr*)rr6rPr}rXrY)rOrrrWr|s r r PyExec.invoke s3==.%')( ZXYr r N)rrrr rr8rr!r r r rr sF$ZZr rzset breakpoint pending onr-z-py-stepz-py-nextz py-finishzpy-runzpy-contzpy-execz-py-execz1Use gdb 7.2 or higher to use the py-exec command.)FF)F)r\rrVlocaler9r rrrrrFrrrrrrrrPy_TPFLAGS_TYPE_SUBCLASSr}rgetpreferredencodingr[rrrrrr(r-r2fsencoderDAttributeErrorrFrIr^rnrrrrrrrrrrr,r4rrCrrrrrrrrrrr.rrrrwryrrcurrent_objfilerrrrrrrr rrr'rrHrjr6rrr1r8r:rDFunctionrFrTr_rrrhrcrnrrrrrrrrrrrr%r'r)r+r.r4r6rVrmr}rpy_steppy_next py_finishpy_runpy_contpy_execr_py_execrIr r r rst(Z -6754   ' ' ' ' ' ' ' '   & & (> L &  l )  ++K& l &u!u!n[  ,*::"3#'@T @TD2Y24{44 { 77  <;<*k:P%kP%fkB* k* Z o k]6{]6~;[;|){)V"{"Hk8yyx K F'' *&6 #   !k=k=ZJ@S[[J@\5: $3;; $ %S[[ % 399hF H"ckk"("#++"* )ckk)@ s{{8   ) )>  >3<<>( _, N;ckk;0 C''):):;#*#*L $ ;;   -(SC#++SCl))X+#+#\.."1 (*<1V F*F C 'C D (D   a%a%H$-$D'CKK'T HZS[[Z6 '( 3 Z.GZ.Gjl3I 8Z\ *FY -GIz2Gj#"2"2C4E4EFH MMEFKT   s& S** S76S7