[uclibc-ng.git] / include / stdio.h

/* Define ISO C stdio on top of C++ iostreams.
   Copyright (C) 1991, 1994-1999, 2000 Free Software Foundation, Inc.

   The GNU C Library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public License as
   published by the Free Software Foundation; either version 2 of the
   License, or (at your option) any later version.

   The GNU C Library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with the GNU C Library; see the file COPYING.LIB.  If not,
   write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.  */

/*
 *	ISO C Standard: 4.9 INPUT/OUTPUT	<stdio.h>
 */

#ifndef _STDIO_H
#define _STDIO_H

#include <features.h>
#include <stdarg.h>
#include <sys/types.h>

__BEGIN_DECLS


/* when you add or change fields here, be sure to change the initialization
 * in stdio_init and fopen */
struct __stdio_file {
  unsigned char *bufpos;   /* the next byte to write to or read from */
  unsigned char *bufread;  /* the end of data returned by last read() */
  unsigned char *bufwrite; /* 1 + highest address writable by macro */
  unsigned char *bufstart; /* the start of the buffer */
  unsigned char *bufend;   /* the end of the buffer; ie the byte after the last
                              malloc()ed byte */
  struct __stdio_file * next;

  int fd; /* the file descriptor associated with the stream */

  unsigned char mode;
  unsigned char ungot;
  char unbuf[2];	   /* The buffer for 'unbuffered' streams */
};

typedef struct __stdio_file FILE;

/* Default buffer size.  */
#define BUFSIZ	    (512)

/* Define EOF and NULL */
#define EOF	(-1)
#ifndef NULL
#define NULL	(0)
#endif

/* The possibilities for the third argument to `setvbuf'.  */
#define _IOFBF 0 		/* Fully buffered.  */
#define _IOLBF 1		/* Line buffered.  */
#define _IONBF 2		/* No buffering.  */

/* Possible states for a file stream -- internal use only */
#define __MODE_BUF		0x03	/* Modal buffering dependent on isatty */
#define __MODE_FREEBUF	0x04	/* Buffer allocated by stdio code, can free */
#define __MODE_FREEFIL	0x08	/* FILE allocated by stdio code, can free */
#define __MODE_UNGOT	0x10	/* Buffer has been polluted by ungetc */
#define __MODE_TIED 	0x20	/* FILE is tied with stdin/stdout */
#define __MODE_EOF		0x40	/* EOF status */
#define __MODE_ERR		0x80	/* Error status */

/* The possibilities for the third argument to `fseek'.
   These values should not be changed.  */
#define SEEK_SET	0	/* Seek from beginning of file.  */
#define SEEK_CUR	1	/* Seek from current position.  */
#define SEEK_END	2	/* Seek from end of file.  */

/* Default path prefix for `tempnam' and `tmpnam'.  */
#define P_tmpdir	"/tmp"
/* Get the values:
   L_tmpnam	How long an array of chars must be to be passed to `tmpnam'.
   TMP_MAX	The minimum number of unique filenames generated by tmpnam
   		(and tempnam when it uses tmpnam's name space),
		or tempnam (the two are separate).
   L_ctermid	How long an array to pass to `ctermid'.
   L_cuserid	How long an array to pass to `cuserid'.
   FOPEN_MAX	Minimum number of files that can be open at once.
   FILENAME_MAX	Maximum length of a filename.  */
#define __need_FOPEN_MAX
#include <bits/stdio_lim.h>
#undef __need_FOPEN_MAX

/* Standard streams (internal).  */
extern FILE *_stdin;
extern FILE *_stdout;
extern FILE *_stderr;

/* C89/C99 say they're macros.  Make them happy.  */
#define stdin  _stdin
#define stdout _stdout
#define stderr _stderr

/* Remove file FILENAME.  */
extern int remove __P ((__const char *__filename));
/* Rename file OLD to NEW.  */
extern int rename __P ((__const char *__old, __const char *__new));


/* Create a temporary file and open it read/write.  */
extern FILE *tmpfile __P ((void));
#ifdef __USE_LARGEFILE64
extern FILE *tmpfile64 __P ((void));
#endif
/* Generate a temporary filename.  */
extern char *tmpnam __P ((char *__s));

#ifdef __USE_MISC
/* This is the reentrant variant of `tmpnam'.  The only difference is
   that it does not allow S to be NULL.  */
extern char *tmpnam_r __P ((char *__s));
#endif


#if defined __USE_SVID || defined __USE_XOPEN
/* Generate a unique temporary filename using up to five characters of PFX
   if it is not NULL.  The directory to put this file in is searched for
   as follows: First the environment variable "TMPDIR" is checked.
   If it contains the name of a writable directory, that directory is used.
   If not and if DIR is not NULL, that value is checked.  If that fails,
   P_tmpdir is tried and finally "/tmp".  The storage for the filename
   is allocated by `malloc'.  */
extern char *tempnam __P ((__const char *__dir, __const char *__pfx));
#endif


/* Close STREAM.  */
extern int fclose __P ((FILE *__stream));
/* Flush STREAM, or all streams if STREAM is NULL.  */
extern int fflush __P ((FILE *__stream));

/* Used internally to actuall open files */
extern FILE *__fopen __P((__const char *__restrict __filename, int __fd, 
	    FILE *__restrict __stream, __const char *__restrict __mode));
