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
|
/**
* @file rtems/error.h
*
* @brief RTEMS Error Reporting
*
* Defines and externs for rtems error reporting
*
* These routines provide general purpose error reporting.
* rtems_error reports an error to stderr and allows use of
* printf style formatting. A newline is appended to all messages.
*
* error_flag can be specified as any of the following:
*
* RTEMS_ERROR_ERRNO -- include errno text in output
* RTEMS_ERROR_PANIC -- halts local system after output
* RTEMS_ERROR_ABORT -- abort after output
*
* It can also include a rtems_status value which can be OR'd
* with the above flags. *
*
* Example 1:
* @code
* #include <rtems.h>
* #include <rtems/error.h>
* rtems_error(0, "stray interrupt %d", intr);
* @endcode
*
* Example 2:
* @code
* if ((status = rtems_task_create(...)) != RTEMS_SUCCCESSFUL)
* {
* rtems_error(status | RTEMS_ERROR_ABORT,
* "could not create task");
* }
* @endcode
*
* Example 3:
* @code
* if ((fd = open(pathname, O_RDNLY)) < 0)
* {
* rtems_error(RTEMS_ERROR_ERRNO, "open of '%s' failed", pathname);
* goto failed;
* }
* @endcode
*/
#ifndef _RTEMS_RTEMS_ERROR_H
#define _RTEMS_RTEMS_ERROR_H
#include <rtems/rtems/status.h>
#include <rtems/fatal.h>
#include <stdarg.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
* @defgroup ErrorPanicSupport Error And Panic Support
*
* @ingroup libcsupport
*
* @brief Defines and externs for rtems error reporting
*
*/
typedef Internal_errors_t rtems_error_code_t;
/*
* rtems_error(), rtems_verror() and rtems_panic() support
*/
#if 0
/* not 16bit-int host clean */
#define RTEMS_ERROR_ERRNO (1<<((sizeof(rtems_error_code_t) * CHAR_BIT) - 2)) /* hi bit; use 'errno' */
#define RTEMS_ERROR_PANIC (RTEMS_ERROR_ERRNO / 2) /* err fatal; no return */
#define RTEMS_ERROR_ABORT (RTEMS_ERROR_ERRNO / 4) /* err is fatal; panic */
#else
#define RTEMS_ERROR_ERRNO (0x40000000) /* hi bit; use 'errno' */
#define RTEMS_ERROR_PANIC (0x20000000) /* err fatal; no return */
#define RTEMS_ERROR_ABORT (0x10000000) /* err is fatal; panic */
#endif
#define RTEMS_ERROR_MASK \
(RTEMS_ERROR_ERRNO | RTEMS_ERROR_ABORT | RTEMS_ERROR_PANIC) /* all */
/**
* @brief Report an Error
*
* @param[in] error_code can be specified as any of the following:
* RTEMS_ERROR_ERRNO -- include errno text in output
* RTEMS_ERROR_PANIC -- halts local system after output
* RTEMS_ERROR_ABORT -- abort after output
*
* @param[in] printf_format is a normal printf(3) format string,
* with its concommitant arguments
*
* @return the number of characters written.
*/
int rtems_error(
rtems_error_code_t error_code,
const char *printf_format,
...
);
/**
* @brief Report an Error
*
* @param[in] error_code can be specified as any of the following:
* RTEMS_ERROR_ERRNO -- include errno text in output
* RTEMS_ERROR_PANIC -- halts local system after output
* RTEMS_ERROR_ABORT -- abort after output
*
* @param[in] printf_format is a normal printf(3) format string,
* with its concommitant arguments
* @param[in] arglist is a varargs list corresponding to
* printf_format
*
* @return the number of characters written.
*/
int rtems_verror(
rtems_error_code_t error_code,
const char *printf_format,
va_list arglist
);
extern int rtems_panic_in_progress;
#ifdef __cplusplus
}
#endif
#endif
/* end of include file */
|
