mirror of
https://github.com/espressif/binutils-gdb.git
synced 2025-12-19 01:19:41 +08:00
d01e823438
This updates the copyright headers to include 2025. I did this by running gdb/copyright.py and then manually modifying a few files as noted by the script. Approved-By: Eli Zaretskii <eliz@gnu.org>
59 lines
2.2 KiB
Python
59 lines
2.2 KiB
Python
# Copyright (C) 2023-2025 Free Software Foundation, Inc.
|
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation; either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
"""
|
|
MissingDebugHandler base class, and register_handler function.
|
|
"""
|
|
|
|
import gdb
|
|
from gdb.missing_files import MissingFileHandler
|
|
|
|
|
|
class MissingDebugHandler(MissingFileHandler):
|
|
"""Base class for missing debug handlers written in Python.
|
|
|
|
A missing debug handler has a single method __call__ along with
|
|
the read/write attribute enabled, and a read-only attribute name.
|
|
|
|
Attributes:
|
|
name: Read-only attribute, the name of this handler.
|
|
enabled: When true this handler is enabled.
|
|
"""
|
|
|
|
def __call__(self, objfile):
|
|
"""Handle missing debug information for an objfile.
|
|
|
|
Arguments:
|
|
objfile: A gdb.Objfile for which GDB could not find any
|
|
debug information.
|
|
|
|
Returns:
|
|
True: GDB should try again to locate the debug information
|
|
for objfile, the handler may have installed the
|
|
missing information.
|
|
False: GDB should move on without the debug information
|
|
for objfile.
|
|
A string: GDB should load the file at the given path; it
|
|
contains the debug information for objfile.
|
|
None: This handler can't help with objfile. GDB should
|
|
try any other registered handlers.
|
|
"""
|
|
raise NotImplementedError("MissingDebugHandler.__call__()")
|
|
|
|
|
|
def register_handler(locus, handler, replace=False):
|
|
"""See gdb.missing_files.register_handler."""
|
|
gdb.missing_files.register_handler("debug", locus, handler, replace)
|