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