raise

Sends a signal to the executing program.

Note

Do not use this method to shut down a Windows Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Windows Store app are not permitted according to Section 3.6 of the Windows 8 app certification requirements. For more information, see Application lifecycle (Windows Store apps).

int raise( 
int sig  
);

Parameters

  • sig
    Signal to be raised.

Return Value

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

Remarks

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

SIGABRT

Abnormal termination

Terminates the calling program with exit code 3

SIGFPE

Floating-point error

Terminates the calling program

SIGILL

Illegal instruction

Terminates the calling program

SIGINT

CTRL+C interrupt

Terminates the calling program

SIGSEGV

Illegal storage access

Terminates the calling program

SIGTERM

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.

Requirements

Routine

Required header

raise

<signal.h>

For additional compatibility information, see Compatibility.

Libraries

All versions of the C run-time libraries.

.NET Framework Equivalent

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

See Also

Reference

Process and Environment Control

abort

signal