include/stdio.h

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