Home | History | Annotate | Line # | Download | only in include
stdlib.h revision 1.82
      1 /*	$NetBSD: stdlib.h,v 1.82 2008/02/28 16:13:35 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 #ifdef	_BSD_WCHAR_T_
     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 (_XOPEN_SOURCE - 0) >= 4 || 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	(((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 #else
    246 void	*alloca(size_t);
    247 #endif /* __GNUC__ */
    248 
    249 uint32_t arc4random(void);
    250 void	 arc4random_stir(void);
    251 void	 arc4random_addrandom(u_char *, int);
    252 char	*getbsize(int *, long *);
    253 char	*cgetcap(char *, const char *, int);
    254 int	 cgetclose(void);
    255 int	 cgetent(char **, const char * const *, const char *);
    256 int	 cgetfirst(char **, const char * const *);
    257 int	 cgetmatch(const char *, const char *);
    258 int	 cgetnext(char **, const char * const *);
    259 int	 cgetnum(char *, const char *, long *);
    260 int	 cgetset(const char *);
    261 int	 cgetstr(char *, const char *, char **);
    262 int	 cgetustr(char *, const char *, char **);
    263 void	 csetexpandtc(int);
    264 
    265 int	 daemon(int, int);
    266 __aconst char *devname(dev_t, mode_t);
    267 
    268 #define	HN_DECIMAL		0x01
    269 #define	HN_NOSPACE		0x02
    270 #define	HN_B			0x04
    271 #define	HN_DIVISOR_1000		0x08
    272 
    273 #define	HN_GETSCALE		0x10
    274 #define	HN_AUTOSCALE		0x20
    275 
    276 int	 humanize_number(char *, size_t, int64_t, const char *, int, int);
    277 int	 dehumanize_number(const char *, int64_t *);
    278 
    279 dev_t	 getdevmajor(const char *, mode_t);
    280 int	 getloadavg(double [], int);
    281 
    282 int	 getenv_r(const char *, char *, size_t);
    283 
    284 void	 cfree(void *);
    285 
    286 int	 heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
    287 int	 mergesort(void *, size_t, size_t,
    288 	    int (*)(const void *, const void *));
    289 int	 radixsort(const unsigned char **, int, const unsigned char *,
    290 	    unsigned);
    291 int	 sradixsort(const unsigned char **, int, const unsigned char *,
    292 	    unsigned);
    293 
    294 void	 setproctitle(const char *, ...)
    295 	    __attribute__((__format__(__printf__, 1, 2)));
    296 const char *getprogname(void) __attribute__((const));
    297 void	setprogname(const char *);
    298 
    299 quad_t	 qabs(quad_t);
    300 quad_t	 strtoq(const char * __restrict, char ** __restrict, int);
    301 u_quad_t strtouq(const char * __restrict, char ** __restrict, int);
    302 
    303 	/* LONGLONG */
    304 long long strsuftoll(const char *, const char *, long long, long long);
    305 	/* LONGLONG */
    306 long long strsuftollx(const char *, const char *, long long, long long,
    307 	    		char *, size_t);
    308 
    309 int	 l64a_r(long, char *, int);
    310 
    311 size_t	shquote(const char *, char *, size_t);
    312 size_t	shquotev(int, char * const *, char *, size_t);
    313 #endif /* _NETBSD_SOURCE */
    314 #endif /* _POSIX_C_SOURCE || _XOPEN_SOURCE || _NETBSD_SOURCE */
    315 
    316 #if defined(_NETBSD_SOURCE)
    317 qdiv_t	 qdiv(quad_t, quad_t);
    318 #endif
    319 __END_DECLS
    320 
    321 #endif /* !_STDLIB_H_ */
    322