NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | RESTRICTIONS | ATTRIBUTES
#include <exec/chPanic.h>int svSysPanic(int panicNo /* panic number */, void *args /* panic argument */, int argsSize /* panic argument size */, char *mess /* panic message */, char *fileName /* file name */, int lineNumber /* line number */);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
CORE
The svSysPanic() system call allows applications to trigger the execution of the microkernel panic handling sequence. When svSysPanic() is invoked by an application, the microkernel executes the panic handling strategy, just as if the panic had been detected by the microkernel itself. If a panic handler has been connected by the board support package, the microkernel invokes this handler, passing the svSysPanic() arguments unchanged. If no panic handler has been connected, the microkernel performs default panic handling (usually by entering the microkernel debugger).
The panicNo field identifies the panic. It should generally take a value not already assigned to components, except in the case of generic panics such as debug assertions, for which a single generic number has been assigned.
The panicArgs member is a pointer to a panic-specific data structure. The panicArgsSize member indicates the size of the panic-specific structure.
This microkernel service is only available to supervisor threads.
The svSysPanic() system call never returns.
This call is restricted to SUPERVISOR threads.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | RESTRICTIONS | ATTRIBUTES