hotfix: a better hinting on non-returning spin function
[lunaix-os.git] / lunaix-os / includes / lunaix / spike.h
1 #ifndef __LUNAIX_SPIKE_H
2 #define __LUNAIX_SPIKE_H
3
4 #include <lunaix/compiler.h>
5
6 /** Some helper functions. As helpful as Spike the Dragon! :) **/
7
8 // 除法 v/(2^k) 向上取整
9 #define CEIL(v, k) (((v) + (1 << (k)) - 1) >> (k))
10
11 #define ICEIL(x, y) ((x) / (y) + ((x) % (y) != 0))
12
13 // 除法 v/(2^k) 向下取整
14 #define FLOOR(v, k) ((v) >> (k))
15
16 // 获取v最近的最大k倍数 (k=2^n)
17 #define ROUNDUP(v, k) (((v) + (k)-1) & ~((k)-1))
18
19 // 获取v最近的最小k倍数 (k=2^m)
20 #define ROUNDDOWN(v, k) ((v) & ~((k)-1))
21
22 #define MIN(a, b) ((a) < (b) ? (a) : (b))
23 #define MAX(a, b) ((a) > (b) ? (a) : (b))
24
25 /**
26  * @brief Fast log base 2 for integer, utilizing constant unfolding.
27  * Adopted from
28  * https://elixir.bootlin.com/linux/v4.4/source/include/linux/log2.h#L85
29  *
30  */
31 #define ILOG2(x)                                                               \
32     (__builtin_constant_p(x) ? ((x) == 0              ? 0                      \
33                                 : ((x) & (1ul << 31)) ? 31                     \
34                                 : ((x) & (1ul << 30)) ? 30                     \
35                                 : ((x) & (1ul << 29)) ? 29                     \
36                                 : ((x) & (1ul << 28)) ? 28                     \
37                                 : ((x) & (1ul << 27)) ? 27                     \
38                                 : ((x) & (1ul << 26)) ? 26                     \
39                                 : ((x) & (1ul << 25)) ? 25                     \
40                                 : ((x) & (1ul << 24)) ? 24                     \
41                                 : ((x) & (1ul << 23)) ? 23                     \
42                                 : ((x) & (1ul << 22)) ? 22                     \
43                                 : ((x) & (1ul << 21)) ? 21                     \
44                                 : ((x) & (1ul << 20)) ? 20                     \
45                                 : ((x) & (1ul << 19)) ? 19                     \
46                                 : ((x) & (1ul << 18)) ? 18                     \
47                                 : ((x) & (1ul << 17)) ? 17                     \
48                                 : ((x) & (1ul << 16)) ? 16                     \
49                                 : ((x) & (1ul << 15)) ? 15                     \
50                                 : ((x) & (1ul << 14)) ? 14                     \
51                                 : ((x) & (1ul << 13)) ? 13                     \
52                                 : ((x) & (1ul << 12)) ? 12                     \
53                                 : ((x) & (1ul << 11)) ? 11                     \
54                                 : ((x) & (1ul << 10)) ? 10                     \
55                                 : ((x) & (1ul << 9))  ? 9                      \
56                                 : ((x) & (1ul << 8))  ? 8                      \
57                                 : ((x) & (1ul << 7))  ? 7                      \
58                                 : ((x) & (1ul << 6))  ? 6                      \
59                                 : ((x) & (1ul << 5))  ? 5                      \
60                                 : ((x) & (1ul << 4))  ? 4                      \
61                                 : ((x) & (1ul << 3))  ? 3                      \
62                                 : ((x) & (1ul << 2))  ? 2                      \
63                                 : ((x) & (1ul << 1))  ? 1                      \
64                                                       : 0)                      \
65                              : (31 - __builtin_clz(x)))
66
67 inline static void noret
68 spin()
69 {
70     volatile int __infloop = 1;
71     while (__infloop)
72         ;
73     __builtin_unreachable();
74 }
75
76 #ifndef __LUNAIXOS_NASSERT__
77 #define assert(cond)                                                           \
78     if (!(cond)) {                                                             \
79         __assert_fail(#cond, __FILE__, __LINE__);                              \
80     }
81
82 #define assert_msg(cond, msg)                                                  \
83     if (!(cond)) {                                                             \
84         __assert_fail(msg, __FILE__, __LINE__);                                \
85     }
86
87 #define fail(msg) __assert_fail(msg, __FILE__, __LINE__);
88
89 void
90 __assert_fail(const char* expr, const char* file, unsigned int line)
91   __attribute__((noinline, noreturn));
92 #else
93 #define assert(cond) (void)(cond);          // assert nothing
94 #define assert_msg(cond, msg) (void)(cond); // assert nothing
95
96 #endif // __LUNAIXOS_NASSERT__
97
98 void noret
99 panick(const char* msg);
100
101 void noret
102 panickf(const char* fmt, ...);
103
104 #define wait_until(cond)                                                       \
105     while (!(cond))                                                            \
106         ;
107 #define loop_until(cond)                                                       \
108     while (!(cond))                                                            \
109         ;
110
111 #define wait_until_expire(cond, max)                                           \
112     ({                                                                         \
113         unsigned int __wcounter__ = (max);                                     \
114         while (!(cond) && __wcounter__-- > 1)                                  \
115             ;                                                                  \
116         __wcounter__;                                                          \
117     })
118
119 #endif /* __LUNAIX_SPIKE_H */