/* Open a file and create a new stream for it.  */
extern FILE *fopen __P ((__const char *__restrict __filename,
			 __const char *__restrict __mode));
#define fopen(__file, __mode)         __fopen((__file), -1, (FILE*)0, (__mode))
/* Open a file, replacing an existing stream with it. */
extern FILE *freopen __P ((__const char *__restrict __filename,
			   __const char *__restrict __mode,
			   FILE *__restrict __stream));

#ifdef __USE_MISC
/*
 * Open a file using an automatically (stack) or statically allocated FILE.
 * The FILE * returned behaves just as any other FILE * with respect to the
 * stdio functions, but be aware of the following:
 * NOTE: The buffer used for the file is FILE's builtin 2-byte buffer, so
 *       setting a new buffer is probably advisable.
 * NOTE: This function is primarily intended to be used for stack-allocated
 *       FILEs when uClibc stdio has been built with no dynamic memory support.
 *       For the statically allocated case, it is probably better to increase
 *        the value of FIXED_STREAMS in stdio.c.
 * WARNING: If allocated on the stack, make sure you call fclose before the
 *          stack memory is reclaimed!
 */
extern FILE *fsfopen __P ((__const char *__restrict __filename,
			   __const char *__restrict __mode,
			   FILE *__restrict __stream));
#endif


#ifdef __USE_LARGEFILE64
extern FILE *fopen64 __P ((__const char *__restrict __filename,
			   __const char *__restrict __mode));
extern FILE *freopen64 __P ((__const char *__restrict __filename,
			     __const char *__restrict __mode,
			     FILE *__restrict __stream));
#endif

#ifdef	__USE_POSIX
/* Create a new stream that refers to an existing system file descriptor.  */
extern FILE *fdopen __P ((int __fd, __const char *__mode));
#define fdopen(__file, __mode)  __fopen((char*)0, (__file), (FILE*)0, (__mode))
#endif


/* Make STREAM use buffering mode MODE.
   If BUF is not NULL, use N bytes of it for buffering;
   else allocate an internal buffer N bytes long.  */
extern int setvbuf __P ((FILE *__restrict __stream, char *__restrict __buf,
			 int __mode, size_t __n));

/* If BUF is NULL, make STREAM unbuffered.
   Else make it use buffer BUF, of size BUFSIZ.  */
extern void setbuf __P ((FILE *__restrict __stream, char *__restrict __buf));

#ifdef	__USE_BSD
/* If BUF is NULL, make STREAM unbuffered.
   Else make it use SIZE bytes of BUF for buffering.  */
extern void setbuffer __P ((FILE *__restrict __stream, char *__restrict __buf,
			    size_t __size));

/* Make STREAM line-buffered.  */
extern void setlinebuf __P ((FILE *__stream));
#endif


/* Write formatted output to STREAM.  */
extern int fprintf __P ((FILE *__restrict __stream,
			 __const char *__restrict __format, ...));
/* Write formatted output to stdout.  */
extern int printf __P ((__const char *__restrict __format, ...));
/* Write formatted output to S.  */
extern int sprintf __P ((char *__restrict __s,
			 __const char *__restrict __format, ...));

/* Write formatted output to a file descriptor */
extern int vdprintf __P((int fd, __const char *__restrict __format,
						 va_list __arg));

/* Write formatted output to a buffer S dynamically allocated by asprintf.  */
extern int asprintf __P ((char **__restrict __s,
			 __const char *__restrict __format, ...));

/* Write formatted output to S from argument list ARG.  */
extern int vfprintf __P ((FILE *__restrict __s,
			  __const char *__restrict __format,
			  va_list __arg));
/* Write formatted output to stdout from argument list ARG.  */
extern int vprintf __P ((__const char *__restrict __format,
			 va_list __arg));
/* Write formatted output to S from argument list ARG.  */
extern int vsprintf __P ((char *__restrict __s,
			  __const char *__restrict __format,
			  va_list __arg));

/* Maximum chars of output to write in MAXLEN.  */
extern int snprintf __P ((char *__restrict __s, size_t __maxlen,
			  __const char *__restrict __format, ...))
     __attribute__ ((__format__ (__printf__, 3, 4)));

extern int __vsnprintf __P ((char *__restrict __s, size_t __maxlen,
			     __const char *__restrict __format,
			     va_list __arg))
     __attribute__ ((__format__ (__printf__, 3, 0)));
extern int vsnprintf __P ((char *__restrict __s, size_t __maxlen,
			   __const char *__restrict __format,
			   va_list __arg))
     __attribute__ ((__format__ (__printf__, 3, 0)));

/* Read formatted input from STREAM.  */
extern int fscanf __P ((FILE *__restrict __stream,
			__const char *__restrict __format, ...));
/* Read formatted input from stdin.  */
extern int scanf __P ((__const char *__restrict __format, ...));
/* Read formatted input from S.  */
extern int sscanf __P ((__const char *__restrict __s,
			__const char *__restrict __format, ...));

/* Read formatted input from S into argument list ARG.  */
extern int vfscanf __P ((FILE *__restrict __s,
			 __const char *__restrict __format,
			 va_list __arg))
     __attribute__ ((__format__ (__scanf__, 2, 0)));

