This documentation is archived and is not being maintained.


Sends a signal to the executing program.

int raise(
   int sig 



Signal to be raised.

If successful, raise returns 0. Otherwise, it returns a nonzero value.

The raise function sends sig to the executing program. If a previous call to signal has installed a signal-handling function for sig, raise executes that function. If no handler function has been installed, the default action associated with the signal value sig is taken, as follows.

Signal Meaning Default


Abnormal termination

Terminates the calling program with exit code 3


Floating-point error

Terminates the calling program


Illegal instruction

Terminates the calling program


CTRL+C interrupt

Terminates the calling program


Illegal storage access

Terminates the calling program


Termination request sent to the program

Ignores the signal

If the argument is not a valid signal as specified above, the invalid parameter handler is invoked, as described in Parameter Validation. If not handled, the function sets errno to EINVAL and returns a nonzero value.

Routine Required header Compatibility



ANSI, Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

For additional compatibility information, see Compatibility in the Introduction.


All versions of the C run-time libraries.

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.