include/platform.h

   1 /* vi: set sw=4 ts=4: */
   2 /*
   3  * Copyright 2006, Bernhard Reutner-Fischer
   4  *
   5  * Licensed under GPLv2 or later, see file LICENSE in this source tree.
   6  */
   7 #ifndef BB_PLATFORM_H
   8 #define BB_PLATFORM_H 1
   9
  10 /* Assume all these functions exist by default.  Platforms where it is not
  11  * true will #undef them below.
  12  */
  13 #define HAVE_FDPRINTF 1
  14 #define HAVE_MEMRCHR 1
  15 #define HAVE_MKDTEMP 1
  16 #define HAVE_SETBIT 1
  17 #define HAVE_STRCASESTR 1
  18 #define HAVE_STRCHRNUL 1
  19 #define HAVE_STRSEP 1
  20 #define HAVE_STRSIGNAL 1
  21 #define HAVE_VASPRINTF 1
  22
  23 /* Convenience macros to test the version of gcc. */
  24 #undef __GNUC_PREREQ
  25 #if defined __GNUC__ && defined __GNUC_MINOR__
  26 # define __GNUC_PREREQ(maj, min) \
  27                 ((__GNUC__ << 16) + __GNUC_MINOR__ >= ((maj) << 16) + (min))
  28 #else
  29 # define __GNUC_PREREQ(maj, min) 0
  30 #endif
  31
  32 /* __restrict is known in EGCS 1.2 and above. */
  33 #if !__GNUC_PREREQ(2,92)
  34 # ifndef __restrict
  35 #  define __restrict
  36 # endif
  37 #endif
  38
  39 /* Define macros for some gcc attributes.  This permits us to use the
  40    macros freely, and know that they will come into play for the
  41    version of gcc in which they are supported.  */
  42
  43 #if !__GNUC_PREREQ(2,7)
  44 # ifndef __attribute__
  45 #  define __attribute__(x)
  46 # endif
  47 #endif
  48
  49 #undef inline
  50 #if defined(__STDC_VERSION__) && __STDC_VERSION__ > 199901L
  51 /* it's a keyword */
  52 #elif __GNUC_PREREQ(2,7)
  53 # define inline __inline__
  54 #else
  55 # define inline
  56 #endif
  57
  58 #ifndef __const
  59 # define __const const
  60 #endif
  61
  62 #define UNUSED_PARAM __attribute__ ((__unused__))
  63 #define NORETURN __attribute__ ((__noreturn__))
  64 /* "The malloc attribute is used to tell the compiler that a function
  65  * may be treated as if any non-NULL pointer it returns cannot alias
  66  * any other pointer valid when the function returns. This will often
  67  * improve optimization. Standard functions with this property include
  68  * malloc and calloc. realloc-like functions have this property as long
  69  * as the old pointer is never referred to (including comparing it
  70  * to the new pointer) after the function returns a non-NULL value."
  71  */
  72 #define RETURNS_MALLOC __attribute__ ((malloc))
  73 #define PACKED __attribute__ ((__packed__))
  74 #define ALIGNED(m) __attribute__ ((__aligned__(m)))
  75
  76 /* __NO_INLINE__: some gcc's do not honor inlining! :( */
  77 #if __GNUC_PREREQ(3,0) && !defined(__NO_INLINE__)
  78 # define ALWAYS_INLINE __attribute__ ((always_inline)) inline
  79 /* I've seen a toolchain where I needed __noinline__ instead of noinline */
  80 # define NOINLINE      __attribute__((__noinline__))
  81 # if !ENABLE_WERROR
  82 #  define DEPRECATED __attribute__ ((__deprecated__))
  83 #  define UNUSED_PARAM_RESULT __attribute__ ((warn_unused_result))
  84 # else
  85 #  define DEPRECATED
  86 #  define UNUSED_PARAM_RESULT
  87 # endif
  88 #else
  89 # define ALWAYS_INLINE inline
  90 # define NOINLINE
  91 # define DEPRECATED
  92 # define UNUSED_PARAM_RESULT
  93 #endif
  94
  95 /* -fwhole-program makes all symbols local. The attribute externally_visible
  96    forces a symbol global.  */
  97 #if __GNUC_PREREQ(4,1)
  98 # define EXTERNALLY_VISIBLE __attribute__(( visibility("default") ))
  99 //__attribute__ ((__externally_visible__))
 100 #else
 101 # define EXTERNALLY_VISIBLE
 102 #endif
 103
 104 /* At 4.4 gcc become much more anal about this, need to use "aliased" types */
 105 #if __GNUC_PREREQ(4,4)
 106 # define FIX_ALIASING __attribute__((__may_alias__))
 107 #else
 108 # define FIX_ALIASING
 109 #endif
 110
 111 /* We use __extension__ in some places to suppress -pedantic warnings
 112    about GCC extensions.  This feature didn't work properly before
 113    gcc 2.8.  */
 114 #if !__GNUC_PREREQ(2,8)
 115 # ifndef __extension__
 116 #  define __extension__
 117 # endif
 118 #endif
 119
 120 /* gcc-2.95 had no va_copy but only __va_copy. */
 121 #if !__GNUC_PREREQ(3,0)
 122 # include <stdarg.h>
 123 # if !defined va_copy && defined __va_copy
 124 #  define va_copy(d,s) __va_copy((d),(s))
 125 # endif
 126 #endif
 127
 128 /* FAST_FUNC is a qualifier which (possibly) makes function call faster
 129  * and/or smaller by using modified ABI. It is usually only needed
 130  * on non-static, busybox internal functions. Recent versions of gcc
 131  * optimize statics automatically. FAST_FUNC on static is required
 132  * only if you need to match a function pointer's type */
 133 #if __GNUC_PREREQ(3,0) && defined(i386) /* || defined(__x86_64__)? */
 134 /* stdcall makes callee to pop arguments from stack, not caller */
 135 # define FAST_FUNC __attribute__((regparm(3),stdcall))
 136 /* #elif ... - add your favorite arch today! */
 137 #else
 138 # define FAST_FUNC
 139 #endif
 140
 141 /* Make all declarations hidden (-fvisibility flag only affects definitions) */
 142 /* (don't include system headers after this until corresponding pop!) */
 143 #if __GNUC_PREREQ(4,1)
 144 # define PUSH_AND_SET_FUNCTION_VISIBILITY_TO_HIDDEN _Pragma("GCC visibility push(hidden)")
 145 # define POP_SAVED_FUNCTION_VISIBILITY              _Pragma("GCC visibility pop")
 146 #else
 147 # define PUSH_AND_SET_FUNCTION_VISIBILITY_TO_HIDDEN
 148 # define POP_SAVED_FUNCTION_VISIBILITY
 149 #endif
 150
 151 /* ---- Endian Detection ------------------------------------ */
 152
 153 #include <limits.h>
 154 #if defined(__digital__) && defined(__unix__)
 155 # include <sex.h>
 156 #elif defined(__FreeBSD__) || defined(__OpenBSD__) || defined(__NetBSD__) \
 157    || defined(__APPLE__)
 158 # include <sys/resource.h>      /* rlimit */
 159 # include <machine/endian.h>
 160 # define bswap_64 __bswap64
 161 # define bswap_32 __bswap32
 162 # define bswap_16 __bswap16
 163 #else
 164 # include <byteswap.h>
 165 # include <endian.h>
 166 #endif
 167
 168 #if defined(__BYTE_ORDER) && __BYTE_ORDER == __BIG_ENDIAN
 169 # define BB_BIG_ENDIAN 1
 170 # define BB_LITTLE_ENDIAN 0
 171 #elif defined(__BYTE_ORDER) && __BYTE_ORDER == __LITTLE_ENDIAN
 172 # define BB_BIG_ENDIAN 0
 173 # define BB_LITTLE_ENDIAN 1
 174 #elif defined(_BYTE_ORDER) && _BYTE_ORDER == _BIG_ENDIAN
 175 # define BB_BIG_ENDIAN 1
 176 # define BB_LITTLE_ENDIAN 0
 177 #elif defined(_BYTE_ORDER) && _BYTE_ORDER == _LITTLE_ENDIAN
 178 # define BB_BIG_ENDIAN 0
 179 # define BB_LITTLE_ENDIAN 1
 180 #elif defined(BYTE_ORDER) && BYTE_ORDER == BIG_ENDIAN
 181 # define BB_BIG_ENDIAN 1
 182 # define BB_LITTLE_ENDIAN 0
 183 #elif defined(BYTE_ORDER) && BYTE_ORDER == LITTLE_ENDIAN
 184 # define BB_BIG_ENDIAN 0
 185 # define BB_LITTLE_ENDIAN 1
 186 #elif defined(__386__)
 187 # define BB_BIG_ENDIAN 0
 188 # define BB_LITTLE_ENDIAN 1
 189 #else
 190 # error "Can't determine endianness"
 191 #endif
 192
 193 #if ULONG_MAX > 0xffffffff
 194 # define bb_bswap_64(x) bswap_64(x)
 195 #endif
 196
 197 /* SWAP_LEnn means "convert CPU<->little_endian by swapping bytes" */
 198 #if BB_BIG_ENDIAN
 199 # define SWAP_BE16(x) (x)
 200 # define SWAP_BE32(x) (x)
 201 # define SWAP_BE64(x) (x)
 202 # define SWAP_LE16(x) bswap_16(x)
 203 # define SWAP_LE32(x) bswap_32(x)
 204 # define SWAP_LE64(x) bb_bswap_64(x)
 205 # define IF_BIG_ENDIAN(...) __VA_ARGS__
 206 # define IF_LITTLE_ENDIAN(...)
 207 #else
 208 # define SWAP_BE16(x) bswap_16(x)
 209 # define SWAP_BE32(x) bswap_32(x)
 210 # define SWAP_BE64(x) bb_bswap_64(x)
 211 # define SWAP_LE16(x) (x)
 212 # define SWAP_LE32(x) (x)
 213 # define SWAP_LE64(x) (x)
 214 # define IF_BIG_ENDIAN(...)
 215 # define IF_LITTLE_ENDIAN(...) __VA_ARGS__
 216 #endif
 217
 218 /* ---- Unaligned access ------------------------------------ */
 219
 220 /* NB: unaligned parameter should be a pointer, aligned one -
 221  * a lvalue. This makes it more likely to not swap them by mistake
 222  */
 223 #if defined(i386) || defined(__x86_64__) || defined(__powerpc__)
 224 # include <stdint.h>
 225 typedef int      bb__aliased_int      FIX_ALIASING;
 226 typedef uint16_t bb__aliased_uint16_t FIX_ALIASING;
 227 typedef uint32_t bb__aliased_uint32_t FIX_ALIASING;
 228 # define move_from_unaligned_int(v, intp) ((v) = *(bb__aliased_int*)(intp))
 229 # define move_from_unaligned16(v, u16p) ((v) = *(bb__aliased_uint16_t*)(u16p))
 230 # define move_from_unaligned32(v, u32p) ((v) = *(bb__aliased_uint32_t*)(u32p))
 231 # define move_to_unaligned16(u16p, v)   (*(bb__aliased_uint16_t*)(u16p) = (v))
 232 # define move_to_unaligned32(u32p, v)   (*(bb__aliased_uint32_t*)(u32p) = (v))
 233 /* #elif ... - add your favorite arch today! */
 234 #else
 235 /* performs reasonably well (gcc usually inlines memcpy here) */
 236 # define move_from_unaligned_int(v, intp) (memcpy(&(v), (intp), sizeof(int)))
 237 # define move_from_unaligned16(v, u16p) (memcpy(&(v), (u16p), 2))
 238 # define move_from_unaligned32(v, u32p) (memcpy(&(v), (u32p), 4))
 239 # define move_to_unaligned16(u16p, v) do { \
 240         uint16_t __t = (v); \
 241         memcpy((u16p), &__t, 4); \
 242 } while (0)
 243 # define move_to_unaligned32(u32p, v) do { \
 244         uint32_t __t = (v); \
 245         memcpy((u32p), &__t, 4); \
 246 } while (0)
 247 #endif
 248
 249 /* ---- Compiler dependent settings ------------------------- */
 250
 251 #if (defined __digital__ && defined __unix__) \
 252  || defined __APPLE__ \
 253  || defined __FreeBSD__ || defined __OpenBSD__ || defined __NetBSD__
 254 # undef HAVE_MNTENT_H
 255 # undef HAVE_SYS_STATFS_H
 256 #else
 257 # define HAVE_MNTENT_H 1
 258 # define HAVE_SYS_STATFS_H 1
 259 #endif
 260
 261 /*----- Kernel versioning ------------------------------------*/
 262
 263 #define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))
 264
 265 /* ---- Miscellaneous --------------------------------------- */
 266
 267 #if defined __GLIBC__ || defined __UCLIBC__ \
 268  || defined __dietlibc__ || defined _NEWLIB_VERSION
 269 # include <features.h>
 270 #endif
 271
 272 /* Size-saving "small" ints (arch-dependent) */
 273 #if defined(i386) || defined(__x86_64__) || defined(__mips__) || defined(__cris__)
 274 /* add other arches which benefit from this... */
 275 typedef signed char smallint;
 276 typedef unsigned char smalluint;
 277 #else
 278 /* for arches where byte accesses generate larger code: */
 279 typedef int smallint;
 280 typedef unsigned smalluint;
 281 #endif
 282
 283 /* ISO C Standard:  7.16  Boolean type and values  <stdbool.h> */
 284 #if (defined __digital__ && defined __unix__)
 285 /* old system without (proper) C99 support */
 286 # define bool smalluint
 287 #else
 288 /* modern system, so use it */
 289 # include <stdbool.h>
 290 #endif
 291
 292 /* Try to defeat gcc's alignment of "char message[]"-like data */
 293 #if 1 /* if needed: !defined(arch1) && !defined(arch2) */
 294 # define ALIGN1 __attribute__((aligned(1)))
 295 # define ALIGN2 __attribute__((aligned(2)))
 296 # define ALIGN4 __attribute__((aligned(4)))
 297 #else
 298 /* Arches which MUST have 2 or 4 byte alignment for everything are here */
 299 # define ALIGN1
 300 # define ALIGN2
 301 # define ALIGN4
 302 #endif
 303
 304
 305 /* uclibc does not implement daemon() for no-mmu systems.
 306  * For 0.9.29 and svn, __ARCH_USE_MMU__ indicates no-mmu reliably.
 307  * For earlier versions there is no reliable way to check if we are building
 308  * for a mmu-less system.
 309  */
 310 #if ENABLE_NOMMU || \
 311     (defined __UCLIBC__ && __UCLIBC_MAJOR__ >= 0 && __UCLIBC_MINOR__ >= 9 && \
 312     __UCLIBC_SUBLEVEL__ > 28 && !defined __ARCH_USE_MMU__)
 313 # define BB_MMU 0
 314 # define USE_FOR_NOMMU(...) __VA_ARGS__
 315 # define USE_FOR_MMU(...)
 316 #else
 317 # define BB_MMU 1
 318 # define USE_FOR_NOMMU(...)
 319 # define USE_FOR_MMU(...) __VA_ARGS__
 320 #endif
 321
 322 /* Don't use lchown with glibc older than 2.1.x */
 323 #if defined(__GLIBC__) && __GLIBC__ <= 2 && __GLIBC_MINOR__ < 1
 324 # define lchown chown
 325 #endif
 326
 327 #if defined(__digital__) && defined(__unix__)
 328
 329 # include <standards.h>
 330 # include <inttypes.h>
 331 # define PRIu32 "u"
 332 /* use legacy setpgrp(pid_t,pid_t) for now.  move to platform.c */
 333 # define bb_setpgrp() do { pid_t __me = getpid(); setpgrp(__me, __me); } while (0)
 334 # if !defined ADJ_OFFSET_SINGLESHOT && defined MOD_CLKA && defined MOD_OFFSET
 335 #  define ADJ_OFFSET_SINGLESHOT (MOD_CLKA | MOD_OFFSET)
 336 # endif
 337 # if !defined ADJ_FREQUENCY && defined MOD_FREQUENCY
 338 #  define ADJ_FREQUENCY MOD_FREQUENCY
 339 # endif
 340 # if !defined ADJ_TIMECONST && defined MOD_TIMECONST
 341 #  define ADJ_TIMECONST MOD_TIMECONST
 342 # endif
 343 # if !defined ADJ_TICK && defined MOD_CLKB
 344 #  define ADJ_TICK MOD_CLKB
 345 # endif
 346
 347 #else
 348
 349 # define bb_setpgrp() setpgrp()
 350
 351 #endif
 352
 353 #if defined(__GLIBC__)
 354 # define fdprintf dprintf
 355 #endif
 356
 357 #if defined(__dietlibc__)
 358 # undef HAVE_STRCHRNUL
 359 #endif
 360
 361 #if defined(__WATCOMC__)
 362 # undef HAVE_FDPRINTF
 363 # undef HAVE_MEMRCHR
 364 # undef HAVE_MKDTEMP
 365 # undef HAVE_SETBIT
 366 # undef HAVE_STRCASESTR
 367 # undef HAVE_STRCHRNUL
 368 # undef HAVE_STRSEP
 369 # undef HAVE_STRSIGNAL
 370 # undef HAVE_VASPRINTF
 371 #endif
 372
 373 #if defined(__FreeBSD__)
 374 # undef HAVE_STRCHRNUL
 375 #endif
 376
 377 /*
 378  * Now, define prototypes for all the functions defined in platform.c
 379  * These must come after all the HAVE_* macros are defined (or not)
 380  */
 381
 382 #ifndef HAVE_FDPRINTF
 383 extern int fdprintf(int fd, const char *format, ...);
 384 #endif
 385
 386 #ifndef HAVE_MEMRCHR
 387 extern void *memrchr(const void *s, int c, size_t n) FAST_FUNC;
 388 #endif
 389
 390 #ifndef HAVE_MKDTEMP
 391 extern char *mkdtemp(char *template) FAST_FUNC;
 392 #endif
 393
 394 #ifndef HAVE_SETBIT
 395 # define setbit(a, b)  ((a)[(b) >> 3] |= 1 << ((b) & 7))
 396 # define clrbit(a, b)  ((a)[(b) >> 3] &= ~(1 << ((b) & 7)))
 397 #endif
 398
 399 #ifndef HAVE_STRCASESTR
 400 extern char *strcasestr(const char *s, const char *pattern) FAST_FUNC;
 401 #endif
 402
 403 #ifndef HAVE_STRCHRNUL
 404 extern char *strchrnul(const char *s, int c) FAST_FUNC;
 405 #endif
 406
 407 #ifndef HAVE_STRSEP
 408 extern char *strsep(char **stringp, const char *delim) FAST_FUNC;
 409 #endif
 410
 411 #ifndef HAVE_STRSIGNAL
 412 /* Not exactly the same: instead of "Stopped" it shows "STOP" etc */
 413 # define strsignal(sig) get_signame(sig)
 414 #endif
 415
 416 #ifndef HAVE_VASPRINTF
 417 extern int vasprintf(char **string_ptr, const char *format, va_list p) FAST_FUNC;
 418 #endif
 419
 420 #endif