libio/stdio.h

   1 /* Define ISO C stdio on top of C++ iostreams.
   2    Copyright (C) 1991,1994-2004, 2005 Free Software Foundation, Inc.
   3    This file is part of the GNU C Library.
   4
   5    The GNU C Library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Lesser General Public
   7    License as published by the Free Software Foundation; either
   8    version 2.1 of the License, or (at your option) any later version.
   9
  10    The GNU C Library 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 GNU
  13    Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public
  16    License along with the GNU C Library; if not, write to the Free
  17    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  18    02111-1307 USA.  */
  19
  20 /*
  21  *      ISO C99 Standard: 7.19 Input/output     <stdio.h>
  22  */
  23
  24 #ifndef _STDIO_H
  25
  26 #if !defined __need_FILE && !defined __need___FILE
  27 # define _STDIO_H       1
  28 # include <features.h>
  29
  30 __BEGIN_DECLS
  31
  32 # define __need_size_t
  33 # define __need_NULL
  34 # include <stddef.h>
  35
  36 # include <bits/types.h>
  37 # define __need_FILE
  38 # define __need___FILE
  39 #endif /* Don't need FILE.  */
  40
  41
  42 #if !defined __FILE_defined && defined __need_FILE
  43
  44 __BEGIN_NAMESPACE_STD
  45 /* The opaque type of streams.  This is the definition used elsewhere.  */
  46 typedef struct _IO_FILE FILE;
  47 __END_NAMESPACE_STD
  48 #if defined __USE_LARGEFILE64 || defined __USE_SVID || defined __USE_POSIX \
  49     || defined __USE_BSD || defined __USE_ISOC99 || defined __USE_XOPEN \
  50     || defined __USE_POSIX2
  51 __USING_NAMESPACE_STD(FILE)
  52 #endif
  53
  54 # define __FILE_defined 1
  55 #endif /* FILE not defined.  */
  56 #undef  __need_FILE
  57
  58
  59 #if !defined ____FILE_defined && defined __need___FILE
  60
  61 /* The opaque type of streams.  This is the definition used elsewhere.  */
  62 typedef struct _IO_FILE __FILE;
  63
  64 # define ____FILE_defined       1
  65 #endif /* __FILE not defined.  */
  66 #undef  __need___FILE
  67
  68
  69 #ifdef  _STDIO_H
  70 #define _STDIO_USES_IOSTREAM
  71
  72 #include <libio.h>
  73
  74 #ifdef __USE_XOPEN
  75 # ifdef __GNUC__
  76 #  ifndef _VA_LIST_DEFINED
  77 typedef _G_va_list va_list;
  78 #   define _VA_LIST_DEFINED
  79 #  endif
  80 # else
  81 #  include <stdarg.h>
  82 # endif
  83 #endif
  84
  85 /* The type of the second argument to `fgetpos' and `fsetpos'.  */
  86 __BEGIN_NAMESPACE_STD
  87 #ifndef __USE_FILE_OFFSET64
  88 typedef _G_fpos_t fpos_t;
  89 #else
  90 typedef _G_fpos64_t fpos_t;
  91 #endif
  92 __END_NAMESPACE_STD
  93 #ifdef __USE_LARGEFILE64
  94 typedef _G_fpos64_t fpos64_t;
  95 #endif
  96
  97 /* The possibilities for the third argument to `setvbuf'.  */
  98 #define _IOFBF 0                /* Fully buffered.  */
  99 #define _IOLBF 1                /* Line buffered.  */
 100 #define _IONBF 2                /* No buffering.  */
 101
 102
 103 /* Default buffer size.  */
 104 #ifndef BUFSIZ
 105 # define BUFSIZ _IO_BUFSIZ
 106 #endif
 107
 108
 109 /* End of file character.
 110    Some things throughout the library rely on this being -1.  */
 111 #ifndef EOF
 112 # define EOF (-1)
 113 #endif
 114
 115
 116 /* The possibilities for the third argument to `fseek'.
 117    These values should not be changed.  */
 118 #define SEEK_SET        0       /* Seek from beginning of file.  */
 119 #define SEEK_CUR        1       /* Seek from current position.  */
 120 #define SEEK_END        2       /* Seek from end of file.  */
 121
 122
 123 #if defined __USE_SVID || defined __USE_XOPEN
 124 /* Default path prefix for `tempnam' and `tmpnam'.  */
 125 # define P_tmpdir       "/tmp"
 126 #endif
 127
 128
 129 /* Get the values:
 130    L_tmpnam     How long an array of chars must be to be passed to `tmpnam'.
 131    TMP_MAX      The minimum number of unique filenames generated by tmpnam
 132                 (and tempnam when it uses tmpnam's name space),
 133                 or tempnam (the two are separate).
 134    L_ctermid    How long an array to pass to `ctermid'.
 135    L_cuserid    How long an array to pass to `cuserid'.
 136    FOPEN_MAX    Minimum number of files that can be open at once.
 137    FILENAME_MAX Maximum length of a filename.  */
 138 #include <bits/stdio_lim.h>
 139
 140
 141 /* Standard streams.  */
 142 extern struct _IO_FILE *stdin;          /* Standard input stream.  */
 143 extern struct _IO_FILE *stdout;         /* Standard output stream.  */
 144 extern struct _IO_FILE *stderr;         /* Standard error output stream.  */
 145 /* C89/C99 say they're macros.  Make them happy.  */
 146 #define stdin stdin
 147 #define stdout stdout
 148 #define stderr stderr
 149
 150 __BEGIN_NAMESPACE_STD
 151 /* Remove file FILENAME.  */
 152 extern int remove (__const char *__filename) __THROW;
 153 /* Rename file OLD to NEW.  */
 154 extern int rename (__const char *__old, __const char *__new) __THROW;
 155 __END_NAMESPACE_STD
 156
 157 #ifdef __USE_GNU
 158 /* Rename file OLD relative to OLDFD to NEW relative to NEWFD.  */
 159 extern int renameat (int __oldfd, __const char *__old, int __newfd,
 160                      __const char *__new) __THROW;
 161 #endif
 162
 163 __BEGIN_NAMESPACE_STD
 164 /* Create a temporary file and open it read/write.
 165
 166    This function is a possible cancellation points and therefore not
 167    marked with __THROW.  */
 168 #ifndef __USE_FILE_OFFSET64
 169 extern FILE *tmpfile (void);
 170 #else
 171 # ifdef __REDIRECT
 172 extern FILE *__REDIRECT (tmpfile, (void), tmpfile64);
 173 # else
 174 #  define tmpfile tmpfile64
 175 # endif
 176 #endif
 177
 178 #ifdef __USE_LARGEFILE64
 179 extern FILE *tmpfile64 (void);
 180 #endif
 181
 182 /* Generate a temporary filename.  */
 183 extern char *tmpnam (char *__s) __THROW;
 184 __END_NAMESPACE_STD
 185
 186 #ifdef __USE_MISC
 187 /* This is the reentrant variant of `tmpnam'.  The only difference is
 188    that it does not allow S to be NULL.  */
 189 extern char *tmpnam_r (char *__s) __THROW;
 190 #endif
 191
 192
 193 #if defined __USE_SVID || defined __USE_XOPEN
 194 /* Generate a unique temporary filename using up to five characters of PFX
 195    if it is not NULL.  The directory to put this file in is searched for
 196    as follows: First the environment variable "TMPDIR" is checked.
 197    If it contains the name of a writable directory, that directory is used.
 198    If not and if DIR is not NULL, that value is checked.  If that fails,
 199    P_tmpdir is tried and finally "/tmp".  The storage for the filename
 200    is allocated by `malloc'.  */
 201 extern char *tempnam (__const char *__dir, __const char *__pfx)
 202      __THROW __attribute_malloc__;
 203 #endif
 204
 205
 206 __BEGIN_NAMESPACE_STD
 207 /* Close STREAM.
 208
 209    This function is a possible cancellation point and therefore not
 210    marked with __THROW.  */
 211 extern int fclose (FILE *__stream);
 212 /* Flush STREAM, or all streams if STREAM is NULL.
 213
 214    This function is a possible cancellation point and therefore not
 215    marked with __THROW.  */
 216 extern int fflush (FILE *__stream);
 217 __END_NAMESPACE_STD
 218
 219 #ifdef __USE_MISC
 220 /* Faster versions when locking is not required.
 221
 222    This function is not part of POSIX and therefore no official
 223    cancellation point.  But due to similarity with an POSIX interface
 224    or due to the implementation it is a cancellation point and
 225    therefore not marked with __THROW.  */
 226 extern int fflush_unlocked (FILE *__stream);
 227 #endif
 228
 229 #ifdef __USE_GNU
 230 /* Close all streams.
 231
 232    This function is not part of POSIX and therefore no official
 233    cancellation point.  But due to similarity with an POSIX interface
 234    or due to the implementation it is a cancellation point and
 235    therefore not marked with __THROW.  */
 236 extern int fcloseall (void);
 237 #endif
 238
 239
 240 __BEGIN_NAMESPACE_STD
 241 #ifndef __USE_FILE_OFFSET64
 242 /* Open a file and create a new stream for it.
 243
 244    This function is a possible cancellation point and therefore not
 245    marked with __THROW.  */
 246 extern FILE *fopen (__const char *__restrict __filename,
 247                     __const char *__restrict __modes);
 248 /* Open a file, replacing an existing stream with it.
 249
 250    This function is a possible cancellation point and therefore not
 251    marked with __THROW.  */
 252 extern FILE *freopen (__const char *__restrict __filename,
 253                       __const char *__restrict __modes,
 254                       FILE *__restrict __stream);
 255 #else
 256 # ifdef __REDIRECT
 257 extern FILE *__REDIRECT (fopen, (__const char *__restrict __filename,
 258                                  __const char *__restrict __modes), fopen64);
 259 extern FILE *__REDIRECT (freopen, (__const char *__restrict __filename,
 260                                    __const char *__restrict __modes,
 261                                    FILE *__restrict __stream), freopen64);
 262 # else
 263 #  define fopen fopen64
 264 #  define freopen freopen64
 265 # endif
 266 #endif
 267 __END_NAMESPACE_STD
 268 #ifdef __USE_LARGEFILE64
 269 extern FILE *fopen64 (__const char *__restrict __filename,
 270                       __const char *__restrict __modes);
 271 extern FILE *freopen64 (__const char *__restrict __filename,
 272                         __const char *__restrict __modes,
 273                         FILE *__restrict __stream);
 274 #endif
 275
 276 #ifdef  __USE_POSIX
 277 /* Create a new stream that refers to an existing system file descriptor.  */
 278 extern FILE *fdopen (int __fd, __const char *__modes) __THROW;
 279 #endif
 280
 281 #ifdef  __USE_GNU
 282 /* Create a new stream that refers to the given magic cookie,
 283    and uses the given functions for input and output.  */
 284 extern FILE *fopencookie (void *__restrict __magic_cookie,
 285                           __const char *__restrict __modes,
 286                           _IO_cookie_io_functions_t __io_funcs) __THROW;
 287
 288 /* Create a new stream that refers to a memory buffer.  */
 289 extern FILE *fmemopen (void *__s, size_t __len, __const char *__modes) __THROW;
 290
 291 /* Open a stream that writes into a malloc'd buffer that is expanded as
 292    necessary.  *BUFLOC and *SIZELOC are updated with the buffer's location
 293    and the number of characters written on fflush or fclose.  */
 294 extern FILE *open_memstream (char **__restrict __bufloc,
 295                              size_t *__restrict __sizeloc) __THROW;
 296 #endif
 297
 298
 299 __BEGIN_NAMESPACE_STD
 300 /* If BUF is NULL, make STREAM unbuffered.
 301    Else make it use buffer BUF, of size BUFSIZ.  */
 302 extern void setbuf (FILE *__restrict __stream, char *__restrict __buf) __THROW;
 303 /* Make STREAM use buffering mode MODE.
 304    If BUF is not NULL, use N bytes of it for buffering;
 305    else allocate an internal buffer N bytes long.  */
 306 extern int setvbuf (FILE *__restrict __stream, char *__restrict __buf,
 307                     int __modes, size_t __n) __THROW;
 308 __END_NAMESPACE_STD
 309
 310 #ifdef  __USE_BSD
 311 /* If BUF is NULL, make STREAM unbuffered.
 312    Else make it use SIZE bytes of BUF for buffering.  */
 313 extern void setbuffer (FILE *__restrict __stream, char *__restrict __buf,
 314                        size_t __size) __THROW;
 315
 316 /* Make STREAM line-buffered.  */
 317 extern void setlinebuf (FILE *__stream) __THROW;
 318 #endif
 319
 320
 321 __BEGIN_NAMESPACE_STD
 322 /* Write formatted output to STREAM.
 323
 324    This function is a possible cancellation point and therefore not
 325    marked with __THROW.  */
 326 extern int fprintf (FILE *__restrict __stream,
 327                     __const char *__restrict __format, ...);
 328 /* Write formatted output to stdout.
 329
 330    This function is a possible cancellation point and therefore not
 331    marked with __THROW.  */
 332 extern int printf (__const char *__restrict __format, ...);
 333 /* Write formatted output to S.  */
 334 extern int sprintf (char *__restrict __s,
 335                     __const char *__restrict __format, ...) __THROW;
 336
 337 /* Write formatted output to S from argument list ARG.
 338
 339    This function is a possible cancellation point and therefore not
 340    marked with __THROW.  */
 341 extern int vfprintf (FILE *__restrict __s, __const char *__restrict __format,
 342                      _G_va_list __arg);
 343 /* Write formatted output to stdout from argument list ARG.
 344
 345    This function is a possible cancellation point and therefore not
 346    marked with __THROW.  */
 347 extern int vprintf (__const char *__restrict __format, _G_va_list __arg);
 348 /* Write formatted output to S from argument list ARG.  */
 349 extern int vsprintf (char *__restrict __s, __const char *__restrict __format,
 350                      _G_va_list __arg) __THROW;
 351 __END_NAMESPACE_STD
 352
 353 #if defined __USE_BSD || defined __USE_ISOC99 || defined __USE_UNIX98
 354 __BEGIN_NAMESPACE_C99
 355 /* Maximum chars of output to write in MAXLEN.  */
 356 extern int snprintf (char *__restrict __s, size_t __maxlen,
 357                      __const char *__restrict __format, ...)
 358      __THROW __attribute__ ((__format__ (__printf__, 3, 4)));
 359
 360 extern int vsnprintf (char *__restrict __s, size_t __maxlen,
 361                       __const char *__restrict __format, _G_va_list __arg)
 362      __THROW __attribute__ ((__format__ (__printf__, 3, 0)));
 363 __END_NAMESPACE_C99
 364 #endif
 365
 366 #ifdef __USE_GNU
 367 /* Write formatted output to a string dynamically allocated with `malloc'.
 368    Store the address of the string in *PTR.  */
 369 extern int vasprintf (char **__restrict __ptr, __const char *__restrict __f,
 370                       _G_va_list __arg)
 371      __THROW __attribute__ ((__format__ (__printf__, 2, 0)));
 372 extern int __asprintf (char **__restrict __ptr,
 373                        __const char *__restrict __fmt, ...)
 374      __THROW __attribute__ ((__format__ (__printf__, 2, 3)));
 375 extern int asprintf (char **__restrict __ptr,
 376                      __const char *__restrict __fmt, ...)
 377      __THROW __attribute__ ((__format__ (__printf__, 2, 3)));
 378
 379 /* Write formatted output to a file descriptor.
 380
 381    These functions are not part of POSIX and therefore no official
 382    cancellation point.  But due to similarity with an POSIX interface
 383    or due to the implementation they are cancellation points and
 384    therefore not marked with __THROW.  */
 385 extern int vdprintf (int __fd, __const char *__restrict __fmt,
 386                      _G_va_list __arg)
 387      __attribute__ ((__format__ (__printf__, 2, 0)));
 388 extern int dprintf (int __fd, __const char *__restrict __fmt, ...)
 389      __attribute__ ((__format__ (__printf__, 2, 3)));
 390 #endif
 391
 392
 393 __BEGIN_NAMESPACE_STD
 394 /* Read formatted input from STREAM.
 395
 396    This function is a possible cancellation point and therefore not
 397    marked with __THROW.  */
 398 extern int fscanf (FILE *__restrict __stream,
 399                    __const char *__restrict __format, ...) __wur;
 400 /* Read formatted input from stdin.
 401
 402    This function is a possible cancellation point and therefore not
 403    marked with __THROW.  */
 404 extern int scanf (__const char *__restrict __format, ...) __wur;
 405 /* Read formatted input from S.  */
 406 extern int sscanf (__const char *__restrict __s,
 407                    __const char *__restrict __format, ...) __THROW;
 408 __END_NAMESPACE_STD
 409
 410 #ifdef  __USE_ISOC99
 411 __BEGIN_NAMESPACE_C99
 412 /* Read formatted input from S into argument list ARG.
 413
 414    This function is a possible cancellation point and therefore not
 415    marked with __THROW.  */
 416 extern int vfscanf (FILE *__restrict __s, __const char *__restrict __format,
 417                     _G_va_list __arg)
 418      __attribute__ ((__format__ (__scanf__, 2, 0))) __wur;
 419
 420 /* Read formatted input from stdin into argument list ARG.
 421
 422    This function is a possible cancellation point and therefore not
 423    marked with __THROW.  */
 424 extern int vscanf (__const char *__restrict __format, _G_va_list __arg)
 425      __attribute__ ((__format__ (__scanf__, 1, 0))) __wur;
 426
 427 /* Read formatted input from S into argument list ARG.  */
 428 extern int vsscanf (__const char *__restrict __s,
 429                     __const char *__restrict __format, _G_va_list __arg)
 430      __THROW __attribute__ ((__format__ (__scanf__, 2, 0)));
 431 __END_NAMESPACE_C99
 432 #endif /* Use ISO C9x.  */
 433
 434
 435 __BEGIN_NAMESPACE_STD
 436 /* Read a character from STREAM.
 437
 438    These functions are possible cancellation points and therefore not
 439    marked with __THROW.  */
 440 extern int fgetc (FILE *__stream);
 441 extern int getc (FILE *__stream);
 442
 443 /* Read a character from stdin.
 444
 445    This function is a possible cancellation point and therefore not
 446    marked with __THROW.  */
 447 extern int getchar (void);
 448 __END_NAMESPACE_STD
 449
 450 /* The C standard explicitly says this is a macro, so we always do the
 451    optimization for it.  */
 452 #define getc(_fp) _IO_getc (_fp)
 453
 454 #if defined __USE_POSIX || defined __USE_MISC
 455 /* These are defined in POSIX.1:1996.
 456
 457    These functions are possible cancellation points and therefore not
 458    marked with __THROW.  */
 459 extern int getc_unlocked (FILE *__stream);
 460 extern int getchar_unlocked (void);
 461 #endif /* Use POSIX or MISC.  */
 462
 463 #ifdef __USE_MISC
 464 /* Faster version when locking is not necessary.
 465
 466    This function is not part of POSIX and therefore no official
 467    cancellation point.  But due to similarity with an POSIX interface
 468    or due to the implementation it is a cancellation point and
 469    therefore not marked with __THROW.  */
 470 extern int fgetc_unlocked (FILE *__stream);
 471 #endif /* Use MISC.  */
 472
 473
 474 __BEGIN_NAMESPACE_STD
 475 /* Write a character to STREAM.
 476
 477    These functions are possible cancellation points and therefore not
 478    marked with __THROW.
 479
 480    These functions is a possible cancellation point and therefore not
 481    marked with __THROW.  */
 482 extern int fputc (int __c, FILE *__stream);
 483 extern int putc (int __c, FILE *__stream);
 484
 485 /* Write a character to stdout.
 486
 487    This function is a possible cancellation point and therefore not
 488    marked with __THROW.  */
 489 extern int putchar (int __c);
 490 __END_NAMESPACE_STD
 491
 492 /* The C standard explicitly says this can be a macro,
 493    so we always do the optimization for it.  */
 494 #define putc(_ch, _fp) _IO_putc (_ch, _fp)
 495
 496 #ifdef __USE_MISC
 497 /* Faster version when locking is not necessary.
 498
 499    This function is not part of POSIX and therefore no official
 500    cancellation point.  But due to similarity with an POSIX interface
 501    or due to the implementation it is a cancellation point and
 502    therefore not marked with __THROW.  */
 503 extern int fputc_unlocked (int __c, FILE *__stream);
 504 #endif /* Use MISC.  */
 505
 506 #if defined __USE_POSIX || defined __USE_MISC
 507 /* These are defined in POSIX.1:1996.
 508
 509    These functions are possible cancellation points and therefore not
 510    marked with __THROW.  */
 511 extern int putc_unlocked (int __c, FILE *__stream);
 512 extern int putchar_unlocked (int __c);
 513 #endif /* Use POSIX or MISC.  */
 514
 515
 516 #if defined __USE_SVID || defined __USE_MISC \
 517     || (defined __USE_XOPEN && !defined __USE_XOPEN2K)
 518 /* Get a word (int) from STREAM.  */
 519 extern int getw (FILE *__stream);
 520
 521 /* Write a word (int) to STREAM.  */
 522 extern int putw (int __w, FILE *__stream);
 523 #endif
 524
 525
 526 __BEGIN_NAMESPACE_STD
 527 /* Get a newline-terminated string of finite length from STREAM.
 528
 529    This function is a possible cancellation point and therefore not
 530    marked with __THROW.  */
 531 extern char *fgets (char *__restrict __s, int __n, FILE *__restrict __stream)
 532      __wur;
 533
 534 /* Get a newline-terminated string from stdin, removing the newline.
 535    DO NOT USE THIS FUNCTION!!  There is no limit on how much it will read.
 536
 537    This function is a possible cancellation point and therefore not
 538    marked with __THROW.  */
 539 extern char *gets (char *__s) __wur;
 540 __END_NAMESPACE_STD
 541
 542 #ifdef __USE_GNU
 543 /* This function does the same as `fgets' but does not lock the stream.
 544
 545    This function is not part of POSIX and therefore no official
 546    cancellation point.  But due to similarity with an POSIX interface
 547    or due to the implementation it is a cancellation point and
 548    therefore not marked with __THROW.  */
 549 extern char *fgets_unlocked (char *__restrict __s, int __n,
 550                              FILE *__restrict __stream) __wur;
 551 #endif
 552
 553
 554 #ifdef  __USE_GNU
 555 /* Read up to (and including) a DELIMITER from STREAM into *LINEPTR
 556    (and null-terminate it). *LINEPTR is a pointer returned from malloc (or
 557    NULL), pointing to *N characters of space.  It is realloc'd as
 558    necessary.  Returns the number of characters read (not including the
 559    null terminator), or -1 on error or EOF.
 560
 561    These functions are not part of POSIX and therefore no official
 562    cancellation point.  But due to similarity with an POSIX interface
 563    or due to the implementation they are cancellation points and
 564    therefore not marked with __THROW.  */
 565 extern _IO_ssize_t __getdelim (char **__restrict __lineptr,
 566                                size_t *__restrict __n, int __delimiter,
 567                                FILE *__restrict __stream) __wur;
 568 extern _IO_ssize_t getdelim (char **__restrict __lineptr,
 569                              size_t *__restrict __n, int __delimiter,
 570                              FILE *__restrict __stream) __wur;
 571
 572 /* Like `getdelim', but reads up to a newline.
 573
 574    This function is not part of POSIX and therefore no official
 575    cancellation point.  But due to similarity with an POSIX interface
 576    or due to the implementation it is a cancellation point and
 577    therefore not marked with __THROW.  */
 578 extern _IO_ssize_t getline (char **__restrict __lineptr,
 579                             size_t *__restrict __n,
 580                             FILE *__restrict __stream) __wur;
 581 #endif
 582
 583
 584 __BEGIN_NAMESPACE_STD
 585 /* Write a string to STREAM.
 586
 587    This function is a possible cancellation points and therefore not
 588    marked with __THROW.  */
 589 extern int fputs (__const char *__restrict __s, FILE *__restrict __stream);
 590
 591 /* Write a string, followed by a newline, to stdout.
 592
 593    This function is a possible cancellation points and therefore not
 594    marked with __THROW.  */
 595 extern int puts (__const char *__s);
 596
 597
 598 /* Push a character back onto the input buffer of STREAM.
 599
 600    This function is a possible cancellation points and therefore not
 601    marked with __THROW.  */
 602 extern int ungetc (int __c, FILE *__stream);
 603
 604
 605 /* Read chunks of generic data from STREAM.
 606
 607    This function is a possible cancellation points and therefore not
 608    marked with __THROW.  */
 609 extern size_t fread (void *__restrict __ptr, size_t __size,
 610                      size_t __n, FILE *__restrict __stream) __wur;
 611 /* Write chunks of generic data to STREAM.
 612
 613    This function is a possible cancellation points and therefore not
 614    marked with __THROW.  */
 615 extern size_t fwrite (__const void *__restrict __ptr, size_t __size,
 616                       size_t __n, FILE *__restrict __s) __wur;
 617 __END_NAMESPACE_STD
 618
 619 #ifdef __USE_GNU
 620 /* This function does the same as `fputs' but does not lock the stream.
 621
 622    This function is not part of POSIX and therefore no official
 623    cancellation point.  But due to similarity with an POSIX interface
 624    or due to the implementation it is a cancellation point and
 625    therefore not marked with __THROW.  */
 626 extern int fputs_unlocked (__const char *__restrict __s,
 627                            FILE *__restrict __stream);
 628 #endif
 629
 630 #ifdef __USE_MISC
 631 /* Faster versions when locking is not necessary.
 632
 633    These functions are not part of POSIX and therefore no official
 634    cancellation point.  But due to similarity with an POSIX interface
 635    or due to the implementation they are cancellation points and
 636    therefore not marked with __THROW.  */
 637 extern size_t fread_unlocked (void *__restrict __ptr, size_t __size,
 638                               size_t __n, FILE *__restrict __stream) __wur;
 639 extern size_t fwrite_unlocked (__const void *__restrict __ptr, size_t __size,
 640                                size_t __n, FILE *__restrict __stream) __wur;
 641 #endif
 642
 643
 644 __BEGIN_NAMESPACE_STD
 645 /* Seek to a certain position on STREAM.
 646
 647    This function is a possible cancellation point and therefore not
 648    marked with __THROW.  */
 649 extern int fseek (FILE *__stream, long int __off, int __whence);
 650 /* Return the current position of STREAM.
 651
 652    This function is a possible cancellation point and therefore not
 653    marked with __THROW.  */
 654 extern long int ftell (FILE *__stream) __wur;
 655 /* Rewind to the beginning of STREAM.
 656
 657    This function is a possible cancellation point and therefore not
 658    marked with __THROW.  */
 659 extern void rewind (FILE *__stream);
 660 __END_NAMESPACE_STD
 661
 662 /* The Single Unix Specification, Version 2, specifies an alternative,
 663    more adequate interface for the two functions above which deal with
 664    file offset.  `long int' is not the right type.  These definitions
 665    are originally defined in the Large File Support API.  */
 666
 667 #if defined __USE_LARGEFILE || defined __USE_XOPEN2K
 668 # ifndef __USE_FILE_OFFSET64
 669 /* Seek to a certain position on STREAM.
 670
 671    This function is a possible cancellation point and therefore not
 672    marked with __THROW.  */
 673 extern int fseeko (FILE *__stream, __off_t __off, int __whence);
 674 /* Return the current position of STREAM.
 675
 676    This function is a possible cancellation point and therefore not
 677    marked with __THROW.  */
 678 extern __off_t ftello (FILE *__stream) __wur;
 679 # else
 680 #  ifdef __REDIRECT
 681 extern int __REDIRECT (fseeko,
 682                        (FILE *__stream, __off64_t __off, int __whence),
 683                        fseeko64);
 684 extern __off64_t __REDIRECT (ftello, (FILE *__stream), ftello64);
 685 #  else
 686 #   define fseeko fseeko64
 687 #   define ftello ftello64
 688 #  endif
 689 # endif
 690 #endif
 691
 692 __BEGIN_NAMESPACE_STD
 693 #ifndef __USE_FILE_OFFSET64
 694 /* Get STREAM's position.
 695
 696    This function is a possible cancellation point and therefore not
 697    marked with __THROW.  */
 698 extern int fgetpos (FILE *__restrict __stream, fpos_t *__restrict __pos);
 699 /* Set STREAM's position.
 700
 701    This function is a possible cancellation point and therefore not
 702    marked with __THROW.  */
 703 extern int fsetpos (FILE *__stream, __const fpos_t *__pos);
 704 #else
 705 # ifdef __REDIRECT
 706 extern int __REDIRECT (fgetpos, (FILE *__restrict __stream,
 707                                  fpos_t *__restrict __pos), fgetpos64);
 708 extern int __REDIRECT (fsetpos,
 709                        (FILE *__stream, __const fpos_t *__pos), fsetpos64);
 710 # else
 711 #  define fgetpos fgetpos64
 712 #  define fsetpos fsetpos64
 713 # endif
 714 #endif
 715 __END_NAMESPACE_STD
 716
 717 #ifdef __USE_LARGEFILE64
 718 extern int fseeko64 (FILE *__stream, __off64_t __off, int __whence);
 719 extern __off64_t ftello64 (FILE *__stream) __wur;
 720 extern int fgetpos64 (FILE *__restrict __stream, fpos64_t *__restrict __pos);
 721 extern int fsetpos64 (FILE *__stream, __const fpos64_t *__pos);
 722 #endif
 723
 724 __BEGIN_NAMESPACE_STD
 725 /* Clear the error and EOF indicators for STREAM.  */
 726 extern void clearerr (FILE *__stream) __THROW;
 727 /* Return the EOF indicator for STREAM.  */
 728 extern int feof (FILE *__stream) __THROW __wur;
 729 /* Return the error indicator for STREAM.  */
 730 extern int ferror (FILE *__stream) __THROW __wur;
 731 __END_NAMESPACE_STD
 732
 733 #ifdef __USE_MISC
 734 /* Faster versions when locking is not required.  */
 735 extern void clearerr_unlocked (FILE *__stream) __THROW;
 736 extern int feof_unlocked (FILE *__stream) __THROW __wur;
 737 extern int ferror_unlocked (FILE *__stream) __THROW __wur;
 738 #endif
 739
 740
 741 __BEGIN_NAMESPACE_STD
 742 /* Print a message describing the meaning of the value of errno.
 743
 744    This function is a possible cancellation point and therefore not
 745    marked with __THROW.  */
 746 extern void perror (__const char *__s);
 747 __END_NAMESPACE_STD
 748
 749 /* Provide the declarations for `sys_errlist' and `sys_nerr' if they
 750    are available on this system.  Even if available, these variables
 751    should not be used directly.  The `strerror' function provides
 752    all the necessary functionality.  */
 753 #include <bits/sys_errlist.h>
 754
 755
 756 #ifdef  __USE_POSIX
 757 /* Return the system file descriptor for STREAM.  */
 758 extern int fileno (FILE *__stream) __THROW __wur;
 759 #endif /* Use POSIX.  */
 760
 761 #ifdef __USE_MISC
 762 /* Faster version when locking is not required.  */
 763 extern int fileno_unlocked (FILE *__stream) __THROW __wur;
 764 #endif
 765
 766
 767 #if (defined __USE_POSIX2 || defined __USE_SVID  || defined __USE_BSD || \
 768      defined __USE_MISC)
 769 /* Create a new stream connected to a pipe running the given command.
 770
 771    This function is a possible cancellation point and therefore not
 772    marked with __THROW.  */
 773 extern FILE *popen (__const char *__command, __const char *__modes) __wur;
 774
 775 /* Close a stream opened by popen and return the status of its child.
 776
 777    This function is a possible cancellation point and therefore not
 778    marked with __THROW.  */
 779 extern int pclose (FILE *__stream);
 780 #endif
 781
 782
 783 #ifdef  __USE_POSIX
 784 /* Return the name of the controlling terminal.  */
 785 extern char *ctermid (char *__s) __THROW;
 786 #endif /* Use POSIX.  */
 787
 788
 789 #ifdef __USE_XOPEN
 790 /* Return the name of the current user.  */
 791 extern char *cuserid (char *__s);
 792 #endif /* Use X/Open, but not issue 6.  */
 793
 794
 795 #ifdef  __USE_GNU
 796 struct obstack;                 /* See <obstack.h>.  */
 797
 798 /* Write formatted output to an obstack.  */
 799 extern int obstack_printf (struct obstack *__restrict __obstack,
 800                            __const char *__restrict __format, ...)
 801      __THROW __attribute__ ((__format__ (__printf__, 2, 3)));
 802 extern int obstack_vprintf (struct obstack *__restrict __obstack,
 803                             __const char *__restrict __format,
 804                             _G_va_list __args)
 805      __THROW __attribute__ ((__format__ (__printf__, 2, 0)));
 806 #endif /* Use GNU.  */
 807
 808
 809 #if defined __USE_POSIX || defined __USE_MISC
 810 /* These are defined in POSIX.1:1996.  */
 811
 812 /* Acquire ownership of STREAM.  */
 813 extern void flockfile (FILE *__stream) __THROW;
 814
 815 /* Try to acquire ownership of STREAM but do not block if it is not
 816    possible.  */
 817 extern int ftrylockfile (FILE *__stream) __THROW __wur;
 818
 819 /* Relinquish the ownership granted for STREAM.  */
 820 extern void funlockfile (FILE *__stream) __THROW;
 821 #endif /* POSIX || misc */
 822
 823 #if defined __USE_XOPEN && !defined __USE_XOPEN2K && !defined __USE_GNU
 824 /* The X/Open standard requires some functions and variables to be
 825    declared here which do not belong into this header.  But we have to
 826    follow.  In GNU mode we don't do this nonsense.  */
 827 # define __need_getopt
 828 # include <getopt.h>
 829 #endif  /* X/Open, but not issue 6 and not for GNU.  */
 830
 831 /* If we are compiling with optimizing read this file.  It contains
 832    several optimizing inline functions and macros.  */
 833 #ifdef __USE_EXTERN_INLINES
 834 # include <bits/stdio.h>
 835 #endif
 836 #if __USE_FORTIFY_LEVEL > 0 && !defined __cplusplus
 837 # include <bits/stdio2.h>
 838 #endif
 839
 840 __END_DECLS
 841
 842 #endif /* <stdio.h> included.  */
 843
 844 #endif /* !_STDIO_H */