posix: Reformat Makefile.
[glibc.git] / include / stdio.h
blobda47d1ce99ef748fb985bff50ea89a3b5676cdfc
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;
97 extern int __isoc23_fscanf (FILE *__restrict __stream,
98 const char *__restrict __format, ...) __wur;
99 extern int __isoc23_scanf (const char *__restrict __format, ...) __wur;
100 extern int __isoc23_sscanf (const char *__restrict __s,
101 const char *__restrict __format, ...) __THROW;
102 extern int __isoc23_vfscanf (FILE *__restrict __s,
103 const char *__restrict __format,
104 __gnuc_va_list __arg) __wur;
105 extern int __isoc23_vscanf (const char *__restrict __format,
106 __gnuc_va_list __arg) __wur;
107 extern int __isoc23_vsscanf (const char *__restrict __s,
108 const char *__restrict __format,
109 __gnuc_va_list __arg) __THROW;
111 libc_hidden_proto (__isoc99_sscanf)
112 libc_hidden_proto (__isoc99_vsscanf)
113 libc_hidden_proto (__isoc99_vfscanf)
114 libc_hidden_proto (__isoc23_sscanf)
115 libc_hidden_proto (__isoc23_vsscanf)
116 libc_hidden_proto (__isoc23_vfscanf)
118 /* Internal uses of sscanf should call the C2X-compliant version.
119 Unfortunately, symbol redirection is not transitive, so the
120 __REDIRECT in the public header does not link up with the above
121 libc_hidden_proto. Bridge the gap with a macro. */
122 # if !__GLIBC_USE (DEPRECATED_SCANF)
123 # undef sscanf
124 # define sscanf __isoc23_sscanf
125 # endif
127 # if __LDOUBLE_REDIRECTS_TO_FLOAT128_ABI == 1 && IS_IN (libc)
128 /* These are implemented as redirects to other public API.
129 Therefore, the usual redirection fails to avoid PLT. */
130 extern __typeof (__isoc99_sscanf) ___ieee128_isoc99_sscanf __THROW;
131 extern __typeof (__isoc99_vsscanf) ___ieee128_isoc99_vsscanf __THROW;
132 extern __typeof (__isoc99_vfscanf) ___ieee128_isoc99_vfscanf __THROW;
133 extern __typeof (__isoc23_sscanf) ___ieee128_isoc23_sscanf __THROW;
134 extern __typeof (__isoc23_vsscanf) ___ieee128_isoc23_vsscanf __THROW;
135 extern __typeof (__isoc23_vfscanf) ___ieee128_isoc23_vfscanf __THROW;
136 libc_hidden_proto (___ieee128_isoc99_sscanf)
137 libc_hidden_proto (___ieee128_isoc99_vsscanf)
138 libc_hidden_proto (___ieee128_isoc99_vfscanf)
139 libc_hidden_proto (___ieee128_isoc23_sscanf)
140 libc_hidden_proto (___ieee128_isoc23_vsscanf)
141 libc_hidden_proto (___ieee128_isoc23_vfscanf)
142 #define __isoc99_sscanf ___ieee128_isoc99_sscanf
143 #define __isoc99_vsscanf ___ieee128_isoc99_vsscanf
144 #define __isoc99_vfscanf ___ieee128_isoc99_vfscanf
145 #define __isoc23_sscanf ___ieee128_isoc23_sscanf
146 #define __isoc23_vsscanf ___ieee128_isoc23_vsscanf
147 #define __isoc23_vfscanf ___ieee128_isoc23_vfscanf
148 # endif
150 /* Prototypes for compatibility functions. */
151 extern FILE *__new_tmpfile (void);
152 extern FILE *__old_tmpfile (void);
154 # define __need_size_t
155 # include <stddef.h>
157 # include <bits/types/wint_t.h>
159 /* Generate a unique file name (and possibly open it). */
160 extern int __path_search (char *__tmpl, size_t __tmpl_len,
161 const char *__dir, const char *__pfx,
162 int __try_tempdir) attribute_hidden;
164 extern int __gen_tempname (char *__tmpl, int __suffixlen, int __flags,
165 int __kind) attribute_hidden;
166 /* The __kind argument to __gen_tempname may be one of: */
167 # define __GT_FILE 0 /* create a file */
168 # define __GT_DIR 1 /* create a directory */
169 # define __GT_NOCREATE 2 /* just find a name not currently in use */
171 /* Print out MESSAGE (which should end with a newline) on the error output
172 and abort. */
173 extern void __libc_fatal (const char *__message)
174 __attribute__ ((__noreturn__));
175 _Noreturn void __libc_message (const char *__fnt, ...) attribute_hidden;
176 extern void __fortify_fail (const char *msg) __attribute__ ((__noreturn__));
177 libc_hidden_proto (__fortify_fail)
179 /* Acquire ownership of STREAM. */
180 extern void __flockfile (FILE *__stream) attribute_hidden;
182 /* Relinquish the ownership granted for STREAM. */
183 extern void __funlockfile (FILE *__stream) attribute_hidden;
185 /* Try to acquire ownership of STREAM but do not block if it is not
186 possible. */
187 extern int __ftrylockfile (FILE *__stream);
189 extern int __getc_unlocked (FILE *__fp) attribute_hidden;
190 extern wint_t __getwc_unlocked (FILE *__fp);
192 extern int __fxprintf (FILE *__fp, const char *__fmt, ...)
193 __attribute__ ((__format__ (__printf__, 2, 3))) attribute_hidden;
194 extern int __fxprintf_nocancel (FILE *__fp, const char *__fmt, ...)
195 __attribute__ ((__format__ (__printf__, 2, 3))) attribute_hidden;
196 int __vfxprintf (FILE *__fp, const char *__fmt, __gnuc_va_list,
197 unsigned int)
198 attribute_hidden;
200 extern const char *const _sys_errlist_internal[] attribute_hidden;
201 extern const size_t _sys_errlist_internal_len attribute_hidden;
202 extern const char *__get_errlist (int) attribute_hidden;
203 extern const char *__get_errname (int) attribute_hidden;
205 libc_hidden_ldbl_proto (__asprintf)
207 # if IS_IN (libc)
208 extern FILE *_IO_new_fopen (const char*, const char*);
209 # define fopen(fname, mode) _IO_new_fopen (fname, mode)
210 extern FILE *_IO_new_fdopen (int, const char*);
211 # define fdopen(fd, mode) _IO_new_fdopen (fd, mode)
212 extern int _IO_new_fclose (FILE*);
213 # define fclose(fp) _IO_new_fclose (fp)
214 extern int _IO_fputs (const char*, FILE*);
215 libc_hidden_proto (_IO_fputs)
216 /* The compiler may optimize calls to fprintf into calls to fputs.
217 Use libc_hidden_proto to ensure that those calls, not redirected by
218 the fputs macro, also do not go through the PLT. */
219 libc_hidden_proto (fputs)
220 # define fputs(str, fp) _IO_fputs (str, fp)
221 extern int _IO_new_fsetpos (FILE *, const __fpos_t *);
222 # define fsetpos(fp, posp) _IO_new_fsetpos (fp, posp)
223 extern int _IO_new_fgetpos (FILE *, __fpos_t *);
224 # define fgetpos(fp, posp) _IO_new_fgetpos (fp, posp)
225 # endif
227 extern __typeof (dprintf) __dprintf
228 __attribute__ ((__format__ (__printf__, 2, 3)));
229 stdio_hidden_ldbl_proto (__, dprintf)
230 libc_hidden_ldbl_proto (dprintf)
231 libc_hidden_ldbl_proto (fprintf)
232 libc_hidden_ldbl_proto (vfprintf)
233 libc_hidden_ldbl_proto (sprintf)
234 libc_hidden_proto (ungetc)
235 libc_hidden_proto (__getdelim)
236 libc_hidden_proto (fwrite)
237 libc_hidden_proto (perror)
238 libc_hidden_proto (remove)
239 libc_hidden_proto (rewind)
240 libc_hidden_proto (fileno)
241 extern __typeof (fileno) __fileno;
242 libc_hidden_proto (__fileno)
243 libc_hidden_proto (fwrite)
244 libc_hidden_proto (fseek)
245 extern __typeof (ftello) __ftello;
246 libc_hidden_proto (__ftello)
247 extern __typeof (fseeko64) __fseeko64;
248 libc_hidden_proto (__fseeko64)
249 extern __typeof (ftello64) __ftello64;
250 libc_hidden_proto (__ftello64)
251 libc_hidden_proto (fflush)
252 libc_hidden_proto (fflush_unlocked)
253 extern __typeof (fflush_unlocked) __fflush_unlocked;
254 libc_hidden_proto (__fflush_unlocked)
255 extern __typeof (fread_unlocked) __fread_unlocked;
256 libc_hidden_proto (__fread_unlocked)
257 libc_hidden_proto (fwrite_unlocked)
258 libc_hidden_proto (fgets_unlocked)
259 extern __typeof (fgets_unlocked) __fgets_unlocked;
260 libc_hidden_proto (__fgets_unlocked)
261 libc_hidden_proto (fputs_unlocked)
262 extern __typeof (fputs_unlocked) __fputs_unlocked;
263 libc_hidden_proto (__fputs_unlocked)
264 libc_hidden_proto (feof_unlocked)
265 extern __typeof (feof_unlocked) __feof_unlocked attribute_hidden;
266 libc_hidden_proto (ferror_unlocked)
267 extern __typeof (ferror_unlocked) __ferror_unlocked attribute_hidden;
268 libc_hidden_proto (getc_unlocked)
269 libc_hidden_proto (fputc_unlocked)
270 libc_hidden_proto (putc_unlocked)
271 extern __typeof (putc_unlocked) __putc_unlocked attribute_hidden;
272 libc_hidden_proto (fmemopen)
273 /* The prototype needs repeating instead of using __typeof to use
274 __THROW in C++ tests. */
275 extern FILE *__open_memstream (char **, size_t *) __THROW __wur;
276 libc_hidden_proto (__open_memstream)
277 libc_hidden_proto (__libc_fatal)
278 rtld_hidden_proto (__libc_fatal)
279 libc_hidden_proto (__vsprintf_chk)
281 extern FILE * __fmemopen (void *buf, size_t len, const char *mode);
282 libc_hidden_proto (__fmemopen)
284 extern int __gen_tempfd (int flags);
285 libc_hidden_proto (__gen_tempfd)
287 # ifdef __USE_EXTERN_INLINES
288 __extern_inline int
289 __NTH (__feof_unlocked (FILE *__stream))
291 return __feof_unlocked_body (__stream);
294 __extern_inline int
295 __NTH (__ferror_unlocked (FILE *__stream))
297 return __ferror_unlocked_body (__stream);
300 __extern_inline int
301 __getc_unlocked (FILE *__fp)
303 return __getc_unlocked_body (__fp);
306 __extern_inline int
307 __putc_unlocked (int __c, FILE *__stream)
309 return __putc_unlocked_body (__c, __stream);
311 # endif
313 extern __typeof (renameat) __renameat;
314 libc_hidden_proto (__renameat)
315 extern __typeof (renameat2) __renameat2;
316 libc_hidden_proto (__renameat2)
318 # endif /* not _ISOMAC */
319 #endif /* stdio.h */