stdlib.h revision 1.74 
1/*	$NetBSD: stdlib.h,v 1.74 2005/12/24 23:04:05 perry 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_
47typedef	_BSD_SIZE_T_	size_t;
48#undef	_BSD_SIZE_T_
49#endif
50
51#ifdef	_BSD_WCHAR_T_
52typedef	_BSD_WCHAR_T_	wchar_t;
53#undef	_BSD_WCHAR_T_
54#endif
55
56typedef struct {
57	int quot;		/* quotient */
58	int rem;		/* remainder */
59} div_t;
60
61typedef 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))
69typedef 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)
78typedef 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
92extern size_t __mb_cur_max;
93#define	MB_CUR_MAX	__mb_cur_max
94
95__BEGIN_DECLS
96__dead	 void _Exit(int) __attribute__((__noreturn__));
97__dead	 void abort(void) __attribute__((__noreturn__));
98__pure	 int abs(int);
99int	 atexit(void (*)(void));
100double	 atof(const char *);
101int	 atoi(const char *);
102long	 atol(const char *);
103#ifndef __BSEARCH_DECLARED
104#define __BSEARCH_DECLARED
105/* also in search.h */
106void	*bsearch(const void *, const void *, size_t, size_t,
107    int (*)(const void *, const void *));
108#endif /* __BSEARCH_DECLARED */
109void	*calloc(size_t, size_t);
110div_t	 div(int, int);
111__dead	 void exit(int) __attribute__((__noreturn__));
112void	 free(void *);
113__aconst char *getenv(const char *);
114__pure long
115	 labs(long);
116ldiv_t	 ldiv(long, long);
117void	*malloc(size_t);
118void	 qsort(void *, size_t, size_t, int (*)(const void *, const void *));
119int	 rand(void);
120void	*realloc(void *, size_t);
121void	 srand(unsigned);
122double	 strtod(const char * __restrict, char ** __restrict);
123long	 strtol(const char * __restrict, char ** __restrict, int);
124unsigned long
125	 strtoul(const char * __restrict, char ** __restrict, int);
126int	 system(const char *);
127
128/* These are currently just stubs. */
129int	 mblen(const char *, size_t);
130size_t	 mbstowcs(wchar_t * __restrict, const char * __restrict, size_t);
131int	 wctomb(char *, wchar_t);
132int	 mbtowc(wchar_t * __restrict, const char * __restrict, size_t);
133size_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)
144int	 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)
152double	 drand48(void);
153double	 erand48(unsigned short[3]);
154long	 jrand48(unsigned short[3]);
155void	 lcong48(unsigned short[7]);
156long	 lrand48(void);
157long	 mrand48(void);
158long	 nrand48(unsigned short[3]);
159unsigned short *
160	 seed48(unsigned short[3]);
161void	 srand48(long);
162
163int	 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)
172long	 a64l(const char *);
173char	*l64a(long);
174
175char	*initstate(unsigned long, char *, size_t);
176long	 random(void);
177char	*setstate(char *);
178void	 srandom(unsigned long);
179
180char	*mkdtemp(char *);
181int	 mkstemp(char *);
182char	*mktemp(char *)
183#ifdef __MKTEMP_OK__
184	__RENAME(_mktemp)
185#endif
186	;
187
188int	 setkey(const char *);
189
190char	*realpath(const char *, char *);
191
192int	 ttyslot(void);
193
194void	*valloc(size_t);		/* obsoleted by malloc() */
195
196int	 grantpt(int);
197int	 unlockpt(int);
198char	*ptsname(int);
199#endif
200
201/*
202 * ISO C99
203 */
204#if defined(_ISOC99_SOURCE) || (__STDC_VERSION__ - 0) >= 199901L || \
205    defined(_NETBSD_SOURCE)
206/* LONGLONG */
207long long int	atoll(const char *);
208/* LONGLONG */
209long long int	llabs(long long int);
210/* LONGLONG */
211lldiv_t		lldiv(long long int, long long int);
212/* LONGLONG */
213long long int	strtoll(const char * __restrict, char ** __restrict, int);
214/* LONGLONG */
215unsigned long long int
216		strtoull(const char * __restrict, char ** __restrict, int);
217#endif
218
219/*
220 * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX)
221 */
222#if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 600 || \
223    defined(_NETBSD_SOURCE)
224int	 setenv(const char *, const char *, int);
225#ifndef __LIBC12_SOURCE__
226int	 unsetenv(const char *) __RENAME(__unsetenv13);
227#endif
228
229int	 posix_openpt(int);
230#endif
231
232/*
233 * Implementation-defined extensions
234 */
235#if defined(_NETBSD_SOURCE)
236#if defined(alloca) && (alloca == __builtin_alloca) && (__GNUC__ < 2)
237void	*alloca(int);     /* built-in for gcc */
238#else
239void	*alloca(size_t);
240#endif /* __GNUC__ */
241
242u_int32_t arc4random(void);
243void	 arc4random_stir(void);
244void	 arc4random_addrandom(u_char *, int);
245char	*getbsize(int *, long *);
246char	*cgetcap(char *, const char *, int);
247int	 cgetclose(void);
248int	 cgetent(char **, const char * const *, const char *);
249int	 cgetfirst(char **, const char * const *);
250int	 cgetmatch(const char *, const char *);
251int	 cgetnext(char **, const char * const *);
252int	 cgetnum(char *, const char *, long *);
253int	 cgetset(const char *);
254int	 cgetstr(char *, const char *, char **);
255int	 cgetustr(char *, const char *, char **);
256
257int	 daemon(int, int);
258__aconst char *devname(dev_t, mode_t);
259dev_t	 getdevmajor(const char *, mode_t);
260int	 getloadavg(double [], int);
261
262int	 getenv_r(const char *, char *, size_t);
263
264void	 cfree(void *);
265
266int	 heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
267int	 mergesort(void *, size_t, size_t,
268	    int (*)(const void *, const void *));
269int	 radixsort(const unsigned char **, int, const unsigned char *,
270	    unsigned);
271int	 sradixsort(const unsigned char **, int, const unsigned char *,
272	    unsigned);
273
274void	 setproctitle(const char *, ...)
275	    __attribute__((__format__(__printf__, 1, 2)));
276const char *getprogname(void) __attribute__((const));
277void	setprogname(const char *);
278
279quad_t	 qabs(quad_t);
280quad_t	 strtoq(const char * __restrict, char ** __restrict, int);
281u_quad_t strtouq(const char * __restrict, char ** __restrict, int);
282
283	/* LONGLONG */
284long long strsuftoll(const char *, const char *, long long, long long);
285	/* LONGLONG */
286long long strsuftollx(const char *, const char *, long long, long long,
287	    		char *, size_t);
288
289int	 l64a_r(long, char *, int);
290
291size_t	shquote(const char *, char *, size_t);
292size_t	shquotev(int, char * const *, char *, size_t);
293#endif /* _NETBSD_SOURCE */
294#endif /* _POSIX_C_SOURCE || _XOPEN_SOURCE || _NETBSD_SOURCE */
295
296#if defined(_NETBSD_SOURCE)
297qdiv_t	 qdiv(quad_t, quad_t);
298#endif
299__END_DECLS
300
301#endif /* !_STDLIB_H_ */
302