summaryrefslogtreecommitdiffstats
path: root/c-user/fatal-error/introduction.rst
blob: fc310f46721fbb04cbcd74393a0ecbb662edb3d0 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
.. SPDX-License-Identifier: CC-BY-SA-4.0

.. Copyright (C) 2015, 2021 embedded brains GmbH & Co. KG
.. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)

.. This file is part of the RTEMS quality process and was automatically
.. generated.  If you find something that needs to be fixed or
.. worded better please post a report or patch to an RTEMS mailing list
.. or raise a bug report:
..
.. https://www.rtems.org/bugs.html
..
.. For information on updating and regenerating please refer to the How-To
.. section in the Software Requirements Engineering chapter of the
.. RTEMS Software Engineering manual.  The manual is provided as a part of
.. a release.  For development sources please refer to the online
.. documentation at:
..
.. https://docs.rtems.org

.. Generated from spec:/rtems/fatal/if/group

.. _FatalErrorManagerIntroduction:

Introduction
============

.. The following list was generated from:
.. spec:/rtems/fatal/if/fatal
.. spec:/rtems/fatal/if/panic
.. spec:/rtems/fatal/if/shutdown-executive
.. spec:/rtems/fatal/if/exception-frame-print
.. spec:/rtems/fatal/if/source-text
.. spec:/rtems/fatal/if/internal-error-text
.. spec:/rtems/fatal/if/error-occurred

The Fatal Error Manager processes all fatal or irrecoverable errors and other
sources of system termination (for example after :c:func:`exit`).  Fatal errors
are identified by the fatal source and code pair. The directives provided by
the Fatal Error Manager are:

* :ref:`InterfaceRtemsFatal` - Invokes the fatal error handler.

* :ref:`InterfaceRtemsPanic` - Prints the message and invokes the fatal error
  handler.

* :ref:`InterfaceRtemsShutdownExecutive` - Invokes the fatal error handler.

* :ref:`InterfaceRtemsExceptionFramePrint` - Prints the exception frame.

* :ref:`InterfaceRtemsFatalSourceText` - Returns a descriptive text for the
  fatal source.

* :ref:`InterfaceRtemsInternalErrorText` - Returns a descriptive text for the
  internal error code.

* :ref:`InterfaceRtemsFatalErrorOccurred` - Invokes the fatal error handler.