source: rtems/cpukit/score/include/rtems/score/interr.h @ 7d0bdca

4.11
Last change on this file since 7d0bdca was 7d0bdca, checked in by Sebastian Huber <sebastian.huber@…>, on Nov 14, 2012 at 8:27:43 AM

score: Add nest level to interal error state

Add Internal_errors_Information::nest_level. This helps to detect
recursive calls to _Internal_error_Occurred().

  • Property mode set to 100644
File size: 3.4 KB
Line 
1/**
2 *  @file  rtems/score/interr.h
3 *
4 *  This include file contains constants and prototypes related
5 *  to the Internal Error Handler.
6 */
7
8/*
9 *  COPYRIGHT (c) 1989-2009.
10 *  On-Line Applications Research Corporation (OAR).
11 *
12 *  The license and distribution terms for this file may be
13 *  found in the file LICENSE in this distribution or at
14 *  http://www.rtems.com/license/LICENSE.
15 */
16
17#ifndef _RTEMS_SCORE_INTERR_H
18#define _RTEMS_SCORE_INTERR_H
19
20#include <stdbool.h>
21#include <stdint.h>
22
23#include <rtems/system.h>
24
25/**
26 *  @defgroup ScoreIntErr Internal Error Handler
27 *
28 *  @ingroup Score
29 *
30 *  This handler encapsulates functionality which provides the foundation
31 *  Semaphore services used in all of the APIs supported by RTEMS.
32 */
33/**@{*/
34
35#ifdef __cplusplus
36extern "C" {
37#endif
38
39/**
40 *  This type lists the possible sources from which an error
41 *  can be reported.
42 */
43typedef enum {
44  INTERNAL_ERROR_CORE,
45  INTERNAL_ERROR_RTEMS_API,
46  INTERNAL_ERROR_POSIX_API
47} Internal_errors_Source;
48
49/**
50 *  A list of errors which are generated internally by the executive core.
51 */
52typedef enum {
53  INTERNAL_ERROR_NO_CONFIGURATION_TABLE,
54  INTERNAL_ERROR_NO_CPU_TABLE,
55  INTERNAL_ERROR_TOO_LITTLE_WORKSPACE,
56  INTERNAL_ERROR_WORKSPACE_ALLOCATION,
57  INTERNAL_ERROR_INTERRUPT_STACK_TOO_SMALL,
58  INTERNAL_ERROR_THREAD_EXITTED,
59  INTERNAL_ERROR_INCONSISTENT_MP_INFORMATION,
60  INTERNAL_ERROR_INVALID_NODE,
61  INTERNAL_ERROR_NO_MPCI,
62  INTERNAL_ERROR_BAD_PACKET,
63  INTERNAL_ERROR_OUT_OF_PACKETS,
64  INTERNAL_ERROR_OUT_OF_GLOBAL_OBJECTS,
65  INTERNAL_ERROR_OUT_OF_PROXIES,
66  INTERNAL_ERROR_INVALID_GLOBAL_ID,
67  INTERNAL_ERROR_BAD_STACK_HOOK,
68  INTERNAL_ERROR_BAD_ATTRIBUTES,
69  INTERNAL_ERROR_IMPLEMENTATION_KEY_CREATE_INCONSISTENCY,
70  INTERNAL_ERROR_IMPLEMENTATION_BLOCKING_OPERATION_CANCEL,
71  INTERNAL_ERROR_MUTEX_OBTAIN_FROM_BAD_STATE,
72  INTERNAL_ERROR_UNLIMITED_AND_MAXIMUM_IS_0,
73  INTERNAL_ERROR_SHUTDOWN_WHEN_NOT_UP,
74  INTERNAL_ERROR_GXX_KEY_ADD_FAILED,
75  INTERNAL_ERROR_GXX_MUTEX_INIT_FAILED,
76  INTERNAL_ERROR_NO_MEMORY_FOR_HEAP
77} Internal_errors_Core_list;
78
79typedef uint32_t Internal_errors_t;
80
81/**
82 *  This type holds the fatal error information.
83 */
84typedef struct {
85  /** This is the source of the error. */
86  Internal_errors_Source  the_source;
87  /** This indicates if the error is internal of external. */
88  bool                    is_internal;
89  /** This is the error code. */
90  Internal_errors_t       the_error;
91
92  /**
93   * @brief The internal error nest level.
94   *
95   * This helps to detect recursive calls to _Internal_error_Occurred().
96   */
97  uint32_t                nest_level;
98} Internal_errors_Information;
99
100/**
101 *  When a fatal error occurs, the error information is stored here.
102 */
103extern Internal_errors_Information _Internal_errors_What_happened;
104
105/**
106 * @brief An internal or fatal error occurred.
107 *
108 * This routine is invoked when the application or the executive itself
109 * determines that a fatal error has occurred.
110 *
111 * This function can be called in every system state provided the following
112 * conditions are true
113 * - the stack pointer is valid,
114 * - the code memory is valid,
115 * - the read-only data is valid, and
116 * - the read-write data is accessible.
117 */
118void _Internal_error_Occurred(
119  Internal_errors_Source  the_source,
120  bool                    is_internal,
121  Internal_errors_t       the_error
122) RTEMS_COMPILER_NO_RETURN_ATTRIBUTE;
123
124#ifdef __cplusplus
125}
126#endif
127
128/**@}*/
129
130#endif
131/* end of include file */
Note: See TracBrowser for help on using the repository browser.