xref: /illumos-gate/usr/src/head/iso/stdio_iso.h (revision 50b37527)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License, Version 1.0 only
6  * (the "License").  You may not use this file except in compliance
7  * with the License.
8  *
9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10  * or http://www.opensolaris.org/os/licensing.
11  * See the License for the specific language governing permissions
12  * and limitations under the License.
13  *
14  * When distributing Covered Code, include this CDDL HEADER in each
15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16  * If applicable, add the following below this CDDL HEADER, with the
17  * fields enclosed by brackets "[]" replaced with your own identifying
18  * information: Portions Copyright [yyyy] [name of copyright owner]
19  *
20  * CDDL HEADER END
21  */
22 /*
23  * Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 /*	Copyright (c) 1988 AT&T	*/
28 /*	  All Rights Reserved  	*/
29 
30 /*
31  * An application should not include this header directly.  Instead it
32  * should be included only through the inclusion of other Sun headers.
33  *
34  * The contents of this header is limited to identifiers specified in the
35  * C Standard.  Any new identifiers specified in future amendments to the
36  * C Standard must be placed in this header.  If these new identifiers
37  * are required to also be in the C++ Standard "std" namespace, then for
38  * anything other than macro definitions, corresponding "using" directives
39  * must also be added to <stdio.h>.
40  */
41 
42 /*
43  * User-visible pieces of the ANSI C standard I/O package.
44  */
45 
46 #ifndef _ISO_STDIO_ISO_H
47 #define	_ISO_STDIO_ISO_H
48 
49 #pragma ident	"%Z%%M%	%I%	%E% SMI"
50 
51 #include <sys/feature_tests.h>
52 #include <sys/va_list.h>
53 #include <stdio_tag.h>
54 #include <stdio_impl.h>
55 
56 /*
57  * If feature test macros are set that enable interfaces that use types
58  * defined in <sys/types.h>, get those types by doing the include.
59  *
60  * Note that in asking for the interfaces associated with this feature test
61  * macro one also asks for definitions of the POSIX types.
62  */
63 
64 #ifdef	__cplusplus
65 extern "C" {
66 #endif
67 
68 #if !defined(_LP64) && (_FILE_OFFSET_BITS == 64 || defined(_LARGEFILE64_SOURCE))
69 /*
70  * The following typedefs are adopted from ones in <sys/types.h> (with leading
71  * underscores added to avoid polluting the ANSI C name space).  See the
72  * commentary there for further explanation.
73  */
74 #if defined(_LONGLONG_TYPE)
75 typedef	long long	__longlong_t;
76 #else
77 /* used to reserve space and generate alignment */
78 typedef union {
79 	double	_d;
80 	int	_l[2];
81 } __longlong_t;
82 #endif
83 #endif  /* !_LP64 && _FILE_OFFSET_BITS == 64 || defined(_LARGEFILE64_SOURCE) */
84 
85 #if __cplusplus >= 199711L
86 namespace std {
87 #endif
88 
89 #if !defined(_FILEDEFED) || __cplusplus >= 199711L
90 #define	_FILEDEFED
91 typedef	__FILE FILE;
92 #endif
93 
94 #if !defined(_SIZE_T) || __cplusplus >= 199711L
95 #define	_SIZE_T
96 #if defined(_LP64) || defined(_I32LPx)
97 typedef unsigned long	size_t;		/* size of something in bytes */
98 #else
99 typedef unsigned int	size_t;		/* (historical version) */
100 #endif
101 #endif	/* !_SIZE_T */
102 
103 #if defined(_LP64) || _FILE_OFFSET_BITS == 32
104 typedef long		fpos_t;
105 #else
106 typedef	__longlong_t	fpos_t;
107 #endif
108 
109 #if __cplusplus >= 199711L
110 }
111 #endif /* end of namespace std */
112 
113 #ifndef	NULL
114 #if defined(_LP64)
115 #define	NULL	0L
116 #else
117 #define	NULL	0
118 #endif
119 #endif
120 
121 #define	BUFSIZ	1024
122 
123 /*
124  * The value of _NFILE is defined in the Processor Specific ABI.  The value
125  * is chosen for historical reasons rather than for truly processor related
126  * attribute.  Note that the SPARC Processor Specific ABI uses the common
127  * UNIX historical value of 20 so it is allowed to fall through.
128  */
129 #if defined(__i386)
130 #define	_NFILE	60	/* initial number of streams: Intel x86 ABI */
131 #else
132 #define	_NFILE	20	/* initial number of streams: SPARC ABI and default */
133 #endif
134 
135 #define	_SBFSIZ	8	/* compatibility with shared libs */
136 
137 #define	_IOFBF		0000	/* full buffered */
138 #define	_IOLBF		0100	/* line buffered */
139 #define	_IONBF		0004	/* not buffered */
140 #define	_IOEOF		0020	/* EOF reached on read */
141 #define	_IOERR		0040	/* I/O error from system */
142 
143 #define	_IOREAD		0001	/* currently reading */
144 #define	_IOWRT		0002	/* currently writing */
145 #define	_IORW		0200	/* opened for reading and writing */
146 #define	_IOMYBUF	0010	/* stdio malloc()'d buffer */
147 
148 #ifndef EOF
149 #define	EOF	(-1)
150 #endif
151 
152 #define	FOPEN_MAX	_NFILE
153 #define	FILENAME_MAX    1024	/* max # of characters in a path name */
154 
155 #define	SEEK_SET	0
156 #define	SEEK_CUR	1
157 #define	SEEK_END	2
158 #define	TMP_MAX		17576	/* 26 * 26 * 26 */
159 
160 #define	L_tmpnam	25	/* (sizeof(P_tmpdir) + 15) */
161 
162 #if defined(__STDC__)
163 extern __FILE	__iob[_NFILE];
164 #define	stdin	(&__iob[0])
165 #define	stdout	(&__iob[1])
166 #define	stderr	(&__iob[2])
167 #else
168 extern __FILE	_iob[_NFILE];
169 #define	stdin	(&_iob[0])
170 #define	stdout	(&_iob[1])
171 #define	stderr	(&_iob[2])
172 #endif	/* __STDC__ */
173 
174 #if __cplusplus >= 199711L
175 namespace std {
176 #endif
177 
178 #if !defined(_LP64) && !defined(_LONGLONG_TYPE)
179 
180 #ifdef __PRAGMA_REDEFINE_EXTNAME
181 #pragma redefine_extname fprintf	_fprintf_c89
182 #pragma redefine_extname printf		_printf_c89
183 #pragma redefine_extname sprintf	_sprintf_c89
184 #pragma redefine_extname vfprintf	_vfprintf_c89
185 #pragma redefine_extname vprintf	_vprintf_c89
186 #pragma redefine_extname vsprintf	_vsprintf_c89
187 #pragma redefine_extname fscanf		_fscanf_c89
188 #pragma redefine_extname scanf		_scanf_c89
189 #pragma redefine_extname sscanf		_sscanf_c89
190 #else
191 #define	fprintf		_fprintf_c89
192 #define	printf		_printf_c89
193 #define	sprintf		_sprintf_c89
194 #define	vfprintf	_vfprintf_c89
195 #define	vprintf		_vprintf_c89
196 #define	vsprintf	_vsprintf_c89
197 #define	fscanf		_fscanf_c89
198 #define	scanf		_scanf_c89
199 #define	sscanf		_sscanf_c89
200 #endif
201 
202 #endif /* !defined(_LP64) && !defined(_LONGLONG_TYPE) */
203 
204 #if defined(__STDC__)
205 
206 extern int	remove(const char *);
207 extern int	rename(const char *, const char *);
208 extern FILE	*tmpfile(void);
209 extern char	*tmpnam(char *);
210 extern int	fclose(FILE *);
211 extern int	fflush(FILE *);
212 extern FILE	*fopen(const char *_RESTRICT_KYWD, const char *_RESTRICT_KYWD);
213 extern FILE	*freopen(const char *_RESTRICT_KYWD,
214 			const char *_RESTRICT_KYWD, FILE *_RESTRICT_KYWD);
215 extern void	setbuf(FILE *_RESTRICT_KYWD, char *_RESTRICT_KYWD);
216 extern int	setvbuf(FILE *_RESTRICT_KYWD, char *_RESTRICT_KYWD, int,
217 			size_t);
218 /* PRINTFLIKE2 */
219 extern int	fprintf(FILE *_RESTRICT_KYWD, const char *_RESTRICT_KYWD, ...);
220 /* SCANFLIKE2 */
221 extern int	fscanf(FILE *_RESTRICT_KYWD, const char *_RESTRICT_KYWD, ...);
222 /* PRINTFLIKE1 */
223 extern int	printf(const char *_RESTRICT_KYWD, ...);
224 /* SCANFLIKE1 */
225 extern int	scanf(const char *_RESTRICT_KYWD, ...);
226 /* PRINTFLIKE2 */
227 extern int	sprintf(char *_RESTRICT_KYWD, const char *_RESTRICT_KYWD, ...);
228 /* SCANFLIKE2 */
229 extern int	sscanf(const char *_RESTRICT_KYWD,
230 			const char *_RESTRICT_KYWD, ...);
231 extern int	vfprintf(FILE *_RESTRICT_KYWD, const char *_RESTRICT_KYWD,
232 			__va_list);
233 extern int	vprintf(const char *_RESTRICT_KYWD, __va_list);
234 extern int	vsprintf(char *_RESTRICT_KYWD, const char *_RESTRICT_KYWD,
235 			__va_list);
236 extern int	fgetc(FILE *);
237 extern char	*fgets(char *_RESTRICT_KYWD, int, FILE *_RESTRICT_KYWD);
238 extern int	fputc(int, FILE *);
239 extern int	fputs(const char *_RESTRICT_KYWD, FILE *_RESTRICT_KYWD);
240 #if (__cplusplus >= 199711L && (defined(_LP64) || defined(_REENTRANT))) || \
241 	__cplusplus < 199711L
242 extern int	getc(FILE *);
243 extern int	putc(int, FILE *);
244 #endif
245 #if (__cplusplus >= 199711L && defined(_REENTRANT)) || \
246 	__cplusplus < 199711L
247 extern int	getchar(void);
248 extern int	putchar(int);
249 #endif
250 extern char	*gets(char *);
251 extern int	puts(const char *);
252 extern int	ungetc(int, FILE *);
253 extern size_t	fread(void *_RESTRICT_KYWD, size_t, size_t,
254 	FILE *_RESTRICT_KYWD);
255 extern size_t	fwrite(const void *_RESTRICT_KYWD, size_t, size_t,
256 	FILE *_RESTRICT_KYWD);
257 #if !defined(__lint) || defined(_LP64) || _FILE_OFFSET_BITS == 32
258 extern int	fgetpos(FILE *_RESTRICT_KYWD, fpos_t *_RESTRICT_KYWD);
259 extern int	fsetpos(FILE *, const fpos_t *);
260 #endif
261 extern int	fseek(FILE *, long, int);
262 extern long	ftell(FILE *);
263 extern void	rewind(FILE *);
264 #if (__cplusplus >= 199711L && (defined(_LP64) || defined(_REENTRANT))) || \
265 	__cplusplus < 199711L
266 extern void	clearerr(FILE *);
267 extern int	feof(FILE *);
268 extern int	ferror(FILE *);
269 #endif
270 extern void	perror(const char *);
271 
272 #ifndef	_LP64
273 extern int	__filbuf(FILE *);
274 extern int	__flsbuf(int, FILE *);
275 #endif	/*	_LP64	*/
276 
277 #else	/* !defined __STDC__ */
278 
279 extern int	remove();
280 extern int	rename();
281 extern FILE	*tmpfile();
282 extern char	*tmpnam();
283 extern int	fclose();
284 extern int	fflush();
285 extern FILE	*fopen();
286 extern FILE	*freopen();
287 extern void	setbuf();
288 extern int	setvbuf();
289 extern int	fprintf();
290 extern int	fscanf();
291 extern int	printf();
292 extern int	scanf();
293 extern int	sprintf();
294 extern int	sscanf();
295 extern int	vfprintf();
296 extern int	vprintf();
297 extern int	vsprintf();
298 extern int	fgetc();
299 extern char	*fgets();
300 extern int	fputc();
301 extern int	fputs();
302 extern int	getc();
303 extern int	getchar();
304 extern char	*gets();
305 extern int	putc();
306 extern int	putchar();
307 extern int	puts();
308 extern int	ungetc();
309 extern size_t	fread();
310 extern size_t	fwrite();
311 extern int	fgetpos();
312 extern int	fseek();
313 extern int	fsetpos();
314 extern long	ftell();
315 extern void	rewind();
316 extern void	clearerr();
317 extern int	feof();
318 extern int	ferror();
319 extern void	perror();
320 
321 #ifndef	_LP64
322 extern int	_filbuf();
323 extern int	_flsbuf();
324 #endif	/*	_LP64	*/
325 
326 #endif	/* __STDC__ */
327 
328 #if __cplusplus >= 199711L
329 }
330 #endif /* end of namespace std */
331 
332 #if !defined(__lint)
333 
334 #if	!defined(_REENTRANT) && !defined(_LP64) && !defined(_STRICT_STDC)
335 
336 #ifdef	__STDC__
337 #if __cplusplus >= 199711L
338 namespace std {
339 inline int getc(FILE *_p) {
340 	return (--_p->_cnt < 0 ? __filbuf(_p) : (int)*_p->_ptr++); }
341 inline int putc(int _x, FILE *_p) {
342 	return (--_p->_cnt < 0 ? __flsbuf(_x, _p)
343 		: (int)(*_p->_ptr++ = (unsigned char) _x)); }
344 }
345 #else /* __cplusplus >= 199711L */
346 #define	getc(p)		(--(p)->_cnt < 0 ? __filbuf(p) : (int)*(p)->_ptr++)
347 #define	putc(x, p)	(--(p)->_cnt < 0 ? __flsbuf((x), (p)) \
348 				: (int)(*(p)->_ptr++ = (unsigned char) (x)))
349 #endif /* __cplusplus >= 199711L */
350 #else /* __STDC__ */
351 #define	getc(p)		(--(p)->_cnt < 0 ? _filbuf(p) : (int)*(p)->_ptr++)
352 #define	putc(x, p)	(--(p)->_cnt < 0 ? _flsbuf((x), (p)) : \
353 				(int)(*(p)->_ptr++ = (unsigned char) (x)))
354 #endif	/* __STDC__ */
355 
356 #endif /* !defined(_REENTRANT) && !defined(_LP64) && !defined(_STRICT_STDC) */
357 
358 #ifndef	_REENTRANT
359 
360 #if __cplusplus >= 199711L
361 namespace std {
362 inline int getchar() { return getc(stdin); }
363 inline int putchar(int _x) { return putc(_x, stdout); }
364 }
365 #else
366 #define	getchar()	getc(stdin)
367 #define	putchar(x)	putc((x), stdout)
368 #endif /* __cplusplus >= 199711L */
369 
370 #ifndef	_LP64
371 #if __cplusplus >= 199711L
372 namespace std {
373 inline void clearerr(FILE *_p) { _p->_flag &= ~(_IOERR | _IOEOF); }
374 inline int feof(FILE *_p) { return _p->_flag & _IOEOF; }
375 inline int ferror(FILE *_p) { return _p->_flag & _IOERR; }
376 }
377 #else /* __cplusplus >= 199711L */
378 #define	clearerr(p)	((void)((p)->_flag &= ~(_IOERR | _IOEOF)))
379 #define	feof(p)		((p)->_flag & _IOEOF)
380 #define	ferror(p)	((p)->_flag & _IOERR)
381 #endif /* __cplusplus >= 199711L */
382 #endif	/* _LP64 */
383 
384 #endif	/* _REENTRANT */
385 
386 #endif	/* !defined(__lint) */
387 
388 #ifdef	__cplusplus
389 }
390 #endif
391 
392 #endif	/* _ISO_STDIO_ISO_H */
393