1 /* A GNU-like <stdlib.h>.
2
3 Copyright (C) 1995, 2001-2004, 2006-2021 Free Software Foundation, Inc.
4
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.
9
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.
14
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/>. */
17
18 #if __GNUC__ >= 3
19 @PRAGMA_SYSTEM_HEADER@
20 #endif
21 @PRAGMA_COLUMNS@
22
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. */
26
27 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
28
29 #else
30 /* Normal invocation convention. */
31
32 #ifndef _@GUARD_PREFIX@_STDLIB_H
33
34 /* The include_next requires a split double-inclusion guard. */
35 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
36
37 #ifndef _@GUARD_PREFIX@_STDLIB_H
38 #define _@GUARD_PREFIX@_STDLIB_H
39
40 /* NetBSD 5.0 mis-defines NULL. */
41 #include <stddef.h>
42
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>
46 #endif
47
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
51 <sys/loadavg.h>. */
52 # include <sys/time.h>
53 # include <sys/loadavg.h>
54 #endif
55
56 /* Native Windows platforms declare _mktemp() in <io.h>. */
57 #if defined _WIN32 && !defined __CYGWIN__
58 # include <io.h>
59 #endif
60
61 #if @GNULIB_RANDOM_R@
62
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'. */
66 # if @HAVE_RANDOM_H@
67 # include <random.h>
68 # endif
69
70 # if !@HAVE_STRUCT_RANDOM_DATA@ || @REPLACE_RANDOM_R@ || !@HAVE_RANDOM_R@
71 # include <stdint.h>
72 # endif
73
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
78 struct random_data
79 {
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. */
87 };
88 # define GNULIB_defined_struct_random_data 1
89 # endif
90 # endif
91 #endif
92
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. */
99 # include <unistd.h>
100 #endif
101
102 /* The __attribute__ feature is available in gcc versions 2.5 and later.
103 The attribute __pure__ was added in gcc 2.96. */
104 #ifndef _GL_ATTRIBUTE_PURE
105 # if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96) || defined __clang__
106 # define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
107 # else
108 # define _GL_ATTRIBUTE_PURE /* empty */
109 # endif
110 #endif
111
112 /* The definition of _Noreturn is copied here. */
113
114 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
115
116 /* The definition of _GL_ARG_NONNULL is copied here. */
117
118 /* The definition of _GL_WARN_ON_USE is copied here. */
119
120
121 /* Some systems do not define EXIT_*, despite otherwise supporting C89. */
122 #ifndef EXIT_SUCCESS
123 # define EXIT_SUCCESS 0
124 #endif
125 /* Tandem/NSK and other platforms that define EXIT_FAILURE as -1 interfere
126 with proper operation of xargs. */
127 #ifndef EXIT_FAILURE
128 # define EXIT_FAILURE 1
129 #elif EXIT_FAILURE != 1
130 # undef EXIT_FAILURE
131 # define EXIT_FAILURE 1
132 #endif
133
134
135 #if @GNULIB__EXIT@
136 /* Terminate the current process with the given return code, without running
137 the 'atexit' handlers. */
138 # if !@HAVE__EXIT@
139 _GL_FUNCDECL_SYS (_Exit, _Noreturn void, (int status));
140 # endif
141 _GL_CXXALIAS_SYS (_Exit, void, (int status));
142 _GL_CXXALIASWARN (_Exit);
143 #elif defined GNULIB_POSIXCHECK
144 # undef _Exit
145 # if HAVE_RAW_DECL__EXIT
146 _GL_WARN_ON_USE (_Exit, "_Exit is unportable - "
147 "use gnulib module _Exit for portability");
148 # endif
149 #endif
150
151
152 /* Allocate memory with indefinite extent and specified alignment. */
153 #if @GNULIB_ALIGNED_ALLOC@
154 # if @REPLACE_ALIGNED_ALLOC@
155 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
156 # undef aligned_alloc
157 # define aligned_alloc rpl_aligned_alloc
158 # endif
159 _GL_FUNCDECL_RPL (aligned_alloc, void *, (size_t alignment, size_t size));
160 _GL_CXXALIAS_RPL (aligned_alloc, void *, (size_t alignment, size_t size));
161 # else
162 # if @HAVE_ALIGNED_ALLOC@
163 _GL_CXXALIAS_SYS (aligned_alloc, void *, (size_t alignment, size_t size));
164 # endif
165 # endif
166 # if @HAVE_ALIGNED_ALLOC@
167 _GL_CXXALIASWARN (aligned_alloc);
168 # endif
169 #elif defined GNULIB_POSIXCHECK
170 # undef aligned_alloc
171 # if HAVE_RAW_DECL_ALIGNED_ALLOC
172 _GL_WARN_ON_USE (aligned_alloc, "aligned_alloc is not portable - "
173 "use gnulib module aligned_alloc for portability");
174 # endif
175 #endif
176
177 #if @GNULIB_ATOLL@
178 /* Parse a signed decimal integer.
179 Returns the value of the integer. Errors are not detected. */
180 # if !@HAVE_ATOLL@
181 _GL_FUNCDECL_SYS (atoll, long long, (const char *string)
182 _GL_ATTRIBUTE_PURE
183 _GL_ARG_NONNULL ((1)));
184 # endif
185 _GL_CXXALIAS_SYS (atoll, long long, (const char *string));
186 _GL_CXXALIASWARN (atoll);
187 #elif defined GNULIB_POSIXCHECK
188 # undef atoll
189 # if HAVE_RAW_DECL_ATOLL
190 _GL_WARN_ON_USE (atoll, "atoll is unportable - "
191 "use gnulib module atoll for portability");
192 # endif
193 #endif
194
195 #if @GNULIB_CALLOC_POSIX@
196 # if @REPLACE_CALLOC@
197 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
198 # undef calloc
199 # define calloc rpl_calloc
200 # endif
201 _GL_FUNCDECL_RPL (calloc, void *, (size_t nmemb, size_t size));
202 _GL_CXXALIAS_RPL (calloc, void *, (size_t nmemb, size_t size));
203 # else
204 _GL_CXXALIAS_SYS (calloc, void *, (size_t nmemb, size_t size));
205 # endif
206 # if __GLIBC__ >= 2
207 _GL_CXXALIASWARN (calloc);
208 # endif
209 #elif defined GNULIB_POSIXCHECK
210 # undef calloc
211 /* Assume calloc is always declared. */
212 _GL_WARN_ON_USE (calloc, "calloc is not POSIX compliant everywhere - "
213 "use gnulib module calloc-posix for portability");
214 #endif
215
216 #if @GNULIB_CANONICALIZE_FILE_NAME@
217 # if @REPLACE_CANONICALIZE_FILE_NAME@
218 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
219 # define canonicalize_file_name rpl_canonicalize_file_name
220 # endif
221 _GL_FUNCDECL_RPL (canonicalize_file_name, char *, (const char *name)
222 _GL_ARG_NONNULL ((1)));
223 _GL_CXXALIAS_RPL (canonicalize_file_name, char *, (const char *name));
224 # else
225 # if !@HAVE_CANONICALIZE_FILE_NAME@
226 _GL_FUNCDECL_SYS (canonicalize_file_name, char *, (const char *name)
227 _GL_ARG_NONNULL ((1)));
228 # endif
229 _GL_CXXALIAS_SYS (canonicalize_file_name, char *, (const char *name));
230 # endif
231 # ifndef GNULIB_defined_canonicalize_file_name
232 # define GNULIB_defined_canonicalize_file_name \
233 (!@HAVE_CANONICALIZE_FILE_NAME@ || @REPLACE_CANONICALIZE_FILE_NAME@)
234 # endif
235 _GL_CXXALIASWARN (canonicalize_file_name);
236 #elif defined GNULIB_POSIXCHECK
237 # undef canonicalize_file_name
238 # if HAVE_RAW_DECL_CANONICALIZE_FILE_NAME
239 _GL_WARN_ON_USE (canonicalize_file_name,
240 "canonicalize_file_name is unportable - "
241 "use gnulib module canonicalize-lgpl for portability");
242 # endif
243 #endif
244
245 #if @GNULIB_MDA_ECVT@
246 /* On native Windows, map 'ecvt' to '_ecvt', so that -loldnames is not
247 required. In C++ with GNULIB_NAMESPACE, avoid differences between
248 platforms by defining GNULIB_NAMESPACE::ecvt on all platforms that have
249 it. */
250 # if defined _WIN32 && !defined __CYGWIN__
251 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
252 # undef ecvt
253 # define ecvt _ecvt
254 # endif
255 _GL_CXXALIAS_MDA (ecvt, char *,
256 (double number, int ndigits, int *decptp, int *signp));
257 # else
258 # if @HAVE_DECL_ECVT@
259 _GL_CXXALIAS_SYS (ecvt, char *,
260 (double number, int ndigits, int *decptp, int *signp));
261 # endif
262 # endif
263 # if (defined _WIN32 && !defined __CYGWIN__) || @HAVE_DECL_ECVT@
264 _GL_CXXALIASWARN (ecvt);
265 # endif
266 #endif
267
268 #if @GNULIB_MDA_FCVT@
269 /* On native Windows, map 'fcvt' to '_fcvt', so that -loldnames is not
270 required. In C++ with GNULIB_NAMESPACE, avoid differences between
271 platforms by defining GNULIB_NAMESPACE::fcvt on all platforms that have
272 it. */
273 # if defined _WIN32 && !defined __CYGWIN__
274 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
275 # undef fcvt
276 # define fcvt _fcvt
277 # endif
278 _GL_CXXALIAS_MDA (fcvt, char *,
279 (double number, int ndigits, int *decptp, int *signp));
280 # else
281 # if @HAVE_DECL_FCVT@
282 _GL_CXXALIAS_SYS (fcvt, char *,
283 (double number, int ndigits, int *decptp, int *signp));
284 # endif
285 # endif
286 # if (defined _WIN32 && !defined __CYGWIN__) || @HAVE_DECL_FCVT@
287 _GL_CXXALIASWARN (fcvt);
288 # endif
289 #endif
290
291 #if @GNULIB_FREE_POSIX@
292 # if @REPLACE_FREE@
293 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
294 # undef free
295 # define free rpl_free
296 # endif
297 _GL_FUNCDECL_RPL (free, void, (void *ptr));
298 _GL_CXXALIAS_RPL (free, void, (void *ptr));
299 # else
300 _GL_CXXALIAS_SYS (free, void, (void *ptr));
301 # endif
302 # if __GLIBC__ >= 2
303 _GL_CXXALIASWARN (free);
304 # endif
305 #elif defined GNULIB_POSIXCHECK
306 # undef free
307 /* Assume free is always declared. */
308 _GL_WARN_ON_USE (free, "free is not future POSIX compliant everywhere - "
309 "use gnulib module free for portability");
310 #endif
311
312 #if @GNULIB_MDA_GCVT@
313 /* On native Windows, map 'gcvt' to '_gcvt', so that -loldnames is not
314 required. In C++ with GNULIB_NAMESPACE, avoid differences between
315 platforms by defining GNULIB_NAMESPACE::gcvt on all platforms that have
316 it. */
317 # if defined _WIN32 && !defined __CYGWIN__
318 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
319 # undef gcvt
320 # define gcvt _gcvt
321 # endif
322 _GL_CXXALIAS_MDA (gcvt, char *, (double number, int ndigits, char *buf));
323 # else
324 # if @HAVE_DECL_GCVT@
325 _GL_CXXALIAS_SYS (gcvt, char *, (double number, int ndigits, char *buf));
326 # endif
327 # endif
328 # if (defined _WIN32 && !defined __CYGWIN__) || @HAVE_DECL_GCVT@
329 _GL_CXXALIASWARN (gcvt);
330 # endif
331 #endif
332
333 #if @GNULIB_GETLOADAVG@
334 /* Store max(NELEM,3) load average numbers in LOADAVG[].
335 The three numbers are the load average of the last 1 minute, the last 5
336 minutes, and the last 15 minutes, respectively.
337 LOADAVG is an array of NELEM numbers. */
338 # if !@HAVE_DECL_GETLOADAVG@
339 _GL_FUNCDECL_SYS (getloadavg, int, (double loadavg[], int nelem)
340 _GL_ARG_NONNULL ((1)));
341 # endif
342 _GL_CXXALIAS_SYS (getloadavg, int, (double loadavg[], int nelem));
343 _GL_CXXALIASWARN (getloadavg);
344 #elif defined GNULIB_POSIXCHECK
345 # undef getloadavg
346 # if HAVE_RAW_DECL_GETLOADAVG
347 _GL_WARN_ON_USE (getloadavg, "getloadavg is not portable - "
348 "use gnulib module getloadavg for portability");
349 # endif
350 #endif
351
352 #if @GNULIB_GETSUBOPT@
353 /* Assuming *OPTIONP is a comma separated list of elements of the form
354 "token" or "token=value", getsubopt parses the first of these elements.
355 If the first element refers to a "token" that is member of the given
356 NULL-terminated array of tokens:
357 - It replaces the comma with a NUL byte, updates *OPTIONP to point past
358 the first option and the comma, sets *VALUEP to the value of the
359 element (or NULL if it doesn't contain an "=" sign),
360 - It returns the index of the "token" in the given array of tokens.
361 Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
362 For more details see the POSIX specification.
363 https://pubs.opengroup.org/onlinepubs/9699919799/functions/getsubopt.html */
364 # if !@HAVE_GETSUBOPT@
365 _GL_FUNCDECL_SYS (getsubopt, int,
366 (char **optionp, char *const *tokens, char **valuep)
367 _GL_ARG_NONNULL ((1, 2, 3)));
368 # endif
369 _GL_CXXALIAS_SYS (getsubopt, int,
370 (char **optionp, char *const *tokens, char **valuep));
371 _GL_CXXALIASWARN (getsubopt);
372 #elif defined GNULIB_POSIXCHECK
373 # undef getsubopt
374 # if HAVE_RAW_DECL_GETSUBOPT
375 _GL_WARN_ON_USE (getsubopt, "getsubopt is unportable - "
376 "use gnulib module getsubopt for portability");
377 # endif
378 #endif
379
380 #if @GNULIB_GRANTPT@
381 /* Change the ownership and access permission of the slave side of the
382 pseudo-terminal whose master side is specified by FD. */
383 # if !@HAVE_GRANTPT@
384 _GL_FUNCDECL_SYS (grantpt, int, (int fd));
385 # endif
386 _GL_CXXALIAS_SYS (grantpt, int, (int fd));
387 _GL_CXXALIASWARN (grantpt);
388 #elif defined GNULIB_POSIXCHECK
389 # undef grantpt
390 # if HAVE_RAW_DECL_GRANTPT
391 _GL_WARN_ON_USE (grantpt, "grantpt is not portable - "
392 "use gnulib module grantpt for portability");
393 # endif
394 #endif
395
396 /* If _GL_USE_STDLIB_ALLOC is nonzero, the including module does not
397 rely on GNU or POSIX semantics for malloc and realloc (for example,
398 by never specifying a zero size), so it does not need malloc or
399 realloc to be redefined. */
400 #if @GNULIB_MALLOC_POSIX@
401 # if @REPLACE_MALLOC@
402 # if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
403 || _GL_USE_STDLIB_ALLOC)
404 # undef malloc
405 # define malloc rpl_malloc
406 # endif
407 _GL_FUNCDECL_RPL (malloc, void *, (size_t size));
408 _GL_CXXALIAS_RPL (malloc, void *, (size_t size));
409 # else
410 _GL_CXXALIAS_SYS (malloc, void *, (size_t size));
411 # endif
412 # if __GLIBC__ >= 2
413 _GL_CXXALIASWARN (malloc);
414 # endif
415 #elif defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
416 # undef malloc
417 /* Assume malloc is always declared. */
418 _GL_WARN_ON_USE (malloc, "malloc is not POSIX compliant everywhere - "
419 "use gnulib module malloc-posix for portability");
420 #endif
421
422 /* Convert a multibyte character to a wide character. */
423 #if @GNULIB_MBTOWC@
424 # if @REPLACE_MBTOWC@
425 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
426 # undef mbtowc
427 # define mbtowc rpl_mbtowc
428 # endif
429 _GL_FUNCDECL_RPL (mbtowc, int,
430 (wchar_t *restrict pwc, const char *restrict s, size_t n));
431 _GL_CXXALIAS_RPL (mbtowc, int,
432 (wchar_t *restrict pwc, const char *restrict s, size_t n));
433 # else
434 # if !@HAVE_MBTOWC@
435 _GL_FUNCDECL_SYS (mbtowc, int,
436 (wchar_t *restrict pwc, const char *restrict s, size_t n));
437 # endif
438 _GL_CXXALIAS_SYS (mbtowc, int,
439 (wchar_t *restrict pwc, const char *restrict s, size_t n));
440 # endif
441 # if __GLIBC__ >= 2
442 _GL_CXXALIASWARN (mbtowc);
443 # endif
444 #elif defined GNULIB_POSIXCHECK
445 # undef mbtowc
446 # if HAVE_RAW_DECL_MBTOWC
447 _GL_WARN_ON_USE (mbtowc, "mbtowc is not portable - "
448 "use gnulib module mbtowc for portability");
449 # endif
450 #endif
451
452 #if @GNULIB_MKDTEMP@
453 /* Create a unique temporary directory from TEMPLATE.
454 The last six characters of TEMPLATE must be "XXXXXX";
455 they are replaced with a string that makes the directory name unique.
456 Returns TEMPLATE, or a null pointer if it cannot get a unique name.
457 The directory is created mode 700. */
458 # if !@HAVE_MKDTEMP@
459 _GL_FUNCDECL_SYS (mkdtemp, char *, (char * /*template*/) _GL_ARG_NONNULL ((1)));
460 # endif
461 _GL_CXXALIAS_SYS (mkdtemp, char *, (char * /*template*/));
462 _GL_CXXALIASWARN (mkdtemp);
463 #elif defined GNULIB_POSIXCHECK
464 # undef mkdtemp
465 # if HAVE_RAW_DECL_MKDTEMP
466 _GL_WARN_ON_USE (mkdtemp, "mkdtemp is unportable - "
467 "use gnulib module mkdtemp for portability");
468 # endif
469 #endif
470
471 #if @GNULIB_MKOSTEMP@
472 /* Create a unique temporary file from TEMPLATE.
473 The last six characters of TEMPLATE must be "XXXXXX";
474 they are replaced with a string that makes the file name unique.
475 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
476 and O_TEXT, O_BINARY (defined in "binary-io.h").
477 The file is then created, with the specified flags, ensuring it didn't exist
478 before.
479 The file is created read-write (mask at least 0600 & ~umask), but it may be
480 world-readable and world-writable (mask 0666 & ~umask), depending on the
481 implementation.
482 Returns the open file descriptor if successful, otherwise -1 and errno
483 set. */
484 # if !@HAVE_MKOSTEMP@
485 _GL_FUNCDECL_SYS (mkostemp, int, (char * /*template*/, int /*flags*/)
486 _GL_ARG_NONNULL ((1)));
487 # endif
488 _GL_CXXALIAS_SYS (mkostemp, int, (char * /*template*/, int /*flags*/));
489 _GL_CXXALIASWARN (mkostemp);
490 #elif defined GNULIB_POSIXCHECK
491 # undef mkostemp
492 # if HAVE_RAW_DECL_MKOSTEMP
493 _GL_WARN_ON_USE (mkostemp, "mkostemp is unportable - "
494 "use gnulib module mkostemp for portability");
495 # endif
496 #endif
497
498 #if @GNULIB_MKOSTEMPS@
499 /* Create a unique temporary file from TEMPLATE.
500 The last six characters of TEMPLATE before a suffix of length
501 SUFFIXLEN must be "XXXXXX";
502 they are replaced with a string that makes the file name unique.
503 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
504 and O_TEXT, O_BINARY (defined in "binary-io.h").
505 The file is then created, with the specified flags, ensuring it didn't exist
506 before.
507 The file is created read-write (mask at least 0600 & ~umask), but it may be
508 world-readable and world-writable (mask 0666 & ~umask), depending on the
509 implementation.
510 Returns the open file descriptor if successful, otherwise -1 and errno
511 set. */
512 # if !@HAVE_MKOSTEMPS@
513 _GL_FUNCDECL_SYS (mkostemps, int,
514 (char * /*template*/, int /*suffixlen*/, int /*flags*/)
515 _GL_ARG_NONNULL ((1)));
516 # endif
517 _GL_CXXALIAS_SYS (mkostemps, int,
518 (char * /*template*/, int /*suffixlen*/, int /*flags*/));
519 _GL_CXXALIASWARN (mkostemps);
520 #elif defined GNULIB_POSIXCHECK
521 # undef mkostemps
522 # if HAVE_RAW_DECL_MKOSTEMPS
523 _GL_WARN_ON_USE (mkostemps, "mkostemps is unportable - "
524 "use gnulib module mkostemps for portability");
525 # endif
526 #endif
527
528 #if @GNULIB_MKSTEMP@
529 /* Create a unique temporary file from TEMPLATE.
530 The last six characters of TEMPLATE must be "XXXXXX";
531 they are replaced with a string that makes the file name unique.
532 The file is then created, ensuring it didn't exist before.
533 The file is created read-write (mask at least 0600 & ~umask), but it may be
534 world-readable and world-writable (mask 0666 & ~umask), depending on the
535 implementation.
536 Returns the open file descriptor if successful, otherwise -1 and errno
537 set. */
538 # if @REPLACE_MKSTEMP@
539 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
540 # define mkstemp rpl_mkstemp
541 # endif
542 _GL_FUNCDECL_RPL (mkstemp, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
543 _GL_CXXALIAS_RPL (mkstemp, int, (char * /*template*/));
544 # else
545 # if ! @HAVE_MKSTEMP@
546 _GL_FUNCDECL_SYS (mkstemp, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
547 # endif
548 _GL_CXXALIAS_SYS (mkstemp, int, (char * /*template*/));
549 # endif
550 _GL_CXXALIASWARN (mkstemp);
551 #elif defined GNULIB_POSIXCHECK
552 # undef mkstemp
553 # if HAVE_RAW_DECL_MKSTEMP
554 _GL_WARN_ON_USE (mkstemp, "mkstemp is unportable - "
555 "use gnulib module mkstemp for portability");
556 # endif
557 #endif
558
559 #if @GNULIB_MKSTEMPS@
560 /* Create a unique temporary file from TEMPLATE.
561 The last six characters of TEMPLATE prior to a suffix of length
562 SUFFIXLEN must be "XXXXXX";
563 they are replaced with a string that makes the file name unique.
564 The file is then created, ensuring it didn't exist before.
565 The file is created read-write (mask at least 0600 & ~umask), but it may be
566 world-readable and world-writable (mask 0666 & ~umask), depending on the
567 implementation.
568 Returns the open file descriptor if successful, otherwise -1 and errno
569 set. */
570 # if !@HAVE_MKSTEMPS@
571 _GL_FUNCDECL_SYS (mkstemps, int, (char * /*template*/, int /*suffixlen*/)
572 _GL_ARG_NONNULL ((1)));
573 # endif
574 _GL_CXXALIAS_SYS (mkstemps, int, (char * /*template*/, int /*suffixlen*/));
575 _GL_CXXALIASWARN (mkstemps);
576 #elif defined GNULIB_POSIXCHECK
577 # undef mkstemps
578 # if HAVE_RAW_DECL_MKSTEMPS
579 _GL_WARN_ON_USE (mkstemps, "mkstemps is unportable - "
580 "use gnulib module mkstemps for portability");
581 # endif
582 #endif
583
584 #if @GNULIB_MDA_MKTEMP@
585 /* On native Windows, map 'mktemp' to '_mktemp', so that -loldnames is not
586 required. In C++ with GNULIB_NAMESPACE, avoid differences between
587 platforms by defining GNULIB_NAMESPACE::mktemp always. */
588 # if defined _WIN32 && !defined __CYGWIN__
589 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
590 # undef mktemp
591 # define mktemp _mktemp
592 # endif
593 _GL_CXXALIAS_MDA (mktemp, char *, (char * /*template*/));
594 # else
595 _GL_CXXALIAS_SYS (mktemp, char *, (char * /*template*/));
596 # endif
597 _GL_CXXALIASWARN (mktemp);
598 #endif
599
600 /* Allocate memory with indefinite extent and specified alignment. */
601 #if @GNULIB_POSIX_MEMALIGN@
602 # if @REPLACE_POSIX_MEMALIGN@
603 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
604 # undef posix_memalign
605 # define posix_memalign rpl_posix_memalign
606 # endif
607 _GL_FUNCDECL_RPL (posix_memalign, int,
608 (void **memptr, size_t alignment, size_t size)
609 _GL_ARG_NONNULL ((1)));
610 _GL_CXXALIAS_RPL (posix_memalign, int,
611 (void **memptr, size_t alignment, size_t size));
612 # else
613 # if @HAVE_POSIX_MEMALIGN@
614 _GL_CXXALIAS_SYS (posix_memalign, int,
615 (void **memptr, size_t alignment, size_t size));
616 # endif
617 # endif
618 # if @HAVE_POSIX_MEMALIGN@
619 _GL_CXXALIASWARN (posix_memalign);
620 # endif
621 #elif defined GNULIB_POSIXCHECK
622 # undef posix_memalign
623 # if HAVE_RAW_DECL_POSIX_MEMALIGN
624 _GL_WARN_ON_USE (posix_memalign, "posix_memalign is not portable - "
625 "use gnulib module posix_memalign for portability");
626 # endif
627 #endif
628
629 #if @GNULIB_POSIX_OPENPT@
630 /* Return an FD open to the master side of a pseudo-terminal. Flags should
631 include O_RDWR, and may also include O_NOCTTY. */
632 # if !@HAVE_POSIX_OPENPT@
633 _GL_FUNCDECL_SYS (posix_openpt, int, (int flags));
634 # endif
635 _GL_CXXALIAS_SYS (posix_openpt, int, (int flags));
636 _GL_CXXALIASWARN (posix_openpt);
637 #elif defined GNULIB_POSIXCHECK
638 # undef posix_openpt
639 # if HAVE_RAW_DECL_POSIX_OPENPT
640 _GL_WARN_ON_USE (posix_openpt, "posix_openpt is not portable - "
641 "use gnulib module posix_openpt for portability");
642 # endif
643 #endif
644
645 #if @GNULIB_PTSNAME@
646 /* Return the pathname of the pseudo-terminal slave associated with
647 the master FD is open on, or NULL on errors. */
648 # if @REPLACE_PTSNAME@
649 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
650 # undef ptsname
651 # define ptsname rpl_ptsname
652 # endif
653 _GL_FUNCDECL_RPL (ptsname, char *, (int fd));
654 _GL_CXXALIAS_RPL (ptsname, char *, (int fd));
655 # else
656 # if !@HAVE_PTSNAME@
657 _GL_FUNCDECL_SYS (ptsname, char *, (int fd));
658 # endif
659 _GL_CXXALIAS_SYS (ptsname, char *, (int fd));
660 # endif
661 _GL_CXXALIASWARN (ptsname);
662 #elif defined GNULIB_POSIXCHECK
663 # undef ptsname
664 # if HAVE_RAW_DECL_PTSNAME
665 _GL_WARN_ON_USE (ptsname, "ptsname is not portable - "
666 "use gnulib module ptsname for portability");
667 # endif
668 #endif
669
670 #if @GNULIB_PTSNAME_R@
671 /* Set the pathname of the pseudo-terminal slave associated with
672 the master FD is open on and return 0, or set errno and return
673 non-zero on errors. */
674 # if @REPLACE_PTSNAME_R@
675 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
676 # undef ptsname_r
677 # define ptsname_r rpl_ptsname_r
678 # endif
679 _GL_FUNCDECL_RPL (ptsname_r, int, (int fd, char *buf, size_t len));
680 _GL_CXXALIAS_RPL (ptsname_r, int, (int fd, char *buf, size_t len));
681 # else
682 # if !@HAVE_PTSNAME_R@
683 _GL_FUNCDECL_SYS (ptsname_r, int, (int fd, char *buf, size_t len));
684 # endif
685 _GL_CXXALIAS_SYS (ptsname_r, int, (int fd, char *buf, size_t len));
686 # endif
687 # ifndef GNULIB_defined_ptsname_r
688 # define GNULIB_defined_ptsname_r (!@HAVE_PTSNAME_R@ || @REPLACE_PTSNAME_R@)
689 # endif
690 _GL_CXXALIASWARN (ptsname_r);
691 #elif defined GNULIB_POSIXCHECK
692 # undef ptsname_r
693 # if HAVE_RAW_DECL_PTSNAME_R
694 _GL_WARN_ON_USE (ptsname_r, "ptsname_r is not portable - "
695 "use gnulib module ptsname_r for portability");
696 # endif
697 #endif
698
699 #if @GNULIB_PUTENV@
700 # if @REPLACE_PUTENV@
701 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
702 # undef putenv
703 # define putenv rpl_putenv
704 # endif
705 _GL_FUNCDECL_RPL (putenv, int, (char *string) _GL_ARG_NONNULL ((1)));
706 _GL_CXXALIAS_RPL (putenv, int, (char *string));
707 # elif defined _WIN32 && !defined __CYGWIN__
708 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
709 # undef putenv
710 # define putenv _putenv
711 # endif
712 _GL_CXXALIAS_MDA (putenv, int, (char *string));
713 # else
714 _GL_CXXALIAS_SYS (putenv, int, (char *string));
715 # endif
716 _GL_CXXALIASWARN (putenv);
717 #elif @GNULIB_MDA_PUTENV@
718 /* On native Windows, map 'putenv' to '_putenv', so that -loldnames is not
719 required. In C++ with GNULIB_NAMESPACE, avoid differences between
720 platforms by defining GNULIB_NAMESPACE::putenv always. */
721 # if defined _WIN32 && !defined __CYGWIN__
722 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
723 # undef putenv
724 # define putenv _putenv
725 # endif
726 /* Need to cast, because on mingw, the parameter is either
727 'const char *string' or 'char *string'. */
728 _GL_CXXALIAS_MDA_CAST (putenv, int, (char *string));
729 # else
730 _GL_CXXALIAS_SYS (putenv, int, (char *string));
731 # endif
732 _GL_CXXALIASWARN (putenv);
733 #endif
734
735 #if @GNULIB_QSORT_R@
736 /* Sort an array of NMEMB elements, starting at address BASE, each element
737 occupying SIZE bytes, in ascending order according to the comparison
738 function COMPARE. */
739 # if @REPLACE_QSORT_R@
740 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
741 # undef qsort_r
742 # define qsort_r rpl_qsort_r
743 # endif
744 _GL_FUNCDECL_RPL (qsort_r, void, (void *base, size_t nmemb, size_t size,
745 int (*compare) (void const *, void const *,
746 void *),
747 void *arg) _GL_ARG_NONNULL ((1, 4)));
748 _GL_CXXALIAS_RPL (qsort_r, void, (void *base, size_t nmemb, size_t size,
749 int (*compare) (void const *, void const *,
750 void *),
751 void *arg));
752 # else
753 # if !@HAVE_QSORT_R@
754 _GL_FUNCDECL_SYS (qsort_r, void, (void *base, size_t nmemb, size_t size,
755 int (*compare) (void const *, void const *,
756 void *),
757 void *arg) _GL_ARG_NONNULL ((1, 4)));
758 # endif
759 _GL_CXXALIAS_SYS (qsort_r, void, (void *base, size_t nmemb, size_t size,
760 int (*compare) (void const *, void const *,
761 void *),
762 void *arg));
763 # endif
764 _GL_CXXALIASWARN (qsort_r);
765 #elif defined GNULIB_POSIXCHECK
766 # undef qsort_r
767 # if HAVE_RAW_DECL_QSORT_R
768 _GL_WARN_ON_USE (qsort_r, "qsort_r is not portable - "
769 "use gnulib module qsort_r for portability");
770 # endif
771 #endif
772
773
774 #if @GNULIB_RANDOM_R@
775 # if !@HAVE_RANDOM_R@
776 # ifndef RAND_MAX
777 # define RAND_MAX 2147483647
778 # endif
779 # endif
780 #endif
781
782
783 #if @GNULIB_RANDOM@
784 # if @REPLACE_RANDOM@
785 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
786 # undef random
787 # define random rpl_random
788 # endif
789 _GL_FUNCDECL_RPL (random, long, (void));
790 _GL_CXXALIAS_RPL (random, long, (void));
791 # else
792 # if !@HAVE_RANDOM@
793 _GL_FUNCDECL_SYS (random, long, (void));
794 # endif
795 /* Need to cast, because on Haiku, the return type is
796 int. */
797 _GL_CXXALIAS_SYS_CAST (random, long, (void));
798 # endif
799 _GL_CXXALIASWARN (random);
800 #elif defined GNULIB_POSIXCHECK
801 # undef random
802 # if HAVE_RAW_DECL_RANDOM
803 _GL_WARN_ON_USE (random, "random is unportable - "
804 "use gnulib module random for portability");
805 # endif
806 #endif
807
808 #if @GNULIB_RANDOM@
809 # if @REPLACE_RANDOM@
810 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
811 # undef srandom
812 # define srandom rpl_srandom
813 # endif
814 _GL_FUNCDECL_RPL (srandom, void, (unsigned int seed));
815 _GL_CXXALIAS_RPL (srandom, void, (unsigned int seed));
816 # else
817 # if !@HAVE_RANDOM@
818 _GL_FUNCDECL_SYS (srandom, void, (unsigned int seed));
819 # endif
820 /* Need to cast, because on FreeBSD, the first parameter is
821 unsigned long seed. */
822 _GL_CXXALIAS_SYS_CAST (srandom, void, (unsigned int seed));
823 # endif
824 _GL_CXXALIASWARN (srandom);
825 #elif defined GNULIB_POSIXCHECK
826 # undef srandom
827 # if HAVE_RAW_DECL_SRANDOM
828 _GL_WARN_ON_USE (srandom, "srandom is unportable - "
829 "use gnulib module random for portability");
830 # endif
831 #endif
832
833 #if @GNULIB_RANDOM@
834 # if @REPLACE_INITSTATE@
835 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
836 # undef initstate
837 # define initstate rpl_initstate
838 # endif
839 _GL_FUNCDECL_RPL (initstate, char *,
840 (unsigned int seed, char *buf, size_t buf_size)
841 _GL_ARG_NONNULL ((2)));
842 _GL_CXXALIAS_RPL (initstate, char *,
843 (unsigned int seed, char *buf, size_t buf_size));
844 # else
845 # if !@HAVE_INITSTATE@ || !@HAVE_DECL_INITSTATE@
846 _GL_FUNCDECL_SYS (initstate, char *,
847 (unsigned int seed, char *buf, size_t buf_size)
848 _GL_ARG_NONNULL ((2)));
849 # endif
850 /* Need to cast, because on FreeBSD, the first parameter is
851 unsigned long seed. */
852 _GL_CXXALIAS_SYS_CAST (initstate, char *,
853 (unsigned int seed, char *buf, size_t buf_size));
854 # endif
855 _GL_CXXALIASWARN (initstate);
856 #elif defined GNULIB_POSIXCHECK
857 # undef initstate
858 # if HAVE_RAW_DECL_INITSTATE
859 _GL_WARN_ON_USE (initstate, "initstate is unportable - "
860 "use gnulib module random for portability");
861 # endif
862 #endif
863
864 #if @GNULIB_RANDOM@
865 # if @REPLACE_SETSTATE@
866 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
867 # undef setstate
868 # define setstate rpl_setstate
869 # endif
870 _GL_FUNCDECL_RPL (setstate, char *, (char *arg_state) _GL_ARG_NONNULL ((1)));
871 _GL_CXXALIAS_RPL (setstate, char *, (char *arg_state));
872 # else
873 # if !@HAVE_SETSTATE@ || !@HAVE_DECL_SETSTATE@
874 _GL_FUNCDECL_SYS (setstate, char *, (char *arg_state) _GL_ARG_NONNULL ((1)));
875 # endif
876 /* Need to cast, because on Mac OS X 10.13, HP-UX, Solaris the first parameter
877 is const char *arg_state. */
878 _GL_CXXALIAS_SYS_CAST (setstate, char *, (char *arg_state));
879 # endif
880 _GL_CXXALIASWARN (setstate);
881 #elif defined GNULIB_POSIXCHECK
882 # undef setstate
883 # if HAVE_RAW_DECL_SETSTATE
884 _GL_WARN_ON_USE (setstate, "setstate is unportable - "
885 "use gnulib module random for portability");
886 # endif
887 #endif
888
889
890 #if @GNULIB_RANDOM_R@
891 # if @REPLACE_RANDOM_R@
892 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
893 # undef random_r
894 # define random_r rpl_random_r
895 # endif
896 _GL_FUNCDECL_RPL (random_r, int, (struct random_data *buf, int32_t *result)
897 _GL_ARG_NONNULL ((1, 2)));
898 _GL_CXXALIAS_RPL (random_r, int, (struct random_data *buf, int32_t *result));
899 # else
900 # if !@HAVE_RANDOM_R@
901 _GL_FUNCDECL_SYS (random_r, int, (struct random_data *buf, int32_t *result)
902 _GL_ARG_NONNULL ((1, 2)));
903 # endif
904 _GL_CXXALIAS_SYS (random_r, int, (struct random_data *buf, int32_t *result));
905 # endif
906 _GL_CXXALIASWARN (random_r);
907 #elif defined GNULIB_POSIXCHECK
908 # undef random_r
909 # if HAVE_RAW_DECL_RANDOM_R
910 _GL_WARN_ON_USE (random_r, "random_r is unportable - "
911 "use gnulib module random_r for portability");
912 # endif
913 #endif
914
915 #if @GNULIB_RANDOM_R@
916 # if @REPLACE_RANDOM_R@
917 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
918 # undef srandom_r
919 # define srandom_r rpl_srandom_r
920 # endif
921 _GL_FUNCDECL_RPL (srandom_r, int,
922 (unsigned int seed, struct random_data *rand_state)
923 _GL_ARG_NONNULL ((2)));
924 _GL_CXXALIAS_RPL (srandom_r, int,
925 (unsigned int seed, struct random_data *rand_state));
926 # else
927 # if !@HAVE_RANDOM_R@
928 _GL_FUNCDECL_SYS (srandom_r, int,
929 (unsigned int seed, struct random_data *rand_state)
930 _GL_ARG_NONNULL ((2)));
931 # endif
932 _GL_CXXALIAS_SYS (srandom_r, int,
933 (unsigned int seed, struct random_data *rand_state));
934 # endif
935 _GL_CXXALIASWARN (srandom_r);
936 #elif defined GNULIB_POSIXCHECK
937 # undef srandom_r
938 # if HAVE_RAW_DECL_SRANDOM_R
939 _GL_WARN_ON_USE (srandom_r, "srandom_r is unportable - "
940 "use gnulib module random_r for portability");
941 # endif
942 #endif
943
944 #if @GNULIB_RANDOM_R@
945 # if @REPLACE_RANDOM_R@
946 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
947 # undef initstate_r
948 # define initstate_r rpl_initstate_r
949 # endif
950 _GL_FUNCDECL_RPL (initstate_r, int,
951 (unsigned int seed, char *buf, size_t buf_size,
952 struct random_data *rand_state)
953 _GL_ARG_NONNULL ((2, 4)));
954 _GL_CXXALIAS_RPL (initstate_r, int,
955 (unsigned int seed, char *buf, size_t buf_size,
956 struct random_data *rand_state));
957 # else
958 # if !@HAVE_RANDOM_R@
959 _GL_FUNCDECL_SYS (initstate_r, int,
960 (unsigned int seed, char *buf, size_t buf_size,
961 struct random_data *rand_state)
962 _GL_ARG_NONNULL ((2, 4)));
963 # endif
964 /* Need to cast, because on Haiku, the third parameter is
965 unsigned long buf_size. */
966 _GL_CXXALIAS_SYS_CAST (initstate_r, int,
967 (unsigned int seed, char *buf, size_t buf_size,
968 struct random_data *rand_state));
969 # endif
970 _GL_CXXALIASWARN (initstate_r);
971 #elif defined GNULIB_POSIXCHECK
972 # undef initstate_r
973 # if HAVE_RAW_DECL_INITSTATE_R
974 _GL_WARN_ON_USE (initstate_r, "initstate_r is unportable - "
975 "use gnulib module random_r for portability");
976 # endif
977 #endif
978
979 #if @GNULIB_RANDOM_R@
980 # if @REPLACE_RANDOM_R@
981 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
982 # undef setstate_r
983 # define setstate_r rpl_setstate_r
984 # endif
985 _GL_FUNCDECL_RPL (setstate_r, int,
986 (char *arg_state, struct random_data *rand_state)
987 _GL_ARG_NONNULL ((1, 2)));
988 _GL_CXXALIAS_RPL (setstate_r, int,
989 (char *arg_state, struct random_data *rand_state));
990 # else
991 # if !@HAVE_RANDOM_R@
992 _GL_FUNCDECL_SYS (setstate_r, int,
993 (char *arg_state, struct random_data *rand_state)
994 _GL_ARG_NONNULL ((1, 2)));
995 # endif
996 /* Need to cast, because on Haiku, the first parameter is
997 void *arg_state. */
998 _GL_CXXALIAS_SYS_CAST (setstate_r, int,
999 (char *arg_state, struct random_data *rand_state));
1000 # endif
1001 _GL_CXXALIASWARN (setstate_r);
1002 #elif defined GNULIB_POSIXCHECK
1003 # undef setstate_r
1004 # if HAVE_RAW_DECL_SETSTATE_R
1005 _GL_WARN_ON_USE (setstate_r, "setstate_r is unportable - "
1006 "use gnulib module random_r for portability");
1007 # endif
1008 #endif
1009
1010
1011 #if @GNULIB_REALLOC_POSIX@
1012 # if @REPLACE_REALLOC@
1013 # if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
1014 || _GL_USE_STDLIB_ALLOC)
1015 # undef realloc
1016 # define realloc rpl_realloc
1017 # endif
1018 _GL_FUNCDECL_RPL (realloc, void *, (void *ptr, size_t size));
1019 _GL_CXXALIAS_RPL (realloc, void *, (void *ptr, size_t size));
1020 # else
1021 _GL_CXXALIAS_SYS (realloc, void *, (void *ptr, size_t size));
1022 # endif
1023 # if __GLIBC__ >= 2
1024 _GL_CXXALIASWARN (realloc);
1025 # endif
1026 #elif defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
1027 # undef realloc
1028 /* Assume realloc is always declared. */
1029 _GL_WARN_ON_USE (realloc, "realloc is not POSIX compliant everywhere - "
1030 "use gnulib module realloc-posix for portability");
1031 #endif
1032
1033
1034 #if @GNULIB_REALLOCARRAY@
1035 # if @REPLACE_REALLOCARRAY@
1036 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1037 # undef reallocarray
1038 # define reallocarray rpl_reallocarray
1039 # endif
1040 _GL_FUNCDECL_RPL (reallocarray, void *,
1041 (void *ptr, size_t nmemb, size_t size));
1042 _GL_CXXALIAS_RPL (reallocarray, void *,
1043 (void *ptr, size_t nmemb, size_t size));
1044 # else
1045 # if ! @HAVE_REALLOCARRAY@
1046 _GL_FUNCDECL_SYS (reallocarray, void *,
1047 (void *ptr, size_t nmemb, size_t size));
1048 # endif
1049 _GL_CXXALIAS_SYS (reallocarray, void *,
1050 (void *ptr, size_t nmemb, size_t size));
1051 # endif
1052 _GL_CXXALIASWARN (reallocarray);
1053 #elif defined GNULIB_POSIXCHECK
1054 # undef reallocarray
1055 # if HAVE_RAW_DECL_REALLOCARRAY
1056 _GL_WARN_ON_USE (reallocarray, "reallocarray is not portable - "
1057 "use gnulib module reallocarray for portability");
1058 # endif
1059 #endif
1060
1061 #if @GNULIB_REALPATH@
1062 # if @REPLACE_REALPATH@
1063 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1064 # define realpath rpl_realpath
1065 # endif
1066 _GL_FUNCDECL_RPL (realpath, char *,
1067 (const char *restrict name, char *restrict resolved)
1068 _GL_ARG_NONNULL ((1)));
1069 _GL_CXXALIAS_RPL (realpath, char *,
1070 (const char *restrict name, char *restrict resolved));
1071 # else
1072 # if !@HAVE_REALPATH@
1073 _GL_FUNCDECL_SYS (realpath, char *,
1074 (const char *restrict name, char *restrict resolved)
1075 _GL_ARG_NONNULL ((1)));
1076 # endif
1077 _GL_CXXALIAS_SYS (realpath, char *,
1078 (const char *restrict name, char *restrict resolved));
1079 # endif
1080 _GL_CXXALIASWARN (realpath);
1081 #elif defined GNULIB_POSIXCHECK
1082 # undef realpath
1083 # if HAVE_RAW_DECL_REALPATH
1084 _GL_WARN_ON_USE (realpath, "realpath is unportable - use gnulib module "
1085 "canonicalize or canonicalize-lgpl for portability");
1086 # endif
1087 #endif
1088
1089 #if @GNULIB_RPMATCH@
1090 /* Test a user response to a question.
1091 Return 1 if it is affirmative, 0 if it is negative, or -1 if not clear. */
1092 # if !@HAVE_RPMATCH@
1093 _GL_FUNCDECL_SYS (rpmatch, int, (const char *response) _GL_ARG_NONNULL ((1)));
1094 # endif
1095 _GL_CXXALIAS_SYS (rpmatch, int, (const char *response));
1096 _GL_CXXALIASWARN (rpmatch);
1097 #elif defined GNULIB_POSIXCHECK
1098 # undef rpmatch
1099 # if HAVE_RAW_DECL_RPMATCH
1100 _GL_WARN_ON_USE (rpmatch, "rpmatch is unportable - "
1101 "use gnulib module rpmatch for portability");
1102 # endif
1103 #endif
1104
1105 #if @GNULIB_SECURE_GETENV@
1106 /* Look up NAME in the environment, returning 0 in insecure situations. */
1107 # if !@HAVE_SECURE_GETENV@
1108 _GL_FUNCDECL_SYS (secure_getenv, char *,
1109 (char const *name) _GL_ARG_NONNULL ((1)));
1110 # endif
1111 _GL_CXXALIAS_SYS (secure_getenv, char *, (char const *name));
1112 _GL_CXXALIASWARN (secure_getenv);
1113 #elif defined GNULIB_POSIXCHECK
1114 # undef secure_getenv
1115 # if HAVE_RAW_DECL_SECURE_GETENV
1116 _GL_WARN_ON_USE (secure_getenv, "secure_getenv is unportable - "
1117 "use gnulib module secure_getenv for portability");
1118 # endif
1119 #endif
1120
1121 #if @GNULIB_SETENV@
1122 /* Set NAME to VALUE in the environment.
1123 If REPLACE is nonzero, overwrite an existing value. */
1124 # if @REPLACE_SETENV@
1125 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1126 # undef setenv
1127 # define setenv rpl_setenv
1128 # endif
1129 _GL_FUNCDECL_RPL (setenv, int,
1130 (const char *name, const char *value, int replace)
1131 _GL_ARG_NONNULL ((1)));
1132 _GL_CXXALIAS_RPL (setenv, int,
1133 (const char *name, const char *value, int replace));
1134 # else
1135 # if !@HAVE_DECL_SETENV@
1136 _GL_FUNCDECL_SYS (setenv, int,
1137 (const char *name, const char *value, int replace)
1138 _GL_ARG_NONNULL ((1)));
1139 # endif
1140 _GL_CXXALIAS_SYS (setenv, int,
1141 (const char *name, const char *value, int replace));
1142 # endif
1143 # if !(@REPLACE_SETENV@ && !@HAVE_DECL_SETENV@)
1144 _GL_CXXALIASWARN (setenv);
1145 # endif
1146 #elif defined GNULIB_POSIXCHECK
1147 # undef setenv
1148 # if HAVE_RAW_DECL_SETENV
1149 _GL_WARN_ON_USE (setenv, "setenv is unportable - "
1150 "use gnulib module setenv for portability");
1151 # endif
1152 #endif
1153
1154 #if @GNULIB_STRTOD@
1155 /* Parse a double from STRING, updating ENDP if appropriate. */
1156 # if @REPLACE_STRTOD@
1157 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1158 # define strtod rpl_strtod
1159 # endif
1160 # define GNULIB_defined_strtod_function 1
1161 _GL_FUNCDECL_RPL (strtod, double,
1162 (const char *restrict str, char **restrict endp)
1163 _GL_ARG_NONNULL ((1)));
1164 _GL_CXXALIAS_RPL (strtod, double,
1165 (const char *restrict str, char **restrict endp));
1166 # else
1167 # if !@HAVE_STRTOD@
1168 _GL_FUNCDECL_SYS (strtod, double,
1169 (const char *restrict str, char **restrict endp)
1170 _GL_ARG_NONNULL ((1)));
1171 # endif
1172 _GL_CXXALIAS_SYS (strtod, double,
1173 (const char *restrict str, char **restrict endp));
1174 # endif
1175 # if __GLIBC__ >= 2
1176 _GL_CXXALIASWARN (strtod);
1177 # endif
1178 #elif defined GNULIB_POSIXCHECK
1179 # undef strtod
1180 # if HAVE_RAW_DECL_STRTOD
1181 _GL_WARN_ON_USE (strtod, "strtod is unportable - "
1182 "use gnulib module strtod for portability");
1183 # endif
1184 #endif
1185
1186 #if @GNULIB_STRTOLD@
1187 /* Parse a 'long double' from STRING, updating ENDP if appropriate. */
1188 # if @REPLACE_STRTOLD@
1189 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1190 # define strtold rpl_strtold
1191 # endif
1192 # define GNULIB_defined_strtold_function 1
1193 _GL_FUNCDECL_RPL (strtold, long double,
1194 (const char *restrict str, char **restrict endp)
1195 _GL_ARG_NONNULL ((1)));
1196 _GL_CXXALIAS_RPL (strtold, long double,
1197 (const char *restrict str, char **restrict endp));
1198 # else
1199 # if !@HAVE_STRTOLD@
1200 _GL_FUNCDECL_SYS (strtold, long double,
1201 (const char *restrict str, char **restrict endp)
1202 _GL_ARG_NONNULL ((1)));
1203 # endif
1204 _GL_CXXALIAS_SYS (strtold, long double,
1205 (const char *restrict str, char **restrict endp));
1206 # endif
1207 _GL_CXXALIASWARN (strtold);
1208 #elif defined GNULIB_POSIXCHECK
1209 # undef strtold
1210 # if HAVE_RAW_DECL_STRTOLD
1211 _GL_WARN_ON_USE (strtold, "strtold is unportable - "
1212 "use gnulib module strtold for portability");
1213 # endif
1214 #endif
1215
1216 #if @GNULIB_STRTOL@
1217 /* Parse a signed integer whose textual representation starts at STRING.
1218 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
1219 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
1220 "0x").
1221 If ENDPTR is not NULL, the address of the first byte after the integer is
1222 stored in *ENDPTR.
1223 Upon overflow, the return value is LONG_MAX or LONG_MIN, and errno is set
1224 to ERANGE. */
1225 # if @REPLACE_STRTOL@
1226 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1227 # define strtol rpl_strtol
1228 # endif
1229 # define GNULIB_defined_strtol_function 1
1230 _GL_FUNCDECL_RPL (strtol, long,
1231 (const char *restrict string, char **restrict endptr,
1232 int base)
1233 _GL_ARG_NONNULL ((1)));
1234 _GL_CXXALIAS_RPL (strtol, long,
1235 (const char *restrict string, char **restrict endptr,
1236 int base));
1237 # else
1238 # if !@HAVE_STRTOL@
1239 _GL_FUNCDECL_SYS (strtol, long,
1240 (const char *restrict string, char **restrict endptr,
1241 int base)
1242 _GL_ARG_NONNULL ((1)));
1243 # endif
1244 _GL_CXXALIAS_SYS (strtol, long,
1245 (const char *restrict string, char **restrict endptr,
1246 int base));
1247 # endif
1248 _GL_CXXALIASWARN (strtol);
1249 #elif defined GNULIB_POSIXCHECK
1250 # undef strtol
1251 # if HAVE_RAW_DECL_STRTOL
1252 _GL_WARN_ON_USE (strtol, "strtol is unportable - "
1253 "use gnulib module strtol for portability");
1254 # endif
1255 #endif
1256
1257 #if @GNULIB_STRTOLL@
1258 /* Parse a signed integer whose textual representation starts at STRING.
1259 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
1260 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
1261 "0x").
1262 If ENDPTR is not NULL, the address of the first byte after the integer is
1263 stored in *ENDPTR.
1264 Upon overflow, the return value is LLONG_MAX or LLONG_MIN, and errno is set
1265 to ERANGE. */
1266 # if @REPLACE_STRTOLL@
1267 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1268 # define strtoll rpl_strtoll
1269 # endif
1270 # define GNULIB_defined_strtoll_function 1
1271 _GL_FUNCDECL_RPL (strtoll, long long,
1272 (const char *restrict string, char **restrict endptr,
1273 int base)
1274 _GL_ARG_NONNULL ((1)));
1275 _GL_CXXALIAS_RPL (strtoll, long long,
1276 (const char *restrict string, char **restrict endptr,
1277 int base));
1278 # else
1279 # if !@HAVE_STRTOLL@
1280 _GL_FUNCDECL_SYS (strtoll, long long,
1281 (const char *restrict string, char **restrict endptr,
1282 int base)
1283 _GL_ARG_NONNULL ((1)));
1284 # endif
1285 _GL_CXXALIAS_SYS (strtoll, long long,
1286 (const char *restrict string, char **restrict endptr,
1287 int base));
1288 # endif
1289 _GL_CXXALIASWARN (strtoll);
1290 #elif defined GNULIB_POSIXCHECK
1291 # undef strtoll
1292 # if HAVE_RAW_DECL_STRTOLL
1293 _GL_WARN_ON_USE (strtoll, "strtoll is unportable - "
1294 "use gnulib module strtoll for portability");
1295 # endif
1296 #endif
1297
1298 #if @GNULIB_STRTOUL@
1299 /* Parse an unsigned integer whose textual representation starts at STRING.
1300 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
1301 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
1302 "0x").
1303 If ENDPTR is not NULL, the address of the first byte after the integer is
1304 stored in *ENDPTR.
1305 Upon overflow, the return value is ULONG_MAX, and errno is set to ERANGE. */
1306 # if @REPLACE_STRTOUL@
1307 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1308 # define strtoul rpl_strtoul
1309 # endif
1310 # define GNULIB_defined_strtoul_function 1
1311 _GL_FUNCDECL_RPL (strtoul, unsigned long,
1312 (const char *restrict string, char **restrict endptr,
1313 int base)
1314 _GL_ARG_NONNULL ((1)));
1315 _GL_CXXALIAS_RPL (strtoul, unsigned long,
1316 (const char *restrict string, char **restrict endptr,
1317 int base));
1318 # else
1319 # if !@HAVE_STRTOUL@
1320 _GL_FUNCDECL_SYS (strtoul, unsigned long,
1321 (const char *restrict string, char **restrict endptr,
1322 int base)
1323 _GL_ARG_NONNULL ((1)));
1324 # endif
1325 _GL_CXXALIAS_SYS (strtoul, unsigned long,
1326 (const char *restrict string, char **restrict endptr,
1327 int base));
1328 # endif
1329 _GL_CXXALIASWARN (strtoul);
1330 #elif defined GNULIB_POSIXCHECK
1331 # undef strtoul
1332 # if HAVE_RAW_DECL_STRTOUL
1333 _GL_WARN_ON_USE (strtoul, "strtoul is unportable - "
1334 "use gnulib module strtoul for portability");
1335 # endif
1336 #endif
1337
1338 #if @GNULIB_STRTOULL@
1339 /* Parse an unsigned integer whose textual representation starts at STRING.
1340 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
1341 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
1342 "0x").
1343 If ENDPTR is not NULL, the address of the first byte after the integer is
1344 stored in *ENDPTR.
1345 Upon overflow, the return value is ULLONG_MAX, and errno is set to
1346 ERANGE. */
1347 # if @REPLACE_STRTOULL@
1348 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1349 # define strtoull rpl_strtoull
1350 # endif
1351 # define GNULIB_defined_strtoull_function 1
1352 _GL_FUNCDECL_RPL (strtoull, unsigned long long,
1353 (const char *restrict string, char **restrict endptr,
1354 int base)
1355 _GL_ARG_NONNULL ((1)));
1356 _GL_CXXALIAS_RPL (strtoull, unsigned long long,
1357 (const char *restrict string, char **restrict endptr,
1358 int base));
1359 # else
1360 # if !@HAVE_STRTOULL@
1361 _GL_FUNCDECL_SYS (strtoull, unsigned long long,
1362 (const char *restrict string, char **restrict endptr,
1363 int base)
1364 _GL_ARG_NONNULL ((1)));
1365 # endif
1366 _GL_CXXALIAS_SYS (strtoull, unsigned long long,
1367 (const char *restrict string, char **restrict endptr,
1368 int base));
1369 # endif
1370 _GL_CXXALIASWARN (strtoull);
1371 #elif defined GNULIB_POSIXCHECK
1372 # undef strtoull
1373 # if HAVE_RAW_DECL_STRTOULL
1374 _GL_WARN_ON_USE (strtoull, "strtoull is unportable - "
1375 "use gnulib module strtoull for portability");
1376 # endif
1377 #endif
1378
1379 #if @GNULIB_UNLOCKPT@
1380 /* Unlock the slave side of the pseudo-terminal whose master side is specified
1381 by FD, so that it can be opened. */
1382 # if !@HAVE_UNLOCKPT@
1383 _GL_FUNCDECL_SYS (unlockpt, int, (int fd));
1384 # endif
1385 _GL_CXXALIAS_SYS (unlockpt, int, (int fd));
1386 _GL_CXXALIASWARN (unlockpt);
1387 #elif defined GNULIB_POSIXCHECK
1388 # undef unlockpt
1389 # if HAVE_RAW_DECL_UNLOCKPT
1390 _GL_WARN_ON_USE (unlockpt, "unlockpt is not portable - "
1391 "use gnulib module unlockpt for portability");
1392 # endif
1393 #endif
1394
1395 #if @GNULIB_UNSETENV@
1396 /* Remove the variable NAME from the environment. */
1397 # if @REPLACE_UNSETENV@
1398 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1399 # undef unsetenv
1400 # define unsetenv rpl_unsetenv
1401 # endif
1402 _GL_FUNCDECL_RPL (unsetenv, int, (const char *name) _GL_ARG_NONNULL ((1)));
1403 _GL_CXXALIAS_RPL (unsetenv, int, (const char *name));
1404 # else
1405 # if !@HAVE_DECL_UNSETENV@
1406 _GL_FUNCDECL_SYS (unsetenv, int, (const char *name) _GL_ARG_NONNULL ((1)));
1407 # endif
1408 _GL_CXXALIAS_SYS (unsetenv, int, (const char *name));
1409 # endif
1410 # if !(@REPLACE_UNSETENV@ && !@HAVE_DECL_UNSETENV@)
1411 _GL_CXXALIASWARN (unsetenv);
1412 # endif
1413 #elif defined GNULIB_POSIXCHECK
1414 # undef unsetenv
1415 # if HAVE_RAW_DECL_UNSETENV
1416 _GL_WARN_ON_USE (unsetenv, "unsetenv is unportable - "
1417 "use gnulib module unsetenv for portability");
1418 # endif
1419 #endif
1420
1421 /* Convert a wide character to a multibyte character. */
1422 #if @GNULIB_WCTOMB@
1423 # if @REPLACE_WCTOMB@
1424 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1425 # undef wctomb
1426 # define wctomb rpl_wctomb
1427 # endif
1428 _GL_FUNCDECL_RPL (wctomb, int, (char *s, wchar_t wc));
1429 _GL_CXXALIAS_RPL (wctomb, int, (char *s, wchar_t wc));
1430 # else
1431 _GL_CXXALIAS_SYS (wctomb, int, (char *s, wchar_t wc));
1432 # endif
1433 # if __GLIBC__ >= 2
1434 _GL_CXXALIASWARN (wctomb);
1435 # endif
1436 #endif
1437
1438
1439 #endif /* _@GUARD_PREFIX@_STDLIB_H */
1440 #endif /* _@GUARD_PREFIX@_STDLIB_H */
1441 #endif