| Server IP : 43.141.49.107 / Your IP : 113.219.202.173 Web Server : Apache System : Linux VM-8-5-opencloudos 6.6.34-9.oc9.x86_64 #1 SMP PREEMPT_DYNAMIC Wed Jun 19 19:35:45 CST 2024 x86_64 User : www ( 1000) PHP Version : 8.1.27 Disable Function : passthru,exec,system,putenv,chroot,chgrp,chown,shell_exec,popen,proc_open,pcntl_exec,ini_alter,ini_restore,dl,openlog,syslog,readlink,symlink,popepassthru,pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,imap_open,apache_setenv MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/share/gdb/python/gdb/__pycache__/ |
Upload File : |
�
� �e�* � � � d Z ddlZddlZddlZ G d� de� � Z G d� de� � Z G d� de� � Z G d � d
e� � Zd � Z d � Z
dd�Z dS )z Utilities for defining xmethods� Nc � � e Zd ZdZd� ZdS )�XMethoda� Base class (or a template) for an xmethod description.
Currently, the description requires only the 'name' and 'enabled'
attributes. Description objects are managed by 'XMethodMatcher'
objects (see below). Note that this is only a template for the
interface of the XMethodMatcher.methods objects. One could use
this class or choose to use an object which supports this exact same
interface. Also, an XMethodMatcher can choose not use it 'methods'
attribute. In such cases this class (or an equivalent) is not used.
Attributes:
name: The name of the xmethod.
enabled: A boolean indicating if the xmethod is enabled.
c �" � || _ d| _ d S )NT)�name�enabled��selfr s �$/usr/share/gdb/python/gdb/xmethod.py�__init__zXMethod.__init__( s � ��� ��� � � � N)�__name__�
__module__� __qualname__�__doc__r � r r
r r s- � � � � � �
�
� � � � � r r c � � e Zd ZdZd� Zd� ZdS )�XMethodMatchera� Abstract base class for matching an xmethod.
When looking for xmethods, GDB invokes the `match' method of a
registered xmethod matcher to match the object type and method name.
The `match' method in concrete classes derived from this class should
return an `XMethodWorker' object, or a list of `XMethodWorker'
objects if there is a match (see below for 'XMethodWorker' class).
Attributes:
name: The name of the matcher.
enabled: A boolean indicating if the matcher is enabled.
methods: A sequence of objects of type 'XMethod', or objects
which have at least the attributes of an 'XMethod' object.
This list is used by the 'enable'/'disable'/'info' commands to
enable/disable/list the xmethods registered with GDB. See
the 'match' method below to know how this sequence is used.
This attribute is None if the matcher chooses not have any
xmethods managed by it.
c �0 � || _ d| _ d| _ dS )z�
Args:
name: An identifying name for the xmethod or the group of
xmethods returned by the `match' method.
TN)r r �methodsr s r
r zXMethodMatcher.__init__B s � � �� ��� ��� � � r c � � t d� � �)a� Match class type and method name.
In derived classes, it should return an XMethodWorker object, or a
sequence of 'XMethodWorker' objects. Only those xmethod workers
whose corresponding 'XMethod' descriptor object is enabled should be
returned.
Args:
class_type: The class type (gdb.Type object) to match.
method_name: The name (string) of the method to match.
zXMethodMatcher match��NotImplementedError)r �
class_type� method_names r
�matchzXMethodMatcher.matchL s � � "�"8�9�9�9r N)r
r r r r r r r r
r r - s< � � � � � �� �( � � � :� :� :� :� :r r c �$ � e Zd ZdZd� Zd� Zd� ZdS )�
XMethodWorkera8 Base class for all xmethod workers defined in Python.
An xmethod worker is an object which matches the method arguments, and
invokes the method when GDB wants it to. Internally, GDB first invokes the
'get_arg_types' method to perform overload resolution. If GDB selects to
invoke this Python xmethod, then it invokes it via the overridden
'__call__' method. The 'get_result_type' method is used to implement
'ptype' on the xmethod.
Derived classes should override the 'get_arg_types', 'get_result_type'
and '__call__' methods.
c � � t d� � �)a� Return arguments types of an xmethod.
A sequence of gdb.Type objects corresponding to the arguments of the
xmethod are returned. If the xmethod takes no arguments, then 'None'
or an empty sequence is returned. If the xmethod takes only a single
argument, then a gdb.Type object or a sequence with a single gdb.Type
element is returned.
zXMethodWorker get_arg_typesr �r s r
�
get_arg_typeszXMethodWorker.get_arg_typesi s � � "�"?�@�@�@r c � � t d� � �)a� Return the type of the result of the xmethod.
Args:
args: Arguments to the method. Each element of the tuple is a
gdb.Value object. The first element is the 'this' pointer
value. These are the same arguments passed to '__call__'.
Returns:
A gdb.Type object representing the type of the result of the
xmethod.
z XMethodWorker get_result_typer �r �argss r
�get_result_typez XMethodWorker.get_result_typet s � � "�"A�B�B�Br c � � t d� � �)ay Invoke the xmethod.
Args:
args: Arguments to the method. Each element of the tuple is a
gdb.Value object. The first element is the 'this' pointer
value.
Returns:
A gdb.Value corresponding to the value returned by the xmethod.
Returns 'None' if the method does not return anything.
zXMethodWorker __call__r r" s r
�__call__zXMethodWorker.__call__� s � � "�":�;�;�;r N)r
r r r r r$ r& r r r
r r [ sQ � � � � � � � � A� A� A� C� C� C� <� <� <� <� <r r c �: � e Zd ZdZ G d� de� � Zd� Zd� ZdS )�SimpleXMethodMatchera� A utility class to implement simple xmethod mathers and workers.
See the __init__ method below for information on how instances of this
class can be used.
For simple classes and methods, one can choose to use this class. For
complex xmethods, which need to replace/implement template methods on
possibly template classes, one should implement their own xmethod
matchers and workers. See py-xmethods.py in testsuite/gdb.python
directory of the GDB source tree for examples.
c � � e Zd Zd� Zd� Zd� ZdS )�(SimpleXMethodMatcher.SimpleXMethodWorkerc �" � || _ || _ d S �N)�
_arg_types�_method_function)r �method_function� arg_typess r
r z1SimpleXMethodMatcher.SimpleXMethodWorker.__init__� s � � '�D�O�$3�D� !� !� !r c � � | j S r, )r- r s r
r z6SimpleXMethodMatcher.SimpleXMethodWorker.get_arg_types� s
� ��?� "r c � � | j |� S r, )r. r" s r
r& z1SimpleXMethodMatcher.SimpleXMethodWorker.__call__� s � �(�4�(�$�/� /r N)r
r r r r r& r r r
�SimpleXMethodWorkerr* � sA � � � � � � 4� 4� 4� #� #� #� 0� 0� 0� 0� 0r r3 c � � t � | |� � t |� � s
J d� � �|| _ || _ || _ || _ dS )a�
Args:
name: Name of the xmethod matcher.
class_matcher: A regular expression used to match the name of the
class whose method this xmethod is implementing/replacing.
method_matcher: A regular expression used to match the name of the
method this xmethod is implementing/replacing.
method_function: A Python callable which would be called via the
'invoke' method of the worker returned by the objects of this
class. This callable should accept the object (*this) as the
first argument followed by the rest of the arguments to the
method. All arguments to this function should be gdb.Value
objects.
arg_types: The gdb.Type objects corresponding to the arguments that
this xmethod takes. It can be None, or an empty sequence,
or a single gdb.Type object, or a sequence of gdb.Type objects.
z^The 'method_function' argument to 'SimpleXMethodMatcher' __init__ method should be a callable.N)r r �callabler. �_class_matcher�_method_matcherr- )r r �
class_matcher�method_matcherr/ r0 s r
r z SimpleXMethodMatcher.__init__� sh � �( � � ��d�+�+�+���(�(�
�
�
4�
�
�
� !0�� � +��� -�� �#����r c � � t j | j t |� � � j � � � � }t j | j |� � }|r'|r't � | j | j
� � S d S d S r, ) �rer r6 �str� unqualified�tagr7 r( r3 r. r- )r r r �cm�mms r
r zSimpleXMethodMatcher.match� s� � �
�X�d�)�3�z�/E�/E�/G�/G�/K�+L�+L�
M�
M��
�X�d�*�K�
8�
8��
� �"� �'�;�;��%�t��� �
� � � � r N)r
r r r r r3 r r r r r
r( r( � sf � � � � � �
�
� 0� 0� 0� 0� 0�m� 0� 0� 0� $� $� $�<� � � � r r( c �l � t | d� � st d� � S t | d� � st d� � S t | d� � st d� � S t | j t � � st d� � S | j � d� � d k rt
d
� � S d S ) Nr z(Xmethod matcher is missing method: matchr z*Xmethod matcher is missing attribute: namer z-Xmethod matcher is missing attribute: enabledz3Attribute 'name' of xmethod matcher is not a string�;r z-Xmethod matcher name cannot contain ';' in it)�hasattr� TypeError�
isinstancer r< �find�
ValueError)�matchers r
�_validate_xmethod_matcherrI � s� � � �7�G� $� $� E��C�D�D�D� �7�F� #� #� G��E�F�F�F� �7�I� &� &� J��H�I�I�I� �g�l�C� (� (� S��Q�R�R�R��|���� � ��"�"��I�J�J�J� #�"r c � � t dt | j � � � � D ] }| j | j |k r|c S � dS )Nr ���)�range�len�xmethodsr )�locusr �is r
�_lookup_xmethod_matcherrQ � sM � �
�1�c�%�.�)�)�
*�
*� � �� �>�!� � !�T� )� )��H�H�H� *�
�2r Fc �n � t |� � }|r|�| st } | t k rd}n| j }t | |j � � }|dk r%|r | j |= nt
d|�d|j ��� � �t j d� � rt j d� � | j � d|� � dS )a� Registers a xmethod matcher MATCHER with a LOCUS.
Arguments:
locus: The locus in which the xmethods should be registered.
It can be 'None' to indicate that the xmethods should be
registered globally. Or, it could be a gdb.Objfile or a
gdb.Progspace object in which the xmethods should be
registered.
matcher: The xmethod matcher to register with the LOCUS. It
should be an instance of 'XMethodMatcher' class.
replace: If True, replace any existing xmethod matcher with the
same name in the locus. Otherwise, if a matcher with the same name
exists in the locus, raise an exception.
�globalr z(Xmethod matcher already registered with z: �verbosez.Registering xmethod matcher '%s' with %s' ...
N)
rI �gdb�filenamerQ r rN � RuntimeError� parameter�write�insert)rO rH �replace�err�
locus_name�indexs r
�register_xmethod_matcherr_ � s� � � $�G�
,�
,�C�
� �� � � ��� ��|�|� �
�
��^�
� #�E�7�<� 8� 8�E� ��z�z� � ���u�%�%� �,� &�J�J�� � �6�� �
� �}�Y� � � E� � �C�D�D�D� �N���!�W�%�%�%�%�%r )F) r rU r; �sys�objectr r r r( rI rQ r_ r r r
�<module>rb s ��" &� %�
�
�
�
� � � � �
�
�
�
� � � � � �f� � � �*+:� +:� +:� +:� +:�V� +:� +:� +:�\3<� 3<� 3<� 3<� 3<�F� 3<� 3<� 3<�l<� <� <� <� <�>� <� <� <�H
K�
K�
K�&� � �#&� #&� #&� #&� #&� #&r