lib/stdio.in.h

   1 /* A GNU-like <stdio.h>.
   2
   3    Copyright (C) 2004, 2007-2011 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 2, or (at your option)
   8    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, write to the Free Software Foundation,
  17    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
  18
  19 #if __GNUC__ >= 3
  20 @PRAGMA_SYSTEM_HEADER@
  21 #endif
  22 @PRAGMA_COLUMNS@
  23
  24 #if defined __need_FILE || defined __need___FILE || defined _GL_ALREADY_INCLUDING_STDIO_H
  25 /* Special invocation convention:
  26    - Inside glibc header files.
  27    - On OSF/1 5.1 we have a sequence of nested includes
  28      <stdio.h> -> <getopt.h> -> <ctype.h> -> <sys/localedef.h> ->
  29      <sys/lc_core.h> -> <nl_types.h> -> <mesg.h> -> <stdio.h>.
  30      In this situation, the functions are not yet declared, therefore we cannot
  31      provide the C++ aliases.  */
  32
  33 #@INCLUDE_NEXT@ @NEXT_STDIO_H@
  34
  35 #else
  36 /* Normal invocation convention.  */
  37
  38 #ifndef _GL_STDIO_H
  39
  40 #define _GL_ALREADY_INCLUDING_STDIO_H
  41
  42 /* The include_next requires a split double-inclusion guard.  */
  43 #@INCLUDE_NEXT@ @NEXT_STDIO_H@
  44
  45 #undef _GL_ALREADY_INCLUDING_STDIO_H
  46
  47 #ifndef _GL_STDIO_H
  48 #define _GL_STDIO_H
  49
  50 /* Get va_list.  Needed on many systems, including glibc 2.8.  */
  51 #include <stdarg.h>
  52
  53 #include <stddef.h>
  54
  55 /* Get off_t and ssize_t.  Needed on many systems, including glibc 2.8.  */
  56 #include <sys/types.h>
  57
  58 #ifndef __attribute__
  59 /* The __attribute__ feature is available in gcc versions 2.5 and later.
  60    The __-protected variants of the attributes 'format' and 'printf' are
  61    accepted by gcc versions 2.6.4 (effectively 2.7) and later.
  62    We enable __attribute__ only if these are supported too, because
  63    gnulib and libintl do '#define printf __printf__' when they override
  64    the 'printf' function.  */
  65 # if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 7)
  66 #  define __attribute__(Spec)   /* empty */
  67 # endif
  68 #endif
  69
  70 /* Solaris 10 declares renameat in <unistd.h>, not in <stdio.h>.  */
  71 /* But in any case avoid namespace pollution on glibc systems.  */
  72 #if (@GNULIB_RENAMEAT@ || defined GNULIB_POSIXCHECK) && defined __sun \
  73     && ! defined __GLIBC__
  74 # include <unistd.h>
  75 #endif
  76
  77
  78 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
  79
  80 /* The definition of _GL_ARG_NONNULL is copied here.  */
  81
  82 /* The definition of _GL_WARN_ON_USE is copied here.  */
  83
  84 /* Macros for stringification.  */
  85 #define _GL_STDIO_STRINGIZE(token) #token
  86 #define _GL_STDIO_MACROEXPAND_AND_STRINGIZE(token) _GL_STDIO_STRINGIZE(token)
  87
  88
  89 #if @GNULIB_DPRINTF@
  90 # if @REPLACE_DPRINTF@
  91 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
  92 #   define dprintf rpl_dprintf
  93 #  endif
  94 _GL_FUNCDECL_RPL (dprintf, int, (int fd, const char *format, ...)
  95                                 __attribute__ ((__format__ (__printf__, 2, 3)))
  96                                 _GL_ARG_NONNULL ((2)));
  97 _GL_CXXALIAS_RPL (dprintf, int, (int fd, const char *format, ...));
  98 # else
  99 #  if !@HAVE_DPRINTF@
 100 _GL_FUNCDECL_SYS (dprintf, int, (int fd, const char *format, ...)
 101                                 __attribute__ ((__format__ (__printf__, 2, 3)))
 102                                 _GL_ARG_NONNULL ((2)));
 103 #  endif
 104 _GL_CXXALIAS_SYS (dprintf, int, (int fd, const char *format, ...));
 105 # endif
 106 _GL_CXXALIASWARN (dprintf);
 107 #elif defined GNULIB_POSIXCHECK
 108 # undef dprintf
 109 # if HAVE_RAW_DECL_DPRINTF
 110 _GL_WARN_ON_USE (dprintf, "dprintf is unportable - "
 111                  "use gnulib module dprintf for portability");
 112 # endif
 113 #endif
 114
 115 #if @GNULIB_FCLOSE@
 116 /* Close STREAM and its underlying file descriptor.  */
 117 # if @REPLACE_FCLOSE@
 118 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 119 #   define fclose rpl_fclose
 120 #  endif
 121 _GL_FUNCDECL_RPL (fclose, int, (FILE *stream) _GL_ARG_NONNULL ((1)));
 122 _GL_CXXALIAS_RPL (fclose, int, (FILE *stream));
 123 # else
 124 _GL_CXXALIAS_SYS (fclose, int, (FILE *stream));
 125 # endif
 126 _GL_CXXALIASWARN (fclose);
 127 #elif defined GNULIB_POSIXCHECK
 128 # undef fclose
 129 /* Assume fclose is always declared.  */
 130 _GL_WARN_ON_USE (fclose, "fclose is not always POSIX compliant - "
 131                  "use gnulib module fclose for portable POSIX compliance");
 132 #endif
 133
 134 #if @GNULIB_FFLUSH@
 135 /* Flush all pending data on STREAM according to POSIX rules.  Both
 136    output and seekable input streams are supported.
 137    Note! LOSS OF DATA can occur if fflush is applied on an input stream
 138    that is _not_seekable_ or on an update stream that is _not_seekable_
 139    and in which the most recent operation was input.  Seekability can
 140    be tested with lseek(fileno(fp),0,SEEK_CUR).  */
 141 # if @REPLACE_FFLUSH@
 142 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 143 #   define fflush rpl_fflush
 144 #  endif
 145 _GL_FUNCDECL_RPL (fflush, int, (FILE *gl_stream));
 146 _GL_CXXALIAS_RPL (fflush, int, (FILE *gl_stream));
 147 # else
 148 _GL_CXXALIAS_SYS (fflush, int, (FILE *gl_stream));
 149 # endif
 150 _GL_CXXALIASWARN (fflush);
 151 #elif defined GNULIB_POSIXCHECK
 152 # undef fflush
 153 /* Assume fflush is always declared.  */
 154 _GL_WARN_ON_USE (fflush, "fflush is not always POSIX compliant - "
 155                  "use gnulib module fflush for portable POSIX compliance");
 156 #endif
 157
 158 /* It is very rare that the developer ever has full control of stdin,
 159    so any use of gets warrants an unconditional warning.  Assume it is
 160    always declared, since it is required by C89.  */
 161 #undef gets
 162 _GL_WARN_ON_USE (gets, "gets is a security hole - use fgets instead");
 163
 164 #if @GNULIB_FOPEN@
 165 # if @REPLACE_FOPEN@
 166 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 167 #   undef fopen
 168 #   define fopen rpl_fopen
 169 #  endif
 170 _GL_FUNCDECL_RPL (fopen, FILE *, (const char *filename, const char *mode)
 171                                  _GL_ARG_NONNULL ((1, 2)));
 172 _GL_CXXALIAS_RPL (fopen, FILE *, (const char *filename, const char *mode));
 173 # else
 174 _GL_CXXALIAS_SYS (fopen, FILE *, (const char *filename, const char *mode));
 175 # endif
 176 _GL_CXXALIASWARN (fopen);
 177 #elif defined GNULIB_POSIXCHECK
 178 # undef fopen
 179 /* Assume fopen is always declared.  */
 180 _GL_WARN_ON_USE (fopen, "fopen on Win32 platforms is not POSIX compatible - "
 181                  "use gnulib module fopen for portability");
 182 #endif
 183
 184 #if @GNULIB_FPRINTF_POSIX@ || @GNULIB_FPRINTF@
 185 # if (@GNULIB_FPRINTF_POSIX@ && @REPLACE_FPRINTF@) \
 186      || (@GNULIB_FPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@)
 187 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 188 #   define fprintf rpl_fprintf
 189 #  endif
 190 #  define GNULIB_overrides_fprintf 1
 191 _GL_FUNCDECL_RPL (fprintf, int, (FILE *fp, const char *format, ...)
 192                                 __attribute__ ((__format__ (__printf__, 2, 3)))
 193                                 _GL_ARG_NONNULL ((1, 2)));
 194 _GL_CXXALIAS_RPL (fprintf, int, (FILE *fp, const char *format, ...));
 195 # else
 196 _GL_CXXALIAS_SYS (fprintf, int, (FILE *fp, const char *format, ...));
 197 # endif
 198 _GL_CXXALIASWARN (fprintf);
 199 #endif
 200 #if !@GNULIB_FPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
 201 # if !GNULIB_overrides_fprintf
 202 #  undef fprintf
 203 # endif
 204 /* Assume fprintf is always declared.  */
 205 _GL_WARN_ON_USE (fprintf, "fprintf is not always POSIX compliant - "
 206                  "use gnulib module fprintf-posix for portable "
 207                  "POSIX compliance");
 208 #endif
 209
 210 #if @GNULIB_FPURGE@
 211 /* Discard all pending buffered I/O data on STREAM.
 212    STREAM must not be wide-character oriented.
 213    When discarding pending output, the file position is set back to where it
 214    was before the write calls.  When discarding pending input, the file
 215    position is advanced to match the end of the previously read input.
 216    Return 0 if successful.  Upon error, return -1 and set errno.  */
 217 # if @REPLACE_FPURGE@
 218 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 219 #   define fpurge rpl_fpurge
 220 #  endif
 221 _GL_FUNCDECL_RPL (fpurge, int, (FILE *gl_stream) _GL_ARG_NONNULL ((1)));
 222 _GL_CXXALIAS_RPL (fpurge, int, (FILE *gl_stream));
 223 # else
 224 #  if !@HAVE_DECL_FPURGE@
 225 _GL_FUNCDECL_SYS (fpurge, int, (FILE *gl_stream) _GL_ARG_NONNULL ((1)));
 226 #  endif
 227 _GL_CXXALIAS_SYS (fpurge, int, (FILE *gl_stream));
 228 # endif
 229 _GL_CXXALIASWARN (fpurge);
 230 #elif defined GNULIB_POSIXCHECK
 231 # undef fpurge
 232 # if HAVE_RAW_DECL_FPURGE
 233 _GL_WARN_ON_USE (fpurge, "fpurge is not always present - "
 234                  "use gnulib module fpurge for portability");
 235 # endif
 236 #endif
 237
 238 #if @GNULIB_FPUTC@
 239 # if @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 240 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 241 #   undef fputc
 242 #   define fputc rpl_fputc
 243 #  endif
 244 _GL_FUNCDECL_RPL (fputc, int, (int c, FILE *stream) _GL_ARG_NONNULL ((2)));
 245 _GL_CXXALIAS_RPL (fputc, int, (int c, FILE *stream));
 246 # else
 247 _GL_CXXALIAS_SYS (fputc, int, (int c, FILE *stream));
 248 # endif
 249 _GL_CXXALIASWARN (fputc);
 250 #endif
 251
 252 #if @GNULIB_FPUTS@
 253 # if @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 254 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 255 #   undef fputs
 256 #   define fputs rpl_fputs
 257 #  endif
 258 _GL_FUNCDECL_RPL (fputs, int, (const char *string, FILE *stream)
 259                               _GL_ARG_NONNULL ((1, 2)));
 260 _GL_CXXALIAS_RPL (fputs, int, (const char *string, FILE *stream));
 261 # else
 262 _GL_CXXALIAS_SYS (fputs, int, (const char *string, FILE *stream));
 263 # endif
 264 _GL_CXXALIASWARN (fputs);
 265 #endif
 266
 267 #if @GNULIB_FREOPEN@
 268 # if @REPLACE_FREOPEN@
 269 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 270 #   undef freopen
 271 #   define freopen rpl_freopen
 272 #  endif
 273 _GL_FUNCDECL_RPL (freopen, FILE *,
 274                   (const char *filename, const char *mode, FILE *stream)
 275                   _GL_ARG_NONNULL ((2, 3)));
 276 _GL_CXXALIAS_RPL (freopen, FILE *,
 277                   (const char *filename, const char *mode, FILE *stream));
 278 # else
 279 _GL_CXXALIAS_SYS (freopen, FILE *,
 280                   (const char *filename, const char *mode, FILE *stream));
 281 # endif
 282 _GL_CXXALIASWARN (freopen);
 283 #elif defined GNULIB_POSIXCHECK
 284 # undef freopen
 285 /* Assume freopen is always declared.  */
 286 _GL_WARN_ON_USE (freopen,
 287                  "freopen on Win32 platforms is not POSIX compatible - "
 288                  "use gnulib module freopen for portability");
 289 #endif
 290
 291
 292 /* Set up the following warnings, based on which modules are in use.
 293    GNU Coding Standards discourage the use of fseek, since it imposes
 294    an arbitrary limitation on some 32-bit hosts.  Remember that the
 295    fseek module depends on the fseeko module, so we only have three
 296    cases to consider:
 297
 298    1. The developer is not using either module.  Issue a warning under
 299    GNULIB_POSIXCHECK for both functions, to remind them that both
 300    functions have bugs on some systems.  _GL_NO_LARGE_FILES has no
 301    impact on this warning.
 302
 303    2. The developer is using both modules.  They may be unaware of the
 304    arbitrary limitations of fseek, so issue a warning under
 305    GNULIB_POSIXCHECK.  On the other hand, they may be using both
 306    modules intentionally, so the developer can define
 307    _GL_NO_LARGE_FILES in the compilation units where the use of fseek
 308    is safe, to silence the warning.
 309
 310    3. The developer is using the fseeko module, but not fseek.  Gnulib
 311    guarantees that fseek will still work around platform bugs in that
 312    case, but we presume that the developer is aware of the pitfalls of
 313    fseek and was trying to avoid it, so issue a warning even when
 314    GNULIB_POSIXCHECK is undefined.  Again, _GL_NO_LARGE_FILES can be
 315    defined to silence the warning in particular compilation units.
 316    In C++ compilations with GNULIB_NAMESPACE, in order to avoid that
 317    fseek gets defined as a macro, it is recommended that the developer
 318    uses the fseek module, even if he is not calling the fseek function.
 319
 320    Most gnulib clients that perform stream operations should fall into
 321    category 3.  */
 322
 323 #if @GNULIB_FSEEK@
 324 # if defined GNULIB_POSIXCHECK && !defined _GL_NO_LARGE_FILES
 325 #  define _GL_FSEEK_WARN /* Category 2, above.  */
 326 #  undef fseek
 327 # endif
 328 # if @REPLACE_FSEEK@
 329 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 330 #   undef fseek
 331 #   define fseek rpl_fseek
 332 #  endif
 333 _GL_FUNCDECL_RPL (fseek, int, (FILE *fp, long offset, int whence)
 334                               _GL_ARG_NONNULL ((1)));
 335 _GL_CXXALIAS_RPL (fseek, int, (FILE *fp, long offset, int whence));
 336 # else
 337 _GL_CXXALIAS_SYS (fseek, int, (FILE *fp, long offset, int whence));
 338 # endif
 339 _GL_CXXALIASWARN (fseek);
 340 #endif
 341
 342 #if @GNULIB_FSEEKO@
 343 # if !@GNULIB_FSEEK@ && !defined _GL_NO_LARGE_FILES
 344 #  define _GL_FSEEK_WARN /* Category 3, above.  */
 345 #  undef fseek
 346 # endif
 347 # if @REPLACE_FSEEKO@
 348 /* Provide an fseeko function that is aware of a preceding fflush(), and which
 349    detects pipes.  */
 350 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 351 #   undef fseeko
 352 #   define fseeko rpl_fseeko
 353 #  endif
 354 _GL_FUNCDECL_RPL (fseeko, int, (FILE *fp, off_t offset, int whence)
 355                                _GL_ARG_NONNULL ((1)));
 356 _GL_CXXALIAS_RPL (fseeko, int, (FILE *fp, off_t offset, int whence));
 357 # else
 358 #  if ! @HAVE_DECL_FSEEKO@
 359 _GL_FUNCDECL_SYS (fseeko, int, (FILE *fp, off_t offset, int whence)
 360                                _GL_ARG_NONNULL ((1)));
 361 #  endif
 362 _GL_CXXALIAS_SYS (fseeko, int, (FILE *fp, off_t offset, int whence));
 363 # endif
 364 _GL_CXXALIASWARN (fseeko);
 365 # if (@REPLACE_FSEEKO@ || !@HAVE_FSEEKO@) && !@GNULIB_FSEEK@
 366    /* Provide an fseek function that is consistent with fseeko.  */
 367    /* In order to avoid that fseek gets defined as a macro here, the
 368       developer can request the 'fseek' module.  */
 369 #  undef fseek
 370 #  define fseek rpl_fseek
 371 static inline int _GL_ARG_NONNULL ((1))
 372 rpl_fseek (FILE *fp, long offset, int whence)
 373 {
 374 #  if @REPLACE_FSEEKO@
 375   return rpl_fseeko (fp, offset, whence);
 376 #  else
 377   return fseeko (fp, offset, whence);
 378 #  endif
 379 }
 380 # endif
 381 #elif defined GNULIB_POSIXCHECK
 382 # define _GL_FSEEK_WARN /* Category 1, above.  */
 383 # undef fseek
 384 # undef fseeko
 385 # if HAVE_RAW_DECL_FSEEKO
 386 _GL_WARN_ON_USE (fseeko, "fseeko is unportable - "
 387                  "use gnulib module fseeko for portability");
 388 # endif
 389 #endif
 390
 391 #ifdef _GL_FSEEK_WARN
 392 # undef _GL_FSEEK_WARN
 393 /* Here, either fseek is undefined (but C89 guarantees that it is
 394    declared), or it is defined as rpl_fseek (declared above).  */
 395 _GL_WARN_ON_USE (fseek, "fseek cannot handle files larger than 4 GB "
 396                  "on 32-bit platforms - "
 397                  "use fseeko function for handling of large files");
 398 #endif
 399
 400
 401 /* ftell, ftello.  See the comments on fseek/fseeko.  */
 402
 403 #if @GNULIB_FTELL@
 404 # if defined GNULIB_POSIXCHECK && !defined _GL_NO_LARGE_FILES
 405 #  define _GL_FTELL_WARN /* Category 2, above.  */
 406 #  undef ftell
 407 # endif
 408 # if @REPLACE_FTELL@
 409 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 410 #   undef ftell
 411 #   define ftell rpl_ftell
 412 #  endif
 413 _GL_FUNCDECL_RPL (ftell, long, (FILE *fp) _GL_ARG_NONNULL ((1)));
 414 _GL_CXXALIAS_RPL (ftell, long, (FILE *fp));
 415 # else
 416 _GL_CXXALIAS_SYS (ftell, long, (FILE *fp));
 417 # endif
 418 _GL_CXXALIASWARN (ftell);
 419 #endif
 420
 421 #if @GNULIB_FTELLO@
 422 # if !@GNULIB_FTELL@ && !defined _GL_NO_LARGE_FILES
 423 #  define _GL_FTELL_WARN /* Category 3, above.  */
 424 #  undef ftell
 425 # endif
 426 # if @REPLACE_FTELLO@
 427 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 428 #   undef ftello
 429 #   define ftello rpl_ftello
 430 #  endif
 431 _GL_FUNCDECL_RPL (ftello, off_t, (FILE *fp) _GL_ARG_NONNULL ((1)));
 432 _GL_CXXALIAS_RPL (ftello, off_t, (FILE *fp));
 433 # else
 434 #  if ! @HAVE_DECL_FTELLO@
 435 _GL_FUNCDECL_SYS (ftello, off_t, (FILE *fp) _GL_ARG_NONNULL ((1)));
 436 #  endif
 437 _GL_CXXALIAS_SYS (ftello, off_t, (FILE *fp));
 438 # endif
 439 _GL_CXXALIASWARN (ftello);
 440 # if (@REPLACE_FTELLO@ || !@HAVE_FTELLO@) && !@GNULIB_FTELL@
 441    /* Provide an ftell function that is consistent with ftello.  */
 442    /* In order to avoid that ftell gets defined as a macro here, the
 443       developer can request the 'ftell' module.  */
 444 #  undef ftell
 445 #  define ftell rpl_ftell
 446 static inline long _GL_ARG_NONNULL ((1))
 447 rpl_ftell (FILE *f)
 448 {
 449 #  if @REPLACE_FTELLO@
 450   return rpl_ftello (f);
 451 #  else
 452   return ftello (f);
 453 #  endif
 454 }
 455 # endif
 456 #elif defined GNULIB_POSIXCHECK
 457 # define _GL_FTELL_WARN /* Category 1, above.  */
 458 # undef ftell
 459 # undef ftello
 460 # if HAVE_RAW_DECL_FTELLO
 461 _GL_WARN_ON_USE (ftello, "ftello is unportable - "
 462                  "use gnulib module ftello for portability");
 463 # endif
 464 #endif
 465
 466 #ifdef _GL_FTELL_WARN
 467 # undef _GL_FTELL_WARN
 468 /* Here, either ftell is undefined (but C89 guarantees that it is
 469    declared), or it is defined as rpl_ftell (declared above).  */
 470 _GL_WARN_ON_USE (ftell, "ftell cannot handle files larger than 4 GB "
 471                  "on 32-bit platforms - "
 472                  "use ftello function for handling of large files");
 473 #endif
 474
 475
 476 #if @GNULIB_FWRITE@
 477 # if @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 478 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 479 #   undef fwrite
 480 #   define fwrite rpl_fwrite
 481 #  endif
 482 _GL_FUNCDECL_RPL (fwrite, size_t,
 483                   (const void *ptr, size_t s, size_t n, FILE *stream)
 484                   _GL_ARG_NONNULL ((1, 4)));
 485 _GL_CXXALIAS_RPL (fwrite, size_t,
 486                   (const void *ptr, size_t s, size_t n, FILE *stream));
 487 # else
 488 _GL_CXXALIAS_SYS (fwrite, size_t,
 489                   (const void *ptr, size_t s, size_t n, FILE *stream));
 490 # endif
 491 _GL_CXXALIASWARN (fwrite);
 492 #endif
 493
 494 #if @GNULIB_GETDELIM@
 495 /* Read input, up to (and including) the next occurrence of DELIMITER, from
 496    STREAM, store it in *LINEPTR (and NUL-terminate it).
 497    *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
 498    bytes of space.  It is realloc'd as necessary.
 499    Return the number of bytes read and stored at *LINEPTR (not including the
 500    NUL terminator), or -1 on error or EOF.  */
 501 # if @REPLACE_GETDELIM@
 502 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 503 #   undef getdelim
 504 #   define getdelim rpl_getdelim
 505 #  endif
 506 _GL_FUNCDECL_RPL (getdelim, ssize_t,
 507                   (char **lineptr, size_t *linesize, int delimiter,
 508                    FILE *stream)
 509                   _GL_ARG_NONNULL ((1, 2, 4)));
 510 _GL_CXXALIAS_RPL (getdelim, ssize_t,
 511                   (char **lineptr, size_t *linesize, int delimiter,
 512                    FILE *stream));
 513 # else
 514 #  if !@HAVE_DECL_GETDELIM@
 515 _GL_FUNCDECL_SYS (getdelim, ssize_t,
 516                   (char **lineptr, size_t *linesize, int delimiter,
 517                    FILE *stream)
 518                   _GL_ARG_NONNULL ((1, 2, 4)));
 519 #  endif
 520 _GL_CXXALIAS_SYS (getdelim, ssize_t,
 521                   (char **lineptr, size_t *linesize, int delimiter,
 522                    FILE *stream));
 523 # endif
 524 _GL_CXXALIASWARN (getdelim);
 525 #elif defined GNULIB_POSIXCHECK
 526 # undef getdelim
 527 # if HAVE_RAW_DECL_GETDELIM
 528 _GL_WARN_ON_USE (getdelim, "getdelim is unportable - "
 529                  "use gnulib module getdelim for portability");
 530 # endif
 531 #endif
 532
 533 #if @GNULIB_GETLINE@
 534 /* Read a line, up to (and including) the next newline, from STREAM, store it
 535    in *LINEPTR (and NUL-terminate it).
 536    *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
 537    bytes of space.  It is realloc'd as necessary.
 538    Return the number of bytes read and stored at *LINEPTR (not including the
 539    NUL terminator), or -1 on error or EOF.  */
 540 # if @REPLACE_GETLINE@
 541 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 542 #   undef getline
 543 #   define getline rpl_getline
 544 #  endif
 545 _GL_FUNCDECL_RPL (getline, ssize_t,
 546                   (char **lineptr, size_t *linesize, FILE *stream)
 547                   _GL_ARG_NONNULL ((1, 2, 3)));
 548 _GL_CXXALIAS_RPL (getline, ssize_t,
 549                   (char **lineptr, size_t *linesize, FILE *stream));
 550 # else
 551 #  if !@HAVE_DECL_GETLINE@
 552 _GL_FUNCDECL_SYS (getline, ssize_t,
 553                   (char **lineptr, size_t *linesize, FILE *stream)
 554                   _GL_ARG_NONNULL ((1, 2, 3)));
 555 #  endif
 556 _GL_CXXALIAS_SYS (getline, ssize_t,
 557                   (char **lineptr, size_t *linesize, FILE *stream));
 558 # endif
 559 # if @HAVE_DECL_GETLINE@
 560 _GL_CXXALIASWARN (getline);
 561 # endif
 562 #elif defined GNULIB_POSIXCHECK
 563 # undef getline
 564 # if HAVE_RAW_DECL_GETLINE
 565 _GL_WARN_ON_USE (getline, "getline is unportable - "
 566                  "use gnulib module getline for portability");
 567 # endif
 568 #endif
 569
 570 #if @GNULIB_OBSTACK_PRINTF@ || @GNULIB_OBSTACK_PRINTF_POSIX@
 571 struct obstack;
 572 /* Grow an obstack with formatted output.  Return the number of
 573    bytes added to OBS.  No trailing nul byte is added, and the
 574    object should be closed with obstack_finish before use.  Upon
 575    memory allocation error, call obstack_alloc_failed_handler.  Upon
 576    other error, return -1.  */
 577 # if @REPLACE_OBSTACK_PRINTF@
 578 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 579 #   define obstack_printf rpl_obstack_printf
 580 #  endif
 581 _GL_FUNCDECL_RPL (obstack_printf, int,
 582                   (struct obstack *obs, const char *format, ...)
 583                   __attribute__ ((__format__ (__printf__, 2, 3)))
 584                   _GL_ARG_NONNULL ((1, 2)));
 585 _GL_CXXALIAS_RPL (obstack_printf, int,
 586                   (struct obstack *obs, const char *format, ...));
 587 # else
 588 #  if !@HAVE_DECL_OBSTACK_PRINTF@
 589 _GL_FUNCDECL_SYS (obstack_printf, int,
 590                   (struct obstack *obs, const char *format, ...)
 591                   __attribute__ ((__format__ (__printf__, 2, 3)))
 592                   _GL_ARG_NONNULL ((1, 2)));
 593 #  endif
 594 _GL_CXXALIAS_SYS (obstack_printf, int,
 595                   (struct obstack *obs, const char *format, ...));
 596 # endif
 597 _GL_CXXALIASWARN (obstack_printf);
 598 # if @REPLACE_OBSTACK_PRINTF@
 599 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 600 #   define obstack_vprintf rpl_obstack_vprintf
 601 #  endif
 602 _GL_FUNCDECL_RPL (obstack_vprintf, int,
 603                   (struct obstack *obs, const char *format, va_list args)
 604                   __attribute__ ((__format__ (__printf__, 2, 0)))
 605                   _GL_ARG_NONNULL ((1, 2)));
 606 _GL_CXXALIAS_RPL (obstack_vprintf, int,
 607                   (struct obstack *obs, const char *format, va_list args));
 608 # else
 609 #  if !@HAVE_DECL_OBSTACK_PRINTF@
 610 _GL_FUNCDECL_SYS (obstack_vprintf, int,
 611                   (struct obstack *obs, const char *format, va_list args)
 612                   __attribute__ ((__format__ (__printf__, 2, 0)))
 613                   _GL_ARG_NONNULL ((1, 2)));
 614 #  endif
 615 _GL_CXXALIAS_SYS (obstack_vprintf, int,
 616                   (struct obstack *obs, const char *format, va_list args));
 617 # endif
 618 _GL_CXXALIASWARN (obstack_vprintf);
 619 #endif
 620
 621 #if @GNULIB_PERROR@
 622 /* Print a message to standard error, describing the value of ERRNO,
 623    (if STRING is not NULL and not empty) prefixed with STRING and ": ",
 624    and terminated with a newline.  */
 625 # if @REPLACE_PERROR@
 626 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 627 #   define perror rpl_perror
 628 #  endif
 629 _GL_FUNCDECL_RPL (perror, void, (const char *string));
 630 _GL_CXXALIAS_RPL (perror, void, (const char *string));
 631 # else
 632 _GL_CXXALIAS_SYS (perror, void, (const char *string));
 633 # endif
 634 _GL_CXXALIASWARN (perror);
 635 #elif defined GNULIB_POSIXCHECK
 636 # undef perror
 637 /* Assume perror is always declared.  */
 638 _GL_WARN_ON_USE (perror, "perror is not always POSIX compliant - "
 639                  "use gnulib module perror for portability");
 640 #endif
 641
 642 #if @GNULIB_POPEN@
 643 # if @REPLACE_POPEN@
 644 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 645 #   undef popen
 646 #   define popen rpl_popen
 647 #  endif
 648 _GL_FUNCDECL_RPL (popen, FILE *, (const char *cmd, const char *mode)
 649                                  _GL_ARG_NONNULL ((1, 2)));
 650 _GL_CXXALIAS_RPL (popen, FILE *, (const char *cmd, const char *mode));
 651 # else
 652 _GL_CXXALIAS_SYS (popen, FILE *, (const char *cmd, const char *mode));
 653 # endif
 654 _GL_CXXALIASWARN (popen);
 655 #elif defined GNULIB_POSIXCHECK
 656 # undef popen
 657 # if HAVE_RAW_DECL_POPEN
 658 _GL_WARN_ON_USE (popen, "popen is buggy on some platforms - "
 659                  "use gnulib module popen or pipe for more portability");
 660 # endif
 661 #endif
 662
 663 #if @GNULIB_PRINTF_POSIX@ || @GNULIB_PRINTF@
 664 # if (@GNULIB_PRINTF_POSIX@ && @REPLACE_PRINTF@) \
 665      || (@GNULIB_PRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@)
 666 #  if defined __GNUC__
 667 #   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 668 /* Don't break __attribute__((format(printf,M,N))).  */
 669 #    define printf __printf__
 670 #   endif
 671 _GL_FUNCDECL_RPL_1 (__printf__, int,
 672                     (const char *format, ...)
 673                     __asm__ (@ASM_SYMBOL_PREFIX@
 674                              _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_printf))
 675                     __attribute__ ((__format__ (__printf__, 1, 2)))
 676                     _GL_ARG_NONNULL ((1)));
 677 _GL_CXXALIAS_RPL_1 (printf, __printf__, int, (const char *format, ...));
 678 #  else
 679 #   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 680 #    define printf rpl_printf
 681 #   endif
 682 _GL_FUNCDECL_RPL (printf, int,
 683                   (const char *format, ...)
 684                   __attribute__ ((__format__ (__printf__, 1, 2)))
 685                   _GL_ARG_NONNULL ((1)));
 686 _GL_CXXALIAS_RPL (printf, int, (const char *format, ...));
 687 #  endif
 688 #  define GNULIB_overrides_printf 1
 689 # else
 690 _GL_CXXALIAS_SYS (printf, int, (const char *format, ...));
 691 # endif
 692 _GL_CXXALIASWARN (printf);
 693 #endif
 694 #if !@GNULIB_PRINTF_POSIX@ && defined GNULIB_POSIXCHECK
 695 # if !GNULIB_overrides_printf
 696 #  undef printf
 697 # endif
 698 /* Assume printf is always declared.  */
 699 _GL_WARN_ON_USE (printf, "printf is not always POSIX compliant - "
 700                  "use gnulib module printf-posix for portable "
 701                  "POSIX compliance");
 702 #endif
 703
 704 #if @GNULIB_PUTC@
 705 # if @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 706 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 707 #   undef putc
 708 #   define putc rpl_fputc
 709 #  endif
 710 _GL_FUNCDECL_RPL (fputc, int, (int c, FILE *stream) _GL_ARG_NONNULL ((2)));
 711 _GL_CXXALIAS_RPL_1 (putc, rpl_fputc, int, (int c, FILE *stream));
 712 # else
 713 _GL_CXXALIAS_SYS (putc, int, (int c, FILE *stream));
 714 # endif
 715 _GL_CXXALIASWARN (putc);
 716 #endif
 717
 718 #if @GNULIB_PUTCHAR@
 719 # if @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 720 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 721 #   undef putchar
 722 #   define putchar rpl_putchar
 723 #  endif
 724 _GL_FUNCDECL_RPL (putchar, int, (int c));
 725 _GL_CXXALIAS_RPL (putchar, int, (int c));
 726 # else
 727 _GL_CXXALIAS_SYS (putchar, int, (int c));
 728 # endif
 729 _GL_CXXALIASWARN (putchar);
 730 #endif
 731
 732 #if @GNULIB_PUTS@
 733 # if @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 734 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 735 #   undef puts
 736 #   define puts rpl_puts
 737 #  endif
 738 _GL_FUNCDECL_RPL (puts, int, (const char *string) _GL_ARG_NONNULL ((1)));
 739 _GL_CXXALIAS_RPL (puts, int, (const char *string));
 740 # else
 741 _GL_CXXALIAS_SYS (puts, int, (const char *string));
 742 # endif
 743 _GL_CXXALIASWARN (puts);
 744 #endif
 745
 746 #if @GNULIB_REMOVE@
 747 # if @REPLACE_REMOVE@
 748 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 749 #   undef remove
 750 #   define remove rpl_remove
 751 #  endif
 752 _GL_FUNCDECL_RPL (remove, int, (const char *name) _GL_ARG_NONNULL ((1)));
 753 _GL_CXXALIAS_RPL (remove, int, (const char *name));
 754 # else
 755 _GL_CXXALIAS_SYS (remove, int, (const char *name));
 756 # endif
 757 _GL_CXXALIASWARN (remove);
 758 #elif defined GNULIB_POSIXCHECK
 759 # undef remove
 760 /* Assume remove is always declared.  */
 761 _GL_WARN_ON_USE (remove, "remove cannot handle directories on some platforms - "
 762                  "use gnulib module remove for more portability");
 763 #endif
 764
 765 #if @GNULIB_RENAME@
 766 # if @REPLACE_RENAME@
 767 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 768 #   undef rename
 769 #   define rename rpl_rename
 770 #  endif
 771 _GL_FUNCDECL_RPL (rename, int,
 772                   (const char *old_filename, const char *new_filename)
 773                   _GL_ARG_NONNULL ((1, 2)));
 774 _GL_CXXALIAS_RPL (rename, int,
 775                   (const char *old_filename, const char *new_filename));
 776 # else
 777 _GL_CXXALIAS_SYS (rename, int,
 778                   (const char *old_filename, const char *new_filename));
 779 # endif
 780 _GL_CXXALIASWARN (rename);
 781 #elif defined GNULIB_POSIXCHECK
 782 # undef rename
 783 /* Assume rename is always declared.  */
 784 _GL_WARN_ON_USE (rename, "rename is buggy on some platforms - "
 785                  "use gnulib module rename for more portability");
 786 #endif
 787
 788 #if @GNULIB_RENAMEAT@
 789 # if @REPLACE_RENAMEAT@
 790 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 791 #   undef renameat
 792 #   define renameat rpl_renameat
 793 #  endif
 794 _GL_FUNCDECL_RPL (renameat, int,
 795                   (int fd1, char const *file1, int fd2, char const *file2)
 796                   _GL_ARG_NONNULL ((2, 4)));
 797 _GL_CXXALIAS_RPL (renameat, int,
 798                   (int fd1, char const *file1, int fd2, char const *file2));
 799 # else
 800 #  if !@HAVE_RENAMEAT@
 801 _GL_FUNCDECL_SYS (renameat, int,
 802                   (int fd1, char const *file1, int fd2, char const *file2)
 803                   _GL_ARG_NONNULL ((2, 4)));
 804 #  endif
 805 _GL_CXXALIAS_SYS (renameat, int,
 806                   (int fd1, char const *file1, int fd2, char const *file2));
 807 # endif
 808 _GL_CXXALIASWARN (renameat);
 809 #elif defined GNULIB_POSIXCHECK
 810 # undef renameat
 811 # if HAVE_RAW_DECL_RENAMEAT
 812 _GL_WARN_ON_USE (renameat, "renameat is not portable - "
 813                  "use gnulib module renameat for portability");
 814 # endif
 815 #endif
 816
 817 #if @GNULIB_SNPRINTF@
 818 # if @REPLACE_SNPRINTF@
 819 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 820 #   define snprintf rpl_snprintf
 821 #  endif
 822 _GL_FUNCDECL_RPL (snprintf, int,
 823                   (char *str, size_t size, const char *format, ...)
 824                   __attribute__ ((__format__ (__printf__, 3, 4)))
 825                   _GL_ARG_NONNULL ((3)));
 826 _GL_CXXALIAS_RPL (snprintf, int,
 827                   (char *str, size_t size, const char *format, ...));
 828 # else
 829 #  if !@HAVE_DECL_SNPRINTF@
 830 _GL_FUNCDECL_SYS (snprintf, int,
 831                   (char *str, size_t size, const char *format, ...)
 832                   __attribute__ ((__format__ (__printf__, 3, 4)))
 833                   _GL_ARG_NONNULL ((3)));
 834 #  endif
 835 _GL_CXXALIAS_SYS (snprintf, int,
 836                   (char *str, size_t size, const char *format, ...));
 837 # endif
 838 _GL_CXXALIASWARN (snprintf);
 839 #elif defined GNULIB_POSIXCHECK
 840 # undef snprintf
 841 # if HAVE_RAW_DECL_SNPRINTF
 842 _GL_WARN_ON_USE (snprintf, "snprintf is unportable - "
 843                  "use gnulib module snprintf for portability");
 844 # endif
 845 #endif
 846
 847 /* Some people would argue that sprintf should be handled like gets
 848    (for example, OpenBSD issues a link warning for both functions),
 849    since both can cause security holes due to buffer overruns.
 850    However, we believe that sprintf can be used safely, and is more
 851    efficient than snprintf in those safe cases; and as proof of our
 852    belief, we use sprintf in several gnulib modules.  So this header
 853    intentionally avoids adding a warning to sprintf except when
 854    GNULIB_POSIXCHECK is defined.  */
 855
 856 #if @GNULIB_SPRINTF_POSIX@
 857 # if @REPLACE_SPRINTF@
 858 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 859 #   define sprintf rpl_sprintf
 860 #  endif
 861 _GL_FUNCDECL_RPL (sprintf, int, (char *str, const char *format, ...)
 862                                 __attribute__ ((__format__ (__printf__, 2, 3)))
 863                                 _GL_ARG_NONNULL ((1, 2)));
 864 _GL_CXXALIAS_RPL (sprintf, int, (char *str, const char *format, ...));
 865 # else
 866 _GL_CXXALIAS_SYS (sprintf, int, (char *str, const char *format, ...));
 867 # endif
 868 _GL_CXXALIASWARN (sprintf);
 869 #elif defined GNULIB_POSIXCHECK
 870 # undef sprintf
 871 /* Assume sprintf is always declared.  */
 872 _GL_WARN_ON_USE (sprintf, "sprintf is not always POSIX compliant - "
 873                  "use gnulib module sprintf-posix for portable "
 874                  "POSIX compliance");
 875 #endif
 876
 877 #if @GNULIB_TMPFILE@
 878 # if @REPLACE_TMPFILE@
 879 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 880 #   define tmpfile rpl_tmpfile
 881 #  endif
 882 _GL_FUNCDECL_RPL (tmpfile, FILE *, (void));
 883 _GL_CXXALIAS_RPL (tmpfile, FILE *, (void));
 884 # else
 885 _GL_CXXALIAS_SYS (tmpfile, FILE *, (void));
 886 # endif
 887 _GL_CXXALIASWARN (tmpfile);
 888 #elif defined GNULIB_POSIXCHECK
 889 # undef tmpfile
 890 # if HAVE_RAW_DECL_TMPFILE
 891 _GL_WARN_ON_USE (tmpfile, "tmpfile is not usable on mingw - "
 892                  "use gnulib module tmpfile for portability");
 893 # endif
 894 #endif
 895
 896 #if @GNULIB_VASPRINTF@
 897 /* Write formatted output to a string dynamically allocated with malloc().
 898    If the memory allocation succeeds, store the address of the string in
 899    *RESULT and return the number of resulting bytes, excluding the trailing
 900    NUL.  Upon memory allocation error, or some other error, return -1.  */
 901 # if @REPLACE_VASPRINTF@
 902 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 903 #   define asprintf rpl_asprintf
 904 #  endif
 905 _GL_FUNCDECL_RPL (asprintf, int,
 906                   (char **result, const char *format, ...)
 907                   __attribute__ ((__format__ (__printf__, 2, 3)))
 908                   _GL_ARG_NONNULL ((1, 2)));
 909 _GL_CXXALIAS_RPL (asprintf, int,
 910                   (char **result, const char *format, ...));
 911 # else
 912 #  if !@HAVE_VASPRINTF@
 913 _GL_FUNCDECL_SYS (asprintf, int,
 914                   (char **result, const char *format, ...)
 915                   __attribute__ ((__format__ (__printf__, 2, 3)))
 916                   _GL_ARG_NONNULL ((1, 2)));
 917 #  endif
 918 _GL_CXXALIAS_SYS (asprintf, int,
 919                   (char **result, const char *format, ...));
 920 # endif
 921 _GL_CXXALIASWARN (asprintf);
 922 # if @REPLACE_VASPRINTF@
 923 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 924 #   define vasprintf rpl_vasprintf
 925 #  endif
 926 _GL_FUNCDECL_RPL (vasprintf, int,
 927                   (char **result, const char *format, va_list args)
 928                   __attribute__ ((__format__ (__printf__, 2, 0)))
 929                   _GL_ARG_NONNULL ((1, 2)));
 930 _GL_CXXALIAS_RPL (vasprintf, int,
 931                   (char **result, const char *format, va_list args));
 932 # else
 933 #  if !@HAVE_VASPRINTF@
 934 _GL_FUNCDECL_SYS (vasprintf, int,
 935                   (char **result, const char *format, va_list args)
 936                   __attribute__ ((__format__ (__printf__, 2, 0)))
 937                   _GL_ARG_NONNULL ((1, 2)));
 938 #  endif
 939 _GL_CXXALIAS_SYS (vasprintf, int,
 940                   (char **result, const char *format, va_list args));
 941 # endif
 942 _GL_CXXALIASWARN (vasprintf);
 943 #endif
 944
 945 #if @GNULIB_VDPRINTF@
 946 # if @REPLACE_VDPRINTF@
 947 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 948 #   define vdprintf rpl_vdprintf
 949 #  endif
 950 _GL_FUNCDECL_RPL (vdprintf, int, (int fd, const char *format, va_list args)
 951                                  __attribute__ ((__format__ (__printf__, 2, 0)))
 952                                  _GL_ARG_NONNULL ((2)));
 953 _GL_CXXALIAS_RPL (vdprintf, int, (int fd, const char *format, va_list args));
 954 # else
 955 #  if !@HAVE_VDPRINTF@
 956 _GL_FUNCDECL_SYS (vdprintf, int, (int fd, const char *format, va_list args)
 957                                  __attribute__ ((__format__ (__printf__, 2, 0)))
 958                                  _GL_ARG_NONNULL ((2)));
 959 #  endif
 960 /* Need to cast, because on Solaris, the third parameter will likely be
 961                                                     __va_list args.  */
 962 _GL_CXXALIAS_SYS_CAST (vdprintf, int,
 963                        (int fd, const char *format, va_list args));
 964 # endif
 965 _GL_CXXALIASWARN (vdprintf);
 966 #elif defined GNULIB_POSIXCHECK
 967 # undef vdprintf
 968 # if HAVE_RAW_DECL_VDPRINTF
 969 _GL_WARN_ON_USE (vdprintf, "vdprintf is unportable - "
 970                  "use gnulib module vdprintf for portability");
 971 # endif
 972 #endif
 973
 974 #if @GNULIB_VFPRINTF_POSIX@ || @GNULIB_VFPRINTF@
 975 # if (@GNULIB_VFPRINTF_POSIX@ && @REPLACE_VFPRINTF@) \
 976      || (@GNULIB_VFPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@)
 977 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 978 #   define vfprintf rpl_vfprintf
 979 #  endif
 980 #  define GNULIB_overrides_vfprintf 1
 981 _GL_FUNCDECL_RPL (vfprintf, int, (FILE *fp, const char *format, va_list args)
 982                                  __attribute__ ((__format__ (__printf__, 2, 0)))
 983                                  _GL_ARG_NONNULL ((1, 2)));
 984 _GL_CXXALIAS_RPL (vfprintf, int, (FILE *fp, const char *format, va_list args));
 985 # else
 986 /* Need to cast, because on Solaris, the third parameter is
 987                                                       __va_list args
 988    and GCC's fixincludes did not change this to __gnuc_va_list.  */
 989 _GL_CXXALIAS_SYS_CAST (vfprintf, int,
 990                        (FILE *fp, const char *format, va_list args));
 991 # endif
 992 _GL_CXXALIASWARN (vfprintf);
 993 #endif
 994 #if !@GNULIB_VFPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
 995 # if !GNULIB_overrides_vfprintf
 996 #  undef vfprintf
 997 # endif
 998 /* Assume vfprintf is always declared.  */
 999 _GL_WARN_ON_USE (vfprintf, "vfprintf is not always POSIX compliant - "
1000                  "use gnulib module vfprintf-posix for portable "
1001                       "POSIX compliance");
1002 #endif
1003
1004 #if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VPRINTF@
1005 # if (@GNULIB_VPRINTF_POSIX@ && @REPLACE_VPRINTF@) \
1006      || (@GNULIB_VPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@)
1007 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1008 #   define vprintf rpl_vprintf
1009 #  endif
1010 #  define GNULIB_overrides_vprintf 1
1011 _GL_FUNCDECL_RPL (vprintf, int, (const char *format, va_list args)
1012                                 __attribute__ ((__format__ (__printf__, 1, 0)))
1013                                 _GL_ARG_NONNULL ((1)));
1014 _GL_CXXALIAS_RPL (vprintf, int, (const char *format, va_list args));
1015 # else
1016 /* Need to cast, because on Solaris, the second parameter is
1017                                                           __va_list args
1018    and GCC's fixincludes did not change this to __gnuc_va_list.  */
1019 _GL_CXXALIAS_SYS_CAST (vprintf, int, (const char *format, va_list args));
1020 # endif
1021 _GL_CXXALIASWARN (vprintf);
1022 #endif
1023 #if !@GNULIB_VPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
1024 # if !GNULIB_overrides_vprintf
1025 #  undef vprintf
1026 # endif
1027 /* Assume vprintf is always declared.  */
1028 _GL_WARN_ON_USE (vprintf, "vprintf is not always POSIX compliant - "
1029                  "use gnulib module vprintf-posix for portable "
1030                  "POSIX compliance");
1031 #endif
1032
1033 #if @GNULIB_VSNPRINTF@
1034 # if @REPLACE_VSNPRINTF@
1035 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1036 #   define vsnprintf rpl_vsnprintf
1037 #  endif
1038 _GL_FUNCDECL_RPL (vsnprintf, int,
1039                   (char *str, size_t size, const char *format, va_list args)
1040                   __attribute__ ((__format__ (__printf__, 3, 0)))
1041                   _GL_ARG_NONNULL ((3)));
1042 _GL_CXXALIAS_RPL (vsnprintf, int,
1043                   (char *str, size_t size, const char *format, va_list args));
1044 # else
1045 #  if !@HAVE_DECL_VSNPRINTF@
1046 _GL_FUNCDECL_SYS (vsnprintf, int,
1047                   (char *str, size_t size, const char *format, va_list args)
1048                   __attribute__ ((__format__ (__printf__, 3, 0)))
1049                   _GL_ARG_NONNULL ((3)));
1050 #  endif
1051 _GL_CXXALIAS_SYS (vsnprintf, int,
1052                   (char *str, size_t size, const char *format, va_list args));
1053 # endif
1054 _GL_CXXALIASWARN (vsnprintf);
1055 #elif defined GNULIB_POSIXCHECK
1056 # undef vsnprintf
1057 # if HAVE_RAW_DECL_VSNPRINTF
1058 _GL_WARN_ON_USE (vsnprintf, "vsnprintf is unportable - "
1059                  "use gnulib module vsnprintf for portability");
1060 # endif
1061 #endif
1062
1063 #if @GNULIB_VSPRINTF_POSIX@
1064 # if @REPLACE_VSPRINTF@
1065 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1066 #   define vsprintf rpl_vsprintf
1067 #  endif
1068 _GL_FUNCDECL_RPL (vsprintf, int,
1069                   (char *str, const char *format, va_list args)
1070                   __attribute__ ((__format__ (__printf__, 2, 0)))
1071                   _GL_ARG_NONNULL ((1, 2)));
1072 _GL_CXXALIAS_RPL (vsprintf, int,
1073                   (char *str, const char *format, va_list args));
1074 # else
1075 /* Need to cast, because on Solaris, the third parameter is
1076                                                        __va_list args
1077    and GCC's fixincludes did not change this to __gnuc_va_list.  */
1078 _GL_CXXALIAS_SYS_CAST (vsprintf, int,
1079                        (char *str, const char *format, va_list args));
1080 # endif
1081 _GL_CXXALIASWARN (vsprintf);
1082 #elif defined GNULIB_POSIXCHECK
1083 # undef vsprintf
1084 /* Assume vsprintf is always declared.  */
1085 _GL_WARN_ON_USE (vsprintf, "vsprintf is not always POSIX compliant - "
1086                  "use gnulib module vsprintf-posix for portable "
1087                       "POSIX compliance");
1088 #endif
1089
1090
1091 #endif /* _GL_STDIO_H */
1092 #endif /* _GL_STDIO_H */
1093 #endif