source: rtems/cpukit/score/include/rtems/score/interr.h @ 9d10cf90

4.11
Last change on this file since 9d10cf90 was 9d10cf90, checked in by Sebastian Huber <sebastian.huber@…>, on Nov 14, 2012 at 12:58:22 PM

score: Add RTEMS_FATAL_SOURCE_BSP_GENERIC

  • Property mode set to 100644
File size: 4.3 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 *  @brief 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
48  /**
49   * @brief Fatal source for the block device cache.
50   *
51   * @see rtems_bdbuf_fatal_code.
52   */
53  RTEMS_FATAL_SOURCE_BDBUF,
54
55  /**
56   * @brief Fatal source for application specific errors.
57   *
58   * The fatal code is application specific.
59   */
60  RTEMS_FATAL_SOURCE_APPLICATION,
61
62  /**
63   * @brief Fatal source of exit().
64   *
65   * The fatal code is the exit() status code.
66   */
67  RTEMS_FATAL_SOURCE_EXIT,
68
69  /**
70   * @brief Fatal source for generic BSP errors.
71   *
72   * The fatal codes are defined in <bsp/bootcard.h>.  Examples are interrupt
73   * and exception initialization.
74   *
75   * @see bsp_generic_fatal_code.
76   */
77  RTEMS_FATAL_SOURCE_BSP_GENERIC,
78
79  /**
80   * @brief The last available fatal source.
81   *
82   * This enum value ensures that the enum type needs at least 32-bits for
83   * architectures with short enums.
84   */
85  RTEMS_FATAL_SOURCE_LAST = 0xffffffff
86} Internal_errors_Source;
87
88/**
89 *  A list of errors which are generated internally by the executive core.
90 */
91typedef enum {
92  INTERNAL_ERROR_NO_CONFIGURATION_TABLE,
93  INTERNAL_ERROR_NO_CPU_TABLE,
94  INTERNAL_ERROR_TOO_LITTLE_WORKSPACE,
95  INTERNAL_ERROR_WORKSPACE_ALLOCATION,
96  INTERNAL_ERROR_INTERRUPT_STACK_TOO_SMALL,
97  INTERNAL_ERROR_THREAD_EXITTED,
98  INTERNAL_ERROR_INCONSISTENT_MP_INFORMATION,
99  INTERNAL_ERROR_INVALID_NODE,
100  INTERNAL_ERROR_NO_MPCI,
101  INTERNAL_ERROR_BAD_PACKET,
102  INTERNAL_ERROR_OUT_OF_PACKETS,
103  INTERNAL_ERROR_OUT_OF_GLOBAL_OBJECTS,
104  INTERNAL_ERROR_OUT_OF_PROXIES,
105  INTERNAL_ERROR_INVALID_GLOBAL_ID,
106  INTERNAL_ERROR_BAD_STACK_HOOK,
107  INTERNAL_ERROR_BAD_ATTRIBUTES,
108  INTERNAL_ERROR_IMPLEMENTATION_KEY_CREATE_INCONSISTENCY,
109  INTERNAL_ERROR_IMPLEMENTATION_BLOCKING_OPERATION_CANCEL,
110  INTERNAL_ERROR_MUTEX_OBTAIN_FROM_BAD_STATE,
111  INTERNAL_ERROR_UNLIMITED_AND_MAXIMUM_IS_0,
112  INTERNAL_ERROR_SHUTDOWN_WHEN_NOT_UP,
113  INTERNAL_ERROR_GXX_KEY_ADD_FAILED,
114  INTERNAL_ERROR_GXX_MUTEX_INIT_FAILED,
115  INTERNAL_ERROR_NO_MEMORY_FOR_HEAP,
116  INTERNAL_ERROR_CPU_ISR_INSTALL_VECTOR
117} Internal_errors_Core_list;
118
119typedef uint32_t Internal_errors_t;
120
121/**
122 *  This type holds the fatal error information.
123 */
124typedef struct {
125  /** This is the source of the error. */
126  Internal_errors_Source  the_source;
127  /** This indicates if the error is internal of external. */
128  bool                    is_internal;
129  /** This is the error code. */
130  Internal_errors_t       the_error;
131
132  /**
133   * @brief The internal error nest level.
134   *
135   * This helps to detect recursive calls to _Internal_error_Occurred().
136   */
137  uint32_t                nest_level;
138} Internal_errors_Information;
139
140/**
141 *  When a fatal error occurs, the error information is stored here.
142 */
143extern Internal_errors_Information _Internal_errors_What_happened;
144
145/**
146 * @brief An internal or fatal error occurred.
147 *
148 * This routine is invoked when the application or the executive itself
149 * determines that a fatal error has occurred.
150 *
151 * This function can be called in every system state provided the following
152 * conditions are true
153 * - the stack pointer is valid,
154 * - the code memory is valid,
155 * - the read-only data is valid, and
156 * - the read-write data is accessible.
157 */
158void _Internal_error_Occurred(
159  Internal_errors_Source  the_source,
160  bool                    is_internal,
161  Internal_errors_t       the_error
162) RTEMS_COMPILER_NO_RETURN_ATTRIBUTE;
163
164#ifdef __cplusplus
165}
166#endif
167
168/**@}*/
169
170#endif
171/* end of include file */
Note: See TracBrowser for help on using the repository browser.