/* Read formatted input from stdin into argument list ARG.  */
extern int vscanf __P ((__const char *__restrict __format, va_list __arg))
     __attribute__ ((__format__ (__scanf__, 1, 0)));

/* Read formatted input from S into argument list ARG.  */
extern int vsscanf __P ((__const char *__restrict __s,
			 __const char *__restrict __format,
			 va_list __arg))
     __attribute__ ((__format__ (__scanf__, 2, 0)));


/* Read a character from STREAM.  */
extern int fgetc __P ((FILE *__stream));
extern int getc __P ((FILE *__stream));

/* Read a character from stdin.  */
extern int getchar __P ((void));
#define getchar() getc(_stdin)

/* The C standard explicitly says this is a macro, so be that way */
#define getc(stream)	\
  (((stream)->bufpos >= (stream)->bufread) ? fgetc(stream):		\
    (*(stream)->bufpos++))

/* Write a character to STREAM.  */
extern int fputc __P ((int __c, FILE *__stream));
extern int putc __P ((int __c, FILE *__stream));

/* Write a character to stdout.  */
extern int putchar __P ((int __c));
/* Beware! stdout can be redefined! */
#define putchar(c) putc((c), _stdout)

/* The C standard explicitly says this can be a macro, so be that way */
#define putc(c, stream)	\
    (((stream)->bufpos >= (stream)->bufwrite) ? fputc((c), (stream))	\
                          : (unsigned char) (*(stream)->bufpos++ = (c))	)

#if defined __USE_SVID || defined __USE_MISC || defined __USE_XOPEN
/* Get a word (int) from STREAM.  */
extern int getw __P ((FILE *__stream));

/* Write a word (int) to STREAM.  */
extern int putw __P ((int __w, FILE *__stream));
#endif


/* Get a newline-terminated string of finite length from STREAM.  */
extern char *fgets __P ((char *__restrict __s, int __n,
			 FILE *__restrict __stream));

/* Get a newline-terminated string from stdin, removing the newline.
   DO NOT USE THIS FUNCTION!!  There is no limit on how much it will read.  */
extern char *gets __P ((char *__s));


#ifdef __USE_GNU
/* Read up to (and including) a DELIMITER from STREAM into *LINEPTR
   (and null-terminate it). *LINEPTR is a pointer returned from malloc (or
   NULL), pointing to *N characters of space.  It is realloc'd as
   necessary.  Returns the number of characters read (not including the
   null terminator), or -1 on error or EOF.  */
extern ssize_t __getdelim __P ((char **__restrict __lineptr,
				    size_t *__restrict __n, int __delimiter,
				    FILE *__restrict __stream));
extern ssize_t getdelim __P ((char **__restrict __lineptr,
				  size_t *__restrict __n, int __delimiter,
				  FILE *__restrict __stream));

/* Like `getdelim', but reads up to a newline.  */
extern ssize_t getline __P ((char **__restrict __lineptr,
				 size_t *__restrict __n,
				 FILE *__restrict __stream));
#endif


/* Write a string to STREAM.  */
extern int fputs __P ((__const char *__restrict __s,
		       FILE *__restrict __stream));

/* Write a string, followed by a newline, to stdout.  */
extern int puts __P ((__const char *__s));


/* Push a character back onto the input buffer of STREAM.  */
extern int ungetc __P ((int __c, FILE *__stream));


/* Read chunks of generic data from STREAM.  */
extern size_t fread __P ((void *__restrict __ptr, size_t __size,
			  size_t __n, FILE *__restrict __stream));
/* Write chunks of generic data to STREAM.  */
extern size_t fwrite __P ((__const void *__restrict __ptr, size_t __size,
			   size_t __n, FILE *__restrict __s));

/* Rewind to the beginning of STREAM.  */
extern void rewind __P ((FILE *__stream));

/* Seek to a certain position on STREAM.  */
extern int fseek __P ((FILE *__stream, long int __off, int __whence));
/* Return the current position of STREAM.  */
extern long int ftell __P ((FILE *__stream));

/* The Single Unix Specification, Version 2, specifies an alternative,
   more adequate interface for the two functions above which deal with
   file offset.  `long int' is not the right type.  These definitions
   are originally defined in the Large File Support API.  */

/* Types needed in these functions.  */
#ifndef off_t
typedef __off_t off_t;
# define off_t off_t
#endif

#if defined __USE_LARGEFILE64 && !defined off64_t
typedef __off64_t off64_t;
# define off64_t off64_t
#endif

#ifndef fpos_t
typedef off_t fpos_t;
#define fpos_t fpos_t
#endif

/* Seek to a certain position on STREAM.  */
extern int fsetpos __P((FILE *__stream, __const fpos_t *__pos));
/* Return the current position of STREAM.  */
extern int fgetpos __P((FILE *__stream, fpos_t *__pos));

/* Clear the error and EOF indicators for STREAM.  */
extern void clearerr __P ((FILE *__stream));
/* Return the EOF indicator for STREAM.  */
extern int feof __P ((FILE *__stream));
/* Return the error indicator for STREAM.  */
extern int ferror __P ((FILE *__stream));

