| /* Extended support for using signal values. |
| Written by Fred Fish. fnf@cygnus.com |
| This file is in the public domain. */ |
| |
| #include "config.h" |
| #include "ansidecl.h" |
| #include "libiberty.h" |
| |
| /* We need to declare sys_siglist, because even if the system provides |
| it we can't assume that it is declared in <signal.h> (for example, |
| SunOS provides sys_siglist, but it does not declare it in any |
| header file). However, we can't declare sys_siglist portably, |
| because on some systems it is declared with const and on some |
| systems it is declared without const. If we were using autoconf, |
| we could work out the right declaration. Until, then we just |
| ignore any declaration in the system header files, and always |
| declare it ourselves. With luck, this will always work. */ |
| #define sys_siglist no_such_symbol |
| #define sys_nsig sys_nsig__no_such_symbol |
| |
| #include <stdio.h> |
| #include <signal.h> |
| |
| /* Routines imported from standard C runtime libraries. */ |
| |
| #ifdef HAVE_STDLIB_H |
| #include <stdlib.h> |
| #else |
| extern PTR malloc (); |
| #endif |
| |
| #ifdef HAVE_STRING_H |
| #include <string.h> |
| #else |
| extern PTR memset (); |
| #endif |
| |
| /* Undefine the macro we used to hide the definition of sys_siglist |
| found in the system header files. */ |
| #undef sys_siglist |
| #undef sys_nsig |
| |
| #ifndef NULL |
| # define NULL (void *) 0 |
| #endif |
| |
| #ifndef MAX |
| # define MAX(a,b) ((a) > (b) ? (a) : (b)) |
| #endif |
| |
| static void init_signal_tables (void); |
| |
| /* Translation table for signal values. |
| |
| Note that this table is generally only accessed when it is used at runtime |
| to initialize signal name and message tables that are indexed by signal |
| value. |
| |
| Not all of these signals will exist on all systems. This table is the only |
| thing that should have to be updated as new signal numbers are introduced. |
| It's sort of ugly, but at least its portable. */ |
| |
| struct signal_info |
| { |
| const int value; /* The numeric value from <signal.h> */ |
| const char *const name; /* The equivalent symbolic value */ |
| #ifndef HAVE_SYS_SIGLIST |
| const char *const msg; /* Short message about this value */ |
| #endif |
| }; |
| |
| #ifndef HAVE_SYS_SIGLIST |
| # define ENTRY(value, name, msg) {value, name, msg} |
| #else |
| # define ENTRY(value, name, msg) {value, name} |
| #endif |
| |
| static const struct signal_info signal_table[] = |
| { |
| #if defined (SIGHUP) |
| ENTRY(SIGHUP, "SIGHUP", "Hangup"), |
| #endif |
| #if defined (SIGINT) |
| ENTRY(SIGINT, "SIGINT", "Interrupt"), |
| #endif |
| #if defined (SIGQUIT) |
| ENTRY(SIGQUIT, "SIGQUIT", "Quit"), |
| #endif |
| #if defined (SIGILL) |
| ENTRY(SIGILL, "SIGILL", "Illegal instruction"), |
| #endif |
| #if defined (SIGTRAP) |
| ENTRY(SIGTRAP, "SIGTRAP", "Trace/breakpoint trap"), |
| #endif |
| /* Put SIGIOT before SIGABRT, so that if SIGIOT==SIGABRT then SIGABRT |
| overrides SIGIOT. SIGABRT is in ANSI and POSIX.1, and SIGIOT isn't. */ |
| #if defined (SIGIOT) |
| ENTRY(SIGIOT, "SIGIOT", "IOT trap"), |
| #endif |
| #if defined (SIGABRT) |
| ENTRY(SIGABRT, "SIGABRT", "Aborted"), |
| #endif |
| #if defined (SIGEMT) |
| ENTRY(SIGEMT, "SIGEMT", "Emulation trap"), |
| #endif |
| #if defined (SIGFPE) |
| ENTRY(SIGFPE, "SIGFPE", "Arithmetic exception"), |
| #endif |
| #if defined (SIGKILL) |
| ENTRY(SIGKILL, "SIGKILL", "Killed"), |
| #endif |
| #if defined (SIGBUS) |
| ENTRY(SIGBUS, "SIGBUS", "Bus error"), |
| #endif |
| #if defined (SIGSEGV) |
| ENTRY(SIGSEGV, "SIGSEGV", "Segmentation fault"), |
| #endif |
| #if defined (SIGSYS) |
| ENTRY(SIGSYS, "SIGSYS", "Bad system call"), |
| #endif |
| #if defined (SIGPIPE) |
| ENTRY(SIGPIPE, "SIGPIPE", "Broken pipe"), |
| #endif |
| #if defined (SIGALRM) |
| ENTRY(SIGALRM, "SIGALRM", "Alarm clock"), |
| #endif |
| #if defined (SIGTERM) |
| ENTRY(SIGTERM, "SIGTERM", "Terminated"), |
| #endif |
| #if defined (SIGUSR1) |
| ENTRY(SIGUSR1, "SIGUSR1", "User defined signal 1"), |
| #endif |
| #if defined (SIGUSR2) |
| ENTRY(SIGUSR2, "SIGUSR2", "User defined signal 2"), |
| #endif |
| /* Put SIGCLD before SIGCHLD, so that if SIGCLD==SIGCHLD then SIGCHLD |
| overrides SIGCLD. SIGCHLD is in POXIX.1 */ |
| #if defined (SIGCLD) |
| ENTRY(SIGCLD, "SIGCLD", "Child status changed"), |
| #endif |
| #if defined (SIGCHLD) |
| ENTRY(SIGCHLD, "SIGCHLD", "Child status changed"), |
| #endif |
| #if defined (SIGPWR) |
| ENTRY(SIGPWR, "SIGPWR", "Power fail/restart"), |
| #endif |
| #if defined (SIGWINCH) |
| ENTRY(SIGWINCH, "SIGWINCH", "Window size changed"), |
| #endif |
| #if defined (SIGURG) |
| ENTRY(SIGURG, "SIGURG", "Urgent I/O condition"), |
| #endif |
| #if defined (SIGIO) |
| /* "I/O pending" has also been suggested, but is misleading since the |
| signal only happens when the process has asked for it, not everytime |
| I/O is pending. */ |
| ENTRY(SIGIO, "SIGIO", "I/O possible"), |
| #endif |
| #if defined (SIGPOLL) |
| ENTRY(SIGPOLL, "SIGPOLL", "Pollable event occurred"), |
| #endif |
| #if defined (SIGSTOP) |
| ENTRY(SIGSTOP, "SIGSTOP", "Stopped (signal)"), |
| #endif |
| #if defined (SIGTSTP) |
| ENTRY(SIGTSTP, "SIGTSTP", "Stopped (user)"), |
| #endif |
| #if defined (SIGCONT) |
| ENTRY(SIGCONT, "SIGCONT", "Continued"), |
| #endif |
| #if defined (SIGTTIN) |
| ENTRY(SIGTTIN, "SIGTTIN", "Stopped (tty input)"), |
| #endif |
| #if defined (SIGTTOU) |
| ENTRY(SIGTTOU, "SIGTTOU", "Stopped (tty output)"), |
| #endif |
| #if defined (SIGVTALRM) |
| ENTRY(SIGVTALRM, "SIGVTALRM", "Virtual timer expired"), |
| #endif |
| #if defined (SIGPROF) |
| ENTRY(SIGPROF, "SIGPROF", "Profiling timer expired"), |
| #endif |
| #if defined (SIGXCPU) |
| ENTRY(SIGXCPU, "SIGXCPU", "CPU time limit exceeded"), |
| #endif |
| #if defined (SIGXFSZ) |
| ENTRY(SIGXFSZ, "SIGXFSZ", "File size limit exceeded"), |
| #endif |
| #if defined (SIGWIND) |
| ENTRY(SIGWIND, "SIGWIND", "SIGWIND"), |
| #endif |
| #if defined (SIGPHONE) |
| ENTRY(SIGPHONE, "SIGPHONE", "SIGPHONE"), |
| #endif |
| #if defined (SIGLOST) |
| ENTRY(SIGLOST, "SIGLOST", "Resource lost"), |
| #endif |
| #if defined (SIGWAITING) |
| ENTRY(SIGWAITING, "SIGWAITING", "Process's LWPs are blocked"), |
| #endif |
| #if defined (SIGLWP) |
| ENTRY(SIGLWP, "SIGLWP", "Signal LWP"), |
| #endif |
| #if defined (SIGDANGER) |
| ENTRY(SIGDANGER, "SIGDANGER", "Swap space dangerously low"), |
| #endif |
| #if defined (SIGGRANT) |
| ENTRY(SIGGRANT, "SIGGRANT", "Monitor mode granted"), |
| #endif |
| #if defined (SIGRETRACT) |
| ENTRY(SIGRETRACT, "SIGRETRACT", "Need to relinguish monitor mode"), |
| #endif |
| #if defined (SIGMSG) |
| ENTRY(SIGMSG, "SIGMSG", "Monitor mode data available"), |
| #endif |
| #if defined (SIGSOUND) |
| ENTRY(SIGSOUND, "SIGSOUND", "Sound completed"), |
| #endif |
| #if defined (SIGSAK) |
| ENTRY(SIGSAK, "SIGSAK", "Secure attention"), |
| #endif |
| ENTRY(0, NULL, NULL) |
| }; |
| |
| /* Translation table allocated and initialized at runtime. Indexed by the |
| signal value to find the equivalent symbolic value. */ |
| |
| static const char **signal_names; |
| static int num_signal_names = 0; |
| |
| /* Translation table allocated and initialized at runtime, if it does not |
| already exist in the host environment. Indexed by the signal value to find |
| the descriptive string. |
| |
| We don't export it for use in other modules because even though it has the |
| same name, it differs from other implementations in that it is dynamically |
| initialized rather than statically initialized. */ |
| |
| #ifndef HAVE_SYS_SIGLIST |
| |
| static int sys_nsig; |
| static const char **sys_siglist; |
| |
| #else |
| |
| #ifdef NSIG |
| static int sys_nsig = NSIG; |
| #else |
| #ifdef _NSIG |
| static int sys_nsig = _NSIG; |
| #endif |
| #endif |
| extern const char * const sys_siglist[]; |
| |
| #endif |
| |
| |
| /* |
| |
| NAME |
| |
| init_signal_tables -- initialize the name and message tables |
| |
| SYNOPSIS |
| |
| static void init_signal_tables (); |
| |
| DESCRIPTION |
| |
| Using the signal_table, which is initialized at compile time, generate |
| the signal_names and the sys_siglist (if needed) tables, which are |
| indexed at runtime by a specific signal value. |
| |
| BUGS |
| |
| The initialization of the tables may fail under low memory conditions, |
| in which case we don't do anything particularly useful, but we don't |
| bomb either. Who knows, it might succeed at a later point if we free |
| some memory in the meantime. In any case, the other routines know |
| how to deal with lack of a table after trying to initialize it. This |
| may or may not be considered to be a bug, that we don't specifically |
| warn about this particular failure mode. |
| |
| */ |
| |
| static void |
| init_signal_tables (void) |
| { |
| const struct signal_info *eip; |
| int nbytes; |
| |
| /* If we haven't already scanned the signal_table once to find the maximum |
| signal value, then go find it now. */ |
| |
| if (num_signal_names == 0) |
| { |
| for (eip = signal_table; eip -> name != NULL; eip++) |
| { |
| if (eip -> value >= num_signal_names) |
| { |
| num_signal_names = eip -> value + 1; |
| } |
| } |
| } |
| |
| /* Now attempt to allocate the signal_names table, zero it out, and then |
| initialize it from the statically initialized signal_table. */ |
| |
| if (signal_names == NULL) |
| { |
| nbytes = num_signal_names * sizeof (char *); |
| if ((signal_names = (const char **) malloc (nbytes)) != NULL) |
| { |
| memset (signal_names, 0, nbytes); |
| for (eip = signal_table; eip -> name != NULL; eip++) |
| { |
| signal_names[eip -> value] = eip -> name; |
| } |
| } |
| } |
| |
| #ifndef HAVE_SYS_SIGLIST |
| |
| /* Now attempt to allocate the sys_siglist table, zero it out, and then |
| initialize it from the statically initialized signal_table. */ |
| |
| if (sys_siglist == NULL) |
| { |
| nbytes = num_signal_names * sizeof (char *); |
| if ((sys_siglist = (const char **) malloc (nbytes)) != NULL) |
| { |
| memset (sys_siglist, 0, nbytes); |
| sys_nsig = num_signal_names; |
| for (eip = signal_table; eip -> name != NULL; eip++) |
| { |
| sys_siglist[eip -> value] = eip -> msg; |
| } |
| } |
| } |
| |
| #endif |
| |
| } |
| |
| |
| /* |
| |
| @deftypefn Extension int signo_max (void) |
| |
| Returns the maximum signal value for which a corresponding symbolic |
| name or message is available. Note that in the case where we use the |
| @code{sys_siglist} supplied by the system, it is possible for there to |
| be more symbolic names than messages, or vice versa. In fact, the |
| manual page for @code{psignal(3b)} explicitly warns that one should |
| check the size of the table (@code{NSIG}) before indexing it, since |
| new signal codes may be added to the system before they are added to |
| the table. Thus @code{NSIG} might be smaller than value implied by |
| the largest signo value defined in @code{<signal.h>}. |
| |
| We return the maximum value that can be used to obtain a meaningful |
| symbolic name or message. |
| |
| @end deftypefn |
| |
| */ |
| |
| int |
| signo_max (void) |
| { |
| int maxsize; |
| |
| if (signal_names == NULL) |
| { |
| init_signal_tables (); |
| } |
| maxsize = MAX (sys_nsig, num_signal_names); |
| return (maxsize - 1); |
| } |
| |
| |
| /* |
| |
| @deftypefn Supplemental {const char *} strsignal (int @var{signo}) |
| |
| Maps an signal number to an signal message string, the contents of |
| which are implementation defined. On systems which have the external |
| variable @code{sys_siglist}, these strings will be the same as the |
| ones used by @code{psignal()}. |
| |
| If the supplied signal number is within the valid range of indices for |
| the @code{sys_siglist}, but no message is available for the particular |
| signal number, then returns the string @samp{Signal @var{num}}, where |
| @var{num} is the signal number. |
| |
| If the supplied signal number is not a valid index into |
| @code{sys_siglist}, returns @code{NULL}. |
| |
| The returned string is only guaranteed to be valid only until the next |
| call to @code{strsignal}. |
| |
| @end deftypefn |
| |
| */ |
| |
| #ifndef HAVE_STRSIGNAL |
| |
| char * |
| strsignal (int signo) |
| { |
| char *msg; |
| static char buf[32]; |
| |
| #ifndef HAVE_SYS_SIGLIST |
| |
| if (signal_names == NULL) |
| { |
| init_signal_tables (); |
| } |
| |
| #endif |
| |
| if ((signo < 0) || (signo >= sys_nsig)) |
| { |
| /* Out of range, just return NULL */ |
| msg = NULL; |
| } |
| else if ((sys_siglist == NULL) || (sys_siglist[signo] == NULL)) |
| { |
| /* In range, but no sys_siglist or no entry at this index. */ |
| sprintf (buf, "Signal %d", signo); |
| msg = buf; |
| } |
| else |
| { |
| /* In range, and a valid message. Just return the message. We |
| can safely cast away const, since POSIX says the user must |
| not modify the result. */ |
| msg = (char *) sys_siglist[signo]; |
| } |
| |
| return (msg); |
| } |
| |
| #endif /* ! HAVE_STRSIGNAL */ |
| |
| /* |
| |
| @deftypefn Extension {const char*} strsigno (int @var{signo}) |
| |
| Given an signal number, returns a pointer to a string containing the |
| symbolic name of that signal number, as found in @code{<signal.h>}. |
| |
| If the supplied signal number is within the valid range of indices for |
| symbolic names, but no name is available for the particular signal |
| number, then returns the string @samp{Signal @var{num}}, where |
| @var{num} is the signal number. |
| |
| If the supplied signal number is not within the range of valid |
| indices, then returns @code{NULL}. |
| |
| The contents of the location pointed to are only guaranteed to be |
| valid until the next call to @code{strsigno}. |
| |
| @end deftypefn |
| |
| */ |
| |
| const char * |
| strsigno (int signo) |
| { |
| const char *name; |
| static char buf[32]; |
| |
| if (signal_names == NULL) |
| { |
| init_signal_tables (); |
| } |
| |
| if ((signo < 0) || (signo >= num_signal_names)) |
| { |
| /* Out of range, just return NULL */ |
| name = NULL; |
| } |
| else if ((signal_names == NULL) || (signal_names[signo] == NULL)) |
| { |
| /* In range, but no signal_names or no entry at this index. */ |
| sprintf (buf, "Signal %d", signo); |
| name = (const char *) buf; |
| } |
| else |
| { |
| /* In range, and a valid name. Just return the name. */ |
| name = signal_names[signo]; |
| } |
| |
| return (name); |
| } |
| |
| |
| /* |
| |
| @deftypefn Extension int strtosigno (const char *@var{name}) |
| |
| Given the symbolic name of a signal, map it to a signal number. If no |
| translation is found, returns 0. |
| |
| @end deftypefn |
| |
| */ |
| |
| int |
| strtosigno (const char *name) |
| { |
| int signo = 0; |
| |
| if (name != NULL) |
| { |
| if (signal_names == NULL) |
| { |
| init_signal_tables (); |
| } |
| for (signo = 0; signo < num_signal_names; signo++) |
| { |
| if ((signal_names[signo] != NULL) && |
| (strcmp (name, signal_names[signo]) == 0)) |
| { |
| break; |
| } |
| } |
| if (signo == num_signal_names) |
| { |
| signo = 0; |
| } |
| } |
| return (signo); |
| } |
| |
| |
| /* |
| |
| @deftypefn Supplemental void psignal (int @var{signo}, char *@var{message}) |
| |
| Print @var{message} to the standard error, followed by a colon, |
| followed by the description of the signal specified by @var{signo}, |
| followed by a newline. |
| |
| @end deftypefn |
| |
| */ |
| |
| #ifndef HAVE_PSIGNAL |
| |
| void |
| psignal (int signo, char *message) |
| { |
| if (signal_names == NULL) |
| { |
| init_signal_tables (); |
| } |
| if ((signo <= 0) || (signo >= sys_nsig)) |
| { |
| fprintf (stderr, "%s: unknown signal\n", message); |
| } |
| else |
| { |
| fprintf (stderr, "%s: %s\n", message, sys_siglist[signo]); |
| } |
| } |
| |
| #endif /* ! HAVE_PSIGNAL */ |
| |
| |
| /* A simple little main that does nothing but print all the signal translations |
| if MAIN is defined and this file is compiled and linked. */ |
| |
| #ifdef MAIN |
| |
| #include <stdio.h> |
| |
| int |
| main (void) |
| { |
| int signo; |
| int maxsigno; |
| const char *name; |
| const char *msg; |
| |
| maxsigno = signo_max (); |
| printf ("%d entries in names table.\n", num_signal_names); |
| printf ("%d entries in messages table.\n", sys_nsig); |
| printf ("%d is max useful index.\n", maxsigno); |
| |
| /* Keep printing values until we get to the end of *both* tables, not |
| *either* table. Note that knowing the maximum useful index does *not* |
| relieve us of the responsibility of testing the return pointer for |
| NULL. */ |
| |
| for (signo = 0; signo <= maxsigno; signo++) |
| { |
| name = strsigno (signo); |
| name = (name == NULL) ? "<NULL>" : name; |
| msg = strsignal (signo); |
| msg = (msg == NULL) ? "<NULL>" : msg; |
| printf ("%-4d%-18s%s\n", signo, name, msg); |
| } |
| |
| return 0; |
| } |
| |
| #endif |