| # Copyright (C) 2023-2026 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) |