Home | History | Annotate | Download | only in include-fixed
      1 /*  DO NOT EDIT THIS FILE.
      2 
      3     It has been auto-edited by fixincludes from:
      4 
      5 	"/tmp/ndk-20110923/install/toolchains/x86-4.4.3/prebuilt/linux-x86/sysroot/usr/include/stdio.h"
      6 
      7     This had to be done to correct non-standard usages in the
      8     original, manufacturer supplied header file.  */
      9 
     10 /*	$OpenBSD: stdio.h,v 1.35 2006/01/13 18:10:09 miod Exp $	*/
     11 /*	$NetBSD: stdio.h,v 1.18 1996/04/25 18:29:21 jtc Exp $	*/
     12 
     13 /*-
     14  * Copyright (c) 1990 The Regents of the University of California.
     15  * All rights reserved.
     16  *
     17  * This code is derived from software contributed to Berkeley by
     18  * Chris Torek.
     19  *
     20  * Redistribution and use in source and binary forms, with or without
     21  * modification, are permitted provided that the following conditions
     22  * are met:
     23  * 1. Redistributions of source code must retain the above copyright
     24  *    notice, this list of conditions and the following disclaimer.
     25  * 2. Redistributions in binary form must reproduce the above copyright
     26  *    notice, this list of conditions and the following disclaimer in the
     27  *    documentation and/or other materials provided with the distribution.
     28  * 3. Neither the name of the University nor the names of its contributors
     29  *    may be used to endorse or promote products derived from this software
     30  *    without specific prior written permission.
     31  *
     32  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     33  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     34  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     35  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     36  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     37  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     38  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     39  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     40  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     41  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     42  * SUCH DAMAGE.
     43  *
     44  *	@(#)stdio.h	5.17 (Berkeley) 6/3/91
     45  */
     46 
     47 #ifndef	_STDIO_H_
     48 #define	_STDIO_H_
     49 
     50 #include <sys/cdefs.h>
     51 #include <sys/_types.h>
     52 
     53 /* __gnuc_va_list and size_t must be defined by stdio.h according to Posix */
     54 #define __need___va_list
     55 #include <stdarg.h>
     56 
     57 /* note that this forces stddef.h to *only* define size_t */
     58 #define __need_size_t
     59 #include <stddef.h>
     60 
     61 #include <stddef.h>
     62 
     63 #if __BSD_VISIBLE || __POSIX_VISIBLE || __XPG_VISIBLE
     64 #include <sys/types.h>	/* XXX should be removed */
     65 #endif
     66 
     67 #ifndef	_SIZE_T_DEFINED_
     68 #define	_SIZE_T_DEFINED_
     69 typedef	unsigned long    size_t;
     70 #endif
     71 
     72 #ifndef	_OFF_T_DEFINED_
     73 #define	_OFF_T_DEFINED_
     74 typedef	long    off_t;
     75 #endif
     76 
     77 #ifndef NULL
     78 #ifdef 	__GNUG__
     79 #define	NULL	__null
     80 #else
     81 #define	NULL	0L
     82 #endif
     83 #endif
     84 
     85 #define	_FSTDIO			/* Define for new stdio with functions. */
     86 
     87 typedef off_t fpos_t;		/* stdio file position type */
     88 
     89 /*
     90  * NB: to fit things in six character monocase externals, the stdio
     91  * code uses the prefix `__s' for stdio objects, typically followed
     92  * by a three-character attempt at a mnemonic.
     93  */
     94 
     95 /* stdio buffers */
     96 struct __sbuf {
     97 	unsigned char *_base;
     98 	int	_size;
     99 };
    100 
    101 /*
    102  * stdio state variables.
    103  *
    104  * The following always hold:
    105  *
    106  *	if (_flags&(__SLBF|__SWR)) == (__SLBF|__SWR),
    107  *		_lbfsize is -_bf._size, else _lbfsize is 0
    108  *	if _flags&__SRD, _w is 0
    109  *	if _flags&__SWR, _r is 0
    110  *
    111  * This ensures that the getc and putc macros (or inline functions) never
    112  * try to write or read from a file that is in `read' or `write' mode.
    113  * (Moreover, they can, and do, automatically switch from read mode to
    114  * write mode, and back, on "r+" and "w+" files.)
    115  *
    116  * _lbfsize is used only to make the inline line-buffered output stream
    117  * code as compact as possible.
    118  *
    119  * _ub, _up, and _ur are used when ungetc() pushes back more characters
    120  * than fit in the current _bf, or when ungetc() pushes back a character
    121  * that does not match the previous one in _bf.  When this happens,
    122  * _ub._base becomes non-nil (i.e., a stream has ungetc() data iff
    123  * _ub._base!=NULL) and _up and _ur save the current values of _p and _r.
    124  *
    125  * NOTE: if you change this structure, you also need to update the
    126  * std() initializer in findfp.c.
    127  */
    128 typedef	struct __sFILE {
    129 	unsigned char *_p;	/* current position in (some) buffer */
    130 	int	_r;		/* read space left for getc() */
    131 	int	_w;		/* write space left for putc() */
    132 	short	_flags;		/* flags, below; this FILE is free if 0 */
    133 	short	_file;		/* fileno, if Unix descriptor, else -1 */
    134 	struct	__sbuf _bf;	/* the buffer (at least 1 byte, if !NULL) */
    135 	int	_lbfsize;	/* 0 or -_bf._size, for inline putc */
    136 
    137 	/* operations */
    138 	void	*_cookie;	/* cookie passed to io functions */
    139 	int	(*_close)(void *);
    140 	int	(*_read)(void *, char *, int);
    141 	fpos_t	(*_seek)(void *, fpos_t, int);
    142 	int	(*_write)(void *, const char *, int);
    143 
    144 	/* extension data, to avoid further ABI breakage */
    145 	struct	__sbuf _ext;
    146 	/* data for long sequences of ungetc() */
    147 	unsigned char *_up;	/* saved _p when _p is doing ungetc data */
    148 	int	_ur;		/* saved _r when _r is counting ungetc data */
    149 
    150 	/* tricks to meet minimum requirements even when malloc() fails */
    151 	unsigned char _ubuf[3];	/* guarantee an ungetc() buffer */
    152 	unsigned char _nbuf[1];	/* guarantee a getc() buffer */
    153 
    154 	/* separate buffer for fgetln() when line crosses buffer boundary */
    155 	struct	__sbuf _lb;	/* buffer for fgetln() */
    156 
    157 	/* Unix stdio files get aligned to block boundaries on fseek() */
    158 	int	_blksize;	/* stat.st_blksize (may be != _bf._size) */
    159 	fpos_t	_offset;	/* current lseek offset */
    160 } FILE;
    161 
    162 __BEGIN_DECLS
    163 extern FILE __sF[];
    164 __END_DECLS
    165 
    166 #define	__SLBF	0x0001		/* line buffered */
    167 #define	__SNBF	0x0002		/* unbuffered */
    168 #define	__SRD	0x0004		/* OK to read */
    169 #define	__SWR	0x0008		/* OK to write */
    170 	/* RD and WR are never simultaneously asserted */
    171 #define	__SRW	0x0010		/* open for reading & writing */
    172 #define	__SEOF	0x0020		/* found EOF */
    173 #define	__SERR	0x0040		/* found error */
    174 #define	__SMBF	0x0080		/* _buf is from malloc */
    175 #define	__SAPP	0x0100		/* fdopen()ed in append mode */
    176 #define	__SSTR	0x0200		/* this is an sprintf/snprintf string */
    177 #define	__SOPT	0x0400		/* do fseek() optimisation */
    178 #define	__SNPT	0x0800		/* do not do fseek() optimisation */
    179 #define	__SOFF	0x1000		/* set iff _offset is in fact correct */
    180 #define	__SMOD	0x2000		/* true => fgetln modified _p text */
    181 #define	__SALC	0x4000		/* allocate string space dynamically */
    182 
    183 /*
    184  * The following three definitions are for ANSI C, which took them
    185  * from System V, which brilliantly took internal interface macros and
    186  * made them official arguments to setvbuf(), without renaming them.
    187  * Hence, these ugly _IOxxx names are *supposed* to appear in user code.
    188  *
    189  * Although numbered as their counterparts above, the implementation
    190  * does not rely on this.
    191  */
    192 #define	_IOFBF	0		/* setvbuf should set fully buffered */
    193 #define	_IOLBF	1		/* setvbuf should set line buffered */
    194 #define	_IONBF	2		/* setvbuf should set unbuffered */
    195 
    196 #define	BUFSIZ	1024		/* size of buffer used by setbuf */
    197 
    198 #define	EOF	(-1)
    199 
    200 /*
    201  * FOPEN_MAX is a minimum maximum, and should be the number of descriptors
    202  * that the kernel can provide without allocation of a resource that can
    203  * fail without the process sleeping.  Do not use this for anything.
    204  */
    205 #define	FOPEN_MAX	20	/* must be <= OPEN_MAX <sys/syslimits.h> */
    206 #define	FILENAME_MAX	1024	/* must be <= PATH_MAX <sys/syslimits.h> */
    207 
    208 /* System V/ANSI C; this is the wrong way to do this, do *not* use these. */
    209 #if __BSD_VISIBLE || __XPG_VISIBLE
    210 #define	P_tmpdir	"/tmp/"
    211 #endif
    212 #define	L_tmpnam	1024	/* XXX must be == PATH_MAX */
    213 #define	TMP_MAX		308915776
    214 
    215 #ifndef SEEK_SET
    216 #define	SEEK_SET	0	/* set file offset to offset */
    217 #endif
    218 #ifndef SEEK_CUR
    219 #define	SEEK_CUR	1	/* set file offset to current plus offset */
    220 #endif
    221 #ifndef SEEK_END
    222 #define	SEEK_END	2	/* set file offset to EOF plus offset */
    223 #endif
    224 
    225 #define	stdin	(&__sF[0])
    226 #define	stdout	(&__sF[1])
    227 #define	stderr	(&__sF[2])
    228 
    229 /*
    230  * Functions defined in ANSI C standard.
    231  */
    232 __BEGIN_DECLS
    233 void	 clearerr(FILE *);
    234 int	 fclose(FILE *);
    235 int	 feof(FILE *);
    236 int	 ferror(FILE *);
    237 int	 fflush(FILE *);
    238 int	 fgetc(FILE *);
    239 int	 fgetpos(FILE *, fpos_t *);
    240 char	*fgets(char *, int, FILE *);
    241 FILE	*fopen(const char *, const char *);
    242 int	 fprintf(FILE *, const char *, ...);
    243 int	 fputc(int, FILE *);
    244 int	 fputs(const char *, FILE *);
    245 size_t	 fread(void *, size_t, size_t, FILE *);
    246 FILE	*freopen(const char *, const char *, FILE *);
    247 int	 fscanf(FILE *, const char *, ...);
    248 int	 fseek(FILE *, long, int);
    249 int	 fseeko(FILE *, off_t, int);
    250 int	 fsetpos(FILE *, const fpos_t *);
    251 long	 ftell(FILE *);
    252 off_t	 ftello(FILE *);
    253 size_t	 fwrite(const void *, size_t, size_t, FILE *);
    254 int	 getc(FILE *);
    255 int	 getchar(void);
    256 char	*gets(char *);
    257 #if __BSD_VISIBLE && !defined(__SYS_ERRLIST)
    258 #define __SYS_ERRLIST
    259 
    260 extern int sys_nerr;			/* perror(3) external variables */
    261 extern char *sys_errlist[];
    262 #endif
    263 void	 perror(const char *);
    264 int	 printf(const char *, ...);
    265 int	 putc(int, FILE *);
    266 int	 putchar(int);
    267 int	 puts(const char *);
    268 int	 remove(const char *);
    269 int	 rename(const char *, const char *);
    270 void	 rewind(FILE *);
    271 int	 scanf(const char *, ...);
    272 void	 setbuf(FILE *, char *);
    273 int	 setvbuf(FILE *, char *, int, size_t);
    274 int	 sprintf(char *, const char *, ...);
    275 int	 sscanf(const char *, const char *, ...);
    276 FILE	*tmpfile(void);
    277 char	*tmpnam(char *);
    278 int	 ungetc(int, FILE *);
    279 int	 vfprintf(FILE *, const char *, __gnuc_va_list);
    280 int	 vprintf(const char *, __gnuc_va_list);
    281 int	 vsprintf(char *, const char *, __gnuc_va_list);
    282 
    283 #if __ISO_C_VISIBLE >= 1999 || __BSD_VISIBLE
    284 int	 snprintf(char *, size_t, const char *, ...)
    285 		__attribute__((__format__ (printf, 3, 4)))
    286 		__attribute__((__nonnull__ (3)));
    287 int	 vfscanf(FILE *, const char *, __gnuc_va_list)
    288 		__attribute__((__format__ (scanf, 2, 0)))
    289 		__attribute__((__nonnull__ (2)));
    290 int	 vscanf(const char *, __gnuc_va_list)
    291 		__attribute__((__format__ (scanf, 1, 0)))
    292 		__attribute__((__nonnull__ (1)));
    293 int	 vsnprintf(char *, size_t, const char *, __gnuc_va_list)
    294 		__attribute__((__format__ (printf, 3, 0)))
    295 		__attribute__((__nonnull__ (3)));
    296 int	 vsscanf(const char *, const char *, __gnuc_va_list)
    297 		__attribute__((__format__ (scanf, 2, 0)))
    298 		__attribute__((__nonnull__ (2)));
    299 #endif /* __ISO_C_VISIBLE >= 1999 || __BSD_VISIBLE */
    300 
    301 __END_DECLS
    302 
    303 
    304 /*
    305  * Functions defined in POSIX 1003.1.
    306  */
    307 #if __BSD_VISIBLE || __POSIX_VISIBLE || __XPG_VISIBLE
    308 #define	L_ctermid	1024	/* size for ctermid(); PATH_MAX */
    309 #define L_cuserid	9	/* size for cuserid(); UT_NAMESIZE + 1 */
    310 
    311 __BEGIN_DECLS
    312 #if 0 /* MISSING FROM BIONIC */
    313 char	*ctermid(char *);
    314 char	*cuserid(char *);
    315 #endif /* MISSING */
    316 FILE	*fdopen(int, const char *);
    317 int	 fileno(FILE *);
    318 
    319 #if (__POSIX_VISIBLE >= 199209)
    320 int	 pclose(FILE *);
    321 FILE	*popen(const char *, const char *);
    322 #endif
    323 
    324 #if __POSIX_VISIBLE >= 199506
    325 void	 flockfile(FILE *);
    326 int	 ftrylockfile(FILE *);
    327 void	 funlockfile(FILE *);
    328 
    329 /*
    330  * These are normally used through macros as defined below, but POSIX
    331  * requires functions as well.
    332  */
    333 int	 getc_unlocked(FILE *);
    334 int	 getchar_unlocked(void);
    335 int	 putc_unlocked(int, FILE *);
    336 int	 putchar_unlocked(int);
    337 #endif /* __POSIX_VISIBLE >= 199506 */
    338 
    339 #if __XPG_VISIBLE
    340 char	*tempnam(const char *, const char *);
    341 #endif
    342 __END_DECLS
    343 
    344 #endif /* __BSD_VISIBLE || __POSIX_VISIBLE || __XPG_VISIBLE */
    345 
    346 /*
    347  * Routines that are purely local.
    348  */
    349 #if __BSD_VISIBLE
    350 __BEGIN_DECLS
    351 int	 asprintf(char **, const char *, ...)
    352 		__attribute__((__format__ (printf, 2, 3)))
    353 		__attribute__((__nonnull__ (2)));
    354 char	*fgetln(FILE *, size_t *);
    355 int	 fpurge(FILE *);
    356 int	 getw(FILE *);
    357 int	 putw(int, FILE *);
    358 void	 setbuffer(FILE *, char *, int);
    359 int	 setlinebuf(FILE *);
    360 int	 vasprintf(char **, const char *, __gnuc_va_list)
    361 		__attribute__((__format__ (printf, 2, 0)))
    362 		__attribute__((__nonnull__ (2)));
    363 __END_DECLS
    364 
    365 /*
    366  * Stdio function-access interface.
    367  */
    368 __BEGIN_DECLS
    369 FILE	*funopen(const void *,
    370 		int (*)(void *, char *, int),
    371 		int (*)(void *, const char *, int),
    372 		fpos_t (*)(void *, fpos_t, int),
    373 		int (*)(void *));
    374 __END_DECLS
    375 #define	fropen(cookie, fn) funopen(cookie, fn, 0, 0, 0)
    376 #define	fwopen(cookie, fn) funopen(cookie, 0, fn, 0, 0)
    377 #endif /* __BSD_VISIBLE */
    378 
    379 /*
    380  * Functions internal to the implementation.
    381  */
    382 __BEGIN_DECLS
    383 int	__srget(FILE *);
    384 int	__swbuf(int, FILE *);
    385 __END_DECLS
    386 
    387 /*
    388  * The __sfoo macros are here so that we can
    389  * define function versions in the C library.
    390  */
    391 #define	__sgetc(p) (--(p)->_r < 0 ? __srget(p) : (int)(*(p)->_p++))
    392 #if defined(__GNUC__)
    393 static __inline int __sputc(int _c, FILE *_p) {
    394 	if (--_p->_w >= 0 || (_p->_w >= _p->_lbfsize && (char)_c != '\n'))
    395 		return (*_p->_p++ = _c);
    396 	else
    397 		return (__swbuf(_c, _p));
    398 }
    399 #else
    400 /*
    401  * This has been tuned to generate reasonable code on the vax using pcc.
    402  */
    403 #define	__sputc(c, p) \
    404 	(--(p)->_w < 0 ? \
    405 		(p)->_w >= (p)->_lbfsize ? \
    406 			(*(p)->_p = (c)), *(p)->_p != '\n' ? \
    407 				(int)*(p)->_p++ : \
    408 				__swbuf('\n', p) : \
    409 			__swbuf((int)(c), p) : \
    410 		(*(p)->_p = (c), (int)*(p)->_p++))
    411 #endif
    412 
    413 #define	__sfeof(p)	(((p)->_flags & __SEOF) != 0)
    414 #define	__sferror(p)	(((p)->_flags & __SERR) != 0)
    415 #define	__sclearerr(p)	((void)((p)->_flags &= ~(__SERR|__SEOF)))
    416 #define	__sfileno(p)	((p)->_file)
    417 
    418 #define	feof(p)		__sfeof(p)
    419 #define	ferror(p)	__sferror(p)
    420 
    421 #ifndef _POSIX_THREADS
    422 #define	clearerr(p)	__sclearerr(p)
    423 #endif
    424 
    425 #if __POSIX_VISIBLE
    426 #define	fileno(p)	__sfileno(p)
    427 #endif
    428 
    429 #ifndef lint
    430 #ifndef _POSIX_THREADS
    431 #define	getc(fp)	__sgetc(fp)
    432 #endif /* _POSIX_THREADS */
    433 #define	getc_unlocked(fp)	__sgetc(fp)
    434 /*
    435  * The macro implementations of putc and putc_unlocked are not
    436  * fully POSIX compliant; they do not set errno on failure
    437  */
    438 #if __BSD_VISIBLE
    439 #ifndef _POSIX_THREADS
    440 #define putc(x, fp)	__sputc(x, fp)
    441 #endif /* _POSIX_THREADS */
    442 #define putc_unlocked(x, fp)	__sputc(x, fp)
    443 #endif /* __BSD_VISIBLE */
    444 #endif /* lint */
    445 
    446 #define	getchar()	getc(stdin)
    447 #define	putchar(x)	putc(x, stdout)
    448 #define getchar_unlocked()	getc_unlocked(stdin)
    449 #define putchar_unlocked(c)	putc_unlocked(c, stdout)
    450 
    451 #ifdef _GNU_SOURCE
    452 /*
    453  * glibc defines dprintf(int, const char*, ...), which is poorly named
    454  * and likely to conflict with locally defined debugging printfs
    455  * fdprintf is a better name, and some programs that use fdprintf use a
    456  * #define fdprintf dprintf for compatibility
    457  */
    458 int fdprintf(int, const char*, ...);
    459 int vfdprintf(int, const char*, __gnuc_va_list);
    460 #endif /* _GNU_SOURCE */
    461 
    462 #endif /* _STDIO_H_ */
    463