mirror of
https://github.com/bminor/binutils-gdb.git
synced 2025-12-26 17:18:55 +00:00
67470b3532
In future commits I want to call set_tdesc_osabi from gdbserver/ code. Currently the only version of set_tdesc_osabi available to gdbserver takes a string representing the osabi. The problem with this is that, having lots of calls to set_tdesc_osabi which all take a string is an invite for a typo to slip in. This typo could potentially go unnoticed until someone tries to debug the wrong combination of GDB and gdbserver, at which point GDB will fail to find the correct gdbarch because it doesn't understand the osabi string. It would be better if the set_tdesc_osabi calls in gdbserver could take an 'enum gdb_osabi' value and then convert this to the "correct" string internally. In this way we are guaranteed to always have a valid, known, osabi string. This commit splits the osabi related code, which currently lives entirely on the GDB side, between gdb/ and gdbsupport/. I've moved the enum definition along with the array of osabi names into gdbsupport/. Then all the functions that access the names list, and which convert between names and enum values are also moved. I've taken the opportunity of this move to add a '.def' file which contains all the enum names along with the name strings. This '.def' file is then used to create 'enum gdb_osabi' as well as the array of osabi name strings. By using a '.def' file we know that the enum order will always match the name string array. This commit is just a refactor, there are no user visible changes after this commit. This commit doesn't change how gdbserver sets the target description osabi string, that will come in the next commit. Approved-By: Luis Machado <luis.machado@arm.com> Approved-By: Simon Marchi <simon.marchi@efficios.com>
56 lines
2.2 KiB
C
56 lines
2.2 KiB
C
/* OS ABI variant handling for GDB.
|
|
Copyright (C) 2001-2024 Free Software Foundation, Inc.
|
|
|
|
This file is part of GDB.
|
|
|
|
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/>. */
|
|
|
|
#ifndef OSABI_H
|
|
#define OSABI_H
|
|
|
|
#include "gdbsupport/osabi.h"
|
|
|
|
/* Register an OS ABI sniffer. Each arch/flavour may have more than
|
|
one sniffer. This is used to e.g. differentiate one OS's a.out from
|
|
another. The first sniffer to return something other than
|
|
GDB_OSABI_UNKNOWN wins, so a sniffer should be careful to claim a file
|
|
only if it knows for sure what it is. */
|
|
void gdbarch_register_osabi_sniffer (enum bfd_architecture,
|
|
enum bfd_flavour,
|
|
enum gdb_osabi (*)(bfd *));
|
|
|
|
/* Register a handler for an OS ABI variant for a given architecture
|
|
and machine type. There should be only one handler for a given OS
|
|
ABI for each architecture and machine type combination. */
|
|
void gdbarch_register_osabi (enum bfd_architecture, unsigned long,
|
|
enum gdb_osabi,
|
|
void (*)(struct gdbarch_info,
|
|
struct gdbarch *));
|
|
|
|
/* Lookup the OS ABI corresponding to the specified BFD. */
|
|
enum gdb_osabi gdbarch_lookup_osabi (bfd *);
|
|
|
|
/* Return true if there's an OS ABI handler for INFO. */
|
|
bool has_gdb_osabi_handler (struct gdbarch_info info);
|
|
|
|
/* Initialize the gdbarch for the specified OS ABI variant. */
|
|
void gdbarch_init_osabi (struct gdbarch_info, struct gdbarch *);
|
|
|
|
/* Helper routine for ELF file sniffers. This looks at ABI tag note
|
|
sections to determine the OS ABI from the note. */
|
|
void generic_elf_osabi_sniff_abi_tag_sections (bfd *, asection *,
|
|
enum gdb_osabi *);
|
|
|
|
#endif /* OSABI_H */
|