lib/stdlib.in.h

   1 /* A GNU-like <stdlib.h>.
   2
   3    Copyright (C) 1995, 2001-2004, 2006-2013 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_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
  31 #ifndef _@GUARD_PREFIX@_STDLIB_H
  32
  33 /* The include_next requires a split double-inclusion guard.  */
  34 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
  35
  36 #ifndef _@GUARD_PREFIX@_STDLIB_H
  37 #define _@GUARD_PREFIX@_STDLIB_H
  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
  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
  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
  66 # if !@HAVE_STRUCT_RANDOM_DATA@ || @REPLACE_RANDOM_R@ || !@HAVE_RANDOM_R@
  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
  74 struct 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
  89 #if (@GNULIB_MKSTEMP@ || @GNULIB_MKSTEMPS@ || @GNULIB_GETSUBOPT@ || defined GNULIB_POSIXCHECK) && ! defined __GLIBC__ && !((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__)
  90 /* On Mac OS X 10.3, only <unistd.h> declares mkstemp.  */
  91 /* On Mac OS X 10.5, only <unistd.h> declares mkstemps.  */
  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
  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
 105 /* The definition of _Noreturn is copied here.  */
 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@
 132 _GL_FUNCDECL_SYS (_Exit, _Noreturn void, (int status));
 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@
 149 _GL_FUNCDECL_SYS (atoll, long long, (const char *string)
 150                                     _GL_ATTRIBUTE_PURE
 151                                     _GL_ARG_NONNULL ((1)));
 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
 265 _GL_WARN_ON_USE (grantpt, "grantpt is not portable - "
 266                  "use gnulib module grantpt for portability");
 267 # endif
 268 #endif
 269
 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.  */
 274 #if @GNULIB_MALLOC_POSIX@
 275 # if @REPLACE_MALLOC@
 276 #  if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
 277         || _GL_USE_STDLIB_ALLOC)
 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);
 287 #elif defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
 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
 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
 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
 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
 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.  */
 460 # if @REPLACE_PTSNAME@
 461 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 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@
 469 _GL_FUNCDECL_SYS (ptsname, char *, (int fd));
 470 #  endif
 471 _GL_CXXALIAS_SYS (ptsname, char *, (int fd));
 472 # endif
 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
 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
 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
 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
 592 #if @GNULIB_RANDOM_R@
 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@
 603 _GL_FUNCDECL_SYS (random_r, int, (struct random_data *buf, int32_t *result)
 604                                  _GL_ARG_NONNULL ((1, 2)));
 605 #  endif
 606 _GL_CXXALIAS_SYS (random_r, int, (struct random_data *buf, int32_t *result));
 607 # endif
 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@
 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@
 630 _GL_FUNCDECL_SYS (srandom_r, int,
 631                   (unsigned int seed, struct random_data *rand_state)
 632                   _GL_ARG_NONNULL ((2)));
 633 #  endif
 634 _GL_CXXALIAS_SYS (srandom_r, int,
 635                   (unsigned int seed, struct random_data *rand_state));
 636 # endif
 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@
 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@
 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)));
 665 #  endif
 666 _GL_CXXALIAS_SYS (initstate_r, int,
 667                   (unsigned int seed, char *buf, size_t buf_size,
 668                    struct random_data *rand_state));
 669 # endif
 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@
 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@
 692 _GL_FUNCDECL_SYS (setstate_r, int,
 693                   (char *arg_state, struct random_data *rand_state)
 694                   _GL_ARG_NONNULL ((1, 2)));
 695 #  endif
 696 _GL_CXXALIAS_SYS (setstate_r, int,
 697                   (char *arg_state, struct random_data *rand_state));
 698 # endif
 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@
 711 #  if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
 712         || _GL_USE_STDLIB_ALLOC)
 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);
 722 #elif defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
 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
 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
 934
 935 #endif /* _@GUARD_PREFIX@_STDLIB_H */
 936 #endif /* _@GUARD_PREFIX@_STDLIB_H */
 937 #endif