xref: /netbsd-src/include/stdlib.h (revision 53b02e147d4ed531c0d2a5ca9b3e8026ba3e99b5)
1 /*	$NetBSD: stdlib.h,v 1.123 2021/07/03 14:07:13 christos Exp $	*/
2 
3 /*-
4  * Copyright (c) 1990, 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  *	@(#)stdlib.h	8.5 (Berkeley) 5/19/95
32  */
33 
34 #ifndef _STDLIB_H_
35 #define _STDLIB_H_
36 
37 #include <sys/cdefs.h>
38 #include <sys/featuretest.h>
39 
40 #if defined(_NETBSD_SOURCE)
41 #include <sys/types.h>		/* for quad_t, etc. */
42 #endif
43 
44 #include <machine/ansi.h>
45 
46 #ifdef	_BSD_SIZE_T_
47 typedef	_BSD_SIZE_T_	size_t;
48 #undef	_BSD_SIZE_T_
49 #endif
50 
51 #if defined(_BSD_WCHAR_T_) && !defined(__cplusplus)
52 typedef	_BSD_WCHAR_T_	wchar_t;
53 #undef	_BSD_WCHAR_T_
54 #endif
55 
56 typedef struct {
57 	int quot;		/* quotient */
58 	int rem;		/* remainder */
59 } div_t;
60 
61 typedef struct {
62 	long quot;		/* quotient */
63 	long rem;		/* remainder */
64 } ldiv_t;
65 
66 #if !defined(_ANSI_SOURCE) && \
67     (defined(_ISOC99_SOURCE) || (__STDC_VERSION__ - 0) >= 199901L || \
68      (__cplusplus - 0) >= 201103L || defined(_NETBSD_SOURCE))
69 typedef struct {
70 	/* LONGLONG */
71 	long long int quot;	/* quotient */
72 	/* LONGLONG */
73 	long long int rem;	/* remainder */
74 } lldiv_t;
75 #endif
76 
77 #if defined(_NETBSD_SOURCE)
78 typedef struct {
79 	quad_t quot;		/* quotient */
80 	quad_t rem;		/* remainder */
81 } qdiv_t;
82 #endif
83 
84 
85 #include <sys/null.h>
86 
87 #define	EXIT_FAILURE	1
88 #define	EXIT_SUCCESS	0
89 
90 #define	RAND_MAX	0x7fffffff
91 
92 extern size_t __mb_cur_max;
93 #define	MB_CUR_MAX	__mb_cur_max
94 
95 __BEGIN_DECLS
96 __dead	 void _Exit(int);
97 __dead	 void abort(void);
98 __constfunc	int abs(int);
99 int	 atexit(void (*)(void));
100 double	 atof(const char *);
101 int	 atoi(const char *);
102 long	 atol(const char *);
103 #ifndef __BSEARCH_DECLARED
104 #define __BSEARCH_DECLARED
105 /* also in search.h */
106 void	*bsearch(const void *, const void *, size_t, size_t,
107     int (*)(const void *, const void *));
108 #endif /* __BSEARCH_DECLARED */
109 void	*calloc(size_t, size_t);
110 div_t	 div(int, int);
111 __dead	 void exit(int);
112 void	 free(void *);
113 __aconst char *getenv(const char *);
114 __constfunc long
115 	 labs(long);
116 ldiv_t	 ldiv(long, long);
117 void	*malloc(size_t);
118 void	 qsort(void *, size_t, size_t, int (*)(const void *, const void *));
119 int	 rand(void);
120 void	*realloc(void *, size_t);
121 void	 srand(unsigned);
122 double	 strtod(const char * __restrict, char ** __restrict);
123 long	 strtol(const char * __restrict, char ** __restrict, int);
124 unsigned long
125 	 strtoul(const char * __restrict, char ** __restrict, int);
126 #ifdef _OPENBSD_SOURCE
127 long long strtonum(const char *, long long, long long, const char **);
128 void	*reallocarray(void *, size_t, size_t);
129 #endif
130 int	 system(const char *);
131 
132 /* These are currently just stubs. */
133 int	 mblen(const char *, size_t);
134 size_t	 mbstowcs(wchar_t * __restrict, const char * __restrict, size_t);
135 int	 wctomb(char *, wchar_t);
136 int	 mbtowc(wchar_t * __restrict, const char * __restrict, size_t);
137 size_t	 wcstombs(char * __restrict, const wchar_t * __restrict, size_t);
138 
139 #if defined(_POSIX_C_SOURCE) || defined(_XOPEN_SOURCE) || \
140     defined(_NETBSD_SOURCE)
141 
142 
143 /*
144  * IEEE Std 1003.1c-95, also adopted by X/Open CAE Spec Issue 5 Version 2
145  */
146 #if (_POSIX_C_SOURCE - 0) >= 199506L || (_XOPEN_SOURCE - 0) >= 500 || \
147     defined(_REENTRANT) || defined(_NETBSD_SOURCE)
148 int	 rand_r(unsigned int *);
149 #endif
150 
151 
152 /*
153  * X/Open Portability Guide >= Issue 4
154  */
155 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
156 double	 drand48(void);
157 double	 erand48(unsigned short[3]);
158 long	 jrand48(unsigned short[3]);
159 void	 lcong48(unsigned short[7]);
160 long	 lrand48(void);
161 long	 mrand48(void);
162 long	 nrand48(unsigned short[3]);
163 unsigned short *
164 	 seed48(unsigned short[3]);
165 void	 srand48(long);
166 
167 #ifndef __LIBC12_SOURCE__
168 int	 putenv(char *) __RENAME(__putenv50);
169 #endif
170 #endif
171 
172 
173 /*
174  * X/Open Portability Guide >= Issue 4 Version 2
175  */
176 #if (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
177     (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
178 long	 a64l(const char *);
179 char	*l64a(long);
180 
181 long	 random(void);
182 char	*setstate(char *);
183 #ifndef __LIBC12_SOURCE__
184 char	*initstate(unsigned int, char *, size_t) __RENAME(__initstate60);
185 void	 srandom(unsigned int) __RENAME(__srandom60);
186 #endif
187 #ifdef _NETBSD_SOURCE
188 #define	RANDOM_MAX	0x7fffffff	/* (((long)1 << 31) - 1) */
189 int	 mkostemp(char *, int);
190 int	 mkostemps(char *, int, int);
191 #endif
192 
193 char	*mktemp(char *)
194 #ifdef __MKTEMP_OK__
195 	__RENAME(_mktemp)
196 #endif
197 	;
198 
199 int	 setkey(const char *);
200 
201 char	*realpath(const char * __restrict, char * __restrict);
202 
203 int	 ttyslot(void);
204 
205 void	*valloc(size_t);		/* obsoleted by malloc() */
206 
207 int	 grantpt(int);
208 int	 unlockpt(int);
209 char	*ptsname(int);
210 #endif
211 
212 /*
213  * ISO C99
214  */
215 #if defined(_ISOC99_SOURCE) || (__STDC_VERSION__ - 0) >= 199901L || \
216     defined(_NETBSD_SOURCE) || (__cplusplus - 0) >= 201103L
217 
218 /* LONGLONG */
219 long long int	atoll(const char *);
220 /* LONGLONG */
221 long long int	llabs(long long int);
222 /* LONGLONG */
223 lldiv_t		lldiv(long long int, long long int);
224 /* LONGLONG */
225 long long int	strtoll(const char * __restrict, char ** __restrict, int);
226 /* LONGLONG */
227 unsigned long long int
228 		strtoull(const char * __restrict, char ** __restrict, int);
229 float		strtof(const char * __restrict, char ** __restrict);
230 long double	strtold(const char * __restrict, char ** __restrict);
231 #endif
232 
233 #if defined(_ISOC11_SOURCE) || (__STDC_VERSION__ - 0) >= 201101L || \
234     defined(_NETBSD_SOURCE) || (__cplusplus - 0) >= 201103L
235 void	*aligned_alloc(size_t, size_t);
236 int	at_quick_exit(void (*)(void));
237 __dead void quick_exit(int);
238 #endif
239 
240 /*
241  * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX)
242  */
243 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 600 || \
244     defined(_NETBSD_SOURCE)
245 int	 setenv(const char *, const char *, int);
246 #ifndef __LIBC12_SOURCE__
247 int	 unsetenv(const char *) __RENAME(__unsetenv13);
248 #endif
249 
250 int	 posix_openpt(int);
251 int	 posix_memalign(void **, size_t, size_t);
252 #endif
253 
254 /*
255  * The Open Group Base Specifications, Issue 7; IEEE Std 1003.1-2008 (POSIX)
256  *   or
257  * X/Open Portability Guide >= Issue 4 Version 2
258  */
259 #if (_POSIX_C_SOURCE - 0) >= 200809L || \
260     (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
261     (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
262 char	*mkdtemp(char *);
263 int	 mkstemp(char *);
264 
265 int	 getsubopt(char **, char * const *, char **);
266 #endif
267 
268 /*
269  * Implementation-defined extensions
270  */
271 #if defined(_NETBSD_SOURCE)
272 #if defined(alloca) && (alloca == __builtin_alloca) && \
273 	defined(__GNUC__) && (__GNUC__ < 2)
274 void	*alloca(int);     /* built-in for gcc */
275 #elif defined(__PCC__) && !defined(__GNUC__)
276 #define alloca(size) __builtin_alloca(size)
277 #else
278 void	*alloca(size_t);
279 #endif /* __GNUC__ */
280 
281 uint32_t arc4random(void);
282 void	 arc4random_stir(void);
283 void	 arc4random_buf(void *, size_t);
284 uint32_t arc4random_uniform(uint32_t);
285 void	 arc4random_addrandom(unsigned char *, int);
286 char	*getbsize(int *, long *);
287 char	*cgetcap(char *, const char *, int);
288 int	 cgetclose(void);
289 int	 cgetent(char **, const char * const *, const char *);
290 int	 cgetfirst(char **, const char * const *);
291 int	 cgetmatch(const char *, const char *);
292 int	 cgetnext(char **, const char * const *);
293 int	 cgetnum(char *, const char *, long *);
294 int	 cgetset(const char *);
295 int	 cgetstr(char *, const char *, char **);
296 int	 cgetustr(char *, const char *, char **);
297 void	 csetexpandtc(int);
298 
299 int	 daemon(int, int);
300 int	 devname_r(dev_t, mode_t, char *, size_t);
301 #ifndef __LIBC12_SOURCE__
302 __aconst char *devname(dev_t, mode_t) __RENAME(__devname50);
303 #endif
304 
305 #define	HN_DECIMAL		0x01
306 #define	HN_NOSPACE		0x02
307 #define	HN_B			0x04
308 #define	HN_DIVISOR_1000		0x08
309 
310 #define	HN_GETSCALE		0x10
311 #define	HN_AUTOSCALE		0x20
312 
313 int	 humanize_number(char *, size_t, int64_t, const char *, int, int);
314 int	 dehumanize_number(const char *, int64_t *);
315 ssize_t	 hmac(const char *, const void *, size_t, const void *, size_t, void *,
316    size_t);
317 
318 devmajor_t getdevmajor(const char *, mode_t);
319 int	 getloadavg(double [], int);
320 
321 int	 getenv_r(const char *, char *, size_t);
322 
323 void	 cfree(void *);
324 
325 int	 heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
326 int	 mergesort(void *, size_t, size_t,
327 	    int (*)(const void *, const void *));
328 int	 ptsname_r(int, char *, size_t);
329 int	 radixsort(const unsigned char **, int, const unsigned char *,
330 	    unsigned);
331 int	 sradixsort(const unsigned char **, int, const unsigned char *,
332 	    unsigned);
333 
334 void	 mi_vector_hash(const void * __restrict, size_t, uint32_t,
335 	    uint32_t[3]);
336 
337 void	 setproctitle(const char *, ...)
338 	    __printflike(1, 2);
339 const char *getprogname(void) __constfunc;
340 void	setprogname(const char *);
341 
342 quad_t	 qabs(quad_t);
343 quad_t	 strtoq(const char * __restrict, char ** __restrict, int);
344 u_quad_t strtouq(const char * __restrict, char ** __restrict, int);
345 
346 	/* LONGLONG */
347 long long strsuftoll(const char *, const char *, long long, long long);
348 	/* LONGLONG */
349 long long strsuftollx(const char *, const char *, long long, long long,
350 	    		char *, size_t);
351 
352 int	 l64a_r(long, char *, int);
353 
354 size_t	shquote(const char *, char *, size_t);
355 size_t	shquotev(int, char * const *, char *, size_t);
356 
357 int	reallocarr(void *, size_t, size_t);
358 #endif /* _NETBSD_SOURCE */
359 #endif /* _POSIX_C_SOURCE || _XOPEN_SOURCE || _NETBSD_SOURCE */
360 
361 #if defined(_NETBSD_SOURCE)
362 qdiv_t	 qdiv(quad_t, quad_t);
363 #endif
364 
365 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
366 #  ifndef __LOCALE_T_DECLARED
367 typedef struct _locale		*locale_t;
368 #  define __LOCALE_T_DECLARED
369 #  endif
370 double		strtod_l(const char * __restrict, char ** __restrict, locale_t);
371 float		strtof_l(const char * __restrict, char ** __restrict, locale_t);
372 long double	strtold_l(const char * __restrict, char ** __restrict,
373 			  locale_t);
374 long	 strtol_l(const char * __restrict, char ** __restrict, int, locale_t);
375 unsigned long
376 	 strtoul_l(const char * __restrict, char ** __restrict, int, locale_t);
377 /* LONGLONG */
378 long long int
379 	strtoll_l(const char * __restrict, char ** __restrict, int, locale_t);
380 /* LONGLONG */
381 unsigned long long int
382 	strtoull_l(const char * __restrict, char ** __restrict, int, locale_t);
383 
384 #  if defined(_NETBSD_SOURCE)
385 quad_t	 strtoq_l(const char * __restrict, char ** __restrict, int, locale_t);
386 u_quad_t strtouq_l(const char * __restrict, char ** __restrict, int, locale_t);
387 
388 size_t	_mb_cur_max_l(locale_t);
389 #define	MB_CUR_MAX_L(loc)	_mb_cur_max_l(loc)
390 int	 mblen_l(const char *, size_t, locale_t);
391 size_t	 mbstowcs_l(wchar_t * __restrict, const char * __restrict, size_t,
392 		    locale_t);
393 int	 wctomb_l(char *, wchar_t, locale_t);
394 int	 mbtowc_l(wchar_t * __restrict, const char * __restrict, size_t,
395 	          locale_t);
396 size_t	 wcstombs_l(char * __restrict, const wchar_t * __restrict, size_t,
397 		    locale_t);
398 
399 #  endif /* _NETBSD_SOURCE */
400 #endif /* _POSIX_C_SOURCE >= 200809 || _NETBSD_SOURCE */
401 
402 __END_DECLS
403 
404 #endif /* !_STDLIB_H_ */
405