STR2SIG(3C) Standard C Library Functions STR2SIG(3C)

NAME

str2sig, sig2str - translation between signal name and signal number

SYNOPSIS

#include <signal.h>

int str2sig(const char *str, int *signum);


int sig2str(int signum, char *str);

DESCRIPTION

The str2sig() function translates the signal name str to a signal number,
and stores that result in the location referenced by signum. The name in
str can be either the symbol for that signal, without the "SIG" prefix,
or a decimal number. All the signal symbols defined in <sys/signal.h>
are recognized. This means that both "CLD" and "CHLD" are recognized and
return the same signal number, as do both "POLL" and "IO". For access to
the signals in the range SIGRTMIN to SIGRTMAX, the first four signals
match the strings "RTMIN", "RTMIN+1", "RTMIN+2", and "RTMIN+3" and the
last four match the strings "RTMAX-3", "RTMAX-2", "RTMAX-1", and "RTMAX".


The sig2str() function translates the signal number signum to the symbol
for that signal, without the "SIG" prefix, and stores that symbol at the
location specified by str. The storage referenced by str should be large
enough to hold the symbol and a terminating null byte. The symbol
SIG2STR_MAX defined by <signal.h> gives the maximum size in bytes
required.

RETURN VALUES

The str2sig() function returns 0 if it recognizes the signal name
specified in str; otherwise, it returns -1.


The sig2str() function returns 0 if the value signum corresponds to a
valid signal number; otherwise, it returns -1.

EXAMPLES

Example 1: A sample program using the str2sig() function.

int i;
char buf[SIG2STR_MAX]; /*storage for symbol */

str2sig("KILL",&i); /*stores 9 in i */
str2sig("9", &i); /* stores 9 in i */
sig2str(SIGKILL,buf); /* stores "KILL" in buf */
sig2str(9,buf); /* stores "KILL" in buf */

SEE ALSO

kill(1), strsignal(3C)


October 7, 1999 STR2SIG(3C)