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