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_ 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(_ISOC99_SOURCE) || (__STDC_VERSION__ - 0) >= 199901L || \ 67 defined(_NETBSD_SOURCE) || (__cplusplus - 0) >= 201103L 68 typedef 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) 77 typedef 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 91 extern 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); 98 int atexit(void (*)(void)); 99 double atof(const char *); 100 int atoi(const char *); 101 long atol(const char *); 102 #ifndef __BSEARCH_DECLARED 103 #define __BSEARCH_DECLARED 104 /* also in search.h */ 105 void *bsearch(const void *, const void *, size_t, size_t, 106 int (*)(const void *, const void *)); 107 #endif /* __BSEARCH_DECLARED */ 108 void *calloc(size_t, size_t); 109 div_t div(int, int); 110 __dead void exit(int); 111 void free(void *); 112 __aconst char *getenv(const char *); 113 __constfunc long 114 labs(long); 115 ldiv_t ldiv(long, long); 116 void *malloc(size_t); 117 void qsort(void *, size_t, size_t, int (*)(const void *, const void *)); 118 int rand(void); 119 void *realloc(void *, size_t); 120 void srand(unsigned); 121 double strtod(const char * __restrict, char ** __restrict); 122 long strtol(const char * __restrict, char ** __restrict, int); 123 unsigned long 124 strtoul(const char * __restrict, char ** __restrict, int); 125 #ifdef _OPENBSD_SOURCE 126 long long strtonum(const char *, long long, long long, const char **); 127 #endif 128 int system(const char *); 129 130 /* These are currently just stubs. */ 131 int mblen(const char *, size_t); 132 size_t mbstowcs(wchar_t * __restrict, const char * __restrict, size_t); 133 int wctomb(char *, wchar_t); 134 int mbtowc(wchar_t * __restrict, const char * __restrict, size_t); 135 size_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) 146 int 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) 154 double drand48(void); 155 double erand48(unsigned short[3]); 156 long jrand48(unsigned short[3]); 157 void lcong48(unsigned short[7]); 158 long lrand48(void); 159 long mrand48(void); 160 long nrand48(unsigned short[3]); 161 unsigned short * 162 seed48(unsigned short[3]); 163 void srand48(long); 164 165 #ifndef __LIBC12_SOURCE__ 166 int 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) 176 long a64l(const char *); 177 char *l64a(long); 178 179 long random(void); 180 char *setstate(char *); 181 #ifndef __LIBC12_SOURCE__ 182 char *initstate(unsigned int, char *, size_t) __RENAME(__initstate60); 183 void srandom(unsigned int) __RENAME(__srandom60); 184 #endif 185 #ifdef _NETBSD_SOURCE 186 #define RANDOM_MAX 0x7fffffff /* (((long)1 << 31) - 1) */ 187 int mkostemps(char *, int, int); 188 #endif 189 190 char *mktemp(char *) 191 #ifdef __MKTEMP_OK__ 192 __RENAME(_mktemp) 193 #endif 194 ; 195 196 int setkey(const char *); 197 198 char *realpath(const char * __restrict, char * __restrict); 199 200 int ttyslot(void); 201 202 void *valloc(size_t); /* obsoleted by malloc() */ 203 204 int grantpt(int); 205 int unlockpt(int); 206 char *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 */ 216 long long int atoll(const char *); 217 /* LONGLONG */ 218 long long int llabs(long long int); 219 /* LONGLONG */ 220 lldiv_t lldiv(long long int, long long int); 221 /* LONGLONG */ 222 long long int strtoll(const char * __restrict, char ** __restrict, int); 223 /* LONGLONG */ 224 unsigned long long int 225 strtoull(const char * __restrict, char ** __restrict, int); 226 float strtof(const char * __restrict, char ** __restrict); 227 long 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 232 void *aligned_alloc(size_t, size_t); 233 int 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) 242 int setenv(const char *, const char *, int); 243 #ifndef __LIBC12_SOURCE__ 244 int unsetenv(const char *) __RENAME(__unsetenv13); 245 #endif 246 247 int posix_openpt(int); 248 int 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) 259 char *mkdtemp(char *); 260 int mkstemp(char *); 261 262 int 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 272 void *alloca(size_t); 273 #endif /* __GNUC__ */ 274 275 uint32_t arc4random(void); 276 void arc4random_stir(void); 277 void arc4random_buf(void *, size_t); 278 uint32_t arc4random_uniform(uint32_t); 279 void arc4random_addrandom(unsigned char *, int); 280 char *getbsize(int *, long *); 281 char *cgetcap(char *, const char *, int); 282 int cgetclose(void); 283 int cgetent(char **, const char * const *, const char *); 284 int cgetfirst(char **, const char * const *); 285 int cgetmatch(const char *, const char *); 286 int cgetnext(char **, const char * const *); 287 int cgetnum(char *, const char *, long *); 288 int cgetset(const char *); 289 int cgetstr(char *, const char *, char **); 290 int cgetustr(char *, const char *, char **); 291 void csetexpandtc(int); 292 293 int daemon(int, int); 294 int 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 307 int humanize_number(char *, size_t, int64_t, const char *, int, int); 308 int dehumanize_number(const char *, int64_t *); 309 ssize_t hmac(const char *, const void *, size_t, const void *, size_t, void *, 310 size_t); 311 312 devmajor_t getdevmajor(const char *, mode_t); 313 int getloadavg(double [], int); 314 315 int getenv_r(const char *, char *, size_t); 316 317 void cfree(void *); 318 319 int heapsort(void *, size_t, size_t, int (*)(const void *, const void *)); 320 int heapsort_r(void *, size_t, size_t, 321 int (*)(const void *, const void *, void *), void *); 322 int mergesort(void *, size_t, size_t, 323 int (*)(const void *, const void *)); 324 int mergesort_r(void *, size_t, size_t, 325 int (*)(const void *, const void *, void *), void *); 326 int ptsname_r(int, char *, size_t); 327 int radixsort(const unsigned char **, int, const unsigned char *, 328 unsigned); 329 int sradixsort(const unsigned char **, int, const unsigned char *, 330 unsigned); 331 332 void mi_vector_hash(const void * __restrict, size_t, uint32_t, 333 uint32_t[3]); 334 335 void setproctitle(const char *, ...) 336 __printflike(1, 2); 337 const char *getprogname(void) __constfunc; 338 void setprogname(const char *); 339 340 quad_t qabs(quad_t); 341 quad_t strtoq(const char * __restrict, char ** __restrict, int); 342 u_quad_t strtouq(const char * __restrict, char ** __restrict, int); 343 344 /* LONGLONG */ 345 long long strsuftoll(const char *, const char *, long long, long long); 346 /* LONGLONG */ 347 long long strsuftollx(const char *, const char *, long long, long long, 348 char *, size_t); 349 350 int l64a_r(long, char *, int); 351 352 size_t shquote(const char *, char *, size_t); 353 size_t shquotev(int, char * const *, char *, size_t); 354 355 int 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) 360 qdiv_t qdiv(quad_t, quad_t); 361 #endif 362 363 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE) 364 # ifndef __LOCALE_T_DECLARED 365 typedef struct _locale *locale_t; 366 # define __LOCALE_T_DECLARED 367 # endif 368 double strtod_l(const char * __restrict, char ** __restrict, locale_t); 369 float strtof_l(const char * __restrict, char ** __restrict, locale_t); 370 long double strtold_l(const char * __restrict, char ** __restrict, 371 locale_t); 372 long strtol_l(const char * __restrict, char ** __restrict, int, locale_t); 373 unsigned long 374 strtoul_l(const char * __restrict, char ** __restrict, int, locale_t); 375 /* LONGLONG */ 376 long long int 377 strtoll_l(const char * __restrict, char ** __restrict, int, locale_t); 378 /* LONGLONG */ 379 unsigned long long int 380 strtoull_l(const char * __restrict, char ** __restrict, int, locale_t); 381 382 # if defined(_NETBSD_SOURCE) 383 quad_t strtoq_l(const char * __restrict, char ** __restrict, int, locale_t); 384 u_quad_t strtouq_l(const char * __restrict, char ** __restrict, int, locale_t); 385 386 size_t _mb_cur_max_l(locale_t); 387 #define MB_CUR_MAX_L(loc) _mb_cur_max_l(loc) 388 int mblen_l(const char *, size_t, locale_t); 389 size_t mbstowcs_l(wchar_t * __restrict, const char * __restrict, size_t, 390 locale_t); 391 int wctomb_l(char *, wchar_t, locale_t); 392 int mbtowc_l(wchar_t * __restrict, const char * __restrict, size_t, 393 locale_t); 394 size_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) 402 void *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) 406 int mkostemp(char *, int); 407 void 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_ */ 414