/* Macro versions of the 3 previous functions */
/* If fp is NULL... */
#define clearerr(fp) ((fp)->mode &= ~(__MODE_EOF|__MODE_ERR), (void)0)
#define feof(fp)   	((fp)->mode&__MODE_EOF)
#define ferror(fp)	((fp)->mode&__MODE_ERR)

/* Print a message describing the meaning of the value of errno.  */
extern void perror __P ((__const char *__s));

/* These variables normally should not be used directly.  The `strerror'
   function provides all the needed functionality.  */
extern int sys_nerr;
extern __const char *__const sys_errlist[];

#ifdef	__USE_POSIX
/* Return the system file descriptor for STREAM.  */
extern int fileno __P ((FILE *__stream));
/* Only use the macro below if you know fp is a valid FILE for a valid fd. */
#define __fileno(fp)	((fp)->fd)
#endif /* Use POSIX.  */

#if (defined __USE_POSIX2 || defined __USE_SVID  || defined __USE_BSD || \
     defined __USE_MISC)
/* Create a new stream connected to a pipe running the given command.  */
extern FILE *popen __P ((__const char *__command, __const char *__mode));

/* Close a stream opened by popen and return the status of its child.  */
extern int pclose __P ((FILE *__stream));
#endif


#ifdef	__USE_POSIX
/* Return the name of the controlling terminal.  */
extern char *ctermid __P ((char *__s));
#endif /* Use POSIX.  */


#ifdef __USE_XOPEN
/* Return the name of the current user.  */
extern char *cuserid __P ((char *__s));
#endif /* Use X/Open.  */


#if defined __USE_POSIX || defined __USE_MISC
/* These are defined in POSIX.1:1996.  */

/* Acquire ownership of STREAM.  */
extern void flockfile __P ((FILE *__stream));

/* Try to acquire ownership of STREAM but do not block if it is not
   possible.  */
extern int ftrylockfile __P ((FILE *__stream));

/* Relinquish the ownership granted for STREAM.  */
extern void funlockfile __P ((FILE *__stream));
#endif /* POSIX || misc */

#if defined __USE_XOPEN && !defined __USE_GNU
/* The X/Open standard requires some functions and variables to be
   declared here which do not belong into this header.  But we have to
   follow.  In GNU mode we don't do this nonsense.  */
# define __need_getopt
# include <getopt.h>
#endif

/* If we are compiling with optimizing read this file.  It contains
   several optizing inline functions and macros.  */
#ifdef __USE_EXTERN_INLINES
# include <bits/stdio.h>
#endif

__END_DECLS

#endif /* !_STDIO_H */
Commit	Line	Data
afa40ade EA	1	/* Define ISO C stdio on top of C++ iostreams.
afa40ade EA	2	Copyright (C) 1991, 1994-1999, 2000 Free Software Foundation, Inc.
64bc6412	3
afa40ade EA	4	The GNU C Library is free software; you can redistribute it and/or
	5	modify it under the terms of the GNU Library General Public License as
	6	published by the Free Software Foundation; either version 2 of the
	7	License, or (at your option) any later version.
64bc6412	8
afa40ade EA	9	The GNU C Library is distributed in the hope that it will be useful,
	10	but WITHOUT ANY WARRANTY; without even the implied warranty of
	11	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	12	Library General Public License for more details.
64bc6412	13
afa40ade EA	14	You should have received a copy of the GNU Library General Public
	15	License along with the GNU C Library; see the file COPYING.LIB. If not,
	16	write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
	17	Boston, MA 02111-1307, USA. */
64bc6412	18
afa40ade EA	19	/*
	20	* ISO C Standard: 4.9 INPUT/OUTPUT <stdio.h>
	21	*/
64bc6412	22
afa40ade EA	23	#ifndef _STDIO_H
afa40ade EA	24	#define _STDIO_H
64bc6412	25
afa40ade EA	26	#include <features.h>
	27	#include <stdarg.h>
	28	#include <sys/types.h>
64bc6412	29
afa40ade	30	__BEGIN_DECLS
64bc6412	31
64bc6412 EA	32
	33	/* when you add or change fields here, be sure to change the initialization
	34	* in stdio_init and fopen */
	35	struct __stdio_file {
	36	unsigned char bufpos; / the next byte to write to or read from */
	37	unsigned char bufread; / the end of data returned by last read() */
82dd793f	38	unsigned char bufwrite; / 1 + highest address writable by macro */
64bc6412 EA	39	unsigned char bufstart; / the start of the buffer */
	40	unsigned char bufend; / the end of the buffer; ie the byte after the last
	41	malloc()ed byte */
82dd793f	42	struct __stdio_file * next;
64bc6412 EA	43
64bc6412 EA	44	int fd; /* the file descriptor associated with the stream */
d521275a	45
82dd793f MNI	46	unsigned char mode;
	47	unsigned char ungot;
	48	char unbuf[2]; /* The buffer for 'unbuffered' streams */
64bc6412 EA	49	};
64bc6412 EA	50
afa40ade EA	51	typedef struct __stdio_file FILE;
	52
	53	/* Default buffer size. */
0c827cb7	54	#define BUFSIZ (512)
afa40ade EA	55
afa40ade EA	56	/* Define EOF and NULL */
64bc6412 EA	57	#define EOF (-1)
	58	#ifndef NULL
	59	#define NULL (0)
	60	#endif
	61
