pintos-os.org Git - pspp/blob - lib/stdio.in.h

   1 /* A GNU-like <stdio.h>.
   2
   3    Copyright (C) 2004, 2007-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 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
  23 #if defined __need_FILE || defined __need___FILE
  24 /* Special invocation convention inside glibc header files.  */
  25
  26 #@INCLUDE_NEXT@ @NEXT_STDIO_H@
  27
  28 #else
  29 /* Normal invocation convention.  */
  30
  31 #ifndef _GL_STDIO_H
  32
  33 /* The include_next requires a split double-inclusion guard.  */
  34 #@INCLUDE_NEXT@ @NEXT_STDIO_H@
  35
  36 #ifndef _GL_STDIO_H
  37 #define _GL_STDIO_H
  38
  39 /* Get va_list.  Needed on many systems, including glibc 2.8.  */
  40 #include <stdarg.h>
  41
  42 #include <stddef.h>
  43
  44 /* Get off_t and ssize_t.  Needed on many systems, including glibc 2.8.  */
  45 #include <sys/types.h>
  46
  47 #ifndef __attribute__
  48 /* The __attribute__ feature is available in gcc versions 2.5 and later.
  49    The __-protected variants of the attributes 'format' and 'printf' are
  50    accepted by gcc versions 2.6.4 (effectively 2.7) and later.
  51    We enable __attribute__ only if these are supported too, because
  52    gnulib and libintl do '#define printf __printf__' when they override
  53    the 'printf' function.  */
  54 # if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 7)
  55 #  define __attribute__(Spec)   /* empty */
  56 # endif
  57 #endif
  58
  59
  60 /* The definition of _GL_ARG_NONNULL is copied here.  */
  61
  62 /* The definition of _GL_WARN_ON_USE is copied here.  */
  63
  64
  65 #ifdef __cplusplus
  66 extern "C" {
  67 #endif
  68
  69 #if @GNULIB_DPRINTF@
  70 # if @REPLACE_DPRINTF@
  71 #  define dprintf rpl_dprintf
  72 # endif
  73 # if @REPLACE_DPRINTF@ || !@HAVE_DPRINTF@
  74 extern int dprintf (int fd, const char *format, ...)
  75        __attribute__ ((__format__ (__printf__, 2, 3))) _GL_ARG_NONNULL ((2));
  76 # endif
  77 #elif defined GNULIB_POSIXCHECK
  78 # undef dprintf
  79 # if HAVE_RAW_DECL_DPRINTF
  80 _GL_WARN_ON_USE (dprintf, "dprintf is unportable - "
  81                  "use gnulib module dprintf for portability");
  82 # endif
  83 #endif
  84
  85 #if @GNULIB_FCLOSE@
  86 # if @REPLACE_FCLOSE@
  87 #  define fclose rpl_fclose
  88   /* Close STREAM and its underlying file descriptor.  */
  89 extern int fclose (FILE *stream) _GL_ARG_NONNULL ((1));
  90 # endif
  91 #elif defined GNULIB_POSIXCHECK
  92 # undef fclose
  93 /* Assume fclose is always declared.  */
  94 _GL_WARN_ON_USE (fclose, "fclose is not always POSIX compliant - "
  95                  "use gnulib module fclose for portable POSIX compliance");
  96 #endif
  97
  98 #if @GNULIB_FFLUSH@
  99 # if @REPLACE_FFLUSH@
 100 #  define fflush rpl_fflush
 101   /* Flush all pending data on STREAM according to POSIX rules.  Both
 102      output and seekable input streams are supported.
 103      Note! LOSS OF DATA can occur if fflush is applied on an input stream
 104      that is _not_seekable_ or on an update stream that is _not_seekable_
 105      and in which the most recent operation was input.  Seekability can
 106      be tested with lseek(fileno(fp),0,SEEK_CUR).  */
 107   extern int fflush (FILE *gl_stream);
 108 # endif
 109 #elif defined GNULIB_POSIXCHECK
 110 # undef fflush
 111 /* Assume fflush is always declared.  */
 112 _GL_WARN_ON_USE (fflush, "fflush is not always POSIX compliant - "
 113                  "use gnulib module fflush for portable POSIX compliance");
 114 #endif
 115
 116 /* It is very rare that the developer ever has full control of stdin,
 117    so any use of gets warrants an unconditional warning.  Assume it is
 118    always declared, since it is required by C89.  */
 119 #undef gets
 120 _GL_WARN_ON_USE (gets, "gets is a security hole - use fgets instead");
 121
 122 #if @GNULIB_FOPEN@
 123 # if @REPLACE_FOPEN@
 124 #  undef fopen
 125 #  define fopen rpl_fopen
 126 extern FILE * fopen (const char *filename, const char *mode)
 127      _GL_ARG_NONNULL ((1, 2));
 128 # endif
 129 #elif defined GNULIB_POSIXCHECK
 130 # undef fopen
 131 /* Assume fopen is always declared.  */
 132 _GL_WARN_ON_USE (fopen, "fopen on Win32 platforms is not POSIX compatible - "
 133                  "use gnulib module fopen for portability");
 134 #endif
 135
 136 #if @GNULIB_FPRINTF_POSIX@
 137 # if @REPLACE_FPRINTF@
 138 #  define fprintf rpl_fprintf
 139 extern int fprintf (FILE *fp, const char *format, ...)
 140        __attribute__ ((__format__ (__printf__, 2, 3)))
 141        _GL_ARG_NONNULL ((1, 2));
 142 # endif
 143 #elif @GNULIB_FPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 144 # define fprintf rpl_fprintf
 145 extern int fprintf (FILE *fp, const char *format, ...)
 146        __attribute__ ((__format__ (__printf__, 2, 3)))
 147        _GL_ARG_NONNULL ((1, 2));
 148 #elif defined GNULIB_POSIXCHECK
 149 # undef fprintf
 150 /* Assume fprintf is always declared.  */
 151 _GL_WARN_ON_USE (fprintf, "fprintf is not always POSIX compliant - "
 152                  "use gnulib module fprintf-posix for portable "
 153                  "POSIX compliance");
 154 #endif
 155
 156 #if @GNULIB_FPURGE@
 157 # if @REPLACE_FPURGE@
 158 #  define fpurge rpl_fpurge
 159 # endif
 160 # if @REPLACE_FPURGE@ || !@HAVE_DECL_FPURGE@
 161   /* Discard all pending buffered I/O data on STREAM.
 162      STREAM must not be wide-character oriented.
 163      When discarding pending output, the file position is set back to where it
 164      was before the write calls.  When discarding pending input, the file
 165      position is advanced to match the end of the previously read input.
 166      Return 0 if successful.  Upon error, return -1 and set errno.  */
 167   extern int fpurge (FILE *gl_stream) _GL_ARG_NONNULL ((1));
 168 # endif
 169 #elif defined GNULIB_POSIXCHECK
 170 # undef fpurge
 171 # if HAVE_RAW_DECL_FPURGE
 172 _GL_WARN_ON_USE (fpurge, "fpurge is not always present - "
 173                  "use gnulib module fpurge for portability");
 174 # endif
 175 #endif
 176
 177 #if @GNULIB_FPUTC@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 178 # undef fputc
 179 # define fputc rpl_fputc
 180 extern int fputc (int c, FILE *stream) _GL_ARG_NONNULL ((2));
 181 #endif
 182
 183 #if @GNULIB_FPUTS@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 184 # undef fputs
 185 # define fputs rpl_fputs
 186 extern int fputs (const char *string, FILE *stream) _GL_ARG_NONNULL ((1, 2));
 187 #endif
 188
 189 #if @GNULIB_FREOPEN@
 190 # if @REPLACE_FREOPEN@
 191 #  undef freopen
 192 #  define freopen rpl_freopen
 193 extern FILE * freopen (const char *filename, const char *mode, FILE *stream)
 194      _GL_ARG_NONNULL ((2, 3));
 195 # endif
 196 #elif defined GNULIB_POSIXCHECK
 197 # undef freopen
 198 /* Assume freopen is always declared.  */
 199 _GL_WARN_ON_USE (freopen, "freopen on Win32 platforms is not POSIX compatible - "
 200                  "use gnulib module freopen for portability");
 201 #endif
 202
 203 /* Set up the following warnings, based on which modules are in use.
 204    GNU Coding Standards discourage the use of fseek, since it imposes
 205    an arbitrary limitation on some 32-bit hosts.  Remember that the
 206    fseek module depends on the fseeko module, so we only have three
 207    cases to consider:
 208
 209    1. The developer is not using either module.  Issue a warning under
 210    GNULIB_POSIXCHECK for both functions, to remind them that both
 211    functions have bugs on some systems.  _GL_NO_LARGE_FILES has no
 212    impact on this warning.
 213
 214    2. The developer is using both modules.  They may be unaware of the
 215    arbitrary limitations of fseek, so issue a warning under
 216    GNULIB_POSIXCHECK.  On the other hand, they may be using both
 217    modules intentionally, so the developer can define
 218    _GL_NO_LARGE_FILES in the compilation units where the use of fseek
 219    is safe, to silence the warning.
 220
 221    3. The developer is using the fseeko module, but not fseek.  Gnulib
 222    guarantees that fseek will still work around platform bugs in that
 223    case, but we presume that the developer is aware of the pitfalls of
 224    fseek and was trying to avoid it, so issue a warning even when
 225    GNULIB_POSIXCHECK is undefined.  Again, _GL_NO_LARGE_FILES can be
 226    defined to silence the warning in particular compilation units.
 227
 228    Most gnulib clients that perform stream operations should fall into
 229    category three.  */
 230
 231 #if @GNULIB_FSEEK@
 232 # if defined GNULIB_POSIXCHECK && !defined _GL_NO_LARGE_FILES
 233 #  define _GL_FSEEK_WARN /* Category 2, above.  */
 234 #  undef fseek
 235 # endif
 236 # if @REPLACE_FSEEK@
 237 #  undef fseek
 238 #  define fseek rpl_fseek
 239 extern int fseek (FILE *fp, long offset, int whence) _GL_ARG_NONNULL ((1));
 240 # endif
 241 #endif
 242
 243 #if @GNULIB_FSEEKO@
 244 # if !@GNULIB_FSEEK@ && !defined _GL_NO_LARGE_FILES
 245 #  define _GL_FSEEK_WARN /* Category 3, above.  */
 246 #  undef fseek
 247 # endif
 248 # if @REPLACE_FSEEKO@
 249 /* Provide fseek, fseeko functions that are aware of a preceding
 250    fflush(), and which detect pipes.  */
 251 #  undef fseeko
 252 #  define fseeko rpl_fseeko
 253 extern int fseeko (FILE *fp, off_t offset, int whence) _GL_ARG_NONNULL ((1));
 254 #  if !@GNULIB_FSEEK@
 255 #   undef fseek
 256 #   define fseek rpl_fseek
 257 static inline int _GL_ARG_NONNULL ((1))
 258 rpl_fseek (FILE *fp, long offset, int whence)
 259 {
 260   return fseeko (fp, offset, whence);
 261 }
 262 #  endif
 263 # endif
 264 #elif defined GNULIB_POSIXCHECK
 265 # define _GL_FSEEK_WARN /* Category 1, above.  */
 266 # undef fseek
 267 # undef fseeko
 268 # if HAVE_RAW_DECL_FSEEKO
 269 _GL_WARN_ON_USE (fseeko, "fseeko is unportable - "
 270                  "use gnulib module fseeko for portability");
 271 # endif
 272 #endif
 273
 274 #ifdef _GL_FSEEK_WARN
 275 # undef _GL_FSEEK_WARN
 276 /* Here, either fseek is undefined (but C89 guarantees that it is
 277    declared), or it is defined as rpl_fseek (declared above).  */
 278 _GL_WARN_ON_USE (fseek, "fseek cannot handle files larger than 4 GB "
 279                  "on 32-bit platforms - "
 280                  "use fseeko function for handling of large files");
 281 #endif
 282
 283 /* See the comments on fseek/fseeko.  */
 284
 285 #if @GNULIB_FTELL@
 286 # if defined GNULIB_POSIXCHECK && !defined _GL_NO_LARGE_FILES
 287 #  define _GL_FTELL_WARN /* Category 2, above.  */
 288 #  undef ftell
 289 # endif
 290 # if @REPLACE_FTELL@
 291 #  undef ftell
 292 #  define ftell rpl_ftell
 293 extern long ftell (FILE *fp) _GL_ARG_NONNULL ((1));
 294 # endif
 295 #endif
 296
 297 #if @GNULIB_FTELLO@
 298 # if !@GNULIB_FTELL@ && !defined _GL_NO_LARGE_FILES
 299 #  define _GL_FTELL_WARN /* Category 3, above.  */
 300 #  undef ftell
 301 # endif
 302 # if @REPLACE_FTELLO@
 303 #  undef ftello
 304 #  define ftello rpl_ftello
 305 extern off_t ftello (FILE *fp) _GL_ARG_NONNULL ((1));
 306 #  if !@GNULIB_FTELL@
 307 #   undef ftell
 308 #   define ftell rpl_ftell
 309 static inline long _GL_ARG_NONNULL ((1))
 310 rpl_ftell (FILE *f)
 311 {
 312   return ftello (f);
 313 }
 314 #  endif
 315 # endif
 316 #elif defined GNULIB_POSIXCHECK
 317 # define _GL_FTELL_WARN /* Category 1, above.  */
 318 # undef ftell
 319 # undef ftello
 320 # if HAVE_RAW_DECL_FTELLO
 321 _GL_WARN_ON_USE (ftello, "ftello is unportable - "
 322                  "use gnulib module ftello for portability");
 323 # endif
 324 #endif
 325
 326 #ifdef _GL_FTELL_WARN
 327 # undef _GL_FTELL_WARN
 328 /* Here, either ftell is undefined (but C89 guarantees that it is
 329    declared), or it is defined as rpl_ftell (declared above).  */
 330 _GL_WARN_ON_USE (ftell, "ftell cannot handle files larger than 4 GB "
 331                  "on 32-bit platforms - "
 332                  "use ftello function for handling of large files");
 333 #endif
 334
 335 #if @GNULIB_FWRITE@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 336 # undef fwrite
 337 # define fwrite rpl_fwrite
 338 extern size_t fwrite (const void *ptr, size_t s, size_t n, FILE *stream)
 339      _GL_ARG_NONNULL ((1, 4));
 340 #endif
 341
 342 #if @GNULIB_GETDELIM@
 343 # if !@HAVE_DECL_GETDELIM@
 344 /* Read input, up to (and including) the next occurrence of DELIMITER, from
 345    STREAM, store it in *LINEPTR (and NUL-terminate it).
 346    *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
 347    bytes of space.  It is realloc'd as necessary.
 348    Return the number of bytes read and stored at *LINEPTR (not including the
 349    NUL terminator), or -1 on error or EOF.  */
 350 extern ssize_t getdelim (char **lineptr, size_t *linesize, int delimiter,
 351                          FILE *stream)
 352      _GL_ARG_NONNULL ((1, 2, 4));
 353 # endif
 354 #elif defined GNULIB_POSIXCHECK
 355 # undef getdelim
 356 # if HAVE_RAW_DECL_GETDELIM
 357 _GL_WARN_ON_USE (getdelim, "getdelim is unportable - "
 358                  "use gnulib module getdelim for portability");
 359 # endif
 360 #endif
 361
 362 #if @GNULIB_GETLINE@
 363 # if @REPLACE_GETLINE@
 364 #  undef getline
 365 #  define getline rpl_getline
 366 # endif
 367 # if !@HAVE_DECL_GETLINE@ || @REPLACE_GETLINE@
 368 /* Read a line, up to (and including) the next newline, from STREAM, store it
 369    in *LINEPTR (and NUL-terminate it).
 370    *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
 371    bytes of space.  It is realloc'd as necessary.
 372    Return the number of bytes read and stored at *LINEPTR (not including the
 373    NUL terminator), or -1 on error or EOF.  */
 374 extern ssize_t getline (char **lineptr, size_t *linesize, FILE *stream)
 375      _GL_ARG_NONNULL ((1, 2, 3));
 376 # endif
 377 #elif defined GNULIB_POSIXCHECK
 378 # undef getline
 379 # if HAVE_RAW_DECL_GETLINE
 380 _GL_WARN_ON_USE (getline, "getline is unportable - "
 381                  "use gnulib module getline for portability");
 382 # endif
 383 #endif
 384
 385 #if @GNULIB_OBSTACK_PRINTF@
 386 # if @REPLACE_OBSTACK_PRINTF@
 387 #  define obstack_printf rpl_osbtack_printf
 388 #  define obstack_vprintf rpl_obstack_vprintf
 389 # endif
 390 # if @REPLACE_OBSTACK_PRINTF@ || !@HAVE_DECL_OBSTACK_PRINTF@
 391   struct obstack;
 392   /* Grow an obstack with formatted output.  Return the number of
 393      bytes added to OBS.  No trailing nul byte is added, and the
 394      object should be closed with obstack_finish before use.  Upon
 395      memory allocation error, call obstack_alloc_failed_handler.  Upon
 396      other error, return -1.  */
 397   extern int obstack_printf (struct obstack *obs, const char *format, ...)
 398     __attribute__ ((__format__ (__printf__, 2, 3))) _GL_ARG_NONNULL ((1, 2));
 399   extern int obstack_vprintf (struct obstack *obs, const char *format,
 400                               va_list args)
 401     __attribute__ ((__format__ (__printf__, 2, 0))) _GL_ARG_NONNULL ((1, 2));
 402 # endif
 403 #endif
 404
 405 #if @GNULIB_PERROR@
 406 # if @REPLACE_PERROR@
 407 #  define perror rpl_perror
 408 /* Print a message to standard error, describing the value of ERRNO,
 409    (if STRING is not NULL and not empty) prefixed with STRING and ": ",
 410    and terminated with a newline.  */
 411 extern void perror (const char *string);
 412 # endif
 413 #elif defined GNULIB_POSIXCHECK
 414 # undef perror
 415 /* Assume perror is always declared.  */
 416 _GL_WARN_ON_USE (perror, "perror is not always POSIX compliant - "
 417                  "use gnulib module perror for portability");
 418 #endif
 419
 420 #if @GNULIB_POPEN@
 421 # if @REPLACE_POPEN@
 422 #  undef popen
 423 #  define popen rpl_popen
 424 extern FILE *popen (const char *cmd, const char *mode)
 425      _GL_ARG_NONNULL ((1, 2));
 426 # endif
 427 #elif defined GNULIB_POSIXCHECK
 428 # undef popen
 429 # if HAVE_RAW_DECL_POPEN
 430 _GL_WARN_ON_USE (popen, "popen is buggy on some platforms - "
 431                  "use gnulib module popen or pipe for more portability");
 432 # endif
 433 #endif
 434
 435 #if @GNULIB_PRINTF_POSIX@
 436 # if @REPLACE_PRINTF@
 437 /* Don't break __attribute__((format(printf,M,N))).  */
 438 #  define printf __printf__
 439 extern int printf (const char *format, ...)
 440        __attribute__ ((__format__ (__printf__, 1, 2))) _GL_ARG_NONNULL ((1));
 441 # endif
 442 #elif @GNULIB_PRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 443 /* Don't break __attribute__((format(printf,M,N))).  */
 444 # define printf __printf__
 445 extern int printf (const char *format, ...)
 446        __attribute__ ((__format__ (__printf__, 1, 2))) _GL_ARG_NONNULL ((1));
 447 #elif defined GNULIB_POSIXCHECK
 448 # undef printf
 449 /* Assume printf is always declared.  */
 450 _GL_WARN_ON_USE (printf, "printf is not always POSIX compliant - "
 451                  "use gnulib module printf-posix for portable "
 452                  "POSIX compliance");
 453 #endif
 454
 455 #if @GNULIB_PUTC@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 456 # undef putc
 457 # define putc rpl_fputc
 458 extern int putc (int c, FILE *stream) _GL_ARG_NONNULL ((2));
 459 #endif
 460
 461 #if @GNULIB_PUTCHAR@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 462 # undef putchar
 463 # define putchar rpl_putchar
 464 extern int putchar (int c);
 465 #endif
 466
 467 #if @GNULIB_PUTS@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 468 # undef puts
 469 # define puts rpl_puts
 470 extern int puts (const char *string) _GL_ARG_NONNULL ((1));
 471 #endif
 472
 473 #if @GNULIB_REMOVE@
 474 # if @REPLACE_REMOVE@
 475 #  undef remove
 476 #  define remove rpl_remove
 477 extern int remove (const char *name) _GL_ARG_NONNULL ((1));
 478 # endif
 479 #elif defined GNULIB_POSIXCHECK
 480 # undef remove
 481 /* Assume remove is always declared.  */
 482 _GL_WARN_ON_USE (remove, "remove cannot handle directories on some platforms - "
 483                  "use gnulib module remove for more portability");
 484 #endif
 485
 486 #if @GNULIB_RENAME@
 487 # if @REPLACE_RENAME@
 488 #  undef rename
 489 #  define rename rpl_rename
 490 extern int rename (const char *old_filename, const char *new_filename)
 491      _GL_ARG_NONNULL ((1, 2));
 492 # endif
 493 #elif defined GNULIB_POSIXCHECK
 494 # undef rename
 495 /* Assume rename is always declared.  */
 496 _GL_WARN_ON_USE (rename, "rename is buggy on some platforms - "
 497                  "use gnulib module rename for more portability");
 498 #endif
 499
 500 #if @GNULIB_RENAMEAT@
 501 # if @REPLACE_RENAMEAT@
 502 #  undef renameat
 503 #  define renameat rpl_renameat
 504 # endif
 505 # if !@HAVE_RENAMEAT@ || @REPLACE_RENAMEAT@
 506 extern int renameat (int fd1, char const *file1, int fd2, char const *file2)
 507      _GL_ARG_NONNULL ((2, 4));
 508 # endif
 509 #elif defined GNULIB_POSIXCHECK
 510 # undef renameat
 511 # if HAVE_RAW_DECL_RENAMEAT
 512 _GL_WARN_ON_USE (renameat, "renameat is not portable - "
 513                  "use gnulib module renameat for portability");
 514 # endif
 515 #endif
 516
 517 #if @GNULIB_SNPRINTF@
 518 # if @REPLACE_SNPRINTF@
 519 #  define snprintf rpl_snprintf
 520 # endif
 521 # if @REPLACE_SNPRINTF@ || !@HAVE_DECL_SNPRINTF@
 522 extern int snprintf (char *str, size_t size, const char *format, ...)
 523        __attribute__ ((__format__ (__printf__, 3, 4)))
 524        _GL_ARG_NONNULL ((3));
 525 # endif
 526 #elif defined GNULIB_POSIXCHECK
 527 # undef snprintf
 528 # if HAVE_RAW_DECL_SNPRINTF
 529 _GL_WARN_ON_USE (snprintf, "snprintf is unportable - "
 530                  "use gnulib module snprintf for portability");
 531 # endif
 532 #endif
 533
 534 /* Some people would argue that sprintf should be handled like gets
 535    (for example, OpenBSD issues a link warning for both functions),
 536    since both can cause security holes due to buffer overruns.
 537    However, we believe that sprintf can be used safely, and is more
 538    efficient than snprintf in those safe cases; and as proof of our
 539    belief, we use sprintf in several gnulib modules.  So this header
 540    intentionally avoids adding a warning to sprintf except when
 541    GNULIB_POSIXCHECK is defined.  */
 542
 543 #if @GNULIB_SPRINTF_POSIX@
 544 # if @REPLACE_SPRINTF@
 545 #  define sprintf rpl_sprintf
 546 extern int sprintf (char *str, const char *format, ...)
 547        __attribute__ ((__format__ (__printf__, 2, 3)))
 548        _GL_ARG_NONNULL ((1, 2));
 549 # endif
 550 #elif defined GNULIB_POSIXCHECK
 551 # undef sprintf
 552 /* Assume sprintf is always declared.  */
 553 _GL_WARN_ON_USE (sprintf, "sprintf is not always POSIX compliant - "
 554                  "use gnulib module sprintf-posix for portable "
 555                  "POSIX compliance");
 556 #endif
 557
 558 #if @GNULIB_VASPRINTF@
 559 # if @REPLACE_VASPRINTF@
 560 #  define asprintf rpl_asprintf
 561 #  define vasprintf rpl_vasprintf
 562 # endif
 563 # if @REPLACE_VASPRINTF@ || !@HAVE_VASPRINTF@
 564   /* Write formatted output to a string dynamically allocated with malloc().
 565      If the memory allocation succeeds, store the address of the string in
 566      *RESULT and return the number of resulting bytes, excluding the trailing
 567      NUL.  Upon memory allocation error, or some other error, return -1.  */
 568   extern int asprintf (char **result, const char *format, ...)
 569     __attribute__ ((__format__ (__printf__, 2, 3))) _GL_ARG_NONNULL ((1, 2));
 570   extern int vasprintf (char **result, const char *format, va_list args)
 571     __attribute__ ((__format__ (__printf__, 2, 0))) _GL_ARG_NONNULL ((1, 2));
 572 # endif
 573 #endif
 574
 575 #if @GNULIB_VDPRINTF@
 576 # if @REPLACE_VDPRINTF@
 577 #  define vdprintf rpl_vdprintf
 578 # endif
 579 # if @REPLACE_VDPRINTF@ || !@HAVE_VDPRINTF@
 580 extern int vdprintf (int fd, const char *format, va_list args)
 581        __attribute__ ((__format__ (__printf__, 2, 0))) _GL_ARG_NONNULL ((2));
 582 # endif
 583 #elif defined GNULIB_POSIXCHECK
 584 # undef vdprintf
 585 # if HAVE_RAW_DECL_VDPRINTF
 586 _GL_WARN_ON_USE (vdprintf, "vdprintf is unportable - "
 587                  "use gnulib module vdprintf for portability");
 588 # endif
 589 #endif
 590
 591 #if @GNULIB_VFPRINTF_POSIX@
 592 # if @REPLACE_VFPRINTF@
 593 #  define vfprintf rpl_vfprintf
 594 extern int vfprintf (FILE *fp, const char *format, va_list args)
 595        __attribute__ ((__format__ (__printf__, 2, 0)))
 596        _GL_ARG_NONNULL ((1, 2));
 597 # endif
 598 #elif @GNULIB_VFPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 599 # define vfprintf rpl_vfprintf
 600 extern int vfprintf (FILE *fp, const char *format, va_list args)
 601        __attribute__ ((__format__ (__printf__, 2, 0)))
 602        _GL_ARG_NONNULL ((1, 2));
 603 #elif defined GNULIB_POSIXCHECK
 604 # undef vfprintf
 605 /* Assume vfprintf is always declared.  */
 606 _GL_WARN_ON_USE (vfprintf, "vfprintf is not always POSIX compliant - "
 607                  "use gnulib module vfprintf-posix for portable "
 608                       "POSIX compliance");
 609 #endif
 610
 611 #if @GNULIB_VPRINTF_POSIX@
 612 # if @REPLACE_VPRINTF@
 613 #  define vprintf rpl_vprintf
 614 extern int vprintf (const char *format, va_list args)
 615        __attribute__ ((__format__ (__printf__, 1, 0))) _GL_ARG_NONNULL ((1));
 616 # endif
 617 #elif @GNULIB_VPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && @GNULIB_STDIO_H_SIGPIPE@
 618 # define vprintf rpl_vprintf
 619 extern int vprintf (const char *format, va_list args)
 620        __attribute__ ((__format__ (__printf__, 1, 0))) _GL_ARG_NONNULL ((1));
 621 #elif defined GNULIB_POSIXCHECK
 622 # undef vprintf
 623 /* Assume vprintf is always declared.  */
 624 _GL_WARN_ON_USE (vprintf, "vprintf is not always POSIX compliant - "
 625                  "use gnulib module vprintf-posix for portable "
 626                  "POSIX compliance");
 627 #endif
 628
 629 #if @GNULIB_VSNPRINTF@
 630 # if @REPLACE_VSNPRINTF@
 631 #  define vsnprintf rpl_vsnprintf
 632 # endif
 633 # if @REPLACE_VSNPRINTF@ || !@HAVE_DECL_VSNPRINTF@
 634 extern int vsnprintf (char *str, size_t size, const char *format, va_list args)
 635        __attribute__ ((__format__ (__printf__, 3, 0)))
 636        _GL_ARG_NONNULL ((3));
 637 # endif
 638 #elif defined GNULIB_POSIXCHECK
 639 # undef vsnprintf
 640 # if HAVE_RAW_DECL_VSNPRINTF
 641 _GL_WARN_ON_USE (vsnprintf, "vsnprintf is unportable - "
 642                  "use gnulib module vsnprintf for portability");
 643 # endif
 644 #endif
 645
 646 #if @GNULIB_VSPRINTF_POSIX@
 647 # if @REPLACE_VSPRINTF@
 648 #  define vsprintf rpl_vsprintf
 649 extern int vsprintf (char *str, const char *format, va_list args)
 650        __attribute__ ((__format__ (__printf__, 2, 0)))
 651        _GL_ARG_NONNULL ((1, 2));
 652 # endif
 653 #elif defined GNULIB_POSIXCHECK
 654 # undef vsprintf
 655 /* Assume vsprintf is always declared.  */
 656 _GL_WARN_ON_USE (vsprintf, "vsprintf is not always POSIX compliant - "
 657                  "use gnulib module vsprintf-posix for portable "
 658                       "POSIX compliance");
 659 #endif
 660
 661 #ifdef __cplusplus
 662 }
 663 #endif
 664
 665 #endif /* _GL_STDIO_H */
 666 #endif /* _GL_STDIO_H */
 667 #endif