Home | History | Annotate | Line # | Download | only in include
      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