xref: /netbsd/include/stdlib.h (revision bf9ec67e)
1 /*	$NetBSD: stdlib.h,v 1.56 2002/05/24 04:01:43 itojun 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. All advertising materials mentioning features or use of this software
16  *    must display the following acknowledgement:
17  *	This product includes software developed by the University of
18  *	California, Berkeley and its contributors.
19  * 4. Neither the name of the University nor the names of its contributors
20  *    may be used to endorse or promote products derived from this software
21  *    without specific prior written permission.
22  *
23  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33  * SUCH DAMAGE.
34  *
35  *	@(#)stdlib.h	8.5 (Berkeley) 5/19/95
36  */
37 
38 #ifndef _STDLIB_H_
39 #define _STDLIB_H_
40 
41 #include <sys/cdefs.h>
42 #include <sys/featuretest.h>
43 
44 #if !defined(_ANSI_SOURCE) && !defined(_POSIX_C_SOURCE) && \
45     !defined(_XOPEN_SOURCE)
46 #include <sys/types.h>		/* for quad_t, etc. */
47 #endif
48 
49 #include <machine/ansi.h>
50 
51 #ifdef	_BSD_SIZE_T_
52 typedef	_BSD_SIZE_T_	size_t;
53 #undef	_BSD_SIZE_T_
54 #endif
55 
56 #ifdef	_BSD_WCHAR_T_
57 typedef	_BSD_WCHAR_T_	wchar_t;
58 #undef	_BSD_WCHAR_T_
59 #endif
60 
61 typedef struct {
62 	int quot;		/* quotient */
63 	int rem;		/* remainder */
64 } div_t;
65 
66 typedef struct {
67 	long quot;		/* quotient */
68 	long rem;		/* remainder */
69 } ldiv_t;
70 
71 #if !defined(_ANSI_SOURCE) && \
72     (!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE) || \
73      defined(_ISOC99_SOURCE) || (__STDC_VERSION__ - 0) >= 199901L)
74 typedef struct {
75 	/* LONGLONG */
76 	long long int quot;	/* quotient */
77 	/* LONGLONG */
78 	long long int rem;	/* remainder */
79 } lldiv_t;
80 #endif
81 
82 #if !defined(_ANSI_SOURCE) && !defined(_ISOC99_SOURCE) && \
83     !defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)
84 typedef struct {
85 	quad_t quot;		/* quotient */
86 	quad_t rem;		/* remainder */
87 } qdiv_t;
88 #endif
89 
90 
91 #include <sys/null.h>
92 
93 #define	EXIT_FAILURE	1
94 #define	EXIT_SUCCESS	0
95 
96 #define	RAND_MAX	0x7fffffff
97 
98 extern size_t __mb_cur_max;
99 #define	MB_CUR_MAX	__mb_cur_max
100 
101 __BEGIN_DECLS
102 __dead	 void abort __P((void)) __attribute__((__noreturn__));
103 __pure	 int abs __P((int));
104 int	 atexit __P((void (*)(void)));
105 double	 atof __P((const char *));
106 int	 atoi __P((const char *));
107 long	 atol __P((const char *));
108 #ifndef __BSEARCH_DECLARED
109 #define __BSEARCH_DECLARED
110 /* also in search.h */
111 void	*bsearch __P((const void *, const void *, size_t, size_t,
112     int (*)(const void *, const void *)));
113 #endif /* __BSEARCH_DECLARED */
114 void	*calloc __P((size_t, size_t));
115 div_t	 div __P((int, int));
116 __dead	 void exit __P((int)) __attribute__((__noreturn__));
117 void	 free __P((void *));
118 __aconst char *getenv __P((const char *));
119 __pure long
120 	 labs __P((long));
121 ldiv_t	 ldiv __P((long, long));
122 void	*malloc __P((size_t));
123 void	 qsort __P((void *, size_t, size_t,
124 	    int (*)(const void *, const void *)));
125 int	 rand __P((void));
126 void	*realloc __P((void *, size_t));
127 void	 srand __P((unsigned));
128 double	 strtod __P((const char * __restrict, char ** __restrict));
129 long	 strtol __P((const char * __restrict, char ** __restrict, int));
130 unsigned long
131 	 strtoul __P((const char * __restrict, char ** __restrict, int));
132 int	 system __P((const char *));
133 
134 /* These are currently just stubs. */
135 int	 mblen __P((const char *, size_t));
136 size_t	 mbstowcs __P((wchar_t * __restrict, const char * __restrict, size_t));
137 int	 wctomb __P((char *, wchar_t));
138 int	 mbtowc __P((wchar_t * __restrict, const char * __restrict, size_t));
139 size_t	 wcstombs __P((char * __restrict, const wchar_t * __restrict, size_t));
140 
141 #if !defined(_ANSI_SOURCE)
142 
143 
144 /*
145  * IEEE Std 1003.1c-95, also adopted by X/Open CAE Spec Issue 5 Version 2
146  */
147 #if (!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)) || \
148     (_POSIX_C_SOURCE - 0) >= 199506L || (_XOPEN_SOURCE - 0) >= 500 || \
149     defined(_REENTRANT)
150 int	 rand_r __P((unsigned int *));
151 #endif
152 
153 
154 /*
155  * X/Open Portability Guide >= Issue 4
156  */
157 #if (!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)) || \
158     (_XOPEN_SOURCE - 0) >= 4
159 double	 drand48 __P((void));
160 double	 erand48 __P((unsigned short[3]));
161 long	 jrand48 __P((unsigned short[3]));
162 void	 lcong48 __P((unsigned short[7]));
163 long	 lrand48 __P((void));
164 long	 mrand48 __P((void));
165 long	 nrand48 __P((unsigned short[3]));
166 unsigned short *
167 	 seed48 __P((unsigned short[3]));
168 void	 srand48 __P((long));
169 
170 int	 putenv __P((const char *));
171 #endif
172 
173 
174 /*
175  * X/Open Portability Guide >= Issue 4 Version 2
176  */
177 #if (!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)) || \
178     (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
179     (_XOPEN_SOURCE - 0) >= 500
180 long	 a64l __P((const char *));
181 char	*l64a __P((long));
182 
183 char	*initstate __P((unsigned long, char *, size_t));
184 long	 random __P((void));
185 char	*setstate __P((char *));
186 void	 srandom __P((unsigned long));
187 
188 char	*mkdtemp __P((char *));
189 int	 mkstemp __P((char *));
190 #ifndef __AUDIT__
191 char	*mktemp __P((char *));
192 #endif
193 
194 int	 setkey __P((const char *));
195 
196 char	*realpath __P((const char *, char *));
197 
198 int	 ttyslot __P((void));
199 
200 void	*valloc __P((size_t));		/* obsoleted by malloc() */
201 #endif
202 
203 /*
204  * ISO C99
205  */
206 #if (!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)) || \
207     defined(_ISOC99_SOURCE) || (__STDC_VERSION__ - 0) >= 199901L
208 /* LONGLONG */
209 long long int	atoll __P((const char *));
210 /* LONGLONG */
211 long long int	llabs __P((long long int));
212 /* LONGLONG */
213 lldiv_t		lldiv __P((long long int, long long int));
214 /* LONGLONG */
215 long long int	strtoll __P((const char * __restrict, char ** __restrict, int));
216 /* LONGLONG */
217 unsigned long long int
218 		strtoull __P((const char * __restrict, char ** __restrict,
219 		    int));
220 #endif
221 
222 /*
223  * Implementation-defined extensions
224  */
225 #if !defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)
226 #if defined(alloca) && (alloca == __builtin_alloca) && (__GNUC__ < 2)
227 void	*alloca __P((int));     /* built-in for gcc */
228 #else
229 void	*alloca __P((size_t));
230 #endif /* __GNUC__ */
231 
232 u_int32_t arc4random __P((void));
233 void	 arc4random_stir __P((void));
234 void	 arc4random_addrandom __P((u_char *, int));
235 char	*getbsize __P((int *, long *));
236 char	*cgetcap __P((char *, const char *, int));
237 int	 cgetclose __P((void));
238 int	 cgetent __P((char **, char **, const char *));
239 int	 cgetfirst __P((char **, char **));
240 int	 cgetmatch __P((const char *, const char *));
241 int	 cgetnext __P((char **, char **));
242 int	 cgetnum __P((char *, const char *, long *));
243 int	 cgetset __P((const char *));
244 int	 cgetstr __P((char *, const char *, char **));
245 int	 cgetustr __P((char *, const char *, char **));
246 
247 int	 daemon __P((int, int));
248 __aconst char *devname __P((dev_t, mode_t));
249 int	 getloadavg __P((double [], int));
250 
251 void	 cfree __P((void *));
252 
253 int	 heapsort __P((void *, size_t, size_t,
254 	    int (*)(const void *, const void *)));
255 int	 mergesort __P((void *, size_t, size_t,
256 	    int (*)(const void *, const void *)));
257 int	 radixsort __P((const unsigned char **, int, const unsigned char *,
258 	    unsigned));
259 int	 sradixsort __P((const unsigned char **, int, const unsigned char *,
260 	    unsigned));
261 
262 int	 setenv __P((const char *, const char *, int));
263 void	 unsetenv __P((const char *));
264 void	 setproctitle __P((const char *, ...))
265 	    __attribute__((__format__(__printf__, 1, 2)));
266 const char *getprogname __P((void)) __attribute__((__const__));
267 void	setprogname __P((const char *));
268 
269 quad_t	 qabs __P((quad_t));
270 quad_t	 strtoq __P((const char * __restrict, char ** __restrict, int));
271 u_quad_t strtouq __P((const char * __restrict, char ** __restrict, int));
272 
273 int	 l64a_r __P((long, char *, int));
274 
275 size_t	shquote __P((const char *arg, char *buf, size_t bufsize));
276 size_t	shquotev __P((int argc, char * const * argv, char *buf,
277 	    size_t bufsize));
278 #endif /* !_POSIX_C_SOURCE && !_XOPEN_SOURCE */
279 #endif /* !_ANSI_SOURCE */
280 
281 #if !defined(_ANSI_SOURCE) && !defined(_ISOC99_SOURCE) && \
282     !defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)
283 qdiv_t	 qdiv __P((quad_t, quad_t));
284 #endif
285 __END_DECLS
286 
287 #endif /* !_STDLIB_H_ */
288