1/* Copyright (C) 1993-2024 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Lesser General Public
6 License as published by the Free Software Foundation; either
7 version 2.1 of the License, or (at your option) any later version.
8
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 Lesser General Public License for more details.
13
14 You should have received a copy of the GNU Lesser General Public
15 License along with the GNU C Library; if not, see
16 <https://www.gnu.org/licenses/>.
17
18 As a special exception, if you link the code in this file with
19 files compiled with a GNU compiler to produce an executable,
20 that does not cause the resulting executable to be covered by
21 the GNU Lesser General Public License. This exception does not
22 however invalidate any other reasons why the executable file
23 might be covered by the GNU Lesser General Public License.
24 This exception applies to code released by its copyright holders
25 in files containing the exception. */
26
27/* NOTE: libio is now exclusively used only by glibc since libstdc++ has its
28 own implementation. As a result, functions that were implemented for C++
29 (like *sputn) may no longer have C++ semantics. This is of course only
30 relevant for internal callers of these functions since these functions are
31 not intended for external use otherwise.
32
33 FIXME: All of the C++ cruft eventually needs to go away. */
34
35#ifndef _LIBIOP_H
36#define _LIBIOP_H 1
37
38#include <stddef.h>
39
40#include <errno.h>
41#include <libc-lock.h>
42
43#include <math_ldbl_opt.h>
44
45#include <stdio.h>
46#include <libio/libio.h>
47#include "iolibio.h"
48
49#include <shlib-compat.h>
50#include <pointer_guard.h>
51
52/* For historical reasons this is the name of the sysdeps header that
53 adjusts the libio configuration. */
54#include <_G_config.h>
55
56#define _IO_seek_set 0
57#define _IO_seek_cur 1
58#define _IO_seek_end 2
59
60/* THE JUMPTABLE FUNCTIONS.
61
62 * The _IO_FILE type is used to implement the FILE type in GNU libc,
63 * as well as the streambuf class in GNU iostreams for C++.
64 * These are all the same, just used differently.
65 * An _IO_FILE (or FILE) object is allows followed by a pointer to
66 * a jump table (of pointers to functions). The pointer is accessed
67 * with the _IO_JUMPS macro. The jump table has an eccentric format,
68 * so as to be compatible with the layout of a C++ virtual function table.
69 * (as implemented by g++). When a pointer to a streambuf object is
70 * coerced to an (FILE*), then _IO_JUMPS on the result just
71 * happens to point to the virtual function table of the streambuf.
72 * Thus the _IO_JUMPS function table used for C stdio/libio does
73 * double duty as the virtual function table for C++ streambuf.
74 *
75 * The entries in the _IO_JUMPS function table (and hence also the
76 * virtual functions of a streambuf) are described below.
77 * The first parameter of each function entry is the _IO_FILE/streambuf
78 * object being acted on (i.e. the 'this' parameter).
79 */
80
81/* Setting this macro to 1 enables the use of the _vtable_offset bias
82 in _IO_JUMPS_FUNCS, below. This is only needed for new-format
83 _IO_FILE in libc that must support old binaries (see oldfileops.c). */
84#if SHLIB_COMPAT (libc, GLIBC_2_0, GLIBC_2_1) && !defined _IO_USE_OLD_IO_FILE
85# define _IO_JUMPS_OFFSET 1
86#else
87# define _IO_JUMPS_OFFSET 0
88#endif
89
90/* Type of MEMBER in struct type TYPE. */
91#define _IO_MEMBER_TYPE(TYPE, MEMBER) __typeof__ (((TYPE){}).MEMBER)
92
93/* Essentially ((TYPE *) THIS)->MEMBER, but avoiding the aliasing
94 violation in case THIS has a different pointer type. */
95#define _IO_CAST_FIELD_ACCESS(THIS, TYPE, MEMBER) \
96 (*(_IO_MEMBER_TYPE (TYPE, MEMBER) *)(((char *) (THIS)) \
97 + offsetof(TYPE, MEMBER)))
98
99#define _IO_JUMPS(THIS) (THIS)->vtable
100#define _IO_JUMPS_FILE_plus(THIS) \
101 _IO_CAST_FIELD_ACCESS ((THIS), struct _IO_FILE_plus, vtable)
102#define _IO_WIDE_JUMPS(THIS) \
103 _IO_CAST_FIELD_ACCESS ((THIS), struct _IO_FILE, _wide_data)->_wide_vtable
104#define _IO_CHECK_WIDE(THIS) \
105 (_IO_CAST_FIELD_ACCESS ((THIS), struct _IO_FILE, _wide_data) != NULL)
106
107#if _IO_JUMPS_OFFSET
108# define _IO_JUMPS_FUNC(THIS) \
109 (IO_validate_vtable \
110 (*(struct _IO_jump_t **) ((void *) &_IO_JUMPS_FILE_plus (THIS) \
111 + (THIS)->_vtable_offset)))
112# define _IO_JUMPS_FUNC_UPDATE(THIS, VTABLE) \
113 (*(const struct _IO_jump_t **) ((void *) &_IO_JUMPS_FILE_plus (THIS) \
114 + (THIS)->_vtable_offset) = (VTABLE))
115# define _IO_vtable_offset(THIS) (THIS)->_vtable_offset
116#else
117# define _IO_JUMPS_FUNC(THIS) (IO_validate_vtable (_IO_JUMPS_FILE_plus (THIS)))
118# define _IO_JUMPS_FUNC_UPDATE(THIS, VTABLE) \
119 (_IO_JUMPS_FILE_plus (THIS) = (VTABLE))
120# define _IO_vtable_offset(THIS) 0
121#endif
122#define _IO_WIDE_JUMPS_FUNC(THIS) _IO_WIDE_JUMPS(THIS)
123#define JUMP_FIELD(TYPE, NAME) TYPE NAME
124#define JUMP0(FUNC, THIS) (_IO_JUMPS_FUNC(THIS)->FUNC) (THIS)
125#define JUMP1(FUNC, THIS, X1) (_IO_JUMPS_FUNC(THIS)->FUNC) (THIS, X1)
126#define JUMP2(FUNC, THIS, X1, X2) (_IO_JUMPS_FUNC(THIS)->FUNC) (THIS, X1, X2)
127#define JUMP3(FUNC, THIS, X1,X2,X3) (_IO_JUMPS_FUNC(THIS)->FUNC) (THIS, X1,X2, X3)
128#define JUMP_INIT(NAME, VALUE) VALUE
129#define JUMP_INIT_DUMMY JUMP_INIT(dummy, 0), JUMP_INIT (dummy2, 0)
130
131#define WJUMP0(FUNC, THIS) (_IO_WIDE_JUMPS_FUNC(THIS)->FUNC) (THIS)
132#define WJUMP1(FUNC, THIS, X1) (_IO_WIDE_JUMPS_FUNC(THIS)->FUNC) (THIS, X1)
133#define WJUMP2(FUNC, THIS, X1, X2) (_IO_WIDE_JUMPS_FUNC(THIS)->FUNC) (THIS, X1, X2)
134#define WJUMP3(FUNC, THIS, X1,X2,X3) (_IO_WIDE_JUMPS_FUNC(THIS)->FUNC) (THIS, X1,X2, X3)
135
136/* The 'finish' function does any final cleaning up of an _IO_FILE object.
137 It does not delete (free) it, but does everything else to finalize it.
138 It matches the streambuf::~streambuf virtual destructor. */
139typedef void (*_IO_finish_t) (FILE *, int); /* finalize */
140#define _IO_FINISH(FP) JUMP1 (__finish, FP, 0)
141#define _IO_WFINISH(FP) WJUMP1 (__finish, FP, 0)
142
143/* The 'overflow' hook flushes the buffer.
144 The second argument is a character, or EOF.
145 It matches the streambuf::overflow virtual function. */
146typedef int (*_IO_overflow_t) (FILE *, int);
147#define _IO_OVERFLOW(FP, CH) JUMP1 (__overflow, FP, CH)
148#define _IO_WOVERFLOW(FP, CH) WJUMP1 (__overflow, FP, CH)
149
150/* The 'underflow' hook tries to fills the get buffer.
151 It returns the next character (as an unsigned char) or EOF. The next
152 character remains in the get buffer, and the get position is not changed.
153 It matches the streambuf::underflow virtual function. */
154typedef int (*_IO_underflow_t) (FILE *);
155#define _IO_UNDERFLOW(FP) JUMP0 (__underflow, FP)
156#define _IO_WUNDERFLOW(FP) WJUMP0 (__underflow, FP)
157
158/* The 'uflow' hook returns the next character in the input stream
159 (cast to unsigned char), and increments the read position;
160 EOF is returned on failure.
161 It matches the streambuf::uflow virtual function, which is not in the
162 cfront implementation, but was added to C++ by the ANSI/ISO committee. */
163#define _IO_UFLOW(FP) JUMP0 (__uflow, FP)
164#define _IO_WUFLOW(FP) WJUMP0 (__uflow, FP)
165
166/* The 'pbackfail' hook handles backing up.
167 It matches the streambuf::pbackfail virtual function. */
168typedef int (*_IO_pbackfail_t) (FILE *, int);
169#define _IO_PBACKFAIL(FP, CH) JUMP1 (__pbackfail, FP, CH)
170#define _IO_WPBACKFAIL(FP, CH) WJUMP1 (__pbackfail, FP, CH)
171
172/* The 'xsputn' hook writes upto N characters from buffer DATA.
173 Returns EOF or the number of character actually written.
174 It matches the streambuf::xsputn virtual function. */
175typedef size_t (*_IO_xsputn_t) (FILE *FP, const void *DATA,
176 size_t N);
177#define _IO_XSPUTN(FP, DATA, N) JUMP2 (__xsputn, FP, DATA, N)
178#define _IO_WXSPUTN(FP, DATA, N) WJUMP2 (__xsputn, FP, DATA, N)
179
180/* The 'xsgetn' hook reads upto N characters into buffer DATA.
181 Returns the number of character actually read.
182 It matches the streambuf::xsgetn virtual function. */
183typedef size_t (*_IO_xsgetn_t) (FILE *FP, void *DATA, size_t N);
184#define _IO_XSGETN(FP, DATA, N) JUMP2 (__xsgetn, FP, DATA, N)
185#define _IO_WXSGETN(FP, DATA, N) WJUMP2 (__xsgetn, FP, DATA, N)
186
187/* The 'seekoff' hook moves the stream position to a new position
188 relative to the start of the file (if DIR==0), the current position
189 (MODE==1), or the end of the file (MODE==2).
190 It matches the streambuf::seekoff virtual function.
191 It is also used for the ANSI fseek function. */
192typedef off64_t (*_IO_seekoff_t) (FILE *FP, off64_t OFF, int DIR,
193 int MODE);
194#define _IO_SEEKOFF(FP, OFF, DIR, MODE) JUMP3 (__seekoff, FP, OFF, DIR, MODE)
195#define _IO_WSEEKOFF(FP, OFF, DIR, MODE) WJUMP3 (__seekoff, FP, OFF, DIR, MODE)
196
197/* The 'seekpos' hook also moves the stream position,
198 but to an absolute position given by a fpos64_t (seekpos).
199 It matches the streambuf::seekpos virtual function.
200 It is also used for the ANSI fgetpos and fsetpos functions. */
201/* The _IO_seek_cur and _IO_seek_end options are not allowed. */
202typedef off64_t (*_IO_seekpos_t) (FILE *, off64_t, int);
203#define _IO_SEEKPOS(FP, POS, FLAGS) JUMP2 (__seekpos, FP, POS, FLAGS)
204#define _IO_WSEEKPOS(FP, POS, FLAGS) WJUMP2 (__seekpos, FP, POS, FLAGS)
205
206/* The 'setbuf' hook gives a buffer to the file.
207 It matches the streambuf::setbuf virtual function. */
208typedef FILE* (*_IO_setbuf_t) (FILE *, char *, ssize_t);
209#define _IO_SETBUF(FP, BUFFER, LENGTH) JUMP2 (__setbuf, FP, BUFFER, LENGTH)
210#define _IO_WSETBUF(FP, BUFFER, LENGTH) WJUMP2 (__setbuf, FP, BUFFER, LENGTH)
211
212/* The 'sync' hook attempts to synchronize the internal data structures
213 of the file with the external state.
214 It matches the streambuf::sync virtual function. */
215typedef int (*_IO_sync_t) (FILE *);
216#define _IO_SYNC(FP) JUMP0 (__sync, FP)
217#define _IO_WSYNC(FP) WJUMP0 (__sync, FP)
218
219/* The 'doallocate' hook is used to tell the file to allocate a buffer.
220 It matches the streambuf::doallocate virtual function, which is not
221 in the ANSI/ISO C++ standard, but is part traditional implementations. */
222typedef int (*_IO_doallocate_t) (FILE *);
223#define _IO_DOALLOCATE(FP) JUMP0 (__doallocate, FP)
224#define _IO_WDOALLOCATE(FP) WJUMP0 (__doallocate, FP)
225
226/* The following four hooks (sysread, syswrite, sysclose, sysseek, and
227 sysstat) are low-level hooks specific to this implementation.
228 There is no correspondence in the ANSI/ISO C++ standard library.
229 The hooks basically correspond to the Unix system functions
230 (read, write, close, lseek, and stat) except that a FILE*
231 parameter is used instead of an integer file descriptor; the default
232 implementation used for normal files just calls those functions.
233 The advantage of overriding these functions instead of the higher-level
234 ones (underflow, overflow etc) is that you can leave all the buffering
235 higher-level functions. */
236
237/* The 'sysread' hook is used to read data from the external file into
238 an existing buffer. It generalizes the Unix read(2) function.
239 It matches the streambuf::sys_read virtual function, which is
240 specific to this implementation. */
241typedef ssize_t (*_IO_read_t) (FILE *, void *, ssize_t);
242#define _IO_SYSREAD(FP, DATA, LEN) JUMP2 (__read, FP, DATA, LEN)
243#define _IO_WSYSREAD(FP, DATA, LEN) WJUMP2 (__read, FP, DATA, LEN)
244
245/* The 'syswrite' hook is used to write data from an existing buffer
246 to an external file. It generalizes the Unix write(2) function.
247 It matches the streambuf::sys_write virtual function, which is
248 specific to this implementation. */
249typedef ssize_t (*_IO_write_t) (FILE *, const void *, ssize_t);
250#define _IO_SYSWRITE(FP, DATA, LEN) JUMP2 (__write, FP, DATA, LEN)
251#define _IO_WSYSWRITE(FP, DATA, LEN) WJUMP2 (__write, FP, DATA, LEN)
252
253/* The 'sysseek' hook is used to re-position an external file.
254 It generalizes the Unix lseek(2) function.
255 It matches the streambuf::sys_seek virtual function, which is
256 specific to this implementation. */
257typedef off64_t (*_IO_seek_t) (FILE *, off64_t, int);
258#define _IO_SYSSEEK(FP, OFFSET, MODE) JUMP2 (__seek, FP, OFFSET, MODE)
259#define _IO_WSYSSEEK(FP, OFFSET, MODE) WJUMP2 (__seek, FP, OFFSET, MODE)
260
261/* The 'sysclose' hook is used to finalize (close, finish up) an
262 external file. It generalizes the Unix close(2) function.
263 It matches the streambuf::sys_close virtual function, which is
264 specific to this implementation. */
265typedef int (*_IO_close_t) (FILE *); /* finalize */
266#define _IO_SYSCLOSE(FP) JUMP0 (__close, FP)
267#define _IO_WSYSCLOSE(FP) WJUMP0 (__close, FP)
268
269/* The 'sysstat' hook is used to get information about an external file
270 into a struct stat buffer. It generalizes the Unix fstat(2) call.
271 It matches the streambuf::sys_stat virtual function, which is
272 specific to this implementation. */
273typedef int (*_IO_stat_t) (FILE *, void *);
274#define _IO_SYSSTAT(FP, BUF) JUMP1 (__stat, FP, BUF)
275#define _IO_WSYSSTAT(FP, BUF) WJUMP1 (__stat, FP, BUF)
276
277/* The 'showmany' hook can be used to get an image how much input is
278 available. In many cases the answer will be 0 which means unknown
279 but some cases one can provide real information. */
280typedef int (*_IO_showmanyc_t) (FILE *);
281#define _IO_SHOWMANYC(FP) JUMP0 (__showmanyc, FP)
282#define _IO_WSHOWMANYC(FP) WJUMP0 (__showmanyc, FP)
283
284/* The 'imbue' hook is used to get information about the currently
285 installed locales. */
286typedef void (*_IO_imbue_t) (FILE *, void *);
287#define _IO_IMBUE(FP, LOCALE) JUMP1 (__imbue, FP, LOCALE)
288#define _IO_WIMBUE(FP, LOCALE) WJUMP1 (__imbue, FP, LOCALE)
289
290
291#define _IO_CHAR_TYPE char /* unsigned char ? */
292#define _IO_INT_TYPE int
293
294struct _IO_jump_t
295{
296 JUMP_FIELD(size_t, __dummy);
297 JUMP_FIELD(size_t, __dummy2);
298 JUMP_FIELD(_IO_finish_t, __finish);
299 JUMP_FIELD(_IO_overflow_t, __overflow);
300 JUMP_FIELD(_IO_underflow_t, __underflow);
301 JUMP_FIELD(_IO_underflow_t, __uflow);
302 JUMP_FIELD(_IO_pbackfail_t, __pbackfail);
303 /* showmany */
304 JUMP_FIELD(_IO_xsputn_t, __xsputn);
305 JUMP_FIELD(_IO_xsgetn_t, __xsgetn);
306 JUMP_FIELD(_IO_seekoff_t, __seekoff);
307 JUMP_FIELD(_IO_seekpos_t, __seekpos);
308 JUMP_FIELD(_IO_setbuf_t, __setbuf);
309 JUMP_FIELD(_IO_sync_t, __sync);
310 JUMP_FIELD(_IO_doallocate_t, __doallocate);
311 JUMP_FIELD(_IO_read_t, __read);
312 JUMP_FIELD(_IO_write_t, __write);
313 JUMP_FIELD(_IO_seek_t, __seek);
314 JUMP_FIELD(_IO_close_t, __close);
315 JUMP_FIELD(_IO_stat_t, __stat);
316 JUMP_FIELD(_IO_showmanyc_t, __showmanyc);
317 JUMP_FIELD(_IO_imbue_t, __imbue);
318};
319
320/* We always allocate an extra word following an _IO_FILE.
321 This contains a pointer to the function jump table used.
322 This is for compatibility with C++ streambuf; the word can
323 be used to smash to a pointer to a virtual function table. */
324
325struct _IO_FILE_plus
326{
327 FILE file;
328 const struct _IO_jump_t *vtable;
329};
330
331#ifdef _IO_USE_OLD_IO_FILE
332/* This structure is used by the compatibility code as if it were an
333 _IO_FILE_plus, but has enough space to initialize the _mode argument
334 of an _IO_FILE_complete. */
335struct _IO_FILE_complete_plus
336{
337 struct _IO_FILE_complete file;
338 const struct _IO_jump_t *vtable;
339};
340#endif
341
342/* Special file type for fopencookie function. */
343struct _IO_cookie_file
344{
345 struct _IO_FILE_plus __fp;
346 void *__cookie;
347 cookie_io_functions_t __io_functions;
348};
349
350FILE *_IO_fopencookie (void *cookie, const char *mode,
351 cookie_io_functions_t io_functions);
352
353
354/* Iterator type for walking global linked list of _IO_FILE objects. */
355
356typedef FILE *_IO_ITER;
357
358/* Generic functions */
359
360extern void _IO_switch_to_main_get_area (FILE *) __THROW;
361extern void _IO_switch_to_backup_area (FILE *) __THROW;
362extern int _IO_switch_to_get_mode (FILE *);
363libc_hidden_proto (_IO_switch_to_get_mode)
364extern void _IO_init_internal (FILE *, int) attribute_hidden;
365extern int _IO_sputbackc (FILE *, int) __THROW;
366libc_hidden_proto (_IO_sputbackc)
367extern int _IO_sungetc (FILE *) __THROW;
368extern void _IO_un_link (struct _IO_FILE_plus *) __THROW;
369libc_hidden_proto (_IO_un_link)
370extern void _IO_link_in (struct _IO_FILE_plus *) __THROW;
371libc_hidden_proto (_IO_link_in)
372extern void _IO_doallocbuf (FILE *) __THROW;
373libc_hidden_proto (_IO_doallocbuf)
374extern void _IO_unsave_markers (FILE *) __THROW;
375libc_hidden_proto (_IO_unsave_markers)
376extern void _IO_setb (FILE *, char *, char *, int) __THROW;
377libc_hidden_proto (_IO_setb)
378extern unsigned _IO_adjust_column (unsigned, const char *, int) __THROW;
379libc_hidden_proto (_IO_adjust_column)
380#define _IO_sputn(__fp, __s, __n) _IO_XSPUTN (__fp, __s, __n)
381
382ssize_t _IO_least_wmarker (FILE *, wchar_t *) __THROW;
383libc_hidden_proto (_IO_least_wmarker)
384extern void _IO_switch_to_main_wget_area (FILE *) __THROW;
385libc_hidden_proto (_IO_switch_to_main_wget_area)
386extern void _IO_switch_to_wbackup_area (FILE *) __THROW;
387libc_hidden_proto (_IO_switch_to_wbackup_area)
388extern int _IO_switch_to_wget_mode (FILE *);
389libc_hidden_proto (_IO_switch_to_wget_mode)
390extern void _IO_wsetb (FILE *, wchar_t *, wchar_t *, int) __THROW;
391libc_hidden_proto (_IO_wsetb)
392extern wint_t _IO_sputbackwc (FILE *, wint_t) __THROW;
393libc_hidden_proto (_IO_sputbackwc)
394extern wint_t _IO_sungetwc (FILE *) __THROW;
395extern void _IO_wdoallocbuf (FILE *) __THROW;
396libc_hidden_proto (_IO_wdoallocbuf)
397extern void _IO_unsave_wmarkers (FILE *) __THROW;
398extern unsigned _IO_adjust_wcolumn (unsigned, const wchar_t *, int) __THROW;
399extern off64_t get_file_offset (FILE *fp);
400
401/* Marker-related function. */
402
403extern void _IO_init_marker (struct _IO_marker *, FILE *);
404extern void _IO_init_wmarker (struct _IO_marker *, FILE *);
405extern void _IO_remove_marker (struct _IO_marker *) __THROW;
406extern int _IO_marker_difference (struct _IO_marker *, struct _IO_marker *)
407 __THROW;
408extern int _IO_marker_delta (struct _IO_marker *) __THROW;
409extern int _IO_wmarker_delta (struct _IO_marker *) __THROW;
410extern int _IO_seekmark (FILE *, struct _IO_marker *, int) __THROW;
411extern int _IO_seekwmark (FILE *, struct _IO_marker *, int) __THROW;
412
413/* Functions for iterating global list and dealing with its lock */
414
415extern _IO_ITER _IO_iter_begin (void) __THROW;
416libc_hidden_proto (_IO_iter_begin)
417extern _IO_ITER _IO_iter_end (void) __THROW;
418libc_hidden_proto (_IO_iter_end)
419extern _IO_ITER _IO_iter_next (_IO_ITER) __THROW;
420libc_hidden_proto (_IO_iter_next)
421extern FILE *_IO_iter_file (_IO_ITER) __THROW;
422libc_hidden_proto (_IO_iter_file)
423extern void _IO_list_lock (void) __THROW;
424libc_hidden_proto (_IO_list_lock)
425extern void _IO_list_unlock (void) __THROW;
426libc_hidden_proto (_IO_list_unlock)
427extern void _IO_list_resetlock (void) __THROW;
428libc_hidden_proto (_IO_list_resetlock)
429extern void _IO_enable_locks (void) __THROW;
430libc_hidden_proto (_IO_enable_locks)
431
432/* Functions for operating popen's proc_file_chain_lock during fork. */
433
434extern void _IO_proc_file_chain_lock (void) __THROW attribute_hidden;
435extern void _IO_proc_file_chain_unlock (void) __THROW attribute_hidden;
436extern void _IO_proc_file_chain_resetlock (void) __THROW attribute_hidden;
437
438/* Default jumptable functions. */
439
440extern int _IO_default_underflow (FILE *) __THROW;
441extern int _IO_default_uflow (FILE *);
442libc_hidden_proto (_IO_default_uflow)
443extern wint_t _IO_wdefault_uflow (FILE *);
444libc_hidden_proto (_IO_wdefault_uflow)
445extern int _IO_default_doallocate (FILE *) __THROW;
446libc_hidden_proto (_IO_default_doallocate)
447extern int _IO_wdefault_doallocate (FILE *) __THROW;
448libc_hidden_proto (_IO_wdefault_doallocate)
449extern void _IO_default_finish (FILE *, int) __THROW;
450libc_hidden_proto (_IO_default_finish)
451extern void _IO_wdefault_finish (FILE *, int) __THROW;
452libc_hidden_proto (_IO_wdefault_finish)
453extern int _IO_default_pbackfail (FILE *, int) __THROW;
454libc_hidden_proto (_IO_default_pbackfail)
455extern wint_t _IO_wdefault_pbackfail (FILE *, wint_t) __THROW;
456libc_hidden_proto (_IO_wdefault_pbackfail)
457extern FILE* _IO_default_setbuf (FILE *, char *, ssize_t);
458extern size_t _IO_default_xsputn (FILE *, const void *, size_t);
459libc_hidden_proto (_IO_default_xsputn)
460extern size_t _IO_wdefault_xsputn (FILE *, const void *, size_t);
461libc_hidden_proto (_IO_wdefault_xsputn)
462extern size_t _IO_default_xsgetn (FILE *, void *, size_t);
463libc_hidden_proto (_IO_default_xsgetn)
464extern size_t _IO_wdefault_xsgetn (FILE *, void *, size_t);
465libc_hidden_proto (_IO_wdefault_xsgetn)
466extern off64_t _IO_default_seekoff (FILE *, off64_t, int, int)
467 __THROW;
468extern off64_t _IO_default_seekpos (FILE *, off64_t, int);
469extern ssize_t _IO_default_write (FILE *, const void *, ssize_t);
470extern ssize_t _IO_default_read (FILE *, void *, ssize_t);
471extern int _IO_default_stat (FILE *, void *) __THROW;
472extern off64_t _IO_default_seek (FILE *, off64_t, int) __THROW;
473extern int _IO_default_sync (FILE *) __THROW;
474#define _IO_default_close ((_IO_close_t) _IO_default_sync)
475extern int _IO_default_showmanyc (FILE *) __THROW;
476extern void _IO_default_imbue (FILE *, void *) __THROW;
477
478extern int __printf_buffer_as_file_overflow (FILE *fp, int ch);
479extern size_t __printf_buffer_as_file_xsputn (FILE *fp, const void *buf,
480 size_t len);
481extern wint_t __wprintf_buffer_as_file_overflow (FILE *fp, int ch);
482extern size_t __wprintf_buffer_as_file_xsputn (FILE *fp, const void *buf,
483 size_t len);
484
485enum
486{
487 IO_STR_JUMPS = 0,
488 IO_WSTR_JUMPS = 1,
489 IO_FILE_JUMPS = 2,
490 IO_FILE_JUMPS_MMAP = 3,
491 IO_FILE_JUMPS_MAYBE_MMAP = 4,
492 IO_WFILE_JUMPS = 5,
493 IO_WFILE_JUMPS_MMAP = 6,
494 IO_WFILE_JUMPS_MAYBE_MMAP = 7,
495 IO_COOKIE_JUMPS = 8,
496 IO_PROC_JUMPS = 9,
497 IO_MEM_JUMPS = 10,
498 IO_WMEM_JUMPS = 11,
499 IO_PRINTF_BUFFER_AS_FILE_JUMPS = 12,
500 IO_WPRINTF_BUFFER_AS_FILE_JUMPS = 13,
501#if SHLIB_COMPAT (libc, GLIBC_2_0, GLIBC_2_1)
502 IO_OLD_FILE_JUMPS = 14,
503 IO_OLD_PROC_JUMPS = 15,
504 IO_OLD_COOKIED_JUMPS = 16,
505 IO_VTABLES_NUM = IO_OLD_COOKIED_JUMPS + 1,
506#elif SHLIB_COMPAT (libc, GLIBC_2_0, GLIBC_2_2)
507 IO_OLD_COOKIED_JUMPS = 14,
508 IO_VTABLES_NUM = IO_OLD_COOKIED_JUMPS + 1,
509#else
510 IO_VTABLES_NUM = IO_WPRINTF_BUFFER_AS_FILE_JUMPS + 1
511#endif
512};
513#define IO_VTABLES_LEN (IO_VTABLES_NUM * sizeof (struct _IO_jump_t))
514
515extern const struct _IO_jump_t __io_vtables[] attribute_hidden;
516#define _IO_str_jumps (__io_vtables[IO_STR_JUMPS])
517#define _IO_wstr_jumps (__io_vtables[IO_WSTR_JUMPS])
518#define _IO_file_jumps (__io_vtables[IO_FILE_JUMPS])
519#define _IO_file_jumps_mmap (__io_vtables[IO_FILE_JUMPS_MMAP])
520#define _IO_file_jumps_maybe_mmap (__io_vtables[IO_FILE_JUMPS_MAYBE_MMAP])
521#define _IO_wfile_jumps (__io_vtables[IO_WFILE_JUMPS])
522#define _IO_wfile_jumps_mmap (__io_vtables[IO_WFILE_JUMPS_MMAP])
523#define _IO_wfile_jumps_maybe_mmap (__io_vtables[IO_WFILE_JUMPS_MAYBE_MMAP])
524#define _IO_cookie_jumps (__io_vtables[IO_COOKIE_JUMPS])
525#define _IO_proc_jumps (__io_vtables[IO_PROC_JUMPS])
526#define _IO_mem_jumps (__io_vtables[IO_MEM_JUMPS])
527#define _IO_wmem_jumps (__io_vtables[IO_WMEM_JUMPS])
528#define _IO_printf_buffer_as_file_jumps (__io_vtables[IO_PRINTF_BUFFER_AS_FILE_JUMPS])
529#define _IO_wprintf_buffer_as_file_jumps (__io_vtables[IO_WPRINTF_BUFFER_AS_FILE_JUMPS])
530#define _IO_old_file_jumps (__io_vtables[IO_OLD_FILE_JUMPS])
531#define _IO_old_proc_jumps (__io_vtables[IO_OLD_PROC_JUMPS])
532#define _IO_old_cookie_jumps (__io_vtables[IO_OLD_COOKIED_JUMPS])
533
534#ifdef SHARED
535# define libio_static_fn_required(name)
536#else
537# define libio_static_fn_required(name) __asm (".globl " #name);
538#endif
539
540extern int _IO_do_write (FILE *, const char *, size_t);
541libc_hidden_proto (_IO_do_write)
542extern int _IO_new_do_write (FILE *, const char *, size_t);
543extern int _IO_old_do_write (FILE *, const char *, size_t);
544extern int _IO_wdo_write (FILE *, const wchar_t *, size_t);
545libc_hidden_proto (_IO_wdo_write)
546extern int _IO_flush_all (void);
547libc_hidden_proto (_IO_flush_all)
548extern void _IO_flush_all_linebuffered (void);
549libc_hidden_proto (_IO_flush_all_linebuffered)
550extern int _IO_new_fgetpos (FILE *, __fpos_t *);
551extern int _IO_old_fgetpos (FILE *, __fpos_t *);
552extern int _IO_new_fsetpos (FILE *, const __fpos_t *);
553extern int _IO_old_fsetpos (FILE *, const __fpos_t *);
554extern int _IO_new_fgetpos64 (FILE *, __fpos64_t *);
555extern int _IO_old_fgetpos64 (FILE *, __fpos64_t *);
556extern int _IO_new_fsetpos64 (FILE *, const __fpos64_t *);
557extern int _IO_old_fsetpos64 (FILE *, const __fpos64_t *);
558extern void _IO_old_init (FILE *fp, int flags) __THROW;
559
560
561#define _IO_do_flush(_f) \
562 ((_f)->_mode <= 0 \
563 ? _IO_do_write(_f, (_f)->_IO_write_base, \
564 (_f)->_IO_write_ptr-(_f)->_IO_write_base) \
565 : _IO_wdo_write(_f, (_f)->_wide_data->_IO_write_base, \
566 ((_f)->_wide_data->_IO_write_ptr \
567 - (_f)->_wide_data->_IO_write_base)))
568#define _IO_old_do_flush(_f) \
569 _IO_old_do_write(_f, (_f)->_IO_write_base, \
570 (_f)->_IO_write_ptr-(_f)->_IO_write_base)
571#define _IO_in_put_mode(_fp) ((_fp)->_flags & _IO_CURRENTLY_PUTTING)
572#define _IO_mask_flags(fp, f, mask) \
573 ((fp)->_flags = ((fp)->_flags & ~(mask)) | ((f) & (mask)))
574#define _IO_setg(fp, eb, g, eg) ((fp)->_IO_read_base = (eb),\
575 (fp)->_IO_read_ptr = (g), (fp)->_IO_read_end = (eg))
576#define _IO_wsetg(fp, eb, g, eg) ((fp)->_wide_data->_IO_read_base = (eb),\
577 (fp)->_wide_data->_IO_read_ptr = (g), \
578 (fp)->_wide_data->_IO_read_end = (eg))
579#define _IO_setp(__fp, __p, __ep) \
580 ((__fp)->_IO_write_base = (__fp)->_IO_write_ptr \
581 = __p, (__fp)->_IO_write_end = (__ep))
582#define _IO_wsetp(__fp, __p, __ep) \
583 ((__fp)->_wide_data->_IO_write_base \
584 = (__fp)->_wide_data->_IO_write_ptr = __p, \
585 (__fp)->_wide_data->_IO_write_end = (__ep))
586#define _IO_have_backup(fp) ((fp)->_IO_backup_base != NULL)
587#define _IO_have_wbackup(fp) ((fp)->_wide_data->_IO_backup_base != NULL)
588#define _IO_in_backup(fp) ((fp)->_flags & _IO_IN_BACKUP)
589#define _IO_have_markers(fp) ((fp)->_markers != NULL)
590#define _IO_blen(fp) ((fp)->_IO_buf_end - (fp)->_IO_buf_base)
591#define _IO_wblen(fp) ((fp)->_wide_data->_IO_buf_end \
592 - (fp)->_wide_data->_IO_buf_base)
593
594/* Jumptable functions for files. */
595
596extern int _IO_file_doallocate (FILE *) __THROW;
597libc_hidden_proto (_IO_file_doallocate)
598extern FILE* _IO_file_setbuf (FILE *, char *, ssize_t);
599libc_hidden_proto (_IO_file_setbuf)
600extern off64_t _IO_file_seekoff (FILE *, off64_t, int, int);
601libc_hidden_proto (_IO_file_seekoff)
602extern off64_t _IO_file_seekoff_mmap (FILE *, off64_t, int, int)
603 __THROW;
604extern size_t _IO_file_xsputn (FILE *, const void *, size_t);
605libc_hidden_proto (_IO_file_xsputn)
606extern size_t _IO_file_xsgetn (FILE *, void *, size_t);
607libc_hidden_proto (_IO_file_xsgetn)
608extern int _IO_file_stat (FILE *, void *) __THROW;
609libc_hidden_proto (_IO_file_stat)
610extern int _IO_file_close (FILE *) __THROW;
611libc_hidden_proto (_IO_file_close)
612extern int _IO_file_close_mmap (FILE *) __THROW;
613extern int _IO_file_underflow (FILE *);
614libc_hidden_proto (_IO_file_underflow)
615extern int _IO_file_underflow_mmap (FILE *);
616extern int _IO_file_underflow_maybe_mmap (FILE *);
617extern int _IO_file_overflow (FILE *, int);
618libc_hidden_proto (_IO_file_overflow)
619#define _IO_file_is_open(__fp) ((__fp)->_fileno != -1)
620extern FILE* _IO_file_attach (FILE *, int);
621libc_hidden_proto (_IO_file_attach)
622extern FILE* _IO_file_open (FILE *, const char *, int, int, int, int);
623libc_hidden_proto (_IO_file_open)
624extern FILE* _IO_file_fopen (FILE *, const char *, const char *, int);
625libc_hidden_proto (_IO_file_fopen)
626extern ssize_t _IO_file_write (FILE *, const void *, ssize_t);
627extern ssize_t _IO_file_read (FILE *, void *, ssize_t);
628libc_hidden_proto (_IO_file_read)
629extern int _IO_file_sync (FILE *);
630libc_hidden_proto (_IO_file_sync)
631extern int _IO_file_close_it (FILE *);
632libc_hidden_proto (_IO_file_close_it)
633extern off64_t _IO_file_seek (FILE *, off64_t, int) __THROW;
634libc_hidden_proto (_IO_file_seek)
635extern void _IO_file_finish (FILE *, int);
636libc_hidden_proto (_IO_file_finish)
637
638extern FILE* _IO_new_file_attach (FILE *, int);
639extern int _IO_new_file_close_it (FILE *);
640extern void _IO_new_file_finish (FILE *, int);
641extern FILE* _IO_new_file_fopen (FILE *, const char *, const char *,
642 int);
643extern void _IO_no_init (FILE *, int, int, struct _IO_wide_data *,
644 const struct _IO_jump_t *) __THROW;
645extern void _IO_new_file_init_internal (struct _IO_FILE_plus *)
646 __THROW attribute_hidden;
647extern FILE* _IO_new_file_setbuf (FILE *, char *, ssize_t);
648extern FILE* _IO_file_setbuf_mmap (FILE *, char *, ssize_t);
649extern int _IO_new_file_sync (FILE *);
650extern int _IO_file_sync_mmap (FILE *) attribute_hidden;
651extern size_t _IO_file_xsgetn_maybe_mmap (FILE *fp, void *data, size_t n)
652 attribute_hidden;
653extern size_t _IO_file_xsgetn_mmap (FILE *fp, void *data, size_t n)
654 attribute_hidden;
655extern off64_t _IO_file_seekoff_maybe_mmap (FILE *fp, off64_t offset, int dir,
656 int mode)
657 attribute_hidden;
658extern int _IO_new_file_underflow (FILE *);
659extern int _IO_new_file_overflow (FILE *, int);
660extern off64_t _IO_new_file_seekoff (FILE *, off64_t, int, int);
661extern ssize_t _IO_new_file_write (FILE *, const void *, ssize_t);
662extern size_t _IO_new_file_xsputn (FILE *, const void *, size_t);
663
664extern FILE* _IO_old_file_setbuf (FILE *, char *, ssize_t);
665extern off64_t _IO_old_file_seekoff (FILE *, off64_t, int, int);
666extern size_t _IO_old_file_xsputn (FILE *, const void *, size_t);
667extern int _IO_old_file_underflow (FILE *);
668extern int _IO_old_file_overflow (FILE *, int);
669extern void _IO_old_file_init_internal (struct _IO_FILE_plus *)
670 __THROW attribute_hidden;
671extern FILE* _IO_old_file_attach (FILE *, int);
672extern FILE* _IO_old_file_fopen (FILE *, const char *, const char *);
673extern ssize_t _IO_old_file_write (FILE *, const void *, ssize_t);
674extern int _IO_old_file_sync (FILE *);
675extern int _IO_old_file_close_it (FILE *);
676extern void _IO_old_file_finish (FILE *, int);
677
678extern int _IO_wfile_doallocate (FILE *) __THROW;
679extern size_t _IO_wfile_xsputn (FILE *, const void *, size_t);
680libc_hidden_proto (_IO_wfile_xsputn)
681extern FILE* _IO_wfile_setbuf (FILE *, wchar_t *, ssize_t);
682extern wint_t _IO_wfile_sync (FILE *);
683libc_hidden_proto (_IO_wfile_sync)
684extern wint_t _IO_wfile_underflow (FILE *);
685libc_hidden_proto (_IO_wfile_underflow)
686extern wint_t _IO_wfile_overflow (FILE *, wint_t);
687libc_hidden_proto (_IO_wfile_overflow)
688extern off64_t _IO_wfile_seekoff (FILE *, off64_t, int, int);
689libc_hidden_proto (_IO_wfile_seekoff)
690extern wint_t _IO_wfile_underflow_maybe_mmap (FILE *fp)
691 attribute_hidden;
692extern wint_t _IO_wfile_underflow_mmap (FILE *fp)
693 attribute_hidden;
694
695/* Jumptable functions for proc_files. */
696extern FILE* _IO_proc_open (FILE *, const char *, const char *)
697 __THROW;
698extern FILE* _IO_new_proc_open (FILE *, const char *, const char *)
699 __THROW;
700extern FILE* _IO_old_proc_open (FILE *, const char *, const char *);
701extern int _IO_proc_close (FILE *) __THROW;
702extern int _IO_new_proc_close (FILE *) __THROW;
703extern int _IO_old_proc_close (FILE *);
704
705/* Jumptable functions for strfiles. */
706extern int _IO_str_underflow (FILE *) __THROW;
707libc_hidden_proto (_IO_str_underflow)
708extern int _IO_str_overflow (FILE *, int) __THROW;
709libc_hidden_proto (_IO_str_overflow)
710extern int _IO_str_pbackfail (FILE *, int) __THROW;
711libc_hidden_proto (_IO_str_pbackfail)
712extern off64_t _IO_str_seekoff (FILE *, off64_t, int, int) __THROW
713 ;
714libc_hidden_proto (_IO_str_seekoff)
715extern void _IO_str_finish (FILE *, int) __THROW;
716extern int _IO_str_chk_overflow (FILE *fp, int c) __THROW
717 attribute_hidden;
718
719/* Jumptable functions for fopencookie. */
720extern ssize_t _IO_cookie_read (FILE *fp, void *buf, ssize_t size)
721 attribute_hidden;
722extern ssize_t _IO_cookie_write (FILE *fp, const void *buf, ssize_t size)
723 attribute_hidden;
724extern off64_t _IO_cookie_seek (FILE *fp, off64_t offset, int dir)
725 attribute_hidden;
726extern int _IO_cookie_close (FILE *fp) attribute_hidden;
727extern off64_t _IO_cookie_seekoff (FILE *fp, off64_t offset, int dir, int mode)
728 attribute_hidden;
729extern off64_t _IO_old_cookie_seek (FILE *fp, off64_t offset, int dir)
730 attribute_hidden;
731
732/* Jumptable functions for obstack. */
733extern int __IO_obstack_overflow (FILE *fp, int c) attribute_hidden;
734extern size_t __IO_obstack_xsputn (FILE *fp, const void *data, size_t n)
735 attribute_hidden;
736
737/* Jumptable functions for open_{w}memstream. */
738extern int _IO_mem_sync (FILE* fp) __THROW attribute_hidden;
739extern void _IO_mem_finish (FILE* fp, int) __THROW attribute_hidden;
740extern int _IO_wmem_sync (FILE* fp) __THROW attribute_hidden;
741extern void _IO_wmem_finish (FILE* fp, int) __THROW attribute_hidden;
742
743/* Other strfile functions */
744struct _IO_strfile_;
745extern ssize_t _IO_str_count (FILE *) __THROW;
746extern int _IO_strn_overflow (FILE *fp, int c) __THROW attribute_hidden;
747
748/* And the wide character versions. */
749extern void _IO_wstr_init_static (FILE *, wchar_t *, size_t, wchar_t *)
750 __THROW;
751extern ssize_t _IO_wstr_count (FILE *) __THROW;
752extern wint_t _IO_wstr_overflow (FILE *, wint_t) __THROW;
753extern wint_t _IO_wstr_underflow (FILE *) __THROW;
754extern off64_t _IO_wstr_seekoff (FILE *, off64_t, int, int)
755 __THROW;
756extern wint_t _IO_wstr_pbackfail (FILE *, wint_t) __THROW;
757extern void _IO_wstr_finish (FILE *, int) __THROW;
758
759/* Helper functions. */
760int _IO_helper_overflow (FILE *s, int c);
761int _IO_whelper_overflow (FILE *s, int c);
762
763/* Internal versions of v*printf that take an additional flags
764 parameter. */
765extern int __vfprintf_internal (FILE *fp, const char *format, va_list ap,
766 unsigned int mode_flags)
767 attribute_hidden;
768extern int __vfwprintf_internal (FILE *fp, const wchar_t *format, va_list ap,
769 unsigned int mode_flags)
770 attribute_hidden;
771
772extern int __vasprintf_internal (char **result_ptr, const char *format,
773 va_list ap, unsigned int mode_flags)
774 attribute_hidden;
775extern int __vdprintf_internal (int d, const char *format, va_list ap,
776 unsigned int mode_flags)
777 attribute_hidden;
778extern int __obstack_vprintf_internal (struct obstack *ob, const char *fmt,
779 va_list ap, unsigned int mode_flags)
780 attribute_hidden;
781
782/* Note: __vsprintf_internal, unlike vsprintf, does take a maxlen argument,
783 because it's called by both vsprintf and vsprintf_chk. If maxlen is
784 not set to -1, overrunning the buffer will cause a prompt crash.
785 This is the behavior of ordinary (v)sprintf functions, thus they call
786 __vsprintf_internal with that argument set to -1. */
787extern int __vsprintf_internal (char *string, size_t maxlen,
788 const char *format, va_list ap,
789 unsigned int mode_flags)
790 attribute_hidden;
791
792extern int __vsnprintf_internal (char *string, size_t maxlen,
793 const char *format, va_list ap,
794 unsigned int mode_flags)
795 attribute_hidden;
796extern int __vswprintf_internal (wchar_t *string, size_t maxlen,
797 const wchar_t *format, va_list ap,
798 unsigned int mode_flags)
799 attribute_hidden;
800
801/* Flags for __v*printf_internal.
802
803 PRINTF_LDBL_IS_DBL indicates whether long double values are to be
804 handled as having the same format as double, in which case the flag
805 should be set to one, or as another format, otherwise.
806
807 PRINTF_FORTIFY, when set to one, indicates that fortification checks
808 are to be performed in input parameters. This is used by the
809 __*printf_chk functions, which are used when _FORTIFY_SOURCE is
810 defined to 1 or 2. Otherwise, such checks are ignored.
811
812 PRINTF_CHK indicates, to the internal function being called, that the
813 call is originated from one of the __*printf_chk functions.
814
815 PRINTF_LDBL_USES_FLOAT128 is used on platforms where the long double
816 format used to be different from the IEC 60559 double format *and*
817 also different from the Quadruple 128-bits IEC 60559 format (such as
818 the IBM Extended Precision format on powerpc or the 80-bits IEC 60559
819 format on x86), but was later converted to the Quadruple 128-bits IEC
820 60559 format, which is the same format that the _Float128 always has
821 (hence the `USES_FLOAT128' suffix in the name of the flag). When set
822 to one, this macro indicates that long double values are to be
823 handled as having this new format. Otherwise, they should be handled
824 as the previous format on that platform. */
825#define PRINTF_LDBL_IS_DBL 0x0001
826#define PRINTF_FORTIFY 0x0002
827#define PRINTF_CHK 0x0004
828#define PRINTF_LDBL_USES_FLOAT128 0x0008
829
830extern size_t _IO_getline (FILE *,char *, size_t, int, int);
831libc_hidden_proto (_IO_getline)
832extern size_t _IO_getline_info (FILE *,char *, size_t,
833 int, int, int *);
834libc_hidden_proto (_IO_getline_info)
835extern size_t _IO_getwline (FILE *,wchar_t *, size_t, wint_t, int);
836extern size_t _IO_getwline_info (FILE *,wchar_t *, size_t,
837 wint_t, int, wint_t *);
838
839extern struct _IO_FILE_plus *_IO_list_all;
840libc_hidden_proto (_IO_list_all)
841extern void (*_IO_cleanup_registration_needed) (void);
842
843extern void _IO_str_init_static_internal (struct _IO_strfile_ *, char *,
844 size_t, char *) __THROW;
845extern off64_t _IO_seekoff_unlocked (FILE *, off64_t, int, int)
846 attribute_hidden;
847extern off64_t _IO_seekpos_unlocked (FILE *, off64_t, int)
848 attribute_hidden;
849
850#if _G_HAVE_MMAP
851
852# include <unistd.h>
853# include <fcntl.h>
854# include <sys/mman.h>
855# include <sys/param.h>
856
857# if !defined(MAP_ANONYMOUS) && defined(MAP_ANON)
858# define MAP_ANONYMOUS MAP_ANON
859# endif
860
861# if !defined(MAP_ANONYMOUS) || !defined(EXEC_PAGESIZE)
862# undef _G_HAVE_MMAP
863# define _G_HAVE_MMAP 0
864# endif
865
866#endif /* _G_HAVE_MMAP */
867
868/* Flags for __vfscanf_internal and __vfwscanf_internal.
869
870 SCANF_LDBL_IS_DBL indicates whether long double values are to be
871 handled as having the same format as double, in which case the flag
872 should be set to one, or as another format, otherwise.
873
874 SCANF_ISOC99_A, when set to one, indicates that the ISO C99 or POSIX
875 behavior of the scanf functions is to be used, i.e. automatic
876 allocation for input strings with %as, %aS and %a[, a GNU extension,
877 is disabled. This is the behavior that the __isoc99_scanf family of
878 functions use. When the flag is set to zero, automatic allocation is
879 enabled.
880
881 SCANF_ISOC23_BIN_CST, when set to one, indicates the %i accepts
882 binary constants starting 0b or 0B.
883
884 SCANF_LDBL_USES_FLOAT128 is used on platforms where the long double
885 format used to be different from the IEC 60559 double format *and*
886 also different from the Quadruple 128-bits IEC 60559 format (such as
887 the IBM Extended Precision format on powerpc or the 80-bits IEC 60559
888 format on x86), but was later converted to the Quadruple 128-bits IEC
889 60559 format, which is the same format that the _Float128 always has
890 (hence the `USES_FLOAT128' suffix in the name of the flag). When set
891 to one, this macros indicates that long double values are to be
892 handled as having this new format. Otherwise, they should be handled
893 as the previous format on that platform. */
894#define SCANF_LDBL_IS_DBL 0x0001
895#define SCANF_ISOC99_A 0x0002
896#define SCANF_ISOC23_BIN_CST 0x0004
897#define SCANF_LDBL_USES_FLOAT128 0x0008
898
899extern int __vfscanf_internal (FILE *fp, const char *format, va_list argp,
900 unsigned int flags)
901 attribute_hidden;
902extern int __vfwscanf_internal (FILE *fp, const wchar_t *format, va_list argp,
903 unsigned int flags)
904 attribute_hidden;
905
906extern int _IO_vscanf (const char *, va_list) __THROW;
907
908#ifdef _IO_MTSAFE_IO
909/* check following! */
910# ifdef _IO_USE_OLD_IO_FILE
911# define FILEBUF_LITERAL(CHAIN, FLAGS, FD, WDP) \
912 { _IO_MAGIC+_IO_LINKED+_IO_IS_FILEBUF+FLAGS, \
913 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, (FILE *) CHAIN, FD, \
914 0, _IO_pos_BAD, 0, 0, { 0 }, &_IO_stdfile_##FD##_lock }
915# else
916# define FILEBUF_LITERAL(CHAIN, FLAGS, FD, WDP) \
917 { _IO_MAGIC+_IO_LINKED+_IO_IS_FILEBUF+FLAGS, \
918 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, (FILE *) CHAIN, FD, \
919 0, _IO_pos_BAD, 0, 0, { 0 }, &_IO_stdfile_##FD##_lock, _IO_pos_BAD,\
920 NULL, WDP, 0 }
921# endif
922#else
923# ifdef _IO_USE_OLD_IO_FILE
924# define FILEBUF_LITERAL(CHAIN, FLAGS, FD, WDP) \
925 { _IO_MAGIC+_IO_LINKED+_IO_IS_FILEBUF+FLAGS, \
926 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, (FILE *) CHAIN, FD, \
927 0, _IO_pos_BAD }
928# else
929# define FILEBUF_LITERAL(CHAIN, FLAGS, FD, WDP) \
930 { _IO_MAGIC+_IO_LINKED+_IO_IS_FILEBUF+FLAGS, \
931 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, (FILE *) CHAIN, FD, \
932 0, _IO_pos_BAD, 0, 0, { 0 }, 0, _IO_pos_BAD, \
933 NULL, WDP, 0 }
934# endif
935#endif
936
937#if SHLIB_COMPAT (libc, GLIBC_2_0, GLIBC_2_1)
938/* See oldstdfiles.c. These are the old stream variables. */
939extern struct _IO_FILE_plus _IO_stdin_;
940extern struct _IO_FILE_plus _IO_stdout_;
941extern struct _IO_FILE_plus _IO_stderr_;
942
943static inline bool
944_IO_legacy_file (FILE *fp)
945{
946 return fp == (FILE *) &_IO_stdin_ || fp == (FILE *) &_IO_stdout_
947 || fp == (FILE *) &_IO_stderr_;
948}
949#endif
950
951/* Deallocate a stream if it is heap-allocated. Preallocated
952 stdin/stdout/stderr streams are not deallocated. */
953static inline void
954_IO_deallocate_file (FILE *fp)
955{
956 /* The current stream variables. */
957 if (fp == (FILE *) &_IO_2_1_stdin_ || fp == (FILE *) &_IO_2_1_stdout_
958 || fp == (FILE *) &_IO_2_1_stderr_)
959 return;
960#if SHLIB_COMPAT (libc, GLIBC_2_0, GLIBC_2_1)
961 if (_IO_legacy_file (fp))
962 return;
963#endif
964 free (ptr: fp);
965}
966
967#ifdef IO_DEBUG
968# define CHECK_FILE(FILE, RET) do { \
969 if ((FILE) == NULL \
970 || ((FILE)->_flags & _IO_MAGIC_MASK) != _IO_MAGIC) \
971 { \
972 __set_errno (EINVAL); \
973 return RET; \
974 } \
975 } while (0)
976#else
977# define CHECK_FILE(FILE, RET) do { } while (0)
978#endif
979
980static inline void
981__attribute__ ((__always_inline__))
982_IO_acquire_lock_fct (FILE **p)
983{
984 FILE *fp = *p;
985 if ((fp->_flags & _IO_USER_LOCK) == 0)
986 _IO_funlockfile (fp);
987}
988
989#if !defined _IO_MTSAFE_IO && IS_IN (libc)
990# define _IO_acquire_lock(_fp) \
991 do {
992# define _IO_release_lock(_fp) \
993 } while (0)
994#endif
995
996#ifdef SHARED
997/* If equal to &_IO_vtable_check (with pointer guard protection),
998 unknown vtable pointers are valid. This function pointer is solely
999 used as a flag. */
1000extern void (*IO_accept_foreign_vtables) (void) attribute_hidden;
1001
1002/* Assigns the passed function pointer (either NULL or
1003 &_IO_vtable_check) to IO_accept_foreign_vtables. */
1004static inline void
1005IO_set_accept_foreign_vtables (void (*flag) (void))
1006{
1007 PTR_MANGLE (flag);
1008 atomic_store_relaxed (&IO_accept_foreign_vtables, flag);
1009}
1010
1011#else /* !SHARED */
1012
1013/* The statically-linked version does nothing. */
1014static inline void
1015IO_set_accept_foreign_vtables (void (*flag) (void))
1016{
1017}
1018
1019#endif
1020
1021/* Check if unknown vtable pointers are permitted; otherwise,
1022 terminate the process. */
1023void _IO_vtable_check (void) attribute_hidden;
1024
1025/* Perform vtable pointer validation. If validation fails, terminate
1026 the process. */
1027static inline const struct _IO_jump_t *
1028IO_validate_vtable (const struct _IO_jump_t *vtable)
1029{
1030 uintptr_t ptr = (uintptr_t) vtable;
1031 uintptr_t offset = ptr - (uintptr_t) &__io_vtables;
1032 if (__glibc_unlikely (offset >= IO_VTABLES_LEN))
1033 /* The vtable pointer is not in the expected section. Use the
1034 slow path, which will terminate the process if necessary. */
1035 _IO_vtable_check ();
1036 return vtable;
1037}
1038
1039/* Character set conversion. */
1040
1041enum __codecvt_result
1042{
1043 __codecvt_ok,
1044 __codecvt_partial,
1045 __codecvt_error,
1046 __codecvt_noconv
1047};
1048
1049enum __codecvt_result __libio_codecvt_out (struct _IO_codecvt *,
1050 __mbstate_t *,
1051 const wchar_t *,
1052 const wchar_t *,
1053 const wchar_t **, char *,
1054 char *, char **)
1055 attribute_hidden;
1056enum __codecvt_result __libio_codecvt_in (struct _IO_codecvt *,
1057 __mbstate_t *,
1058 const char *, const char *,
1059 const char **, wchar_t *,
1060 wchar_t *, wchar_t **)
1061 attribute_hidden;
1062int __libio_codecvt_encoding (struct _IO_codecvt *) attribute_hidden;
1063int __libio_codecvt_length (struct _IO_codecvt *, __mbstate_t *,
1064 const char *, const char *, size_t)
1065 attribute_hidden;
1066
1067#endif /* libioP.h. */
1068

Provided by KDAB

Privacy Policy
Update your C++ knowledge – Modern C++11/14/17 Training
Find out more

source code of glibc/libio/libioP.h