include/stdlib.h

   1 /*      $NetBSD: stdlib.h,v 1.106 2013/04/26 18:07:43 christos Exp $    */
   2
   3 /*-
   4  * Copyright (c) 1990, 1993
   5  *      The Regents of the University of California.  All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  * 1. Redistributions of source code must retain the above copyright
  11  *    notice, this list of conditions and the following disclaimer.
  12  * 2. Redistributions in binary form must reproduce the above copyright
  13  *    notice, this list of conditions and the following disclaimer in the
  14  *    documentation and/or other materials provided with the distribution.
  15  * 3. Neither the name of the University nor the names of its contributors
  16  *    may be used to endorse or promote products derived from this software
  17  *    without specific prior written permission.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  23  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  29  * SUCH DAMAGE.
  30  *
  31  *      @(#)stdlib.h    8.5 (Berkeley) 5/19/95
  32  */
  33
  34 #ifndef _STDLIB_H_
  35 #define _STDLIB_H_
  36
  37 #include <sys/cdefs.h>
  38 #include <sys/featuretest.h>
  39
  40 #if defined(_NETBSD_SOURCE)
  41 #include <sys/types.h>          /* for quad_t, etc. */
  42 #endif
  43
  44 #include <machine/ansi.h>
  45
  46 #ifdef  _BSD_SIZE_T_
  47 typedef _BSD_SIZE_T_    size_t;
  48 #undef  _BSD_SIZE_T_
  49 #endif
  50
  51 #if defined(_BSD_WCHAR_T_) && !defined(__cplusplus)
  52 typedef _BSD_WCHAR_T_   wchar_t;
  53 #undef  _BSD_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 !defined(_ANSI_SOURCE) && \
  67     (defined(_ISOC99_SOURCE) || (__STDC_VERSION__ - 0) >= 199901L || \
  68      (__cplusplus - 0) >= 201103L || defined(_NETBSD_SOURCE))
  69 typedef struct {
  70         /* LONGLONG */
  71         long long int quot;     /* quotient */
  72         /* LONGLONG */
  73         long long int rem;      /* remainder */
  74 } lldiv_t;
  75 #endif
  76
  77 #if defined(_NETBSD_SOURCE)
  78 typedef struct {
  79         quad_t quot;            /* quotient */
  80         quad_t rem;             /* remainder */
  81 } qdiv_t;
  82 #endif
  83
  84
  85 #include <sys/null.h>
  86
  87 #define EXIT_FAILURE    1
  88 #define EXIT_SUCCESS    0
  89
  90 #define RAND_MAX        0x7fffffff
  91
  92 extern size_t __mb_cur_max;
  93 #define MB_CUR_MAX      __mb_cur_max
  94
  95 __BEGIN_DECLS
  96 __dead   void _Exit(int);
  97 __dead   void abort(void);
  98 __pure   int abs(int);
  99 int      atexit(void (*)(void));
 100 double   atof(const char *);
 101 int      atoi(const char *);
 102 long     atol(const char *);
 103 #ifndef __BSEARCH_DECLARED
 104 #define __BSEARCH_DECLARED
 105 /* also in search.h */
 106 void    *bsearch(const void *, const void *, size_t, size_t,
 107     int (*)(const void *, const void *));
 108 #endif /* __BSEARCH_DECLARED */
 109 void    *calloc(size_t, size_t);
 110 div_t    div(int, int);
 111 __dead   void exit(int);
 112 void     free(void *);
 113 __aconst char *getenv(const char *);
 114 __pure long
 115          labs(long);
 116 ldiv_t   ldiv(long, long);
 117 void    *malloc(size_t);
 118 void     qsort(void *, size_t, size_t, int (*)(const void *, const void *));
 119 int      rand(void);
 120 void    *realloc(void *, size_t);
 121 void     srand(unsigned);
 122 double   strtod(const char * __restrict, char ** __restrict);
 123 long     strtol(const char * __restrict, char ** __restrict, int);
 124 unsigned long
 125          strtoul(const char * __restrict, char ** __restrict, int);
 126 int      system(const char *);
 127
 128 /* These are currently just stubs. */
 129 int      mblen(const char *, size_t);
 130 size_t   mbstowcs(wchar_t * __restrict, const char * __restrict, size_t);
 131 int      wctomb(char *, wchar_t);
 132 int      mbtowc(wchar_t * __restrict, const char * __restrict, size_t);
 133 size_t   wcstombs(char * __restrict, const wchar_t * __restrict, size_t);
 134
 135 #if defined(_POSIX_C_SOURCE) || defined(_XOPEN_SOURCE) || \
 136     defined(_NETBSD_SOURCE)
 137
 138
 139 /*
 140  * IEEE Std 1003.1c-95, also adopted by X/Open CAE Spec Issue 5 Version 2
 141  */
 142 #if (_POSIX_C_SOURCE - 0) >= 199506L || (_XOPEN_SOURCE - 0) >= 500 || \
 143     defined(_REENTRANT) || defined(_NETBSD_SOURCE)
 144 int      rand_r(unsigned int *);
 145 #endif
 146
 147
 148 /*
 149  * X/Open Portability Guide >= Issue 4
 150  */
 151 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
 152 double   drand48(void);
 153 double   erand48(unsigned short[3]);
 154 long     jrand48(unsigned short[3]);
 155 void     lcong48(unsigned short[7]);
 156 long     lrand48(void);
 157 long     mrand48(void);
 158 long     nrand48(unsigned short[3]);
 159 unsigned short *
 160          seed48(unsigned short[3]);
 161 void     srand48(long);
 162
 163 #ifndef __LIBC12_SOURCE__
 164 int      putenv(char *) __RENAME(__putenv50);
 165 #endif
 166 #endif
 167
 168
 169 /*
 170  * X/Open Portability Guide >= Issue 4 Version 2
 171  */
 172 #if (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
 173     (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
 174 long     a64l(const char *);
 175 char    *l64a(long);
 176
 177 char    *initstate(unsigned long, char *, size_t);
 178 long     random(void);
 179 char    *setstate(char *);
 180 void     srandom(unsigned long);
 181 #ifdef _NETBSD_SOURCE
 182 #define RANDOM_MAX      0x7fffffff      /* (((long)1 << 31) - 1) */
 183 #endif
 184
 185 char    *mkdtemp(char *);
 186 int      mkstemp(char *);
 187 char    *mktemp(char *)
 188 #ifdef __MKTEMP_OK__
 189         __RENAME(_mktemp)
 190 #endif
 191         ;
 192
 193 int      setkey(const char *);
 194
 195 char    *realpath(const char * __restrict, char * __restrict);
 196
 197 int      ttyslot(void);
 198
 199 void    *valloc(size_t);                /* obsoleted by malloc() */
 200
 201 int      grantpt(int);
 202 int      unlockpt(int);
 203 char    *ptsname(int);
 204 #endif
 205
 206 /*
 207  * ISO C99
 208  */
 209 #if defined(_ISOC99_SOURCE) || (__STDC_VERSION__ - 0) >= 199901L || \
 210     defined(_NETBSD_SOURCE) || (__cplusplus - 0) >= 201103L
 211
 212 /* LONGLONG */
 213 long long int   atoll(const char *);
 214 /* LONGLONG */
 215 long long int   llabs(long long int);
 216 /* LONGLONG */
 217 lldiv_t         lldiv(long long int, long long int);
 218 /* LONGLONG */
 219 long long int   strtoll(const char * __restrict, char ** __restrict, int);
 220 /* LONGLONG */
 221 unsigned long long int
 222                 strtoull(const char * __restrict, char ** __restrict, int);
 223 float           strtof(const char * __restrict, char ** __restrict);
 224 long double     strtold(const char * __restrict, char ** __restrict);
 225 #endif
 226
 227 #if defined(_ISOC11_SOURCE) || (__STDC_VERSION__ - 0) >= 201101L || \
 228     defined(_NETBSD_SOURCE) || (__cplusplus - 0) >= 201103L
 229 int     at_quick_exit(void (*)(void));
 230 __dead void quick_exit(int);
 231 #endif
 232
 233 /*
 234  * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX)
 235  */
 236 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 600 || \
 237     defined(_NETBSD_SOURCE)
 238 int      setenv(const char *, const char *, int);
 239 #ifndef __LIBC12_SOURCE__
 240 int      unsetenv(const char *) __RENAME(__unsetenv13);
 241 #endif
 242
 243 int      posix_openpt(int);
 244 int      posix_memalign(void **, size_t, size_t);
 245 #endif
 246
 247 /*
 248  * Implementation-defined extensions
 249  */
 250 #if defined(_NETBSD_SOURCE)
 251 #if defined(alloca) && (alloca == __builtin_alloca) && \
 252         defined(__GNUC__) && (__GNUC__ < 2)
 253 void    *alloca(int);     /* built-in for gcc */
 254 #elif defined(__PCC__) && !defined(__GNUC__)
 255 #define alloca(size) __builtin_alloca(size)
 256 #else
 257 void    *alloca(size_t);
 258 #endif /* __GNUC__ */
 259
 260 uint32_t arc4random(void);
 261 void     arc4random_stir(void);
 262 void     arc4random_buf(void *, size_t);
 263 uint32_t arc4random_uniform(uint32_t);
 264 void     arc4random_addrandom(u_char *, int);
 265 char    *getbsize(int *, long *);
 266 char    *cgetcap(char *, const char *, int);
 267 int      cgetclose(void);
 268 int      cgetent(char **, const char * const *, const char *);
 269 int      cgetfirst(char **, const char * const *);
 270 int      cgetmatch(const char *, const char *);
 271 int      cgetnext(char **, const char * const *);
 272 int      cgetnum(char *, const char *, long *);
 273 int      cgetset(const char *);
 274 int      cgetstr(char *, const char *, char **);
 275 int      cgetustr(char *, const char *, char **);
 276 void     csetexpandtc(int);
 277
 278 int      daemon(int, int);
 279 int      devname_r(dev_t, mode_t, char *, size_t);
 280 #ifndef __LIBC12_SOURCE__
 281 __aconst char *devname(dev_t, mode_t) __RENAME(__devname50);
 282 #endif
 283
 284 #define HN_DECIMAL              0x01
 285 #define HN_NOSPACE              0x02
 286 #define HN_B                    0x04
 287 #define HN_DIVISOR_1000         0x08
 288
 289 #define HN_GETSCALE             0x10
 290 #define HN_AUTOSCALE            0x20
 291
 292 int      humanize_number(char *, size_t, int64_t, const char *, int, int);
 293 int      dehumanize_number(const char *, int64_t *);
 294
 295 #if !defined(__minix)
 296 devmajor_t getdevmajor(const char *, mode_t);
 297 #endif /* !defined(__minix) */
 298 int      getloadavg(double [], int);
 299
 300 int      getenv_r(const char *, char *, size_t);
 301
 302 void     cfree(void *);
 303
 304 int      heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
 305 int      mergesort(void *, size_t, size_t,
 306             int (*)(const void *, const void *));
 307 int      radixsort(const unsigned char **, int, const unsigned char *,
 308             unsigned);
 309 int      sradixsort(const unsigned char **, int, const unsigned char *,
 310             unsigned);
 311
 312 void     mi_vector_hash(const void * __restrict, size_t, uint32_t,
 313             uint32_t[3]);
 314
 315 void     setproctitle(const char *, ...)
 316             __printflike(1, 2);
 317 const char *getprogname(void) __constfunc;
 318 void    setprogname(const char *);
 319
 320 quad_t   qabs(quad_t);
 321 quad_t   strtoq(const char * __restrict, char ** __restrict, int);
 322 u_quad_t strtouq(const char * __restrict, char ** __restrict, int);
 323
 324         /* LONGLONG */
 325 long long strsuftoll(const char *, const char *, long long, long long);
 326         /* LONGLONG */
 327 long long strsuftollx(const char *, const char *, long long, long long,
 328                         char *, size_t);
 329
 330 int      l64a_r(long, char *, int);
 331
 332 size_t  shquote(const char *, char *, size_t);
 333 size_t  shquotev(int, char * const *, char *, size_t);
 334 #endif /* _NETBSD_SOURCE */
 335 #endif /* _POSIX_C_SOURCE || _XOPEN_SOURCE || _NETBSD_SOURCE */
 336
 337 #if defined(_NETBSD_SOURCE)
 338 qdiv_t   qdiv(quad_t, quad_t);
 339 #endif
 340
 341 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
 342 #  ifndef __LOCALE_T_DECLARED
 343 typedef struct _locale          *locale_t;
 344 #  define __LOCALE_T_DECLARED
 345 #  endif
 346 double          strtod_l(const char * __restrict, char ** __restrict, locale_t);
 347 float           strtof_l(const char * __restrict, char ** __restrict, locale_t);
 348 long double     strtold_l(const char * __restrict, char ** __restrict,
 349                           locale_t);
 350 long     strtol_l(const char * __restrict, char ** __restrict, int, locale_t);
 351 unsigned long
 352          strtoul_l(const char * __restrict, char ** __restrict, int, locale_t);
 353 /* LONGLONG */
 354 long long int
 355         strtoll_l(const char * __restrict, char ** __restrict, int, locale_t);
 356 /* LONGLONG */
 357 unsigned long long int
 358         strtoull_l(const char * __restrict, char ** __restrict, int, locale_t);
 359
 360 #  if defined(_NETBSD_SOURCE)
 361 quad_t   strtoq_l(const char * __restrict, char ** __restrict, int, locale_t);
 362 u_quad_t strtouq_l(const char * __restrict, char ** __restrict, int, locale_t);
 363
 364 size_t  _mb_cur_max_l(locale_t);
 365 #define MB_CUR_MAX_L(loc)       _mb_cur_max_l(loc)
 366 int      mblen_l(const char *, size_t, locale_t);
 367 size_t   mbstowcs_l(wchar_t * __restrict, const char * __restrict, size_t,
 368                     locale_t);
 369 int      wctomb_l(char *, wchar_t, locale_t);
 370 int      mbtowc_l(wchar_t * __restrict, const char * __restrict, size_t,
 371                   locale_t);
 372 size_t   wcstombs_l(char * __restrict, const wchar_t * __restrict, size_t,
 373                     locale_t);
 374
 375 #  endif /* _NETBSD_SOURCE */
 376 #endif /* _POSIX_C_SOURCE >= 200809 || _NETBSD_SOURCE */
 377
 378 __END_DECLS
 379
 380 #endif /* !_STDLIB_H_ */