Annotation of src/include/stdlib.h, Revision 1.63
1.63 ! tedu 1: /* $OpenBSD: stdlib.h,v 1.62 2014/12/08 21:45:19 deraadt Exp $ */
1.2 deraadt 2: /* $NetBSD: stdlib.h,v 1.25 1995/12/27 21:19:08 jtc Exp $ */
1.1 deraadt 3:
4: /*-
5: * Copyright (c) 1990 The Regents of the University of California.
6: * All rights reserved.
7: *
8: * Redistribution and use in source and binary forms, with or without
9: * modification, are permitted provided that the following conditions
10: * are met:
11: * 1. Redistributions of source code must retain the above copyright
12: * notice, this list of conditions and the following disclaimer.
13: * 2. Redistributions in binary form must reproduce the above copyright
14: * notice, this list of conditions and the following disclaimer in the
15: * documentation and/or other materials provided with the distribution.
1.25 millert 16: * 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 17: * may be used to endorse or promote products derived from this software
18: * without specific prior written permission.
19: *
20: * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23: * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30: * SUCH DAMAGE.
31: *
32: * @(#)stdlib.h 5.13 (Berkeley) 6/4/91
33: */
34:
35: #ifndef _STDLIB_H_
36: #define _STDLIB_H_
37:
1.35 millert 38: #include <sys/cdefs.h>
1.36 millert 39: #include <machine/_types.h>
40: #if __BSD_VISIBLE /* for quad_t, etc. (XXX - use protected types) */
1.1 deraadt 41: #include <sys/types.h>
42: #endif
43:
1.36 millert 44: #ifndef _SIZE_T_DEFINED_
45: #define _SIZE_T_DEFINED_
46: typedef __size_t size_t;
1.1 deraadt 47: #endif
48:
1.11 espie 49: /* in C++, wchar_t is a built-in type */
1.36 millert 50: #if !defined(_WCHAR_T_DEFINED_) && !defined(__cplusplus)
51: #define _WCHAR_T_DEFINED_
52: typedef __wchar_t wchar_t;
1.1 deraadt 53: #endif
54:
55: typedef struct {
56: int quot; /* quotient */
57: int rem; /* remainder */
58: } div_t;
59:
60: typedef struct {
61: long quot; /* quotient */
62: long rem; /* remainder */
63: } ldiv_t;
64:
1.37 millert 65: #if __ISO_C_VISIBLE >= 1999
66: typedef struct {
67: long long quot; /* quotient */
68: long long rem; /* remainder */
69: } lldiv_t;
70: #endif
71:
1.35 millert 72: #if __BSD_VISIBLE
1.1 deraadt 73: typedef struct {
74: quad_t quot; /* quotient */
75: quad_t rem; /* remainder */
76: } qdiv_t;
77: #endif
78:
79:
80: #ifndef NULL
1.10 espie 81: #ifdef __GNUG__
82: #define NULL __null
1.49 jsg 83: #elif defined(__cplusplus)
84: #define NULL 0L
1.10 espie 85: #else
1.48 miod 86: #define NULL ((void *)0)
1.10 espie 87: #endif
1.1 deraadt 88: #endif
89:
90: #define EXIT_FAILURE 1
91: #define EXIT_SUCCESS 0
92:
93: #define RAND_MAX 0x7fffffff
94:
1.33 espie 95: extern size_t __mb_cur_max;
96: #define MB_CUR_MAX __mb_cur_max
1.1 deraadt 97:
98: #include <sys/cdefs.h>
99:
1.18 millert 100: /*
101: * Some header files may define an abs macro.
102: * If defined, undef it to prevent a syntax error and issue a warning.
103: */
104: #ifdef abs
105: #undef abs
106: #warning abs macro collides with abs() prototype, undefining
107: #endif
108:
1.1 deraadt 109: __BEGIN_DECLS
1.16 millert 110: __dead void abort(void);
111: int abs(int);
1.17 millert 112: int atexit(void (*)(void));
1.16 millert 113: double atof(const char *);
114: int atoi(const char *);
115: long atol(const char *);
1.17 millert 116: void *bsearch(const void *, const void *, size_t, size_t,
117: int (*)(const void *, const void *));
1.16 millert 118: void *calloc(size_t, size_t);
119: div_t div(int, int);
120: __dead void exit(int);
1.30 millert 121: __dead void _Exit(int);
1.16 millert 122: void free(void *);
123: char *getenv(const char *);
124: long labs(long);
125: ldiv_t ldiv(long, long);
126: void *malloc(size_t);
1.57 deraadt 127: #if __BSD_VISIBLE
1.58 tedu 128: void *reallocarray(void *, size_t, size_t);
1.57 deraadt 129: #endif /* __BSD_VISIBLE */
1.17 millert 130: void qsort(void *, size_t, size_t, int (*)(const void *, const void *));
1.16 millert 131: int rand(void);
132: void *realloc(void *, size_t);
133: void srand(unsigned);
1.62 deraadt 134: void srand_deterministic(unsigned);
1.16 millert 135: double strtod(const char *, char **);
1.42 landry 136: float strtof(const char *, char **);
1.16 millert 137: long strtol(const char *, char **, int);
1.45 martynas 138: long double
139: strtold(const char *, char **);
1.1 deraadt 140: unsigned long
1.16 millert 141: strtoul(const char *, char **, int);
142: int system(const char *);
1.1 deraadt 143:
144: /* these are currently just stubs */
1.16 millert 145: int mblen(const char *, size_t);
146: size_t mbstowcs(wchar_t *, const char *, size_t);
147: int wctomb(char *, wchar_t);
148: int mbtowc(wchar_t *, const char *, size_t);
149: size_t wcstombs(char *, const wchar_t *, size_t);
1.1 deraadt 150:
1.35 millert 151: /*
152: * IEEE Std 1003.1c-95, also adopted by X/Open CAE Spec Issue 5 Version 2
153: */
1.50 guenther 154: #if __BSD_VISIBLE || __POSIX_VISIBLE >= 199506 || defined(_REENTRANT)
1.35 millert 155: int rand_r(unsigned int *);
156: #endif
157:
158: #if __BSD_VISIBLE || __XPG_VISIBLE >= 400
159: double drand48(void);
160: double erand48(unsigned short[3]);
161: long jrand48(unsigned short[3]);
162: void lcong48(unsigned short[7]);
1.62 deraadt 163: void lcong48_deterministic(unsigned short[7]);
1.35 millert 164: long lrand48(void);
165: long mrand48(void);
166: long nrand48(unsigned short[3]);
167: unsigned short *seed48(unsigned short[3]);
1.62 deraadt 168: unsigned short *seed48_deterministic(unsigned short[3]);
1.35 millert 169: void srand48(long);
1.62 deraadt 170: void srand48_deterministic(long);
1.35 millert 171:
1.46 millert 172: int putenv(char *);
1.35 millert 173: #endif
174:
1.50 guenther 175: /*
176: * XSI functions marked LEGACY in IEEE Std 1003.1-2001 (POSIX) and
177: * removed in IEEE Std 1003.1-2008
178: */
179: #if __BSD_VISIBLE || __XPG_VISIBLE < 700
180: char *ecvt(double, int, int *, int *);
181: char *fcvt(double, int, int *, int *);
182: char *gcvt(double, int, char *);
183: #if __BSD_VISIBLE || __XPG_VISIBLE >= 420
184: char *mktemp(char *);
185: #endif
186: #endif /* __BSD_VISIBLE || __XPG_VISIBLE < 700 */
187:
1.35 millert 188: #if __BSD_VISIBLE || __XPG_VISIBLE >= 420
189: long a64l(const char *);
190: char *l64a(long);
191:
192: char *initstate(unsigned int, char *, size_t)
193: __attribute__((__bounded__ (__string__,2,3)));
194: long random(void);
1.50 guenther 195: char *setstate(char *);
1.35 millert 196: void srandom(unsigned int);
1.62 deraadt 197: void srandom_deterministic(unsigned int);
1.35 millert 198:
1.56 martynas 199: char *realpath(const char *, char *)
200: __attribute__((__bounded__ (__minbytes__,2,1024)));
1.35 millert 201:
1.50 guenther 202: /*
203: * XSI functions marked LEGACY in XPG5 and removed in IEEE Std 1003.1-2001
204: */
205: #if __BSD_VISIBLE || __XPG_VISIBLE < 600
1.35 millert 206: int ttyslot(void);
207: void *valloc(size_t); /* obsoleted by malloc() */
1.50 guenther 208: #endif
1.35 millert 209: #endif /* __BSD_VISIBLE || __XPG_VISIBLE >= 420 */
210:
211: /*
1.50 guenther 212: * 4.4BSD, then XSI in XPG4.2, then added to POSIX base in IEEE Std 1003.1-2008
213: */
214: #if __BSD_VISIBLE || __XPG_VISIBLE >= 420 || __POSIX_VISIBLE >= 200809
215: int mkstemp(char *);
216: #endif
217:
218: /*
1.35 millert 219: * ISO C99
220: */
1.37 millert 221: #if __ISO_C_VISIBLE >= 1999
1.35 millert 222: long long
223: atoll(const char *);
224: long long
225: llabs(long long);
1.39 djm 226: lldiv_t
227: lldiv(long long, long long);
1.35 millert 228: long long
229: strtoll(const char *, char **, int);
230: unsigned long long
231: strtoull(const char *, char **, int);
232: #endif
233:
234: /*
235: * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX)
236: */
1.50 guenther 237: #if __BSD_VISIBLE || __POSIX_VISIBLE >= 200112
238: int posix_memalign(void **, size_t, size_t);
1.35 millert 239: int setenv(const char *, const char *, int);
1.46 millert 240: int unsetenv(const char *);
1.51 millert 241: #endif
242: #if __XPG_VISIBLE >= 420 || __POSIX_VISIBLE >= 200112
243: char *ptsname(int);
244: int grantpt(int);
245: int unlockpt(int);
246: #endif
247: #if __POSIX_VISIBLE >= 200112
248: int posix_openpt(int);
1.35 millert 249: #endif
250:
1.50 guenther 251: /*
252: * The Open Group Base Specifications, Issue 7; IEEE Std 1003.1-2008 (POSIX)
253: */
254: #if __BSD_VISIBLE || __POSIX_VISIBLE >= 200809
255: char *mkdtemp(char *);
256: #endif
257:
1.55 millert 258: #if __XPG_VISIBLE >= 420 || __POSIX_VISIBLE >= 200809
1.54 millert 259: int getsubopt(char **, char * const *, char **);
260: #endif
261:
1.60 guenther 262: /*
263: * The Open Group Base Specifications, post-Issue 7
264: */
265: #if __BSD_VISIBLE
266: int mkostemp(char *, int);
267: #endif
268:
1.35 millert 269: #if __BSD_VISIBLE
1.63 ! tedu 270: #define alloca(n) __builtin_alloca(n)
1.1 deraadt 271:
1.16 millert 272: char *getbsize(int *, long *);
273: char *cgetcap(char *, const char *, int);
274: int cgetclose(void);
275: int cgetent(char **, char **, const char *);
276: int cgetfirst(char **, char **);
277: int cgetmatch(char *, const char *);
278: int cgetnext(char **, char **);
279: int cgetnum(char *, const char *, long *);
280: int cgetset(const char *);
281: int cgetusedb(int);
282: int cgetstr(char *, const char *, char **);
283: int cgetustr(char *, const char *, char **);
284:
285: int daemon(int, int);
1.38 deraadt 286: char *devname(int, mode_t);
1.16 millert 287: int getloadavg(double [], int);
1.52 ajacouto 288:
289: const char *
290: getprogname(void);
291: void setprogname(const char *);
1.1 deraadt 292:
293: extern char *suboptarg; /* getsubopt(3) external variable */
294:
1.35 millert 295: int mkstemps(char *, int);
1.60 guenther 296: int mkostemps(char *, int, int);
1.35 millert 297:
1.17 millert 298: int heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
299: int mergesort(void *, size_t, size_t, int (*)(const void *, const void *));
300: int radixsort(const unsigned char **, int, const unsigned char *,
301: unsigned);
302: int sradixsort(const unsigned char **, int, const unsigned char *,
303: unsigned);
1.1 deraadt 304:
1.16 millert 305: void srandomdev(void);
1.35 millert 306: long long
307: strtonum(const char *, long long, long long, const char **);
1.16 millert 308:
309: void setproctitle(const char *, ...)
1.15 krw 310: __attribute__((__format__ (__printf__, 1, 2)));
1.1 deraadt 311:
1.16 millert 312: quad_t qabs(quad_t);
313: qdiv_t qdiv(quad_t, quad_t);
314: quad_t strtoq(const char *, char **, int);
315: u_quad_t strtouq(const char *, char **, int);
316:
1.59 beck 317: uint32_t arc4random(void);
318: uint32_t arc4random_uniform(uint32_t);
1.41 otto 319: void arc4random_buf(void *, size_t)
320: __attribute__((__bounded__ (__string__,1,2)));
321:
1.35 millert 322: #endif /* __BSD_VISIBLE */
1.1 deraadt 323:
324: __END_DECLS
325:
326: #endif /* _STDLIB_H_ */