include/stdlib.h

   1 /*      $NetBSD: stdlib.h,v 1.100 2012/06/21 21:13:29 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      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  * X/Open Portability Guide >= Issue 4
 149  */
 150 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
 151 double   drand48(void);
 152 double   erand48(unsigned short[3]);
 153 long     jrand48(unsigned short[3]);
 154 void     lcong48(unsigned short[7]);
 155 long     lrand48(void);
 156 long     mrand48(void);
 157 long     nrand48(unsigned short[3]);
 158 unsigned short *
 159          seed48(unsigned short[3]);
 160 void     srand48(long);
 161
 162 #ifndef __LIBC12_SOURCE__
 163 int      putenv(char *) __RENAME(__putenv50);
 164 #endif
 165 #endif
 166
 167
 168 /*
 169  * X/Open Portability Guide >= Issue 4 Version 2
 170  */
 171 #if (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
 172     (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
 173 long     a64l(const char *);
 174 char    *l64a(long);
 175
 176 char    *initstate(unsigned long, char *, size_t);
 177 long     random(void);
 178 char    *setstate(char *);
 179 void     srandom(unsigned long);
 180 #ifdef _NETBSD_SOURCE
 181 #define RANDOM_MAX      0x7fffffff      /* (((long)1 << 31) - 1) */
 182 #endif
 183
 184 char    *mkdtemp(char *);
 185 int      mkstemp(char *);
 186 char    *mktemp(char *)
 187 #ifdef __MKTEMP_OK__
 188         __RENAME(_mktemp)
 189 #endif
 190         ;
 191
 192 int      setkey(const char *);
 193
 194 char    *realpath(const char * __restrict, char * __restrict);
 195
 196 int      ttyslot(void);
 197
 198 void    *valloc(size_t);                /* obsoleted by malloc() */
 199
 200 int      grantpt(int);
 201 int      unlockpt(int);
 202 char    *ptsname(int);
 203 #endif
 204
 205 /*
 206  * ISO C99
 207  */
 208 #if defined(_ISOC99_SOURCE) || (__STDC_VERSION__ - 0) >= 199901L || \
 209     defined(_NETBSD_SOURCE)
 210 /* LONGLONG */
 211 long long int   atoll(const char *);
 212 /* LONGLONG */
 213 long long int   llabs(long long int);
 214 /* LONGLONG */
 215 lldiv_t         lldiv(long long int, long long int);
 216 /* LONGLONG */
 217 long long int   strtoll(const char * __restrict, char ** __restrict, int);
 218 /* LONGLONG */
 219 unsigned long long int
 220                 strtoull(const char * __restrict, char ** __restrict, int);
 221 float           strtof(const char * __restrict, char ** __restrict);
 222 long double     strtold(const char * __restrict, char ** __restrict);
 223 #endif
 224
 225 /*
 226  * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX)
 227  */
 228 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 600 || \
 229     defined(_NETBSD_SOURCE)
 230 int      setenv(const char *, const char *, int);
 231 #ifndef __LIBC12_SOURCE__
 232 int      unsetenv(const char *) __RENAME(__unsetenv13);
 233 #endif
 234
 235 int      posix_openpt(int);
 236 int      posix_memalign(void **, size_t, size_t);
 237 #endif
 238
 239 /*
 240  * Implementation-defined extensions
 241  */
 242 #if defined(_NETBSD_SOURCE)
 243 #if defined(alloca) && (alloca == __builtin_alloca) && \
 244         defined(__GNUC__) && (__GNUC__ < 2)
 245 void    *alloca(int);     /* built-in for gcc */
 246 #elif defined(__PCC__) && !defined(__GNUC__)
 247 #define alloca(size) __builtin_alloca(size)
 248 #elif (__GNUC__ >= 2)
 249 /* LSC: MINIX Patch needed (2 following lines) */
 250 #define alloca(size) __builtin_alloca(size)
 251 #else
 252 void    *alloca(size_t);
 253 #endif /* __GNUC__ */
 254
 255 uint32_t arc4random(void);
 256 void     arc4random_stir(void);
 257 void     arc4random_buf(void *, size_t);
 258 uint32_t arc4random_uniform(uint32_t);
 259 void     arc4random_addrandom(u_char *, int);
 260 char    *getbsize(int *, long *);
 261 char    *cgetcap(char *, const char *, int);
 262 int      cgetclose(void);
 263 int      cgetent(char **, const char * const *, const char *);
 264 int      cgetfirst(char **, const char * const *);
 265 int      cgetmatch(const char *, const char *);
 266 int      cgetnext(char **, const char * const *);
 267 int      cgetnum(char *, const char *, long *);
 268 int      cgetset(const char *);
 269 int      cgetstr(char *, const char *, char **);
 270 int      cgetustr(char *, const char *, char **);
 271 void     csetexpandtc(int);
 272
 273 int      daemon(int, int);
 274 #ifndef __minix
 275 int      devname_r(dev_t, mode_t, char *, size_t);
 276 #ifndef __LIBC12_SOURCE__
 277 __aconst char *devname(dev_t, mode_t) __RENAME(__devname50);
 278 #endif
 279 #endif /* !__minix */
 280
 281 #define HN_DECIMAL              0x01
 282 #define HN_NOSPACE              0x02
 283 #define HN_B                    0x04
 284 #define HN_DIVISOR_1000         0x08
 285
 286 #define HN_GETSCALE             0x10
 287 #define HN_AUTOSCALE            0x20
 288
 289 int      humanize_number(char *, size_t, int64_t, const char *, int, int);
 290 int      dehumanize_number(const char *, int64_t *);
 291
 292 #ifndef __minix
 293 devmajor_t getdevmajor(const char *, mode_t);
 294 #endif /* !__minix */
 295 int      getloadavg(double [], int);
 296
 297 int      getenv_r(const char *, char *, size_t);
 298
 299 void     cfree(void *);
 300
 301 int      heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
 302 int      mergesort(void *, size_t, size_t,
 303             int (*)(const void *, const void *));
 304 int      radixsort(const unsigned char **, int, const unsigned char *,
 305             unsigned);
 306 int      sradixsort(const unsigned char **, int, const unsigned char *,
 307             unsigned);
 308
 309 void     mi_vector_hash(const void * __restrict, size_t, uint32_t,
 310             uint32_t[3]);
 311
 312 void     setproctitle(const char *, ...)
 313             __printflike(1, 2);
 314 const char *getprogname(void) __constfunc;
 315 void    setprogname(const char *);
 316
 317 quad_t   qabs(quad_t);
 318 quad_t   strtoq(const char * __restrict, char ** __restrict, int);
 319 u_quad_t strtouq(const char * __restrict, char ** __restrict, int);
 320
 321         /* LONGLONG */
 322 long long strsuftoll(const char *, const char *, long long, long long);
 323         /* LONGLONG */
 324 long long strsuftollx(const char *, const char *, long long, long long,
 325                         char *, size_t);
 326
 327 int      l64a_r(long, char *, int);
 328
 329 size_t  shquote(const char *, char *, size_t);
 330 size_t  shquotev(int, char * const *, char *, size_t);
 331 #endif /* _NETBSD_SOURCE */
 332 #endif /* _POSIX_C_SOURCE || _XOPEN_SOURCE || _NETBSD_SOURCE */
 333
 334 #if defined(_NETBSD_SOURCE)
 335 qdiv_t   qdiv(quad_t, quad_t);
 336 #endif
 337 __END_DECLS
 338
 339 #endif /* !_STDLIB_H_ */