a69d75b485fbeffbc09c0cc2a37fd0146246ee7e
[kopensolaris-gnu/glibc.git] / libio / libioP.h
1 /* Copyright (C) 1993, 1997 Free Software Foundation, Inc.
2    This file is part of the GNU IO Library.
3
4    This library is free software; you can redistribute it and/or
5    modify it under the terms of the GNU General Public License as
6    published by the Free Software Foundation; either version 2, or (at
7    your option) any later version.
8
9    This library is distributed in the hope that it will be useful, but
10    WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12    General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this library; see the file COPYING.  If not, write to
16    the Free Software Foundation, 59 Temple Place - Suite 330, Boston,
17    MA 02111-1307, USA.
18
19    As a special exception, if you link this library with files
20    compiled with a GNU compiler to produce an executable, this does
21    not cause the resulting executable to be covered by the GNU General
22    Public License.  This exception does not however invalidate any
23    other reasons why the executable file might be covered by the GNU
24    General Public License.  */
25
26 #include <errno.h>
27 #ifndef __set_errno
28 # define __set_errno(Val) errno = (Val)
29 #endif
30 #if defined __GLIBC__ && __GLIBC__ >= 2
31 # include <bits/libc-lock.h>
32 #else
33 /*# include <comthread.h>*/
34 #endif
35
36 #include "iolibio.h"
37
38 #ifdef __cplusplus
39 extern "C" {
40 #endif
41
42 #define _IO_seek_set 0
43 #define _IO_seek_cur 1
44 #define _IO_seek_end 2
45
46 /* THE JUMPTABLE FUNCTIONS.
47
48  * The _IO_FILE type is used to implement the FILE type in GNU libc,
49  * as well as the streambuf class in GNU iostreams for C++.
50  * These are all the same, just used differently.
51  * An _IO_FILE (or FILE) object is allows followed by a pointer to
52  * a jump table (of pointers to functions).  The pointer is accessed
53  * with the _IO_JUMPS macro.  The jump table has a eccentric format,
54  * so as to be compatible with the layout of a C++ virtual function table.
55  * (as implemented by g++).  When a pointer to a streambuf object is
56  * coerced to an (_IO_FILE*), then _IO_JUMPS on the result just
57  * happens to point to the virtual function table of the streambuf.
58  * Thus the _IO_JUMPS function table used for C stdio/libio does
59  * double duty as the virtual function table for C++ streambuf.
60  *
61  * The entries in the _IO_JUMPS function table (and hence also the
62  * virtual functions of a streambuf) are described below.
63  * The first parameter of each function entry is the _IO_FILE/streambuf
64  * object being acted on (i.e. the 'this' parameter).
65  */
66
67 #define _IO_JUMPS(THIS) ((struct _IO_FILE_plus *) (THIS))->vtable
68 #ifdef _G_USING_THUNKS
69 # define JUMP_FIELD(TYPE, NAME) TYPE NAME
70 # define JUMP0(FUNC, THIS) _IO_JUMPS(THIS)->FUNC (THIS)
71 # define JUMP1(FUNC, THIS, X1) _IO_JUMPS(THIS)->FUNC (THIS, X1)
72 # define JUMP2(FUNC, THIS, X1, X2) _IO_JUMPS(THIS)->FUNC (THIS, X1, X2)
73 # define JUMP3(FUNC, THIS, X1,X2,X3) _IO_JUMPS(THIS)->FUNC (THIS, X1,X2, X3)
74 # define JUMP_INIT(NAME, VALUE) VALUE
75 # define JUMP_INIT_DUMMY JUMP_INIT(dummy, 0), JUMP_INIT (dummy2, 0)
76 #else
77 /* These macros will change when we re-implement vtables to use "thunks"! */
78 # define JUMP_FIELD(TYPE, NAME) struct { short delta1, delta2; TYPE pfn; } NAME
79 # define JUMP0(FUNC, THIS) _IO_JUMPS(THIS)->FUNC.pfn (THIS)
80 # define JUMP1(FUNC, THIS, X1) _IO_JUMPS(THIS)->FUNC.pfn (THIS, X1)
81 # define JUMP2(FUNC, THIS, X1, X2) _IO_JUMPS(THIS)->FUNC.pfn (THIS, X1, X2)
82 # define JUMP3(FUNC, THIS, X1,X2,X3) _IO_JUMPS(THIS)->FUNC.pfn (THIS, X1,X2,X3)
83 # define JUMP_INIT(NAME, VALUE) {0, 0, VALUE}
84 # define JUMP_INIT_DUMMY JUMP_INIT(dummy, 0)
85 #endif
86
87 /* The 'finish' function does any final cleaning up of an _IO_FILE object.
88    It does not delete (free) it, but does everything else to finalize it/
89    It matches the streambuf::~streambuf virtual destructor.  */
90 typedef void (*_IO_finish_t) __P ((_IO_FILE *, int)); /* finalize */
91 #define _IO_FINISH(FP) JUMP1 (__finish, FP, 0)
92
93 /* The 'overflow' hook flushes the buffer.
94    The second argument is a character, or EOF.
95    It matches the streambuf::overflow virtual function. */
96 typedef int (*_IO_overflow_t) __P ((_IO_FILE *, int));
97 #define _IO_OVERFLOW(FP, CH) JUMP1 (__overflow, FP, CH)
98
99 /* The 'underflow' hook tries to fills the get buffer.
100    It returns the next character (as an unsigned char) or EOF.  The next
101    character remains in the get buffer, and the get position is not changed.
102    It matches the streambuf::underflow virtual function. */
103 typedef int (*_IO_underflow_t) __P ((_IO_FILE *));
104 #define _IO_UNDERFLOW(FP) JUMP0 (__underflow, FP)
105
106 /* The 'uflow' hook returns the next character in the input stream
107    (cast to unsigned char), and increments the read position;
108    EOF is returned on failure.
109    It matches the streambuf::uflow virtual function, which is not in the
110    cfront implementation, but was added to C++ by the ANSI/ISO committee. */
111 #define _IO_UFLOW(FP) JUMP0 (__uflow, FP)
112
113 /* The 'pbackfail' hook handles backing up.
114    It matches the streambuf::pbackfail virtual function. */
115 typedef int (*_IO_pbackfail_t) __P ((_IO_FILE *, int));
116 #define _IO_PBACKFAIL(FP, CH) JUMP1 (__pbackfail, FP, CH)
117
118 /* The 'xsputn' hook writes upto N characters from buffer DATA.
119    Returns the number of character actually written.
120    It matches the streambuf::xsputn virtual function. */
121 typedef _IO_size_t (*_IO_xsputn_t) __P ((_IO_FILE *FP, const void *DATA,
122                                          _IO_size_t N));
123 #define _IO_XSPUTN(FP, DATA, N) JUMP2 (__xsputn, FP, DATA, N)
124
125 /* The 'xsgetn' hook reads upto N characters into buffer DATA.
126    Returns the number of character actually read.
127    It matches the streambuf::xsgetn virtual function. */
128 typedef _IO_size_t (*_IO_xsgetn_t) __P ((_IO_FILE *FP, void *DATA,
129                                          _IO_size_t N));
130 #define _IO_XSGETN(FP, DATA, N) JUMP2 (__xsgetn, FP, DATA, N)
131
132 /* The 'seekoff' hook moves the stream position to a new position
133    relative to the start of the file (if DIR==0), the current position
134    (MODE==1), or the end of the file (MODE==2).
135    It matches the streambuf::seekoff virtual function.
136    It is also used for the ANSI fseek function. */
137 typedef _IO_fpos64_t (*_IO_seekoff_t) __P ((_IO_FILE *FP, _IO_off64_t OFF,
138                                           int DIR, int MODE));
139 #define _IO_SEEKOFF(FP, OFF, DIR, MODE) JUMP3 (__seekoff, FP, OFF, DIR, MODE)
140
141 /* The 'seekpos' hook also moves the stream position,
142    but to an absolute position given by a fpos64_t (seekpos).
143    It matches the streambuf::seekpos virtual function.
144    It is also used for the ANSI fgetpos and fsetpos functions.  */
145 /* The _IO_seek_cur and _IO_seek_end options are not allowed. */
146 typedef _IO_fpos64_t (*_IO_seekpos_t) __P ((_IO_FILE *, _IO_fpos64_t, int));
147 #define _IO_SEEKPOS(FP, POS, FLAGS) JUMP2 (__seekpos, FP, POS, FLAGS)
148
149 /* The 'setbuf' hook gives a buffer to the file.
150    It matches the streambuf::setbuf virtual function. */
151 typedef _IO_FILE* (*_IO_setbuf_t) __P ((_IO_FILE *, char *, _IO_ssize_t));
152 #define _IO_SETBUF(FP, BUFFER, LENGTH) JUMP2 (__setbuf, FP, BUFFER, LENGTH)
153
154 /* The 'sync' hook attempts to synchronize the internal data structures
155    of the file with the external state.
156    It matches the streambuf::sync virtual function. */
157 typedef int (*_IO_sync_t) __P ((_IO_FILE *));
158 #define _IO_SYNC(FP) JUMP0 (__sync, FP)
159
160 /* The 'doallocate' hook is used to tell the file to allocate a buffer.
161    It matches the streambuf::doallocate virtual function, which is not
162    in the ANSI/ISO C++ standard, but is part traditional implementations. */
163 typedef int (*_IO_doallocate_t) __P ((_IO_FILE *));
164 #define _IO_DOALLOCATE(FP) JUMP0 (__doallocate, FP)
165
166 /* The following four hooks (sysread, syswrite, sysclose, sysseek, and
167    sysstat) are low-level hooks specific to this implementation.
168    There is no correspondence in the ANSI/ISO C++ standard library.
169    The hooks basically correspond to the Unix system functions
170    (read, write, close, lseek, and stat) except that a _IO_FILE*
171    parameter is used instead of a integer file descriptor;  the default
172    implementation used for normal files just calls those functions.
173    The advantage of overriding these functions instead of the higher-level
174    ones (underflow, overflow etc) is that you can leave all the buffering
175    higher-level functions.  */
176
177 /* The 'sysread' hook is used to read data from the external file into
178    an existing buffer.  It generalizes the Unix read(2) function.
179    It matches the streambuf::sys_read virtual function, which is
180    specific to this implementation. */
181 typedef _IO_ssize_t (*_IO_read_t) __P ((_IO_FILE *, void *, _IO_ssize_t));
182 #define _IO_SYSREAD(FP, DATA, LEN) JUMP2 (__read, FP, DATA, LEN)
183
184 /* The 'syswrite' hook is used to write data from an existing buffer
185    to an external file.  It generalizes the Unix write(2) function.
186    It matches the streambuf::sys_write virtual function, which is
187    specific to this implementation. */
188 typedef _IO_ssize_t (*_IO_write_t) __P ((_IO_FILE *,const void *,_IO_ssize_t));
189 #define _IO_SYSWRITE(FP, DATA, LEN) JUMP2 (__write, FP, DATA, LEN)
190
191 /* The 'sysseek' hook is used to re-position an external file.
192    It generalizes the Unix lseek(2) function.
193    It matches the streambuf::sys_seek virtual function, which is
194    specific to this implementation. */
195 typedef _IO_fpos64_t (*_IO_seek_t) __P ((_IO_FILE *, _IO_off64_t, int));
196 #define _IO_SYSSEEK(FP, OFFSET, MODE) JUMP2 (__seek, FP, OFFSET, MODE)
197
198 /* The 'sysclose' hook is used to finalize (close, finish up) an
199    external file.  It generalizes the Unix close(2) function.
200    It matches the streambuf::sys_close virtual function, which is
201    specific to this implementation. */
202 typedef int (*_IO_close_t) __P ((_IO_FILE *)); /* finalize */
203 #define _IO_SYSCLOSE(FP) JUMP0 (__close, FP)
204
205 /* The 'sysstat' hook is used to get information about an external file
206    into a struct stat buffer.  It generalizes the Unix fstat(2) call.
207    It matches the streambuf::sys_stat virtual function, which is
208    specific to this implementation. */
209 typedef int (*_IO_stat_t) __P ((_IO_FILE *, void *));
210 #define _IO_SYSSTAT(FP, BUF) JUMP1 (__stat, FP, BUF)
211
212 /* The 'showmany' hook can be used to get an image how much input is
213    available.  In many cases the answer will be 0 which means unknown
214    but some cases one can provide real information.  */
215 typedef int (*_IO_showmanyc_t) __P ((_IO_FILE *));
216 #define _IO_SHOWMANYC(FP) JUMP0 (__showmanyc, FP)
217
218 /* The 'imbue' hook is used to get information about the currently
219    installed locales.  */
220 typedef void (*_IO_imbue_t) __P ((_IO_FILE *, void *));
221 #define _IO_IMBUE(FP, LOCALE) JUMP1 (__imbue, FP, LOCALE)
222
223
224 #define _IO_CHAR_TYPE char /* unsigned char ? */
225 #define _IO_INT_TYPE int
226
227 struct _IO_jump_t
228 {
229     JUMP_FIELD(_G_size_t, __dummy);
230 #ifdef _G_USING_THUNKS
231     JUMP_FIELD(_G_size_t, __dummy2);
232 #endif
233     JUMP_FIELD(_IO_finish_t, __finish);
234     JUMP_FIELD(_IO_overflow_t, __overflow);
235     JUMP_FIELD(_IO_underflow_t, __underflow);
236     JUMP_FIELD(_IO_underflow_t, __uflow);
237     JUMP_FIELD(_IO_pbackfail_t, __pbackfail);
238     /* showmany */
239     JUMP_FIELD(_IO_xsputn_t, __xsputn);
240     JUMP_FIELD(_IO_xsgetn_t, __xsgetn);
241     JUMP_FIELD(_IO_seekoff_t, __seekoff);
242     JUMP_FIELD(_IO_seekpos_t, __seekpos);
243     JUMP_FIELD(_IO_setbuf_t, __setbuf);
244     JUMP_FIELD(_IO_sync_t, __sync);
245     JUMP_FIELD(_IO_doallocate_t, __doallocate);
246     JUMP_FIELD(_IO_read_t, __read);
247     JUMP_FIELD(_IO_write_t, __write);
248     JUMP_FIELD(_IO_seek_t, __seek);
249     JUMP_FIELD(_IO_close_t, __close);
250     JUMP_FIELD(_IO_stat_t, __stat);
251     JUMP_FIELD(_IO_showmanyc_t, __showmanyc);
252     JUMP_FIELD(_IO_imbue_t, __imbue);
253 #if 0
254     get_column;
255     set_column;
256 #endif
257 };
258
259 /* We always allocate an extra word following an _IO_FILE.
260    This contains a pointer to the function jump table used.
261    This is for compatibility with C++ streambuf; the word can
262    be used to smash to a pointer to a virtual function table. */
263
264 struct _IO_FILE_plus
265 {
266   _IO_FILE file;
267   const struct _IO_jump_t *vtable;
268 };
269
270 /* We had to extend _IO_FILE but this isn't easily possible without
271    compatibility problems.  So we mimic the C++ way to do this which
272    especially takes care that the position of the vtable stays the
273    same.  */
274 struct _IO_FILE_complete
275 {
276   struct _IO_FILE_plus plus;
277   _IO_off64_t _offset;
278   int _unused2[16];     /* Make sure we don't get into trouble again.  */
279 };
280
281 /* Generic functions */
282
283 extern _IO_fpos64_t _IO_seekoff __P ((_IO_FILE *, _IO_off64_t, int, int));
284 extern _IO_fpos64_t _IO_seekpos __P ((_IO_FILE *, _IO_fpos64_t, int));
285
286 extern void _IO_switch_to_main_get_area __P ((_IO_FILE *));
287 extern void _IO_switch_to_backup_area __P ((_IO_FILE *));
288 extern int _IO_switch_to_get_mode __P ((_IO_FILE *));
289 extern void _IO_init __P ((_IO_FILE *, int));
290 extern int _IO_sputbackc __P ((_IO_FILE *, int));
291 extern int _IO_sungetc __P ((_IO_FILE *));
292 extern void _IO_un_link __P ((_IO_FILE *));
293 extern void _IO_link_in __P ((_IO_FILE *));
294 extern void _IO_doallocbuf __P ((_IO_FILE *));
295 extern void _IO_unsave_markers __P ((_IO_FILE *));
296 extern void _IO_setb __P ((_IO_FILE *, char *, char *, int));
297 extern unsigned _IO_adjust_column __P ((unsigned, const char *, int));
298 #define _IO_sputn(__fp, __s, __n) _IO_XSPUTN (__fp, __s, __n)
299
300 /* Marker-related function. */
301
302 extern void _IO_init_marker __P ((struct _IO_marker *, _IO_FILE *));
303 extern void _IO_remove_marker __P ((struct _IO_marker *));
304 extern int _IO_marker_difference __P ((struct _IO_marker *,
305                                        struct _IO_marker *));
306 extern int _IO_marker_delta __P ((struct _IO_marker *));
307 extern int _IO_seekmark __P ((_IO_FILE *, struct _IO_marker *, int));
308
309 /* Default jumptable functions. */
310
311 extern int _IO_default_underflow __P ((_IO_FILE *));
312 extern int _IO_default_uflow __P ((_IO_FILE *));
313 extern int _IO_default_doallocate __P ((_IO_FILE *));
314 extern void _IO_default_finish __P ((_IO_FILE *, int));
315 extern int _IO_default_pbackfail __P ((_IO_FILE *, int));
316 extern _IO_FILE* _IO_default_setbuf __P ((_IO_FILE *, char *, _IO_ssize_t));
317 extern _IO_size_t _IO_default_xsputn __P ((_IO_FILE *, const void *,
318                                            _IO_size_t));
319 extern _IO_size_t _IO_default_xsgetn __P ((_IO_FILE *, void *, _IO_size_t));
320 extern _IO_fpos64_t _IO_default_seekoff __P ((_IO_FILE *,
321                                               _IO_off64_t, int, int));
322 extern _IO_fpos64_t _IO_default_seekpos __P ((_IO_FILE *,
323                                               _IO_fpos64_t, int));
324 extern _IO_ssize_t _IO_default_write __P ((_IO_FILE *, const void *,
325                                            _IO_ssize_t));
326 extern _IO_ssize_t _IO_default_read __P ((_IO_FILE *, void *, _IO_ssize_t));
327 extern int _IO_default_stat __P ((_IO_FILE *, void *));
328 extern _IO_fpos64_t _IO_default_seek __P ((_IO_FILE *, _IO_off64_t, int));
329 extern int _IO_default_sync __P ((_IO_FILE *));
330 #define _IO_default_close ((_IO_close_t) _IO_default_sync)
331 extern int _IO_default_showmanyc __P ((_IO_FILE *));
332 extern void _IO_default_imbue __P ((_IO_FILE *, void *));
333
334 extern struct _IO_jump_t _IO_file_jumps;
335 extern struct _IO_jump_t _IO_new_file_jumps;
336 extern struct _IO_jump_t _IO_old_file_jumps;
337 extern struct _IO_jump_t _IO_streambuf_jumps;
338 extern struct _IO_jump_t _IO_proc_jumps;
339 extern struct _IO_jump_t _IO_str_jumps;
340 extern int _IO_do_write __P ((_IO_FILE *, const char *, _IO_size_t));
341 extern int _IO_old_do_write __P ((_IO_FILE *, const char *, _IO_size_t));
342 extern int _IO_flush_all __P ((void));
343 extern void _IO_cleanup __P ((void));
344 extern void _IO_flush_all_linebuffered __P ((void));
345
346 #define _IO_do_flush(_f) \
347   _IO_do_write(_f, (_f)->_IO_write_base, \
348                (_f)->_IO_write_ptr-(_f)->_IO_write_base)
349 #define _IO_old_do_flush(_f) \
350   _IO_old_do_write(_f, (_f)->_IO_write_base, \
351                    (_f)->_IO_write_ptr-(_f)->_IO_write_base)
352 #define _IO_in_put_mode(_fp) ((_fp)->_flags & _IO_CURRENTLY_PUTTING)
353 #define _IO_mask_flags(fp, f, mask) \
354        ((fp)->_flags = ((fp)->_flags & ~(mask)) | ((f) & (mask)))
355 #define _IO_setg(fp, eb, g, eg)  ((fp)->_IO_read_base = (eb),\
356         (fp)->_IO_read_ptr = (g), (fp)->_IO_read_end = (eg))
357 #define _IO_setp(__fp, __p, __ep) \
358        ((__fp)->_IO_write_base = (__fp)->_IO_write_ptr = __p, (__fp)->_IO_write_end = (__ep))
359 #define _IO_have_backup(fp) ((fp)->_IO_save_base != NULL)
360 #define _IO_in_backup(fp) ((fp)->_flags & _IO_IN_BACKUP)
361 #define _IO_have_markers(fp) ((fp)->_markers != NULL)
362 #define _IO_blen(fp) ((fp)->_IO_buf_end - (fp)->_IO_buf_base)
363
364 /* Jumptable functions for files. */
365
366 extern int _IO_file_doallocate __P ((_IO_FILE *));
367 extern _IO_FILE* _IO_file_setbuf __P ((_IO_FILE *, char *, _IO_ssize_t));
368 extern _IO_fpos64_t _IO_file_seekoff __P ((_IO_FILE *, _IO_off64_t, int, int));
369 extern _IO_size_t _IO_file_xsputn __P ((_IO_FILE *, const void *, _IO_size_t));
370 extern int _IO_file_stat __P ((_IO_FILE *, void *));
371 extern int _IO_file_close __P ((_IO_FILE *));
372 extern int _IO_file_underflow __P ((_IO_FILE *));
373 extern int _IO_file_overflow __P ((_IO_FILE *, int));
374 #define _IO_file_is_open(__fp) ((__fp)->_fileno >= 0)
375 extern void _IO_file_init __P ((_IO_FILE *));
376 extern _IO_FILE* _IO_file_attach __P ((_IO_FILE *, int));
377 extern _IO_FILE* _IO_file_fopen __P ((_IO_FILE *, const char *, const char *,
378                                       int));
379 extern _IO_ssize_t _IO_file_write __P ((_IO_FILE *, const void *,
380                                         _IO_ssize_t));
381 extern _IO_ssize_t _IO_file_read __P ((_IO_FILE *, void *, _IO_ssize_t));
382 extern int _IO_file_sync __P ((_IO_FILE *));
383 extern int _IO_file_close_it __P ((_IO_FILE *));
384 extern _IO_fpos64_t _IO_file_seek __P ((_IO_FILE *, _IO_off64_t, int));
385 extern void _IO_file_finish __P ((_IO_FILE *, int));
386
387 extern _IO_FILE* _IO_old_file_setbuf __P ((_IO_FILE *, char *, _IO_ssize_t));
388 extern _IO_fpos64_t _IO_old_file_seekoff __P ((_IO_FILE *, _IO_off64_t, int,
389                                                int));
390 extern _IO_size_t _IO_old_file_xsputn __P ((_IO_FILE *, const void *,
391                                             _IO_size_t));
392 extern int _IO_old_file_underflow __P ((_IO_FILE *));
393 extern int _IO_old_file_overflow __P ((_IO_FILE *, int));
394 extern void _IO_old_file_init __P ((_IO_FILE *));
395 extern _IO_FILE* _IO_old_file_attach __P ((_IO_FILE *, int));
396 extern _IO_FILE* _IO_old_file_fopen __P ((_IO_FILE *, const char *,
397                                           const char *));
398 extern _IO_ssize_t _IO_old_file_write __P ((_IO_FILE *, const void *,
399                                             _IO_ssize_t));
400 extern int _IO_old_file_sync __P ((_IO_FILE *));
401 extern int _IO_old_file_close_it __P ((_IO_FILE *));
402 extern void _IO_old_file_finish __P ((_IO_FILE *, int));
403
404 /* Jumptable functions for proc_files. */
405 extern _IO_FILE* _IO_proc_open __P ((_IO_FILE *, const char *, const char *));
406 extern int _IO_proc_close __P ((_IO_FILE *));
407
408 /* Jumptable functions for strfiles. */
409 extern int _IO_str_underflow __P ((_IO_FILE *));
410 extern int _IO_str_overflow __P ((_IO_FILE *, int));
411 extern int _IO_str_pbackfail __P ((_IO_FILE *, int));
412 extern _IO_fpos64_t _IO_str_seekoff __P ((_IO_FILE *, _IO_off64_t, int, int));
413 extern void _IO_str_finish __P ((_IO_FILE *, int));
414
415 /* Other strfile functions */
416 extern void _IO_str_init_static __P ((_IO_FILE *, char *, int, char *));
417 extern void _IO_str_init_readonly __P ((_IO_FILE *, const char *, int));
418 extern _IO_ssize_t _IO_str_count __P ((_IO_FILE *));
419
420 extern int _IO_vasprintf __P ((char **result_ptr, __const char *format,
421                                _IO_va_list args));
422 extern int _IO_vdprintf __P ((int d, __const char *format, _IO_va_list arg));
423 extern int _IO_vsnprintf __P ((char *string, _IO_size_t maxlen,
424                                __const char *format, _IO_va_list args));
425
426
427 extern _IO_size_t _IO_getline __P ((_IO_FILE *,char *, _IO_size_t, int, int));
428 extern _IO_ssize_t _IO_getdelim __P ((char **, _IO_size_t *, int, _IO_FILE *));
429 extern double _IO_strtod __P ((const char *, char **));
430 extern char *_IO_dtoa __P ((double __d, int __mode, int __ndigits,
431                             int *__decpt, int *__sign, char **__rve));
432 extern int _IO_outfloat __P ((double __value, _IO_FILE *__sb, int __type,
433                               int __width, int __precision, int __flags,
434                               int __sign_mode, int __fill));
435
436 extern _IO_FILE *_IO_list_all;
437 extern void (*_IO_cleanup_registration_needed) __P ((void));
438
439 #ifndef EOF
440 # define EOF (-1)
441 #endif
442 #ifndef NULL
443 # if defined __GNUG__ && \
444     (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 8))
445 #  define NULL (__null)
446 # else
447 #  if !defined(__cplusplus)
448 #   define NULL ((void*)0)
449 #  else
450 #   define NULL (0)
451 #  endif
452 # endif
453 #endif
454
455 #if _G_HAVE_MMAP
456
457 # include <unistd.h>
458 # include <fcntl.h>
459 # include <sys/mman.h>
460 # include <sys/param.h>
461
462 # if !defined(MAP_ANONYMOUS) && defined(MAP_ANON)
463 #  define MAP_ANONYMOUS MAP_ANON
464 # endif
465
466 # if !defined(MAP_ANONYMOUS) || !defined(EXEC_PAGESIZE)
467 #  undef _G_HAVE_MMAP
468 #  define _G_HAVE_MMAP 0
469 # endif
470
471 #endif /* _G_HAVE_MMAP */
472
473 #if _G_HAVE_MMAP
474
475 # ifdef _LIBC
476 /* When using this code in the GNU libc we must not pollute the name space.  */
477 #  define mmap __mmap
478 #  define munmap __munmap
479 #  define ftruncate __ftruncate
480 # endif
481
482 # define ROUND_TO_PAGE(_S) \
483        (((_S) + EXEC_PAGESIZE - 1) & ~(EXEC_PAGESIZE - 1))
484
485 # define FREE_BUF(_B, _S) \
486        munmap ((_B), ROUND_TO_PAGE (_S))
487 # define ALLOC_BUF(_B, _S, _R) \
488        do {                                                                   \
489           (_B) = (char *) mmap (0, ROUND_TO_PAGE (_S),                        \
490                                 PROT_READ | PROT_WRITE,                       \
491                                 MAP_PRIVATE | MAP_ANONYMOUS, -1, 0);          \
492           if ((_B) == (char *) -1)                                            \
493             return (_R);                                                      \
494        } while (0)
495
496 #else /* _G_HAVE_MMAP */
497
498 # define FREE_BUF(_B, _S) \
499        free(_B)
500 # define ALLOC_BUF(_B, _S, _R) \
501        do {                                                                   \
502           (_B) = (char*)malloc(_S);                                           \
503           if ((_B) == NULL)                                                   \
504             return (_R);                                                      \
505        } while (0)
506
507 #endif /* _G_HAVE_MMAP */
508
509 #ifndef OS_FSTAT
510 # define OS_FSTAT fstat
511 #endif
512 struct stat;
513 extern _IO_ssize_t _IO_read __P ((int, void *, _IO_size_t));
514 extern _IO_ssize_t _IO_write __P ((int, const void *, _IO_size_t));
515 extern _IO_off64_t _IO_lseek __P ((int, _IO_off64_t, int));
516 extern int _IO_close __P ((int));
517 extern int _IO_fstat __P ((int, struct stat *));
518 extern int _IO_vscanf __P ((const char *, _IO_va_list));
519
520 /* Operations on _IO_fpos64_t.
521    Normally, these are trivial, but we provide hooks for configurations
522    where an _IO_fpos64_t is a struct.
523    Note that _IO_off64_t must be an integral type. */
524
525 /* _IO_pos_BAD is an _IO_fpos64_t value indicating error, unknown, or EOF. */
526 #ifndef _IO_pos_BAD
527 # define _IO_pos_BAD ((_IO_fpos64_t) -1)
528 #endif
529 /* _IO_pos_as_off converts an _IO_fpos64_t value to an _IO_off64_t value. */
530 #ifndef _IO_pos_as_off
531 # define _IO_pos_as_off(__pos) ((_IO_off64_t) (__pos))
532 #endif
533 /* _IO_pos_adjust adjust an _IO_fpos64_t by some number of bytes. */
534 #ifndef _IO_pos_adjust
535 # define _IO_pos_adjust(__pos, __delta) ((__pos) += (__delta))
536 #endif
537 /* _IO_pos_0 is an _IO_fpos64_t value indicating beginning of file. */
538 #ifndef _IO_pos_0
539 # define _IO_pos_0 ((_IO_fpos64_t) 0)
540 #endif
541
542 #ifdef __cplusplus
543 }
544 #endif
545
546 #ifdef _IO_MTSAFE_IO
547 /* check following! */
548 # define FILEBUF_LITERAL(CHAIN, FLAGS, FD) \
549        { _IO_MAGIC+_IO_LINKED+_IO_IS_FILEBUF+FLAGS, \
550          0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, CHAIN, FD, \
551            0, 0, 0, 0, { 0 }, &_IO_stdfile_##FD##_lock }
552 #else
553 /* check following! */
554 # define FILEBUF_LITERAL(CHAIN, FLAGS, FD) \
555        { _IO_MAGIC+_IO_LINKED+_IO_IS_FILEBUF+FLAGS, \
556            0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, CHAIN, FD }
557 #endif
558
559 /* VTABLE_LABEL defines NAME as of the CLASS class.
560    CNLENGTH is strlen(#CLASS).  */
561 #ifdef __GNUC__
562 # if _G_VTABLE_LABEL_HAS_LENGTH
563 #  define VTABLE_LABEL(NAME, CLASS, CNLENGTH) \
564   extern char NAME[] asm (_G_VTABLE_LABEL_PREFIX #CNLENGTH #CLASS);
565 # else
566 #  define VTABLE_LABEL(NAME, CLASS, CNLENGTH) \
567   extern char NAME[] asm (_G_VTABLE_LABEL_PREFIX #CLASS);
568 # endif
569 #endif /* __GNUC__ */
570
571 #if !defined(builtinbuf_vtable) && defined(__cplusplus)
572 # ifdef __GNUC__
573 VTABLE_LABEL(builtinbuf_vtable, builtinbuf, 10)
574 # else
575 #  if _G_VTABLE_LABEL_HAS_LENGTH
576 #   define builtinbuf_vtable _G_VTABLE_LABEL_PREFIX_ID##10builtinbuf
577 #  else
578 #   define builtinbuf_vtable _G_VTABLE_LABEL_PREFIX_ID##builtinbuf
579 #  endif
580 # endif
581 #endif /* !defined(builtinbuf_vtable) && defined(__cplusplus) */
582
583 #if defined(__STDC__) || defined(__cplusplus)
584 # define _IO_va_start(args, last) va_start(args, last)
585 #else
586 # define _IO_va_start(args, last) va_start(args)
587 #endif
588
589 extern struct _IO_fake_stdiobuf _IO_stdin_buf, _IO_stdout_buf, _IO_stderr_buf;
590
591 #if 1
592 # define COERCE_FILE(FILE) /* Nothing */
593 #else
594 /* This is part of the kludge for binary compatibility with old stdio. */
595 # define COERCE_FILE(FILE) \
596   (((FILE)->_IO_file_flags & _IO_MAGIC_MASK) == _OLD_MAGIC_MASK \
597     && (FILE) = *(FILE**)&((int*)fp)[1])
598 #endif
599
600 #ifdef EINVAL
601 # define MAYBE_SET_EINVAL __set_errno (EINVAL)
602 #else
603 # define MAYBE_SET_EINVAL /* nothing */
604 #endif
605
606 #ifdef IO_DEBUG
607 # define CHECK_FILE(FILE, RET) \
608         if ((FILE) == NULL) { MAYBE_SET_EINVAL; return RET; } \
609         else { COERCE_FILE(FILE); \
610                if (((FILE)->_IO_file_flags & _IO_MAGIC_MASK) != _IO_MAGIC) \
611           { MAYBE_SET_EINVAL; return RET; }}
612 #else
613 # define CHECK_FILE(FILE, RET) COERCE_FILE (FILE)
614 #endif