contrib/gdb-7/gdb/common/gdb_signals.h

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