1 /* $NetBSD: stdlib.h,v 1.127 2024/10/11 18:43:22 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 mkostemp(char *, int); 188 int mkostemps(char *, int, int); 189 #endif 190 191 char *mktemp(char *) 192 #ifdef __MKTEMP_OK__ 193 __RENAME(_mktemp) 194 #endif 195 ; 196 197 int setkey(const char *); 198 199 char *realpath(const char * __restrict, char * __restrict); 200 201 int ttyslot(void); 202 203 void *valloc(size_t); /* obsoleted by malloc() */ 204 205 int grantpt(int); 206 int unlockpt(int); 207 char *ptsname(int); 208 #endif 209 210 /* 211 * ISO C99 212 */ 213 #if defined(_ISOC99_SOURCE) || (__STDC_VERSION__ - 0) >= 199901L || \ 214 defined(_NETBSD_SOURCE) || (__cplusplus - 0) >= 201103L 215 216 /* LONGLONG */ 217 long long int atoll(const char *); 218 /* LONGLONG */ 219 long long int llabs(long long int); 220 /* LONGLONG */ 221 lldiv_t lldiv(long long int, long long int); 222 /* LONGLONG */ 223 long long int strtoll(const char * __restrict, char ** __restrict, int); 224 /* LONGLONG */ 225 unsigned long long int 226 strtoull(const char * __restrict, char ** __restrict, int); 227 float strtof(const char * __restrict, char ** __restrict); 228 long double strtold(const char * __restrict, char ** __restrict); 229 #endif 230 231 #if defined(_ISOC11_SOURCE) || (__STDC_VERSION__ - 0) >= 201101L || \ 232 defined(_NETBSD_SOURCE) || (__cplusplus - 0) >= 201103L 233 void *aligned_alloc(size_t, size_t); 234 int at_quick_exit(void (*)(void)); 235 __dead void quick_exit(int); 236 #endif 237 238 /* 239 * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX) 240 */ 241 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 600 || \ 242 defined(_NETBSD_SOURCE) 243 int setenv(const char *, const char *, int); 244 #ifndef __LIBC12_SOURCE__ 245 int unsetenv(const char *) __RENAME(__unsetenv13); 246 #endif 247 248 int posix_openpt(int); 249 int posix_memalign(void **, size_t, size_t); 250 #endif 251 252 /* 253 * The Open Group Base Specifications, Issue 7; IEEE Std 1003.1-2008 (POSIX) 254 * or 255 * X/Open Portability Guide >= Issue 4 Version 2 256 */ 257 #if (_POSIX_C_SOURCE - 0) >= 200809L || \ 258 (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \ 259 (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE) 260 char *mkdtemp(char *); 261 int mkstemp(char *); 262 263 int getsubopt(char **, char * const *, char **); 264 #endif 265 266 /* 267 * Implementation-defined extensions 268 */ 269 #if defined(_NETBSD_SOURCE) 270 #if defined(__PCC__) && !defined(__GNUC__) 271 #define alloca(size) __builtin_alloca(size) 272 #else 273 void *alloca(size_t); 274 #endif /* __GNUC__ */ 275 276 uint32_t arc4random(void); 277 void arc4random_stir(void); 278 void arc4random_buf(void *, size_t); 279 uint32_t arc4random_uniform(uint32_t); 280 void arc4random_addrandom(unsigned char *, int); 281 char *getbsize(int *, long *); 282 char *cgetcap(char *, const char *, int); 283 int cgetclose(void); 284 int cgetent(char **, const char * const *, const char *); 285 int cgetfirst(char **, const char * const *); 286 int cgetmatch(const char *, const char *); 287 int cgetnext(char **, const char * const *); 288 int cgetnum(char *, const char *, long *); 289 int cgetset(const char *); 290 int cgetstr(char *, const char *, char **); 291 int cgetustr(char *, const char *, char **); 292 void csetexpandtc(int); 293 294 int daemon(int, int); 295 int devname_r(dev_t, mode_t, char *, size_t); 296 #ifndef __LIBC12_SOURCE__ 297 __aconst char *devname(dev_t, mode_t) __RENAME(__devname50); 298 #endif 299 300 #define HN_DECIMAL 0x01 301 #define HN_NOSPACE 0x02 302 #define HN_B 0x04 303 #define HN_DIVISOR_1000 0x08 304 305 #define HN_GETSCALE 0x10 306 #define HN_AUTOSCALE 0x20 307 308 int humanize_number(char *, size_t, int64_t, const char *, int, int); 309 int dehumanize_number(const char *, int64_t *); 310 ssize_t hmac(const char *, const void *, size_t, const void *, size_t, void *, 311 size_t); 312 313 devmajor_t getdevmajor(const char *, mode_t); 314 int getloadavg(double [], int); 315 316 int getenv_r(const char *, char *, size_t); 317 318 void cfree(void *); 319 320 int heapsort(void *, size_t, size_t, int (*)(const void *, const void *)); 321 int mergesort(void *, size_t, size_t, 322 int (*)(const void *, const void *)); 323 int ptsname_r(int, char *, size_t); 324 int radixsort(const unsigned char **, int, const unsigned char *, 325 unsigned); 326 int sradixsort(const unsigned char **, int, const unsigned char *, 327 unsigned); 328 329 void mi_vector_hash(const void * __restrict, size_t, uint32_t, 330 uint32_t[3]); 331 332 void setproctitle(const char *, ...) 333 __printflike(1, 2); 334 const char *getprogname(void) __constfunc; 335 void setprogname(const char *); 336 337 quad_t qabs(quad_t); 338 quad_t strtoq(const char * __restrict, char ** __restrict, int); 339 u_quad_t strtouq(const char * __restrict, char ** __restrict, int); 340 341 /* LONGLONG */ 342 long long strsuftoll(const char *, const char *, long long, long long); 343 /* LONGLONG */ 344 long long strsuftollx(const char *, const char *, long long, long long, 345 char *, size_t); 346 347 int l64a_r(long, char *, int); 348 349 size_t shquote(const char *, char *, size_t); 350 size_t shquotev(int, char * const *, char *, size_t); 351 352 int reallocarr(void *, size_t, size_t); 353 #endif /* _NETBSD_SOURCE */ 354 #endif /* _POSIX_C_SOURCE || _XOPEN_SOURCE || _NETBSD_SOURCE */ 355 356 #if defined(_NETBSD_SOURCE) 357 qdiv_t qdiv(quad_t, quad_t); 358 #endif 359 360 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE) 361 # ifndef __LOCALE_T_DECLARED 362 typedef struct _locale *locale_t; 363 # define __LOCALE_T_DECLARED 364 # endif 365 double strtod_l(const char * __restrict, char ** __restrict, locale_t); 366 float strtof_l(const char * __restrict, char ** __restrict, locale_t); 367 long double strtold_l(const char * __restrict, char ** __restrict, 368 locale_t); 369 long strtol_l(const char * __restrict, char ** __restrict, int, locale_t); 370 unsigned long 371 strtoul_l(const char * __restrict, char ** __restrict, int, locale_t); 372 /* LONGLONG */ 373 long long int 374 strtoll_l(const char * __restrict, char ** __restrict, int, locale_t); 375 /* LONGLONG */ 376 unsigned long long int 377 strtoull_l(const char * __restrict, char ** __restrict, int, locale_t); 378 379 # if defined(_NETBSD_SOURCE) 380 quad_t strtoq_l(const char * __restrict, char ** __restrict, int, locale_t); 381 u_quad_t strtouq_l(const char * __restrict, char ** __restrict, int, locale_t); 382 383 size_t _mb_cur_max_l(locale_t); 384 #define MB_CUR_MAX_L(loc) _mb_cur_max_l(loc) 385 int mblen_l(const char *, size_t, locale_t); 386 size_t mbstowcs_l(wchar_t * __restrict, const char * __restrict, size_t, 387 locale_t); 388 int wctomb_l(char *, wchar_t, locale_t); 389 int mbtowc_l(wchar_t * __restrict, const char * __restrict, size_t, 390 locale_t); 391 size_t wcstombs_l(char * __restrict, const wchar_t * __restrict, size_t, 392 locale_t); 393 394 # endif /* _NETBSD_SOURCE */ 395 #endif /* _POSIX_C_SOURCE >= 200809 || _NETBSD_SOURCE */ 396 397 #if (_POSIX_C_SOURCE - 0) >= 202405L || \ 398 defined(_NETBSD_SOURCE) || defined(_OPENBSD_SOURCE) 399 void *reallocarray(void *, size_t, size_t); 400 #endif /* _POSIX_C_SOURCE >= 202405L || _NETBSD_SOURCE || _OPENBSD_SOURCE */ 401 402 __END_DECLS 403 404 #endif /* !_STDLIB_H_ */ 405