xref: /freebsd/sys/sys/libkern.h (revision 76f14217f6051df414e435c3388d3f4bb388cc22)
1 /*-
2  * SPDX-License-Identifier: BSD-3-Clause
3  *
4  * Copyright (c) 1992, 1993
5  *	The Regents of the University of California.  All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. Neither the name of the University nor the names of its contributors
16  *    may be used to endorse or promote products derived from this software
17  *    without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29  * SUCH DAMAGE.
30  */
31 
32 #ifndef _SYS_LIBKERN_H_
33 #define	_SYS_LIBKERN_H_
34 
35 #include <sys/types.h>
36 #ifdef _KERNEL
37 #include <sys/systm.h>
38 #endif
39 #include <sys/kassert.h>
40 
41 #ifndef	LIBKERN_INLINE
42 #define	LIBKERN_INLINE  static __inline
43 #define	LIBKERN_BODY
44 #endif
45 
46 /* BCD conversions. */
47 extern u_char const	bcd2bin_data[];
48 extern u_char const	bin2bcd_data[];
49 extern char const	hex2ascii_data[];
50 
51 #define	LIBKERN_LEN_BCD2BIN	154
52 #define	LIBKERN_LEN_BIN2BCD	100
53 #define	LIBKERN_LEN_HEX2ASCII	36
54 
55 static inline u_char
bcd2bin(int bcd)56 bcd2bin(int bcd)
57 {
58 
59 	KASSERT(bcd >= 0 && bcd < LIBKERN_LEN_BCD2BIN,
60 	    ("invalid bcd %d", bcd));
61 	return (bcd2bin_data[bcd]);
62 }
63 
64 static inline u_char
bin2bcd(int bin)65 bin2bcd(int bin)
66 {
67 
68 	KASSERT(bin >= 0 && bin < LIBKERN_LEN_BIN2BCD,
69 	    ("invalid bin %d", bin));
70 	return (bin2bcd_data[bin]);
71 }
72 
73 static inline char
hex2ascii(int hex)74 hex2ascii(int hex)
75 {
76 
77 	KASSERT(hex >= 0 && hex < LIBKERN_LEN_HEX2ASCII,
78 	    ("invalid hex %d", hex));
79 	return (hex2ascii_data[hex]);
80 }
81 
82 static inline bool
validbcd(int bcd)83 validbcd(int bcd)
84 {
85 
86 	return (bcd == 0 || (bcd > 0 && bcd <= 0x99 && bcd2bin_data[bcd] != 0));
87 }
imax(int a,int b)88 static __inline int imax(int a, int b) { return (a > b ? a : b); }
imin(int a,int b)89 static __inline int imin(int a, int b) { return (a < b ? a : b); }
lmax(long a,long b)90 static __inline long lmax(long a, long b) { return (a > b ? a : b); }
lmin(long a,long b)91 static __inline long lmin(long a, long b) { return (a < b ? a : b); }
max(u_int a,u_int b)92 static __inline u_int max(u_int a, u_int b) { return (a > b ? a : b); }
min(u_int a,u_int b)93 static __inline u_int min(u_int a, u_int b) { return (a < b ? a : b); }
qmax(quad_t a,quad_t b)94 static __inline quad_t qmax(quad_t a, quad_t b) { return (a > b ? a : b); }
qmin(quad_t a,quad_t b)95 static __inline quad_t qmin(quad_t a, quad_t b) { return (a < b ? a : b); }
uqmax(u_quad_t a,u_quad_t b)96 static __inline u_quad_t uqmax(u_quad_t a, u_quad_t b) { return (a > b ? a : b); }
uqmin(u_quad_t a,u_quad_t b)97 static __inline u_quad_t uqmin(u_quad_t a, u_quad_t b) { return (a < b ? a : b); }
ulmax(u_long a,u_long b)98 static __inline u_long ulmax(u_long a, u_long b) { return (a > b ? a : b); }
ulmin(u_long a,u_long b)99 static __inline u_long ulmin(u_long a, u_long b) { return (a < b ? a : b); }
ummax(__uintmax_t a,__uintmax_t b)100 static __inline __uintmax_t ummax(__uintmax_t a, __uintmax_t b)
101 {
102 
103 	return (a > b ? a : b);
104 }
ummin(__uintmax_t a,__uintmax_t b)105 static __inline __uintmax_t ummin(__uintmax_t a, __uintmax_t b)
106 {
107 
108 	return (a < b ? a : b);
109 }
omax(off_t a,off_t b)110 static __inline off_t omax(off_t a, off_t b) { return (a > b ? a : b); }
omin(off_t a,off_t b)111 static __inline off_t omin(off_t a, off_t b) { return (a < b ? a : b); }
abs(int a)112 static __inline int abs(int a) { return (a < 0 ? -a : a); }
labs(long a)113 static __inline long labs(long a) { return (a < 0 ? -a : a); }
abs64(int64_t a)114 static __inline int64_t abs64(int64_t a) { return (a < 0 ? -a : a); }
qabs(quad_t a)115 static __inline quad_t qabs(quad_t a) { return (a < 0 ? -a : a); }
116 
117 #ifndef RANDOM_FENESTRASX
118 #define	ARC4_ENTR_NONE	0	/* Don't have entropy yet. */
119 #define	ARC4_ENTR_HAVE	1	/* Have entropy. */
120 #define	ARC4_ENTR_SEED	2	/* Reseeding. */
121 extern int arc4rand_iniseed_state;
122 #endif
123 
124 /* Prototypes for non-quad routines. */
125 struct malloc_type;
126 uint32_t arc4random(void);
127 void	 arc4random_buf(void *, size_t);
128 uint32_t arc4random_uniform(uint32_t);
129 void	 arc4rand(void *, u_int, int);
130 int	 timingsafe_bcmp(const void *, const void *, size_t);
131 void	*bsearch(const void *, const void *, size_t,
132 	    size_t, int (*)(const void *, const void *));
133 
134 static __inline __pure2 int
ffs(int mask)135 ffs(int mask)
136 {
137 
138 	return (__builtin_ffs((u_int)mask));
139 }
140 
141 static __inline __pure2 int
ffsl(long mask)142 ffsl(long mask)
143 {
144 
145 	return (__builtin_ffsl((u_long)mask));
146 }
147 
148 static __inline __pure2 int
ffsll(long long mask)149 ffsll(long long mask)
150 {
151 
152 	return (__builtin_ffsll((unsigned long long)mask));
153 }
154 
155 static __inline __pure2 int
fls(int mask)156 fls(int mask)
157 {
158 
159 	return (mask == 0 ? 0 :
160 	    8 * sizeof(mask) - __builtin_clz((u_int)mask));
161 }
162 
163 static __inline __pure2 int
flsl(long mask)164 flsl(long mask)
165 {
166 
167 	return (mask == 0 ? 0 :
168 	    8 * sizeof(mask) - __builtin_clzl((u_long)mask));
169 }
170 
171 static __inline __pure2 int
flsll(long long mask)172 flsll(long long mask)
173 {
174 
175 	return (mask == 0 ? 0 :
176 	    8 * sizeof(mask) - __builtin_clzll((unsigned long long)mask));
177 }
178 
179 static __inline __pure2 int
ilog2_int(int n)180 ilog2_int(int n)
181 {
182 
183 	KASSERT(n != 0, ("ilog argument must be nonzero"));
184 	return (8 * sizeof(n) - 1 - __builtin_clz((u_int)n));
185 }
186 
187 static __inline __pure2 int
ilog2_long(long n)188 ilog2_long(long n)
189 {
190 
191 	KASSERT(n != 0, ("ilog argument must be nonzero"));
192 	return (8 * sizeof(n) - 1 - __builtin_clzl((u_long)n));
193 }
194 
195 static __inline __pure2 int
ilog2_long_long(long long n)196 ilog2_long_long(long long n)
197 {
198 
199 	KASSERT(n != 0, ("ilog argument must be nonzero"));
200 	return (8 * sizeof(n) - 1 -
201 	    __builtin_clzll((unsigned long long)n));
202 }
203 
204 #define ilog2_var(n)				\
205 	_Generic((n),				\
206 	    default: ilog2_int,			\
207 	    long: ilog2_long,			\
208 	    unsigned long: ilog2_long,		\
209 	    long long: ilog2_long_long,		\
210 	    unsigned long long: ilog2_long_long	\
211 	)(n)
212 
213 #define	ilog2_const(n)				\
214     (8 * (int)sizeof(unsigned long long) - 1 -	\
215     __builtin_clzll(n))
216 
217 #define	ilog2(n) (__builtin_constant_p(n) ? ilog2_const(n) : ilog2_var(n))
218 #define	rounddown_pow_of_two(n)	((__typeof(n))1 << ilog2(n))
219 #define order_base_2(n) ilog2(2*(n)-1)
220 #define	roundup_pow_of_two(n)	((__typeof(n))1 << order_base_2(n))
221 
222 #define	bitcount64(x)	__bitcount64((uint64_t)(x))
223 #define	bitcount32(x)	__bitcount32((uint32_t)(x))
224 #define	bitcount16(x)	__bitcount16((uint16_t)(x))
225 #define	bitcountl(x)	__bitcountl((u_long)(x))
226 #define	bitcount(x)	__bitcount((u_int)(x))
227 
228 int	 fnmatch(const char *, const char *, int);
229 int	 locc(int, char *, u_int);
230 void	*memchr(const void *s, int c, size_t n);
231 void	*memcchr(const void *s, int c, size_t n);
232 void	*memmem(const void *l, size_t l_len, const void *s, size_t s_len);
233 void	 qsort(void *base, size_t nmemb, size_t size,
234 	    int (*compar)(const void *, const void *));
235 void	 qsort_r(void *base, size_t nmemb, size_t size,
236 	    int (*compar)(const void *, const void *, void *), void *thunk);
237 u_long	 random(void);
238 int	 scanc(u_int, const u_char *, const u_char *, int);
239 int	 strcasecmp(const char *, const char *);
240 char	*strcasestr(const char *, const char *);
241 char	*strcat(char * __restrict, const char * __restrict);
242 char	*strchr(const char *, int);
243 char	*strchrnul(const char *, int);
244 int	 strcmp(const char *, const char *);
245 char	*strcpy(char * __restrict, const char * __restrict);
246 char	*strdup_flags(const char *__restrict, struct malloc_type *, int);
247 size_t	 strcspn(const char *, const char *) __pure;
248 char	*strdup(const char *__restrict, struct malloc_type *);
249 char	*strncat(char *, const char *, size_t);
250 char	*strndup(const char *__restrict, size_t, struct malloc_type *);
251 size_t	 strlcat(char *, const char *, size_t);
252 size_t	 strlcpy(char *, const char *, size_t);
253 size_t	 strlen(const char *);
254 int	 strncasecmp(const char *, const char *, size_t);
255 int	 strncmp(const char *, const char *, size_t);
256 char	*strncpy(char * __restrict, const char * __restrict, size_t);
257 size_t	 strnlen(const char *, size_t);
258 char	*strnstr(const char *, const char *, size_t);
259 char	*strrchr(const char *, int);
260 char	*strsep(char **, const char *delim);
261 size_t	 strspn(const char *, const char *);
262 char	*strstr(const char *, const char *);
263 int	 strvalid(const char *, size_t);
264 
265 #ifdef SAN_NEEDS_INTERCEPTORS
266 #ifndef SAN_INTERCEPTOR
267 #define	SAN_INTERCEPTOR(func)	\
268 	__CONCAT(SAN_INTERCEPTOR_PREFIX, __CONCAT(_, func))
269 #endif
270 char	*SAN_INTERCEPTOR(strcpy)(char *, const char *);
271 int	SAN_INTERCEPTOR(strcmp)(const char *, const char *);
272 size_t	SAN_INTERCEPTOR(strlen)(const char *);
273 #ifndef SAN_RUNTIME
274 #define	strcpy(d, s)	SAN_INTERCEPTOR(strcpy)((d), (s))
275 #define	strcmp(s1, s2)	SAN_INTERCEPTOR(strcmp)((s1), (s2))
276 #define	strlen(s)	SAN_INTERCEPTOR(strlen)(s)
277 #endif /* !SAN_RUNTIME */
278 #else /* !SAN_NEEDS_INTERCEPTORS */
279 #define strcpy(d, s)	__builtin_strcpy((d), (s))
280 #define strcmp(s1, s2)	__builtin_strcmp((s1), (s2))
281 #define strlen(s)	__builtin_strlen((s))
282 #endif /* SAN_NEEDS_INTERCEPTORS */
283 
284 static __inline char *
index(const char * p,int ch)285 index(const char *p, int ch)
286 {
287 
288 	return (strchr(p, ch));
289 }
290 
291 static __inline char *
rindex(const char * p,int ch)292 rindex(const char *p, int ch)
293 {
294 
295 	return (strrchr(p, ch));
296 }
297 
298 static __inline int64_t
signed_extend64(uint64_t bitmap,int lsb,int width)299 signed_extend64(uint64_t bitmap, int lsb, int width)
300 {
301 
302 	return ((int64_t)(bitmap << (63 - lsb - (width - 1)))) >>
303 	    (63 - (width - 1));
304 }
305 
306 static __inline int32_t
signed_extend32(uint32_t bitmap,int lsb,int width)307 signed_extend32(uint32_t bitmap, int lsb, int width)
308 {
309 
310 	return ((int32_t)(bitmap << (31 - lsb - (width - 1)))) >>
311 	    (31 - (width - 1));
312 }
313 
314 /* fnmatch() return values. */
315 #define	FNM_NOMATCH	1	/* Match failed. */
316 
317 /* fnmatch() flags. */
318 #define	FNM_NOESCAPE	0x01	/* Disable backslash escaping. */
319 #define	FNM_PATHNAME	0x02	/* Slash must be matched by slash. */
320 #define	FNM_PERIOD	0x04	/* Period must be matched by period. */
321 #define	FNM_LEADING_DIR	0x08	/* Ignore /<tail> after Imatch. */
322 #define	FNM_CASEFOLD	0x10	/* Case insensitive search. */
323 #define	FNM_IGNORECASE	FNM_CASEFOLD
324 #define	FNM_FILE_NAME	FNM_PATHNAME
325 
326 #if !defined(_KERNEL) && __has_include(<ssp/ssp.h>)
327 #include <ssp/ssp.h>	/* __ssp_real */
328 #else
329 #define __ssp_real(fun)		fun
330 #endif
331 
332 #endif /* !_SYS_LIBKERN_H_ */
333