lib/stdlib.in.h

   1 /* A GNU-like <stdlib.h>.
   2
   3    Copyright (C) 1995, 2001-2004, 2006-2010 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 Lesser 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 Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser 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 _GL_STDLIB_H
  32
  33 /* The include_next requires a split double-inclusion guard.  */
  34 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
  35
  36 #ifndef _GL_STDLIB_H
  37 #define _GL_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 /* OSF/1 5.1 declares 'struct random_data' in <random.h>, which is included
  53    from <stdlib.h> if _REENTRANT is defined.  Include it always.  */
  54 #if @HAVE_RANDOM_H@
  55 # include <random.h>
  56 #endif
  57
  58 #if !@HAVE_STRUCT_RANDOM_DATA@ || (@GNULIB_RANDOM_R@ && !@HAVE_RANDOM_R@) \
  59     || defined GNULIB_POSIXCHECK
  60 # include <stdint.h>
  61 #endif
  62
  63 #if !@HAVE_STRUCT_RANDOM_DATA@
  64 /* Define 'struct random_data'.
  65    But allow multiple gnulib generated <stdlib.h> replacements to coexist.  */
  66 # if !GNULIB_defined_struct_random_data
  67 struct random_data
  68 {
  69   int32_t *fptr;                /* Front pointer.  */
  70   int32_t *rptr;                /* Rear pointer.  */
  71   int32_t *state;               /* Array of state values.  */
  72   int rand_type;                /* Type of random number generator.  */
  73   int rand_deg;                 /* Degree of random number generator.  */
  74   int rand_sep;                 /* Distance between front and rear.  */
  75   int32_t *end_ptr;             /* Pointer behind state table.  */
  76 };
  77 #  define GNULIB_defined_struct_random_data 1
  78 # endif
  79 #endif
  80
  81 #if (@GNULIB_MKSTEMP@ || @GNULIB_GETSUBOPT@ || defined GNULIB_POSIXCHECK) && ! defined __GLIBC__ && !((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__)
  82 /* On MacOS X 10.3, only <unistd.h> declares mkstemp.  */
  83 /* On Cygwin 1.7.1, only <unistd.h> declares getsubopt.  */
  84 /* But avoid namespace pollution on glibc systems and native Windows.  */
  85 # include <unistd.h>
  86 #endif
  87
  88 #ifndef __attribute__
  89 # if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 8)
  90 #  define __attribute__(Spec)   /* empty */
  91 # endif
  92 #endif
  93
  94 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
  95
  96 /* The definition of _GL_ARG_NONNULL is copied here.  */
  97
  98 /* The definition of _GL_WARN_ON_USE is copied here.  */
  99
 100
 101 /* Some systems do not define EXIT_*, despite otherwise supporting C89.  */
 102 #ifndef EXIT_SUCCESS
 103 # define EXIT_SUCCESS 0
 104 #endif
 105 /* Tandem/NSK and other platforms that define EXIT_FAILURE as -1 interfere
 106    with proper operation of xargs.  */
 107 #ifndef EXIT_FAILURE
 108 # define EXIT_FAILURE 1
 109 #elif EXIT_FAILURE != 1
 110 # undef EXIT_FAILURE
 111 # define EXIT_FAILURE 1
 112 #endif
 113
 114
 115 #if @GNULIB__EXIT@
 116 /* Terminate the current process with the given return code, without running
 117    the 'atexit' handlers.  */
 118 # if !@HAVE__EXIT@
 119 _GL_FUNCDECL_SYS (_Exit, void, (int status) __attribute__ ((__noreturn__)));
 120 # endif
 121 _GL_CXXALIAS_SYS (_Exit, void, (int status));
 122 _GL_CXXALIASWARN (_Exit);
 123 #elif defined GNULIB_POSIXCHECK
 124 # undef _Exit
 125 # if HAVE_RAW_DECL__EXIT
 126 _GL_WARN_ON_USE (_Exit, "_Exit is unportable - "
 127                  "use gnulib module _Exit for portability");
 128 # endif
 129 #endif
 130
 131
 132 #if @GNULIB_ATOLL@
 133 /* Parse a signed decimal integer.
 134    Returns the value of the integer.  Errors are not detected.  */
 135 # if !@HAVE_ATOLL@
 136 _GL_FUNCDECL_SYS (atoll, long long, (const char *string) _GL_ARG_NONNULL ((1)));
 137 # endif
 138 _GL_CXXALIAS_SYS (atoll, long long, (const char *string));
 139 _GL_CXXALIASWARN (atoll);
 140 #elif defined GNULIB_POSIXCHECK
 141 # undef atoll
 142 # if HAVE_RAW_DECL_ATOLL
 143 _GL_WARN_ON_USE (atoll, "atoll is unportable - "
 144                  "use gnulib module atoll for portability");
 145 # endif
 146 #endif
 147
 148 #if @GNULIB_CALLOC_POSIX@
 149 # if @REPLACE_CALLOC@
 150 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 151 #   undef calloc
 152 #   define calloc rpl_calloc
 153 #  endif
 154 _GL_FUNCDECL_RPL (calloc, void *, (size_t nmemb, size_t size));
 155 _GL_CXXALIAS_RPL (calloc, void *, (size_t nmemb, size_t size));
 156 # else
 157 _GL_CXXALIAS_SYS (calloc, void *, (size_t nmemb, size_t size));
 158 # endif
 159 _GL_CXXALIASWARN (calloc);
 160 #elif defined GNULIB_POSIXCHECK
 161 # undef calloc
 162 /* Assume calloc is always declared.  */
 163 _GL_WARN_ON_USE (calloc, "calloc is not POSIX compliant everywhere - "
 164                  "use gnulib module calloc-posix for portability");
 165 #endif
 166
 167 #if @GNULIB_CANONICALIZE_FILE_NAME@
 168 # if @REPLACE_CANONICALIZE_FILE_NAME@
 169 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 170 #   define canonicalize_file_name rpl_canonicalize_file_name
 171 #  endif
 172 _GL_FUNCDECL_RPL (canonicalize_file_name, char *, (const char *name)
 173                                                   _GL_ARG_NONNULL ((1)));
 174 _GL_CXXALIAS_RPL (canonicalize_file_name, char *, (const char *name));
 175 # else
 176 #  if !@HAVE_CANONICALIZE_FILE_NAME@
 177 _GL_FUNCDECL_SYS (canonicalize_file_name, char *, (const char *name)
 178                                                   _GL_ARG_NONNULL ((1)));
 179 #  endif
 180 _GL_CXXALIAS_SYS (canonicalize_file_name, char *, (const char *name));
 181 # endif
 182 _GL_CXXALIASWARN (canonicalize_file_name);
 183 #elif defined GNULIB_POSIXCHECK
 184 # undef canonicalize_file_name
 185 # if HAVE_RAW_DECL_CANONICALIZE_FILE_NAME
 186 _GL_WARN_ON_USE (canonicalize_file_name,
 187                  "canonicalize_file_name is unportable - "
 188                  "use gnulib module canonicalize-lgpl for portability");
 189 # endif
 190 #endif
 191
 192 #if @GNULIB_GETLOADAVG@
 193 /* Store max(NELEM,3) load average numbers in LOADAVG[].
 194    The three numbers are the load average of the last 1 minute, the last 5
 195    minutes, and the last 15 minutes, respectively.
 196    LOADAVG is an array of NELEM numbers.  */
 197 # if !@HAVE_DECL_GETLOADAVG@
 198 _GL_FUNCDECL_SYS (getloadavg, int, (double loadavg[], int nelem)
 199                                    _GL_ARG_NONNULL ((1)));
 200 # endif
 201 _GL_CXXALIAS_SYS (getloadavg, int, (double loadavg[], int nelem));
 202 _GL_CXXALIASWARN (getloadavg);
 203 #elif defined GNULIB_POSIXCHECK
 204 # undef getloadavg
 205 # if HAVE_RAW_DECL_GETLOADAVG
 206 _GL_WARN_ON_USE (getloadavg, "getloadavg is not portable - "
 207                  "use gnulib module getloadavg for portability");
 208 # endif
 209 #endif
 210
 211 #if @GNULIB_GETSUBOPT@
 212 /* Assuming *OPTIONP is a comma separated list of elements of the form
 213    "token" or "token=value", getsubopt parses the first of these elements.
 214    If the first element refers to a "token" that is member of the given
 215    NULL-terminated array of tokens:
 216      - It replaces the comma with a NUL byte, updates *OPTIONP to point past
 217        the first option and the comma, sets *VALUEP to the value of the
 218        element (or NULL if it doesn't contain an "=" sign),
 219      - It returns the index of the "token" in the given array of tokens.
 220    Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
 221    For more details see the POSIX:2001 specification.
 222    http://www.opengroup.org/susv3xsh/getsubopt.html */
 223 # if !@HAVE_GETSUBOPT@
 224 _GL_FUNCDECL_SYS (getsubopt, int,
 225                   (char **optionp, char *const *tokens, char **valuep)
 226                   _GL_ARG_NONNULL ((1, 2, 3)));
 227 # endif
 228 _GL_CXXALIAS_SYS (getsubopt, int,
 229                   (char **optionp, char *const *tokens, char **valuep));
 230 _GL_CXXALIASWARN (getsubopt);
 231 #elif defined GNULIB_POSIXCHECK
 232 # undef getsubopt
 233 # if HAVE_RAW_DECL_GETSUBOPT
 234 _GL_WARN_ON_USE (getsubopt, "getsubopt is unportable - "
 235                  "use gnulib module getsubopt for portability");
 236 # endif
 237 #endif
 238
 239 #if @GNULIB_GRANTPT@
 240 /* Change the ownership and access permission of the slave side of the
 241    pseudo-terminal whose master side is specified by FD.  */
 242 # if !@HAVE_GRANTPT@
 243 _GL_FUNCDECL_SYS (grantpt, int, (int fd));
 244 # endif
 245 _GL_CXXALIAS_SYS (grantpt, int, (int fd));
 246 _GL_CXXALIASWARN (grantpt);
 247 #elif defined GNULIB_POSIXCHECK
 248 # undef grantpt
 249 # if HAVE_RAW_DECL_GRANTPT
 250 _GL_WARN_ON_USE (ptsname, "grantpt is not portable - "
 251                  "use gnulib module grantpt for portability");
 252 # endif
 253 #endif
 254
 255 #if @GNULIB_MALLOC_POSIX@
 256 # if @REPLACE_MALLOC@
 257 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 258 #   undef malloc
 259 #   define malloc rpl_malloc
 260 #  endif
 261 _GL_FUNCDECL_RPL (malloc, void *, (size_t size));
 262 _GL_CXXALIAS_RPL (malloc, void *, (size_t size));
 263 # else
 264 _GL_CXXALIAS_SYS (malloc, void *, (size_t size));
 265 # endif
 266 _GL_CXXALIASWARN (malloc);
 267 #elif defined GNULIB_POSIXCHECK
 268 # undef malloc
 269 /* Assume malloc is always declared.  */
 270 _GL_WARN_ON_USE (malloc, "malloc is not POSIX compliant everywhere - "
 271                  "use gnulib module malloc-posix for portability");
 272 #endif
 273
 274 #if @GNULIB_MKDTEMP@
 275 /* Create a unique temporary directory from TEMPLATE.
 276    The last six characters of TEMPLATE must be "XXXXXX";
 277    they are replaced with a string that makes the directory name unique.
 278    Returns TEMPLATE, or a null pointer if it cannot get a unique name.
 279    The directory is created mode 700.  */
 280 # if !@HAVE_MKDTEMP@
 281 _GL_FUNCDECL_SYS (mkdtemp, char *, (char * /*template*/) _GL_ARG_NONNULL ((1)));
 282 # endif
 283 _GL_CXXALIAS_SYS (mkdtemp, char *, (char * /*template*/));
 284 _GL_CXXALIASWARN (mkdtemp);
 285 #elif defined GNULIB_POSIXCHECK
 286 # undef mkdtemp
 287 # if HAVE_RAW_DECL_MKDTEMP
 288 _GL_WARN_ON_USE (mkdtemp, "mkdtemp is unportable - "
 289                  "use gnulib module mkdtemp for portability");
 290 # endif
 291 #endif
 292
 293 #if @GNULIB_MKOSTEMP@
 294 /* Create a unique temporary file from TEMPLATE.
 295    The last six characters of TEMPLATE must be "XXXXXX";
 296    they are replaced with a string that makes the file name unique.
 297    The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
 298    and O_TEXT, O_BINARY (defined in "binary-io.h").
 299    The file is then created, with the specified flags, ensuring it didn't exist
 300    before.
 301    The file is created read-write (mask at least 0600 & ~umask), but it may be
 302    world-readable and world-writable (mask 0666 & ~umask), depending on the
 303    implementation.
 304    Returns the open file descriptor if successful, otherwise -1 and errno
 305    set.  */
 306 # if !@HAVE_MKOSTEMP@
 307 _GL_FUNCDECL_SYS (mkostemp, int, (char * /*template*/, int /*flags*/)
 308                                  _GL_ARG_NONNULL ((1)));
 309 # endif
 310 _GL_CXXALIAS_SYS (mkostemp, int, (char * /*template*/, int /*flags*/));
 311 _GL_CXXALIASWARN (mkostemp);
 312 #elif defined GNULIB_POSIXCHECK
 313 # undef mkostemp
 314 # if HAVE_RAW_DECL_MKOSTEMP
 315 _GL_WARN_ON_USE (mkostemp, "mkostemp is unportable - "
 316                  "use gnulib module mkostemp for portability");
 317 # endif
 318 #endif
 319
 320 #if @GNULIB_MKOSTEMPS@
 321 /* Create a unique temporary file from TEMPLATE.
 322    The last six characters of TEMPLATE before a suffix of length
 323    SUFFIXLEN must be "XXXXXX";
 324    they are replaced with a string that makes the file name unique.
 325    The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
 326    and O_TEXT, O_BINARY (defined in "binary-io.h").
 327    The file is then created, with the specified flags, ensuring it didn't exist
 328    before.
 329    The file is created read-write (mask at least 0600 & ~umask), but it may be
 330    world-readable and world-writable (mask 0666 & ~umask), depending on the
 331    implementation.
 332    Returns the open file descriptor if successful, otherwise -1 and errno
 333    set.  */
 334 # if !@HAVE_MKOSTEMPS@
 335 _GL_FUNCDECL_SYS (mkostemps, int,
 336                   (char * /*template*/, int /*suffixlen*/, int /*flags*/)
 337                   _GL_ARG_NONNULL ((1)));
 338 # endif
 339 _GL_CXXALIAS_SYS (mkostemps, int,
 340                   (char * /*template*/, int /*suffixlen*/, int /*flags*/));
 341 _GL_CXXALIASWARN (mkostemps);
 342 #elif defined GNULIB_POSIXCHECK
 343 # undef mkostemps
 344 # if HAVE_RAW_DECL_MKOSTEMPS
 345 _GL_WARN_ON_USE (mkostemps, "mkostemps is unportable - "
 346                  "use gnulib module mkostemps for portability");
 347 # endif
 348 #endif
 349
 350 #if @GNULIB_MKSTEMP@
 351 /* Create a unique temporary file from TEMPLATE.
 352    The last six characters of TEMPLATE must be "XXXXXX";
 353    they are replaced with a string that makes the file name unique.
 354    The file is then created, ensuring it didn't exist before.
 355    The file is created read-write (mask at least 0600 & ~umask), but it may be
 356    world-readable and world-writable (mask 0666 & ~umask), depending on the
 357    implementation.
 358    Returns the open file descriptor if successful, otherwise -1 and errno
 359    set.  */
 360 # if @REPLACE_MKSTEMP@
 361 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 362 #   define mkstemp rpl_mkstemp
 363 #  endif
 364 _GL_FUNCDECL_RPL (mkstemp, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
 365 _GL_CXXALIAS_RPL (mkstemp, int, (char * /*template*/));
 366 # else
 367 #  if ! @HAVE_MKSTEMP@
 368 _GL_FUNCDECL_SYS (mkstemp, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
 369 #  endif
 370 _GL_CXXALIAS_SYS (mkstemp, int, (char * /*template*/));
 371 # endif
 372 _GL_CXXALIASWARN (mkstemp);
 373 #elif defined GNULIB_POSIXCHECK
 374 # undef mkstemp
 375 # if HAVE_RAW_DECL_MKSTEMP
 376 _GL_WARN_ON_USE (mkstemp, "mkstemp is unportable - "
 377                  "use gnulib module mkstemp for portability");
 378 # endif
 379 #endif
 380
 381 #if @GNULIB_MKSTEMPS@
 382 /* Create a unique temporary file from TEMPLATE.
 383    The last six characters of TEMPLATE prior to a suffix of length
 384    SUFFIXLEN must be "XXXXXX";
 385    they are replaced with a string that makes the file name unique.
 386    The file is then created, ensuring it didn't exist before.
 387    The file is created read-write (mask at least 0600 & ~umask), but it may be
 388    world-readable and world-writable (mask 0666 & ~umask), depending on the
 389    implementation.
 390    Returns the open file descriptor if successful, otherwise -1 and errno
 391    set.  */
 392 # if !@HAVE_MKSTEMPS@
 393 _GL_FUNCDECL_SYS (mkstemps, int, (char * /*template*/, int /*suffixlen*/)
 394                                  _GL_ARG_NONNULL ((1)));
 395 # endif
 396 _GL_CXXALIAS_SYS (mkstemps, int, (char * /*template*/, int /*suffixlen*/));
 397 _GL_CXXALIASWARN (mkstemps);
 398 #elif defined GNULIB_POSIXCHECK
 399 # undef mkstemps
 400 # if HAVE_RAW_DECL_MKSTEMPS
 401 _GL_WARN_ON_USE (mkstemps, "mkstemps is unportable - "
 402                  "use gnulib module mkstemps for portability");
 403 # endif
 404 #endif
 405
 406 #if @GNULIB_PTSNAME@
 407 /* Return the pathname of the pseudo-terminal slave associated with
 408    the master FD is open on, or NULL on errors.  */
 409 # if !@HAVE_PTSNAME@
 410 _GL_FUNCDECL_SYS (ptsname, char *, (int fd));
 411 # endif
 412 _GL_CXXALIAS_SYS (ptsname, char *, (int fd));
 413 _GL_CXXALIASWARN (ptsname);
 414 #elif defined GNULIB_POSIXCHECK
 415 # undef ptsname
 416 # if HAVE_RAW_DECL_PTSNAME
 417 _GL_WARN_ON_USE (ptsname, "ptsname is not portable - "
 418                  "use gnulib module ptsname for portability");
 419 # endif
 420 #endif
 421
 422 #if @GNULIB_PUTENV@
 423 # if @REPLACE_PUTENV@
 424 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 425 #   undef putenv
 426 #   define putenv rpl_putenv
 427 #  endif
 428 _GL_FUNCDECL_RPL (putenv, int, (char *string) _GL_ARG_NONNULL ((1)));
 429 _GL_CXXALIAS_RPL (putenv, int, (char *string));
 430 # else
 431 _GL_CXXALIAS_SYS (putenv, int, (char *string));
 432 # endif
 433 _GL_CXXALIASWARN (putenv);
 434 #endif
 435
 436
 437 #if @GNULIB_RANDOM_R@
 438 # if !@HAVE_RANDOM_R@
 439 #  ifndef RAND_MAX
 440 #   define RAND_MAX 2147483647
 441 #  endif
 442 # endif
 443 #endif
 444
 445 #if @GNULIB_RANDOM_R@
 446 # if !@HAVE_RANDOM_R@
 447 _GL_FUNCDECL_SYS (random_r, int, (struct random_data *buf, int32_t *result)
 448                                  _GL_ARG_NONNULL ((1, 2)));
 449 # endif
 450 _GL_CXXALIAS_SYS (random_r, int, (struct random_data *buf, int32_t *result));
 451 _GL_CXXALIASWARN (random_r);
 452 #elif defined GNULIB_POSIXCHECK
 453 # undef random_r
 454 # if HAVE_RAW_DECL_RANDOM_R
 455 _GL_WARN_ON_USE (random_r, "random_r is unportable - "
 456                  "use gnulib module random_r for portability");
 457 # endif
 458 #endif
 459
 460 #if @GNULIB_RANDOM_R@
 461 # if !@HAVE_RANDOM_R@
 462 _GL_FUNCDECL_SYS (srandom_r, int,
 463                   (unsigned int seed, struct random_data *rand_state)
 464                   _GL_ARG_NONNULL ((2)));
 465 # endif
 466 _GL_CXXALIAS_SYS (srandom_r, int,
 467                   (unsigned int seed, struct random_data *rand_state));
 468 _GL_CXXALIASWARN (srandom_r);
 469 #elif defined GNULIB_POSIXCHECK
 470 # undef srandom_r
 471 # if HAVE_RAW_DECL_SRANDOM_R
 472 _GL_WARN_ON_USE (srandom_r, "srandom_r is unportable - "
 473                  "use gnulib module random_r for portability");
 474 # endif
 475 #endif
 476
 477 #if @GNULIB_RANDOM_R@
 478 # if !@HAVE_RANDOM_R@
 479 _GL_FUNCDECL_SYS (initstate_r, int,
 480                   (unsigned int seed, char *buf, size_t buf_size,
 481                    struct random_data *rand_state)
 482                   _GL_ARG_NONNULL ((2, 4)));
 483 # endif
 484 _GL_CXXALIAS_SYS (initstate_r, int,
 485                   (unsigned int seed, char *buf, size_t buf_size,
 486                    struct random_data *rand_state));
 487 _GL_CXXALIASWARN (initstate_r);
 488 #elif defined GNULIB_POSIXCHECK
 489 # undef initstate_r
 490 # if HAVE_RAW_DECL_INITSTATE_R
 491 _GL_WARN_ON_USE (initstate_r, "initstate_r is unportable - "
 492                  "use gnulib module random_r for portability");
 493 # endif
 494 #endif
 495
 496 #if @GNULIB_RANDOM_R@
 497 # if !@HAVE_RANDOM_R@
 498 _GL_FUNCDECL_SYS (setstate_r, int,
 499                   (char *arg_state, struct random_data *rand_state)
 500                   _GL_ARG_NONNULL ((1, 2)));
 501 # endif
 502 _GL_CXXALIAS_SYS (setstate_r, int,
 503                   (char *arg_state, struct random_data *rand_state));
 504 _GL_CXXALIASWARN (setstate_r);
 505 #elif defined GNULIB_POSIXCHECK
 506 # undef setstate_r
 507 # if HAVE_RAW_DECL_SETSTATE_R
 508 _GL_WARN_ON_USE (setstate_r, "setstate_r is unportable - "
 509                  "use gnulib module random_r for portability");
 510 # endif
 511 #endif
 512
 513
 514 #if @GNULIB_REALLOC_POSIX@
 515 # if @REPLACE_REALLOC@
 516 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 517 #   undef realloc
 518 #   define realloc rpl_realloc
 519 #  endif
 520 _GL_FUNCDECL_RPL (realloc, void *, (void *ptr, size_t size));
 521 _GL_CXXALIAS_RPL (realloc, void *, (void *ptr, size_t size));
 522 # else
 523 _GL_CXXALIAS_SYS (realloc, void *, (void *ptr, size_t size));
 524 # endif
 525 _GL_CXXALIASWARN (realloc);
 526 #elif defined GNULIB_POSIXCHECK
 527 # undef realloc
 528 /* Assume realloc is always declared.  */
 529 _GL_WARN_ON_USE (realloc, "realloc is not POSIX compliant everywhere - "
 530                  "use gnulib module realloc-posix for portability");
 531 #endif
 532
 533 #if @GNULIB_REALPATH@
 534 # if @REPLACE_REALPATH@
 535 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 536 #   define realpath rpl_realpath
 537 #  endif
 538 _GL_FUNCDECL_RPL (realpath, char *, (const char *name, char *resolved)
 539                                     _GL_ARG_NONNULL ((1)));
 540 _GL_CXXALIAS_RPL (realpath, char *, (const char *name, char *resolved));
 541 # else
 542 #  if !@HAVE_REALPATH@
 543 _GL_FUNCDECL_SYS (realpath, char *, (const char *name, char *resolved)
 544                                     _GL_ARG_NONNULL ((1)));
 545 #  endif
 546 _GL_CXXALIAS_SYS (realpath, char *, (const char *name, char *resolved));
 547 # endif
 548 _GL_CXXALIASWARN (realpath);
 549 #elif defined GNULIB_POSIXCHECK
 550 # undef realpath
 551 # if HAVE_RAW_DECL_REALPATH
 552 _GL_WARN_ON_USE (realpath, "realpath is unportable - use gnulib module "
 553                  "canonicalize or canonicalize-lgpl for portability");
 554 # endif
 555 #endif
 556
 557 #if @GNULIB_RPMATCH@
 558 /* Test a user response to a question.
 559    Return 1 if it is affirmative, 0 if it is negative, or -1 if not clear.  */
 560 # if !@HAVE_RPMATCH@
 561 _GL_FUNCDECL_SYS (rpmatch, int, (const char *response) _GL_ARG_NONNULL ((1)));
 562 # endif
 563 _GL_CXXALIAS_SYS (rpmatch, int, (const char *response));
 564 _GL_CXXALIASWARN (rpmatch);
 565 #elif defined GNULIB_POSIXCHECK
 566 # undef rpmatch
 567 # if HAVE_RAW_DECL_RPMATCH
 568 _GL_WARN_ON_USE (rpmatch, "rpmatch is unportable - "
 569                  "use gnulib module rpmatch for portability");
 570 # endif
 571 #endif
 572
 573 #if @GNULIB_SETENV@
 574 /* Set NAME to VALUE in the environment.
 575    If REPLACE is nonzero, overwrite an existing value.  */
 576 # if @REPLACE_SETENV@
 577 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 578 #   undef setenv
 579 #   define setenv rpl_setenv
 580 #  endif
 581 _GL_FUNCDECL_RPL (setenv, int,
 582                   (const char *name, const char *value, int replace)
 583                   _GL_ARG_NONNULL ((1)));
 584 _GL_CXXALIAS_RPL (setenv, int,
 585                   (const char *name, const char *value, int replace));
 586 # else
 587 #  if !@HAVE_DECL_SETENV@
 588 _GL_FUNCDECL_SYS (setenv, int,
 589                   (const char *name, const char *value, int replace)
 590                   _GL_ARG_NONNULL ((1)));
 591 #  endif
 592 _GL_CXXALIAS_SYS (setenv, int,
 593                   (const char *name, const char *value, int replace));
 594 # endif
 595 # if !(@REPLACE_SETENV@ && !@HAVE_DECL_SETENV@)
 596 _GL_CXXALIASWARN (setenv);
 597 # endif
 598 #elif defined GNULIB_POSIXCHECK
 599 # undef setenv
 600 # if HAVE_RAW_DECL_SETENV
 601 _GL_WARN_ON_USE (setenv, "setenv is unportable - "
 602                  "use gnulib module setenv for portability");
 603 # endif
 604 #endif
 605
 606 #if @GNULIB_STRTOD@
 607  /* Parse a double from STRING, updating ENDP if appropriate.  */
 608 # if @REPLACE_STRTOD@
 609 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 610 #   define strtod rpl_strtod
 611 #  endif
 612 _GL_FUNCDECL_RPL (strtod, double, (const char *str, char **endp)
 613                                   _GL_ARG_NONNULL ((1)));
 614 _GL_CXXALIAS_RPL (strtod, double, (const char *str, char **endp));
 615 # else
 616 #  if !@HAVE_STRTOD@
 617 _GL_FUNCDECL_SYS (strtod, double, (const char *str, char **endp)
 618                                   _GL_ARG_NONNULL ((1)));
 619 #  endif
 620 _GL_CXXALIAS_SYS (strtod, double, (const char *str, char **endp));
 621 # endif
 622 _GL_CXXALIASWARN (strtod);
 623 #elif defined GNULIB_POSIXCHECK
 624 # undef strtod
 625 # if HAVE_RAW_DECL_STRTOD
 626 _GL_WARN_ON_USE (strtod, "strtod is unportable - "
 627                  "use gnulib module strtod for portability");
 628 # endif
 629 #endif
 630
 631 #if @GNULIB_STRTOLL@
 632 /* Parse a signed integer whose textual representation starts at STRING.
 633    The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
 634    it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
 635    "0x").
 636    If ENDPTR is not NULL, the address of the first byte after the integer is
 637    stored in *ENDPTR.
 638    Upon overflow, the return value is LLONG_MAX or LLONG_MIN, and errno is set
 639    to ERANGE.  */
 640 # if !@HAVE_STRTOLL@
 641 _GL_FUNCDECL_SYS (strtoll, long long,
 642                   (const char *string, char **endptr, int base)
 643                   _GL_ARG_NONNULL ((1)));
 644 # endif
 645 _GL_CXXALIAS_SYS (strtoll, long long,
 646                   (const char *string, char **endptr, int base));
 647 _GL_CXXALIASWARN (strtoll);
 648 #elif defined GNULIB_POSIXCHECK
 649 # undef strtoll
 650 # if HAVE_RAW_DECL_STRTOLL
 651 _GL_WARN_ON_USE (strtoll, "strtoll is unportable - "
 652                  "use gnulib module strtoll for portability");
 653 # endif
 654 #endif
 655
 656 #if @GNULIB_STRTOULL@
 657 /* Parse an unsigned integer whose textual representation starts at STRING.
 658    The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
 659    it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
 660    "0x").
 661    If ENDPTR is not NULL, the address of the first byte after the integer is
 662    stored in *ENDPTR.
 663    Upon overflow, the return value is ULLONG_MAX, and errno is set to
 664    ERANGE.  */
 665 # if !@HAVE_STRTOULL@
 666 _GL_FUNCDECL_SYS (strtoull, unsigned long long,
 667                   (const char *string, char **endptr, int base)
 668                   _GL_ARG_NONNULL ((1)));
 669 # endif
 670 _GL_CXXALIAS_SYS (strtoull, unsigned long long,
 671                   (const char *string, char **endptr, int base));
 672 _GL_CXXALIASWARN (strtoull);
 673 #elif defined GNULIB_POSIXCHECK
 674 # undef strtoull
 675 # if HAVE_RAW_DECL_STRTOULL
 676 _GL_WARN_ON_USE (strtoull, "strtoull is unportable - "
 677                  "use gnulib module strtoull for portability");
 678 # endif
 679 #endif
 680
 681 #if @GNULIB_UNLOCKPT@
 682 /* Unlock the slave side of the pseudo-terminal whose master side is specified
 683    by FD, so that it can be opened.  */
 684 # if !@HAVE_UNLOCKPT@
 685 _GL_FUNCDECL_SYS (unlockpt, int, (int fd));
 686 # endif
 687 _GL_CXXALIAS_SYS (unlockpt, int, (int fd));
 688 _GL_CXXALIASWARN (unlockpt);
 689 #elif defined GNULIB_POSIXCHECK
 690 # undef unlockpt
 691 # if HAVE_RAW_DECL_UNLOCKPT
 692 _GL_WARN_ON_USE (unlockpt, "unlockpt is not portable - "
 693                  "use gnulib module unlockpt for portability");
 694 # endif
 695 #endif
 696
 697 #if @GNULIB_UNSETENV@
 698 /* Remove the variable NAME from the environment.  */
 699 # if @REPLACE_UNSETENV@
 700 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 701 #   undef unsetenv
 702 #   define unsetenv rpl_unsetenv
 703 #  endif
 704 _GL_FUNCDECL_RPL (unsetenv, int, (const char *name) _GL_ARG_NONNULL ((1)));
 705 _GL_CXXALIAS_RPL (unsetenv, int, (const char *name));
 706 # else
 707 #  if !@HAVE_DECL_UNSETENV@
 708 _GL_FUNCDECL_SYS (unsetenv, int, (const char *name) _GL_ARG_NONNULL ((1)));
 709 #  endif
 710 _GL_CXXALIAS_SYS (unsetenv, int, (const char *name));
 711 # endif
 712 # if !(@REPLACE_UNSETENV@ && !@HAVE_DECL_UNSETENV@)
 713 _GL_CXXALIASWARN (unsetenv);
 714 # endif
 715 #elif defined GNULIB_POSIXCHECK
 716 # undef unsetenv
 717 # if HAVE_RAW_DECL_UNSETENV
 718 _GL_WARN_ON_USE (unsetenv, "unsetenv is unportable - "
 719                  "use gnulib module unsetenv for portability");
 720 # endif
 721 #endif
 722
 723
 724 #endif /* _GL_STDLIB_H */
 725 #endif /* _GL_STDLIB_H */
 726 #endif