| SIGNALNAME(3) | Library Functions Manual | SIGNALNAME(3) | 
signalname, signalnumber,
  signalnext —
#include <signal.h>
const char *
  
  signalname(int
    sig);
int
  
  signalnumber(const
    char *name);
int
  
  signalnext(int
    sig);
signalname() function takes a signal number
  sig, and returns the name of that signal. The name
  returned is locale independent, and can be the string representation of one of
  the signal names from
  <signal.h> such as
  SIGHUP, SIGSTOP,
  SIGKILL, or some similar name, but does not contain
  the leading “SIG” prefix.
The return value of signalname() is
    NULL if sig does not represent
    a valid signal number, or if the signal number given has no name.
The signalnumber() function converts the
    signal name name to the number corresponding to that
    signal. The name is handled in a case-insensitive
    manner. Any leading “SIG” prefix in
    name is ignored.
This implementation also accepts rtmax[-n]
    and rtmin[+n] (where the optional
    n is a decimal integer between 0 and
    SIGRTMAX-SIGRTMIN) to refer to the real time signals.
The signalnumber() function returns the
    signal number, or zero (0) if the name given does not represent a valid
    signal.
The signalnext() function takes a signal
    number, and returns the number of the next available bigger signal number.
    When no higher signal numbers remain, it returns zero (0). The parameter
    sig can be given as zero (0), to obtain the smallest
    implemented signal number.
The signalnext() function returns minus
    one (-1) on error, that is, if the given signal sig is
    neither a valid signal number nor zero. It returns zero when the input
    signal number, sig, is the biggest available signal
    number. Otherwise it returns the signal number of an implemented signal that
    is larger than sig and such that there are no
    implemented signals with values between sig and the
    value returned.
The signalnext() function can also be used
    to determine if a non-zero signal number is valid or not (0 is always
    invalid, but cannot be detected as such this way.) Given the non-zero signal
    number to check as sig, if
    signalnext() returns anything other than minus one
    (-1) then sig represents a valid signal number. If the
    return value is -1 then sig is invalid.
signalname(), signalnext(),
  and signalnumber() functions first appeared in
  NetBSD 8.0.
| April 28, 2017 | NetBSD 10.0 |