Update copyright notices for 2013.
[bpt/emacs.git] / lib / stdlib.in.h
CommitLineData
1f5d53eb
PE
1/* A GNU-like <stdlib.h>.
2
ab422c4d 3 Copyright (C) 1995, 2001-2004, 2006-2013 Free Software Foundation, Inc.
1f5d53eb
PE
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 <http://www.gnu.org/licenses/>. */
17
18#if __GNUC__ >= 3
19@PRAGMA_SYSTEM_HEADER@
20#endif
21@PRAGMA_COLUMNS@
22
23#if defined __need_malloc_and_calloc
24/* Special invocation convention inside glibc header files. */
25
26#@INCLUDE_NEXT@ @NEXT_STDLIB_H@
27
28#else
29/* Normal invocation convention. */
30
6a3e57bb 31#ifndef _@GUARD_PREFIX@_STDLIB_H
1f5d53eb
PE
32
33/* The include_next requires a split double-inclusion guard. */
34#@INCLUDE_NEXT@ @NEXT_STDLIB_H@
35
6a3e57bb
PE
36#ifndef _@GUARD_PREFIX@_STDLIB_H
37#define _@GUARD_PREFIX@_STDLIB_H
1f5d53eb
PE
38
39/* NetBSD 5.0 mis-defines NULL. */
40#include <stddef.h>
41
42/* MirBSD 10 defines WEXITSTATUS in <sys/wait.h>, not in <stdlib.h>. */
43#if @GNULIB_SYSTEM_POSIX@ && !defined WEXITSTATUS
44# include <sys/wait.h>
45#endif
46
47/* Solaris declares getloadavg() in <sys/loadavg.h>. */
48#if (@GNULIB_GETLOADAVG@ || defined GNULIB_POSIXCHECK) && @HAVE_SYS_LOADAVG_H@
49# include <sys/loadavg.h>
50#endif
51
caf8a9b2
PE
52/* Native Windows platforms declare mktemp() in <io.h>. */
53#if 0 && ((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__)
54# include <io.h>
55#endif
56
1f5d53eb
PE
57#if @GNULIB_RANDOM_R@
58
59/* OSF/1 5.1 declares 'struct random_data' in <random.h>, which is included
60 from <stdlib.h> if _REENTRANT is defined. Include it whenever we need
61 'struct random_data'. */
62# if @HAVE_RANDOM_H@
63# include <random.h>
64# endif
65
caf8a9b2 66# if !@HAVE_STRUCT_RANDOM_DATA@ || @REPLACE_RANDOM_R@ || !@HAVE_RANDOM_R@
1f5d53eb
PE
67# include <stdint.h>
68# endif
69
70# if !@HAVE_STRUCT_RANDOM_DATA@
71/* Define 'struct random_data'.
72 But allow multiple gnulib generated <stdlib.h> replacements to coexist. */
73# if !GNULIB_defined_struct_random_data
74struct random_data
75{
76 int32_t *fptr; /* Front pointer. */
77 int32_t *rptr; /* Rear pointer. */
78 int32_t *state; /* Array of state values. */
79 int rand_type; /* Type of random number generator. */
80 int rand_deg; /* Degree of random number generator. */
81 int rand_sep; /* Distance between front and rear. */
82 int32_t *end_ptr; /* Pointer behind state table. */
83};
84# define GNULIB_defined_struct_random_data 1
85# endif
86# endif
87#endif
88
19548d08 89#if (@GNULIB_MKSTEMP@ || @GNULIB_MKSTEMPS@ || @GNULIB_GETSUBOPT@ || defined GNULIB_POSIXCHECK) && ! defined __GLIBC__ && !((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__)
05730648
PE
90/* On Mac OS X 10.3, only <unistd.h> declares mkstemp. */
91/* On Mac OS X 10.5, only <unistd.h> declares mkstemps. */
1f5d53eb
PE
92/* On Cygwin 1.7.1, only <unistd.h> declares getsubopt. */
93/* But avoid namespace pollution on glibc systems and native Windows. */
94# include <unistd.h>
95#endif
96
caf8a9b2
PE
97/* The __attribute__ feature is available in gcc versions 2.5 and later.
98 The attribute __pure__ was added in gcc 2.96. */
99#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
100# define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
101#else
102# define _GL_ATTRIBUTE_PURE /* empty */
103#endif
104
24e0f6b1 105/* The definition of _Noreturn is copied here. */
1f5d53eb
PE
106
107/* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
108
109/* The definition of _GL_ARG_NONNULL is copied here. */
110
111/* The definition of _GL_WARN_ON_USE is copied here. */
112
113
114/* Some systems do not define EXIT_*, despite otherwise supporting C89. */
115#ifndef EXIT_SUCCESS
116# define EXIT_SUCCESS 0
117#endif
118/* Tandem/NSK and other platforms that define EXIT_FAILURE as -1 interfere
119 with proper operation of xargs. */
120#ifndef EXIT_FAILURE
121# define EXIT_FAILURE 1
122#elif EXIT_FAILURE != 1
123# undef EXIT_FAILURE
124# define EXIT_FAILURE 1
125#endif
126
127
128#if @GNULIB__EXIT@
129/* Terminate the current process with the given return code, without running
130 the 'atexit' handlers. */
131# if !@HAVE__EXIT@
24e0f6b1 132_GL_FUNCDECL_SYS (_Exit, _Noreturn void, (int status));
1f5d53eb
PE
133# endif
134_GL_CXXALIAS_SYS (_Exit, void, (int status));
135_GL_CXXALIASWARN (_Exit);
136#elif defined GNULIB_POSIXCHECK
137# undef _Exit
138# if HAVE_RAW_DECL__EXIT
139_GL_WARN_ON_USE (_Exit, "_Exit is unportable - "
140 "use gnulib module _Exit for portability");
141# endif
142#endif
143
144
145#if @GNULIB_ATOLL@
146/* Parse a signed decimal integer.
147 Returns the value of the integer. Errors are not detected. */
148# if !@HAVE_ATOLL@
caf8a9b2
PE
149_GL_FUNCDECL_SYS (atoll, long long, (const char *string)
150 _GL_ATTRIBUTE_PURE
151 _GL_ARG_NONNULL ((1)));
1f5d53eb
PE
152# endif
153_GL_CXXALIAS_SYS (atoll, long long, (const char *string));
154_GL_CXXALIASWARN (atoll);
155#elif defined GNULIB_POSIXCHECK
156# undef atoll
157# if HAVE_RAW_DECL_ATOLL
158_GL_WARN_ON_USE (atoll, "atoll is unportable - "
159 "use gnulib module atoll for portability");
160# endif
161#endif
162
163#if @GNULIB_CALLOC_POSIX@
164# if @REPLACE_CALLOC@
165# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
166# undef calloc
167# define calloc rpl_calloc
168# endif
169_GL_FUNCDECL_RPL (calloc, void *, (size_t nmemb, size_t size));
170_GL_CXXALIAS_RPL (calloc, void *, (size_t nmemb, size_t size));
171# else
172_GL_CXXALIAS_SYS (calloc, void *, (size_t nmemb, size_t size));
173# endif
174_GL_CXXALIASWARN (calloc);
175#elif defined GNULIB_POSIXCHECK
176# undef calloc
177/* Assume calloc is always declared. */
178_GL_WARN_ON_USE (calloc, "calloc is not POSIX compliant everywhere - "
179 "use gnulib module calloc-posix for portability");
180#endif
181
182#if @GNULIB_CANONICALIZE_FILE_NAME@
183# if @REPLACE_CANONICALIZE_FILE_NAME@
184# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
185# define canonicalize_file_name rpl_canonicalize_file_name
186# endif
187_GL_FUNCDECL_RPL (canonicalize_file_name, char *, (const char *name)
188 _GL_ARG_NONNULL ((1)));
189_GL_CXXALIAS_RPL (canonicalize_file_name, char *, (const char *name));
190# else
191# if !@HAVE_CANONICALIZE_FILE_NAME@
192_GL_FUNCDECL_SYS (canonicalize_file_name, char *, (const char *name)
193 _GL_ARG_NONNULL ((1)));
194# endif
195_GL_CXXALIAS_SYS (canonicalize_file_name, char *, (const char *name));
196# endif
197_GL_CXXALIASWARN (canonicalize_file_name);
198#elif defined GNULIB_POSIXCHECK
199# undef canonicalize_file_name
200# if HAVE_RAW_DECL_CANONICALIZE_FILE_NAME
201_GL_WARN_ON_USE (canonicalize_file_name,
202 "canonicalize_file_name is unportable - "
203 "use gnulib module canonicalize-lgpl for portability");
204# endif
205#endif
206
207#if @GNULIB_GETLOADAVG@
208/* Store max(NELEM,3) load average numbers in LOADAVG[].
209 The three numbers are the load average of the last 1 minute, the last 5
210 minutes, and the last 15 minutes, respectively.
211 LOADAVG is an array of NELEM numbers. */
212# if !@HAVE_DECL_GETLOADAVG@
213_GL_FUNCDECL_SYS (getloadavg, int, (double loadavg[], int nelem)
214 _GL_ARG_NONNULL ((1)));
215# endif
216_GL_CXXALIAS_SYS (getloadavg, int, (double loadavg[], int nelem));
217_GL_CXXALIASWARN (getloadavg);
218#elif defined GNULIB_POSIXCHECK
219# undef getloadavg
220# if HAVE_RAW_DECL_GETLOADAVG
221_GL_WARN_ON_USE (getloadavg, "getloadavg is not portable - "
222 "use gnulib module getloadavg for portability");
223# endif
224#endif
225
226#if @GNULIB_GETSUBOPT@
227/* Assuming *OPTIONP is a comma separated list of elements of the form
228 "token" or "token=value", getsubopt parses the first of these elements.
229 If the first element refers to a "token" that is member of the given
230 NULL-terminated array of tokens:
231 - It replaces the comma with a NUL byte, updates *OPTIONP to point past
232 the first option and the comma, sets *VALUEP to the value of the
233 element (or NULL if it doesn't contain an "=" sign),
234 - It returns the index of the "token" in the given array of tokens.
235 Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
236 For more details see the POSIX:2001 specification.
237 http://www.opengroup.org/susv3xsh/getsubopt.html */
238# if !@HAVE_GETSUBOPT@
239_GL_FUNCDECL_SYS (getsubopt, int,
240 (char **optionp, char *const *tokens, char **valuep)
241 _GL_ARG_NONNULL ((1, 2, 3)));
242# endif
243_GL_CXXALIAS_SYS (getsubopt, int,
244 (char **optionp, char *const *tokens, char **valuep));
245_GL_CXXALIASWARN (getsubopt);
246#elif defined GNULIB_POSIXCHECK
247# undef getsubopt
248# if HAVE_RAW_DECL_GETSUBOPT
249_GL_WARN_ON_USE (getsubopt, "getsubopt is unportable - "
250 "use gnulib module getsubopt for portability");
251# endif
252#endif
253
254#if @GNULIB_GRANTPT@
255/* Change the ownership and access permission of the slave side of the
256 pseudo-terminal whose master side is specified by FD. */
257# if !@HAVE_GRANTPT@
258_GL_FUNCDECL_SYS (grantpt, int, (int fd));
259# endif
260_GL_CXXALIAS_SYS (grantpt, int, (int fd));
261_GL_CXXALIASWARN (grantpt);
262#elif defined GNULIB_POSIXCHECK
263# undef grantpt
264# if HAVE_RAW_DECL_GRANTPT
caf8a9b2 265_GL_WARN_ON_USE (grantpt, "grantpt is not portable - "
1f5d53eb
PE
266 "use gnulib module grantpt for portability");
267# endif
268#endif
269
7ec98caf
PE
270/* If _GL_USE_STDLIB_ALLOC is nonzero, the including module does not
271 rely on GNU or POSIX semantics for malloc and realloc (for example,
272 by never specifying a zero size), so it does not need malloc or
273 realloc to be redefined. */
1f5d53eb
PE
274#if @GNULIB_MALLOC_POSIX@
275# if @REPLACE_MALLOC@
7ec98caf
PE
276# if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
277 || _GL_USE_STDLIB_ALLOC)
1f5d53eb
PE
278# undef malloc
279# define malloc rpl_malloc
280# endif
281_GL_FUNCDECL_RPL (malloc, void *, (size_t size));
282_GL_CXXALIAS_RPL (malloc, void *, (size_t size));
283# else
284_GL_CXXALIAS_SYS (malloc, void *, (size_t size));
285# endif
286_GL_CXXALIASWARN (malloc);
7ec98caf 287#elif defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
1f5d53eb
PE
288# undef malloc
289/* Assume malloc is always declared. */
290_GL_WARN_ON_USE (malloc, "malloc is not POSIX compliant everywhere - "
291 "use gnulib module malloc-posix for portability");
292#endif
293
9411886d
PE
294/* Convert a multibyte character to a wide character. */
295#if @GNULIB_MBTOWC@
296# if @REPLACE_MBTOWC@
297# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
298# undef mbtowc
299# define mbtowc rpl_mbtowc
300# endif
301_GL_FUNCDECL_RPL (mbtowc, int, (wchar_t *pwc, const char *s, size_t n));
302_GL_CXXALIAS_RPL (mbtowc, int, (wchar_t *pwc, const char *s, size_t n));
303# else
304_GL_CXXALIAS_SYS (mbtowc, int, (wchar_t *pwc, const char *s, size_t n));
305# endif
306_GL_CXXALIASWARN (mbtowc);
307#endif
308
1f5d53eb
PE
309#if @GNULIB_MKDTEMP@
310/* Create a unique temporary directory from TEMPLATE.
311 The last six characters of TEMPLATE must be "XXXXXX";
312 they are replaced with a string that makes the directory name unique.
313 Returns TEMPLATE, or a null pointer if it cannot get a unique name.
314 The directory is created mode 700. */
315# if !@HAVE_MKDTEMP@
316_GL_FUNCDECL_SYS (mkdtemp, char *, (char * /*template*/) _GL_ARG_NONNULL ((1)));
317# endif
318_GL_CXXALIAS_SYS (mkdtemp, char *, (char * /*template*/));
319_GL_CXXALIASWARN (mkdtemp);
320#elif defined GNULIB_POSIXCHECK
321# undef mkdtemp
322# if HAVE_RAW_DECL_MKDTEMP
323_GL_WARN_ON_USE (mkdtemp, "mkdtemp is unportable - "
324 "use gnulib module mkdtemp for portability");
325# endif
326#endif
327
328#if @GNULIB_MKOSTEMP@
329/* Create a unique temporary file from TEMPLATE.
330 The last six characters of TEMPLATE must be "XXXXXX";
331 they are replaced with a string that makes the file name unique.
332 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
333 and O_TEXT, O_BINARY (defined in "binary-io.h").
334 The file is then created, with the specified flags, ensuring it didn't exist
335 before.
336 The file is created read-write (mask at least 0600 & ~umask), but it may be
337 world-readable and world-writable (mask 0666 & ~umask), depending on the
338 implementation.
339 Returns the open file descriptor if successful, otherwise -1 and errno
340 set. */
341# if !@HAVE_MKOSTEMP@
342_GL_FUNCDECL_SYS (mkostemp, int, (char * /*template*/, int /*flags*/)
343 _GL_ARG_NONNULL ((1)));
344# endif
345_GL_CXXALIAS_SYS (mkostemp, int, (char * /*template*/, int /*flags*/));
346_GL_CXXALIASWARN (mkostemp);
347#elif defined GNULIB_POSIXCHECK
348# undef mkostemp
349# if HAVE_RAW_DECL_MKOSTEMP
350_GL_WARN_ON_USE (mkostemp, "mkostemp is unportable - "
351 "use gnulib module mkostemp for portability");
352# endif
353#endif
354
355#if @GNULIB_MKOSTEMPS@
356/* Create a unique temporary file from TEMPLATE.
357 The last six characters of TEMPLATE before a suffix of length
358 SUFFIXLEN must be "XXXXXX";
359 they are replaced with a string that makes the file name unique.
360 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
361 and O_TEXT, O_BINARY (defined in "binary-io.h").
362 The file is then created, with the specified flags, ensuring it didn't exist
363 before.
364 The file is created read-write (mask at least 0600 & ~umask), but it may be
365 world-readable and world-writable (mask 0666 & ~umask), depending on the
366 implementation.
367 Returns the open file descriptor if successful, otherwise -1 and errno
368 set. */
369# if !@HAVE_MKOSTEMPS@
370_GL_FUNCDECL_SYS (mkostemps, int,
371 (char * /*template*/, int /*suffixlen*/, int /*flags*/)
372 _GL_ARG_NONNULL ((1)));
373# endif
374_GL_CXXALIAS_SYS (mkostemps, int,
375 (char * /*template*/, int /*suffixlen*/, int /*flags*/));
376_GL_CXXALIASWARN (mkostemps);
377#elif defined GNULIB_POSIXCHECK
378# undef mkostemps
379# if HAVE_RAW_DECL_MKOSTEMPS
380_GL_WARN_ON_USE (mkostemps, "mkostemps is unportable - "
381 "use gnulib module mkostemps for portability");
382# endif
383#endif
384
385#if @GNULIB_MKSTEMP@
386/* Create a unique temporary file from TEMPLATE.
387 The last six characters of TEMPLATE must be "XXXXXX";
388 they are replaced with a string that makes the file name unique.
389 The file is then created, ensuring it didn't exist before.
390 The file is created read-write (mask at least 0600 & ~umask), but it may be
391 world-readable and world-writable (mask 0666 & ~umask), depending on the
392 implementation.
393 Returns the open file descriptor if successful, otherwise -1 and errno
394 set. */
395# if @REPLACE_MKSTEMP@
396# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
397# define mkstemp rpl_mkstemp
398# endif
399_GL_FUNCDECL_RPL (mkstemp, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
400_GL_CXXALIAS_RPL (mkstemp, int, (char * /*template*/));
401# else
402# if ! @HAVE_MKSTEMP@
403_GL_FUNCDECL_SYS (mkstemp, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
404# endif
405_GL_CXXALIAS_SYS (mkstemp, int, (char * /*template*/));
406# endif
407_GL_CXXALIASWARN (mkstemp);
408#elif defined GNULIB_POSIXCHECK
409# undef mkstemp
410# if HAVE_RAW_DECL_MKSTEMP
411_GL_WARN_ON_USE (mkstemp, "mkstemp is unportable - "
412 "use gnulib module mkstemp for portability");
413# endif
414#endif
415
416#if @GNULIB_MKSTEMPS@
417/* Create a unique temporary file from TEMPLATE.
418 The last six characters of TEMPLATE prior to a suffix of length
419 SUFFIXLEN must be "XXXXXX";
420 they are replaced with a string that makes the file name unique.
421 The file is then created, ensuring it didn't exist before.
422 The file is created read-write (mask at least 0600 & ~umask), but it may be
423 world-readable and world-writable (mask 0666 & ~umask), depending on the
424 implementation.
425 Returns the open file descriptor if successful, otherwise -1 and errno
426 set. */
427# if !@HAVE_MKSTEMPS@
428_GL_FUNCDECL_SYS (mkstemps, int, (char * /*template*/, int /*suffixlen*/)
429 _GL_ARG_NONNULL ((1)));
430# endif
431_GL_CXXALIAS_SYS (mkstemps, int, (char * /*template*/, int /*suffixlen*/));
432_GL_CXXALIASWARN (mkstemps);
433#elif defined GNULIB_POSIXCHECK
434# undef mkstemps
435# if HAVE_RAW_DECL_MKSTEMPS
436_GL_WARN_ON_USE (mkstemps, "mkstemps is unportable - "
437 "use gnulib module mkstemps for portability");
438# endif
439#endif
440
caf8a9b2
PE
441#if @GNULIB_POSIX_OPENPT@
442/* Return an FD open to the master side of a pseudo-terminal. Flags should
443 include O_RDWR, and may also include O_NOCTTY. */
444# if !@HAVE_POSIX_OPENPT@
445_GL_FUNCDECL_SYS (posix_openpt, int, (int flags));
446# endif
447_GL_CXXALIAS_SYS (posix_openpt, int, (int flags));
448_GL_CXXALIASWARN (posix_openpt);
449#elif defined GNULIB_POSIXCHECK
450# undef posix_openpt
451# if HAVE_RAW_DECL_POSIX_OPENPT
452_GL_WARN_ON_USE (posix_openpt, "posix_openpt is not portable - "
453 "use gnulib module posix_openpt for portability");
454# endif
455#endif
456
1f5d53eb
PE
457#if @GNULIB_PTSNAME@
458/* Return the pathname of the pseudo-terminal slave associated with
459 the master FD is open on, or NULL on errors. */
bb1dfdad 460# if @REPLACE_PTSNAME@
735135f9 461# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
bb1dfdad
PE
462# undef ptsname
463# define ptsname rpl_ptsname
464# endif
465_GL_FUNCDECL_RPL (ptsname, char *, (int fd));
466_GL_CXXALIAS_RPL (ptsname, char *, (int fd));
467# else
468# if !@HAVE_PTSNAME@
1f5d53eb 469_GL_FUNCDECL_SYS (ptsname, char *, (int fd));
bb1dfdad 470# endif
1f5d53eb 471_GL_CXXALIAS_SYS (ptsname, char *, (int fd));
bb1dfdad 472# endif
1f5d53eb
PE
473_GL_CXXALIASWARN (ptsname);
474#elif defined GNULIB_POSIXCHECK
475# undef ptsname
476# if HAVE_RAW_DECL_PTSNAME
477_GL_WARN_ON_USE (ptsname, "ptsname is not portable - "
478 "use gnulib module ptsname for portability");
479# endif
480#endif
481
caf8a9b2
PE
482#if @GNULIB_PTSNAME_R@
483/* Set the pathname of the pseudo-terminal slave associated with
484 the master FD is open on and return 0, or set errno and return
485 non-zero on errors. */
486# if @REPLACE_PTSNAME_R@
487# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
488# undef ptsname_r
489# define ptsname_r rpl_ptsname_r
490# endif
491_GL_FUNCDECL_RPL (ptsname_r, int, (int fd, char *buf, size_t len));
492_GL_CXXALIAS_RPL (ptsname_r, int, (int fd, char *buf, size_t len));
493# else
494# if !@HAVE_PTSNAME_R@
495_GL_FUNCDECL_SYS (ptsname_r, int, (int fd, char *buf, size_t len));
496# endif
497_GL_CXXALIAS_SYS (ptsname_r, int, (int fd, char *buf, size_t len));
498# endif
499_GL_CXXALIASWARN (ptsname_r);
500#elif defined GNULIB_POSIXCHECK
501# undef ptsname_r
502# if HAVE_RAW_DECL_PTSNAME_R
503_GL_WARN_ON_USE (ptsname_r, "ptsname_r is not portable - "
504 "use gnulib module ptsname_r for portability");
505# endif
506#endif
507
1f5d53eb
PE
508#if @GNULIB_PUTENV@
509# if @REPLACE_PUTENV@
510# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
511# undef putenv
512# define putenv rpl_putenv
513# endif
514_GL_FUNCDECL_RPL (putenv, int, (char *string) _GL_ARG_NONNULL ((1)));
515_GL_CXXALIAS_RPL (putenv, int, (char *string));
516# else
517_GL_CXXALIAS_SYS (putenv, int, (char *string));
518# endif
519_GL_CXXALIASWARN (putenv);
520#endif
521
522
523#if @GNULIB_RANDOM_R@
524# if !@HAVE_RANDOM_R@
525# ifndef RAND_MAX
526# define RAND_MAX 2147483647
527# endif
528# endif
529#endif
530
caf8a9b2
PE
531
532#if @GNULIB_RANDOM@
533# if !@HAVE_RANDOM@
534_GL_FUNCDECL_SYS (random, long, (void));
535# endif
536_GL_CXXALIAS_SYS (random, long, (void));
537_GL_CXXALIASWARN (random);
538#elif defined GNULIB_POSIXCHECK
539# undef random
540# if HAVE_RAW_DECL_RANDOM
541_GL_WARN_ON_USE (random, "random is unportable - "
542 "use gnulib module random for portability");
543# endif
544#endif
545
546#if @GNULIB_RANDOM@
547# if !@HAVE_RANDOM@
548_GL_FUNCDECL_SYS (srandom, void, (unsigned int seed));
549# endif
550_GL_CXXALIAS_SYS (srandom, void, (unsigned int seed));
551_GL_CXXALIASWARN (srandom);
552#elif defined GNULIB_POSIXCHECK
553# undef srandom
554# if HAVE_RAW_DECL_SRANDOM
555_GL_WARN_ON_USE (srandom, "srandom is unportable - "
556 "use gnulib module random for portability");
557# endif
558#endif
559
560#if @GNULIB_RANDOM@
561# if !@HAVE_RANDOM@
562_GL_FUNCDECL_SYS (initstate, char *,
563 (unsigned int seed, char *buf, size_t buf_size)
564 _GL_ARG_NONNULL ((2)));
565# endif
566_GL_CXXALIAS_SYS (initstate, char *,
567 (unsigned int seed, char *buf, size_t buf_size));
568_GL_CXXALIASWARN (initstate);
569#elif defined GNULIB_POSIXCHECK
570# undef initstate
571# if HAVE_RAW_DECL_INITSTATE_R
572_GL_WARN_ON_USE (initstate, "initstate is unportable - "
573 "use gnulib module random for portability");
574# endif
575#endif
576
577#if @GNULIB_RANDOM@
578# if !@HAVE_RANDOM@
579_GL_FUNCDECL_SYS (setstate, char *, (char *arg_state) _GL_ARG_NONNULL ((1)));
580# endif
581_GL_CXXALIAS_SYS (setstate, char *, (char *arg_state));
582_GL_CXXALIASWARN (setstate);
583#elif defined GNULIB_POSIXCHECK
584# undef setstate
585# if HAVE_RAW_DECL_SETSTATE_R
586_GL_WARN_ON_USE (setstate, "setstate is unportable - "
587 "use gnulib module random for portability");
588# endif
589#endif
590
591
1f5d53eb 592#if @GNULIB_RANDOM_R@
caf8a9b2
PE
593# if @REPLACE_RANDOM_R@
594# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
595# undef random_r
596# define random_r rpl_random_r
597# endif
598_GL_FUNCDECL_RPL (random_r, int, (struct random_data *buf, int32_t *result)
599 _GL_ARG_NONNULL ((1, 2)));
600_GL_CXXALIAS_RPL (random_r, int, (struct random_data *buf, int32_t *result));
601# else
602# if !@HAVE_RANDOM_R@
1f5d53eb
PE
603_GL_FUNCDECL_SYS (random_r, int, (struct random_data *buf, int32_t *result)
604 _GL_ARG_NONNULL ((1, 2)));
caf8a9b2 605# endif
1f5d53eb 606_GL_CXXALIAS_SYS (random_r, int, (struct random_data *buf, int32_t *result));
caf8a9b2 607# endif
1f5d53eb
PE
608_GL_CXXALIASWARN (random_r);
609#elif defined GNULIB_POSIXCHECK
610# undef random_r
611# if HAVE_RAW_DECL_RANDOM_R
612_GL_WARN_ON_USE (random_r, "random_r is unportable - "
613 "use gnulib module random_r for portability");
614# endif
615#endif
616
617#if @GNULIB_RANDOM_R@
caf8a9b2
PE
618# if @REPLACE_RANDOM_R@
619# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
620# undef srandom_r
621# define srandom_r rpl_srandom_r
622# endif
623_GL_FUNCDECL_RPL (srandom_r, int,
624 (unsigned int seed, struct random_data *rand_state)
625 _GL_ARG_NONNULL ((2)));
626_GL_CXXALIAS_RPL (srandom_r, int,
627 (unsigned int seed, struct random_data *rand_state));
628# else
629# if !@HAVE_RANDOM_R@
1f5d53eb
PE
630_GL_FUNCDECL_SYS (srandom_r, int,
631 (unsigned int seed, struct random_data *rand_state)
632 _GL_ARG_NONNULL ((2)));
caf8a9b2 633# endif
1f5d53eb
PE
634_GL_CXXALIAS_SYS (srandom_r, int,
635 (unsigned int seed, struct random_data *rand_state));
caf8a9b2 636# endif
1f5d53eb
PE
637_GL_CXXALIASWARN (srandom_r);
638#elif defined GNULIB_POSIXCHECK
639# undef srandom_r
640# if HAVE_RAW_DECL_SRANDOM_R
641_GL_WARN_ON_USE (srandom_r, "srandom_r is unportable - "
642 "use gnulib module random_r for portability");
643# endif
644#endif
645
646#if @GNULIB_RANDOM_R@
caf8a9b2
PE
647# if @REPLACE_RANDOM_R@
648# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
649# undef initstate_r
650# define initstate_r rpl_initstate_r
651# endif
652_GL_FUNCDECL_RPL (initstate_r, int,
653 (unsigned int seed, char *buf, size_t buf_size,
654 struct random_data *rand_state)
655 _GL_ARG_NONNULL ((2, 4)));
656_GL_CXXALIAS_RPL (initstate_r, int,
657 (unsigned int seed, char *buf, size_t buf_size,
658 struct random_data *rand_state));
659# else
660# if !@HAVE_RANDOM_R@
1f5d53eb
PE
661_GL_FUNCDECL_SYS (initstate_r, int,
662 (unsigned int seed, char *buf, size_t buf_size,
663 struct random_data *rand_state)
664 _GL_ARG_NONNULL ((2, 4)));
caf8a9b2 665# endif
1f5d53eb
PE
666_GL_CXXALIAS_SYS (initstate_r, int,
667 (unsigned int seed, char *buf, size_t buf_size,
668 struct random_data *rand_state));
caf8a9b2 669# endif
1f5d53eb
PE
670_GL_CXXALIASWARN (initstate_r);
671#elif defined GNULIB_POSIXCHECK
672# undef initstate_r
673# if HAVE_RAW_DECL_INITSTATE_R
674_GL_WARN_ON_USE (initstate_r, "initstate_r is unportable - "
675 "use gnulib module random_r for portability");
676# endif
677#endif
678
679#if @GNULIB_RANDOM_R@
caf8a9b2
PE
680# if @REPLACE_RANDOM_R@
681# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
682# undef setstate_r
683# define setstate_r rpl_setstate_r
684# endif
685_GL_FUNCDECL_RPL (setstate_r, int,
686 (char *arg_state, struct random_data *rand_state)
687 _GL_ARG_NONNULL ((1, 2)));
688_GL_CXXALIAS_RPL (setstate_r, int,
689 (char *arg_state, struct random_data *rand_state));
690# else
691# if !@HAVE_RANDOM_R@
1f5d53eb
PE
692_GL_FUNCDECL_SYS (setstate_r, int,
693 (char *arg_state, struct random_data *rand_state)
694 _GL_ARG_NONNULL ((1, 2)));
caf8a9b2 695# endif
1f5d53eb
PE
696_GL_CXXALIAS_SYS (setstate_r, int,
697 (char *arg_state, struct random_data *rand_state));
caf8a9b2 698# endif
1f5d53eb
PE
699_GL_CXXALIASWARN (setstate_r);
700#elif defined GNULIB_POSIXCHECK
701# undef setstate_r
702# if HAVE_RAW_DECL_SETSTATE_R
703_GL_WARN_ON_USE (setstate_r, "setstate_r is unportable - "
704 "use gnulib module random_r for portability");
705# endif
706#endif
707
708
709#if @GNULIB_REALLOC_POSIX@
710# if @REPLACE_REALLOC@
7ec98caf
PE
711# if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
712 || _GL_USE_STDLIB_ALLOC)
1f5d53eb
PE
713# undef realloc
714# define realloc rpl_realloc
715# endif
716_GL_FUNCDECL_RPL (realloc, void *, (void *ptr, size_t size));
717_GL_CXXALIAS_RPL (realloc, void *, (void *ptr, size_t size));
718# else
719_GL_CXXALIAS_SYS (realloc, void *, (void *ptr, size_t size));
720# endif
721_GL_CXXALIASWARN (realloc);
7ec98caf 722#elif defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
1f5d53eb
PE
723# undef realloc
724/* Assume realloc is always declared. */
725_GL_WARN_ON_USE (realloc, "realloc is not POSIX compliant everywhere - "
726 "use gnulib module realloc-posix for portability");
727#endif
728
729#if @GNULIB_REALPATH@
730# if @REPLACE_REALPATH@
731# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
732# define realpath rpl_realpath
733# endif
734_GL_FUNCDECL_RPL (realpath, char *, (const char *name, char *resolved)
735 _GL_ARG_NONNULL ((1)));
736_GL_CXXALIAS_RPL (realpath, char *, (const char *name, char *resolved));
737# else
738# if !@HAVE_REALPATH@
739_GL_FUNCDECL_SYS (realpath, char *, (const char *name, char *resolved)
740 _GL_ARG_NONNULL ((1)));
741# endif
742_GL_CXXALIAS_SYS (realpath, char *, (const char *name, char *resolved));
743# endif
744_GL_CXXALIASWARN (realpath);
745#elif defined GNULIB_POSIXCHECK
746# undef realpath
747# if HAVE_RAW_DECL_REALPATH
748_GL_WARN_ON_USE (realpath, "realpath is unportable - use gnulib module "
749 "canonicalize or canonicalize-lgpl for portability");
750# endif
751#endif
752
753#if @GNULIB_RPMATCH@
754/* Test a user response to a question.
755 Return 1 if it is affirmative, 0 if it is negative, or -1 if not clear. */
756# if !@HAVE_RPMATCH@
757_GL_FUNCDECL_SYS (rpmatch, int, (const char *response) _GL_ARG_NONNULL ((1)));
758# endif
759_GL_CXXALIAS_SYS (rpmatch, int, (const char *response));
760_GL_CXXALIASWARN (rpmatch);
761#elif defined GNULIB_POSIXCHECK
762# undef rpmatch
763# if HAVE_RAW_DECL_RPMATCH
764_GL_WARN_ON_USE (rpmatch, "rpmatch is unportable - "
765 "use gnulib module rpmatch for portability");
766# endif
767#endif
768
769#if @GNULIB_SETENV@
770/* Set NAME to VALUE in the environment.
771 If REPLACE is nonzero, overwrite an existing value. */
772# if @REPLACE_SETENV@
773# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
774# undef setenv
775# define setenv rpl_setenv
776# endif
777_GL_FUNCDECL_RPL (setenv, int,
778 (const char *name, const char *value, int replace)
779 _GL_ARG_NONNULL ((1)));
780_GL_CXXALIAS_RPL (setenv, int,
781 (const char *name, const char *value, int replace));
782# else
783# if !@HAVE_DECL_SETENV@
784_GL_FUNCDECL_SYS (setenv, int,
785 (const char *name, const char *value, int replace)
786 _GL_ARG_NONNULL ((1)));
787# endif
788_GL_CXXALIAS_SYS (setenv, int,
789 (const char *name, const char *value, int replace));
790# endif
791# if !(@REPLACE_SETENV@ && !@HAVE_DECL_SETENV@)
792_GL_CXXALIASWARN (setenv);
793# endif
794#elif defined GNULIB_POSIXCHECK
795# undef setenv
796# if HAVE_RAW_DECL_SETENV
797_GL_WARN_ON_USE (setenv, "setenv is unportable - "
798 "use gnulib module setenv for portability");
799# endif
800#endif
801
802#if @GNULIB_STRTOD@
803 /* Parse a double from STRING, updating ENDP if appropriate. */
804# if @REPLACE_STRTOD@
805# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
806# define strtod rpl_strtod
807# endif
808_GL_FUNCDECL_RPL (strtod, double, (const char *str, char **endp)
809 _GL_ARG_NONNULL ((1)));
810_GL_CXXALIAS_RPL (strtod, double, (const char *str, char **endp));
811# else
812# if !@HAVE_STRTOD@
813_GL_FUNCDECL_SYS (strtod, double, (const char *str, char **endp)
814 _GL_ARG_NONNULL ((1)));
815# endif
816_GL_CXXALIAS_SYS (strtod, double, (const char *str, char **endp));
817# endif
818_GL_CXXALIASWARN (strtod);
819#elif defined GNULIB_POSIXCHECK
820# undef strtod
821# if HAVE_RAW_DECL_STRTOD
822_GL_WARN_ON_USE (strtod, "strtod is unportable - "
823 "use gnulib module strtod for portability");
824# endif
825#endif
826
827#if @GNULIB_STRTOLL@
828/* Parse a signed integer whose textual representation starts at STRING.
829 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
830 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
831 "0x").
832 If ENDPTR is not NULL, the address of the first byte after the integer is
833 stored in *ENDPTR.
834 Upon overflow, the return value is LLONG_MAX or LLONG_MIN, and errno is set
835 to ERANGE. */
836# if !@HAVE_STRTOLL@
837_GL_FUNCDECL_SYS (strtoll, long long,
838 (const char *string, char **endptr, int base)
839 _GL_ARG_NONNULL ((1)));
840# endif
841_GL_CXXALIAS_SYS (strtoll, long long,
842 (const char *string, char **endptr, int base));
843_GL_CXXALIASWARN (strtoll);
844#elif defined GNULIB_POSIXCHECK
845# undef strtoll
846# if HAVE_RAW_DECL_STRTOLL
847_GL_WARN_ON_USE (strtoll, "strtoll is unportable - "
848 "use gnulib module strtoll for portability");
849# endif
850#endif
851
852#if @GNULIB_STRTOULL@
853/* Parse an unsigned integer whose textual representation starts at STRING.
854 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
855 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
856 "0x").
857 If ENDPTR is not NULL, the address of the first byte after the integer is
858 stored in *ENDPTR.
859 Upon overflow, the return value is ULLONG_MAX, and errno is set to
860 ERANGE. */
861# if !@HAVE_STRTOULL@
862_GL_FUNCDECL_SYS (strtoull, unsigned long long,
863 (const char *string, char **endptr, int base)
864 _GL_ARG_NONNULL ((1)));
865# endif
866_GL_CXXALIAS_SYS (strtoull, unsigned long long,
867 (const char *string, char **endptr, int base));
868_GL_CXXALIASWARN (strtoull);
869#elif defined GNULIB_POSIXCHECK
870# undef strtoull
871# if HAVE_RAW_DECL_STRTOULL
872_GL_WARN_ON_USE (strtoull, "strtoull is unportable - "
873 "use gnulib module strtoull for portability");
874# endif
875#endif
876
877#if @GNULIB_UNLOCKPT@
878/* Unlock the slave side of the pseudo-terminal whose master side is specified
879 by FD, so that it can be opened. */
880# if !@HAVE_UNLOCKPT@
881_GL_FUNCDECL_SYS (unlockpt, int, (int fd));
882# endif
883_GL_CXXALIAS_SYS (unlockpt, int, (int fd));
884_GL_CXXALIASWARN (unlockpt);
885#elif defined GNULIB_POSIXCHECK
886# undef unlockpt
887# if HAVE_RAW_DECL_UNLOCKPT
888_GL_WARN_ON_USE (unlockpt, "unlockpt is not portable - "
889 "use gnulib module unlockpt for portability");
890# endif
891#endif
892
893#if @GNULIB_UNSETENV@
894/* Remove the variable NAME from the environment. */
895# if @REPLACE_UNSETENV@
896# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
897# undef unsetenv
898# define unsetenv rpl_unsetenv
899# endif
900_GL_FUNCDECL_RPL (unsetenv, int, (const char *name) _GL_ARG_NONNULL ((1)));
901_GL_CXXALIAS_RPL (unsetenv, int, (const char *name));
902# else
903# if !@HAVE_DECL_UNSETENV@
904_GL_FUNCDECL_SYS (unsetenv, int, (const char *name) _GL_ARG_NONNULL ((1)));
905# endif
906_GL_CXXALIAS_SYS (unsetenv, int, (const char *name));
907# endif
908# if !(@REPLACE_UNSETENV@ && !@HAVE_DECL_UNSETENV@)
909_GL_CXXALIASWARN (unsetenv);
910# endif
911#elif defined GNULIB_POSIXCHECK
912# undef unsetenv
913# if HAVE_RAW_DECL_UNSETENV
914_GL_WARN_ON_USE (unsetenv, "unsetenv is unportable - "
915 "use gnulib module unsetenv for portability");
916# endif
917#endif
918
9411886d
PE
919/* Convert a wide character to a multibyte character. */
920#if @GNULIB_WCTOMB@
921# if @REPLACE_WCTOMB@
922# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
923# undef wctomb
924# define wctomb rpl_wctomb
925# endif
926_GL_FUNCDECL_RPL (wctomb, int, (char *s, wchar_t wc));
927_GL_CXXALIAS_RPL (wctomb, int, (char *s, wchar_t wc));
928# else
929_GL_CXXALIAS_SYS (wctomb, int, (char *s, wchar_t wc));
930# endif
931_GL_CXXALIASWARN (wctomb);
932#endif
933
1f5d53eb 934
6a3e57bb
PE
935#endif /* _@GUARD_PREFIX@_STDLIB_H */
936#endif /* _@GUARD_PREFIX@_STDLIB_H */
1f5d53eb 937#endif