1// SPDX-License-Identifier: GPL-2.0-or-later 2/* 3 * Copyright (c) 2016 Cyril Hrubis <chrubis@suse.cz> 4 * Copyright (c) 2013 Stanislav Kholmanskikh <stanislav.kholmanskikh@oracle.com> 5 * Copyright (c) 2010 Ngie Cooper <yaneurabeya@gmail.com> 6 * Copyright (c) 2008 Mike Frysinger <vapier@gmail.com> 7 */ 8 9#ifndef TST_COMMON_H__ 10#define TST_COMMON_H__ 11 12#define LTP_ATTRIBUTE_NORETURN __attribute__((noreturn)) 13#define LTP_ATTRIBUTE_UNUSED __attribute__((unused)) 14#define LTP_ATTRIBUTE_UNUSED_RESULT __attribute__((warn_unused_result)) 15 16#ifndef ARRAY_SIZE 17# define ARRAY_SIZE(arr) (sizeof(arr) / sizeof((arr)[0])) 18#endif 19 20/* Round x to the next multiple of a. 21 * a should be a power of 2. 22 */ 23#define LTP_ALIGN(x, a) __LTP_ALIGN_MASK(x, (typeof(x))(a) - 1) 24#define __LTP_ALIGN_MASK(x, mask) (((x) + (mask)) & ~(mask)) 25 26/** 27 * TST_RETRY_FUNC() - Repeatedly retry a function with an increasing delay. 28 * @FUNC - The function which will be retried 29 * @ECHCK - Function/macro for validating @FUNC return value 30 * 31 * This macro will call @FUNC in a loop with a delay between retries. 32 * If ECHCK(ret) evaluates to non-zero, the loop ends. The delay between 33 * retries starts at one microsecond and is then doubled each iteration until 34 * it exceeds one second (the total time sleeping will be approximately one 35 * second as well). When the delay exceeds one second, the loop will end. 36 * The TST_RETRY_FUNC() macro returns the last value returned by @FUNC. 37 */ 38#define TST_RETRY_FUNC(FUNC, ECHCK) \ 39 TST_RETRY_FN_EXP_BACKOFF(FUNC, ECHCK, 1) 40 41#define TST_RETRY_FN_EXP_BACKOFF(FUNC, ECHCK, MAX_DELAY) \ 42({ unsigned int tst_delay_, tst_max_delay_; \ 43 typeof(FUNC) tst_ret_; \ 44 tst_delay_ = 1; \ 45 tst_max_delay_ = tst_multiply_timeout(MAX_DELAY * 1000000); \ 46 for (;;) { \ 47 errno = 0; \ 48 tst_ret_ = FUNC; \ 49 if (ECHCK(tst_ret_)) \ 50 break; \ 51 if (tst_delay_ < tst_max_delay_) { \ 52 usleep(tst_delay_); \ 53 tst_delay_ *= 2; \ 54 } else { \ 55 break; \ 56 } \ 57 } \ 58 tst_ret_; \ 59}) 60 61/* 62 * Return value validation macros for TST_RETRY_FUNC(): 63 * TST_RETVAL_EQ0() - Check that value is equal to zero 64 */ 65#define TST_RETVAL_EQ0(x) (!(x)) 66 67/* 68 * TST_RETVAL_NOTNULL() - Check that value is not equal to zero/NULL 69 */ 70#define TST_RETVAL_NOTNULL(x) (!!(x)) 71 72/* 73 * TST_RETVAL_GE0() - Check that value is greater than or equal to zero 74 */ 75#define TST_RETVAL_GE0(x) ((x) >= 0) 76 77#define TST_BUILD_BUG_ON(condition) \ 78 do { ((void)sizeof(char[1 - 2 * !!(condition)])); } while (0) 79 80#define TST_BRK_SUPPORTS_ONLY_TCONF_TBROK(condition) \ 81 TST_BUILD_BUG_ON(condition) 82 83#define TST_RES_SUPPORTS_TCONF_TFAIL_TINFO_TPASS_TWARN(condition) \ 84 TST_BUILD_BUG_ON(condition) 85 86/* stringification */ 87#define TST_TO_STR_(s) #s 88#define TST_TO_STR(s) TST_TO_STR_(s) 89 90#endif /* TST_COMMON_H__ */ 91