NAME    [Toc]    [Back]

       raise - Send a signal to the executing process or thread

SYNOPSIS    [Toc]    [Back]

       #include <signal.h>

       int raise(
               int signal );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       raise():  XSH5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies a signal number.

DESCRIPTION    [Toc]    [Back]

       The  raise()  function  sends  the signal specified by the
       signal  parameter  to  the  invoking  thread.  In  singlethreaded
 programs this is equivalent to:

       kill(getpid(), signal);

       The behavior of the raise() function is equivalent to:

       pthread_kill(pthread_self(), signal);

RETURN VALUES    [Toc]    [Back]

       Upon  successful  completion  of  the  raise() function, a
       value of 0 (zero) is returned. Otherwise, a nonzero  value
       is returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       The  raise()  function  sets errno to the specified values
       for the following conditions:  The  value  of  the  signal
       parameter is an invalid signal number.

SEE ALSO    [Toc]    [Back]

       Functions: kill(2), sigaction(2)

       Standards: standards(5)



                                                         raise(3)