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 * @(#)libkern.h 8.1 (Berkeley) 6/10/93 32 * $FreeBSD$ 33 */ 34 35 #ifndef _SYS_LIBKERN_H_ 36 #define _SYS_LIBKERN_H_ 37 38 #include <sys/cdefs.h> 39 #include <sys/types.h> 40 #ifdef _KERNEL 41 #include <sys/systm.h> 42 #endif 43 44 #ifndef LIBKERN_INLINE 45 #define LIBKERN_INLINE static __inline 46 #define LIBKERN_BODY 47 #endif 48 49 /* BCD conversions. */ 50 extern u_char const bcd2bin_data[]; 51 extern u_char const bin2bcd_data[]; 52 extern char const hex2ascii_data[]; 53 54 #define LIBKERN_LEN_BCD2BIN 154 55 #define LIBKERN_LEN_BIN2BCD 100 56 #define LIBKERN_LEN_HEX2ASCII 36 57 58 static inline u_char 59 bcd2bin(int bcd) 60 { 61 62 KASSERT(bcd >= 0 && bcd < LIBKERN_LEN_BCD2BIN, 63 ("invalid bcd %d", bcd)); 64 return (bcd2bin_data[bcd]); 65 } 66 67 static inline u_char 68 bin2bcd(int bin) 69 { 70 71 KASSERT(bin >= 0 && bin < LIBKERN_LEN_BIN2BCD, 72 ("invalid bin %d", bin)); 73 return (bin2bcd_data[bin]); 74 } 75 76 static inline char 77 hex2ascii(int hex) 78 { 79 80 KASSERT(hex >= 0 && hex < LIBKERN_LEN_HEX2ASCII, 81 ("invalid hex %d", hex)); 82 return (hex2ascii_data[hex]); 83 } 84 85 static inline bool 86 validbcd(int bcd) 87 { 88 89 return (bcd == 0 || (bcd > 0 && bcd <= 0x99 && bcd2bin_data[bcd] != 0)); 90 } 91 92 static __inline int imax(int a, int b) { return (a > b ? a : b); } 93 static __inline int imin(int a, int b) { return (a < b ? a : b); } 94 static __inline long lmax(long a, long b) { return (a > b ? a : b); } 95 static __inline long lmin(long a, long b) { return (a < b ? a : b); } 96 static __inline u_int max(u_int a, u_int b) { return (a > b ? a : b); } 97 static __inline u_int min(u_int a, u_int b) { return (a < b ? a : b); } 98 static __inline quad_t qmax(quad_t a, quad_t b) { return (a > b ? a : b); } 99 static __inline quad_t qmin(quad_t a, quad_t b) { return (a < b ? a : b); } 100 static __inline u_quad_t uqmax(u_quad_t a, u_quad_t b) { return (a > b ? a : b); } 101 static __inline u_quad_t uqmin(u_quad_t a, u_quad_t b) { return (a < b ? a : b); } 102 static __inline u_long ulmax(u_long a, u_long b) { return (a > b ? a : b); } 103 static __inline u_long ulmin(u_long a, u_long b) { return (a < b ? a : b); } 104 static __inline __uintmax_t ummax(__uintmax_t a, __uintmax_t b) 105 { 106 107 return (a > b ? a : b); 108 } 109 static __inline __uintmax_t ummin(__uintmax_t a, __uintmax_t b) 110 { 111 112 return (a < b ? a : b); 113 } 114 static __inline off_t omax(off_t a, off_t b) { return (a > b ? a : b); } 115 static __inline off_t omin(off_t a, off_t b) { return (a < b ? a : b); } 116 117 static __inline int abs(int a) { return (a < 0 ? -a : a); } 118 static __inline long labs(long a) { return (a < 0 ? -a : a); } 119 static __inline quad_t qabs(quad_t a) { return (a < 0 ? -a : a); } 120 121 #define ARC4_ENTR_NONE 0 /* Don't have entropy yet. */ 122 #define ARC4_ENTR_HAVE 1 /* Have entropy. */ 123 #define ARC4_ENTR_SEED 2 /* Reseeding. */ 124 extern int arc4rand_iniseed_state; 125 126 /* Prototypes for non-quad routines. */ 127 struct malloc_type; 128 uint32_t arc4random(void); 129 void arc4random_buf(void *, size_t); 130 void arc4rand(void *, u_int, int); 131 int bcmp(const void *, const void *, size_t); 132 int timingsafe_bcmp(const void *, const void *, size_t); 133 void *bsearch(const void *, const void *, size_t, 134 size_t, int (*)(const void *, const void *)); 135 #ifndef HAVE_INLINE_FFS 136 int ffs(int); 137 #endif 138 #ifndef HAVE_INLINE_FFSL 139 int ffsl(long); 140 #endif 141 #ifndef HAVE_INLINE_FFSLL 142 int ffsll(long long); 143 #endif 144 #ifndef HAVE_INLINE_FLS 145 int fls(int); 146 #endif 147 #ifndef HAVE_INLINE_FLSL 148 int flsl(long); 149 #endif 150 #ifndef HAVE_INLINE_FLSLL 151 int flsll(long long); 152 #endif 153 #define bitcount64(x) __bitcount64((uint64_t)(x)) 154 #define bitcount32(x) __bitcount32((uint32_t)(x)) 155 #define bitcount16(x) __bitcount16((uint16_t)(x)) 156 #define bitcountl(x) __bitcountl((u_long)(x)) 157 #define bitcount(x) __bitcount((u_int)(x)) 158 159 int fnmatch(const char *, const char *, int); 160 int locc(int, char *, u_int); 161 void *memchr(const void *s, int c, size_t n); 162 void *memcchr(const void *s, int c, size_t n); 163 int memcmp(const void *b1, const void *b2, size_t len); 164 void *memmem(const void *l, size_t l_len, const void *s, size_t s_len); 165 void qsort(void *base, size_t nmemb, size_t size, 166 int (*compar)(const void *, const void *)); 167 void qsort_r(void *base, size_t nmemb, size_t size, void *thunk, 168 int (*compar)(void *, const void *, const void *)); 169 u_long random(void); 170 int scanc(u_int, const u_char *, const u_char *, int); 171 void srandom(u_long); 172 int strcasecmp(const char *, const char *); 173 char *strcat(char * __restrict, const char * __restrict); 174 char *strchr(const char *, int); 175 int strcmp(const char *, const char *); 176 char *strcpy(char * __restrict, const char * __restrict); 177 size_t strcspn(const char * __restrict, const char * __restrict) __pure; 178 char *strdup(const char *__restrict, struct malloc_type *); 179 char *strncat(char *, const char *, size_t); 180 char *strndup(const char *__restrict, size_t, struct malloc_type *); 181 size_t strlcat(char *, const char *, size_t); 182 size_t strlcpy(char *, const char *, size_t); 183 size_t strlen(const char *); 184 int strncasecmp(const char *, const char *, size_t); 185 int strncmp(const char *, const char *, size_t); 186 char *strncpy(char * __restrict, const char * __restrict, size_t); 187 size_t strnlen(const char *, size_t); 188 char *strrchr(const char *, int); 189 char *strsep(char **, const char *delim); 190 size_t strspn(const char *, const char *); 191 char *strstr(const char *, const char *); 192 int strvalid(const char *, size_t); 193 194 extern const uint32_t crc32_tab[]; 195 196 static __inline uint32_t 197 crc32_raw(const void *buf, size_t size, uint32_t crc) 198 { 199 const uint8_t *p = (const uint8_t *)buf; 200 201 while (size--) 202 crc = crc32_tab[(crc ^ *p++) & 0xFF] ^ (crc >> 8); 203 return (crc); 204 } 205 206 static __inline uint32_t 207 crc32(const void *buf, size_t size) 208 { 209 uint32_t crc; 210 211 crc = crc32_raw(buf, size, ~0U); 212 return (crc ^ ~0U); 213 } 214 215 uint32_t 216 calculate_crc32c(uint32_t crc32c, const unsigned char *buffer, 217 unsigned int length); 218 #ifdef _KERNEL 219 #if defined(__amd64__) || defined(__i386__) 220 uint32_t sse42_crc32c(uint32_t, const unsigned char *, unsigned); 221 #endif 222 #if defined(__aarch64__) 223 uint32_t armv8_crc32c(uint32_t, const unsigned char *, unsigned int); 224 #endif 225 #endif 226 227 228 LIBKERN_INLINE void *memset(void *, int, size_t); 229 #ifdef LIBKERN_BODY 230 LIBKERN_INLINE void * 231 memset(void *b, int c, size_t len) 232 { 233 char *bb; 234 235 if (c == 0) 236 bzero(b, len); 237 else 238 for (bb = (char *)b; len--; ) 239 *bb++ = c; 240 return (b); 241 } 242 #endif 243 244 static __inline char * 245 index(const char *p, int ch) 246 { 247 248 return (strchr(p, ch)); 249 } 250 251 static __inline char * 252 rindex(const char *p, int ch) 253 { 254 255 return (strrchr(p, ch)); 256 } 257 258 /* fnmatch() return values. */ 259 #define FNM_NOMATCH 1 /* Match failed. */ 260 261 /* fnmatch() flags. */ 262 #define FNM_NOESCAPE 0x01 /* Disable backslash escaping. */ 263 #define FNM_PATHNAME 0x02 /* Slash must be matched by slash. */ 264 #define FNM_PERIOD 0x04 /* Period must be matched by period. */ 265 #define FNM_LEADING_DIR 0x08 /* Ignore /<tail> after Imatch. */ 266 #define FNM_CASEFOLD 0x10 /* Case insensitive search. */ 267 #define FNM_IGNORECASE FNM_CASEFOLD 268 #define FNM_FILE_NAME FNM_PATHNAME 269 270 #endif /* !_SYS_LIBKERN_H_ */ 271