afa40ade EA	62	/* The possibilities for the third argument to `setvbuf'. */
	63	#define _IOFBF 0 /* Fully buffered. */
	64	#define _IOLBF 1 /* Line buffered. */
	65	#define _IONBF 2 /* No buffering. */
	66
	67	/* Possible states for a file stream -- internal use only */
82dd793f MNI	68	#define __MODE_BUF 0x03 /* Modal buffering dependent on isatty */
	69	#define __MODE_FREEBUF 0x04 /* Buffer allocated by stdio code, can free */
	70	#define __MODE_FREEFIL 0x08 /* FILE allocated by stdio code, can free */
	71	#define __MODE_UNGOT 0x10 /* Buffer has been polluted by ungetc */
	72	#define __MODE_TIED 0x20 /* FILE is tied with stdin/stdout */
	73	#define __MODE_EOF 0x40 /* EOF status */
	74	#define __MODE_ERR 0x80 /* Error status */
64bc6412	75
afa40ade EA	76	/* The possibilities for the third argument to `fseek'.
	77	These values should not be changed. */
	78	#define SEEK_SET 0 /* Seek from beginning of file. */
	79	#define SEEK_CUR 1 /* Seek from current position. */
	80	#define SEEK_END 2 /* Seek from end of file. */
64bc6412	81
afa40ade EA	82	/* Default path prefix for `tempnam' and `tmpnam'. */
	83	#define P_tmpdir "/tmp"
	84	/* Get the values:
	85	L_tmpnam How long an array of chars must be to be passed to `tmpnam'.
	86	TMP_MAX The minimum number of unique filenames generated by tmpnam
	87	(and tempnam when it uses tmpnam's name space),
	88	or tempnam (the two are separate).
	89	L_ctermid How long an array to pass to `ctermid'.
	90	L_cuserid How long an array to pass to `cuserid'.
	91	FOPEN_MAX Minimum number of files that can be open at once.
	92	FILENAME_MAX Maximum length of a filename. */
	93	#define __need_FOPEN_MAX
	94	#include <bits/stdio_lim.h>
	95	#undef __need_FOPEN_MAX
64bc6412	96
ae97a89e	97	/* Standard streams (internal). */
bd0ff62e MNI	98	extern FILE *_stdin;
	99	extern FILE *_stdout;
	100	extern FILE *_stderr;
	101
afa40ade	102	/* C89/C99 say they're macros. Make them happy. */
bd0ff62e MNI	103	#define stdin _stdin
	104	#define stdout _stdout
	105	#define stderr _stderr
64bc6412	106
afa40ade EA	107	/* Remove file FILENAME. */
	108	extern int remove __P ((__const char *__filename));
	109	/* Rename file OLD to NEW. */
	110	extern int rename __P ((__const char __old, __const char __new));
64bc6412	111
64bc6412	112
afa40ade EA	113	/* Create a temporary file and open it read/write. */
	114	extern FILE *tmpfile __P ((void));
	115	#ifdef __USE_LARGEFILE64
	116	extern FILE *tmpfile64 __P ((void));
	117	#endif
	118	/* Generate a temporary filename. */
	119	extern char tmpnam __P ((char __s));
	120
	121	#ifdef __USE_MISC
	122	/* This is the reentrant variant of `tmpnam'. The only difference is
	123	that it does not allow S to be NULL. */
	124	extern char tmpnam_r __P ((char __s));
	125	#endif
	126
	127
	128	#if defined __USE_SVID \|\| defined __USE_XOPEN
	129	/* Generate a unique temporary filename using up to five characters of PFX
	130	if it is not NULL. The directory to put this file in is searched for
	131	as follows: First the environment variable "TMPDIR" is checked.
	132	If it contains the name of a writable directory, that directory is used.
	133	If not and if DIR is not NULL, that value is checked. If that fails,
	134	P_tmpdir is tried and finally "/tmp". The storage for the filename
	135	is allocated by `malloc'. */
	136	extern char tempnam __P ((__const char __dir, __const char *__pfx));
	137	#endif
42ee0791	138
42ee0791 EA	139
	140	/* Close STREAM. */
	141	extern int fclose __P ((FILE *__stream));
	142	/* Flush STREAM, or all streams if STREAM is NULL. */
	143	extern int fflush __P ((FILE *__stream));
	144
afa40ade	145	/* Used internally to actuall open files */
42ee0791	146	extern FILE __fopen __P((__const char __restrict __filename, int __fd,
d521275a MNI	147	FILE __restrict __stream, __const char __restrict __mode));
	148	/* Open a file and create a new stream for it. */
	149	extern FILE fopen __P ((__const char __restrict __filename,
	150	__const char *__restrict __mode));
