1 /* $OpenBSD: stdlib.h,v 1.78 2024/08/03 20:09:24 guenther Exp $ */ 2 /* $NetBSD: stdlib.h,v 1.25 1995/12/27 21:19:08 jtc Exp $ */ 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. 16 * 3. Neither the name of the University nor the names of its contributors 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 38 #include <sys/cdefs.h> 39 #include <sys/_null.h> 40 #include <machine/_types.h> 41 #if __BSD_VISIBLE /* for quad_t, etc. (XXX - use protected types) */ 42 #include <sys/types.h> 43 #endif 44 45 #ifndef _SIZE_T_DEFINED_ 46 #define _SIZE_T_DEFINED_ 47 typedef __size_t size_t; 48 #endif 49 50 /* in C++, wchar_t is a built-in type */ 51 #if !defined(_WCHAR_T_DEFINED_) && !defined(__cplusplus) 52 #define _WCHAR_T_DEFINED_ 53 typedef __wchar_t wchar_t; 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 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 73 #if __BSD_VISIBLE 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 85 #define MB_CUR_MAX __mb_cur_max() 86 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 96 __BEGIN_DECLS 97 __dead void abort(void); 98 int abs(int); 99 int atexit(void (*)(void)); 100 double atof(const char *); 101 int atoi(const char *); 102 long atol(const char *); 103 void *bsearch(const void *, const void *, size_t, size_t, 104 int (*)(const void *, const void *)); 105 void *calloc(size_t, size_t); 106 div_t div(int, int); 107 __dead void exit(int); 108 __dead void _Exit(int); 109 void free(void *); 110 char *getenv(const char *); 111 long labs(long); 112 ldiv_t ldiv(long, long); 113 void *malloc(size_t); 114 #if __BSD_VISIBLE 115 void freezero(void *, size_t) 116 __attribute__ ((__bounded__(__buffer__,1,2))); 117 void *calloc_conceal(size_t, size_t); 118 void *malloc_conceal(size_t); 119 void *recallocarray(void *, size_t, size_t, size_t); 120 #endif /* __BSD_VISIBLE */ 121 void qsort(void *, size_t, size_t, int (*)(const void *, const void *)); 122 int rand(void); 123 void *realloc(void *, size_t); 124 void srand(unsigned); 125 void srand_deterministic(unsigned); 126 double strtod(const char *__restrict, char **__restrict); 127 float strtof(const char *__restrict, char **__restrict); 128 long strtol(const char *__restrict, char **__restrict, int); 129 long double 130 strtold(const char *__restrict, char **__restrict); 131 unsigned long 132 strtoul(const char *__restrict, char **__restrict, int); 133 int system(const char *); 134 135 size_t __mb_cur_max(void); 136 int mblen(const char *, size_t); 137 size_t mbstowcs(wchar_t *, const char *, size_t); 138 int wctomb(char *, wchar_t); 139 int mbtowc(wchar_t *, const char *, size_t); 140 size_t wcstombs(char *, const wchar_t *, size_t); 141 142 /* 143 * IEEE Std 1003.1c-95, also adopted by X/Open CAE Spec Issue 5 Version 2 144 */ 145 #if __BSD_VISIBLE || __POSIX_VISIBLE >= 199506 || defined(_REENTRANT) 146 int rand_r(unsigned int *); 147 #endif 148 149 #if __BSD_VISIBLE || __XPG_VISIBLE >= 400 150 double drand48(void); 151 double erand48(unsigned short[3]); 152 long jrand48(unsigned short[3]); 153 void lcong48(unsigned short[7]); 154 void lcong48_deterministic(unsigned short[7]); 155 long lrand48(void); 156 long mrand48(void); 157 long nrand48(unsigned short[3]); 158 unsigned short *seed48(unsigned short[3]); 159 unsigned short *seed48_deterministic(unsigned short[3]); 160 void srand48(long); 161 void srand48_deterministic(long); 162 163 int putenv(char *); 164 #endif 165 166 /* 167 * XSI functions marked LEGACY in IEEE Std 1003.1-2001 (POSIX) and 168 * removed in IEEE Std 1003.1-2008 169 */ 170 #if __BSD_VISIBLE || __XPG_VISIBLE < 700 171 char *ecvt(double, int, int *, int *); 172 char *fcvt(double, int, int *, int *); 173 char *gcvt(double, int, char *); 174 #if __BSD_VISIBLE || __XPG_VISIBLE >= 420 175 char *mktemp(char *); 176 #endif 177 #endif /* __BSD_VISIBLE || __XPG_VISIBLE < 700 */ 178 179 #if __BSD_VISIBLE || __XPG_VISIBLE >= 420 180 long a64l(const char *); 181 char *l64a(long); 182 183 char *initstate(unsigned int, char *, size_t) 184 __attribute__((__bounded__ (__string__,2,3))); 185 long random(void); 186 char *setstate(char *); 187 void srandom(unsigned int); 188 void srandom_deterministic(unsigned int); 189 190 char *realpath(const char *, char *) 191 __attribute__((__bounded__ (__minbytes__,2,1024))); 192 193 /* 194 * XSI functions marked LEGACY in XPG5 and removed in IEEE Std 1003.1-2001 195 */ 196 #if __BSD_VISIBLE || __XPG_VISIBLE < 600 197 int ttyslot(void); 198 void *valloc(size_t); /* obsoleted by malloc() */ 199 #endif 200 #endif /* __BSD_VISIBLE || __XPG_VISIBLE >= 420 */ 201 202 /* 203 * 4.4BSD, then XSI in XPG4.2, then added to POSIX base in IEEE Std 1003.1-2008 204 */ 205 #if __BSD_VISIBLE || __XPG_VISIBLE >= 420 || __POSIX_VISIBLE >= 200809 206 int mkstemp(char *); 207 #endif 208 209 /* 210 * ISO C99 211 */ 212 #if __ISO_C_VISIBLE >= 1999 213 long long 214 atoll(const char *); 215 long long 216 llabs(long long); 217 lldiv_t 218 lldiv(long long, long long); 219 long long 220 strtoll(const char *__restrict, char **__restrict, int); 221 unsigned long long 222 strtoull(const char *__restrict, char **__restrict, int); 223 #endif 224 225 #if __ISO_C_VISIBLE >= 2011 226 void * 227 aligned_alloc(size_t, size_t); 228 #endif 229 230 /* 231 * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX) 232 */ 233 #if __BSD_VISIBLE || __POSIX_VISIBLE >= 200112 234 int posix_memalign(void **, size_t, size_t); 235 int setenv(const char *, const char *, int); 236 int unsetenv(const char *); 237 #endif 238 #if __XPG_VISIBLE >= 420 || __POSIX_VISIBLE >= 200112 239 char *ptsname(int); 240 int grantpt(int); 241 int unlockpt(int); 242 #endif 243 #if __POSIX_VISIBLE >= 200112 244 int posix_openpt(int); 245 #endif 246 247 /* 248 * The Open Group Base Specifications, Issue 7; IEEE Std 1003.1-2008 (POSIX) 249 */ 250 #if __BSD_VISIBLE || __POSIX_VISIBLE >= 200809 251 char *mkdtemp(char *); 252 #endif 253 254 #if __XPG_VISIBLE >= 420 || __POSIX_VISIBLE >= 200809 255 int getsubopt(char **, char * const *, char **); 256 #endif 257 258 /* 259 * The Open Group Base Specifications, Issue 8 260 */ 261 #if __POSIX_VISIBLE >= 202405 || __BSD_VISIBLE 262 int mkostemp(char *, int); 263 void *reallocarray(void *, size_t, size_t); 264 #endif 265 266 #if __BSD_VISIBLE 267 #define alloca(n) __builtin_alloca(n) 268 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); 283 char *devname(dev_t, mode_t); 284 int getloadavg(double [], int); 285 286 const char * 287 getprogname(void); 288 void setprogname(const char *); 289 290 extern char *suboptarg; /* getsubopt(3) external variable */ 291 292 char * mkdtemps(char *, int); 293 int mkstemps(char *, int); 294 int mkostemps(char *, int, int); 295 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); 302 303 void srandomdev(void); 304 long long 305 strtonum(const char *, long long, long long, const char **); 306 307 void setproctitle(const char *, ...) 308 __attribute__((__format__ (__printf__, 1, 2))); 309 310 quad_t qabs(quad_t); 311 qdiv_t qdiv(quad_t, quad_t); 312 quad_t strtoq(const char *__restrict, char **__restrict, int); 313 u_quad_t strtouq(const char *__restrict, char **__restrict, int); 314 315 uint32_t arc4random(void); 316 uint32_t arc4random_uniform(uint32_t); 317 void arc4random_buf(void *, size_t) 318 __attribute__((__bounded__ (__buffer__,1,2))); 319 320 #endif /* __BSD_VISIBLE */ 321 322 __END_DECLS 323 324 #endif /* _STDLIB_H_ */ 325