xref: /freebsd/include/stdlib.h (revision f6ab8089c6f3c01370add0f7e9a940b8bfbc8ee5)
159deaec5SRodney W. Grimes /*-
259deaec5SRodney W. Grimes  * Copyright (c) 1990, 1993
359deaec5SRodney W. Grimes  *	The Regents of the University of California.  All rights reserved.
459deaec5SRodney W. Grimes  *
559deaec5SRodney W. Grimes  * Redistribution and use in source and binary forms, with or without
659deaec5SRodney W. Grimes  * modification, are permitted provided that the following conditions
759deaec5SRodney W. Grimes  * are met:
859deaec5SRodney W. Grimes  * 1. Redistributions of source code must retain the above copyright
959deaec5SRodney W. Grimes  *    notice, this list of conditions and the following disclaimer.
1059deaec5SRodney W. Grimes  * 2. Redistributions in binary form must reproduce the above copyright
1159deaec5SRodney W. Grimes  *    notice, this list of conditions and the following disclaimer in the
1259deaec5SRodney W. Grimes  *    documentation and/or other materials provided with the distribution.
13f2556687SWarner Losh  * 3. Neither the name of the University nor the names of its contributors
1459deaec5SRodney W. Grimes  *    may be used to endorse or promote products derived from this software
1559deaec5SRodney W. Grimes  *    without specific prior written permission.
1659deaec5SRodney W. Grimes  *
1759deaec5SRodney W. Grimes  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
1859deaec5SRodney W. Grimes  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1959deaec5SRodney W. Grimes  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2059deaec5SRodney W. Grimes  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2159deaec5SRodney W. Grimes  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2259deaec5SRodney W. Grimes  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2359deaec5SRodney W. Grimes  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2459deaec5SRodney W. Grimes  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2559deaec5SRodney W. Grimes  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2659deaec5SRodney W. Grimes  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2759deaec5SRodney W. Grimes  * SUCH DAMAGE.
2859deaec5SRodney W. Grimes  *
29c59376afSPeter Wemm  *	@(#)stdlib.h	8.5 (Berkeley) 5/19/95
30dea750aeSBruce Evans  * $FreeBSD$
3159deaec5SRodney W. Grimes  */
3259deaec5SRodney W. Grimes 
3359deaec5SRodney W. Grimes #ifndef _STDLIB_H_
3459deaec5SRodney W. Grimes #define	_STDLIB_H_
3559deaec5SRodney W. Grimes 
3685b46962SBruce Evans #include <sys/cdefs.h>
3712eb46c8SMarcel Moolenaar #include <sys/_null.h>
38abbd8902SMike Barcroft #include <sys/_types.h>
3959deaec5SRodney W. Grimes 
403ecc48e2SGarrett Wollman #if __BSD_VISIBLE
41abbd8902SMike Barcroft #ifndef _RUNE_T_DECLARED
42abbd8902SMike Barcroft typedef	__rune_t	rune_t;
43abbd8902SMike Barcroft #define	_RUNE_T_DECLARED
44cdd84b02SBruce Evans #endif
45cdd84b02SBruce Evans #endif
46cdd84b02SBruce Evans 
47abbd8902SMike Barcroft #ifndef _SIZE_T_DECLARED
48abbd8902SMike Barcroft typedef	__size_t	size_t;
49abbd8902SMike Barcroft #define	_SIZE_T_DECLARED
5059deaec5SRodney W. Grimes #endif
5159deaec5SRodney W. Grimes 
526087d244SDavid E. O'Brien #ifndef	__cplusplus
53abbd8902SMike Barcroft #ifndef _WCHAR_T_DECLARED
54abbd8902SMike Barcroft typedef	__wchar_t	wchar_t;
55abbd8902SMike Barcroft #define	_WCHAR_T_DECLARED
5659deaec5SRodney W. Grimes #endif
576087d244SDavid E. O'Brien #endif
5859deaec5SRodney W. Grimes 
5959deaec5SRodney W. Grimes typedef struct {
6059deaec5SRodney W. Grimes 	int	quot;		/* quotient */
6159deaec5SRodney W. Grimes 	int	rem;		/* remainder */
6259deaec5SRodney W. Grimes } div_t;
6359deaec5SRodney W. Grimes 
6459deaec5SRodney W. Grimes typedef struct {
65a4c8a68cSBruce Evans 	long	quot;
66a4c8a68cSBruce Evans 	long	rem;
6759deaec5SRodney W. Grimes } ldiv_t;
6859deaec5SRodney W. Grimes 
6959deaec5SRodney W. Grimes #define	EXIT_FAILURE	1
7059deaec5SRodney W. Grimes #define	EXIT_SUCCESS	0
7159deaec5SRodney W. Grimes 
7259deaec5SRodney W. Grimes #define	RAND_MAX	0x7fffffff
7359deaec5SRodney W. Grimes 
7459deaec5SRodney W. Grimes __BEGIN_DECLS
753c87aa1dSDavid Chisnall extern int __mb_cur_max;
763c87aa1dSDavid Chisnall extern int ___mb_cur_max(void);
773c87aa1dSDavid Chisnall #define	MB_CUR_MAX	(___mb_cur_max())
783c87aa1dSDavid Chisnall 
7957979d1bSDavid Chisnall _Noreturn void	 abort(void);
80bb28f3c2SWarner Losh int	 abs(int) __pure2;
81bb28f3c2SWarner Losh int	 atexit(void (*)(void));
82bb28f3c2SWarner Losh double	 atof(const char *);
83bb28f3c2SWarner Losh int	 atoi(const char *);
84bb28f3c2SWarner Losh long	 atol(const char *);
85bb28f3c2SWarner Losh void	*bsearch(const void *, const void *, size_t,
86bb28f3c2SWarner Losh 	    size_t, int (*)(const void *, const void *));
87544048ecSDavid Schultz void	*calloc(size_t, size_t) __malloc_like;
88bb28f3c2SWarner Losh div_t	 div(int, int) __pure2;
8957979d1bSDavid Chisnall _Noreturn void	 exit(int);
90bb28f3c2SWarner Losh void	 free(void *);
91bb28f3c2SWarner Losh char	*getenv(const char *);
92bb28f3c2SWarner Losh long	 labs(long) __pure2;
93bb28f3c2SWarner Losh ldiv_t	 ldiv(long, long) __pure2;
94544048ecSDavid Schultz void	*malloc(size_t) __malloc_like;
953ecc48e2SGarrett Wollman int	 mblen(const char *, size_t);
963ecc48e2SGarrett Wollman size_t	 mbstowcs(wchar_t * __restrict , const char * __restrict, size_t);
973ecc48e2SGarrett Wollman int	 mbtowc(wchar_t * __restrict, const char * __restrict, size_t);
98bb28f3c2SWarner Losh void	 qsort(void *, size_t, size_t,
99bb28f3c2SWarner Losh 	    int (*)(const void *, const void *));
100bb28f3c2SWarner Losh int	 rand(void);
101bb28f3c2SWarner Losh void	*realloc(void *, size_t);
102bb28f3c2SWarner Losh void	 srand(unsigned);
1035618f724SRobert Drehmel double	 strtod(const char * __restrict, char ** __restrict);
1046a66acb5SDavid Schultz float	 strtof(const char * __restrict, char ** __restrict);
1055618f724SRobert Drehmel long	 strtol(const char * __restrict, char ** __restrict, int);
1066a66acb5SDavid Schultz long double
1076a66acb5SDavid Schultz 	 strtold(const char * __restrict, char ** __restrict);
10859deaec5SRodney W. Grimes unsigned long
1095618f724SRobert Drehmel 	 strtoul(const char * __restrict, char ** __restrict, int);
110bb28f3c2SWarner Losh int	 system(const char *);
111bb28f3c2SWarner Losh int	 wctomb(char *, wchar_t);
1129771f1e2STim J. Robbins size_t	 wcstombs(char * __restrict, const wchar_t * __restrict, size_t);
11359deaec5SRodney W. Grimes 
1143ecc48e2SGarrett Wollman /*
1153ecc48e2SGarrett Wollman  * Functions added in C99 which we make conditionally available in the
1163ecc48e2SGarrett Wollman  * BSD^C89 namespace if the compiler supports `long long'.
1173ecc48e2SGarrett Wollman  * The #if test is more complicated than it ought to be because
1183ecc48e2SGarrett Wollman  * __BSD_VISIBLE implies __ISO_C_VISIBLE == 1999 *even if* `long long'
1193ecc48e2SGarrett Wollman  * is not supported in the compilation environment (which therefore means
1203ecc48e2SGarrett Wollman  * that it can't really be ISO C99).
1213ecc48e2SGarrett Wollman  *
1223ecc48e2SGarrett Wollman  * (The only other extension made by C99 in thie header is _Exit().)
1233ecc48e2SGarrett Wollman  */
1243ecc48e2SGarrett Wollman #if __ISO_C_VISIBLE >= 1999
1253ecc48e2SGarrett Wollman #ifdef __LONG_LONG_SUPPORTED
1263ecc48e2SGarrett Wollman /* LONGLONG */
1273ecc48e2SGarrett Wollman typedef struct {
1283ecc48e2SGarrett Wollman 	long long quot;
1293ecc48e2SGarrett Wollman 	long long rem;
1303ecc48e2SGarrett Wollman } lldiv_t;
131798c1fd8SPoul-Henning Kamp 
1323ecc48e2SGarrett Wollman /* LONGLONG */
1333ecc48e2SGarrett Wollman long long
1343ecc48e2SGarrett Wollman 	 atoll(const char *);
1353ecc48e2SGarrett Wollman /* LONGLONG */
1363ecc48e2SGarrett Wollman long long
1373ecc48e2SGarrett Wollman 	 llabs(long long) __pure2;
1383ecc48e2SGarrett Wollman /* LONGLONG */
1393ecc48e2SGarrett Wollman lldiv_t	 lldiv(long long, long long) __pure2;
1403ecc48e2SGarrett Wollman /* LONGLONG */
1413ecc48e2SGarrett Wollman long long
1423ecc48e2SGarrett Wollman 	 strtoll(const char * __restrict, char ** __restrict, int);
1433ecc48e2SGarrett Wollman /* LONGLONG */
1443ecc48e2SGarrett Wollman unsigned long long
1453ecc48e2SGarrett Wollman 	 strtoull(const char * __restrict, char ** __restrict, int);
1463ecc48e2SGarrett Wollman #endif /* __LONG_LONG_SUPPORTED */
1473ecc48e2SGarrett Wollman 
14857979d1bSDavid Chisnall _Noreturn void	 _Exit(int);
1493ecc48e2SGarrett Wollman #endif /* __ISO_C_VISIBLE >= 1999 */
1503ecc48e2SGarrett Wollman 
1513ecc48e2SGarrett Wollman /*
1520a31efe0SDavid Chisnall  * If we're in a mode greater than C99, expose C1x functions.
1530a31efe0SDavid Chisnall  */
1540a31efe0SDavid Chisnall #if __ISO_C_VISIBLE > 1999
15557979d1bSDavid Chisnall _Noreturn void quick_exit(int)
1560a31efe0SDavid Chisnall int
1570a31efe0SDavid Chisnall at_quick_exit(void (*func)(void));
1580a31efe0SDavid Chisnall #endif /* __ISO_C_VISIBLE > 1999 */
1590a31efe0SDavid Chisnall /*
1603ecc48e2SGarrett Wollman  * Extensions made by POSIX relative to C.  We don't know yet which edition
1613ecc48e2SGarrett Wollman  * of POSIX made these extensions, so assume they've always been there until
1623ecc48e2SGarrett Wollman  * research can be done.
1633ecc48e2SGarrett Wollman  */
1643ecc48e2SGarrett Wollman #if __POSIX_VISIBLE /* >= ??? */
165b3d51d3aSJason Evans int	 posix_memalign(void **, size_t, size_t); /* (ADV) */
1663ecc48e2SGarrett Wollman int	 rand_r(unsigned *);			/* (TSF) */
167585b8e0fSKonstantin Belousov char	*realpath(const char * __restrict, char * __restrict);
168bb28f3c2SWarner Losh int	 setenv(const char *, const char *, int);
1692966d28cSSean Farley int	 unsetenv(const char *);
1703ecc48e2SGarrett Wollman #endif
17159deaec5SRodney W. Grimes 
17265e8b129SDavid Schultz #if __POSIX_VISIBLE >= 200809 || __XSI_VISIBLE
17365e8b129SDavid Schultz int	 getsubopt(char **, char *const *, char **);
17465e8b129SDavid Schultz #ifndef _MKDTEMP_DECLARED
17565e8b129SDavid Schultz char	*mkdtemp(char *);
17665e8b129SDavid Schultz #define	_MKDTEMP_DECLARED
17765e8b129SDavid Schultz #endif
17865e8b129SDavid Schultz #ifndef _MKSTEMP_DECLARED
17965e8b129SDavid Schultz int	 mkstemp(char *);
18065e8b129SDavid Schultz #define	_MKSTEMP_DECLARED
18165e8b129SDavid Schultz #endif
18265e8b129SDavid Schultz #endif /* __POSIX_VISIBLE >= 200809 || __XSI_VISIBLE */
18365e8b129SDavid Schultz 
1843ecc48e2SGarrett Wollman /*
1853ecc48e2SGarrett Wollman  * The only changes to the XSI namespace in revision 6 were the deletion
1863ecc48e2SGarrett Wollman  * of the ttyslot() and valloc() functions, which FreeBSD never declared
1873ecc48e2SGarrett Wollman  * in this header.  For revision 7, ecvt(), fcvt(), and gcvt(), which
1883ecc48e2SGarrett Wollman  * FreeBSD also does not have, and mktemp(), are to be deleted.
1893ecc48e2SGarrett Wollman  */
1903ecc48e2SGarrett Wollman #if __XSI_VISIBLE
1913ecc48e2SGarrett Wollman /* XXX XSI requires pollution from <sys/wait.h> here.  We'd rather not. */
192257551c6STom Rhodes long	 a64l(const char *);
193bb28f3c2SWarner Losh double	 drand48(void);
1943ecc48e2SGarrett Wollman /* char	*ecvt(double, int, int * __restrict, int * __restrict); */
195bb28f3c2SWarner Losh double	 erand48(unsigned short[3]);
1963ecc48e2SGarrett Wollman /* char	*fcvt(double, int, int * __restrict, int * __restrict); */
1973ecc48e2SGarrett Wollman /* char	*gcvt(double, int, int * __restrict, int * __restrict); */
198d3951ad1SJuli Mallett int	 grantpt(int);
1993ecc48e2SGarrett Wollman char	*initstate(unsigned long /* XSI requires u_int */, char *, long);
200bb28f3c2SWarner Losh long	 jrand48(unsigned short[3]);
201257551c6STom Rhodes char	*l64a(long);
202bb28f3c2SWarner Losh void	 lcong48(unsigned short[7]);
203bb28f3c2SWarner Losh long	 lrand48(void);
204d9c43159SDavid Schultz #if !defined(_MKTEMP_DECLARED) && (__BSD_VISIBLE || __XSI_VISIBLE <= 600)
2053ecc48e2SGarrett Wollman char	*mktemp(char *);
2063ecc48e2SGarrett Wollman #define	_MKTEMP_DECLARED
2073ecc48e2SGarrett Wollman #endif
208bb28f3c2SWarner Losh long	 mrand48(void);
209bb28f3c2SWarner Losh long	 nrand48(unsigned short[3]);
210d3951ad1SJuli Mallett int	 posix_openpt(int);
211d3951ad1SJuli Mallett char	*ptsname(int);
2122966d28cSSean Farley int	 putenv(char *);
2133ecc48e2SGarrett Wollman long	 random(void);
21467c54240SBruce Evans unsigned short
215bb28f3c2SWarner Losh 	*seed48(unsigned short[3]);
2163ecc48e2SGarrett Wollman #ifndef _SETKEY_DECLARED
2173ecc48e2SGarrett Wollman int	 setkey(const char *);
2183ecc48e2SGarrett Wollman #define	_SETKEY_DECLARED
2193ecc48e2SGarrett Wollman #endif
2203ecc48e2SGarrett Wollman char	*setstate(/* const */ char *);
221bb28f3c2SWarner Losh void	 srand48(long);
2223ecc48e2SGarrett Wollman void	 srandom(unsigned long);
223d3951ad1SJuli Mallett int	 unlockpt(int);
2243ecc48e2SGarrett Wollman #endif /* __XSI_VISIBLE */
2253ecc48e2SGarrett Wollman 
2263ecc48e2SGarrett Wollman #if __BSD_VISIBLE
2273ecc48e2SGarrett Wollman extern const char *_malloc_options;
228a4c8a68cSBruce Evans extern void (*_malloc_message)(const char *, const char *, const char *,
229a4c8a68cSBruce Evans 	    const char *);
230f8f6d0dcSAndreas Schulz 
23179806b4cSDag-Erling Smørgrav /*
23279806b4cSDag-Erling Smørgrav  * The alloca() function can't be implemented in C, and on some
23379806b4cSDag-Erling Smørgrav  * platforms it can't be implemented at all as a callable function.
23479806b4cSDag-Erling Smørgrav  * The GNU C compiler provides a built-in alloca() which we can use;
23579806b4cSDag-Erling Smørgrav  * in all other cases, provide a prototype, mainly to pacify various
23679806b4cSDag-Erling Smørgrav  * incarnations of lint.  On platforms where alloca() is not in libc,
23779806b4cSDag-Erling Smørgrav  * programs which use it will fail to link when compiled with non-GNU
23879806b4cSDag-Erling Smørgrav  * compilers.
23979806b4cSDag-Erling Smørgrav  */
240d7875fc3SDavid E. O'Brien #if __GNUC__ >= 2 || defined(__INTEL_COMPILER)
241d7875fc3SDavid E. O'Brien #undef  alloca	/* some GNU bits try to get cute and define this on their own */
24279806b4cSDag-Erling Smørgrav #define alloca(sz) __builtin_alloca(sz)
243d7875fc3SDavid E. O'Brien #elif defined(lint)
24479806b4cSDag-Erling Smørgrav void	*alloca(size_t);
24579806b4cSDag-Erling Smørgrav #endif
24679806b4cSDag-Erling Smørgrav 
247b38a55d4SDavid Schultz void	 abort2(const char *, int, void **) __dead2;
2488252a465SDmitrij Tejblum __uint32_t
249bb28f3c2SWarner Losh 	 arc4random(void);
2503204108bSAndrey A. Chernov void	 arc4random_addrandom(unsigned char *, int);
2513204108bSAndrey A. Chernov void	 arc4random_buf(void *, size_t);
252bb28f3c2SWarner Losh void	 arc4random_stir(void);
253c0046493SAndrey A. Chernov __uint32_t
254c0046493SAndrey A. Chernov 	 arc4random_uniform(__uint32_t);
255c2e55537SDavid E. O'Brien char	*getbsize(int *, long *);
2563ecc48e2SGarrett Wollman 					/* getcap(3) functions */
257bb28f3c2SWarner Losh char	*cgetcap(char *, const char *, int);
258bb28f3c2SWarner Losh int	 cgetclose(void);
259bb28f3c2SWarner Losh int	 cgetent(char **, char **, const char *);
260bb28f3c2SWarner Losh int	 cgetfirst(char **, char **);
261bb28f3c2SWarner Losh int	 cgetmatch(const char *, const char *);
262bb28f3c2SWarner Losh int	 cgetnext(char **, char **);
263bb28f3c2SWarner Losh int	 cgetnum(char *, const char *, long *);
264bb28f3c2SWarner Losh int	 cgetset(const char *);
265bb28f3c2SWarner Losh int	 cgetstr(char *, const char *, char **);
266bb28f3c2SWarner Losh int	 cgetustr(char *, const char *, char **);
26759deaec5SRodney W. Grimes 
268bb28f3c2SWarner Losh int	 daemon(int, int);
2699d301680SStefan Farfeleder char	*devname(__dev_t, __mode_t);
2709d301680SStefan Farfeleder char 	*devname_r(__dev_t, __mode_t, char *, int);
27126d4f5e9SEd Schouten char	*fdevname(int);
27226d4f5e9SEd Schouten char 	*fdevname_r(int, char *, int);
273bb28f3c2SWarner Losh int	 getloadavg(double [], int);
274*f6ab8089SEd Schouten const char *
275bb28f3c2SWarner Losh 	 getprogname(void);
27659deaec5SRodney W. Grimes 
277bb28f3c2SWarner Losh int	 heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
278257551c6STom Rhodes int	 l64a_r(long, char *, int);
279bb28f3c2SWarner Losh int	 mergesort(void *, size_t, size_t, int (*)(const void *, const void *));
2800855f655SGarrett Wollman void	 qsort_r(void *, size_t, size_t, void *,
2810855f655SGarrett Wollman 	    int (*)(void *, const void *, const void *));
282bb28f3c2SWarner Losh int	 radixsort(const unsigned char **, int, const unsigned char *,
283bb28f3c2SWarner Losh 	    unsigned);
284bb28f3c2SWarner Losh void    *reallocf(void *, size_t);
28517ebe400STim J. Robbins int	 rpmatch(const char *);
286bb28f3c2SWarner Losh void	 setprogname(const char *);
2870855f655SGarrett Wollman int	 sradixsort(const unsigned char **, int, const unsigned char *,
2880855f655SGarrett Wollman 	    unsigned);
289bb28f3c2SWarner Losh void	 sranddev(void);
290bb28f3c2SWarner Losh void	 srandomdev(void);
291c74dfa2fSAndre Oppermann long long
292c74dfa2fSAndre Oppermann 	strtonum(const char *, long long, long long, const char **);
2933ecc48e2SGarrett Wollman 
2943ecc48e2SGarrett Wollman /* Deprecated interfaces, to be removed in FreeBSD 6.0. */
295a4c8a68cSBruce Evans __int64_t
296a4c8a68cSBruce Evans 	 strtoq(const char *, char **, int);
2978252a465SDmitrij Tejblum __uint64_t
298bb28f3c2SWarner Losh 	 strtouq(const char *, char **, int);
2998720578dSAndrey A. Chernov 
3008720578dSAndrey A. Chernov extern char *suboptarg;			/* getsubopt(3) external variable */
3013ecc48e2SGarrett Wollman #endif /* __BSD_VISIBLE */
30259deaec5SRodney W. Grimes __END_DECLS
30359deaec5SRodney W. Grimes 
30467c54240SBruce Evans #endif /* !_STDLIB_H_ */
305