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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
|
/**
* @file rtems/score/interr.h
*
* This include file contains constants and prototypes related
* to the Internal Error Handler.
*/
/*
* COPYRIGHT (c) 1989-2009.
* On-Line Applications Research Corporation (OAR).
*
* The license and distribution terms for this file may be
* found in the file LICENSE in this distribution or at
* http://www.rtems.com/license/LICENSE.
*/
#ifndef _RTEMS_SCORE_INTERR_H
#define _RTEMS_SCORE_INTERR_H
#include <stdbool.h>
#include <stdint.h>
#include <rtems/system.h>
/**
* @defgroup ScoreIntErr Internal Error Handler
*
* @ingroup Score
*
* This handler encapsulates functionality which provides the foundation
* Semaphore services used in all of the APIs supported by RTEMS.
*/
/**@{*/
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief This type lists the possible sources from which an error
* can be reported.
*/
typedef enum {
INTERNAL_ERROR_CORE,
INTERNAL_ERROR_RTEMS_API,
INTERNAL_ERROR_POSIX_API,
/**
* @brief Fatal source for the block device cache.
*
* @see rtems_bdbuf_fatal_code.
*/
RTEMS_FATAL_SOURCE_BDBUF,
/**
* @brief Fatal source for application specific errors.
*
* The fatal code is application specific.
*/
RTEMS_FATAL_SOURCE_APPLICATION,
/**
* @brief Fatal source of exit().
*
* The fatal code is the exit() status code.
*/
RTEMS_FATAL_SOURCE_EXIT,
/**
* @brief Fatal source for generic BSP errors.
*
* The fatal codes are defined in <bsp/bootcard.h>. Examples are interrupt
* and exception initialization.
*
* @see bsp_generic_fatal_code.
*/
RTEMS_FATAL_SOURCE_BSP_GENERIC,
/**
* @brief Fatal source for BSP specific errors.
*
* The fatal code is BSP specific.
*/
RTEMS_FATAL_SOURCE_BSP_SPECIFIC,
/**
* @brief Fatal source of assert().
*
* The fatal code is the pointer value of the function string.
*/
RTEMS_FATAL_SOURCE_ASSERT,
/**
* @brief The last available fatal source.
*
* This enum value ensures that the enum type needs at least 32-bits for
* architectures with short enums.
*/
RTEMS_FATAL_SOURCE_LAST = 0xffffffff
} Internal_errors_Source;
/**
* A list of errors which are generated internally by the executive core.
*/
typedef enum {
INTERNAL_ERROR_NO_CONFIGURATION_TABLE,
INTERNAL_ERROR_NO_CPU_TABLE,
INTERNAL_ERROR_TOO_LITTLE_WORKSPACE,
INTERNAL_ERROR_WORKSPACE_ALLOCATION,
INTERNAL_ERROR_INTERRUPT_STACK_TOO_SMALL,
INTERNAL_ERROR_THREAD_EXITTED,
INTERNAL_ERROR_INCONSISTENT_MP_INFORMATION,
INTERNAL_ERROR_INVALID_NODE,
INTERNAL_ERROR_NO_MPCI,
INTERNAL_ERROR_BAD_PACKET,
INTERNAL_ERROR_OUT_OF_PACKETS,
INTERNAL_ERROR_OUT_OF_GLOBAL_OBJECTS,
INTERNAL_ERROR_OUT_OF_PROXIES,
INTERNAL_ERROR_INVALID_GLOBAL_ID,
INTERNAL_ERROR_BAD_STACK_HOOK,
INTERNAL_ERROR_BAD_ATTRIBUTES,
INTERNAL_ERROR_IMPLEMENTATION_KEY_CREATE_INCONSISTENCY,
INTERNAL_ERROR_IMPLEMENTATION_BLOCKING_OPERATION_CANCEL,
INTERNAL_ERROR_MUTEX_OBTAIN_FROM_BAD_STATE,
INTERNAL_ERROR_UNLIMITED_AND_MAXIMUM_IS_0,
INTERNAL_ERROR_SHUTDOWN_WHEN_NOT_UP,
INTERNAL_ERROR_GXX_KEY_ADD_FAILED,
INTERNAL_ERROR_GXX_MUTEX_INIT_FAILED,
INTERNAL_ERROR_NO_MEMORY_FOR_HEAP,
INTERNAL_ERROR_CPU_ISR_INSTALL_VECTOR
} Internal_errors_Core_list;
typedef uint32_t Internal_errors_t;
/**
* This type holds the fatal error information.
*/
typedef struct {
/** This is the source of the error. */
Internal_errors_Source the_source;
/** This indicates if the error is internal of external. */
bool is_internal;
/** This is the error code. */
Internal_errors_t the_error;
/**
* @brief The internal error nest level.
*
* This helps to detect recursive calls to _Internal_error_Occurred().
*/
uint32_t nest_level;
} Internal_errors_Information;
/**
* When a fatal error occurs, the error information is stored here.
*/
extern Internal_errors_Information _Internal_errors_What_happened;
/**
* @brief An internal or fatal error occurred.
*
* This routine is invoked when the application or the executive itself
* determines that a fatal error has occurred.
*
* This function can be called in every system state provided the following
* conditions are true
* - the stack pointer is valid,
* - the code memory is valid,
* - the read-only data is valid, and
* - the read-write data is accessible.
*/
void _Internal_error_Occurred(
Internal_errors_Source the_source,
bool is_internal,
Internal_errors_t the_error
) RTEMS_COMPILER_NO_RETURN_ATTRIBUTE;
#ifdef __cplusplus
}
#endif
/**@}*/
#endif
/* end of include file */
|
