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 /*
 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)
 211 /* LONGLONG */
 212 long long int   atoll(const char *);
 213 /* LONGLONG */
 214 long long int   llabs(long long int);
 215 /* LONGLONG */
 216 lldiv_t         lldiv(long long int, long long int);
 217 /* LONGLONG */
 218 long long int   strtoll(const char * __restrict, char ** __restrict, int);
 219 /* LONGLONG */
 220 unsigned long long int
 221                 strtoull(const char * __restrict, char ** __restrict, int);
 222 float           strtof(const char * __restrict, char ** __restrict);
 223 long double     strtold(const char * __restrict, char ** __restrict);
 224 #endif
 225
 226 /*
 227  * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX)
 228  */
 229 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 600 || \
 230     defined(_NETBSD_SOURCE)
 231 int      setenv(const char *, const char *, int);
 232 #ifndef __LIBC12_SOURCE__
 233 int      unsetenv(const char *) __RENAME(__unsetenv13);
 234 #endif
 235
 236 int      posix_openpt(int);
 237 int      posix_memalign(void **, size_t, size_t);
 238 #endif
 239
 240 /*
 241  * Implementation-defined extensions
 242  */
 243 #if defined(_NETBSD_SOURCE)
 244 #if defined(alloca) && (alloca == __builtin_alloca) && \
 245         defined(__GNUC__) && (__GNUC__ < 2)
 246 void    *alloca(int);     /* built-in for gcc */
 247 #elif defined(__PCC__) && !defined(__GNUC__)
 248 #define alloca(size) __builtin_alloca(size)
 249 #else
 250 void    *alloca(size_t);
 251 #endif /* __GNUC__ */
 252
 253 uint32_t arc4random(void);
 254 void     arc4random_stir(void);
 255 void     arc4random_buf(void *, size_t);
 256 uint32_t arc4random_uniform(uint32_t);
 257 void     arc4random_addrandom(u_char *, int);
 258 char    *getbsize(int *, long *);
 259 char    *cgetcap(char *, const char *, int);
 260 int      cgetclose(void);
 261 int      cgetent(char **, const char * const *, const char *);
 262 int      cgetfirst(char **, const char * const *);
 263 int      cgetmatch(const char *, const char *);
 264 int      cgetnext(char **, const char * const *);
 265 int      cgetnum(char *, const char *, long *);
 266 int      cgetset(const char *);
 267 int      cgetstr(char *, const char *, char **);
 268 int      cgetustr(char *, const char *, char **);
 269 void     csetexpandtc(int);
 270
 271 int      daemon(int, int);
 272 int      devname_r(dev_t, mode_t, char *, size_t);
 273 #ifndef __LIBC12_SOURCE__
 274 __aconst char *devname(dev_t, mode_t) __RENAME(__devname50);
 275 #endif
 276
 277 #define HN_DECIMAL              0x01
 278 #define HN_NOSPACE              0x02
 279 #define HN_B                    0x04
 280 #define HN_DIVISOR_1000         0x08
 281
 282 #define HN_GETSCALE             0x10
 283 #define HN_AUTOSCALE            0x20
 284
 285 int      humanize_number(char *, size_t, int64_t, const char *, int, int);
 286 int      dehumanize_number(const char *, int64_t *);
 287
 288 #ifndef __minix
 289 devmajor_t getdevmajor(const char *, mode_t);
 290 #endif /* !__minix */
 291 int      getloadavg(double [], int);
 292
 293 int      getenv_r(const char *, char *, size_t);
 294
 295 void     cfree(void *);
 296
 297 int      heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
 298 int      mergesort(void *, size_t, size_t,
 299             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);
 304
 305 void     mi_vector_hash(const void * __restrict, size_t, uint32_t,
 306             uint32_t[3]);
 307
 308 void     setproctitle(const char *, ...)
 309             __printflike(1, 2);
 310 const char *getprogname(void) __constfunc;
 311 void    setprogname(const char *);
 312
 313 quad_t   qabs(quad_t);
 314 quad_t   strtoq(const char * __restrict, char ** __restrict, int);
 315 u_quad_t strtouq(const char * __restrict, char ** __restrict, int);
 316
 317         /* LONGLONG */
 318 long long strsuftoll(const char *, const char *, long long, long long);
 319         /* LONGLONG */
 320 long long strsuftollx(const char *, const char *, long long, long long,
 321                         char *, size_t);
 322
 323 int      l64a_r(long, char *, int);
 324
 325 size_t  shquote(const char *, char *, size_t);
 326 size_t  shquotev(int, char * const *, char *, size_t);
 327 #endif /* _NETBSD_SOURCE */
 328 #endif /* _POSIX_C_SOURCE || _XOPEN_SOURCE || _NETBSD_SOURCE */
 329
 330 #if defined(_NETBSD_SOURCE)
 331 qdiv_t   qdiv(quad_t, quad_t);
 332 #endif
 333 __END_DECLS
 334
 335 #endif /* !_STDLIB_H_ */