Update NEWS bug list.
[glibc.git] / include / stdio.h
bloba6f7fd43cb664eb55f4987dfa830466bba38aa5b
1 #ifndef _STDIO_H
2 # if !defined _ISOMAC && defined _IO_MTSAFE_IO
3 # include <stdio-lock.h>
4 # endif
6 /* Workaround PR90731 with GCC 9 when using ldbl redirects in C++. */
7 # include <bits/floatn.h>
8 # if defined __cplusplus && __LDOUBLE_REDIRECTS_TO_FLOAT128_ABI == 1
9 # if __GNUC_PREREQ (9, 0) && !__GNUC_PREREQ (9, 3)
10 # pragma GCC system_header
11 # endif
12 # endif
14 # include <libio/stdio.h>
15 # ifndef _ISOMAC
17 # define _LIBC_STDIO_H 1
18 # include <libio/libio.h>
20 /* Now define the internal interfaces. */
22 /* Some libc_hidden_ldbl_proto's do not map to a unique symbol when
23 redirecting ldouble to _Float128 variants. We can therefore safely
24 directly alias them to their internal name. */
25 # if __LDOUBLE_REDIRECTS_TO_FLOAT128_ABI == 1 && IS_IN (libc)
26 # define stdio_hidden_ldbl_proto(p, f) \
27 extern __typeof (p ## f) p ## f __asm (__ASMNAME ("___ieee128_" #f));
28 # elif __LDOUBLE_REDIRECTS_TO_FLOAT128_ABI == 1
29 # define stdio_hidden_ldbl_proto(p,f) __LDBL_REDIR1_DECL (p ## f, p ## f ## ieee128)
30 # else
31 # define stdio_hidden_ldbl_proto(p,f) libc_hidden_proto (p ## f)
32 # endif
34 /* Set the error indicator on FP. */
35 static inline void
36 fseterr_unlocked (FILE *fp)
38 fp->_flags |= _IO_ERR_SEEN;
41 extern int __fcloseall (void) attribute_hidden;
42 extern int __snprintf (char *__restrict __s, size_t __maxlen,
43 const char *__restrict __format, ...)
44 __attribute__ ((__format__ (__printf__, 3, 4)));
45 stdio_hidden_ldbl_proto (__, snprintf)
47 extern int __vfscanf (FILE *__restrict __s,
48 const char *__restrict __format,
49 __gnuc_va_list __arg)
50 __attribute__ ((__format__ (__scanf__, 2, 0)));
51 libc_hidden_proto (__vfscanf)
52 extern int __vscanf (const char *__restrict __format,
53 __gnuc_va_list __arg)
54 __attribute__ ((__format__ (__scanf__, 1, 0)));
55 extern __ssize_t __getline (char **__lineptr, size_t *__n,
56 FILE *__stream) attribute_hidden;
57 extern int __vsscanf (const char *__restrict __s,
58 const char *__restrict __format,
59 __gnuc_va_list __arg)
60 __attribute__ ((__format__ (__scanf__, 2, 0)));
62 extern int __sprintf_chk (char *, int, size_t, const char *, ...) __THROW;
63 extern int __snprintf_chk (char *, size_t, int, size_t, const char *, ...)
64 __THROW;
65 extern int __vsprintf_chk (char *, int, size_t, const char *,
66 __gnuc_va_list) __THROW;
67 extern int __vsnprintf_chk (char *, size_t, int, size_t, const char *,
68 __gnuc_va_list) __THROW;
69 extern int __printf_chk (int, const char *, ...);
70 extern int __fprintf_chk (FILE *, int, const char *, ...);
71 extern int __vprintf_chk (int, const char *, __gnuc_va_list);
72 extern int __vfprintf_chk (FILE *, int, const char *, __gnuc_va_list);
73 extern char *__fgets_unlocked_chk (char *buf, size_t size, int n, FILE *fp);
74 extern char *__fgets_chk (char *buf, size_t size, int n, FILE *fp);
75 extern int __asprintf_chk (char **, int, const char *, ...) __THROW;
76 extern int __vasprintf_chk (char **, int, const char *, __gnuc_va_list) __THROW;
77 extern int __dprintf_chk (int, int, const char *, ...);
78 extern int __vdprintf_chk (int, int, const char *, __gnuc_va_list);
79 extern int __obstack_printf_chk (struct obstack *, int, const char *, ...)
80 __THROW;
81 extern int __obstack_vprintf_chk (struct obstack *, int, const char *,
82 __gnuc_va_list) __THROW;
84 extern int __isoc99_fscanf (FILE *__restrict __stream,
85 const char *__restrict __format, ...) __wur;
86 extern int __isoc99_scanf (const char *__restrict __format, ...) __wur;
87 extern int __isoc99_sscanf (const char *__restrict __s,
88 const char *__restrict __format, ...) __THROW;
89 extern int __isoc99_vfscanf (FILE *__restrict __s,
90 const char *__restrict __format,
91 __gnuc_va_list __arg) __wur;
92 extern int __isoc99_vscanf (const char *__restrict __format,
93 __gnuc_va_list __arg) __wur;
94 extern int __isoc99_vsscanf (const char *__restrict __s,
95 const char *__restrict __format,
96 __gnuc_va_list __arg) __THROW;
98 libc_hidden_proto (__isoc99_sscanf)
99 libc_hidden_proto (__isoc99_vsscanf)
100 libc_hidden_proto (__isoc99_vfscanf)
102 /* Internal uses of sscanf should call the C99-compliant version.
103 Unfortunately, symbol redirection is not transitive, so the
104 __REDIRECT in the public header does not link up with the above
105 libc_hidden_proto. Bridge the gap with a macro. */
106 # if !__GLIBC_USE (DEPRECATED_SCANF)
107 # undef sscanf
108 # define sscanf __isoc99_sscanf
109 # endif
111 # if __LDOUBLE_REDIRECTS_TO_FLOAT128_ABI == 1 && IS_IN (libc)
112 /* These are implemented as redirects to other public API.
113 Therefore, the usual redirection fails to avoid PLT. */
114 extern __typeof (__isoc99_sscanf) ___ieee128_isoc99_sscanf __THROW;
115 extern __typeof (__isoc99_vsscanf) ___ieee128_isoc99_vsscanf __THROW;
116 extern __typeof (__isoc99_vfscanf) ___ieee128_isoc99_vfscanf __THROW;
117 libc_hidden_proto (___ieee128_isoc99_sscanf)
118 libc_hidden_proto (___ieee128_isoc99_vsscanf)
119 libc_hidden_proto (___ieee128_isoc99_vfscanf)
120 #define __isoc99_sscanf ___ieee128_isoc99_sscanf
121 #define __isoc99_vsscanf ___ieee128_isoc99_vsscanf
122 #define __isoc99_vfscanf ___ieee128_isoc99_vfscanf
123 # endif
125 /* Prototypes for compatibility functions. */
126 extern FILE *__new_tmpfile (void);
127 extern FILE *__old_tmpfile (void);
129 # define __need_size_t
130 # include <stddef.h>
132 # include <bits/types/wint_t.h>
134 /* Generate a unique file name (and possibly open it). */
135 extern int __path_search (char *__tmpl, size_t __tmpl_len,
136 const char *__dir, const char *__pfx,
137 int __try_tempdir) attribute_hidden;
139 extern int __gen_tempname (char *__tmpl, int __suffixlen, int __flags,
140 int __kind) attribute_hidden;
141 /* The __kind argument to __gen_tempname may be one of: */
142 # define __GT_FILE 0 /* create a file */
143 # define __GT_DIR 1 /* create a directory */
144 # define __GT_NOCREATE 2 /* just find a name not currently in use */
146 enum __libc_message_action
148 do_message = 0, /* Print message. */
149 do_abort = 1 << 0, /* Abort. */
152 /* Print out MESSAGE (which should end with a newline) on the error output
153 and abort. */
154 extern void __libc_fatal (const char *__message)
155 __attribute__ ((__noreturn__));
156 extern void __libc_message (enum __libc_message_action action,
157 const char *__fnt, ...) attribute_hidden;
158 extern void __fortify_fail (const char *msg) __attribute__ ((__noreturn__));
159 libc_hidden_proto (__fortify_fail)
161 /* Acquire ownership of STREAM. */
162 extern void __flockfile (FILE *__stream) attribute_hidden;
164 /* Relinquish the ownership granted for STREAM. */
165 extern void __funlockfile (FILE *__stream) attribute_hidden;
167 /* Try to acquire ownership of STREAM but do not block if it is not
168 possible. */
169 extern int __ftrylockfile (FILE *__stream);
171 extern int __getc_unlocked (FILE *__fp) attribute_hidden;
172 extern wint_t __getwc_unlocked (FILE *__fp);
174 extern int __fxprintf (FILE *__fp, const char *__fmt, ...)
175 __attribute__ ((__format__ (__printf__, 2, 3))) attribute_hidden;
176 extern int __fxprintf_nocancel (FILE *__fp, const char *__fmt, ...)
177 __attribute__ ((__format__ (__printf__, 2, 3))) attribute_hidden;
178 int __vfxprintf (FILE *__fp, const char *__fmt, __gnuc_va_list,
179 unsigned int)
180 attribute_hidden;
182 extern const char *const _sys_errlist_internal[] attribute_hidden;
183 extern const size_t _sys_errlist_internal_len attribute_hidden;
184 extern const char *__get_errlist (int) attribute_hidden;
185 extern const char *__get_errname (int) attribute_hidden;
187 libc_hidden_ldbl_proto (__asprintf)
189 # if IS_IN (libc)
190 extern FILE *_IO_new_fopen (const char*, const char*);
191 # define fopen(fname, mode) _IO_new_fopen (fname, mode)
192 extern FILE *_IO_new_fdopen (int, const char*);
193 # define fdopen(fd, mode) _IO_new_fdopen (fd, mode)
194 extern int _IO_new_fclose (FILE*);
195 # define fclose(fp) _IO_new_fclose (fp)
196 extern int _IO_fputs (const char*, FILE*);
197 libc_hidden_proto (_IO_fputs)
198 /* The compiler may optimize calls to fprintf into calls to fputs.
199 Use libc_hidden_proto to ensure that those calls, not redirected by
200 the fputs macro, also do not go through the PLT. */
201 libc_hidden_proto (fputs)
202 # define fputs(str, fp) _IO_fputs (str, fp)
203 extern int _IO_new_fsetpos (FILE *, const __fpos_t *);
204 # define fsetpos(fp, posp) _IO_new_fsetpos (fp, posp)
205 extern int _IO_new_fgetpos (FILE *, __fpos_t *);
206 # define fgetpos(fp, posp) _IO_new_fgetpos (fp, posp)
207 # endif
209 extern __typeof (dprintf) __dprintf
210 __attribute__ ((__format__ (__printf__, 2, 3)));
211 stdio_hidden_ldbl_proto (__, dprintf)
212 libc_hidden_ldbl_proto (dprintf)
213 libc_hidden_ldbl_proto (fprintf)
214 libc_hidden_ldbl_proto (vfprintf)
215 libc_hidden_ldbl_proto (sprintf)
216 libc_hidden_proto (ungetc)
217 libc_hidden_proto (__getdelim)
218 libc_hidden_proto (fwrite)
219 libc_hidden_proto (perror)
220 libc_hidden_proto (remove)
221 libc_hidden_proto (rewind)
222 libc_hidden_proto (fileno)
223 extern __typeof (fileno) __fileno;
224 libc_hidden_proto (__fileno)
225 libc_hidden_proto (fwrite)
226 libc_hidden_proto (fseek)
227 extern __typeof (ftello) __ftello;
228 libc_hidden_proto (__ftello)
229 extern __typeof (fseeko64) __fseeko64;
230 libc_hidden_proto (__fseeko64)
231 extern __typeof (ftello64) __ftello64;
232 libc_hidden_proto (__ftello64)
233 libc_hidden_proto (fflush)
234 libc_hidden_proto (fflush_unlocked)
235 extern __typeof (fflush_unlocked) __fflush_unlocked;
236 libc_hidden_proto (__fflush_unlocked)
237 extern __typeof (fread_unlocked) __fread_unlocked;
238 libc_hidden_proto (__fread_unlocked)
239 libc_hidden_proto (fwrite_unlocked)
240 libc_hidden_proto (fgets_unlocked)
241 extern __typeof (fgets_unlocked) __fgets_unlocked;
242 libc_hidden_proto (__fgets_unlocked)
243 libc_hidden_proto (fputs_unlocked)
244 extern __typeof (fputs_unlocked) __fputs_unlocked;
245 libc_hidden_proto (__fputs_unlocked)
246 libc_hidden_proto (feof_unlocked)
247 extern __typeof (feof_unlocked) __feof_unlocked attribute_hidden;
248 libc_hidden_proto (ferror_unlocked)
249 extern __typeof (ferror_unlocked) __ferror_unlocked attribute_hidden;
250 libc_hidden_proto (getc_unlocked)
251 libc_hidden_proto (fputc_unlocked)
252 libc_hidden_proto (putc_unlocked)
253 extern __typeof (putc_unlocked) __putc_unlocked attribute_hidden;
254 libc_hidden_proto (fmemopen)
255 /* The prototype needs repeating instead of using __typeof to use
256 __THROW in C++ tests. */
257 extern FILE *__open_memstream (char **, size_t *) __THROW __wur;
258 libc_hidden_proto (__open_memstream)
259 libc_hidden_proto (__libc_fatal)
260 rtld_hidden_proto (__libc_fatal)
261 libc_hidden_proto (__vsprintf_chk)
263 extern FILE * __fmemopen (void *buf, size_t len, const char *mode);
264 libc_hidden_proto (__fmemopen)
266 extern int __gen_tempfd (int flags);
267 libc_hidden_proto (__gen_tempfd)
269 # ifdef __USE_EXTERN_INLINES
270 __extern_inline int
271 __NTH (__feof_unlocked (FILE *__stream))
273 return __feof_unlocked_body (__stream);
276 __extern_inline int
277 __NTH (__ferror_unlocked (FILE *__stream))
279 return __ferror_unlocked_body (__stream);
282 __extern_inline int
283 __getc_unlocked (FILE *__fp)
285 return __getc_unlocked_body (__fp);
288 __extern_inline int
289 __putc_unlocked (int __c, FILE *__stream)
291 return __putc_unlocked_body (__c, __stream);
293 # endif
295 extern __typeof (renameat) __renameat;
296 libc_hidden_proto (__renameat)
297 extern __typeof (renameat2) __renameat2;
298 libc_hidden_proto (__renameat2)
300 # endif /* not _ISOMAC */
301 #endif /* stdio.h */