File: //usr/share/gdb/python/gdb/command/__pycache__/explore.cpython-310.pyc
o
��nb�h � @ s� d Z ddlZddlZejd dkreZG dd� de�ZG dd� de�ZG dd � d e�Z G d
d � d e�Z
G d d
� d
e�Z G dd� de�Z G dd� de�Z
G dd� de�ZG dd� dej�ZG dd� dej�ZG dd� dej�Ze�� e� e� e� dS )zEImplementation of the GDB 'explore' command using the GDB Python API.� N� c @ s� e Zd ZdZi Zejejejej ej
ej fZ e
dd� �Ze
dd� �Ze
dd� �Ze
dd � �Ze
d
d � �Ze
d d
� �Ze
dd� �Ze
dd� �Ze
dd� �ZdS )�Explorerz-Internal class which invokes other explorers.c C s� t | �}d}| d dkr| |d dkrn2d}||k rG| | }|dks;d|kr+|dks;d |kr3|d
ks;d |kr<|d kr<nd
}n|d7 }||k s|rOd| d S | S )NFr �(� �)�_�a�z�A�Z�0�9T)�len)�expr�length�guard�i�c� r �,/usr/share/gdb/python/gdb/command/explore.py�
guard_expr* s& � zExplorer.guard_exprc C sX |j j}|tjv r!tj| }|�| ||�r |�| ||�sdS dS tdt|j � � dS )a� Main function to explore an expression value.
Arguments:
expr: The expression string that is being explored.
value: The gdb.Value value of the expression.
is_child: Boolean value to indicate if the expression is a child.
An expression is a child if it is derived from the main
expression entered by the user. For example, if the user
entered an expression which evaluates to a struct, then
when exploring the fields of the struct, is_child is set
to True internally.
Returns:
No return value.
�*Explorer for type '%s' not yet available.
N)�type�coder �type_code_to_explorer_map� explore_expr�print�str)r �value�is_child� type_code�explorer_classr r r r F s
�zExplorer.explore_exprc C sT |j }|tjv r tj| }|�| ||�r |�| ||�sdS dS tdt|� � dS )a� Main function to explore a data type.
Arguments:
name: The string representing the path to the data type being
explored.
datatype: The gdb.Type value of the data type being explored.
is_child: Boolean value to indicate if the name is a child.
A name is a child if it is derived from the main name
entered by the user. For example, if the user entered
the name of struct type, then when exploring the fields
of the struct, is_child is set to True internally.
Returns:
No return value.
r N)r r r � explore_typer r )�name�datatyper r r! r r r r" _ s
�zExplorer.explore_typec C sX t jtt jtt jtt jtt jtt jtt jt t j
t t j t t j
tt jtt jtt jti
t_dS )z�Initializes the Explorer environment.
This function should be invoked before starting any exploration. If
invoked before an exploration, it need not be invoked for subsequent
explorations.
N)�gdb�TYPE_CODE_CHAR�ScalarExplorer�
TYPE_CODE_INT�TYPE_CODE_BOOL�
TYPE_CODE_FLT�TYPE_CODE_VOID�TYPE_CODE_ENUM�TYPE_CODE_STRUCT�CompoundExplorer�TYPE_CODE_UNION�
TYPE_CODE_PTR�PointerExplorer�
TYPE_CODE_REF�ReferenceExplorer�TYPE_CODE_RVALUE_REF�TYPE_CODE_TYPEDEF�TypedefExplorer�TYPE_CODE_ARRAY�
ArrayExplorerr r r r r r �init_envx s
�zExplorer.init_envc C s | j tjv S )a� Checks whether a type is a scalar type.
A type is a scalar type of its type is
gdb.TYPE_CODE_CHAR or
gdb.TYPE_CODE_INT or
gdb.TYPE_CODE_BOOL or
gdb.TYPE_CODE_FLT or
gdb.TYPE_CODE_VOID or
gdb.TYPE_CODE_ENUM.
Arguments:
type: The type to be checked.
Returns:
'True' if 'type' is a scalar type. 'False' otherwise.
)r r �_SCALAR_TYPE_LIST)r r r r �is_scalar_type� s zExplorer.is_scalar_typec C � t d� dS )z�A utility function which prints that the current exploration session
is returning to the parent value. Useful when exploring values.
z
Returning to parent value...
N�r r r r r �return_to_parent_value� � z Explorer.return_to_parent_valuec C r< )z�A utility function which prompts the user to press the 'enter' key
so that the exploration session can shift back to the parent value.
Useful when exploring values.
z(
Press enter to return to parent value: N�� raw_inputr r r r � return_to_parent_value_prompt� � z&Explorer.return_to_parent_value_promptc C r< )z�A utility function which prints that the current exploration session
is returning to the enclosing type. Useful when exploring types.
z
Returning to enclosing type...
Nr= r r r r �return_to_enclosing_type� r? z!Explorer.return_to_enclosing_typec C r< )z�A utility function which prompts the user to press the 'enter' key
so that the exploration session can shift back to the enclosing type.
Useful when exploring types.
z*
Press enter to return to enclosing type: Nr@ r r r r � return_to_enclosing_type_prompt� rC z(Explorer.return_to_enclosing_type_promptN)�__name__�
__module__� __qualname__�__doc__r r% r& r( r) r* r+ r, r: � staticmethodr r r" r9 r; r> rB rD rE r r r r r s8 �
r c @ �( e Zd ZdZedd� �Zedd� �ZdS )r' z-Internal class used to explore scalar values.c C s> t d| |jf � t d| t|�f � |r t�� t�� dS )z�Function to explore scalar values.
See Explorer.explore_expr and Explorer.is_scalar_type for more
information.
z$'%s' is a scalar value of type '%s'.z%s = %sF)r r r r rB r> )r r r r r r r � s zScalarExplorer.explore_exprc C sr |j tjkr|rtd| t|�f � ntd| � n|r'td| t|�f � ntd| � |r7t�� t�� dS )z�Function to explore scalar types.
See Explorer.explore_type and Explorer.is_scalar_type for more
information.
z!%s is of an enumerated type '%s'.z'%s' is an enumerated type.z %s is of a scalar type '%s'.z'%s' is a scalar type.F)r r% r, r r r rE rD )r# r$ r r r r r" � s zScalarExplorer.explore_typeN�rF rG rH rI rJ r r" r r r r r' � �
r' c @ rK )r1 z.Internal class used to explore pointer values.c C s6 t d| t|j�� �f � td�}|dkrGd}z
|�� }t|� W n tjy8 t d| � |r5t� � Y dS w t�
dt� | � ||� dS td�}|dkr� d
}z
t td | ��}W n
t
yf Y dS w d t� | �|f }|| }zt|� W n tjy� t d
| � Y qOw t�
||d � qP|r�t�� dS )zdFunction to explore pointer values.
See Explorer.explore_expr for more information.
z)'%s' is a pointer to a value of type '%s'z<Continue exploring it as a pointer to a single value [y/n]: �yNz6'%s' a pointer pointing to an invalid memory location.Fz*%sz6Continue exploring it as a pointer to an array [y/n]: Tr �<Enter the index of the element you want to explore in '%s': �%s[%d]� Cannot read value at index %d.)r r r �targetrA � dereferencer% � MemoryErrorr rB r r �int�
ValueErrorr> )r r r �option� deref_value�index� element_expr�elementr r r r � sl ��� ������ � ��z PointerExplorer.explore_exprc C �2 |� � }td| t|�f � t�d| ||� dS )�cFunction to explore pointer types.
See Explorer.explore_type for more information.
z)
%s is a pointer to a value of type '%s'.zthe pointee type of %sF�rR r r r r" �r# r$ r � target_typer r r r" & � z PointerExplorer.explore_typeNrL r r r r r1 � s
7r1 c @ rK )r3 z@Internal class used to explore reference (TYPE_CODE_REF) values.c C � |� � }t�| ||� dS )�bFunction to explore array values.
See Explorer.explore_expr for more information.
F)�referenced_valuer r )r r r rd r r r r 5 � z ReferenceExplorer.explore_exprc C rb )r] F)rR r r" r_ r r r r" > re z ReferenceExplorer.explore_typeNrL r r r r r3 2 s
r3 c @ rK )r8 z&Internal class used to explore arrays.c C s� |j �� }td| t|�f � d}z
ttd| ��}W n ty+ |r(t�� Y dS w d}z
|| }t|� W n t j
yM td| � td� Y dS w t� d t� | �|f |d� dS )
rc z'%s' is an array of '%s'.r rO FNrQ zPress enter to continue... TrP )
r rR r r rU rA rV r r> r% rT r r )r r r r` rY r[ r r r r K s:
��� � ��zArrayExplorer.explore_exprc C r\ )zaFunction to explore array types.
See Explorer.explore_type for more information.
z%s is an array of '%s'.zthe array element of %sFr^ r_ r r r r" m ra zArrayExplorer.explore_typeNrL r r r r r8 H s
!r8 c @ s@ e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zd
S ) r. z:Internal class used to explore struct, classes and unions.c C sR d}| D ]}|t |d �k rt |d �}q| D ]}td||d |d f � qdS )zBInternal function which prints the fields of a struct/class/union.r z
%*s = %sr N)r r )�
print_list�max_field_name_length�pairr r r �
_print_fields| s � �z CompoundExplorer._print_fieldsc C s d}| D ] }|j s
|d }q|S )Nr r )�
artificial)�fields�real_field_count�fieldr r r �_get_real_field_count� s �z&CompoundExplorer._get_real_field_countc C s� |j }|j}|�� }|tjkrd}nd}t�|�dkr/td| |t|j �f � |r-t �
� dS td| |t|j �f � d}i }d} g }
|D ]l} | j rKqEt � | �d | j
} | jr_|�| j �}
n|| j
}
d}|tjkrwd | t| j �f }d
}n&t �| j �r�d t|
�t| j �f }n| jr�d }nd
}d| |t| j �f }d
}| |
f|t| �< | d } |
�| j
|f� qEt�|
� td� |r�td�}||v r�t �|| d || d d
� d
S |r�t �� dS |r�t �
� dS )zvFunction to explore structs/classes and union values.
See Explorer.explore_expr for more information.
� struct/class�unionr z6The value of '%s' is a %s of type '%s' with no fields.FzBThe value of '%s' is a %s of type '%s' with the following fields:
�.� z-<Enter %d to explore this field of type '%s'>Tz%s .. (Value of type '%s')�
base classrm �*<Enter %d to explore this %s of type '%s'>r �"Enter the field number of choice: )r r rk r% r- r. rn r r r rB rj r r# �
is_base_class�castr/ r; �appendri rA r r> )r r r r$ r rk � type_desc�has_explorable_fields� choice_to_compound_field_map�current_choicerf rm �field_full_name� field_value�
literal_value�
field_desc�choicer r r r � s�
����
� �� �
��z CompoundExplorer.explore_exprc C s� |j }d}|tjkr
d}nd}|�� }t�|�dkr7|r-td| |t|�f � t� � dS td| |f � dS |rEtd| |t|�f � ntd | |f � d}i }g }|D ]/} | j
r[qU| j rad
}
nd }
d ||
t| j �f } |�
| j| f� | j| j |
f|t|�< |d
}qUt�|� td� t|�dkr�td�} | |v r�|r�d|| d || d | f }
nd|| d || d | f }
t�|
|| d
d� dS |r�t�� dS |r�t� � dS )zrFunction to explore struct/class and union types.
See Explorer.explore_type for more information.
rr ro rp r z'%s is a %s of type '%s' with no fields.z '%s' is a %s with no fields.Fz3%s is a %s of type '%s' with the following fields:
z('%s' is a %s with the following fields:
rs rm rt r ru z
%s '%s' of %sr z%s '%s' of '%s'T)r r% r- rk r. rn r r r rE rj rv r rx r# ri r rA r" rD )r# r$ r r ry rk r| r{ rf rm r� �rhsr� �new_namer r r r" � s�
��� ��� �
�
���z CompoundExplorer.explore_typeN) rF rG rH rI rJ ri rn r r" r r r r r. y s
]r. c @ rK )r6 z>Internal class used to explore values whose type is a typedef.c C s> |j �� }td| t|j �t|�f � t�| |�|�|� dS )zdFunction to explore typedef values.
See Explorer.explore_expr for more information.
zAThe value of '%s' is of type '%s' which is a typedef of type '%s'F)r �strip_typedefsr r r r rw )r r r � actual_typer r r r H s
��z TypedefExplorer.explore_exprc C sH |� � }|rtd| t|�f � n
td| t|�f � t�| ||� dS )zcFunction to explore typedef types.
See Explorer.explore_type for more information.
z)The type of %s is a typedef of type '%s'.z(The type '%s' is a typedef of type '%s'.F)r� r r r r" )r# r$ r r� r r r r" W s �z TypedefExplorer.explore_typeNrL r r r r r6 E rM r6 c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) � ExploreUtilszEInternal class which provides utilities for the main command classes.c C s t |�dk r
t�d| ��dS )a� Utility to check if adequate number of arguments are passed to an
explore command.
Arguments:
name: The name of the explore command.
arg_str: The argument string passed to the explore command.
Returns:
True if adequate arguments are passed, false otherwise.
Raises:
gdb.GdbError if adequate arguments are not passed.
r z!ERROR: '%s' requires an argument.FT)r r% �GdbError)r# �arg_strr r r �
check_argsk s zExploreUtils.check_argsc C sN z t �d| �j�� W S ty& zt �| �W Y S ty% Y Y dS w w )a< A utility function to deduce the gdb.Type value from a string
representing the type.
Arguments:
type_str: The type string from which the gdb.Type value should be
deduced.
Returns:
The deduced gdb.Type value if possible, None otherwise.
z(%s *)0N)r% �parse_and_evalr rR � RuntimeError� lookup_type)�type_strr r r �get_type_from_str� s ��z ExploreUtils.get_type_from_strc C s" zt �| �W S ty Y dS w )aC A utility function to deduce the gdb.Value value from a string
representing the value.
Arguments:
value_str: The value string from which the gdb.Value value should
be deduced.
Returns:
The deduced gdb.Value value if possible, None otherwise.
N)r% r� r� )� value_strr r r �get_value_from_str� s
�z ExploreUtils.get_value_from_strN)rF rG rH rI rJ r� r� r� r r r r r� h s
r� c �( e Zd ZdZ� fdd�Zdd� Z� ZS )�ExploreCommanda Explore a value or a type valid in the current context.
Usage: explore ARG
- ARG is either a valid expression or a type name.
- At any stage of exploration, hit the return key (instead of a
choice, if any) to return to the enclosing type or value.c s t t| �jdtjdd� d S )N�exploreT)r# �
command_class�prefix)�superr� �__init__r% � COMMAND_DATA��self�� __class__r r r� � s
�zExploreCommand.__init__c C sj t �d|�du r
d S t �|�}|d ur t�||d� d S t �|�}|d ur.t�||d� d S t�d| ��)Nr� FzG'%s' neither evaluates to a value nor is a type in the current context.) r� r� r� r r r� r" r% r� )r� r� �from_ttyr r$ r r r �invoke� s
��zExploreCommand.invoke�rF rG rH rI r� r� �
__classcell__r r r� r r� � � r� c r� )�ExploreValueCommandz�Explore value of an expression valid in the current context.
Usage: explore value ARG
- ARG is a valid expression.
- At any stage of exploration, hit the return key (instead of a
choice, if any) to return to the enclosing value.c � t t| �jdtjd� d S )N�
explore value�r# r� )r� r� r� r% r� r� r� r r r� � �
�z ExploreValueCommand.__init__c C sF t �d|�du r
d S t �|�}|d u rt�d| ��t�||d� d S )Nr� Fz: '%s' does not evaluate to a value in the current context.)r� r� r� r% r� r r )r� r� r� r r r r r� � s
��zExploreValueCommand.invoker� r r r� r r� � r� r� c r� )�ExploreTypeCommandz�Explore a type or the type of an expression.
Usage: explore type ARG
- ARG is a valid expression or a type name.
- At any stage of exploration, hit the return key (instead of a
choice, if any) to return to the enclosing type.c r� )N� explore typer� )r� r� r� r% r� r� r� r r r� � r� zExploreTypeCommand.__init__c C s� t �d|�du r
d S t �|�}|d ur t�||d� d S t �|�}|d ur=td|t|j�f � t�t|j�|jd� d S t �
d| ��)Nr� Fz'%s' is of type '%s'.z3'%s' is not a type or value in the current context.) r� r� r� r r" r� r r r r% r� )r� r� r� r$ r r r r r� � s
�zExploreTypeCommand.invoker� r r r� r r� � r� r� )rI r% �sys� version_info�inputrA �objectr r' r1 r3 r8 r. r6 r� �Commandr� r� r� r9 r r r r �<module> s, '*G1 M#A' "