64bc6412	151	#define fopen(__file, __mode) __fopen((__file), -1, (FILE*)0, (__mode))
42ee0791	152	/* Open a file, replacing an existing stream with it. */
afa40ade	153	extern FILE freopen __P ((__const char __restrict __filename,
d521275a	154	__const char *__restrict __mode,
afa40ade	155	FILE *__restrict __stream));
82dd793f MNI	156
	157	#ifdef __USE_MISC
	158	/*
	159	* Open a file using an automatically (stack) or statically allocated FILE.
	160	* The FILE * returned behaves just as any other FILE * with respect to the
	161	* stdio functions, but be aware of the following:
	162	* NOTE: The buffer used for the file is FILE's builtin 2-byte buffer, so
	163	* setting a new buffer is probably advisable.
	164	* NOTE: This function is primarily intended to be used for stack-allocated
	165	* FILEs when uClibc stdio has been built with no dynamic memory support.
	166	* For the statically allocated case, it is probably better to increase
	167	* the value of FIXED_STREAMS in stdio.c.
	168	* WARNING: If allocated on the stack, make sure you call fclose before the
	169	* stack memory is reclaimed!
	170	*/
	171	extern FILE fsfopen __P ((__const char __restrict __filename,
	172	__const char *__restrict __mode,
	173	FILE *__restrict __stream));
	174	#endif
	175
afa40ade EA	176
	177	#ifdef __USE_LARGEFILE64
	178	extern FILE fopen64 __P ((__const char __restrict __filename,
d521275a	179	__const char *__restrict __mode));
afa40ade	180	extern FILE freopen64 __P ((__const char __restrict __filename,
d521275a	181	__const char *__restrict __mode,
afa40ade EA	182	FILE *__restrict __stream));
	183	#endif
	184
	185	#ifdef __USE_POSIX
42ee0791	186	/* Create a new stream that refers to an existing system file descriptor. */
d521275a	187	extern FILE fdopen __P ((int __fd, __const char __mode));
64bc6412	188	#define fdopen(__file, __mode) __fopen((char)0, (__file), (FILE)0, (__mode))
afa40ade	189	#endif
64bc6412	190
64bc6412	191
afa40ade EA	192	/* Make STREAM use buffering mode MODE.
	193	If BUF is not NULL, use N bytes of it for buffering;
	194	else allocate an internal buffer N bytes long. */
	195	extern int setvbuf __P ((FILE __restrict __stream, char __restrict __buf,
d521275a MNI	196	int __mode, size_t __n));
	197
	198	/* If BUF is NULL, make STREAM unbuffered.
	199	Else make it use buffer BUF, of size BUFSIZ. */
	200	extern void setbuf __P ((FILE __restrict __stream, char __restrict __buf));
42ee0791	201
afa40ade EA	202	#ifdef __USE_BSD
	203	/* If BUF is NULL, make STREAM unbuffered.
	204	Else make it use SIZE bytes of BUF for buffering. */
	205	extern void setbuffer __P ((FILE __restrict __stream, char __restrict __buf,
	206	size_t __size));
	207
	208	/* Make STREAM line-buffered. */
	209	extern void setlinebuf __P ((FILE *__stream));
afa40ade	210	#endif
42ee0791 EA	211
42ee0791 EA	212
42ee0791 EA	213	/* Write formatted output to STREAM. */
	214	extern int fprintf __P ((FILE *__restrict __stream,
	215	__const char *__restrict __format, ...));
afa40ade EA	216	/* Write formatted output to stdout. */
afa40ade EA	217	extern int printf __P ((__const char *__restrict __format, ...));
42ee0791 EA	218	/* Write formatted output to S. */
	219	extern int sprintf __P ((char *__restrict __s,
	220	__const char *__restrict __format, ...));
	221
bd0ff62e MNI	222	/* Write formatted output to a file descriptor */
	223	extern int vdprintf __P((int fd, __const char *__restrict __format,
	224	va_list __arg));
	225
fdfb85cb MNI	226	/* Write formatted output to a buffer S dynamically allocated by asprintf. */
	227	extern int asprintf __P ((char **__restrict __s,
	228	__const char *__restrict __format, ...));
	229
42ee0791 EA	230	/* Write formatted output to S from argument list ARG. */
	231	extern int vfprintf __P ((FILE *__restrict __s,
	232	__const char *__restrict __format,
	233	va_list __arg));
afa40ade EA	234	/* Write formatted output to stdout from argument list ARG. */
	235	extern int vprintf __P ((__const char *__restrict __format,
	236	va_list __arg));
42ee0791 EA	237	/* Write formatted output to S from argument list ARG. */
	238	extern int vsprintf __P ((char *__restrict __s,
	239	__const char *__restrict __format,
	240	va_list __arg));
afa40ade	241
84866232 EA	242	/* Maximum chars of output to write in MAXLEN. */
	243	extern int snprintf __P ((char *__restrict __s, size_t __maxlen,
	244	__const char *__restrict __format, ...))
	245	__attribute__ ((__format__ (__printf__, 3, 4)));
afa40ade EA	246
	247	extern int __vsnprintf __P ((char *__restrict __s, size_t __maxlen,
	248	__const char *__restrict __format,
	249	va_list __arg))
	250	__attribute__ ((__format__ (__printf__, 3, 0)));
84866232 EA	251	extern int vsnprintf __P ((char *__restrict __s, size_t __maxlen,
	252	__const char *__restrict __format,
	253	va_list __arg))
	254	__attribute__ ((__format__ (__printf__, 3, 0)));
42ee0791	255
afa40ade EA	256	/* Read formatted input from STREAM. */
	257	extern int fscanf __P ((FILE *__restrict __stream,
	258	__const char *__restrict __format, ...));
