source: rtems/cpukit/score/include/rtems/score/basedefs.h @ dc18190

4.115
Last change on this file since dc18190 was dc18190, checked in by Sebastian Huber <sebastian.huber@…>, on Apr 14, 2014 at 10:41:57 AM

score: Add and use RTEMS_ZERO_LENGTH_ARRAY

  • Property mode set to 100644
File size: 6.0 KB
Line 
1/**
2 * @file
3 *
4 * @ingroup Score
5 *
6 * @brief Basic Definitions
7 */
8
9/*
10 *  COPYRIGHT (c) 1989-2007.
11 *  On-Line Applications Research Corporation (OAR).
12 *
13 *  Copyright (c) 2010 embedded brains GmbH.
14 *
15 *  The license and distribution terms for this file may be
16 *  found in the file LICENSE in this distribution or at
17 *  http://www.rtems.org/license/LICENSE.
18 */
19
20#ifndef _RTEMS_BASEDEFS_H
21#define _RTEMS_BASEDEFS_H
22
23/**
24 *  @defgroup ScoreBaseDefs Basic Definitions
25 *
26 *  @ingroup Score
27 */
28/**@{*/
29
30#include <rtems/score/cpuopts.h>
31
32#ifndef ASM
33  #include <stddef.h>
34  #include <stdbool.h>
35  #include <stdint.h>
36
37  /*
38   * FIXME: This include should not be present.  In older RTEMS versions
39   * <rtems.h> provided <limits.h> indirectly.  This include is here to not
40   * break application source files that relied on this accidentally.
41   */
42  #include <limits.h>
43
44  /*
45   * FIXME: This include should not be present.  In older RTEMS versions
46   * <rtems.h> provided <string.h> indirectly.  This include is here to not
47   * break application source files that relied on this accidentally.
48   */
49  #include <string.h>
50#endif
51
52#ifndef TRUE
53  /**
54   *  This ensures that RTEMS has TRUE defined in all situations.
55   */
56  #define TRUE 1
57#endif
58
59#ifndef FALSE
60  /**
61   *  This ensures that RTEMS has FALSE defined in all situations.
62   */
63  #define FALSE 0
64#endif
65
66#if TRUE == FALSE
67  #error "TRUE equals FALSE"
68#endif
69
70/**
71 *  The following ensures that all data is declared in the space
72 *  of the initialization routine for either the Initialization Manager
73 *  or the initialization file for the appropriate API.  It is
74 *  referenced as "external" in every other file.
75 */
76#ifdef SCORE_INIT
77  #undef  SCORE_EXTERN
78  #define SCORE_EXTERN
79#else
80  #undef  SCORE_EXTERN
81  #define SCORE_EXTERN  extern
82#endif
83
84/**
85 *  The following ensures that all data is declared in the space
86 *  of the initialization routine for either the Initialization Manager
87 *  or the initialization file for the appropriate API.  It is
88 *  referenced as "external" in every other file.
89 */
90#ifdef SAPI_INIT
91  #undef  SAPI_EXTERN
92  #define SAPI_EXTERN
93#else
94  #undef  SAPI_EXTERN
95  #define SAPI_EXTERN  extern
96#endif
97
98/**
99 *  The following ensures that all data is declared in the space
100 *  of the initialization routine for either the Initialization Manager
101 *  or the initialization file for the appropriate API.  It is
102 *  referenced as "external" in every other file.
103 */
104#ifdef RTEMS_API_INIT
105  #undef  RTEMS_EXTERN
106  #define RTEMS_EXTERN
107#else
108  #undef  RTEMS_EXTERN
109  #define RTEMS_EXTERN  extern
110#endif
111
112/**
113 *  The following ensures that all data is declared in the space
114 *  of the initialization routine for either the Initialization Manager
115 *  or the initialization file for the appropriate API.  It is
116 *  referenced as "external" in every other file.
117 */
118#ifdef POSIX_API_INIT
119  #undef  POSIX_EXTERN
120  #define POSIX_EXTERN
121#else
122  #undef  POSIX_EXTERN
123  #define POSIX_EXTERN  extern
124#endif
125
126/**
127 *  The following (in conjunction with compiler arguments) are used
128 *  to choose between the use of static inline functions and macro
129 *  functions.   The static inline implementation allows better
130 *  type checking with no cost in code size or execution speed.
131 */
132#ifdef __GNUC__
133  #define RTEMS_INLINE_ROUTINE static __inline__
134#else
135  #define RTEMS_INLINE_ROUTINE static inline
136#endif
137
138/**
139 *  The following macro is a compiler specific way to ensure that memory
140 *  writes are not reordered around certian points.  This specifically can
141 *  impact interrupt disable and thread dispatching critical sections.
142 */
143#ifdef __GNUC__
144  #define RTEMS_COMPILER_MEMORY_BARRIER() __asm__ volatile("" ::: "memory")
145#else
146  #define RTEMS_COMPILER_MEMORY_BARRIER()
147#endif
148
149/**
150 *  The following macro is a compiler specific way to indicate that
151 *  the method will NOT return to the caller.  This can assist the
152 *  compiler in code generation and avoid unreachable paths.  This
153 *  can impact the code generated following calls to
154 *  rtems_fatal_error_occurred and _Terminate.
155 */
156#ifdef __GNUC__
157  #define RTEMS_COMPILER_NO_RETURN_ATTRIBUTE \
158      __attribute__ ((noreturn))
159#else
160  #define RTEMS_COMPILER_NO_RETURN_ATTRIBUTE
161#endif
162
163/**
164 *  The following defines a compiler specific attribute which informs
165 *  the compiler that the method has no effect except the return value
166 *  and that the return value depends only on parameters and/or global
167 *  variables.
168 */
169#ifdef __GNUC__
170  #define RTEMS_COMPILER_PURE_ATTRIBUTE \
171     __attribute__ ((pure))
172#else
173  #define RTEMS_COMPILER_PURE_ATTRIBUTE
174#endif
175
176/**
177 *  Instructs the compiler to issue a warning whenever a variable or function
178 *  with this attribute will be used.
179 */
180#ifdef __GNUC__
181  #define RTEMS_COMPILER_DEPRECATED_ATTRIBUTE \
182     __attribute__ ((deprecated))
183#else
184  #define RTEMS_COMPILER_DEPRECATED_ATTRIBUTE
185#endif
186
187/**
188 *  Instructs the compiler that a specific variable is deliberately unused.
189 *  This can occur when reading volatile device memory or skipping arguments
190 *  in a variable argument method.
191 */
192#if defined(__GNUC__)       
193  #define RTEMS_COMPILER_UNUSED_ATTRIBUTE __attribute__((unused))
194#else
195  #define RTEMS_COMPILER_UNUSED_ATTRIBUTE
196#endif
197
198#if __cplusplus >= 201103L
199  #define RTEMS_STATIC_ASSERT(cond, msg) \
200    static_assert(cond, # msg)
201#elif __STDC_VERSION__ >= 201112L
202  #define RTEMS_STATIC_ASSERT(cond, msg) \
203    _Static_assert(cond, # msg)
204#else
205  #define RTEMS_STATIC_ASSERT(cond, msg) \
206    typedef int rtems_static_assert_ ## msg [(cond) ? 1 : -1]
207#endif
208
209#define RTEMS_ARRAY_SIZE(array) (sizeof(array) / sizeof((array)[0]))
210
211/*
212 * Zero-length arrays are valid in C99 as flexible array members.  C++11
213 * doesn't allow flexible array members.  Use the GNU extension which is also
214 * supported by other compilers.
215 */
216#define RTEMS_ZERO_LENGTH_ARRAY 0
217
218#ifndef ASM
219  #ifdef RTEMS_DEPRECATED_TYPES
220    typedef bool boolean;
221    typedef float single_precision;
222    typedef double double_precision;
223  #endif
224
225  /**
226   * XXX: Eventually proc_ptr needs to disappear!!!
227   */
228  typedef void * proc_ptr;
229#endif
230
231/**@}*/
232
233#endif /* _RTEMS_BASEDEFS_H */
Note: See TracBrowser for help on using the repository browser.