RTEMS 4.7.99.2 On-Line Library

Fatal Error Manager FATAL_ERROR_OCCURRED - Invoke the fatal error handler

RTEMS C User's Guide

17.4.1: FATAL_ERROR_OCCURRED - Invoke the fatal error handler

CALLING SEQUENCE:

void volatile rtems_fatal_error_occurred(
  rtems_unsigned32        the_error
);

DIRECTIVE STATUS CODES

NONE

DESCRIPTION:

This directive processes fatal errors. If the FATAL error extension is defined in the configuration table, then the user-defined error extension is called. If configured and the provided FATAL error extension returns, then the RTEMS default error handler is invoked. This directive can be invoked by RTEMS or by the user's application code including initialization tasks, other tasks, and ISRs.

NOTES:

This directive supports local operations only.

Unless the user-defined error extension takes special actions such as restarting the calling task, this directive WILL NOT RETURN to the caller.

The user-defined extension for this directive may wish to initiate a global shutdown.

RTEMS C User's Guide