Home | History | Annotate | Line # | Download | only in gdbsupport 
      1 /* Target signal translation functions for GDB.
      2    Copyright (C) 1990-2024 Free Software Foundation, Inc.
      3    Contributed by Cygnus Support.
      4 
      5    This file is part of GDB.
      6 
      7    This program is free software; you can redistribute it and/or modify
      8    it under the terms of the GNU General Public License as published by
      9    the Free Software Foundation; either version 3 of the License, or
     10    (at your option) any later version.
     11 
     12    This program is distributed in the hope that it will be useful,
     13    but WITHOUT ANY WARRANTY; without even the implied warranty of
     14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     15    GNU General Public License for more details.
     16 
     17    You should have received a copy of the GNU General Public License
     18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
     19 
     20 #ifndef GDBSUPPORT_GDB_SIGNALS_H
     21 #define GDBSUPPORT_GDB_SIGNALS_H
     22 
     23 #include "gdb/signals.h"
     24 
     25 /* Predicate to gdb_signal_to_host(). Return non-zero if the enum
     26    targ_signal SIGNO has an equivalent ``host'' representation.  */
     27 /* FIXME: cagney/1999-11-22: The name below was chosen in preference
     28    to the shorter gdb_signal_p() because it is far less ambiguous.
     29    In this context ``gdb_signal'' refers to GDB's internal
     30    representation of the target's set of signals while ``host signal''
     31    refers to the target operating system's signal.  Confused?  */
     32 extern int gdb_signal_to_host_p (enum gdb_signal signo);
     33 
     34 /* Convert between host signal numbers and enum gdb_signal's.
     35    gdb_signal_to_host() returns 0 and prints a warning() on GDB's
     36    console if SIGNO has no equivalent host representation.  */
     37 /* FIXME: cagney/1999-11-22: Here ``host'' is used incorrectly, it is
     38    referring to the target operating system's signal numbering.
     39    Similarly, ``enum gdb_signal'' is named incorrectly, ``enum
     40    gdb_signal'' would probably be better as it is referring to GDB's
     41    internal representation of a target operating system's signal.  */
     42 extern enum gdb_signal gdb_signal_from_host (int);
     43 extern int gdb_signal_to_host (enum gdb_signal);
     44 
     45 /* Return the enum symbol name of SIG as a string, to use in debug
     46    output.  */
     47 extern const char *gdb_signal_to_symbol_string (enum gdb_signal sig);
     48 
     49 /* Return the string for a signal.  */
     50 extern const char *gdb_signal_to_string (enum gdb_signal);
     51 
     52 /* Return the name (SIGHUP, etc.) for a signal.  */
     53 extern const char *gdb_signal_to_name (enum gdb_signal);
     54 
     55 /* Given a name (SIGHUP, etc.), return its signal.  */
     56 enum gdb_signal gdb_signal_from_name (const char *);
     57 
     58 #endif /* GDBSUPPORT_GDB_SIGNALS_H */
     59