Annotation of src/include/stdio.h, Revision 1.64
1.64 ! mrg 1: /* $NetBSD: stdio.h,v 1.63 2005/12/27 17:21:28 perry Exp $ */
1.14 cgd 2:
1.1 cgd 3: /*-
1.20 perry 4: * Copyright (c) 1990, 1993
5: * The Regents of the University of California. All rights reserved.
1.1 cgd 6: *
7: * This code is derived from software contributed to Berkeley by
8: * Chris Torek.
9: *
10: * Redistribution and use in source and binary forms, with or without
11: * modification, are permitted provided that the following conditions
12: * are met:
13: * 1. Redistributions of source code must retain the above copyright
14: * notice, this list of conditions and the following disclaimer.
15: * 2. Redistributions in binary form must reproduce the above copyright
16: * notice, this list of conditions and the following disclaimer in the
17: * documentation and/or other materials provided with the distribution.
1.53 agc 18: * 3. Neither the name of the University nor the names of its contributors
1.1 cgd 19: * may be used to endorse or promote products derived from this software
20: * without specific prior written permission.
21: *
22: * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25: * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32: * SUCH DAMAGE.
33: *
1.20 perry 34: * @(#)stdio.h 8.5 (Berkeley) 4/29/95
1.1 cgd 35: */
36:
37: #ifndef _STDIO_H_
38: #define _STDIO_H_
39:
40: #include <sys/cdefs.h>
1.21 kleink 41: #include <sys/featuretest.h>
1.61 kleink 42: #include <sys/ansi.h>
1.1 cgd 43:
44: #include <machine/ansi.h>
1.12 cgd 45: #ifdef _BSD_SIZE_T_
46: typedef _BSD_SIZE_T_ size_t;
47: #undef _BSD_SIZE_T_
1.1 cgd 48: #endif
49:
1.32 kleink 50: #include <sys/null.h>
1.1 cgd 51:
1.11 cgd 52: /*
53: * This is fairly grotesque, but pure ANSI code must not inspect the
54: * innards of an fpos_t anyway. The library internally uses off_t,
55: * which we assume is exactly as big as eight chars.
56: */
1.37 mycroft 57: #if (!defined(_ANSI_SOURCE) && !defined(__STRICT_ANSI__)) || defined(_LIBC)
1.33 kleink 58: typedef __off_t fpos_t;
1.11 cgd 59: #else
60: typedef struct __sfpos {
1.33 kleink 61: __off_t _pos;
1.11 cgd 62: } fpos_t;
63: #endif
1.1 cgd 64:
65: #define _FSTDIO /* Define for new stdio with functions. */
66:
67: /*
68: * NB: to fit things in six character monocase externals, the stdio
69: * code uses the prefix `__s' for stdio objects, typically followed
70: * by a three-character attempt at a mnemonic.
71: */
72:
73: /* stdio buffers */
74: struct __sbuf {
75: unsigned char *_base;
76: int _size;
77: };
78:
79: /*
80: * stdio state variables.
81: *
82: * The following always hold:
83: *
84: * if (_flags&(__SLBF|__SWR)) == (__SLBF|__SWR),
85: * _lbfsize is -_bf._size, else _lbfsize is 0
86: * if _flags&__SRD, _w is 0
87: * if _flags&__SWR, _r is 0
88: *
89: * This ensures that the getc and putc macros (or inline functions) never
90: * try to write or read from a file that is in `read' or `write' mode.
91: * (Moreover, they can, and do, automatically switch from read mode to
92: * write mode, and back, on "r+" and "w+" files.)
93: *
94: * _lbfsize is used only to make the inline line-buffered output stream
95: * code as compact as possible.
96: *
97: * _ub, _up, and _ur are used when ungetc() pushes back more characters
98: * than fit in the current _bf, or when ungetc() pushes back a character
99: * that does not match the previous one in _bf. When this happens,
100: * _ub._base becomes non-nil (i.e., a stream has ungetc() data iff
101: * _ub._base!=NULL) and _up and _ur save the current values of _p and _r.
1.20 perry 102: *
103: * NB: see WARNING above before changing the layout of this structure!
1.1 cgd 104: */
105: typedef struct __sFILE {
106: unsigned char *_p; /* current position in (some) buffer */
107: int _r; /* read space left for getc() */
108: int _w; /* write space left for putc() */
109: short _flags; /* flags, below; this FILE is free if 0 */
110: short _file; /* fileno, if Unix descriptor, else -1 */
111: struct __sbuf _bf; /* the buffer (at least 1 byte, if !NULL) */
112: int _lbfsize; /* 0 or -_bf._size, for inline putc */
113:
114: /* operations */
115: void *_cookie; /* cookie passed to io functions */
1.57 perry 116: int (*_close)(void *);
117: int (*_read) (void *, char *, int);
118: fpos_t (*_seek) (void *, fpos_t, int);
119: int (*_write)(void *, const char *, int);
1.1 cgd 120:
1.42 yamt 121: /* file extension */
122: struct __sbuf _ext;
123:
1.1 cgd 124: /* separate buffer for long sequences of ungetc() */
125: unsigned char *_up; /* saved _p when _p is doing ungetc data */
126: int _ur; /* saved _r when _r is counting ungetc data */
127:
128: /* tricks to meet minimum requirements even when malloc() fails */
129: unsigned char _ubuf[3]; /* guarantee an ungetc() buffer */
130: unsigned char _nbuf[1]; /* guarantee a getc() buffer */
131:
1.10 cgd 132: /* separate buffer for fgetln() when line crosses buffer boundary */
133: struct __sbuf _lb; /* buffer for fgetln() */
1.1 cgd 134:
135: /* Unix stdio files get aligned to block boundaries on fseek() */
136: int _blksize; /* stat.st_blksize (may be != _bf._size) */
1.11 cgd 137: fpos_t _offset; /* current lseek offset */
1.1 cgd 138: } FILE;
139:
140: __BEGIN_DECLS
141: extern FILE __sF[];
142: __END_DECLS
143:
144: #define __SLBF 0x0001 /* line buffered */
145: #define __SNBF 0x0002 /* unbuffered */
146: #define __SRD 0x0004 /* OK to read */
147: #define __SWR 0x0008 /* OK to write */
148: /* RD and WR are never simultaneously asserted */
149: #define __SRW 0x0010 /* open for reading & writing */
150: #define __SEOF 0x0020 /* found EOF */
151: #define __SERR 0x0040 /* found error */
152: #define __SMBF 0x0080 /* _buf is from malloc */
153: #define __SAPP 0x0100 /* fdopen()ed in append mode */
154: #define __SSTR 0x0200 /* this is an sprintf/snprintf string */
1.36 enami 155: #define __SOPT 0x0400 /* do fseek() optimization */
156: #define __SNPT 0x0800 /* do not do fseek() optimization */
1.1 cgd 157: #define __SOFF 0x1000 /* set iff _offset is in fact correct */
1.10 cgd 158: #define __SMOD 0x2000 /* true => fgetln modified _p text */
1.27 perry 159: #define __SALC 0x4000 /* allocate string space dynamically */
1.1 cgd 160:
161: /*
162: * The following three definitions are for ANSI C, which took them
163: * from System V, which brilliantly took internal interface macros and
164: * made them official arguments to setvbuf(), without renaming them.
165: * Hence, these ugly _IOxxx names are *supposed* to appear in user code.
166: *
167: * Although numbered as their counterparts above, the implementation
168: * does not rely on this.
169: */
170: #define _IOFBF 0 /* setvbuf should set fully buffered */
171: #define _IOLBF 1 /* setvbuf should set line buffered */
172: #define _IONBF 2 /* setvbuf should set unbuffered */
173:
174: #define BUFSIZ 1024 /* size of buffer used by setbuf */
175: #define EOF (-1)
176:
177: /*
1.20 perry 178: * FOPEN_MAX is a minimum maximum, and is the number of streams that
179: * stdio can provide without attempting to allocate further resources
180: * (which could fail). Do not use this for anything.
1.1 cgd 181: */
1.20 perry 182: /* must be == _POSIX_STREAM_MAX <limits.h> */
1.1 cgd 183: #define FOPEN_MAX 20 /* must be <= OPEN_MAX <sys/syslimits.h> */
184: #define FILENAME_MAX 1024 /* must be <= PATH_MAX <sys/syslimits.h> */
185:
186: /* System V/ANSI C; this is the wrong way to do this, do *not* use these. */
1.52 bjh21 187: #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
1.1 cgd 188: #define P_tmpdir "/var/tmp/"
189: #endif
190: #define L_tmpnam 1024 /* XXX must be == PATH_MAX */
1.49 christos 191: /* Always ensure that this is consistent with <limits.h> */
192: #ifndef TMP_MAX
193: #define TMP_MAX 308915776 /* Legacy */
194: #endif
1.1 cgd 195:
1.22 kleink 196: /* Always ensure that these are consistent with <fcntl.h> and <unistd.h>! */
1.1 cgd 197: #ifndef SEEK_SET
198: #define SEEK_SET 0 /* set file offset to offset */
199: #endif
200: #ifndef SEEK_CUR
201: #define SEEK_CUR 1 /* set file offset to current plus offset */
202: #endif
203: #ifndef SEEK_END
204: #define SEEK_END 2 /* set file offset to EOF plus offset */
205: #endif
206:
207: #define stdin (&__sF[0])
208: #define stdout (&__sF[1])
209: #define stderr (&__sF[2])
210:
211: /*
212: * Functions defined in ANSI C standard.
213: */
214: __BEGIN_DECLS
1.57 perry 215: void clearerr(FILE *);
216: int fclose(FILE *);
217: int feof(FILE *);
218: int ferror(FILE *);
219: int fflush(FILE *);
220: int fgetc(FILE *);
221: int fgetpos(FILE * __restrict, fpos_t * __restrict);
222: char *fgets(char * __restrict, int, FILE * __restrict);
1.59 kleink 223: FILE *fopen(const char * __restrict , const char * __restrict);
1.57 perry 224: int fprintf(FILE * __restrict , const char * __restrict, ...);
225: int fputc(int, FILE *);
226: int fputs(const char * __restrict, FILE * __restrict);
227: size_t fread(void * __restrict, size_t, size_t, FILE * __restrict);
1.59 kleink 228: FILE *freopen(const char * __restrict, const char * __restrict,
229: FILE * __restrict);
1.57 perry 230: int fscanf(FILE * __restrict, const char * __restrict, ...);
231: int fseek(FILE *, long, int);
232: int fsetpos(FILE *, const fpos_t *);
233: long ftell(FILE *);
234: size_t fwrite(const void * __restrict, size_t, size_t, FILE * __restrict);
235: int getc(FILE *);
236: int getchar(void);
237: void perror(const char *);
238: int printf(const char * __restrict, ...);
239: int putc(int, FILE *);
240: int putchar(int);
241: int puts(const char *);
242: int remove(const char *);
243: void rewind(FILE *);
244: int scanf(const char * __restrict, ...);
245: void setbuf(FILE * __restrict, char * __restrict);
246: int setvbuf(FILE * __restrict, char * __restrict, int, size_t);
247: int sscanf(const char * __restrict, const char * __restrict, ...);
248: FILE *tmpfile(void);
249: int ungetc(int, FILE *);
250: int vfprintf(FILE * __restrict, const char * __restrict, _BSD_VA_LIST_);
251: int vprintf(const char * __restrict, _BSD_VA_LIST_);
1.24 mycroft 252:
253: #ifndef __AUDIT__
1.57 perry 254: char *gets(char *);
255: int sprintf(char * __restrict, const char * __restrict, ...);
256: char *tmpnam(char *);
257: int vsprintf(char * __restrict, const char * __restrict,
258: _BSD_VA_LIST_);
1.24 mycroft 259: #endif
1.21 kleink 260:
261: #if defined(_POSIX_C_SOURCE) || defined(_XOPEN_SOURCE)
1.57 perry 262: int rename (const char *, const char *) __RENAME(__posix_rename);
1.21 kleink 263: #else
1.57 perry 264: int rename (const char *, const char *);
1.21 kleink 265: #endif
1.1 cgd 266: __END_DECLS
267:
268: /*
1.29 kleink 269: * IEEE Std 1003.1-90
1.1 cgd 270: */
1.51 bjh21 271: #if defined(_POSIX_C_SOURCE) || defined(_XOPEN_SOURCE) || \
272: defined(_NETBSD_SOURCE)
1.1 cgd 273: #define L_ctermid 1024 /* size for ctermid(); PATH_MAX */
1.7 jtc 274: #define L_cuserid 9 /* size for cuserid(); UT_NAMESIZE + 1 */
1.1 cgd 275:
276: __BEGIN_DECLS
1.57 perry 277: char *ctermid(char *);
1.40 christos 278: #ifndef __CUSERID_DECLARED
279: #define __CUSERID_DECLARED
280: /* also declared in unistd.h */
1.57 perry 281: char *cuserid(char *);
1.40 christos 282: #endif /* __CUSERID_DECLARED */
1.57 perry 283: FILE *fdopen(int, const char *);
284: int fileno(FILE *);
1.1 cgd 285: __END_DECLS
286: #endif /* not ANSI */
287:
1.29 kleink 288: /*
289: * IEEE Std 1003.1c-95, also adopted by X/Open CAE Spec Issue 5 Version 2
290: */
1.51 bjh21 291: #if (_POSIX_C_SOURCE - 0) >= 199506L || (_XOPEN_SOURCE - 0) >= 500 || \
292: defined(_REENTRANT) || defined(_NETBSD_SOURCE)
1.29 kleink 293: __BEGIN_DECLS
1.57 perry 294: void flockfile(FILE *);
295: int ftrylockfile(FILE *);
296: void funlockfile(FILE *);
297: int getc_unlocked(FILE *);
298: int getchar_unlocked(void);
299: int putc_unlocked(int, FILE *);
300: int putchar_unlocked(int);
1.29 kleink 301: __END_DECLS
1.51 bjh21 302: #endif /* _POSIX_C_SOURCE >= 1995056 || _XOPEN_SOURCE >= 500 || ... */
1.19 jtc 303:
1.1 cgd 304: /*
1.29 kleink 305: * Functions defined in POSIX 1003.2 and XPG2 or later.
1.1 cgd 306: */
1.51 bjh21 307: #if (_POSIX_C_SOURCE - 0) >= 2 || (_XOPEN_SOURCE - 0) >= 2 || \
308: defined(_NETBSD_SOURCE)
1.1 cgd 309: __BEGIN_DECLS
1.57 perry 310: int pclose(FILE *);
311: FILE *popen(const char *, const char *);
1.22 kleink 312: __END_DECLS
313: #endif
314:
315: /*
1.60 kleink 316: * Functions defined in ISO XPG4.2, ISO C99, POSIX 1003.1-2001 or later.
317: */
318: #if !defined(_ANSI_SOURCE) && !defined(_POSIX_C_SOURCE) && \
319: !defined(_XOPEN_SOURCE) || \
320: ((__STDC_VERSION__ - 0) >= 199901L) || \
321: ((_POSIX_C_SOURCE - 0) >= 200112L) || \
322: (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
323: ((_XOPEN_SOURCE - 0) >= 500) || \
324: defined(_ISOC99_SOURCE) || defined(_NETBSD_SOURCE)
1.64 ! mrg 325: __BEGIN_DECLS
1.60 kleink 326: int snprintf(char * __restrict, size_t, const char * __restrict, ...)
327: __attribute__((__format__(__printf__, 3, 4)));
328: int vsnprintf(char * __restrict, size_t, const char * __restrict,
329: _BSD_VA_LIST_)
330: __attribute__((__format__(__printf__, 3, 0)));
1.64 ! mrg 331: __END_DECLS
1.60 kleink 332: #endif
333:
334: /*
1.22 kleink 335: * Functions defined in XPG4.2.
336: */
1.51 bjh21 337: #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
1.22 kleink 338: __BEGIN_DECLS
1.57 perry 339: int getw(FILE *);
340: int putw(int, FILE *);
1.24 mycroft 341:
342: #ifndef __AUDIT__
1.57 perry 343: char *tempnam(const char *, const char *);
1.24 mycroft 344: #endif
1.22 kleink 345: __END_DECLS
346: #endif
1.34 kleink 347:
348: /*
349: * X/Open CAE Specification Issue 5 Version 2
350: */
1.51 bjh21 351: #if (_XOPEN_SOURCE - 0) >= 500 || defined(_LARGEFILE_SOURCE) || \
352: defined(_NETBSD_SOURCE)
1.34 kleink 353: #ifndef off_t
354: typedef __off_t off_t;
1.38 kleink 355: #define off_t __off_t
1.35 drochner 356: #endif /* off_t */
1.34 kleink 357:
1.36 enami 358: __BEGIN_DECLS
1.57 perry 359: int fseeko(FILE *, off_t, int);
360: off_t ftello(FILE *);
1.36 enami 361: __END_DECLS
1.51 bjh21 362: #endif /* _XOPEN_SOURCE >= 500 || _LARGEFILE_SOURCE || _NETBSD_SOURCE */
1.22 kleink 363:
364: /*
365: * Routines that are purely local.
366: */
1.51 bjh21 367: #if defined(_NETBSD_SOURCE)
1.46 lukem 368:
369: #define FPARSELN_UNESCESC 0x01
370: #define FPARSELN_UNESCCONT 0x02
371: #define FPARSELN_UNESCCOMM 0x04
372: #define FPARSELN_UNESCREST 0x08
373: #define FPARSELN_UNESCALL 0x0f
374:
1.22 kleink 375: __BEGIN_DECLS
1.57 perry 376: int asprintf(char ** __restrict, const char * __restrict, ...)
1.41 kleink 377: __attribute__((__format__(__printf__, 2, 3)));
1.57 perry 378: char *fgetln(FILE * __restrict, size_t * __restrict);
1.46 lukem 379: char *fparseln(FILE *, size_t *, size_t *, const char[3], int);
1.57 perry 380: int fpurge(FILE *);
381: void setbuffer(FILE *, char *, int);
382: int setlinebuf(FILE *);
383: int vasprintf(char ** __restrict, const char * __restrict,
384: _BSD_VA_LIST_)
1.41 kleink 385: __attribute__((__format__(__printf__, 2, 0)));
1.57 perry 386: int vscanf(const char * __restrict, _BSD_VA_LIST_)
1.26 mycroft 387: __attribute__((__format__(__scanf__, 1, 0)));
1.57 perry 388: int vfscanf(FILE * __restrict, const char * __restrict,
389: _BSD_VA_LIST_)
1.45 thorpej 390: __attribute__((__format__(__scanf__, 2, 0)));
1.57 perry 391: int vsscanf(const char * __restrict, const char * __restrict,
392: _BSD_VA_LIST_)
1.26 mycroft 393: __attribute__((__format__(__scanf__, 2, 0)));
1.62 perry 394: const char *fmtcheck(const char *, const char *)
1.41 kleink 395: __attribute__((__format_arg__(2)));
1.1 cgd 396: __END_DECLS
397:
398: /*
399: * Stdio function-access interface.
400: */
401: __BEGIN_DECLS
1.57 perry 402: FILE *funopen(const void *,
1.1 cgd 403: int (*)(void *, char *, int),
404: int (*)(void *, const char *, int),
405: fpos_t (*)(void *, fpos_t, int),
1.57 perry 406: int (*)(void *));
1.1 cgd 407: __END_DECLS
408: #define fropen(cookie, fn) funopen(cookie, fn, 0, 0, 0)
409: #define fwopen(cookie, fn) funopen(cookie, 0, fn, 0, 0)
1.51 bjh21 410: #endif /* _NETBSD_SOURCE */
1.1 cgd 411:
412: /*
413: * Functions internal to the implementation.
414: */
415: __BEGIN_DECLS
1.57 perry 416: int __srget(FILE *);
417: int __swbuf(int, FILE *);
1.1 cgd 418: __END_DECLS
419:
420: /*
421: * The __sfoo macros are here so that we can
422: * define function versions in the C library.
423: */
424: #define __sgetc(p) (--(p)->_r < 0 ? __srget(p) : (int)(*(p)->_p++))
425: #if defined(__GNUC__) && defined(__STDC__)
1.63 perry 426: static __inline int __sputc(int _c, FILE *_p) {
1.1 cgd 427: if (--_p->_w >= 0 || (_p->_w >= _p->_lbfsize && (char)_c != '\n'))
428: return (*_p->_p++ = _c);
429: else
430: return (__swbuf(_c, _p));
431: }
432: #else
433: /*
434: * This has been tuned to generate reasonable code on the vax using pcc.
435: */
436: #define __sputc(c, p) \
437: (--(p)->_w < 0 ? \
438: (p)->_w >= (p)->_lbfsize ? \
439: (*(p)->_p = (c)), *(p)->_p != '\n' ? \
440: (int)*(p)->_p++ : \
441: __swbuf('\n', p) : \
442: __swbuf((int)(c), p) : \
443: (*(p)->_p = (c), (int)*(p)->_p++))
444: #endif
445:
446: #define __sfeof(p) (((p)->_flags & __SEOF) != 0)
447: #define __sferror(p) (((p)->_flags & __SERR) != 0)
448: #define __sclearerr(p) ((void)((p)->_flags &= ~(__SERR|__SEOF)))
449: #define __sfileno(p) ((p)->_file)
450:
1.56 kleink 451: #ifndef __lint__
1.50 kleink 452: #if !defined(_REENTRANT) && !defined(_PTHREADS)
1.1 cgd 453: #define feof(p) __sfeof(p)
454: #define ferror(p) __sferror(p)
455: #define clearerr(p) __sclearerr(p)
456:
457: #define getc(fp) __sgetc(fp)
458: #define putc(x, fp) __sputc(x, fp)
1.50 kleink 459: #endif /* !_REENTRANT && !_PTHREADS */
1.56 kleink 460: #endif /* __lint__ */
1.1 cgd 461:
462: #define getchar() getc(stdin)
463: #define putchar(x) putc(x, stdout)
1.19 jtc 464:
1.51 bjh21 465: #if defined(_POSIX_C_SOURCE) || defined(_XOPEN_SOURCE) || \
466: defined(_NETBSD_SOURCE)
1.50 kleink 467: #if !defined(_REENTRANT) && !defined(_PTHREADS)
1.19 jtc 468: #define fileno(p) __sfileno(p)
1.50 kleink 469: #endif /* !_REENTRANT && !_PTHREADS */
1.30 kleink 470: #endif /* !_ANSI_SOURCE */
1.19 jtc 471:
1.51 bjh21 472: #if (_POSIX_C_SOURCE - 0) >= 199506L || (_XOPEN_SOURCE - 0) >= 500 || \
473: defined(_REENTRANT) || defined(_NETBSD_SOURCE)
1.19 jtc 474: #define getc_unlocked(fp) __sgetc(fp)
475: #define putc_unlocked(x, fp) __sputc(x, fp)
476:
477: #define getchar_unlocked() getc_unlocked(stdin)
478: #define putchar_unlocked(x) putc_unlocked(x, stdout)
1.51 bjh21 479: #endif /* _POSIX_C_SOURCE >= 199506 || _XOPEN_SOURCE >= 500 || _REENTRANT... */
1.19 jtc 480:
1.1 cgd 481: #endif /* _STDIO_H_ */
CVSweb <webmaster@jp.NetBSD.org>