42ee0791 EA	259	/* Read formatted input from stdin. */
	260	extern int scanf __P ((__const char *__restrict __format, ...));
	261	/* Read formatted input from S. */
	262	extern int sscanf __P ((__const char *__restrict __s,
	263	__const char *__restrict __format, ...));
afa40ade	264
42ee0791	265	/* Read formatted input from S into argument list ARG. */
afa40ade	266	extern int vfscanf __P ((FILE *__restrict __s,
42ee0791 EA	267	__const char *__restrict __format,
	268	va_list __arg))
	269	__attribute__ ((__format__ (__scanf__, 2, 0)));
afa40ade EA	270
	271	/* Read formatted input from stdin into argument list ARG. */
	272	extern int vscanf __P ((__const char *__restrict __format, va_list __arg))
	273	__attribute__ ((__format__ (__scanf__, 1, 0)));
	274
42ee0791	275	/* Read formatted input from S into argument list ARG. */
afa40ade	276	extern int vsscanf __P ((__const char *__restrict __s,
42ee0791 EA	277	__const char *__restrict __format,
	278	va_list __arg))
	279	__attribute__ ((__format__ (__scanf__, 2, 0)));
64bc6412	280
64bc6412	281
afa40ade EA	282	/* Read a character from STREAM. */
	283	extern int fgetc __P ((FILE *__stream));
	284	extern int getc __P ((FILE *__stream));
	285
	286	/* Read a character from stdin. */
	287	extern int getchar __P ((void));
d521275a	288	#define getchar() getc(_stdin)
afa40ade EA	289
	290	/* The C standard explicitly says this is a macro, so be that way */
	291	#define getc(stream) \
	292	(((stream)->bufpos >= (stream)->bufread) ? fgetc(stream): \
	293	(*(stream)->bufpos++))
	294
	295	/* Write a character to STREAM. */
	296	extern int fputc __P ((int __c, FILE *__stream));
	297	extern int putc __P ((int __c, FILE *__stream));
	298
	299	/* Write a character to stdout. */
	300	extern int putchar __P ((int __c));
d521275a MNI	301	/* Beware! stdout can be redefined! */
d521275a MNI	302	#define putchar(c) putc((c), _stdout)
afa40ade EA	303
	304	/* The C standard explicitly says this can be a macro, so be that way */
	305	#define putc(c, stream) \
	306	(((stream)->bufpos >= (stream)->bufwrite) ? fputc((c), (stream)) \
	307	: (unsigned char) (*(stream)->bufpos++ = (c)) )
	308
	309	#if defined __USE_SVID \|\| defined __USE_MISC \|\| defined __USE_XOPEN
	310	/* Get a word (int) from STREAM. */
	311	extern int getw __P ((FILE *__stream));
	312
	313	/* Write a word (int) to STREAM. */
	314	extern int putw __P ((int __w, FILE *__stream));
	315	#endif
	316
	317
	318	/* Get a newline-terminated string of finite length from STREAM. */
	319	extern char fgets __P ((char __restrict __s, int __n,
	320	FILE *__restrict __stream));
	321
	322	/* Get a newline-terminated string from stdin, removing the newline.
	323	DO NOT USE THIS FUNCTION!! There is no limit on how much it will read. */
	324	extern char gets __P ((char __s));
	325
a67c6273	326
a8aa4c64	327	#ifdef __USE_GNU
cf4328b1 EA	328	/* Read up to (and including) a DELIMITER from STREAM into *LINEPTR
	329	(and null-terminate it). *LINEPTR is a pointer returned from malloc (or
	330	NULL), pointing to *N characters of space. It is realloc'd as
	331	necessary. Returns the number of characters read (not including the
	332	null terminator), or -1 on error or EOF. */
afa40ade EA	333	extern ssize_t __getdelim __P ((char **__restrict __lineptr,
	334	size_t *__restrict __n, int __delimiter,
	335	FILE *__restrict __stream));
	336	extern ssize_t getdelim __P ((char **__restrict __lineptr,
cf4328b1 EA	337	size_t *__restrict __n, int __delimiter,
cf4328b1 EA	338	FILE *__restrict __stream));
afa40ade	339
56e5d28c	340	/* Like `getdelim', but reads up to a newline. */
afa40ade	341	extern ssize_t getline __P ((char **__restrict __lineptr,
56e5d28c EA	342	size_t *__restrict __n,
56e5d28c EA	343	FILE *__restrict __stream));
a8aa4c64	344	#endif
a67c6273	345
64bc6412	346
afa40ade EA	347	/* Write a string to STREAM. */
	348	extern int fputs __P ((__const char *__restrict __s,
	349	FILE *__restrict __stream));
	350
	351	/* Write a string, followed by a newline, to stdout. */
	352	extern int puts __P ((__const char *__s));
	353
	354
	355	/* Push a character back onto the input buffer of STREAM. */
	356	extern int ungetc __P ((int __c, FILE *__stream));
	357
	358
	359	/* Read chunks of generic data from STREAM. */
	360	extern size_t fread __P ((void *__restrict __ptr, size_t __size,
	361	size_t __n, FILE *__restrict __stream));
	362	/* Write chunks of generic data to STREAM. */
	363	extern size_t fwrite __P ((__const void *__restrict __ptr, size_t __size,
	364	size_t __n, FILE *__restrict __s));
	365
