1 /* 2 * Copyright (c) 2016-2017, ARM Limited and Contributors. All rights reserved. 3 * 4 * SPDX-License-Identifier: BSD-3-Clause 5 */ 6 7 #ifndef __UTILS_DEF_H__ 8 #define __UTILS_DEF_H__ 9 10 /* Compute the number of elements in the given array */ 11 #define ARRAY_SIZE(a) \ 12 (sizeof(a) / sizeof((a)[0])) 13 14 #define IS_POWER_OF_TWO(x) \ 15 (((x) & ((x) - 1)) == 0) 16 17 #define SIZE_FROM_LOG2_WORDS(n) (4 << (n)) 18 19 #define BIT(nr) (1UL << (nr)) 20 21 #define MIN(x, y) __extension__ ({ \ 22 __typeof__(x) _x = (x); \ 23 __typeof__(y) _y = (y); \ 24 (void)(&_x == &_y); \ 25 _x < _y ? _x : _y; \ 26 }) 27 28 #define MAX(x, y) __extension__ ({ \ 29 __typeof__(x) _x = (x); \ 30 __typeof__(y) _y = (y); \ 31 (void)(&_x == &_y); \ 32 _x > _y ? _x : _y; \ 33 }) 34 35 /* 36 * The round_up() macro rounds up a value to the given boundary in a 37 * type-agnostic yet type-safe manner. The boundary must be a power of two. 38 * In other words, it computes the smallest multiple of boundary which is 39 * greater than or equal to value. 40 * 41 * round_down() is similar but rounds the value down instead. 42 */ 43 #define round_boundary(value, boundary) \ 44 ((__typeof__(value))((boundary) - 1)) 45 46 #define round_up(value, boundary) \ 47 ((((value) - 1) | round_boundary(value, boundary)) + 1) 48 49 #define round_down(value, boundary) \ 50 ((value) & ~round_boundary(value, boundary)) 51 52 /* 53 * Evaluates to 1 if (ptr + inc) overflows, 0 otherwise. 54 * Both arguments must be unsigned pointer values (i.e. uintptr_t). 55 */ 56 #define check_uptr_overflow(ptr, inc) \ 57 (((ptr) > UINTPTR_MAX - (inc)) ? 1 : 0) 58 59 /* 60 * For those constants to be shared between C and other sources, apply a 'ull' 61 * suffix to the argument only in C, to avoid undefined or unintended behaviour. 62 * 63 * The GNU assembler and linker do not support the 'ull' suffix (it causes the 64 * build process to fail) therefore the suffix is omitted when used in linker 65 * scripts and assembler files. 66 */ 67 #if defined(__LINKER__) || defined(__ASSEMBLY__) 68 # define ULL(_x) (_x) 69 #else 70 # define ULL(_x) (_x##ull) 71 #endif 72 73 #endif /* __UTILS_DEF_H__ */ 74