1 /* A GNU-like <stdlib.h>.
3 Copyright (C) 1995, 2001-2004, 2006-2019 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 <https://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 /* OpenIndiana has a bug: <sys/time.h> must be included before
52 # include <sys/time.h>
53 # include <sys/loadavg.h>
56 /* Native Windows platforms declare mktemp() in <io.h>. */
57 #if 0 && (defined _WIN32 && ! defined __CYGWIN__)
63 /* OSF/1 5.1 declares 'struct random_data' in <random.h>, which is included
64 from <stdlib.h> if _REENTRANT is defined. Include it whenever we need
65 'struct random_data'. */
70 # if !@HAVE_STRUCT_RANDOM_DATA@ || @REPLACE_RANDOM_R@ || !@HAVE_RANDOM_R@
74 # if !@HAVE_STRUCT_RANDOM_DATA@
75 /* Define 'struct random_data'.
76 But allow multiple gnulib generated <stdlib.h> replacements to coexist. */
77 # if !GNULIB_defined_struct_random_data
80 int32_t *fptr
; /* Front pointer. */
81 int32_t *rptr
; /* Rear pointer. */
82 int32_t *state
; /* Array of state values. */
83 int rand_type
; /* Type of random number generator. */
84 int rand_deg
; /* Degree of random number generator. */
85 int rand_sep
; /* Distance between front and rear. */
86 int32_t *end_ptr
; /* Pointer behind state table. */
88 # define GNULIB_defined_struct_random_data 1
93 #if (@GNULIB_MKSTEMP@ || @GNULIB_MKSTEMPS@ || @GNULIB_MKOSTEMP@ || @GNULIB_MKOSTEMPS@ || @GNULIB_GETSUBOPT@ || defined GNULIB_POSIXCHECK) && ! defined __GLIBC__ && !(defined _WIN32 && ! defined __CYGWIN__)
94 /* On Mac OS X 10.3, only <unistd.h> declares mkstemp. */
95 /* On Mac OS X 10.5, only <unistd.h> declares mkstemps. */
96 /* On Mac OS X 10.13, only <unistd.h> declares mkostemp and mkostemps. */
97 /* On Cygwin 1.7.1, only <unistd.h> declares getsubopt. */
98 /* But avoid namespace pollution on glibc systems and native Windows. */
102 /* The __attribute__ feature is available in gcc versions 2.5 and later.
103 The attribute __pure__ was added in gcc 2.96. */
104 #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
105 # define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
107 # define _GL_ATTRIBUTE_PURE /* empty */
110 /* The definition of _Noreturn is copied here. */
112 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
114 /* The definition of _GL_ARG_NONNULL is copied here. */
116 /* The definition of _GL_WARN_ON_USE is copied here. */
119 /* Some systems do not define EXIT_*, despite otherwise supporting C89. */
121 # define EXIT_SUCCESS 0
123 /* Tandem/NSK and other platforms that define EXIT_FAILURE as -1 interfere
124 with proper operation of xargs. */
126 # define EXIT_FAILURE 1
127 #elif EXIT_FAILURE != 1
129 # define EXIT_FAILURE 1
134 /* Terminate the current process with the given return code, without running
135 the 'atexit' handlers. */
137 _GL_FUNCDECL_SYS (_Exit
, _Noreturn
void, (int status
));
139 _GL_CXXALIAS_SYS (_Exit
, void, (int status
));
140 _GL_CXXALIASWARN (_Exit
);
141 #elif defined GNULIB_POSIXCHECK
143 # if HAVE_RAW_DECL__EXIT
144 _GL_WARN_ON_USE (_Exit
, "_Exit is unportable - "
145 "use gnulib module _Exit for portability");
151 /* Parse a signed decimal integer.
152 Returns the value of the integer. Errors are not detected. */
154 _GL_FUNCDECL_SYS (atoll
, long long, (const char *string
)
156 _GL_ARG_NONNULL ((1)));
158 _GL_CXXALIAS_SYS (atoll
, long long, (const char *string
));
159 _GL_CXXALIASWARN (atoll
);
160 #elif defined GNULIB_POSIXCHECK
162 # if HAVE_RAW_DECL_ATOLL
163 _GL_WARN_ON_USE (atoll
, "atoll is unportable - "
164 "use gnulib module atoll for portability");
168 #if @GNULIB_CALLOC_POSIX@
169 # if @REPLACE_CALLOC@
170 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
172 # define calloc rpl_calloc
174 _GL_FUNCDECL_RPL (calloc
, void *, (size_t nmemb
, size_t size
));
175 _GL_CXXALIAS_RPL (calloc
, void *, (size_t nmemb
, size_t size
));
177 _GL_CXXALIAS_SYS (calloc
, void *, (size_t nmemb
, size_t size
));
179 _GL_CXXALIASWARN (calloc
);
180 #elif defined GNULIB_POSIXCHECK
182 /* Assume calloc is always declared. */
183 _GL_WARN_ON_USE (calloc
, "calloc is not POSIX compliant everywhere - "
184 "use gnulib module calloc-posix for portability");
187 #if @GNULIB_CANONICALIZE_FILE_NAME@
188 # if @REPLACE_CANONICALIZE_FILE_NAME@
189 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
190 # define canonicalize_file_name rpl_canonicalize_file_name
192 _GL_FUNCDECL_RPL (canonicalize_file_name
, char *, (const char *name
)
193 _GL_ARG_NONNULL ((1)));
194 _GL_CXXALIAS_RPL (canonicalize_file_name
, char *, (const char *name
));
196 # if !@HAVE_CANONICALIZE_FILE_NAME@
197 _GL_FUNCDECL_SYS (canonicalize_file_name
, char *, (const char *name
)
198 _GL_ARG_NONNULL ((1)));
200 _GL_CXXALIAS_SYS (canonicalize_file_name
, char *, (const char *name
));
202 _GL_CXXALIASWARN (canonicalize_file_name
);
203 #elif defined GNULIB_POSIXCHECK
204 # undef canonicalize_file_name
205 # if HAVE_RAW_DECL_CANONICALIZE_FILE_NAME
206 _GL_WARN_ON_USE (canonicalize_file_name
,
207 "canonicalize_file_name is unportable - "
208 "use gnulib module canonicalize-lgpl for portability");
212 #if @GNULIB_GETLOADAVG@
213 /* Store max(NELEM,3) load average numbers in LOADAVG[].
214 The three numbers are the load average of the last 1 minute, the last 5
215 minutes, and the last 15 minutes, respectively.
216 LOADAVG is an array of NELEM numbers. */
217 # if !@HAVE_DECL_GETLOADAVG@
218 _GL_FUNCDECL_SYS (getloadavg
, int, (double loadavg
[], int nelem
)
219 _GL_ARG_NONNULL ((1)));
221 _GL_CXXALIAS_SYS (getloadavg
, int, (double loadavg
[], int nelem
));
222 _GL_CXXALIASWARN (getloadavg
);
223 #elif defined GNULIB_POSIXCHECK
225 # if HAVE_RAW_DECL_GETLOADAVG
226 _GL_WARN_ON_USE (getloadavg
, "getloadavg is not portable - "
227 "use gnulib module getloadavg for portability");
231 #if @GNULIB_GETSUBOPT@
232 /* Assuming *OPTIONP is a comma separated list of elements of the form
233 "token" or "token=value", getsubopt parses the first of these elements.
234 If the first element refers to a "token" that is member of the given
235 NULL-terminated array of tokens:
236 - It replaces the comma with a NUL byte, updates *OPTIONP to point past
237 the first option and the comma, sets *VALUEP to the value of the
238 element (or NULL if it doesn't contain an "=" sign),
239 - It returns the index of the "token" in the given array of tokens.
240 Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
241 For more details see the POSIX:2001 specification.
242 http://www.opengroup.org/susv3xsh/getsubopt.html */
243 # if !@HAVE_GETSUBOPT@
244 _GL_FUNCDECL_SYS (getsubopt
, int,
245 (char **optionp
, char *const *tokens
, char **valuep
)
246 _GL_ARG_NONNULL ((1, 2, 3)));
248 _GL_CXXALIAS_SYS (getsubopt
, int,
249 (char **optionp
, char *const *tokens
, char **valuep
));
250 _GL_CXXALIASWARN (getsubopt
);
251 #elif defined GNULIB_POSIXCHECK
253 # if HAVE_RAW_DECL_GETSUBOPT
254 _GL_WARN_ON_USE (getsubopt
, "getsubopt is unportable - "
255 "use gnulib module getsubopt for portability");
260 /* Change the ownership and access permission of the slave side of the
261 pseudo-terminal whose master side is specified by FD. */
263 _GL_FUNCDECL_SYS (grantpt
, int, (int fd
));
265 _GL_CXXALIAS_SYS (grantpt
, int, (int fd
));
266 _GL_CXXALIASWARN (grantpt
);
267 #elif defined GNULIB_POSIXCHECK
269 # if HAVE_RAW_DECL_GRANTPT
270 _GL_WARN_ON_USE (grantpt
, "grantpt is not portable - "
271 "use gnulib module grantpt for portability");
275 /* If _GL_USE_STDLIB_ALLOC is nonzero, the including module does not
276 rely on GNU or POSIX semantics for malloc and realloc (for example,
277 by never specifying a zero size), so it does not need malloc or
278 realloc to be redefined. */
279 #if @GNULIB_MALLOC_POSIX@
280 # if @REPLACE_MALLOC@
281 # if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
282 || _GL_USE_STDLIB_ALLOC)
284 # define malloc rpl_malloc
286 _GL_FUNCDECL_RPL (malloc
, void *, (size_t size
));
287 _GL_CXXALIAS_RPL (malloc
, void *, (size_t size
));
289 _GL_CXXALIAS_SYS (malloc
, void *, (size_t size
));
291 _GL_CXXALIASWARN (malloc
);
292 #elif defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
294 /* Assume malloc is always declared. */
295 _GL_WARN_ON_USE (malloc
, "malloc is not POSIX compliant everywhere - "
296 "use gnulib module malloc-posix for portability");
299 /* Convert a multibyte character to a wide character. */
301 # if @REPLACE_MBTOWC@
302 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
304 # define mbtowc rpl_mbtowc
306 _GL_FUNCDECL_RPL (mbtowc
, int, (wchar_t *pwc
, const char *s
, size_t n
));
307 _GL_CXXALIAS_RPL (mbtowc
, int, (wchar_t *pwc
, const char *s
, size_t n
));
310 _GL_FUNCDECL_SYS (mbtowc
, int, (wchar_t *pwc
, const char *s
, size_t n
));
312 _GL_CXXALIAS_SYS (mbtowc
, int, (wchar_t *pwc
, const char *s
, size_t n
));
314 _GL_CXXALIASWARN (mbtowc
);
315 #elif defined GNULIB_POSIXCHECK
317 # if HAVE_RAW_DECL_MBTOWC
318 _GL_WARN_ON_USE (mbtowc
, "mbtowc is not portable - "
319 "use gnulib module mbtowc for portability");
324 /* Create a unique temporary directory from TEMPLATE.
325 The last six characters of TEMPLATE must be "XXXXXX";
326 they are replaced with a string that makes the directory name unique.
327 Returns TEMPLATE, or a null pointer if it cannot get a unique name.
328 The directory is created mode 700. */
330 _GL_FUNCDECL_SYS (mkdtemp
, char *, (char * /*template*/) _GL_ARG_NONNULL ((1)));
332 _GL_CXXALIAS_SYS (mkdtemp
, char *, (char * /*template*/));
333 _GL_CXXALIASWARN (mkdtemp
);
334 #elif defined GNULIB_POSIXCHECK
336 # if HAVE_RAW_DECL_MKDTEMP
337 _GL_WARN_ON_USE (mkdtemp
, "mkdtemp is unportable - "
338 "use gnulib module mkdtemp for portability");
342 #if @GNULIB_MKOSTEMP@
343 /* Create a unique temporary file from TEMPLATE.
344 The last six characters of TEMPLATE must be "XXXXXX";
345 they are replaced with a string that makes the file name unique.
346 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
347 and O_TEXT, O_BINARY (defined in "binary-io.h").
348 The file is then created, with the specified flags, ensuring it didn't exist
350 The file is created read-write (mask at least 0600 & ~umask), but it may be
351 world-readable and world-writable (mask 0666 & ~umask), depending on the
353 Returns the open file descriptor if successful, otherwise -1 and errno
355 # if !@HAVE_MKOSTEMP@
356 _GL_FUNCDECL_SYS (mkostemp
, int, (char * /*template*/, int /*flags*/)
357 _GL_ARG_NONNULL ((1)));
359 _GL_CXXALIAS_SYS (mkostemp
, int, (char * /*template*/, int /*flags*/));
360 _GL_CXXALIASWARN (mkostemp
);
361 #elif defined GNULIB_POSIXCHECK
363 # if HAVE_RAW_DECL_MKOSTEMP
364 _GL_WARN_ON_USE (mkostemp
, "mkostemp is unportable - "
365 "use gnulib module mkostemp for portability");
369 #if @GNULIB_MKOSTEMPS@
370 /* Create a unique temporary file from TEMPLATE.
371 The last six characters of TEMPLATE before a suffix of length
372 SUFFIXLEN must be "XXXXXX";
373 they are replaced with a string that makes the file name unique.
374 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
375 and O_TEXT, O_BINARY (defined in "binary-io.h").
376 The file is then created, with the specified flags, ensuring it didn't exist
378 The file is created read-write (mask at least 0600 & ~umask), but it may be
379 world-readable and world-writable (mask 0666 & ~umask), depending on the
381 Returns the open file descriptor if successful, otherwise -1 and errno
383 # if !@HAVE_MKOSTEMPS@
384 _GL_FUNCDECL_SYS (mkostemps
, int,
385 (char * /*template*/, int /*suffixlen*/, int /*flags*/)
386 _GL_ARG_NONNULL ((1)));
388 _GL_CXXALIAS_SYS (mkostemps
, int,
389 (char * /*template*/, int /*suffixlen*/, int /*flags*/));
390 _GL_CXXALIASWARN (mkostemps
);
391 #elif defined GNULIB_POSIXCHECK
393 # if HAVE_RAW_DECL_MKOSTEMPS
394 _GL_WARN_ON_USE (mkostemps
, "mkostemps is unportable - "
395 "use gnulib module mkostemps for portability");
400 /* Create a unique temporary file from TEMPLATE.
401 The last six characters of TEMPLATE must be "XXXXXX";
402 they are replaced with a string that makes the file name unique.
403 The file is then created, ensuring it didn't exist before.
404 The file is created read-write (mask at least 0600 & ~umask), but it may be
405 world-readable and world-writable (mask 0666 & ~umask), depending on the
407 Returns the open file descriptor if successful, otherwise -1 and errno
409 # if @REPLACE_MKSTEMP@
410 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
411 # define mkstemp rpl_mkstemp
413 _GL_FUNCDECL_RPL (mkstemp
, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
414 _GL_CXXALIAS_RPL (mkstemp
, int, (char * /*template*/));
416 # if ! @HAVE_MKSTEMP@
417 _GL_FUNCDECL_SYS (mkstemp
, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
419 _GL_CXXALIAS_SYS (mkstemp
, int, (char * /*template*/));
421 _GL_CXXALIASWARN (mkstemp
);
422 #elif defined GNULIB_POSIXCHECK
424 # if HAVE_RAW_DECL_MKSTEMP
425 _GL_WARN_ON_USE (mkstemp
, "mkstemp is unportable - "
426 "use gnulib module mkstemp for portability");
430 #if @GNULIB_MKSTEMPS@
431 /* Create a unique temporary file from TEMPLATE.
432 The last six characters of TEMPLATE prior to a suffix of length
433 SUFFIXLEN must be "XXXXXX";
434 they are replaced with a string that makes the file name unique.
435 The file is then created, ensuring it didn't exist before.
436 The file is created read-write (mask at least 0600 & ~umask), but it may be
437 world-readable and world-writable (mask 0666 & ~umask), depending on the
439 Returns the open file descriptor if successful, otherwise -1 and errno
441 # if !@HAVE_MKSTEMPS@
442 _GL_FUNCDECL_SYS (mkstemps
, int, (char * /*template*/, int /*suffixlen*/)
443 _GL_ARG_NONNULL ((1)));
445 _GL_CXXALIAS_SYS (mkstemps
, int, (char * /*template*/, int /*suffixlen*/));
446 _GL_CXXALIASWARN (mkstemps
);
447 #elif defined GNULIB_POSIXCHECK
449 # if HAVE_RAW_DECL_MKSTEMPS
450 _GL_WARN_ON_USE (mkstemps
, "mkstemps is unportable - "
451 "use gnulib module mkstemps for portability");
455 #if @GNULIB_POSIX_OPENPT@
456 /* Return an FD open to the master side of a pseudo-terminal. Flags should
457 include O_RDWR, and may also include O_NOCTTY. */
458 # if !@HAVE_POSIX_OPENPT@
459 _GL_FUNCDECL_SYS (posix_openpt
, int, (int flags
));
461 _GL_CXXALIAS_SYS (posix_openpt
, int, (int flags
));
462 _GL_CXXALIASWARN (posix_openpt
);
463 #elif defined GNULIB_POSIXCHECK
465 # if HAVE_RAW_DECL_POSIX_OPENPT
466 _GL_WARN_ON_USE (posix_openpt
, "posix_openpt is not portable - "
467 "use gnulib module posix_openpt for portability");
472 /* Return the pathname of the pseudo-terminal slave associated with
473 the master FD is open on, or NULL on errors. */
474 # if @REPLACE_PTSNAME@
475 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
477 # define ptsname rpl_ptsname
479 _GL_FUNCDECL_RPL (ptsname
, char *, (int fd
));
480 _GL_CXXALIAS_RPL (ptsname
, char *, (int fd
));
483 _GL_FUNCDECL_SYS (ptsname
, char *, (int fd
));
485 _GL_CXXALIAS_SYS (ptsname
, char *, (int fd
));
487 _GL_CXXALIASWARN (ptsname
);
488 #elif defined GNULIB_POSIXCHECK
490 # if HAVE_RAW_DECL_PTSNAME
491 _GL_WARN_ON_USE (ptsname
, "ptsname is not portable - "
492 "use gnulib module ptsname for portability");
496 #if @GNULIB_PTSNAME_R@
497 /* Set the pathname of the pseudo-terminal slave associated with
498 the master FD is open on and return 0, or set errno and return
499 non-zero on errors. */
500 # if @REPLACE_PTSNAME_R@
501 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
503 # define ptsname_r rpl_ptsname_r
505 _GL_FUNCDECL_RPL (ptsname_r
, int, (int fd
, char *buf
, size_t len
));
506 _GL_CXXALIAS_RPL (ptsname_r
, int, (int fd
, char *buf
, size_t len
));
508 # if !@HAVE_PTSNAME_R@
509 _GL_FUNCDECL_SYS (ptsname_r
, int, (int fd
, char *buf
, size_t len
));
511 _GL_CXXALIAS_SYS (ptsname_r
, int, (int fd
, char *buf
, size_t len
));
513 _GL_CXXALIASWARN (ptsname_r
);
514 #elif defined GNULIB_POSIXCHECK
516 # if HAVE_RAW_DECL_PTSNAME_R
517 _GL_WARN_ON_USE (ptsname_r
, "ptsname_r is not portable - "
518 "use gnulib module ptsname_r for portability");
523 # if @REPLACE_PUTENV@
524 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
526 # define putenv rpl_putenv
528 _GL_FUNCDECL_RPL (putenv
, int, (char *string
) _GL_ARG_NONNULL ((1)));
529 _GL_CXXALIAS_RPL (putenv
, int, (char *string
));
531 _GL_CXXALIAS_SYS (putenv
, int, (char *string
));
533 _GL_CXXALIASWARN (putenv
);
537 /* Sort an array of NMEMB elements, starting at address BASE, each element
538 occupying SIZE bytes, in ascending order according to the comparison
540 # if @REPLACE_QSORT_R@
541 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
543 # define qsort_r rpl_qsort_r
545 _GL_FUNCDECL_RPL (qsort_r
, void, (void *base
, size_t nmemb
, size_t size
,
546 int (*compare
) (void const *, void const *,
548 void *arg
) _GL_ARG_NONNULL ((1, 4)));
549 _GL_CXXALIAS_RPL (qsort_r
, void, (void *base
, size_t nmemb
, size_t size
,
550 int (*compare
) (void const *, void const *,
555 _GL_FUNCDECL_SYS (qsort_r
, void, (void *base
, size_t nmemb
, size_t size
,
556 int (*compare
) (void const *, void const *,
558 void *arg
) _GL_ARG_NONNULL ((1, 4)));
560 _GL_CXXALIAS_SYS (qsort_r
, void, (void *base
, size_t nmemb
, size_t size
,
561 int (*compare
) (void const *, void const *,
565 _GL_CXXALIASWARN (qsort_r
);
566 #elif defined GNULIB_POSIXCHECK
568 # if HAVE_RAW_DECL_QSORT_R
569 _GL_WARN_ON_USE (qsort_r
, "qsort_r is not portable - "
570 "use gnulib module qsort_r for portability");
575 #if @GNULIB_RANDOM_R@
576 # if !@HAVE_RANDOM_R@
578 # define RAND_MAX 2147483647
586 _GL_FUNCDECL_SYS (random
, long, (void));
588 _GL_CXXALIAS_SYS (random
, long, (void));
589 _GL_CXXALIASWARN (random
);
590 #elif defined GNULIB_POSIXCHECK
592 # if HAVE_RAW_DECL_RANDOM
593 _GL_WARN_ON_USE (random
, "random is unportable - "
594 "use gnulib module random for portability");
600 _GL_FUNCDECL_SYS (srandom
, void, (unsigned int seed
));
602 _GL_CXXALIAS_SYS (srandom
, void, (unsigned int seed
));
603 _GL_CXXALIASWARN (srandom
);
604 #elif defined GNULIB_POSIXCHECK
606 # if HAVE_RAW_DECL_SRANDOM
607 _GL_WARN_ON_USE (srandom
, "srandom is unportable - "
608 "use gnulib module random for portability");
613 # if !@HAVE_RANDOM@ || !@HAVE_DECL_INITSTATE@
614 _GL_FUNCDECL_SYS (initstate
, char *,
615 (unsigned int seed
, char *buf
, size_t buf_size
)
616 _GL_ARG_NONNULL ((2)));
618 _GL_CXXALIAS_SYS (initstate
, char *,
619 (unsigned int seed
, char *buf
, size_t buf_size
));
620 _GL_CXXALIASWARN (initstate
);
621 #elif defined GNULIB_POSIXCHECK
623 # if HAVE_RAW_DECL_INITSTATE_R
624 _GL_WARN_ON_USE (initstate
, "initstate is unportable - "
625 "use gnulib module random for portability");
630 # if !@HAVE_RANDOM@ || !@HAVE_DECL_SETSTATE@
631 _GL_FUNCDECL_SYS (setstate
, char *, (char *arg_state
) _GL_ARG_NONNULL ((1)));
633 _GL_CXXALIAS_SYS (setstate
, char *, (char *arg_state
));
634 _GL_CXXALIASWARN (setstate
);
635 #elif defined GNULIB_POSIXCHECK
637 # if HAVE_RAW_DECL_SETSTATE_R
638 _GL_WARN_ON_USE (setstate
, "setstate is unportable - "
639 "use gnulib module random for portability");
644 #if @GNULIB_RANDOM_R@
645 # if @REPLACE_RANDOM_R@
646 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
648 # define random_r rpl_random_r
650 _GL_FUNCDECL_RPL (random_r
, int, (struct random_data
*buf
, int32_t *result
)
651 _GL_ARG_NONNULL ((1, 2)));
652 _GL_CXXALIAS_RPL (random_r
, int, (struct random_data
*buf
, int32_t *result
));
654 # if !@HAVE_RANDOM_R@
655 _GL_FUNCDECL_SYS (random_r
, int, (struct random_data
*buf
, int32_t *result
)
656 _GL_ARG_NONNULL ((1, 2)));
658 _GL_CXXALIAS_SYS (random_r
, int, (struct random_data
*buf
, int32_t *result
));
660 _GL_CXXALIASWARN (random_r
);
661 #elif defined GNULIB_POSIXCHECK
663 # if HAVE_RAW_DECL_RANDOM_R
664 _GL_WARN_ON_USE (random_r
, "random_r is unportable - "
665 "use gnulib module random_r for portability");
669 #if @GNULIB_RANDOM_R@
670 # if @REPLACE_RANDOM_R@
671 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
673 # define srandom_r rpl_srandom_r
675 _GL_FUNCDECL_RPL (srandom_r
, int,
676 (unsigned int seed
, struct random_data
*rand_state
)
677 _GL_ARG_NONNULL ((2)));
678 _GL_CXXALIAS_RPL (srandom_r
, int,
679 (unsigned int seed
, struct random_data
*rand_state
));
681 # if !@HAVE_RANDOM_R@
682 _GL_FUNCDECL_SYS (srandom_r
, int,
683 (unsigned int seed
, struct random_data
*rand_state
)
684 _GL_ARG_NONNULL ((2)));
686 _GL_CXXALIAS_SYS (srandom_r
, int,
687 (unsigned int seed
, struct random_data
*rand_state
));
689 _GL_CXXALIASWARN (srandom_r
);
690 #elif defined GNULIB_POSIXCHECK
692 # if HAVE_RAW_DECL_SRANDOM_R
693 _GL_WARN_ON_USE (srandom_r
, "srandom_r is unportable - "
694 "use gnulib module random_r for portability");
698 #if @GNULIB_RANDOM_R@
699 # if @REPLACE_RANDOM_R@
700 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
702 # define initstate_r rpl_initstate_r
704 _GL_FUNCDECL_RPL (initstate_r
, int,
705 (unsigned int seed
, char *buf
, size_t buf_size
,
706 struct random_data
*rand_state
)
707 _GL_ARG_NONNULL ((2, 4)));
708 _GL_CXXALIAS_RPL (initstate_r
, int,
709 (unsigned int seed
, char *buf
, size_t buf_size
,
710 struct random_data
*rand_state
));
712 # if !@HAVE_RANDOM_R@
713 _GL_FUNCDECL_SYS (initstate_r
, int,
714 (unsigned int seed
, char *buf
, size_t buf_size
,
715 struct random_data
*rand_state
)
716 _GL_ARG_NONNULL ((2, 4)));
718 _GL_CXXALIAS_SYS (initstate_r
, int,
719 (unsigned int seed
, char *buf
, size_t buf_size
,
720 struct random_data
*rand_state
));
722 _GL_CXXALIASWARN (initstate_r
);
723 #elif defined GNULIB_POSIXCHECK
725 # if HAVE_RAW_DECL_INITSTATE_R
726 _GL_WARN_ON_USE (initstate_r
, "initstate_r is unportable - "
727 "use gnulib module random_r for portability");
731 #if @GNULIB_RANDOM_R@
732 # if @REPLACE_RANDOM_R@
733 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
735 # define setstate_r rpl_setstate_r
737 _GL_FUNCDECL_RPL (setstate_r
, int,
738 (char *arg_state
, struct random_data
*rand_state
)
739 _GL_ARG_NONNULL ((1, 2)));
740 _GL_CXXALIAS_RPL (setstate_r
, int,
741 (char *arg_state
, struct random_data
*rand_state
));
743 # if !@HAVE_RANDOM_R@
744 _GL_FUNCDECL_SYS (setstate_r
, int,
745 (char *arg_state
, struct random_data
*rand_state
)
746 _GL_ARG_NONNULL ((1, 2)));
748 _GL_CXXALIAS_SYS (setstate_r
, int,
749 (char *arg_state
, struct random_data
*rand_state
));
751 _GL_CXXALIASWARN (setstate_r
);
752 #elif defined GNULIB_POSIXCHECK
754 # if HAVE_RAW_DECL_SETSTATE_R
755 _GL_WARN_ON_USE (setstate_r
, "setstate_r is unportable - "
756 "use gnulib module random_r for portability");
761 #if @GNULIB_REALLOC_POSIX@
762 # if @REPLACE_REALLOC@
763 # if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
764 || _GL_USE_STDLIB_ALLOC)
766 # define realloc rpl_realloc
768 _GL_FUNCDECL_RPL (realloc
, void *, (void *ptr
, size_t size
));
769 _GL_CXXALIAS_RPL (realloc
, void *, (void *ptr
, size_t size
));
771 _GL_CXXALIAS_SYS (realloc
, void *, (void *ptr
, size_t size
));
773 _GL_CXXALIASWARN (realloc
);
774 #elif defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
776 /* Assume realloc is always declared. */
777 _GL_WARN_ON_USE (realloc
, "realloc is not POSIX compliant everywhere - "
778 "use gnulib module realloc-posix for portability");
782 #if @GNULIB_REALLOCARRAY@
783 # if ! @HAVE_REALLOCARRAY@
784 _GL_FUNCDECL_SYS (reallocarray
, void *,
785 (void *ptr
, size_t nmemb
, size_t size
));
787 _GL_CXXALIAS_SYS (reallocarray
, void *,
788 (void *ptr
, size_t nmemb
, size_t size
));
789 _GL_CXXALIASWARN (reallocarray
);
790 #elif defined GNULIB_POSIXCHECK
792 # if HAVE_RAW_DECL_REALLOCARRAY
793 _GL_WARN_ON_USE (reallocarray
, "reallocarray is not portable - "
794 "use gnulib module reallocarray for portability");
798 #if @GNULIB_REALPATH@
799 # if @REPLACE_REALPATH@
800 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
801 # define realpath rpl_realpath
803 _GL_FUNCDECL_RPL (realpath
, char *, (const char *name
, char *resolved
)
804 _GL_ARG_NONNULL ((1)));
805 _GL_CXXALIAS_RPL (realpath
, char *, (const char *name
, char *resolved
));
807 # if !@HAVE_REALPATH@
808 _GL_FUNCDECL_SYS (realpath
, char *, (const char *name
, char *resolved
)
809 _GL_ARG_NONNULL ((1)));
811 _GL_CXXALIAS_SYS (realpath
, char *, (const char *name
, char *resolved
));
813 _GL_CXXALIASWARN (realpath
);
814 #elif defined GNULIB_POSIXCHECK
816 # if HAVE_RAW_DECL_REALPATH
817 _GL_WARN_ON_USE (realpath
, "realpath is unportable - use gnulib module "
818 "canonicalize or canonicalize-lgpl for portability");
823 /* Test a user response to a question.
824 Return 1 if it is affirmative, 0 if it is negative, or -1 if not clear. */
826 _GL_FUNCDECL_SYS (rpmatch
, int, (const char *response
) _GL_ARG_NONNULL ((1)));
828 _GL_CXXALIAS_SYS (rpmatch
, int, (const char *response
));
829 _GL_CXXALIASWARN (rpmatch
);
830 #elif defined GNULIB_POSIXCHECK
832 # if HAVE_RAW_DECL_RPMATCH
833 _GL_WARN_ON_USE (rpmatch
, "rpmatch is unportable - "
834 "use gnulib module rpmatch for portability");
838 #if @GNULIB_SECURE_GETENV@
839 /* Look up NAME in the environment, returning 0 in insecure situations. */
840 # if !@HAVE_SECURE_GETENV@
841 _GL_FUNCDECL_SYS (secure_getenv
, char *,
842 (char const *name
) _GL_ARG_NONNULL ((1)));
844 _GL_CXXALIAS_SYS (secure_getenv
, char *, (char const *name
));
845 _GL_CXXALIASWARN (secure_getenv
);
846 #elif defined GNULIB_POSIXCHECK
847 # undef secure_getenv
848 # if HAVE_RAW_DECL_SECURE_GETENV
849 _GL_WARN_ON_USE (secure_getenv
, "secure_getenv is unportable - "
850 "use gnulib module secure_getenv for portability");
855 /* Set NAME to VALUE in the environment.
856 If REPLACE is nonzero, overwrite an existing value. */
857 # if @REPLACE_SETENV@
858 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
860 # define setenv rpl_setenv
862 _GL_FUNCDECL_RPL (setenv
, int,
863 (const char *name
, const char *value
, int replace
)
864 _GL_ARG_NONNULL ((1)));
865 _GL_CXXALIAS_RPL (setenv
, int,
866 (const char *name
, const char *value
, int replace
));
868 # if !@HAVE_DECL_SETENV@
869 _GL_FUNCDECL_SYS (setenv
, int,
870 (const char *name
, const char *value
, int replace
)
871 _GL_ARG_NONNULL ((1)));
873 _GL_CXXALIAS_SYS (setenv
, int,
874 (const char *name
, const char *value
, int replace
));
876 # if !(@REPLACE_SETENV@ && !@HAVE_DECL_SETENV@)
877 _GL_CXXALIASWARN (setenv
);
879 #elif defined GNULIB_POSIXCHECK
881 # if HAVE_RAW_DECL_SETENV
882 _GL_WARN_ON_USE (setenv
, "setenv is unportable - "
883 "use gnulib module setenv for portability");
888 /* Parse a double from STRING, updating ENDP if appropriate. */
889 # if @REPLACE_STRTOD@
890 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
891 # define strtod rpl_strtod
893 _GL_FUNCDECL_RPL (strtod
, double, (const char *str
, char **endp
)
894 _GL_ARG_NONNULL ((1)));
895 _GL_CXXALIAS_RPL (strtod
, double, (const char *str
, char **endp
));
898 _GL_FUNCDECL_SYS (strtod
, double, (const char *str
, char **endp
)
899 _GL_ARG_NONNULL ((1)));
901 _GL_CXXALIAS_SYS (strtod
, double, (const char *str
, char **endp
));
903 _GL_CXXALIASWARN (strtod
);
904 #elif defined GNULIB_POSIXCHECK
906 # if HAVE_RAW_DECL_STRTOD
907 _GL_WARN_ON_USE (strtod
, "strtod is unportable - "
908 "use gnulib module strtod for portability");
913 /* Parse a signed integer whose textual representation starts at STRING.
914 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
915 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
917 If ENDPTR is not NULL, the address of the first byte after the integer is
919 Upon overflow, the return value is LLONG_MAX or LLONG_MIN, and errno is set
922 _GL_FUNCDECL_SYS (strtoll
, long long,
923 (const char *string
, char **endptr
, int base
)
924 _GL_ARG_NONNULL ((1)));
926 _GL_CXXALIAS_SYS (strtoll
, long long,
927 (const char *string
, char **endptr
, int base
));
928 _GL_CXXALIASWARN (strtoll
);
929 #elif defined GNULIB_POSIXCHECK
931 # if HAVE_RAW_DECL_STRTOLL
932 _GL_WARN_ON_USE (strtoll
, "strtoll is unportable - "
933 "use gnulib module strtoll for portability");
937 #if @GNULIB_STRTOULL@
938 /* Parse an unsigned integer whose textual representation starts at STRING.
939 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
940 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
942 If ENDPTR is not NULL, the address of the first byte after the integer is
944 Upon overflow, the return value is ULLONG_MAX, and errno is set to
946 # if !@HAVE_STRTOULL@
947 _GL_FUNCDECL_SYS (strtoull
, unsigned long long,
948 (const char *string
, char **endptr
, int base
)
949 _GL_ARG_NONNULL ((1)));
951 _GL_CXXALIAS_SYS (strtoull
, unsigned long long,
952 (const char *string
, char **endptr
, int base
));
953 _GL_CXXALIASWARN (strtoull
);
954 #elif defined GNULIB_POSIXCHECK
956 # if HAVE_RAW_DECL_STRTOULL
957 _GL_WARN_ON_USE (strtoull
, "strtoull is unportable - "
958 "use gnulib module strtoull for portability");
962 #if @GNULIB_UNLOCKPT@
963 /* Unlock the slave side of the pseudo-terminal whose master side is specified
964 by FD, so that it can be opened. */
965 # if !@HAVE_UNLOCKPT@
966 _GL_FUNCDECL_SYS (unlockpt
, int, (int fd
));
968 _GL_CXXALIAS_SYS (unlockpt
, int, (int fd
));
969 _GL_CXXALIASWARN (unlockpt
);
970 #elif defined GNULIB_POSIXCHECK
972 # if HAVE_RAW_DECL_UNLOCKPT
973 _GL_WARN_ON_USE (unlockpt
, "unlockpt is not portable - "
974 "use gnulib module unlockpt for portability");
978 #if @GNULIB_UNSETENV@
979 /* Remove the variable NAME from the environment. */
980 # if @REPLACE_UNSETENV@
981 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
983 # define unsetenv rpl_unsetenv
985 _GL_FUNCDECL_RPL (unsetenv
, int, (const char *name
) _GL_ARG_NONNULL ((1)));
986 _GL_CXXALIAS_RPL (unsetenv
, int, (const char *name
));
988 # if !@HAVE_DECL_UNSETENV@
989 _GL_FUNCDECL_SYS (unsetenv
, int, (const char *name
) _GL_ARG_NONNULL ((1)));
991 _GL_CXXALIAS_SYS (unsetenv
, int, (const char *name
));
993 # if !(@REPLACE_UNSETENV@ && !@HAVE_DECL_UNSETENV@)
994 _GL_CXXALIASWARN (unsetenv
);
996 #elif defined GNULIB_POSIXCHECK
998 # if HAVE_RAW_DECL_UNSETENV
999 _GL_WARN_ON_USE (unsetenv
, "unsetenv is unportable - "
1000 "use gnulib module unsetenv for portability");
1004 /* Convert a wide character to a multibyte character. */
1006 # if @REPLACE_WCTOMB@
1007 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1009 # define wctomb rpl_wctomb
1011 _GL_FUNCDECL_RPL (wctomb
, int, (char *s
, wchar_t wc
));
1012 _GL_CXXALIAS_RPL (wctomb
, int, (char *s
, wchar_t wc
));
1014 _GL_CXXALIAS_SYS (wctomb
, int, (char *s
, wchar_t wc
));
1016 _GL_CXXALIASWARN (wctomb
);
1020 #endif /* _@GUARD_PREFIX@_STDLIB_H */
1021 #endif /* _@GUARD_PREFIX@_STDLIB_H */