Home | History | Annotate | Download | only in lib
      1 /* A GNU-like <stdlib.h>.
      2 
      3    Copyright (C) 1995, 2001-2004, 2006-2012 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
    938