include/stdlib.h

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