1 /* A GNU-like <stdlib.h>.
3 Copyright (C) 1995, 2001-2004, 2006-2010 Free Software Foundation, Inc.
5 This program is free software: you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 3 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program. If not, see <http://www.gnu.org/licenses/>. */
19 @PRAGMA_SYSTEM_HEADER@
22 #if defined __need_malloc_and_calloc
23 /* Special invocation convention inside glibc header files. */
25 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
28 /* Normal invocation convention. */
32 /* The include_next requires a split double-inclusion guard. */
33 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
38 /* NetBSD 5.0 mis-defines NULL. */
41 /* Solaris declares getloadavg() in <sys/loadavg.h>. */
42 #if (@GNULIB_GETLOADAVG@ || defined GNULIB_POSIXCHECK) && @HAVE_SYS_LOADAVG_H@
43 # include <sys/loadavg.h>
46 /* OSF/1 5.1 declares 'struct random_data' in <random.h>, which is included
47 from <stdlib.h> if _REENTRANT is defined. Include it always. */
52 #if !@HAVE_STRUCT_RANDOM_DATA@ || (@GNULIB_RANDOM_R@ && !@HAVE_RANDOM_R@) \
53 || defined GNULIB_POSIXCHECK
57 #if !@HAVE_STRUCT_RANDOM_DATA@
60 int32_t *fptr; /* Front pointer. */
61 int32_t *rptr; /* Rear pointer. */
62 int32_t *state; /* Array of state values. */
63 int rand_type; /* Type of random number generator. */
64 int rand_deg; /* Degree of random number generator. */
65 int rand_sep; /* Distance between front and rear. */
66 int32_t *end_ptr; /* Pointer behind state table. */
70 #if (@GNULIB_MKSTEMP@ || @GNULIB_GETSUBOPT@ || defined GNULIB_POSIXCHECK) && ! defined __GLIBC__
71 /* On MacOS X 10.3, only <unistd.h> declares mkstemp. */
72 /* On Cygwin 1.7.1, only <unistd.h> declares getsubopt. */
73 /* But avoid namespace pollution on glibc systems. */
77 /* The definition of GL_LINK_WARNING is copied here. */
79 /* The definition of _GL_ARG_NONNULL is copied here. */
82 /* Some systems do not define EXIT_*, despite otherwise supporting C89. */
84 # define EXIT_SUCCESS 0
86 /* Tandem/NSK and other platforms that define EXIT_FAILURE as -1 interfere
87 with proper operation of xargs. */
89 # define EXIT_FAILURE 1
90 #elif EXIT_FAILURE != 1
92 # define EXIT_FAILURE 1
102 /* Parse a signed decimal integer.
103 Returns the value of the integer. Errors are not detected. */
104 extern long long atoll (const char *string) _GL_ARG_NONNULL ((1));
106 #elif defined GNULIB_POSIXCHECK
109 (GL_LINK_WARNING ("atoll is unportable - " \
110 "use gnulib module atoll for portability"), \
114 #if @GNULIB_CALLOC_POSIX@
115 # if !@HAVE_CALLOC_POSIX@
117 # define calloc rpl_calloc
118 extern void * calloc (size_t nmemb, size_t size);
120 #elif defined GNULIB_POSIXCHECK
122 # define calloc(n,s) \
123 (GL_LINK_WARNING ("calloc is not POSIX compliant everywhere - " \
124 "use gnulib module calloc-posix for portability"), \
128 #if @GNULIB_CANONICALIZE_FILE_NAME@
129 # if @REPLACE_CANONICALIZE_FILE_NAME@
130 # define canonicalize_file_name rpl_canonicalize_file_name
132 # if !@HAVE_CANONICALIZE_FILE_NAME@ || @REPLACE_CANONICALIZE_FILE_NAME@
133 extern char *canonicalize_file_name (const char *name) _GL_ARG_NONNULL ((1));
135 #elif defined GNULIB_POSIXCHECK
136 # undef canonicalize_file_name
137 # define canonicalize_file_name(n) \
138 (GL_LINK_WARNING ("canonicalize_file_name is unportable - " \
139 "use gnulib module canonicalize-lgpl for portability"), \
140 canonicalize_file_name (n))
143 #if @GNULIB_GETLOADAVG@
144 # if !@HAVE_DECL_GETLOADAVG@
145 /* Store max(NELEM,3) load average numbers in LOADAVG[].
146 The three numbers are the load average of the last 1 minute, the last 5
147 minutes, and the last 15 minutes, respectively.
148 LOADAVG is an array of NELEM numbers. */
149 extern int getloadavg (double loadavg[], int nelem) _GL_ARG_NONNULL ((1));
151 #elif defined GNULIB_POSIXCHECK
153 # define getloadavg(l,n) \
154 (GL_LINK_WARNING ("getloadavg is not portable - " \
155 "use gnulib module getloadavg for portability"), \
159 #if @GNULIB_GETSUBOPT@
160 /* Assuming *OPTIONP is a comma separated list of elements of the form
161 "token" or "token=value", getsubopt parses the first of these elements.
162 If the first element refers to a "token" that is member of the given
163 NULL-terminated array of tokens:
164 - It replaces the comma with a NUL byte, updates *OPTIONP to point past
165 the first option and the comma, sets *VALUEP to the value of the
166 element (or NULL if it doesn't contain an "=" sign),
167 - It returns the index of the "token" in the given array of tokens.
168 Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
169 For more details see the POSIX:2001 specification.
170 http://www.opengroup.org/susv3xsh/getsubopt.html */
171 # if !@HAVE_GETSUBOPT@
172 extern int getsubopt (char **optionp, char *const *tokens, char **valuep)
173 _GL_ARG_NONNULL ((1, 2, 3));
175 #elif defined GNULIB_POSIXCHECK
177 # define getsubopt(o,t,v) \
178 (GL_LINK_WARNING ("getsubopt is unportable - " \
179 "use gnulib module getsubopt for portability"), \
183 #if @GNULIB_MALLOC_POSIX@
184 # if !@HAVE_MALLOC_POSIX@
186 # define malloc rpl_malloc
187 extern void * malloc (size_t size);
189 #elif defined GNULIB_POSIXCHECK
192 (GL_LINK_WARNING ("malloc is not POSIX compliant everywhere - " \
193 "use gnulib module malloc-posix for portability"), \
199 /* Create a unique temporary directory from TEMPLATE.
200 The last six characters of TEMPLATE must be "XXXXXX";
201 they are replaced with a string that makes the directory name unique.
202 Returns TEMPLATE, or a null pointer if it cannot get a unique name.
203 The directory is created mode 700. */
204 extern char * mkdtemp (char * /*template*/) _GL_ARG_NONNULL ((1));
206 #elif defined GNULIB_POSIXCHECK
208 # define mkdtemp(t) \
209 (GL_LINK_WARNING ("mkdtemp is unportable - " \
210 "use gnulib module mkdtemp for portability"), \
214 #if @GNULIB_MKOSTEMP@
215 # if !@HAVE_MKOSTEMP@
216 /* Create a unique temporary file from TEMPLATE.
217 The last six characters of TEMPLATE must be "XXXXXX";
218 they are replaced with a string that makes the file name unique.
219 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
220 and O_TEXT, O_BINARY (defined in "binary-io.h").
221 The file is then created, with the specified flags, ensuring it didn't exist
223 The file is created read-write (mask at least 0600 & ~umask), but it may be
224 world-readable and world-writable (mask 0666 & ~umask), depending on the
226 Returns the open file descriptor if successful, otherwise -1 and errno
228 extern int mkostemp (char * /*template*/, int /*flags*/) _GL_ARG_NONNULL ((1));
230 #elif defined GNULIB_POSIXCHECK
232 # define mkostemp(t,f) \
233 (GL_LINK_WARNING ("mkostemp is unportable - " \
234 "use gnulib module mkostemp for portability"), \
238 #if @GNULIB_MKOSTEMPS@
239 # if !@HAVE_MKOSTEMPS@
240 /* Create a unique temporary file from TEMPLATE.
241 The last six characters of TEMPLATE before a suffix of length
242 SUFFIXLEN must be "XXXXXX";
243 they are replaced with a string that makes the file name unique.
244 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
245 and O_TEXT, O_BINARY (defined in "binary-io.h").
246 The file is then created, with the specified flags, ensuring it didn't exist
248 The file is created read-write (mask at least 0600 & ~umask), but it may be
249 world-readable and world-writable (mask 0666 & ~umask), depending on the
251 Returns the open file descriptor if successful, otherwise -1 and errno
253 extern int mkostemps (char * /*template*/, int /*suffixlen*/, int /*flags*/)
254 _GL_ARG_NONNULL ((1));
256 #elif defined GNULIB_POSIXCHECK
258 # define mkostemps(t,s,f) \
259 (GL_LINK_WARNING ("mkostemps is unportable - " \
260 "use gnulib module mkostemps for portability"), \
265 # if @REPLACE_MKSTEMP@
266 /* Create a unique temporary file from TEMPLATE.
267 The last six characters of TEMPLATE must be "XXXXXX";
268 they are replaced with a string that makes the file name unique.
269 The file is then created, ensuring it didn't exist before.
270 The file is created read-write (mask at least 0600 & ~umask), but it may be
271 world-readable and world-writable (mask 0666 & ~umask), depending on the
273 Returns the open file descriptor if successful, otherwise -1 and errno
275 # define mkstemp rpl_mkstemp
276 extern int mkstemp (char * /*template*/) _GL_ARG_NONNULL ((1));
278 #elif defined GNULIB_POSIXCHECK
280 # define mkstemp(t) \
281 (GL_LINK_WARNING ("mkstemp is unportable - " \
282 "use gnulib module mkstemp for portability"), \
286 #if @GNULIB_MKSTEMPS@
287 # if !@HAVE_MKSTEMPS@
288 /* Create a unique temporary file from TEMPLATE.
289 The last six characters of TEMPLATE prior to a suffix of length
290 SUFFIXLEN must be "XXXXXX";
291 they are replaced with a string that makes the file name unique.
292 The file is then created, ensuring it didn't exist before.
293 The file is created read-write (mask at least 0600 & ~umask), but it may be
294 world-readable and world-writable (mask 0666 & ~umask), depending on the
296 Returns the open file descriptor if successful, otherwise -1 and errno
298 extern int mkstemps (char * /*template*/, int /*suffixlen*/)
299 _GL_ARG_NONNULL ((1));
301 #elif defined GNULIB_POSIXCHECK
303 # define mkstemps(t,s) \
304 (GL_LINK_WARNING ("mkstemps is unportable - " \
305 "use gnulib module mkstemps for portability"), \
310 # if @REPLACE_PUTENV@
312 # define putenv rpl_putenv
313 extern int putenv (char *string) _GL_ARG_NONNULL ((1));
317 #if @GNULIB_RANDOM_R@
318 # if !@HAVE_RANDOM_R@
321 # define RAND_MAX 2147483647
324 int srandom_r (unsigned int seed, struct random_data *rand_state)
325 _GL_ARG_NONNULL ((2));
326 int initstate_r (unsigned int seed, char *buf, size_t buf_size,
327 struct random_data *rand_state)
328 _GL_ARG_NONNULL ((2, 4));
329 int setstate_r (char *arg_state, struct random_data *rand_state)
330 _GL_ARG_NONNULL ((1, 2));
331 int random_r (struct random_data *buf, int32_t *result)
332 _GL_ARG_NONNULL ((1, 2));
334 #elif defined GNULIB_POSIXCHECK
336 # define random_r(b,r) \
337 (GL_LINK_WARNING ("random_r is unportable - " \
338 "use gnulib module random_r for portability"), \
341 # define initstate_r(s,b,sz,r) \
342 (GL_LINK_WARNING ("initstate_r is unportable - " \
343 "use gnulib module random_r for portability"), \
344 initstate_r (s,b,sz,r))
346 # define srandom_r(s,r) \
347 (GL_LINK_WARNING ("srandom_r is unportable - " \
348 "use gnulib module random_r for portability"), \
351 # define setstate_r(a,r) \
352 (GL_LINK_WARNING ("setstate_r is unportable - " \
353 "use gnulib module random_r for portability"), \
357 #if @GNULIB_REALLOC_POSIX@
358 # if !@HAVE_REALLOC_POSIX@
360 # define realloc rpl_realloc
361 extern void * realloc (void *ptr, size_t size);
363 #elif defined GNULIB_POSIXCHECK
365 # define realloc(p,s) \
366 (GL_LINK_WARNING ("realloc is not POSIX compliant everywhere - " \
367 "use gnulib module realloc-posix for portability"), \
371 #if @GNULIB_REALPATH@
372 # if @REPLACE_REALPATH@
373 # define realpath rpl_realpath
375 # if !@HAVE_REALPATH@ || @REPLACE_REALPATH@
376 extern char *realpath (const char *name, char *resolved) _GL_ARG_NONNULL ((1));
378 #elif defined GNULIB_POSIXCHECK
380 # define realpath(n,r) \
381 (GL_LINK_WARNING ("realpath is unportable - use gnulib module " \
382 "canonicalize or canonicalize-lgpl for portability"), \
388 /* Test a user response to a question.
389 Return 1 if it is affirmative, 0 if it is negative, or -1 if not clear. */
390 extern int rpmatch (const char *response) _GL_ARG_NONNULL ((1));
392 #elif defined GNULIB_POSIXCHECK
394 # define rpmatch(r) \
395 (GL_LINK_WARNING ("rpmatch is unportable - " \
396 "use gnulib module rpmatch for portability"), \
401 # if @REPLACE_SETENV@
403 # define setenv rpl_setenv
405 # if !@HAVE_SETENV@ || @REPLACE_SETENV@
406 /* Set NAME to VALUE in the environment.
407 If REPLACE is nonzero, overwrite an existing value. */
408 extern int setenv (const char *name, const char *value, int replace)
409 _GL_ARG_NONNULL ((1));
411 #elif defined GNULIB_POSIXCHECK
413 # define setenv(n,v,o) \
414 (GL_LINK_WARNING ("setenv is unportable - " \
415 "use gnulib module setenv for portability"), \
420 # if @REPLACE_STRTOD@
421 # define strtod rpl_strtod
423 # if !@HAVE_STRTOD@ || @REPLACE_STRTOD@
424 /* Parse a double from STRING, updating ENDP if appropriate. */
425 extern double strtod (const char *str, char **endp) _GL_ARG_NONNULL ((1));
427 #elif defined GNULIB_POSIXCHECK
429 # define strtod(s, e) \
430 (GL_LINK_WARNING ("strtod is unportable - " \
431 "use gnulib module strtod for portability"), \
437 /* Parse a signed integer whose textual representation starts at STRING.
438 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
439 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
441 If ENDPTR is not NULL, the address of the first byte after the integer is
443 Upon overflow, the return value is LLONG_MAX or LLONG_MIN, and errno is set
445 extern long long strtoll (const char *string, char **endptr, int base)
446 _GL_ARG_NONNULL ((1));
448 #elif defined GNULIB_POSIXCHECK
450 # define strtoll(s,e,b) \
451 (GL_LINK_WARNING ("strtoll is unportable - " \
452 "use gnulib module strtoll for portability"), \
456 #if @GNULIB_STRTOULL@
457 # if !@HAVE_STRTOULL@
458 /* Parse an unsigned integer whose textual representation starts at STRING.
459 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
460 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
462 If ENDPTR is not NULL, the address of the first byte after the integer is
464 Upon overflow, the return value is ULLONG_MAX, and errno is set to
466 extern unsigned long long strtoull (const char *string, char **endptr, int base)
467 _GL_ARG_NONNULL ((1));
469 #elif defined GNULIB_POSIXCHECK
471 # define strtoull(s,e,b) \
472 (GL_LINK_WARNING ("strtoull is unportable - " \
473 "use gnulib module strtoull for portability"), \
477 #if @GNULIB_UNSETENV@
478 # if @REPLACE_UNSETENV@
480 # define unsetenv rpl_unsetenv
482 # if !@HAVE_UNSETENV@ || @REPLACE_UNSETENV@
483 /* Remove the variable NAME from the environment. */
484 extern int unsetenv (const char *name) _GL_ARG_NONNULL ((1));
486 #elif defined GNULIB_POSIXCHECK
488 # define unsetenv(n) \
489 (GL_LINK_WARNING ("unsetenv is unportable - " \
490 "use gnulib module unsetenv for portability"), \
498 #endif /* _GL_STDLIB_H */
499 #endif /* _GL_STDLIB_H */