Annotation of src/include/stdlib.h, Revision 1.77
1.77 ! millert 1: /* $OpenBSD: stdlib.h,v 1.76 2019/05/10 15:03:24 otto 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.66 millert 39: #include <sys/_null.h>
1.36 millert 40: #include <machine/_types.h>
41: #if __BSD_VISIBLE /* for quad_t, etc. (XXX - use protected types) */
1.1 deraadt 42: #include <sys/types.h>
43: #endif
44:
1.36 millert 45: #ifndef _SIZE_T_DEFINED_
46: #define _SIZE_T_DEFINED_
47: typedef __size_t size_t;
1.1 deraadt 48: #endif
49:
1.11 espie 50: /* in C++, wchar_t is a built-in type */
1.36 millert 51: #if !defined(_WCHAR_T_DEFINED_) && !defined(__cplusplus)
52: #define _WCHAR_T_DEFINED_
53: typedef __wchar_t wchar_t;
1.1 deraadt 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:
1.37 millert 66: #if __ISO_C_VISIBLE >= 1999
67: typedef struct {
68: long long quot; /* quotient */
69: long long rem; /* remainder */
70: } lldiv_t;
71: #endif
72:
1.35 millert 73: #if __BSD_VISIBLE
1.1 deraadt 74: typedef struct {
75: quad_t quot; /* quotient */
76: quad_t rem; /* remainder */
77: } qdiv_t;
78: #endif
79:
80: #define EXIT_FAILURE 1
81: #define EXIT_SUCCESS 0
82:
83: #define RAND_MAX 0x7fffffff
84:
1.72 schwarze 85: #define MB_CUR_MAX __mb_cur_max()
1.1 deraadt 86:
1.18 millert 87: /*
88: * Some header files may define an abs macro.
89: * If defined, undef it to prevent a syntax error and issue a warning.
90: */
91: #ifdef abs
92: #undef abs
93: #warning abs macro collides with abs() prototype, undefining
94: #endif
95:
1.1 deraadt 96: __BEGIN_DECLS
1.16 millert 97: __dead void abort(void);
98: int abs(int);
1.17 millert 99: int atexit(void (*)(void));
1.16 millert 100: double atof(const char *);
101: int atoi(const char *);
102: long atol(const char *);
1.17 millert 103: void *bsearch(const void *, const void *, size_t, size_t,
104: int (*)(const void *, const void *));
1.16 millert 105: void *calloc(size_t, size_t);
106: div_t div(int, int);
107: __dead void exit(int);
1.30 millert 108: __dead void _Exit(int);
1.16 millert 109: void free(void *);
110: char *getenv(const char *);
111: long labs(long);
112: ldiv_t ldiv(long, long);
113: void *malloc(size_t);
1.57 deraadt 114: #if __BSD_VISIBLE
1.70 millert 115: void freezero(void *, size_t)
116: __attribute__ ((__bounded__(__buffer__,1,2)));
1.76 otto 117: void *calloc_conceal(size_t, size_t);
118: void *malloc_conceal(size_t);
1.58 tedu 119: void *reallocarray(void *, size_t, size_t);
1.68 otto 120: void *recallocarray(void *, size_t, size_t, size_t);
1.57 deraadt 121: #endif /* __BSD_VISIBLE */
1.17 millert 122: void qsort(void *, size_t, size_t, int (*)(const void *, const void *));
1.16 millert 123: int rand(void);
124: void *realloc(void *, size_t);
125: void srand(unsigned);
1.62 deraadt 126: void srand_deterministic(unsigned);
1.64 tedu 127: double strtod(const char *__restrict, char **__restrict);
128: float strtof(const char *__restrict, char **__restrict);
129: long strtol(const char *__restrict, char **__restrict, int);
1.45 martynas 130: long double
1.64 tedu 131: strtold(const char *__restrict, char **__restrict);
1.1 deraadt 132: unsigned long
1.64 tedu 133: strtoul(const char *__restrict, char **__restrict, int);
1.16 millert 134: int system(const char *);
1.1 deraadt 135:
1.72 schwarze 136: size_t __mb_cur_max(void);
1.16 millert 137: int mblen(const char *, size_t);
138: size_t mbstowcs(wchar_t *, const char *, size_t);
139: int wctomb(char *, wchar_t);
140: int mbtowc(wchar_t *, const char *, size_t);
141: size_t wcstombs(char *, const wchar_t *, size_t);
1.1 deraadt 142:
1.35 millert 143: /*
144: * IEEE Std 1003.1c-95, also adopted by X/Open CAE Spec Issue 5 Version 2
145: */
1.50 guenther 146: #if __BSD_VISIBLE || __POSIX_VISIBLE >= 199506 || defined(_REENTRANT)
1.35 millert 147: int rand_r(unsigned int *);
148: #endif
149:
150: #if __BSD_VISIBLE || __XPG_VISIBLE >= 400
151: double drand48(void);
152: double erand48(unsigned short[3]);
153: long jrand48(unsigned short[3]);
154: void lcong48(unsigned short[7]);
1.62 deraadt 155: void lcong48_deterministic(unsigned short[7]);
1.35 millert 156: long lrand48(void);
157: long mrand48(void);
158: long nrand48(unsigned short[3]);
159: unsigned short *seed48(unsigned short[3]);
1.62 deraadt 160: unsigned short *seed48_deterministic(unsigned short[3]);
1.35 millert 161: void srand48(long);
1.62 deraadt 162: void srand48_deterministic(long);
1.35 millert 163:
1.46 millert 164: int putenv(char *);
1.35 millert 165: #endif
166:
1.50 guenther 167: /*
168: * XSI functions marked LEGACY in IEEE Std 1003.1-2001 (POSIX) and
169: * removed in IEEE Std 1003.1-2008
170: */
171: #if __BSD_VISIBLE || __XPG_VISIBLE < 700
172: char *ecvt(double, int, int *, int *);
173: char *fcvt(double, int, int *, int *);
174: char *gcvt(double, int, char *);
175: #if __BSD_VISIBLE || __XPG_VISIBLE >= 420
176: char *mktemp(char *);
177: #endif
178: #endif /* __BSD_VISIBLE || __XPG_VISIBLE < 700 */
179:
1.35 millert 180: #if __BSD_VISIBLE || __XPG_VISIBLE >= 420
181: long a64l(const char *);
182: char *l64a(long);
183:
184: char *initstate(unsigned int, char *, size_t)
185: __attribute__((__bounded__ (__string__,2,3)));
186: long random(void);
1.50 guenther 187: char *setstate(char *);
1.35 millert 188: void srandom(unsigned int);
1.62 deraadt 189: void srandom_deterministic(unsigned int);
1.35 millert 190:
1.56 martynas 191: char *realpath(const char *, char *)
192: __attribute__((__bounded__ (__minbytes__,2,1024)));
1.35 millert 193:
1.50 guenther 194: /*
195: * XSI functions marked LEGACY in XPG5 and removed in IEEE Std 1003.1-2001
196: */
197: #if __BSD_VISIBLE || __XPG_VISIBLE < 600
1.35 millert 198: int ttyslot(void);
199: void *valloc(size_t); /* obsoleted by malloc() */
1.50 guenther 200: #endif
1.35 millert 201: #endif /* __BSD_VISIBLE || __XPG_VISIBLE >= 420 */
202:
203: /*
1.50 guenther 204: * 4.4BSD, then XSI in XPG4.2, then added to POSIX base in IEEE Std 1003.1-2008
205: */
206: #if __BSD_VISIBLE || __XPG_VISIBLE >= 420 || __POSIX_VISIBLE >= 200809
207: int mkstemp(char *);
208: #endif
209:
210: /*
1.35 millert 211: * ISO C99
212: */
1.37 millert 213: #if __ISO_C_VISIBLE >= 1999
1.35 millert 214: long long
215: atoll(const char *);
216: long long
217: llabs(long long);
1.39 djm 218: lldiv_t
219: lldiv(long long, long long);
1.35 millert 220: long long
1.64 tedu 221: strtoll(const char *__restrict, char **__restrict, int);
1.35 millert 222: unsigned long long
1.64 tedu 223: strtoull(const char *__restrict, char **__restrict, int);
1.73 otto 224: #endif
225:
226: #if __ISO_C_VISIBLE >= 2011
227: void *
228: aligned_alloc(size_t, size_t);
1.35 millert 229: #endif
230:
231: /*
232: * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX)
233: */
1.50 guenther 234: #if __BSD_VISIBLE || __POSIX_VISIBLE >= 200112
235: int posix_memalign(void **, size_t, size_t);
1.35 millert 236: int setenv(const char *, const char *, int);
1.46 millert 237: int unsetenv(const char *);
1.51 millert 238: #endif
239: #if __XPG_VISIBLE >= 420 || __POSIX_VISIBLE >= 200112
240: char *ptsname(int);
241: int grantpt(int);
242: int unlockpt(int);
243: #endif
244: #if __POSIX_VISIBLE >= 200112
245: int posix_openpt(int);
1.35 millert 246: #endif
247:
1.50 guenther 248: /*
249: * The Open Group Base Specifications, Issue 7; IEEE Std 1003.1-2008 (POSIX)
250: */
251: #if __BSD_VISIBLE || __POSIX_VISIBLE >= 200809
252: char *mkdtemp(char *);
253: #endif
254:
1.55 millert 255: #if __XPG_VISIBLE >= 420 || __POSIX_VISIBLE >= 200809
1.54 millert 256: int getsubopt(char **, char * const *, char **);
257: #endif
258:
1.60 guenther 259: /*
260: * The Open Group Base Specifications, post-Issue 7
261: */
262: #if __BSD_VISIBLE
263: int mkostemp(char *, int);
264: #endif
265:
1.35 millert 266: #if __BSD_VISIBLE
1.63 tedu 267: #define alloca(n) __builtin_alloca(n)
1.1 deraadt 268:
1.16 millert 269: char *getbsize(int *, long *);
270: char *cgetcap(char *, const char *, int);
271: int cgetclose(void);
272: int cgetent(char **, char **, const char *);
273: int cgetfirst(char **, char **);
274: int cgetmatch(char *, const char *);
275: int cgetnext(char **, char **);
276: int cgetnum(char *, const char *, long *);
277: int cgetset(const char *);
278: int cgetusedb(int);
279: int cgetstr(char *, const char *, char **);
280: int cgetustr(char *, const char *, char **);
281:
282: int daemon(int, int);
1.65 millert 283: char *devname(dev_t, mode_t);
1.16 millert 284: int getloadavg(double [], int);
1.52 ajacouto 285:
286: const char *
287: getprogname(void);
288: void setprogname(const char *);
1.1 deraadt 289:
290: extern char *suboptarg; /* getsubopt(3) external variable */
291:
1.77 ! millert 292: char * mkdtemps(char *, int);
1.35 millert 293: int mkstemps(char *, int);
1.60 guenther 294: int mkostemps(char *, int, int);
1.35 millert 295:
1.17 millert 296: int heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
297: int mergesort(void *, size_t, size_t, int (*)(const void *, const void *));
298: int radixsort(const unsigned char **, int, const unsigned char *,
299: unsigned);
300: int sradixsort(const unsigned char **, int, const unsigned char *,
301: unsigned);
1.1 deraadt 302:
1.16 millert 303: void srandomdev(void);
1.35 millert 304: long long
305: strtonum(const char *, long long, long long, const char **);
1.16 millert 306:
307: void setproctitle(const char *, ...)
1.15 krw 308: __attribute__((__format__ (__printf__, 1, 2)));
1.1 deraadt 309:
1.16 millert 310: quad_t qabs(quad_t);
311: qdiv_t qdiv(quad_t, quad_t);
1.64 tedu 312: quad_t strtoq(const char *__restrict, char **__restrict, int);
313: u_quad_t strtouq(const char *__restrict, char **__restrict, int);
1.16 millert 314:
1.59 beck 315: uint32_t arc4random(void);
316: uint32_t arc4random_uniform(uint32_t);
1.41 otto 317: void arc4random_buf(void *, size_t)
1.71 tom 318: __attribute__((__bounded__ (__buffer__,1,2)));
1.41 otto 319:
1.35 millert 320: #endif /* __BSD_VISIBLE */
1.1 deraadt 321:
322: __END_DECLS
323:
324: #endif /* _STDLIB_H_ */