raise(2)                            CLIX                            raise(2)



  NAME

    raise - Sends a signal to the current process

  LIBRARY

    Standard C Library (libc.a)

  SYNOPSIS

    #include <sys/signal.h>

    int raise(
      int signal );

  PARAMETERS

    signal   Specifies the signalm and is either a value from the list given
             in the signal() function, or 0.  If the signal parameter is 0
             (the null signal), error checking is performed but no signal is
             sent.  This can be used to check the validity of the process
             parameter.

  DESCRIPTION

    The raise() function sends the signal specified by the signal parameter to
    the current process.

  EXAMPLES

    In this example, if the value of the SIGKILL signal sent by raise() is -1,
    the message failed to kill process appears.

    #include <sys/signal.h>

    if (raise(SIGKILL) == -1)
         perror("failed to kill process");


  RETURN VALUES

    Upon successful completion, raise() returns a value of 0.  Otherwise, a
    value of -1 is returned and the global variable errno is set to indicate
    the error.

  ERRORS

    The raise() function fails and no signal is sent if the following is true:

    [EINVAL] The signal parameter is not a valid signal number.




  2/94 - Intergraph Corporation                                              1

  raise(2)                            CLIX                            raise(2)



  RELATED INFORMATION

    Functions:  sigaction(2), signal(2), sigset(2)



















































  2                                              Intergraph Corporation - 2/94