lib/stdlib.in.h

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