d521275a MNI	366	/* Rewind to the beginning of STREAM. */
	367	extern void rewind __P ((FILE *__stream));
	368
afa40ade EA	369	/* Seek to a certain position on STREAM. */
	370	extern int fseek __P ((FILE *__stream, long int __off, int __whence));
	371	/* Return the current position of STREAM. */
	372	extern long int ftell __P ((FILE *__stream));
afa40ade EA	373
	374	/* The Single Unix Specification, Version 2, specifies an alternative,
	375	more adequate interface for the two functions above which deal with
	376	file offset. `long int' is not the right type. These definitions
	377	are originally defined in the Large File Support API. */
	378
	379	/* Types needed in these functions. */
	380	#ifndef off_t
	381	typedef __off_t off_t;
	382	# define off_t off_t
	383	#endif
	384
	385	#if defined __USE_LARGEFILE64 && !defined off64_t
	386	typedef __off64_t off64_t;
	387	# define off64_t off64_t
	388	#endif
	389
d521275a MNI	390	#ifndef fpos_t
	391	typedef off_t fpos_t;
	392	#define fpos_t fpos_t
	393	#endif
	394
	395	/* Seek to a certain position on STREAM. */
	396	extern int fsetpos __P((FILE __stream, __const fpos_t __pos));
	397	/* Return the current position of STREAM. */
	398	extern int fgetpos __P((FILE __stream, fpos_t __pos));
afa40ade EA	399
	400	/* Clear the error and EOF indicators for STREAM. */
	401	extern void clearerr __P ((FILE *__stream));
afa40ade EA	402	/* Return the EOF indicator for STREAM. */
afa40ade EA	403	extern int feof __P ((FILE *__stream));
afa40ade EA	404	/* Return the error indicator for STREAM. */
afa40ade EA	405	extern int ferror __P ((FILE *__stream));
d521275a MNI	406
	407	/* Macro versions of the 3 previous functions */
	408	/* If fp is NULL... */
	409	#define clearerr(fp) ((fp)->mode &= ~(__MODE_EOF\|__MODE_ERR), (void)0)
82dd793f MNI	410	#define feof(fp) ((fp)->mode&__MODE_EOF)
82dd793f MNI	411	#define ferror(fp) ((fp)->mode&__MODE_ERR)
afa40ade EA	412
	413	/* Print a message describing the meaning of the value of errno. */
	414	extern void perror __P ((__const char *__s));
	415
	416	/* These variables normally should not be used directly. The `strerror'
	417	function provides all the needed functionality. */
	418	extern int sys_nerr;
	419	extern __const char *__const sys_errlist[];
	420
	421	#ifdef __USE_POSIX
	422	/* Return the system file descriptor for STREAM. */
	423	extern int fileno __P ((FILE *__stream));
d521275a MNI	424	/* Only use the macro below if you know fp is a valid FILE for a valid fd. */
d521275a MNI	425	#define __fileno(fp) ((fp)->fd)
afa40ade EA	426	#endif /* Use POSIX. */
	427
	428	#if (defined __USE_POSIX2 \|\| defined __USE_SVID \|\| defined __USE_BSD \|\| \
	429	defined __USE_MISC)
	430	/* Create a new stream connected to a pipe running the given command. */
d521275a	431	extern FILE popen __P ((__const char __command, __const char *__mode));
afa40ade EA	432
	433	/* Close a stream opened by popen and return the status of its child. */
	434	extern int pclose __P ((FILE *__stream));
	435	#endif
	436
	437
	438	#ifdef __USE_POSIX
	439	/* Return the name of the controlling terminal. */
	440	extern char ctermid __P ((char __s));
	441	#endif /* Use POSIX. */
	442
	443
	444	#ifdef __USE_XOPEN
	445	/* Return the name of the current user. */
	446	extern char cuserid __P ((char __s));
	447	#endif /* Use X/Open. */
	448
	449
	450	#if defined __USE_POSIX \|\| defined __USE_MISC
	451	/* These are defined in POSIX.1:1996. */
	452
	453	/* Acquire ownership of STREAM. */
	454	extern void flockfile __P ((FILE *__stream));
	455
	456	/* Try to acquire ownership of STREAM but do not block if it is not
	457	possible. */
	458	extern int ftrylockfile __P ((FILE *__stream));
	459
	460	/* Relinquish the ownership granted for STREAM. */
	461	extern void funlockfile __P ((FILE *__stream));
	462	#endif /* POSIX \|\| misc */
	463
	464	#if defined __USE_XOPEN && !defined __USE_GNU
	465	/* The X/Open standard requires some functions and variables to be
	466	declared here which do not belong into this header. But we have to
	467	follow. In GNU mode we don't do this nonsense. */
	468	# define __need_getopt
	469	# include <getopt.h>
	470	#endif
	471
	472	/* If we are compiling with optimizing read this file. It contains
	473	several optizing inline functions and macros. */
	474	#ifdef __USE_EXTERN_INLINES
	475	# include <bits/stdio.h>
	476	#endif
	477
	478	__END_DECLS
	479
	480	#endif /* !_STDIO_H */