binutils-gdb/gdbsupport/osabi.h
Andrew Burgess 67470b3532 gdb: split osabi support between gdb/ and gdbsupport/ directories
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>
2024-10-10 17:36:21 +01:00

55 lines
1.7 KiB
C

/* OS ABI variant handling for GDB and gdbserver.
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_COMMON_H
#define OSABI_COMMON_H
/* List of known OS ABIs. If you change this, make sure to update the
table in osabi.cc. */
enum gdb_osabi
{
#define GDB_OSABI_DEF_FIRST(Enum, Name, Regex) \
GDB_OSABI_ ## Enum = 0,
#define GDB_OSABI_DEF(Enum, Name, Regex) \
GDB_OSABI_ ## Enum,
#define GDB_OSABI_DEF_LAST(Enum, Name, Regex) \
GDB_OSABI_ ## Enum
#include "gdbsupport/osabi.def"
#undef GDB_OSABI_DEF_LAST
#undef GDB_OSABI_DEF
#undef GDB_OSABI_DEF_FIRST
};
/* Lookup the OS ABI corresponding to the specified target description
string. */
enum gdb_osabi osabi_from_tdesc_string (const char *text);
/* Return the name of the specified OS ABI. */
const char *gdbarch_osabi_name (enum gdb_osabi);
/* Return a regular expression that matches the OS part of a GNU
configury triplet for the given OSABI. */
const char *osabi_triplet_regexp (enum gdb_osabi osabi);
#endif /* OSABI_COMMON_H */