1 /* vi: set sw=4 ts=4: */
3 * Copyright 2006, Bernhard Reutner-Fischer
5 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
8 #define BB_PLATFORM_H 1
11 /* Convenience macros to test the version of gcc. */
13 #if defined __GNUC__ && defined __GNUC_MINOR__
14 # define __GNUC_PREREQ(maj, min) \
15 ((__GNUC__ << 16) + __GNUC_MINOR__ >= ((maj) << 16) + (min))
17 # define __GNUC_PREREQ(maj, min) 0
20 /* __restrict is known in EGCS 1.2 and above. */
21 #if !__GNUC_PREREQ(2,92)
27 #if !__GNUC_PREREQ(2,7)
28 # ifndef __attribute__
29 # define __attribute__(x)
34 #if defined(__STDC_VERSION__) && __STDC_VERSION__ > 199901L
36 #elif __GNUC_PREREQ(2,7)
37 # define inline __inline__
43 # define __const const
46 #define UNUSED_PARAM __attribute__ ((__unused__))
47 #define NORETURN __attribute__ ((__noreturn__))
48 /* "The malloc attribute is used to tell the compiler that a function
49 * may be treated as if any non-NULL pointer it returns cannot alias
50 * any other pointer valid when the function returns. This will often
51 * improve optimization. Standard functions with this property include
52 * malloc and calloc. realloc-like functions have this property as long
53 * as the old pointer is never referred to (including comparing it
54 * to the new pointer) after the function returns a non-NULL value."
56 #define RETURNS_MALLOC __attribute__ ((malloc))
57 #define PACKED __attribute__ ((__packed__))
58 #define ALIGNED(m) __attribute__ ((__aligned__(m)))
60 /* __NO_INLINE__: some gcc's do not honor inlining! :( */
61 #if __GNUC_PREREQ(3,0) && !defined(__NO_INLINE__)
62 # define ALWAYS_INLINE __attribute__ ((always_inline)) inline
63 /* I've seen a toolchain where I needed __noinline__ instead of noinline */
64 # define NOINLINE __attribute__((__noinline__))
66 # define DEPRECATED __attribute__ ((__deprecated__))
67 # define UNUSED_PARAM_RESULT __attribute__ ((warn_unused_result))
70 # define UNUSED_PARAM_RESULT
73 # define ALWAYS_INLINE inline
76 # define UNUSED_PARAM_RESULT
79 /* -fwhole-program makes all symbols local. The attribute externally_visible
80 * forces a symbol global. */
81 #if __GNUC_PREREQ(4,1)
82 # define EXTERNALLY_VISIBLE __attribute__(( visibility("default") ))
83 //__attribute__ ((__externally_visible__))
85 # define EXTERNALLY_VISIBLE
88 /* At 4.4 gcc become much more anal about this, need to use "aliased" types */
89 #if __GNUC_PREREQ(4,4)
90 # define FIX_ALIASING __attribute__((__may_alias__))
95 /* We use __extension__ in some places to suppress -pedantic warnings
96 * about GCC extensions. This feature didn't work properly before
98 #if !__GNUC_PREREQ(2,8)
99 # ifndef __extension__
100 # define __extension__
104 /* FAST_FUNC is a qualifier which (possibly) makes function call faster
105 * and/or smaller by using modified ABI. It is usually only needed
106 * on non-static, busybox internal functions. Recent versions of gcc
107 * optimize statics automatically. FAST_FUNC on static is required
108 * only if you need to match a function pointer's type */
109 #if __GNUC_PREREQ(3,0) && defined(i386) /* || defined(__x86_64__)? */
110 /* stdcall makes callee to pop arguments from stack, not caller */
111 # define FAST_FUNC __attribute__((regparm(3),stdcall))
112 /* #elif ... - add your favorite arch today! */
117 /* Make all declarations hidden (-fvisibility flag only affects definitions) */
118 /* (don't include system headers after this until corresponding pop!) */
119 #if __GNUC_PREREQ(4,1) && !defined(__CYGWIN__)
120 # define PUSH_AND_SET_FUNCTION_VISIBILITY_TO_HIDDEN _Pragma("GCC visibility push(hidden)")
121 # define POP_SAVED_FUNCTION_VISIBILITY _Pragma("GCC visibility pop")
123 # define PUSH_AND_SET_FUNCTION_VISIBILITY_TO_HIDDEN
124 # define POP_SAVED_FUNCTION_VISIBILITY
127 /* gcc-2.95 had no va_copy but only __va_copy. */
128 #if !__GNUC_PREREQ(3,0)
130 # if !defined va_copy && defined __va_copy
131 # define va_copy(d,s) __va_copy((d),(s))
136 /* ---- Endian Detection ------------------------------------ */
139 #if defined(__digital__) && defined(__unix__)
141 #elif defined(__FreeBSD__) || defined(__OpenBSD__) || defined(__NetBSD__) \
142 || defined(__APPLE__)
143 # include <sys/resource.h> /* rlimit */
144 # include <machine/endian.h>
145 # define bswap_64 __bswap64
146 # define bswap_32 __bswap32
147 # define bswap_16 __bswap16
149 # include <byteswap.h>
153 #if defined(__BYTE_ORDER) && __BYTE_ORDER == __BIG_ENDIAN
154 # define BB_BIG_ENDIAN 1
155 # define BB_LITTLE_ENDIAN 0
156 #elif defined(__BYTE_ORDER) && __BYTE_ORDER == __LITTLE_ENDIAN
157 # define BB_BIG_ENDIAN 0
158 # define BB_LITTLE_ENDIAN 1
159 #elif defined(_BYTE_ORDER) && _BYTE_ORDER == _BIG_ENDIAN
160 # define BB_BIG_ENDIAN 1
161 # define BB_LITTLE_ENDIAN 0
162 #elif defined(_BYTE_ORDER) && _BYTE_ORDER == _LITTLE_ENDIAN
163 # define BB_BIG_ENDIAN 0
164 # define BB_LITTLE_ENDIAN 1
165 #elif defined(BYTE_ORDER) && BYTE_ORDER == BIG_ENDIAN
166 # define BB_BIG_ENDIAN 1
167 # define BB_LITTLE_ENDIAN 0
168 #elif defined(BYTE_ORDER) && BYTE_ORDER == LITTLE_ENDIAN
169 # define BB_BIG_ENDIAN 0
170 # define BB_LITTLE_ENDIAN 1
171 #elif defined(__386__)
172 # define BB_BIG_ENDIAN 0
173 # define BB_LITTLE_ENDIAN 1
175 # error "Can't determine endianness"
178 #if ULONG_MAX > 0xffffffff
179 # define bb_bswap_64(x) bswap_64(x)
182 /* SWAP_LEnn means "convert CPU<->little_endian by swapping bytes" */
184 # define SWAP_BE16(x) (x)
185 # define SWAP_BE32(x) (x)
186 # define SWAP_BE64(x) (x)
187 # define SWAP_LE16(x) bswap_16(x)
188 # define SWAP_LE32(x) bswap_32(x)
189 # define SWAP_LE64(x) bb_bswap_64(x)
190 # define IF_BIG_ENDIAN(...) __VA_ARGS__
191 # define IF_LITTLE_ENDIAN(...)
193 # define SWAP_BE16(x) bswap_16(x)
194 # define SWAP_BE32(x) bswap_32(x)
195 # define SWAP_BE64(x) bb_bswap_64(x)
196 # define SWAP_LE16(x) (x)
197 # define SWAP_LE32(x) (x)
198 # define SWAP_LE64(x) (x)
199 # define IF_BIG_ENDIAN(...)
200 # define IF_LITTLE_ENDIAN(...) __VA_ARGS__
204 /* ---- Unaligned access ------------------------------------ */
207 typedef int bb__aliased_int FIX_ALIASING;
208 typedef long bb__aliased_long FIX_ALIASING;
209 typedef uint16_t bb__aliased_uint16_t FIX_ALIASING;
210 typedef uint32_t bb__aliased_uint32_t FIX_ALIASING;
212 /* NB: unaligned parameter should be a pointer, aligned one -
213 * a lvalue. This makes it more likely to not swap them by mistake
215 #if defined(i386) || defined(__x86_64__) || defined(__powerpc__)
216 # define move_from_unaligned_int(v, intp) ((v) = *(bb__aliased_int*)(intp))
217 # define move_from_unaligned_long(v, longp) ((v) = *(bb__aliased_long*)(longp))
218 # define move_from_unaligned16(v, u16p) ((v) = *(bb__aliased_uint16_t*)(u16p))
219 # define move_from_unaligned32(v, u32p) ((v) = *(bb__aliased_uint32_t*)(u32p))
220 # define move_to_unaligned16(u16p, v) (*(bb__aliased_uint16_t*)(u16p) = (v))
221 # define move_to_unaligned32(u32p, v) (*(bb__aliased_uint32_t*)(u32p) = (v))
222 /* #elif ... - add your favorite arch today! */
224 /* performs reasonably well (gcc usually inlines memcpy here) */
225 # define move_from_unaligned_int(v, intp) (memcpy(&(v), (intp), sizeof(int)))
226 # define move_from_unaligned_long(v, longp) (memcpy(&(v), (longp), sizeof(long)))
227 # define move_from_unaligned16(v, u16p) (memcpy(&(v), (u16p), 2))
228 # define move_from_unaligned32(v, u32p) (memcpy(&(v), (u32p), 4))
229 # define move_to_unaligned16(u16p, v) do { \
230 uint16_t __t = (v); \
231 memcpy((u16p), &__t, 2); \
233 # define move_to_unaligned32(u32p, v) do { \
234 uint32_t __t = (v); \
235 memcpy((u32p), &__t, 4); \
240 /* ---- Size-saving "small" ints (arch-dependent) ----------- */
242 #if defined(i386) || defined(__x86_64__) || defined(__mips__) || defined(__cris__)
243 /* add other arches which benefit from this... */
244 typedef signed char smallint;
245 typedef unsigned char smalluint;
247 /* for arches where byte accesses generate larger code: */
248 typedef int smallint;
249 typedef unsigned smalluint;
252 /* ISO C Standard: 7.16 Boolean type and values <stdbool.h> */
253 #if (defined __digital__ && defined __unix__)
254 /* old system without (proper) C99 support */
255 # define bool smalluint
257 /* modern system, so use it */
258 # include <stdbool.h>
262 /*----- Kernel versioning ------------------------------------*/
264 #define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))
267 /* ---- Miscellaneous --------------------------------------- */
269 #if defined __GLIBC__ \
270 || defined __UCLIBC__ \
271 || defined __dietlibc__ \
272 || defined __BIONIC__ \
273 || defined _NEWLIB_VERSION
274 # include <features.h>
277 /* Define bb_setpgrp */
278 #if defined(__digital__) && defined(__unix__)
279 /* use legacy setpgrp(pid_t, pid_t) for now. move to platform.c */
280 # define bb_setpgrp() do { pid_t __me = getpid(); setpgrp(__me, __me); } while (0)
282 # define bb_setpgrp() setpgrp()
285 /* fdprintf is more readable, we used it before dprintf was standardized */
287 #define fdprintf dprintf
289 /* Useful for defeating gcc's alignment of "char message[]"-like data */
290 #if !defined(__s390__)
291 /* on s390[x], non-word-aligned data accesses require larger code */
292 # define ALIGN1 __attribute__((aligned(1)))
293 # define ALIGN2 __attribute__((aligned(2)))
294 # define ALIGN4 __attribute__((aligned(4)))
296 /* Arches which MUST have 2 or 4 byte alignment for everything are here */
303 * For 0.9.29 and svn, __ARCH_USE_MMU__ indicates no-mmu reliably.
304 * For earlier versions there is no reliable way to check if we are building
305 * for a mmu-less system.
307 #if ENABLE_NOMMU || \
308 (defined __UCLIBC__ && __UCLIBC_MAJOR__ >= 0 && __UCLIBC_MINOR__ >= 9 && \
309 __UCLIBC_SUBLEVEL__ > 28 && !defined __ARCH_USE_MMU__)
311 # define USE_FOR_NOMMU(...) __VA_ARGS__
312 # define USE_FOR_MMU(...)
315 # define USE_FOR_NOMMU(...)
316 # define USE_FOR_MMU(...) __VA_ARGS__
319 #if defined(__digital__) && defined(__unix__)
320 # include <standards.h>
321 # include <inttypes.h>
323 # if !defined ADJ_OFFSET_SINGLESHOT && defined MOD_CLKA && defined MOD_OFFSET
324 # define ADJ_OFFSET_SINGLESHOT (MOD_CLKA | MOD_OFFSET)
326 # if !defined ADJ_FREQUENCY && defined MOD_FREQUENCY
327 # define ADJ_FREQUENCY MOD_FREQUENCY
329 # if !defined ADJ_TIMECONST && defined MOD_TIMECONST
330 # define ADJ_TIMECONST MOD_TIMECONST
332 # if !defined ADJ_TICK && defined MOD_CLKB
333 # define ADJ_TICK MOD_CLKB
337 #if defined(__CYGWIN__)
338 # define MAXSYMLINKS SYMLOOP_MAX
341 #if defined(ANDROID) || defined(__ANDROID__)
342 # define BB_ADDITIONAL_PATH ":/system/sbin:/system/bin:/system/xbin"
343 # define SYS_ioprio_set __NR_ioprio_set
344 # define SYS_ioprio_get __NR_ioprio_get
348 /* ---- Who misses what? ------------------------------------ */
350 /* Assume all these functions and header files exist by default.
351 * Platforms where it is not true will #undef them below.
353 #define HAVE_CLEARENV 1
354 #define HAVE_FDATASYNC 1
355 #define HAVE_DPRINTF 1
356 #define HAVE_MEMRCHR 1
357 #define HAVE_MKDTEMP 1
358 #define HAVE_PTSNAME_R 1
359 #define HAVE_SETBIT 1
360 #define HAVE_SIGHANDLER_T 1
361 #define HAVE_STPCPY 1
362 #define HAVE_STRCASESTR 1
363 #define HAVE_STRCHRNUL 1
364 #define HAVE_STRSEP 1
365 #define HAVE_STRSIGNAL 1
366 #define HAVE_STRVERSCMP 1
367 #define HAVE_VASPRINTF 1
368 #define HAVE_UNLOCKED_STDIO 1
369 #define HAVE_UNLOCKED_LINE_OPS 1
370 #define HAVE_GETLINE 1
372 #define HAVE_MNTENT_H 1
373 #define HAVE_NET_ETHERNET_H 1
374 #define HAVE_SYS_STATFS_H 1
376 #if defined(__UCLIBC_MAJOR__)
377 # if __UCLIBC_MAJOR__ == 0 \
378 && ( __UCLIBC_MINOR__ < 9 \
379 || (__UCLIBC_MINOR__ == 9 && __UCLIBC_SUBLEVEL__ < 32) \
381 # undef HAVE_STRVERSCMP
385 #if defined(__dietlibc__)
386 # undef HAVE_STRCHRNUL
389 #if defined(__WATCOMC__)
396 # undef HAVE_STRCASESTR
397 # undef HAVE_STRCHRNUL
399 # undef HAVE_STRSIGNAL
400 # undef HAVE_STRVERSCMP
401 # undef HAVE_VASPRINTF
402 # undef HAVE_UNLOCKED_STDIO
403 # undef HAVE_UNLOCKED_LINE_OPS
404 # undef HAVE_NET_ETHERNET_H
407 #if defined(__CYGWIN__)
408 # undef HAVE_CLEARENV
409 # undef HAVE_FDPRINTF
411 # undef HAVE_PTSNAME_R
412 # undef HAVE_STRVERSCMP
413 # undef HAVE_UNLOCKED_LINE_OPS
416 /* These BSD-derived OSes share many similarities */
417 #if (defined __digital__ && defined __unix__) \
418 || defined __APPLE__ \
419 || defined __FreeBSD__ || defined __OpenBSD__ || defined __NetBSD__
420 # undef HAVE_CLEARENV
421 # undef HAVE_FDATASYNC
423 # undef HAVE_MNTENT_H
424 # undef HAVE_PTSNAME_R
425 # undef HAVE_SYS_STATFS_H
426 # undef HAVE_SIGHANDLER_T
427 # undef HAVE_STRVERSCMP
430 # undef HAVE_UNLOCKED_STDIO
431 # undef HAVE_UNLOCKED_LINE_OPS
434 #if defined(__FreeBSD__)
435 # undef HAVE_STRCHRNUL
438 #if defined(__NetBSD__)
439 # define HAVE_GETLINE 1 /* Recent NetBSD versions have getline() */
442 #if defined(__digital__) && defined(__unix__)
446 #if defined(ANDROID) || defined(__ANDROID__)
450 # undef HAVE_STRCHRNUL
451 # undef HAVE_STRVERSCMP
452 # undef HAVE_UNLOCKED_LINE_OPS
453 # undef HAVE_NET_ETHERNET_H
457 * Now, define prototypes for all the functions defined in platform.c
458 * These must come after all the HAVE_* macros are defined (or not)
462 extern int dprintf(int fd, const char *format, ...);
466 extern void *memrchr(const void *s, int c, size_t n) FAST_FUNC;
470 extern char *mkdtemp(char *template) FAST_FUNC;
474 # define setbit(a, b) ((a)[(b) >> 3] |= 1 << ((b) & 7))
475 # define clrbit(a, b) ((a)[(b) >> 3] &= ~(1 << ((b) & 7)))
478 #ifndef HAVE_SIGHANDLER_T
479 typedef void (*sighandler_t)(int);
483 extern char *stpcpy(char *p, const char *to_add) FAST_FUNC;
486 #ifndef HAVE_STRCASESTR
487 extern char *strcasestr(const char *s, const char *pattern) FAST_FUNC;
490 #ifndef HAVE_STRCHRNUL
491 extern char *strchrnul(const char *s, int c) FAST_FUNC;
495 extern char *strsep(char **stringp, const char *delim) FAST_FUNC;
498 #ifndef HAVE_STRSIGNAL
499 /* Not exactly the same: instead of "Stopped" it shows "STOP" etc */
500 # define strsignal(sig) get_signame(sig)
503 #ifndef HAVE_VASPRINTF
504 extern int vasprintf(char **string_ptr, const char *format, va_list p) FAST_FUNC;
508 # include <stdio.h> /* for FILE */
509 # include <sys/types.h> /* size_t */
510 extern ssize_t getline(char **lineptr, size_t *n, FILE *stream) FAST_FUNC;