pSOSystem System Calls - Read

k_fatal pSOS+ System Calls
k_fatal Aborts and enters fatal error handling mode.
#include
void k_fatal(
unsigned long err_code, /* user's error code */
unsigned long flags /* fatal condition attributes */
)
Description
Arguments
Return Value
This system call allows the user application to pass control to the user-defined fatal
error handler in the event of a nonrecoverable failure. k_fatal() forces a
nonrecoverable shutdown of the pSOS+ environment and never returns to the
caller.
err_code Specifies a user-defined failure code that is passed to the fatal
error handler. The failure code must be at least 0x20000000.
flags The flags argument is ignored in the single-processor version
of the pSOS+ kernel. In a multiprocessor system, the flags
argument is used to determine whether the local node should be
shut down or a system-wide shutdown should occur. flags is
formed by selecting one of the following symbolic constants,
which are defined in (see “Multiprocessor
Considerations”).
K_GLOBAL /
K_LOCAL
If the value of flags is K_GLOBAL, a global shutdown packet is sent to the master,
which then sends a shutdown packet to every other node in the system.
This call never returns to the caller.
k_fatal() invocation causes global system
shutdown / local node shutdown.
1-40 pSOSystem System Calls