File: //usr/share/gdb/python/gdb/__pycache__/FrameDecorator.cpython-310.pyc
o
��nb�( � @ s\ d dl Z ze W n ey eZY nw G dd� de�ZG dd� de�ZG dd� de�ZdS )� Nc @ sf e Zd ZdZ dd� Zedd� �Zdd� Zdd � Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
dd� ZdS )�FrameDecoratorz)Basic implementation of a Frame Decoratorc C s
|| _ d S �N)�_base)�self�base� r �+/usr/share/gdb/python/gdb/FrameDecorator.py�__init__= s
zFrameDecorator.__init__c C s: | � � }|jr|jjr| �� tjks| �� tjkrdS dS )zIInternal utility to determine if the frame is special or
limited.TF)�find_sal�symtab�filename�type�gdb� DUMMY_FRAME�SIGTRAMP_FRAME)�frame�salr r r �_is_limited_frame@ s ��z FrameDecorator._is_limited_framec C s t | jd�r | j�� S dS )zLReturn any elided frames that this class might be
wrapping, or None.�elidedN)�hasattrr r �r r r r r Q s
zFrameDecorator.elidedc C st t | jtj�st| jd�r| j�� S | �� }|�� tjkr dS |�� tj kr(dS |�� }|du r6|�
� }|S t |�S )a� Return the name of the frame's function or an address of
the function of the frame. First determine if this is a
special frame. If not, try to determine filename from GDB's
frame internal function API. Finally, if a name cannot be
determined return the address. If this function returns an
address, GDB will attempt to determine the function name from
its internal minimal symbols store (for example, for inferiors
without debug-info).�functionz<function called from gdb>z<signal handler called>N) �
isinstancer r �Framer r �inferior_framer
r r �pc�str)r r �funcr r r r r Y s
zFrameDecorator.functionc C s& t | jd�r | j�� S | �� }|�� S )z$Return the address of the frame's pc�address)r r r r r �r r r r r r ~ s
zFrameDecorator.addressc C sN t | jd�r | j�� S | �� }|�� }|jr|jjs#|�� }t�|�S |jjS )z�Return the filename associated with this frame, detecting
and returning the appropriate library name is this is a shared
library.r ) r r r r r
r r r �
solib_name)r r r r r r r r � s
zFrameDecorator.filenamec C �< t | jd�r | j�� S | �� }| �|�rdS t|�}|�� S )a Return an iterable of frame arguments for this frame, if
any. The iterable object contains objects conforming with the
Symbol/Value interface. If there are no frame arguments, or
if this frame is deemed to be a special case, return None.�
frame_argsN)r r r" r r � FrameVars�fetch_frame_args�r r �argsr r r r" � �
zFrameDecorator.frame_argsc C r! )a Return an iterable of local variables for this frame, if
any. The iterable object contains objects conforming with the
Symbol/Value interface. If there are no frame locals, or if
this frame is deemed to be a special case, return None.� frame_localsN)r r r( r r r# �fetch_frame_localsr% r r r r( � r' zFrameDecorator.frame_localsc C sB t | jd�r | j�� S | �� }| �|�rdS |�� }|r |jS dS )z�Return line number information associated with the frame's
pc. If symbol table/line information does not exist, or if
this frame is deemed to be a special case, return None�lineN)r r r* r r r
)r r r r r r r* � s
zFrameDecorator.linec C s t | jd�r | j�� S | jS )z7Return the gdb.Frame underpinning this frame decorator.r )r r r r r r r r � s
z FrameDecorator.inferior_frameN)�__name__�
__module__� __qualname__�__doc__r � staticmethodr r r r r r" r( r* r r r r r r s
% r c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �SymValueWrapperzkA container class conforming to the Symbol/Value interface
which holds frame locals or frame arguments.c C s || _ || _d S r )�sym�val)r �symbol�valuer r r r � s
zSymValueWrapper.__init__c C � | j S )z5Return the value associated with this symbol, or None)r2 r r r r r4 � s zSymValueWrapper.valuec C r5 )zOReturn the symbol, or Python text, associated with this
symbol, or None)r1 r r r r r3 � s zSymValueWrapper.symbolN)r+ r, r- r. r r4 r3 r r r r r0 � s
r0 c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) r# zOUtility class to fetch and store frame local variables, or
frame arguments.c C s: || _ tjdtjdtjdtjdtjdtjdtjdi| _ d S )NT)
r r �SYMBOL_LOC_STATIC�SYMBOL_LOC_REGISTER�SYMBOL_LOC_ARG�SYMBOL_LOC_REF_ARG�SYMBOL_LOC_LOCAL�SYMBOL_LOC_REGPARM_ADDR�SYMBOL_LOC_COMPUTED� symbol_classr r r r r � s
�zFrameVars.__init__c C s" t |t�rdS |j}| j�|d�S )z�Local utility method to determine if according to Symbol
type whether it should be included in the iterator. Not all
symbols are fetched, and only symbols that return
True from this method should be fetched.TF)r �
basestring�
addr_classr= �get)r r1 �sym_typer r r �fetch_b� s
zFrameVars.fetch_bc C s� g }z| j �� }W n ty d}Y nw |dur?|js |jr" |S |D ]}|jr*q$| �|�r7|�t|d�� q$|j }|dus|S )z�Public utility method to fetch frame local variables for
the stored frame. Frame arguments are not fetched. If there
are no frame local variables, return an empty list.N)
r �block� RuntimeError� is_global� is_static� is_argumentrB �appendr0 �
superblock)r �lvarsrC r1 r r r r) s& � �
�� z FrameVars.fetch_frame_localsc C sz g }z| j �� }W n ty d}Y nw |dur&|jdur n|j}|dus|dur;|D ]}|js2q,|�t|d�� q,|S )z�Public utility method to fetch frame arguments for the
stored frame. Frame arguments are the only type fetched. If
there are no frame argument variables, return an empty list.N)r rC rD r rI rG rH r0 )r r& rC r1 r r r r$ s" �
�zFrameVars.fetch_frame_argsN)r+ r, r- r. r rB r) r$ r r r r r# � s r# )r r> � NameErrorr �objectr r0 r# r r r r �<module> s � 8