1 /* A GNU-like <stdlib.h>.
3 Copyright (C) 1995, 2001-2004, 2006-2013 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@
23 #if defined __need_system_stdlib_h || defined __need_malloc_and_calloc
24 /* Special invocation conventions inside some gnulib header files,
25 and inside some glibc header files, respectively. */
27 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
30 /* Normal invocation convention. */
32 #ifndef _@GUARD_PREFIX@_STDLIB_H
34 /* The include_next requires a split double-inclusion guard. */
35 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
37 #ifndef _@GUARD_PREFIX@_STDLIB_H
38 #define _@GUARD_PREFIX@_STDLIB_H
40 /* NetBSD 5.0 mis-defines NULL. */
43 /* MirBSD 10 defines WEXITSTATUS in <sys/wait.h>, not in <stdlib.h>. */
44 #if @GNULIB_SYSTEM_POSIX@ && !defined WEXITSTATUS
45 # include <sys/wait.h>
48 /* Solaris declares getloadavg() in <sys/loadavg.h>. */
49 #if (@GNULIB_GETLOADAVG@ || defined GNULIB_POSIXCHECK) && @HAVE_SYS_LOADAVG_H@
50 # include <sys/loadavg.h>
53 /* Native Windows platforms declare mktemp() in <io.h>. */
54 #if 0 && ((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__)
60 /* OSF/1 5.1 declares 'struct random_data' in <random.h>, which is included
61 from <stdlib.h> if _REENTRANT is defined. Include it whenever we need
62 'struct random_data'. */
67 # if !@HAVE_STRUCT_RANDOM_DATA@ || @REPLACE_RANDOM_R@ || !@HAVE_RANDOM_R@
71 # if !@HAVE_STRUCT_RANDOM_DATA@
72 /* Define 'struct random_data'.
73 But allow multiple gnulib generated <stdlib.h> replacements to coexist. */
74 # if !GNULIB_defined_struct_random_data
77 int32_t *fptr
; /* Front pointer. */
78 int32_t *rptr
; /* Rear pointer. */
79 int32_t *state
; /* Array of state values. */
80 int rand_type
; /* Type of random number generator. */
81 int rand_deg
; /* Degree of random number generator. */
82 int rand_sep
; /* Distance between front and rear. */
83 int32_t *end_ptr
; /* Pointer behind state table. */
85 # define GNULIB_defined_struct_random_data 1
90 #if (@GNULIB_MKSTEMP@ || @GNULIB_MKSTEMPS@ || @GNULIB_GETSUBOPT@ || defined GNULIB_POSIXCHECK) && ! defined __GLIBC__ && !((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__)
91 /* On Mac OS X 10.3, only <unistd.h> declares mkstemp. */
92 /* On Mac OS X 10.5, only <unistd.h> declares mkstemps. */
93 /* On Cygwin 1.7.1, only <unistd.h> declares getsubopt. */
94 /* But avoid namespace pollution on glibc systems and native Windows. */
98 /* The __attribute__ feature is available in gcc versions 2.5 and later.
99 The attribute __pure__ was added in gcc 2.96. */
100 #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
101 # define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
103 # define _GL_ATTRIBUTE_PURE /* empty */
106 /* The definition of _Noreturn is copied here. */
108 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
110 /* The definition of _GL_ARG_NONNULL is copied here. */
112 /* The definition of _GL_WARN_ON_USE is copied here. */
115 /* Some systems do not define EXIT_*, despite otherwise supporting C89. */
117 # define EXIT_SUCCESS 0
119 /* Tandem/NSK and other platforms that define EXIT_FAILURE as -1 interfere
120 with proper operation of xargs. */
122 # define EXIT_FAILURE 1
123 #elif EXIT_FAILURE != 1
125 # define EXIT_FAILURE 1
130 /* Terminate the current process with the given return code, without running
131 the 'atexit' handlers. */
133 _GL_FUNCDECL_SYS (_Exit
, _Noreturn
void, (int status
));
135 _GL_CXXALIAS_SYS (_Exit
, void, (int status
));
136 _GL_CXXALIASWARN (_Exit
);
137 #elif defined GNULIB_POSIXCHECK
139 # if HAVE_RAW_DECL__EXIT
140 _GL_WARN_ON_USE (_Exit
, "_Exit is unportable - "
141 "use gnulib module _Exit for portability");
147 /* Parse a signed decimal integer.
148 Returns the value of the integer. Errors are not detected. */
150 _GL_FUNCDECL_SYS (atoll
, long long, (const char *string
)
152 _GL_ARG_NONNULL ((1)));
154 _GL_CXXALIAS_SYS (atoll
, long long, (const char *string
));
155 _GL_CXXALIASWARN (atoll
);
156 #elif defined GNULIB_POSIXCHECK
158 # if HAVE_RAW_DECL_ATOLL
159 _GL_WARN_ON_USE (atoll
, "atoll is unportable - "
160 "use gnulib module atoll for portability");
164 #if @GNULIB_CALLOC_POSIX@
165 # if @REPLACE_CALLOC@
166 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
168 # define calloc rpl_calloc
170 _GL_FUNCDECL_RPL (calloc
, void *, (size_t nmemb
, size_t size
));
171 _GL_CXXALIAS_RPL (calloc
, void *, (size_t nmemb
, size_t size
));
173 _GL_CXXALIAS_SYS (calloc
, void *, (size_t nmemb
, size_t size
));
175 _GL_CXXALIASWARN (calloc
);
176 #elif defined GNULIB_POSIXCHECK
178 /* Assume calloc is always declared. */
179 _GL_WARN_ON_USE (calloc
, "calloc is not POSIX compliant everywhere - "
180 "use gnulib module calloc-posix for portability");
183 #if @GNULIB_CANONICALIZE_FILE_NAME@
184 # if @REPLACE_CANONICALIZE_FILE_NAME@
185 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
186 # define canonicalize_file_name rpl_canonicalize_file_name
188 _GL_FUNCDECL_RPL (canonicalize_file_name
, char *, (const char *name
)
189 _GL_ARG_NONNULL ((1)));
190 _GL_CXXALIAS_RPL (canonicalize_file_name
, char *, (const char *name
));
192 # if !@HAVE_CANONICALIZE_FILE_NAME@
193 _GL_FUNCDECL_SYS (canonicalize_file_name
, char *, (const char *name
)
194 _GL_ARG_NONNULL ((1)));
196 _GL_CXXALIAS_SYS (canonicalize_file_name
, char *, (const char *name
));
198 _GL_CXXALIASWARN (canonicalize_file_name
);
199 #elif defined GNULIB_POSIXCHECK
200 # undef canonicalize_file_name
201 # if HAVE_RAW_DECL_CANONICALIZE_FILE_NAME
202 _GL_WARN_ON_USE (canonicalize_file_name
,
203 "canonicalize_file_name is unportable - "
204 "use gnulib module canonicalize-lgpl for portability");
208 #if @GNULIB_GETLOADAVG@
209 /* Store max(NELEM,3) load average numbers in LOADAVG[].
210 The three numbers are the load average of the last 1 minute, the last 5
211 minutes, and the last 15 minutes, respectively.
212 LOADAVG is an array of NELEM numbers. */
213 # if !@HAVE_DECL_GETLOADAVG@
214 _GL_FUNCDECL_SYS (getloadavg
, int, (double loadavg
[], int nelem
)
215 _GL_ARG_NONNULL ((1)));
217 _GL_CXXALIAS_SYS (getloadavg
, int, (double loadavg
[], int nelem
));
218 _GL_CXXALIASWARN (getloadavg
);
219 #elif defined GNULIB_POSIXCHECK
221 # if HAVE_RAW_DECL_GETLOADAVG
222 _GL_WARN_ON_USE (getloadavg
, "getloadavg is not portable - "
223 "use gnulib module getloadavg for portability");
227 #if @GNULIB_GETSUBOPT@
228 /* Assuming *OPTIONP is a comma separated list of elements of the form
229 "token" or "token=value", getsubopt parses the first of these elements.
230 If the first element refers to a "token" that is member of the given
231 NULL-terminated array of tokens:
232 - It replaces the comma with a NUL byte, updates *OPTIONP to point past
233 the first option and the comma, sets *VALUEP to the value of the
234 element (or NULL if it doesn't contain an "=" sign),
235 - It returns the index of the "token" in the given array of tokens.
236 Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
237 For more details see the POSIX:2001 specification.
238 http://www.opengroup.org/susv3xsh/getsubopt.html */
239 # if !@HAVE_GETSUBOPT@
240 _GL_FUNCDECL_SYS (getsubopt
, int,
241 (char **optionp
, char *const *tokens
, char **valuep
)
242 _GL_ARG_NONNULL ((1, 2, 3)));
244 _GL_CXXALIAS_SYS (getsubopt
, int,
245 (char **optionp
, char *const *tokens
, char **valuep
));
246 _GL_CXXALIASWARN (getsubopt
);
247 #elif defined GNULIB_POSIXCHECK
249 # if HAVE_RAW_DECL_GETSUBOPT
250 _GL_WARN_ON_USE (getsubopt
, "getsubopt is unportable - "
251 "use gnulib module getsubopt for portability");
256 /* Change the ownership and access permission of the slave side of the
257 pseudo-terminal whose master side is specified by FD. */
259 _GL_FUNCDECL_SYS (grantpt
, int, (int fd
));
261 _GL_CXXALIAS_SYS (grantpt
, int, (int fd
));
262 _GL_CXXALIASWARN (grantpt
);
263 #elif defined GNULIB_POSIXCHECK
265 # if HAVE_RAW_DECL_GRANTPT
266 _GL_WARN_ON_USE (grantpt
, "grantpt is not portable - "
267 "use gnulib module grantpt for portability");
271 /* If _GL_USE_STDLIB_ALLOC is nonzero, the including module does not
272 rely on GNU or POSIX semantics for malloc and realloc (for example,
273 by never specifying a zero size), so it does not need malloc or
274 realloc to be redefined. */
275 #if @GNULIB_MALLOC_POSIX@
276 # if @REPLACE_MALLOC@
277 # if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
278 || _GL_USE_STDLIB_ALLOC)
280 # define malloc rpl_malloc
282 _GL_FUNCDECL_RPL (malloc
, void *, (size_t size
));
283 _GL_CXXALIAS_RPL (malloc
, void *, (size_t size
));
285 _GL_CXXALIAS_SYS (malloc
, void *, (size_t size
));
287 _GL_CXXALIASWARN (malloc
);
288 #elif defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
290 /* Assume malloc is always declared. */
291 _GL_WARN_ON_USE (malloc
, "malloc is not POSIX compliant everywhere - "
292 "use gnulib module malloc-posix for portability");
295 /* Convert a multibyte character to a wide character. */
297 # if @REPLACE_MBTOWC@
298 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
300 # define mbtowc rpl_mbtowc
302 _GL_FUNCDECL_RPL (mbtowc
, int, (wchar_t *pwc
, const char *s
, size_t n
));
303 _GL_CXXALIAS_RPL (mbtowc
, int, (wchar_t *pwc
, const char *s
, size_t n
));
305 _GL_CXXALIAS_SYS (mbtowc
, int, (wchar_t *pwc
, const char *s
, size_t n
));
307 _GL_CXXALIASWARN (mbtowc
);
311 /* Create a unique temporary directory from TEMPLATE.
312 The last six characters of TEMPLATE must be "XXXXXX";
313 they are replaced with a string that makes the directory name unique.
314 Returns TEMPLATE, or a null pointer if it cannot get a unique name.
315 The directory is created mode 700. */
317 _GL_FUNCDECL_SYS (mkdtemp
, char *, (char * /*template*/) _GL_ARG_NONNULL ((1)));
319 _GL_CXXALIAS_SYS (mkdtemp
, char *, (char * /*template*/));
320 _GL_CXXALIASWARN (mkdtemp
);
321 #elif defined GNULIB_POSIXCHECK
323 # if HAVE_RAW_DECL_MKDTEMP
324 _GL_WARN_ON_USE (mkdtemp
, "mkdtemp is unportable - "
325 "use gnulib module mkdtemp for portability");
329 #if @GNULIB_MKOSTEMP@
330 /* Create a unique temporary file from TEMPLATE.
331 The last six characters of TEMPLATE must be "XXXXXX";
332 they are replaced with a string that makes the file name unique.
333 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
334 and O_TEXT, O_BINARY (defined in "binary-io.h").
335 The file is then created, with the specified flags, ensuring it didn't exist
337 The file is created read-write (mask at least 0600 & ~umask), but it may be
338 world-readable and world-writable (mask 0666 & ~umask), depending on the
340 Returns the open file descriptor if successful, otherwise -1 and errno
342 # if !@HAVE_MKOSTEMP@
343 _GL_FUNCDECL_SYS (mkostemp
, int, (char * /*template*/, int /*flags*/)
344 _GL_ARG_NONNULL ((1)));
346 _GL_CXXALIAS_SYS (mkostemp
, int, (char * /*template*/, int /*flags*/));
347 _GL_CXXALIASWARN (mkostemp
);
348 #elif defined GNULIB_POSIXCHECK
350 # if HAVE_RAW_DECL_MKOSTEMP
351 _GL_WARN_ON_USE (mkostemp
, "mkostemp is unportable - "
352 "use gnulib module mkostemp for portability");
356 #if @GNULIB_MKOSTEMPS@
357 /* Create a unique temporary file from TEMPLATE.
358 The last six characters of TEMPLATE before a suffix of length
359 SUFFIXLEN must be "XXXXXX";
360 they are replaced with a string that makes the file name unique.
361 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
362 and O_TEXT, O_BINARY (defined in "binary-io.h").
363 The file is then created, with the specified flags, ensuring it didn't exist
365 The file is created read-write (mask at least 0600 & ~umask), but it may be
366 world-readable and world-writable (mask 0666 & ~umask), depending on the
368 Returns the open file descriptor if successful, otherwise -1 and errno
370 # if !@HAVE_MKOSTEMPS@
371 _GL_FUNCDECL_SYS (mkostemps
, int,
372 (char * /*template*/, int /*suffixlen*/, int /*flags*/)
373 _GL_ARG_NONNULL ((1)));
375 _GL_CXXALIAS_SYS (mkostemps
, int,
376 (char * /*template*/, int /*suffixlen*/, int /*flags*/));
377 _GL_CXXALIASWARN (mkostemps
);
378 #elif defined GNULIB_POSIXCHECK
380 # if HAVE_RAW_DECL_MKOSTEMPS
381 _GL_WARN_ON_USE (mkostemps
, "mkostemps is unportable - "
382 "use gnulib module mkostemps for portability");
387 /* Create a unique temporary file from TEMPLATE.
388 The last six characters of TEMPLATE must be "XXXXXX";
389 they are replaced with a string that makes the file name unique.
390 The file is then created, ensuring it didn't exist before.
391 The file is created read-write (mask at least 0600 & ~umask), but it may be
392 world-readable and world-writable (mask 0666 & ~umask), depending on the
394 Returns the open file descriptor if successful, otherwise -1 and errno
396 # if @REPLACE_MKSTEMP@
397 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
398 # define mkstemp rpl_mkstemp
400 _GL_FUNCDECL_RPL (mkstemp
, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
401 _GL_CXXALIAS_RPL (mkstemp
, int, (char * /*template*/));
403 # if ! @HAVE_MKSTEMP@
404 _GL_FUNCDECL_SYS (mkstemp
, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
406 _GL_CXXALIAS_SYS (mkstemp
, int, (char * /*template*/));
408 _GL_CXXALIASWARN (mkstemp
);
409 #elif defined GNULIB_POSIXCHECK
411 # if HAVE_RAW_DECL_MKSTEMP
412 _GL_WARN_ON_USE (mkstemp
, "mkstemp is unportable - "
413 "use gnulib module mkstemp for portability");
417 #if @GNULIB_MKSTEMPS@
418 /* Create a unique temporary file from TEMPLATE.
419 The last six characters of TEMPLATE prior to a suffix of length
420 SUFFIXLEN must be "XXXXXX";
421 they are replaced with a string that makes the file name unique.
422 The file is then created, ensuring it didn't exist before.
423 The file is created read-write (mask at least 0600 & ~umask), but it may be
424 world-readable and world-writable (mask 0666 & ~umask), depending on the
426 Returns the open file descriptor if successful, otherwise -1 and errno
428 # if !@HAVE_MKSTEMPS@
429 _GL_FUNCDECL_SYS (mkstemps
, int, (char * /*template*/, int /*suffixlen*/)
430 _GL_ARG_NONNULL ((1)));
432 _GL_CXXALIAS_SYS (mkstemps
, int, (char * /*template*/, int /*suffixlen*/));
433 _GL_CXXALIASWARN (mkstemps
);
434 #elif defined GNULIB_POSIXCHECK
436 # if HAVE_RAW_DECL_MKSTEMPS
437 _GL_WARN_ON_USE (mkstemps
, "mkstemps is unportable - "
438 "use gnulib module mkstemps for portability");
442 #if @GNULIB_POSIX_OPENPT@
443 /* Return an FD open to the master side of a pseudo-terminal. Flags should
444 include O_RDWR, and may also include O_NOCTTY. */
445 # if !@HAVE_POSIX_OPENPT@
446 _GL_FUNCDECL_SYS (posix_openpt
, int, (int flags
));
448 _GL_CXXALIAS_SYS (posix_openpt
, int, (int flags
));
449 _GL_CXXALIASWARN (posix_openpt
);
450 #elif defined GNULIB_POSIXCHECK
452 # if HAVE_RAW_DECL_POSIX_OPENPT
453 _GL_WARN_ON_USE (posix_openpt
, "posix_openpt is not portable - "
454 "use gnulib module posix_openpt for portability");
459 /* Return the pathname of the pseudo-terminal slave associated with
460 the master FD is open on, or NULL on errors. */
461 # if @REPLACE_PTSNAME@
462 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
464 # define ptsname rpl_ptsname
466 _GL_FUNCDECL_RPL (ptsname
, char *, (int fd
));
467 _GL_CXXALIAS_RPL (ptsname
, char *, (int fd
));
470 _GL_FUNCDECL_SYS (ptsname
, char *, (int fd
));
472 _GL_CXXALIAS_SYS (ptsname
, char *, (int fd
));
474 _GL_CXXALIASWARN (ptsname
);
475 #elif defined GNULIB_POSIXCHECK
477 # if HAVE_RAW_DECL_PTSNAME
478 _GL_WARN_ON_USE (ptsname
, "ptsname is not portable - "
479 "use gnulib module ptsname for portability");
483 #if @GNULIB_PTSNAME_R@
484 /* Set the pathname of the pseudo-terminal slave associated with
485 the master FD is open on and return 0, or set errno and return
486 non-zero on errors. */
487 # if @REPLACE_PTSNAME_R@
488 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
490 # define ptsname_r rpl_ptsname_r
492 _GL_FUNCDECL_RPL (ptsname_r
, int, (int fd
, char *buf
, size_t len
));
493 _GL_CXXALIAS_RPL (ptsname_r
, int, (int fd
, char *buf
, size_t len
));
495 # if !@HAVE_PTSNAME_R@
496 _GL_FUNCDECL_SYS (ptsname_r
, int, (int fd
, char *buf
, size_t len
));
498 _GL_CXXALIAS_SYS (ptsname_r
, int, (int fd
, char *buf
, size_t len
));
500 _GL_CXXALIASWARN (ptsname_r
);
501 #elif defined GNULIB_POSIXCHECK
503 # if HAVE_RAW_DECL_PTSNAME_R
504 _GL_WARN_ON_USE (ptsname_r
, "ptsname_r is not portable - "
505 "use gnulib module ptsname_r for portability");
510 # if @REPLACE_PUTENV@
511 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
513 # define putenv rpl_putenv
515 _GL_FUNCDECL_RPL (putenv
, int, (char *string
) _GL_ARG_NONNULL ((1)));
516 _GL_CXXALIAS_RPL (putenv
, int, (char *string
));
518 _GL_CXXALIAS_SYS (putenv
, int, (char *string
));
520 _GL_CXXALIASWARN (putenv
);
524 #if @GNULIB_RANDOM_R@
525 # if !@HAVE_RANDOM_R@
527 # define RAND_MAX 2147483647
535 _GL_FUNCDECL_SYS (random
, long, (void));
537 _GL_CXXALIAS_SYS (random
, long, (void));
538 _GL_CXXALIASWARN (random
);
539 #elif defined GNULIB_POSIXCHECK
541 # if HAVE_RAW_DECL_RANDOM
542 _GL_WARN_ON_USE (random
, "random is unportable - "
543 "use gnulib module random for portability");
549 _GL_FUNCDECL_SYS (srandom
, void, (unsigned int seed
));
551 _GL_CXXALIAS_SYS (srandom
, void, (unsigned int seed
));
552 _GL_CXXALIASWARN (srandom
);
553 #elif defined GNULIB_POSIXCHECK
555 # if HAVE_RAW_DECL_SRANDOM
556 _GL_WARN_ON_USE (srandom
, "srandom is unportable - "
557 "use gnulib module random for portability");
563 _GL_FUNCDECL_SYS (initstate
, char *,
564 (unsigned int seed
, char *buf
, size_t buf_size
)
565 _GL_ARG_NONNULL ((2)));
567 _GL_CXXALIAS_SYS (initstate
, char *,
568 (unsigned int seed
, char *buf
, size_t buf_size
));
569 _GL_CXXALIASWARN (initstate
);
570 #elif defined GNULIB_POSIXCHECK
572 # if HAVE_RAW_DECL_INITSTATE_R
573 _GL_WARN_ON_USE (initstate
, "initstate is unportable - "
574 "use gnulib module random for portability");
580 _GL_FUNCDECL_SYS (setstate
, char *, (char *arg_state
) _GL_ARG_NONNULL ((1)));
582 _GL_CXXALIAS_SYS (setstate
, char *, (char *arg_state
));
583 _GL_CXXALIASWARN (setstate
);
584 #elif defined GNULIB_POSIXCHECK
586 # if HAVE_RAW_DECL_SETSTATE_R
587 _GL_WARN_ON_USE (setstate
, "setstate is unportable - "
588 "use gnulib module random for portability");
593 #if @GNULIB_RANDOM_R@
594 # if @REPLACE_RANDOM_R@
595 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
597 # define random_r rpl_random_r
599 _GL_FUNCDECL_RPL (random_r
, int, (struct random_data
*buf
, int32_t *result
)
600 _GL_ARG_NONNULL ((1, 2)));
601 _GL_CXXALIAS_RPL (random_r
, int, (struct random_data
*buf
, int32_t *result
));
603 # if !@HAVE_RANDOM_R@
604 _GL_FUNCDECL_SYS (random_r
, int, (struct random_data
*buf
, int32_t *result
)
605 _GL_ARG_NONNULL ((1, 2)));
607 _GL_CXXALIAS_SYS (random_r
, int, (struct random_data
*buf
, int32_t *result
));
609 _GL_CXXALIASWARN (random_r
);
610 #elif defined GNULIB_POSIXCHECK
612 # if HAVE_RAW_DECL_RANDOM_R
613 _GL_WARN_ON_USE (random_r
, "random_r is unportable - "
614 "use gnulib module random_r for portability");
618 #if @GNULIB_RANDOM_R@
619 # if @REPLACE_RANDOM_R@
620 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
622 # define srandom_r rpl_srandom_r
624 _GL_FUNCDECL_RPL (srandom_r
, int,
625 (unsigned int seed
, struct random_data
*rand_state
)
626 _GL_ARG_NONNULL ((2)));
627 _GL_CXXALIAS_RPL (srandom_r
, int,
628 (unsigned int seed
, struct random_data
*rand_state
));
630 # if !@HAVE_RANDOM_R@
631 _GL_FUNCDECL_SYS (srandom_r
, int,
632 (unsigned int seed
, struct random_data
*rand_state
)
633 _GL_ARG_NONNULL ((2)));
635 _GL_CXXALIAS_SYS (srandom_r
, int,
636 (unsigned int seed
, struct random_data
*rand_state
));
638 _GL_CXXALIASWARN (srandom_r
);
639 #elif defined GNULIB_POSIXCHECK
641 # if HAVE_RAW_DECL_SRANDOM_R
642 _GL_WARN_ON_USE (srandom_r
, "srandom_r is unportable - "
643 "use gnulib module random_r for portability");
647 #if @GNULIB_RANDOM_R@
648 # if @REPLACE_RANDOM_R@
649 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
651 # define initstate_r rpl_initstate_r
653 _GL_FUNCDECL_RPL (initstate_r
, int,
654 (unsigned int seed
, char *buf
, size_t buf_size
,
655 struct random_data
*rand_state
)
656 _GL_ARG_NONNULL ((2, 4)));
657 _GL_CXXALIAS_RPL (initstate_r
, int,
658 (unsigned int seed
, char *buf
, size_t buf_size
,
659 struct random_data
*rand_state
));
661 # if !@HAVE_RANDOM_R@
662 _GL_FUNCDECL_SYS (initstate_r
, int,
663 (unsigned int seed
, char *buf
, size_t buf_size
,
664 struct random_data
*rand_state
)
665 _GL_ARG_NONNULL ((2, 4)));
667 _GL_CXXALIAS_SYS (initstate_r
, int,
668 (unsigned int seed
, char *buf
, size_t buf_size
,
669 struct random_data
*rand_state
));
671 _GL_CXXALIASWARN (initstate_r
);
672 #elif defined GNULIB_POSIXCHECK
674 # if HAVE_RAW_DECL_INITSTATE_R
675 _GL_WARN_ON_USE (initstate_r
, "initstate_r is unportable - "
676 "use gnulib module random_r for portability");
680 #if @GNULIB_RANDOM_R@
681 # if @REPLACE_RANDOM_R@
682 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
684 # define setstate_r rpl_setstate_r
686 _GL_FUNCDECL_RPL (setstate_r
, int,
687 (char *arg_state
, struct random_data
*rand_state
)
688 _GL_ARG_NONNULL ((1, 2)));
689 _GL_CXXALIAS_RPL (setstate_r
, int,
690 (char *arg_state
, struct random_data
*rand_state
));
692 # if !@HAVE_RANDOM_R@
693 _GL_FUNCDECL_SYS (setstate_r
, int,
694 (char *arg_state
, struct random_data
*rand_state
)
695 _GL_ARG_NONNULL ((1, 2)));
697 _GL_CXXALIAS_SYS (setstate_r
, int,
698 (char *arg_state
, struct random_data
*rand_state
));
700 _GL_CXXALIASWARN (setstate_r
);
701 #elif defined GNULIB_POSIXCHECK
703 # if HAVE_RAW_DECL_SETSTATE_R
704 _GL_WARN_ON_USE (setstate_r
, "setstate_r is unportable - "
705 "use gnulib module random_r for portability");
710 #if @GNULIB_REALLOC_POSIX@
711 # if @REPLACE_REALLOC@
712 # if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
713 || _GL_USE_STDLIB_ALLOC)
715 # define realloc rpl_realloc
717 _GL_FUNCDECL_RPL (realloc
, void *, (void *ptr
, size_t size
));
718 _GL_CXXALIAS_RPL (realloc
, void *, (void *ptr
, size_t size
));
720 _GL_CXXALIAS_SYS (realloc
, void *, (void *ptr
, size_t size
));
722 _GL_CXXALIASWARN (realloc
);
723 #elif defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
725 /* Assume realloc is always declared. */
726 _GL_WARN_ON_USE (realloc
, "realloc is not POSIX compliant everywhere - "
727 "use gnulib module realloc-posix for portability");
730 #if @GNULIB_REALPATH@
731 # if @REPLACE_REALPATH@
732 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
733 # define realpath rpl_realpath
735 _GL_FUNCDECL_RPL (realpath
, char *, (const char *name
, char *resolved
)
736 _GL_ARG_NONNULL ((1)));
737 _GL_CXXALIAS_RPL (realpath
, char *, (const char *name
, char *resolved
));
739 # if !@HAVE_REALPATH@
740 _GL_FUNCDECL_SYS (realpath
, char *, (const char *name
, char *resolved
)
741 _GL_ARG_NONNULL ((1)));
743 _GL_CXXALIAS_SYS (realpath
, char *, (const char *name
, char *resolved
));
745 _GL_CXXALIASWARN (realpath
);
746 #elif defined GNULIB_POSIXCHECK
748 # if HAVE_RAW_DECL_REALPATH
749 _GL_WARN_ON_USE (realpath
, "realpath is unportable - use gnulib module "
750 "canonicalize or canonicalize-lgpl for portability");
755 /* Test a user response to a question.
756 Return 1 if it is affirmative, 0 if it is negative, or -1 if not clear. */
758 _GL_FUNCDECL_SYS (rpmatch
, int, (const char *response
) _GL_ARG_NONNULL ((1)));
760 _GL_CXXALIAS_SYS (rpmatch
, int, (const char *response
));
761 _GL_CXXALIASWARN (rpmatch
);
762 #elif defined GNULIB_POSIXCHECK
764 # if HAVE_RAW_DECL_RPMATCH
765 _GL_WARN_ON_USE (rpmatch
, "rpmatch is unportable - "
766 "use gnulib module rpmatch for portability");
770 #if @GNULIB_SECURE_GETENV@
771 /* Look up NAME in the environment, returning 0 in insecure situations. */
772 # if !@HAVE_SECURE_GETENV@
773 _GL_FUNCDECL_SYS (secure_getenv
, char *,
774 (char const *name
) _GL_ARG_NONNULL ((1)));
776 _GL_CXXALIAS_SYS (secure_getenv
, int, (char const *name
));
777 _GL_CXXALIASWARN (secure_getenv
);
778 #elif defined GNULIB_POSIXCHECK
779 # undef secure_getenv
780 # if HAVE_RAW_DECL_SECURE_GETENV
781 _GL_WARN_ON_USE (secure_getenv
, "secure_getenv is unportable - "
782 "use gnulib module secure_getenv for portability");
787 /* Set NAME to VALUE in the environment.
788 If REPLACE is nonzero, overwrite an existing value. */
789 # if @REPLACE_SETENV@
790 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
792 # define setenv rpl_setenv
794 _GL_FUNCDECL_RPL (setenv
, int,
795 (const char *name
, const char *value
, int replace
)
796 _GL_ARG_NONNULL ((1)));
797 _GL_CXXALIAS_RPL (setenv
, int,
798 (const char *name
, const char *value
, int replace
));
800 # if !@HAVE_DECL_SETENV@
801 _GL_FUNCDECL_SYS (setenv
, int,
802 (const char *name
, const char *value
, int replace
)
803 _GL_ARG_NONNULL ((1)));
805 _GL_CXXALIAS_SYS (setenv
, int,
806 (const char *name
, const char *value
, int replace
));
808 # if !(@REPLACE_SETENV@ && !@HAVE_DECL_SETENV@)
809 _GL_CXXALIASWARN (setenv
);
811 #elif defined GNULIB_POSIXCHECK
813 # if HAVE_RAW_DECL_SETENV
814 _GL_WARN_ON_USE (setenv
, "setenv is unportable - "
815 "use gnulib module setenv for portability");
820 /* Parse a double from STRING, updating ENDP if appropriate. */
821 # if @REPLACE_STRTOD@
822 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
823 # define strtod rpl_strtod
825 _GL_FUNCDECL_RPL (strtod
, double, (const char *str
, char **endp
)
826 _GL_ARG_NONNULL ((1)));
827 _GL_CXXALIAS_RPL (strtod
, double, (const char *str
, char **endp
));
830 _GL_FUNCDECL_SYS (strtod
, double, (const char *str
, char **endp
)
831 _GL_ARG_NONNULL ((1)));
833 _GL_CXXALIAS_SYS (strtod
, double, (const char *str
, char **endp
));
835 _GL_CXXALIASWARN (strtod
);
836 #elif defined GNULIB_POSIXCHECK
838 # if HAVE_RAW_DECL_STRTOD
839 _GL_WARN_ON_USE (strtod
, "strtod is unportable - "
840 "use gnulib module strtod for portability");
845 /* Parse a signed integer whose textual representation starts at STRING.
846 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
847 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
849 If ENDPTR is not NULL, the address of the first byte after the integer is
851 Upon overflow, the return value is LLONG_MAX or LLONG_MIN, and errno is set
854 _GL_FUNCDECL_SYS (strtoll
, long long,
855 (const char *string
, char **endptr
, int base
)
856 _GL_ARG_NONNULL ((1)));
858 _GL_CXXALIAS_SYS (strtoll
, long long,
859 (const char *string
, char **endptr
, int base
));
860 _GL_CXXALIASWARN (strtoll
);
861 #elif defined GNULIB_POSIXCHECK
863 # if HAVE_RAW_DECL_STRTOLL
864 _GL_WARN_ON_USE (strtoll
, "strtoll is unportable - "
865 "use gnulib module strtoll for portability");
869 #if @GNULIB_STRTOULL@
870 /* Parse an unsigned integer whose textual representation starts at STRING.
871 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
872 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
874 If ENDPTR is not NULL, the address of the first byte after the integer is
876 Upon overflow, the return value is ULLONG_MAX, and errno is set to
878 # if !@HAVE_STRTOULL@
879 _GL_FUNCDECL_SYS (strtoull
, unsigned long long,
880 (const char *string
, char **endptr
, int base
)
881 _GL_ARG_NONNULL ((1)));
883 _GL_CXXALIAS_SYS (strtoull
, unsigned long long,
884 (const char *string
, char **endptr
, int base
));
885 _GL_CXXALIASWARN (strtoull
);
886 #elif defined GNULIB_POSIXCHECK
888 # if HAVE_RAW_DECL_STRTOULL
889 _GL_WARN_ON_USE (strtoull
, "strtoull is unportable - "
890 "use gnulib module strtoull for portability");
894 #if @GNULIB_UNLOCKPT@
895 /* Unlock the slave side of the pseudo-terminal whose master side is specified
896 by FD, so that it can be opened. */
897 # if !@HAVE_UNLOCKPT@
898 _GL_FUNCDECL_SYS (unlockpt
, int, (int fd
));
900 _GL_CXXALIAS_SYS (unlockpt
, int, (int fd
));
901 _GL_CXXALIASWARN (unlockpt
);
902 #elif defined GNULIB_POSIXCHECK
904 # if HAVE_RAW_DECL_UNLOCKPT
905 _GL_WARN_ON_USE (unlockpt
, "unlockpt is not portable - "
906 "use gnulib module unlockpt for portability");
910 #if @GNULIB_UNSETENV@
911 /* Remove the variable NAME from the environment. */
912 # if @REPLACE_UNSETENV@
913 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
915 # define unsetenv rpl_unsetenv
917 _GL_FUNCDECL_RPL (unsetenv
, int, (const char *name
) _GL_ARG_NONNULL ((1)));
918 _GL_CXXALIAS_RPL (unsetenv
, int, (const char *name
));
920 # if !@HAVE_DECL_UNSETENV@
921 _GL_FUNCDECL_SYS (unsetenv
, int, (const char *name
) _GL_ARG_NONNULL ((1)));
923 _GL_CXXALIAS_SYS (unsetenv
, int, (const char *name
));
925 # if !(@REPLACE_UNSETENV@ && !@HAVE_DECL_UNSETENV@)
926 _GL_CXXALIASWARN (unsetenv
);
928 #elif defined GNULIB_POSIXCHECK
930 # if HAVE_RAW_DECL_UNSETENV
931 _GL_WARN_ON_USE (unsetenv
, "unsetenv is unportable - "
932 "use gnulib module unsetenv for portability");
936 /* Convert a wide character to a multibyte character. */
938 # if @REPLACE_WCTOMB@
939 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
941 # define wctomb rpl_wctomb
943 _GL_FUNCDECL_RPL (wctomb
, int, (char *s
, wchar_t wc
));
944 _GL_CXXALIAS_RPL (wctomb
, int, (char *s
, wchar_t wc
));
946 _GL_CXXALIAS_SYS (wctomb
, int, (char *s
, wchar_t wc
));
948 _GL_CXXALIASWARN (wctomb
);
952 #endif /* _@GUARD_PREFIX@_STDLIB_H */
953 #endif /* _@GUARD_PREFIX@_STDLIB_H */