stdlib.h revision 153707
1234949Sbapt/*- 2234949Sbapt * Copyright (c) 1990, 1993 3234949Sbapt * The Regents of the University of California. All rights reserved. 4234949Sbapt * 5234949Sbapt * Redistribution and use in source and binary forms, with or without 6234949Sbapt * modification, are permitted provided that the following conditions 7234949Sbapt * are met: 8234949Sbapt * 1. Redistributions of source code must retain the above copyright 9234949Sbapt * notice, this list of conditions and the following disclaimer. 10234949Sbapt * 2. Redistributions in binary form must reproduce the above copyright 11234949Sbapt * notice, this list of conditions and the following disclaimer in the 12234949Sbapt * documentation and/or other materials provided with the distribution. 13234949Sbapt * 3. All advertising materials mentioning features or use of this software 14234949Sbapt * must display the following acknowledgement: 15234949Sbapt * This product includes software developed by the University of 16234949Sbapt * California, Berkeley and its contributors. 17234949Sbapt * 4. Neither the name of the University nor the names of its contributors 18234949Sbapt * may be used to endorse or promote products derived from this software 19234949Sbapt * without specific prior written permission. 20234949Sbapt * 21234949Sbapt * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 22234949Sbapt * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23234949Sbapt * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24234949Sbapt * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 25234949Sbapt * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 26234949Sbapt * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27234949Sbapt * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28234949Sbapt * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29234949Sbapt * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30234949Sbapt * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31234949Sbapt * SUCH DAMAGE. 32234949Sbapt * 33234949Sbapt * @(#)stdlib.h 8.5 (Berkeley) 5/19/95 34234949Sbapt * $FreeBSD: head/include/stdlib.h 153707 2005-12-24 22:37:59Z trhodes $ 35234949Sbapt */ 36234949Sbapt 37234949Sbapt#ifndef _STDLIB_H_ 38234949Sbapt#define _STDLIB_H_ 39234949Sbapt 40234949Sbapt#include <sys/cdefs.h> 41234949Sbapt#include <sys/_null.h> 42234949Sbapt#include <sys/_types.h> 43234949Sbapt 44234949Sbapt#if __BSD_VISIBLE 45234949Sbapt#ifndef _RUNE_T_DECLARED 46234949Sbapttypedef __rune_t rune_t; 47234949Sbapt#define _RUNE_T_DECLARED 48234949Sbapt#endif 49234949Sbapt#endif 50234949Sbapt 51234949Sbapt#ifndef _SIZE_T_DECLARED 52234949Sbapttypedef __size_t size_t; 53234949Sbapt#define _SIZE_T_DECLARED 54234949Sbapt#endif 55234949Sbapt 56234949Sbapt#ifndef __cplusplus 57234949Sbapt#ifndef _WCHAR_T_DECLARED 58234949Sbapttypedef __wchar_t wchar_t; 59234949Sbapt#define _WCHAR_T_DECLARED 60234949Sbapt#endif 61234949Sbapt#endif 62234949Sbapt 63234949Sbapttypedef struct { 64234949Sbapt int quot; /* quotient */ 65234949Sbapt int rem; /* remainder */ 66234949Sbapt} div_t; 67234949Sbapt 68234949Sbapttypedef struct { 69234949Sbapt long quot; 70234949Sbapt long rem; 71234949Sbapt} ldiv_t; 72234949Sbapt 73234949Sbapt#define EXIT_FAILURE 1 74234949Sbapt#define EXIT_SUCCESS 0 75234949Sbapt 76234949Sbapt#define RAND_MAX 0x7fffffff 77234949Sbapt 78234949Sbaptextern int __mb_cur_max; 79234949Sbapt#define MB_CUR_MAX __mb_cur_max 80234949Sbapt 81234949Sbapt__BEGIN_DECLS 82234949Sbaptvoid abort(void) __dead2; 83234949Sbaptvoid abort2(const char *, int, void **) __dead2; 84234949Sbaptint abs(int) __pure2; 85234949Sbaptint atexit(void (*)(void)); 86234949Sbaptdouble atof(const char *); 87234949Sbaptint atoi(const char *); 88234949Sbaptlong atol(const char *); 89234949Sbaptvoid *bsearch(const void *, const void *, size_t, 90234949Sbapt size_t, int (*)(const void *, const void *)); 91234949Sbaptvoid *calloc(size_t, size_t); 92234949Sbaptdiv_t div(int, int) __pure2; 93234949Sbaptvoid exit(int) __dead2; 94234949Sbaptvoid free(void *); 95234949Sbaptchar *getenv(const char *); 96234949Sbaptlong labs(long) __pure2; 97234949Sbaptldiv_t ldiv(long, long) __pure2; 98234949Sbaptvoid *malloc(size_t); 99234949Sbaptint mblen(const char *, size_t); 100234949Sbaptsize_t mbstowcs(wchar_t * __restrict , const char * __restrict, size_t); 101234949Sbaptint mbtowc(wchar_t * __restrict, const char * __restrict, size_t); 102234949Sbaptvoid qsort(void *, size_t, size_t, 103234949Sbapt int (*)(const void *, const void *)); 104234949Sbaptint rand(void); 105234949Sbaptvoid *realloc(void *, size_t); 106234949Sbaptvoid srand(unsigned); 107234949Sbaptdouble strtod(const char * __restrict, char ** __restrict); 108234949Sbaptfloat strtof(const char * __restrict, char ** __restrict); 109234949Sbaptlong strtol(const char * __restrict, char ** __restrict, int); 110234949Sbaptlong double 111234949Sbapt strtold(const char * __restrict, char ** __restrict); 112234949Sbaptunsigned long 113 strtoul(const char * __restrict, char ** __restrict, int); 114int system(const char *); 115int wctomb(char *, wchar_t); 116size_t wcstombs(char * __restrict, const wchar_t * __restrict, size_t); 117 118/* 119 * Functions added in C99 which we make conditionally available in the 120 * BSD^C89 namespace if the compiler supports `long long'. 121 * The #if test is more complicated than it ought to be because 122 * __BSD_VISIBLE implies __ISO_C_VISIBLE == 1999 *even if* `long long' 123 * is not supported in the compilation environment (which therefore means 124 * that it can't really be ISO C99). 125 * 126 * (The only other extension made by C99 in thie header is _Exit().) 127 */ 128#if __ISO_C_VISIBLE >= 1999 129#ifdef __LONG_LONG_SUPPORTED 130/* LONGLONG */ 131typedef struct { 132 long long quot; 133 long long rem; 134} lldiv_t; 135 136/* LONGLONG */ 137long long 138 atoll(const char *); 139/* LONGLONG */ 140long long 141 llabs(long long) __pure2; 142/* LONGLONG */ 143lldiv_t lldiv(long long, long long) __pure2; 144/* LONGLONG */ 145long long 146 strtoll(const char * __restrict, char ** __restrict, int); 147/* LONGLONG */ 148unsigned long long 149 strtoull(const char * __restrict, char ** __restrict, int); 150#endif /* __LONG_LONG_SUPPORTED */ 151 152void _Exit(int) __dead2; 153#endif /* __ISO_C_VISIBLE >= 1999 */ 154 155/* 156 * Extensions made by POSIX relative to C. We don't know yet which edition 157 * of POSIX made these extensions, so assume they've always been there until 158 * research can be done. 159 */ 160#if __POSIX_VISIBLE /* >= ??? */ 161/* int posix_memalign(void **, size_t, size_t); (ADV) */ 162int rand_r(unsigned *); /* (TSF) */ 163int setenv(const char *, const char *, int); 164void unsetenv(const char *); 165#endif 166 167/* 168 * The only changes to the XSI namespace in revision 6 were the deletion 169 * of the ttyslot() and valloc() functions, which FreeBSD never declared 170 * in this header. For revision 7, ecvt(), fcvt(), and gcvt(), which 171 * FreeBSD also does not have, and mktemp(), are to be deleted. 172 */ 173#if __XSI_VISIBLE 174/* XXX XSI requires pollution from <sys/wait.h> here. We'd rather not. */ 175long a64l(const char *); 176double drand48(void); 177/* char *ecvt(double, int, int * __restrict, int * __restrict); */ 178double erand48(unsigned short[3]); 179/* char *fcvt(double, int, int * __restrict, int * __restrict); */ 180/* char *gcvt(double, int, int * __restrict, int * __restrict); */ 181int getsubopt(char **, char *const *, char **); 182int grantpt(int); 183char *initstate(unsigned long /* XSI requires u_int */, char *, long); 184long jrand48(unsigned short[3]); 185char *l64a(long); 186void lcong48(unsigned short[7]); 187long lrand48(void); 188#ifndef _MKSTEMP_DECLARED 189int mkstemp(char *); 190#define _MKSTEMP_DECLARED 191#endif 192#ifndef _MKTEMP_DECLARED 193char *mktemp(char *); 194#define _MKTEMP_DECLARED 195#endif 196long mrand48(void); 197long nrand48(unsigned short[3]); 198int posix_openpt(int); 199char *ptsname(int); 200int putenv(const char *); 201long random(void); 202char *realpath(const char *, char resolved_path[]); 203unsigned short 204 *seed48(unsigned short[3]); 205#ifndef _SETKEY_DECLARED 206int setkey(const char *); 207#define _SETKEY_DECLARED 208#endif 209char *setstate(/* const */ char *); 210void srand48(long); 211void srandom(unsigned long); 212int unlockpt(int); 213#endif /* __XSI_VISIBLE */ 214 215#if __BSD_VISIBLE 216extern const char *_malloc_options; 217extern void (*_malloc_message)(const char *, const char *, const char *, 218 const char *); 219 220/* 221 * The alloca() function can't be implemented in C, and on some 222 * platforms it can't be implemented at all as a callable function. 223 * The GNU C compiler provides a built-in alloca() which we can use; 224 * in all other cases, provide a prototype, mainly to pacify various 225 * incarnations of lint. On platforms where alloca() is not in libc, 226 * programs which use it will fail to link when compiled with non-GNU 227 * compilers. 228 */ 229#if __GNUC__ >= 2 || defined(__INTEL_COMPILER) 230#undef alloca /* some GNU bits try to get cute and define this on their own */ 231#define alloca(sz) __builtin_alloca(sz) 232#elif defined(lint) 233void *alloca(size_t); 234#endif 235 236__uint32_t 237 arc4random(void); 238void arc4random_addrandom(unsigned char *dat, int datlen); 239void arc4random_stir(void); 240char *getbsize(int *, long *); 241 /* getcap(3) functions */ 242char *cgetcap(char *, const char *, int); 243int cgetclose(void); 244int cgetent(char **, char **, const char *); 245int cgetfirst(char **, char **); 246int cgetmatch(const char *, const char *); 247int cgetnext(char **, char **); 248int cgetnum(char *, const char *, long *); 249int cgetset(const char *); 250int cgetstr(char *, const char *, char **); 251int cgetustr(char *, const char *, char **); 252 253int daemon(int, int); 254char *devname(__dev_t, __mode_t); 255char *devname_r(__dev_t, __mode_t, char *, int); 256int getloadavg(double [], int); 257__const char * 258 getprogname(void); 259 260int heapsort(void *, size_t, size_t, int (*)(const void *, const void *)); 261int l64a_r(long, char *, int); 262int mergesort(void *, size_t, size_t, int (*)(const void *, const void *)); 263void qsort_r(void *, size_t, size_t, void *, 264 int (*)(void *, const void *, const void *)); 265int radixsort(const unsigned char **, int, const unsigned char *, 266 unsigned); 267void *reallocf(void *, size_t); 268int rpmatch(const char *); 269void setprogname(const char *); 270int sradixsort(const unsigned char **, int, const unsigned char *, 271 unsigned); 272void sranddev(void); 273void srandomdev(void); 274 275/* Deprecated interfaces, to be removed in FreeBSD 6.0. */ 276__int64_t 277 strtoq(const char *, char **, int); 278__uint64_t 279 strtouq(const char *, char **, int); 280 281extern char *suboptarg; /* getsubopt(3) external variable */ 282#endif /* __BSD_VISIBLE */ 283__END_DECLS 284 285#endif /* !_STDLIB_H_ */ 286