raise

Article
2017-06-05

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at raise.

Sends a signal to the executing program.

Note

Do not use this method to shut down a Windows 8.x Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Windows 8.x 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).

Syntax

  
      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.

Share via