blob: 31a37e025b912ea4f21198effa3fe82de70709a9 (
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
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
|
/**
* @file rtems/error.h
*
* @brief RTEMS Error Reporting
*
* Defines and externs for rtems error reporting
*
* Currently just used by RTEMS monitor.
*
* 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
* #include <rtems.h>
* #include <rtems/error.h>
* rtems_error(0, "stray interrupt %d", intr);
*
* EXAMPLE
* if ((status = rtems_task_create(...)) != RTEMS_SUCCCESSFUL)
* {
* rtems_error(status | RTEMS_ERROR_ABORT,
* "could not create task");
* }
*
* EXAMPLE
* if ((fd = open(pathname, O_RDNLY)) < 0)
* {
* rtems_error(RTEMS_ERROR_ERRNO, "open of '%s' failed", pathname);
* goto failed;
* }
*/
#ifndef _RTEMS_RTEMS_ERROR_H
#define _RTEMS_RTEMS_ERROR_H
#include <rtems/rtems/status.h>
#include <rtems/score/interr.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() 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 */
const char *rtems_status_text(rtems_status_code sc);
/**
* @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,
...
);
/**
* rtems_panic is shorthand for rtems_error(RTEMS_ERROR_PANIC, ...)
*/
void rtems_panic(
const char *printf_format,
...
) RTEMS_COMPILER_NO_RETURN_ATTRIBUTE;
extern int rtems_panic_in_progress;
#ifdef __cplusplus
}
#endif
#endif
/* end of include file */
|