pSOSystem System Calls - Read

pSOS+ System Calls k_fatal
Notes
1. The shutdown procedure is a procedure whereby pSOS+ attempts to halt
execution in the most orderly manner possible. The pSOS+ kernel first
examines the pSOS+ Configuration Table entry kc_fatal. If this entry is
nonzero, the pSOS+ kernel jumps to this address. If kc_fatal is zero, and the
pROBE+ System Debug/Analyzer is present, then the pSOS+ kernel passes
control to the System Failure entry of the pROBE+ debugger. For a description
of the pROBE+ debugger behavior in this case, refer to the pROBE+ User’s
Manual. Finally, if the pROBE+ debugger is absent, the pSOS+ kernel internally
executes an illegal instruction to cause a deliberate illegal instruction exception.
This passes control to a ROM monitor or other low-level debug tool.
2. k_fatal() is not the only mechanism by which control is passed to the fatal
error handler. It can also receive control following an internal pSOS+ fatal error
or, in multiprocessor systems, a shutdown packet from the master node.
Multiprocessor Considerations
In a multiprocessor system, k_fatal() can be used to implement a system-wide
abort or shutdown. In this case, K_GLOBAL should be set. This causes a global
shutdown packet to go to the master node, which sends a shutdown packet to every
node in the system.
Callable From
■ Task
■ KI
pSOSystem System Calls 1-41
1