Standard C Library Functions                          str2sig(3C)



NAME
     str2sig, sig2str - translation between signal name and  sig-
     nal number

SYNOPSIS
     #include 

     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 refer-
     enced 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  
     are  recognized.   This means that both "CLD" and "CHLD" are
     recognized and return the same signal  number,  as  do  both
     "POL"  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  SIG2STRMAX
     defined  by    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[SIG2STRMAX];     /*storage for symbol */

       str2sig("KIL",&i);        /*stores 9 in i */



SunOS 5.11           Last change: 7 Oct 1999                    1






Standard C Library Functions                          str2sig(3C)



       str2sig("9", &i);          /* stores 9 in i */
       sig2str(SIGKIL,buf);      /* stores "KIL" in buf */
       sig2str(9,buf);            /* stores "KIL" in buf */



SEE ALSO
     kill(1), strsignal(3C)















































SunOS 5.11           Last change: 7 Oct 1999                    2