xref: /openbsd/sys/lib/libkern/libkern.h (revision e86eac0a)
1 /*	$OpenBSD: libkern.h,v 1.37 2023/12/21 02:57:14 jsg Exp $	*/
2 /*	$NetBSD: libkern.h,v 1.7 1996/03/14 18:52:08 christos Exp $	*/
3 
4 /*-
5  * Copyright (c) 1992, 1993
6  *	The Regents of the University of California.  All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. Neither the name of the University nor the names of its contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  *
32  *	@(#)libkern.h	8.1 (Berkeley) 6/10/93
33  */
34 
35 #ifndef __LIBKERN_H__
36 #define __LIBKERN_H__
37 
38 #include <sys/types.h>
39 
40 #ifndef LIBKERN_INLINE
41 #define LIBKERN_INLINE	static __inline
42 #define LIBKERN_BODY
43 #endif
44 
45 
46 LIBKERN_INLINE int imax(int, int);
47 LIBKERN_INLINE int imin(int, int);
48 LIBKERN_INLINE u_int max(u_int, u_int);
49 LIBKERN_INLINE u_int min(u_int, u_int);
50 LIBKERN_INLINE long lmax(long, long);
51 LIBKERN_INLINE long lmin(long, long);
52 LIBKERN_INLINE u_long ulmax(u_long, u_long);
53 LIBKERN_INLINE u_long ulmin(u_long, u_long);
54 LIBKERN_INLINE int abs(int);
55 
56 #ifdef LIBKERN_BODY
57 LIBKERN_INLINE int
imax(int a,int b)58 imax(int a, int b)
59 {
60 	return (a > b ? a : b);
61 }
62 LIBKERN_INLINE int
imin(int a,int b)63 imin(int a, int b)
64 {
65 	return (a < b ? a : b);
66 }
67 LIBKERN_INLINE long
lmax(long a,long b)68 lmax(long a, long b)
69 {
70 	return (a > b ? a : b);
71 }
72 LIBKERN_INLINE long
lmin(long a,long b)73 lmin(long a, long b)
74 {
75 	return (a < b ? a : b);
76 }
77 LIBKERN_INLINE u_int
max(u_int a,u_int b)78 max(u_int a, u_int b)
79 {
80 	return (a > b ? a : b);
81 }
82 LIBKERN_INLINE u_int
min(u_int a,u_int b)83 min(u_int a, u_int b)
84 {
85 	return (a < b ? a : b);
86 }
87 LIBKERN_INLINE u_long
ulmax(u_long a,u_long b)88 ulmax(u_long a, u_long b)
89 {
90 	return (a > b ? a : b);
91 }
92 LIBKERN_INLINE u_long
ulmin(u_long a,u_long b)93 ulmin(u_long a, u_long b)
94 {
95 	return (a < b ? a : b);
96 }
97 
98 LIBKERN_INLINE int
abs(int j)99 abs(int j)
100 {
101 	return(j < 0 ? -j : j);
102 }
103 #endif
104 
105 #ifdef NDEBUG						/* tradition! */
106 #define	assert(e)	((void)0)
107 #else
108 #define	assert(e)	((e) ? (void)0 :				    \
109 			    __assert("", __FILE__, __LINE__, #e))
110 #endif
111 
112 #define	__KASSERTSTR	"kernel %sassertion \"%s\" failed: file \"%s\", line %d"
113 
114 #ifndef DIAGNOSTIC
115 #define	KASSERTMSG(e, msg, ...)	((void)0)
116 #define	KASSERT(e)	((void)0)
117 #else
118 #define	KASSERTMSG(e, msg, ...)	((e) ? (void)0 :			    \
119 			    panic(__KASSERTSTR " " msg, "diagnostic ", #e,  \
120 			    __FILE__, __LINE__, ## __VA_ARGS__))
121 #define	KASSERT(e)	((e) ? (void)0 :				    \
122 			    __assert("diagnostic ", __FILE__, __LINE__, #e))
123 #endif
124 
125 #ifndef DEBUG
126 #define	KDASSERTMSG(e, msg, ...)	((void)0)
127 #define	KDASSERT(e)	((void)0)
128 #else
129 #define	KDASSERTMSG(e, msg, ...)	((e) ? (void)0 :		    \
130 			    panic(__KASSERTSTR " " msg, "debugging ", #e,   \
131 			    __FILE__, __LINE__, ## __VA_ARGS__))
132 #define	KDASSERT(e)	((e) ? (void)0 :				    \
133 			    __assert("debugging ", __FILE__, __LINE__, #e))
134 #endif
135 
136 #define	CTASSERT(x)	extern char  _ctassert[(x) ? 1 : -1 ]	\
137 			    __attribute__((__unused__))
138 
139 /* Prototypes for non-quad routines. */
140 void	 __assert(const char *, const char *, int, const char *)
141 	    __attribute__ ((__noreturn__));
142 int	 bcmp(const void *, const void *, size_t);
143 void	 bzero(void *, size_t);
144 void	 explicit_bzero(void *, size_t);
145 int	 ffs(int);
146 int	 fls(int);
147 int	 flsl(long);
148 void	*memchr(const void *, int, size_t);
149 int	 memcmp(const void *, const void *, size_t);
150 void	*memset(void *, int c, size_t len);
151 u_int32_t random(void);
152 int	 scanc(u_int, const u_char *, const u_char [], int);
153 int	 skpc(int, size_t, u_char *);
154 size_t	 strlen(const char *);
155 char	*strncpy(char *, const char *, size_t)
156 		__attribute__ ((__bounded__(__string__,1,3)));
157 size_t	 strnlen(const char *, size_t);
158 size_t	 strlcpy(char *, const char *, size_t)
159 		__attribute__ ((__bounded__(__string__,1,3)));
160 size_t	 strlcat(char *, const char *, size_t)
161 		__attribute__ ((__bounded__(__string__,1,3)));
162 int	 strcmp(const char *, const char *);
163 int	 strncmp(const char *, const char *, size_t);
164 int	 strncasecmp(const char *, const char *, size_t);
165 size_t	 getsn(char *, size_t)
166 		__attribute__ ((__bounded__(__string__,1,2)));
167 char	*strchr(const char *, int);
168 char	*strrchr(const char *, int);
169 int	 timingsafe_bcmp(const void *, const void *, size_t);
170 char	*strnstr(const char *, const char *, size_t);
171 
172 #endif /* __LIBKERN_H__ */
173