1/*	$NetBSD: stdlib.h,v 1.125 2022/10/28 09:43:59 wiz 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_
47typedef	_BSD_SIZE_T_	size_t;
48#undef	_BSD_SIZE_T_
49#endif
50
51#if defined(_BSD_WCHAR_T_) && !defined(__cplusplus)
52typedef	_BSD_WCHAR_T_	wchar_t;
53#undef	_BSD_WCHAR_T_
54#endif
55
56typedef struct {
57	int quot;		/* quotient */
58	int rem;		/* remainder */
59} div_t;
60
61typedef 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))
69typedef 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)
78typedef 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
92extern 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);
99int	 atexit(void (*)(void));
100double	 atof(const char *);
101int	 atoi(const char *);
102long	 atol(const char *);
103#ifndef __BSEARCH_DECLARED
104#define __BSEARCH_DECLARED
105/* also in search.h */
106void	*bsearch(const void *, const void *, size_t, size_t,
107    int (*)(const void *, const void *));
108#endif /* __BSEARCH_DECLARED */
109void	*calloc(size_t, size_t);
110div_t	 div(int, int);
111__dead	 void exit(int);
112void	 free(void *);
113__aconst char *getenv(const char *);
114__constfunc long
115	 labs(long);
116ldiv_t	 ldiv(long, long);
117void	*malloc(size_t);
118void	 qsort(void *, size_t, size_t, int (*)(const void *, const void *));
119int	 rand(void);
120void	*realloc(void *, size_t);
121void	*reallocarray(void *, size_t, size_t);
122void	 srand(unsigned);
123double	 strtod(const char * __restrict, char ** __restrict);
124long	 strtol(const char * __restrict, char ** __restrict, int);
125unsigned long
126	 strtoul(const char * __restrict, char ** __restrict, int);
127#ifdef _OPENBSD_SOURCE
128long long strtonum(const char *, long long, long long, const char **);
129#endif
130int	 system(const char *);
131
132/* These are currently just stubs. */
133int	 mblen(const char *, size_t);
134size_t	 mbstowcs(wchar_t * __restrict, const char * __restrict, size_t);
135int	 wctomb(char *, wchar_t);
136int	 mbtowc(wchar_t * __restrict, const char * __restrict, size_t);
137size_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)
148int	 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)
156double	 drand48(void);
157double	 erand48(unsigned short[3]);
158long	 jrand48(unsigned short[3]);
159void	 lcong48(unsigned short[7]);
160long	 lrand48(void);
161long	 mrand48(void);
162long	 nrand48(unsigned short[3]);
163unsigned short *
164	 seed48(unsigned short[3]);
165void	 srand48(long);
166
167#ifndef __LIBC12_SOURCE__
168int	 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)
178long	 a64l(const char *);
179char	*l64a(long);
180
181long	 random(void);
182char	*setstate(char *);
183#ifndef __LIBC12_SOURCE__
184char	*initstate(unsigned int, char *, size_t) __RENAME(__initstate60);
185void	 srandom(unsigned int) __RENAME(__srandom60);
186#endif
187#ifdef _NETBSD_SOURCE
188#define	RANDOM_MAX	0x7fffffff	/* (((long)1 << 31) - 1) */
189int	 mkostemp(char *, int);
190int	 mkostemps(char *, int, int);
191#endif
192
193char	*mktemp(char *)
194#ifdef __MKTEMP_OK__
195	__RENAME(_mktemp)
196#endif
197	;
198
199int	 setkey(const char *);
200
201char	*realpath(const char * __restrict, char * __restrict);
202
203int	 ttyslot(void);
204
205void	*valloc(size_t);		/* obsoleted by malloc() */
206
207int	 grantpt(int);
208int	 unlockpt(int);
209char	*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 */
219long long int	atoll(const char *);
220/* LONGLONG */
221long long int	llabs(long long int);
222/* LONGLONG */
223lldiv_t		lldiv(long long int, long long int);
224/* LONGLONG */
225long long int	strtoll(const char * __restrict, char ** __restrict, int);
226/* LONGLONG */
227unsigned long long int
228		strtoull(const char * __restrict, char ** __restrict, int);
229float		strtof(const char * __restrict, char ** __restrict);
230long 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
235void	*aligned_alloc(size_t, size_t);
236int	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)
245int	 setenv(const char *, const char *, int);
246#ifndef __LIBC12_SOURCE__
247int	 unsetenv(const char *) __RENAME(__unsetenv13);
248#endif
249
250int	 posix_openpt(int);
251int	 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)
262char	*mkdtemp(char *);
263int	 mkstemp(char *);
264
265int	 getsubopt(char **, char * const *, char **);
266#endif
267
268/*
269 * Implementation-defined extensions
270 */
271#if defined(_NETBSD_SOURCE)
272#if defined(__PCC__) && !defined(__GNUC__)
273#define alloca(size) __builtin_alloca(size)
274#else
275void	*alloca(size_t);
276#endif /* __GNUC__ */
277
278uint32_t arc4random(void);
279void	 arc4random_stir(void);
280void	 arc4random_buf(void *, size_t);
281uint32_t arc4random_uniform(uint32_t);
282void	 arc4random_addrandom(unsigned char *, int);
283char	*getbsize(int *, long *);
284char	*cgetcap(char *, const char *, int);
285int	 cgetclose(void);
286int	 cgetent(char **, const char * const *, const char *);
287int	 cgetfirst(char **, const char * const *);
288int	 cgetmatch(const char *, const char *);
289int	 cgetnext(char **, const char * const *);
290int	 cgetnum(char *, const char *, long *);
291int	 cgetset(const char *);
292int	 cgetstr(char *, const char *, char **);
293int	 cgetustr(char *, const char *, char **);
294void	 csetexpandtc(int);
295
296int	 daemon(int, int);
297int	 devname_r(dev_t, mode_t, char *, size_t);
298#ifndef __LIBC12_SOURCE__
299__aconst char *devname(dev_t, mode_t) __RENAME(__devname50);
300#endif
301
302#define	HN_DECIMAL		0x01
303#define	HN_NOSPACE		0x02
304#define	HN_B			0x04
305#define	HN_DIVISOR_1000		0x08
306
307#define	HN_GETSCALE		0x10
308#define	HN_AUTOSCALE		0x20
309
310int	 humanize_number(char *, size_t, int64_t, const char *, int, int);
311int	 dehumanize_number(const char *, int64_t *);
312ssize_t	 hmac(const char *, const void *, size_t, const void *, size_t, void *,
313   size_t);
314
315devmajor_t getdevmajor(const char *, mode_t);
316int	 getloadavg(double [], int);
317
318int	 getenv_r(const char *, char *, size_t);
319
320void	 cfree(void *);
321
322int	 heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
323int	 mergesort(void *, size_t, size_t,
324	    int (*)(const void *, const void *));
325int	 ptsname_r(int, char *, size_t);
326int	 radixsort(const unsigned char **, int, const unsigned char *,
327	    unsigned);
328int	 sradixsort(const unsigned char **, int, const unsigned char *,
329	    unsigned);
330
331void	 mi_vector_hash(const void * __restrict, size_t, uint32_t,
332	    uint32_t[3]);
333
334void	 setproctitle(const char *, ...)
335	    __printflike(1, 2);
336const char *getprogname(void) __constfunc;
337void	setprogname(const char *);
338
339quad_t	 qabs(quad_t);
340quad_t	 strtoq(const char * __restrict, char ** __restrict, int);
341u_quad_t strtouq(const char * __restrict, char ** __restrict, int);
342
343	/* LONGLONG */
344long long strsuftoll(const char *, const char *, long long, long long);
345	/* LONGLONG */
346long long strsuftollx(const char *, const char *, long long, long long,
347	    		char *, size_t);
348
349int	 l64a_r(long, char *, int);
350
351size_t	shquote(const char *, char *, size_t);
352size_t	shquotev(int, char * const *, char *, size_t);
353
354int	reallocarr(void *, size_t, size_t);
355#endif /* _NETBSD_SOURCE */
356#endif /* _POSIX_C_SOURCE || _XOPEN_SOURCE || _NETBSD_SOURCE */
357
358#if defined(_NETBSD_SOURCE)
359qdiv_t	 qdiv(quad_t, quad_t);
360#endif
361
362#if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
363#  ifndef __LOCALE_T_DECLARED
364typedef struct _locale		*locale_t;
365#  define __LOCALE_T_DECLARED
366#  endif
367double		strtod_l(const char * __restrict, char ** __restrict, locale_t);
368float		strtof_l(const char * __restrict, char ** __restrict, locale_t);
369long double	strtold_l(const char * __restrict, char ** __restrict,
370			  locale_t);
371long	 strtol_l(const char * __restrict, char ** __restrict, int, locale_t);
372unsigned long
373	 strtoul_l(const char * __restrict, char ** __restrict, int, locale_t);
374/* LONGLONG */
375long long int
376	strtoll_l(const char * __restrict, char ** __restrict, int, locale_t);
377/* LONGLONG */
378unsigned long long int
379	strtoull_l(const char * __restrict, char ** __restrict, int, locale_t);
380
381#  if defined(_NETBSD_SOURCE)
382quad_t	 strtoq_l(const char * __restrict, char ** __restrict, int, locale_t);
383u_quad_t strtouq_l(const char * __restrict, char ** __restrict, int, locale_t);
384
385size_t	_mb_cur_max_l(locale_t);
386#define	MB_CUR_MAX_L(loc)	_mb_cur_max_l(loc)
387int	 mblen_l(const char *, size_t, locale_t);
388size_t	 mbstowcs_l(wchar_t * __restrict, const char * __restrict, size_t,
389		    locale_t);
390int	 wctomb_l(char *, wchar_t, locale_t);
391int	 mbtowc_l(wchar_t * __restrict, const char * __restrict, size_t,
392	          locale_t);
393size_t	 wcstombs_l(char * __restrict, const wchar_t * __restrict, size_t,
394		    locale_t);
395
396#  endif /* _NETBSD_SOURCE */
397#endif /* _POSIX_C_SOURCE >= 200809 || _NETBSD_SOURCE */
398
399__END_DECLS
400
401#endif /* !_STDLIB_H_ */
402