kernel.h revision 1.36 1 1.36 riastrad /* $NetBSD: kernel.h,v 1.36 2021/12/19 01:39:12 riastradh Exp $ */
2 1.1 skrll
3 1.1 skrll /*-
4 1.1 skrll * Copyright (c) 2013 The NetBSD Foundation, Inc.
5 1.1 skrll * All rights reserved.
6 1.1 skrll *
7 1.1 skrll * This code is derived from software contributed to The NetBSD Foundation
8 1.1 skrll * by Taylor R. Campbell.
9 1.1 skrll *
10 1.1 skrll * Redistribution and use in source and binary forms, with or without
11 1.1 skrll * modification, are permitted provided that the following conditions
12 1.1 skrll * are met:
13 1.1 skrll * 1. Redistributions of source code must retain the above copyright
14 1.1 skrll * notice, this list of conditions and the following disclaimer.
15 1.1 skrll * 2. Redistributions in binary form must reproduce the above copyright
16 1.1 skrll * notice, this list of conditions and the following disclaimer in the
17 1.1 skrll * documentation and/or other materials provided with the distribution.
18 1.1 skrll *
19 1.1 skrll * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 1.1 skrll * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 1.1 skrll * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 1.1 skrll * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 1.1 skrll * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 1.1 skrll * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 1.1 skrll * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 1.1 skrll * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 1.1 skrll * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 1.1 skrll * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 1.1 skrll * POSSIBILITY OF SUCH DAMAGE.
30 1.1 skrll */
31 1.1 skrll
32 1.1 skrll #ifndef _LINUX_KERNEL_H_
33 1.1 skrll #define _LINUX_KERNEL_H_
34 1.1 skrll
35 1.1 skrll #include <sys/cdefs.h>
36 1.1 skrll #include <sys/types.h>
37 1.1 skrll #include <sys/param.h>
38 1.3 riastrad #include <sys/systm.h>
39 1.26 jmcneill #include <sys/endian.h>
40 1.3 riastrad
41 1.7 riastrad #include <lib/libkern/libkern.h>
42 1.25 maya
43 1.25 maya #include <asm/byteorder.h>
44 1.25 maya #include <asm/div64.h>
45 1.25 maya
46 1.13 riastrad #include <linux/bitops.h>
47 1.28 riastrad #include <linux/compiler.h>
48 1.25 maya #include <linux/log2.h>
49 1.10 riastrad #include <linux/printk.h>
50 1.14 riastrad #include <linux/slab.h>
51 1.7 riastrad
52 1.12 riastrad #define U16_MAX UINT16_MAX
53 1.12 riastrad #define U32_MAX UINT32_MAX
54 1.12 riastrad #define U64_MAX UINT64_MAX
55 1.12 riastrad
56 1.3 riastrad #define oops_in_progress (panicstr != NULL)
57 1.3 riastrad
58 1.26 jmcneill #if BYTE_ORDER == BIG_ENDIAN
59 1.26 jmcneill #define __BIG_ENDIAN _BIG_ENDIAN
60 1.26 jmcneill #else
61 1.26 jmcneill #define __LITTLE_ENDIAN _LITTLE_ENDIAN
62 1.26 jmcneill #endif
63 1.26 jmcneill
64 1.27 riastrad #define IS_BUILTIN(option) (1) /* Probably... */
65 1.8 skrll #define IS_ENABLED(option) (option)
66 1.27 riastrad #define IS_REACHABLE(option) (option)
67 1.1 skrll
68 1.1 skrll #define __printf __printflike
69 1.1 skrll #define __user
70 1.21 riastrad #if __GNUC_PREREQ__(4,0) /* not sure when but this will work */
71 1.21 riastrad #define __must_check __attribute__((warn_unused_result))
72 1.21 riastrad #else
73 1.21 riastrad #define __must_check /* nothing */
74 1.21 riastrad #endif
75 1.1 skrll #define __always_unused __unused
76 1.36 riastrad #define __maybe_unused __unused
77 1.18 riastrad #define noinline __noinline
78 1.34 riastrad #define __deprecated /* nothing */
79 1.1 skrll
80 1.1 skrll #define barrier() __insn_barrier()
81 1.3 riastrad #define likely(X) __predict_true(X)
82 1.1 skrll #define unlikely(X) __predict_false(X)
83 1.1 skrll
84 1.35 riastrad #define might_sleep ASSERT_SLEEPABLE
85 1.35 riastrad
86 1.2 riastrad /*
87 1.2 riastrad * XXX Linux kludge to work around GCC uninitialized variable warning.
88 1.2 riastrad * Linux does `x = x', which is bollocks.
89 1.2 riastrad */
90 1.2 riastrad #define uninitialized_var(x) x = 0
91 1.1 skrll
92 1.36 riastrad #define typecheck(T, X) ({(1 + 0*sizeof((T *)0 - &(X)));})
93 1.36 riastrad
94 1.1 skrll /* XXX These will multiply evaluate their arguments. */
95 1.9 riastrad #define min(X, Y) MIN(X, Y)
96 1.9 riastrad #define max(X, Y) MAX(X, Y)
97 1.9 riastrad
98 1.29 riastrad #define max_t(T, X, Y) MAX((T)(X), (T)(Y))
99 1.29 riastrad #define min_t(T, X, Y) MIN((T)(X), (T)(Y))
100 1.1 skrll
101 1.3 riastrad #define clamp_t(T, X, MIN, MAX) min_t(T, max_t(T, X, MIN), MAX)
102 1.6 riastrad #define clamp(X, MN, MX) MIN(MAX(X, MN), MX)
103 1.30 riastrad #define clamp_val(X, MIN, MAX) clamp_t(typeof(X), X, MIN, MAX)
104 1.3 riastrad
105 1.16 riastrad #define min3(X, Y, Z) MIN(X, MIN(Y, Z))
106 1.16 riastrad #define max3(X, Y, Z) MAX(X, MAX(Y, Z))
107 1.16 riastrad
108 1.1 skrll /*
109 1.2 riastrad * Rounding to nearest.
110 1.2 riastrad */
111 1.2 riastrad #define DIV_ROUND_CLOSEST(N, D) \
112 1.2 riastrad ((0 < (N)) ? (((N) + ((D) / 2)) / (D)) \
113 1.2 riastrad : (((N) - ((D) / 2)) / (D)))
114 1.2 riastrad
115 1.17 riastrad #define DIV_ROUND_CLOSEST_ULL(N, D) (((N) + (D)/2)/(D))
116 1.17 riastrad
117 1.2 riastrad /*
118 1.1 skrll * Rounding to what may or may not be powers of two.
119 1.1 skrll */
120 1.1 skrll #define DIV_ROUND_UP(X, N) (((X) + (N) - 1) / (N))
121 1.3 riastrad #define DIV_ROUND_UP_ULL(X, N) DIV_ROUND_UP((unsigned long long)(X), (N))
122 1.1 skrll
123 1.33 riastrad #define DIV_ROUND_DOWN_ULL(X,N) ((unsigned long long)(X) / (N))
124 1.33 riastrad
125 1.1 skrll /*
126 1.1 skrll * Rounding to powers of two -- carefully avoiding multiple evaluation
127 1.1 skrll * of arguments and pitfalls with C integer arithmetic rules.
128 1.1 skrll */
129 1.1 skrll #define round_up(X, N) ((((X) - 1) | ((N) - 1)) + 1)
130 1.1 skrll #define round_down(X, N) ((X) & ~(uintmax_t)((N) - 1))
131 1.1 skrll
132 1.4 riastrad #define IS_ALIGNED(X, N) (((X) & ((N) - 1)) == 0)
133 1.4 riastrad
134 1.1 skrll /*
135 1.1 skrll * These select 32-bit halves of what may be 32- or 64-bit quantities,
136 1.1 skrll * for which straight 32-bit shifts may be undefined behaviour (and do
137 1.1 skrll * the wrong thing on most machines: return the input unshifted by
138 1.1 skrll * ignoring the upper bits of the shift count).
139 1.1 skrll */
140 1.1 skrll #define upper_32_bits(X) ((uint32_t) (((X) >> 16) >> 16))
141 1.1 skrll #define lower_32_bits(X) ((uint32_t) ((X) & 0xffffffffUL))
142 1.1 skrll
143 1.1 skrll #define ARRAY_SIZE(ARRAY) __arraycount(ARRAY)
144 1.1 skrll
145 1.1 skrll #define swap(X, Y) do \
146 1.1 skrll { \
147 1.1 skrll /* XXX Kludge for type-safety. */ \
148 1.1 skrll if (&(X) != &(Y)) { \
149 1.1 skrll CTASSERT(sizeof(X) == sizeof(Y)); \
150 1.1 skrll /* XXX Can't do this much better without typeof. */ \
151 1.1 skrll char __swap_tmp[sizeof(X)]; \
152 1.1 skrll (void)memcpy(__swap_tmp, &(X), sizeof(X)); \
153 1.1 skrll (void)memcpy(&(X), &(Y), sizeof(X)); \
154 1.1 skrll (void)memcpy(&(Y), __swap_tmp, sizeof(X)); \
155 1.1 skrll } \
156 1.1 skrll } while (0)
157 1.1 skrll
158 1.23 christos static __inline int64_t
159 1.1 skrll abs64(int64_t x)
160 1.1 skrll {
161 1.1 skrll return (x < 0? (-x) : x);
162 1.1 skrll }
163 1.1 skrll
164 1.23 christos static __inline uintmax_t
165 1.3 riastrad mult_frac(uintmax_t x, uintmax_t multiplier, uintmax_t divisor)
166 1.3 riastrad {
167 1.3 riastrad uintmax_t q = (x / divisor);
168 1.3 riastrad uintmax_t r = (x % divisor);
169 1.3 riastrad
170 1.3 riastrad return ((q * multiplier) + ((r * multiplier) / divisor));
171 1.3 riastrad }
172 1.3 riastrad
173 1.2 riastrad static int panic_timeout __unused = 0;
174 1.2 riastrad
175 1.23 christos static __inline int __printflike(3, 0)
176 1.3 riastrad vscnprintf(char *buf, size_t size, const char *fmt, va_list va)
177 1.3 riastrad {
178 1.3 riastrad int ret;
179 1.3 riastrad
180 1.3 riastrad ret = vsnprintf(buf, size, fmt, va);
181 1.3 riastrad if (__predict_false(ret < 0))
182 1.3 riastrad return ret;
183 1.3 riastrad if (__predict_false(size == 0))
184 1.3 riastrad return 0;
185 1.22 mrg if (__predict_false(size <= (size_t)ret))
186 1.3 riastrad return (size - 1);
187 1.3 riastrad
188 1.3 riastrad return ret;
189 1.3 riastrad }
190 1.3 riastrad
191 1.23 christos static __inline int __printflike(3, 4)
192 1.3 riastrad scnprintf(char *buf, size_t size, const char *fmt, ...)
193 1.3 riastrad {
194 1.3 riastrad va_list va;
195 1.3 riastrad int ret;
196 1.3 riastrad
197 1.3 riastrad va_start(va, fmt);
198 1.3 riastrad ret = vscnprintf(buf, size, fmt, va);
199 1.3 riastrad va_end(va);
200 1.3 riastrad
201 1.3 riastrad return ret;
202 1.3 riastrad }
203 1.3 riastrad
204 1.23 christos static __inline int
205 1.5 riastrad kstrtol(const char *s, unsigned base, long *vp)
206 1.5 riastrad {
207 1.5 riastrad long long v;
208 1.5 riastrad
209 1.5 riastrad v = strtoll(s, NULL, base);
210 1.5 riastrad if (v < LONG_MIN || LONG_MAX < v)
211 1.5 riastrad return -ERANGE;
212 1.5 riastrad *vp = v;
213 1.5 riastrad return 0;
214 1.5 riastrad }
215 1.5 riastrad
216 1.24 riastrad static inline long
217 1.24 riastrad simple_strtol(const char *s, char **endp, unsigned base)
218 1.24 riastrad {
219 1.24 riastrad long v;
220 1.24 riastrad
221 1.24 riastrad *endp = NULL; /* paranoia */
222 1.24 riastrad v = strtoll(s, endp, base);
223 1.24 riastrad if (v < LONG_MIN || LONG_MAX < v)
224 1.24 riastrad return 0;
225 1.24 riastrad return v;
226 1.24 riastrad }
227 1.24 riastrad
228 1.23 christos static __inline char * __printflike(2, 0)
229 1.15 riastrad kvasprintf(gfp_t gfp, const char *fmt, va_list va)
230 1.14 riastrad {
231 1.20 riastrad va_list tva;
232 1.14 riastrad char *str;
233 1.14 riastrad int len, len1 __diagused;
234 1.14 riastrad
235 1.20 riastrad va_copy(tva, va);
236 1.20 riastrad len = vsnprintf(NULL, 0, fmt, tva);
237 1.20 riastrad va_end(tva);
238 1.14 riastrad str = kmalloc(len + 1, gfp);
239 1.14 riastrad if (str == NULL)
240 1.14 riastrad return NULL;
241 1.15 riastrad len1 = vsnprintf(str, len + 1, fmt, va);
242 1.15 riastrad KASSERT(len1 == len);
243 1.15 riastrad
244 1.15 riastrad return str;
245 1.15 riastrad }
246 1.15 riastrad
247 1.23 christos static __inline char * __printflike(2, 3)
248 1.15 riastrad kasprintf(gfp_t gfp, const char *fmt, ...)
249 1.15 riastrad {
250 1.15 riastrad va_list va;
251 1.15 riastrad char *str;
252 1.14 riastrad
253 1.14 riastrad va_start(va, fmt);
254 1.15 riastrad str = kvasprintf(gfp, fmt, va);
255 1.14 riastrad va_end(va);
256 1.14 riastrad
257 1.14 riastrad return str;
258 1.14 riastrad }
259 1.14 riastrad
260 1.32 riastrad static inline void __user *
261 1.32 riastrad u64_to_user_ptr(uint64_t addr)
262 1.32 riastrad {
263 1.32 riastrad
264 1.32 riastrad return (void __user *)(uintptr_t)addr;
265 1.32 riastrad }
266 1.32 riastrad
267 1.35 riastrad #define TAINT_MACHINE_CHECK 0
268 1.35 riastrad #define TAINT_WARN 1
269 1.35 riastrad
270 1.35 riastrad #define LOCKDEP_STILL_OK 0
271 1.35 riastrad
272 1.35 riastrad static inline void
273 1.35 riastrad add_taint(unsigned taint, int lockdep)
274 1.35 riastrad {
275 1.35 riastrad }
276 1.35 riastrad
277 1.1 skrll #endif /* _LINUX_KERNEL_H_ */
278