* manual/arith.texi: Document MTASC-safety properties.
[jlayton/glibc.git] / include / stdio.h
1 #ifndef _STDIO_H
2 # if defined __need_FILE || defined __need___FILE || defined _ISOMAC
3 #  include <libio/stdio.h>
4 # else
5 #  include <libio/stdio.h>
6
7 /* Now define the internal interfaces.  */
8 __BEGIN_DECLS
9
10 extern int __fcloseall (void);
11 extern int __snprintf (char *__restrict __s, size_t __maxlen,
12                        const char *__restrict __format, ...)
13      __attribute__ ((__format__ (__printf__, 3, 4)));
14 extern int __vsnprintf (char *__restrict __s, size_t __maxlen,
15                         const char *__restrict __format, _G_va_list __arg)
16      __attribute__ ((__format__ (__printf__, 3, 0)));
17 extern int __vfscanf (FILE *__restrict __s,
18                       const char *__restrict __format,
19                       _G_va_list __arg)
20      __attribute__ ((__format__ (__scanf__, 2, 0)));
21 libc_hidden_proto (__vfscanf)
22 extern int __vscanf (const char *__restrict __format,
23                      _G_va_list __arg)
24      __attribute__ ((__format__ (__scanf__, 1, 0)));
25 extern _IO_ssize_t __getline (char **__lineptr, size_t *__n,
26                               FILE *__stream);
27 extern int __vsscanf (const char *__restrict __s,
28                       const char *__restrict __format,
29                       _G_va_list __arg)
30      __attribute__ ((__format__ (__scanf__, 2, 0)));
31
32 #  ifndef __cplusplus
33 extern int __sprintf_chk (char *, int, size_t, const char *, ...) __THROW;
34 extern int __snprintf_chk (char *, size_t, int, size_t, const char *, ...)
35      __THROW;
36 extern int __vsprintf_chk (char *, int, size_t, const char *,
37                            _G_va_list) __THROW;
38 extern int __vsnprintf_chk (char *, size_t, int, size_t, const char *,
39                             _G_va_list) __THROW;
40 extern int __printf_chk (int, const char *, ...);
41 extern int __fprintf_chk (FILE *, int, const char *, ...);
42 extern int __vprintf_chk (int, const char *, _G_va_list);
43 extern int __vfprintf_chk (FILE *, int, const char *, _G_va_list);
44 extern char *__fgets_unlocked_chk (char *buf, size_t size, int n, FILE *fp);
45 extern char *__fgets_chk (char *buf, size_t size, int n, FILE *fp);
46 extern int __asprintf_chk (char **, int, const char *, ...) __THROW;
47 extern int __vasprintf_chk (char **, int, const char *, _G_va_list) __THROW;
48 extern int __dprintf_chk (int, int, const char *, ...);
49 extern int __vdprintf_chk (int, int, const char *, _G_va_list);
50 extern int __obstack_printf_chk (struct obstack *, int, const char *, ...)
51      __THROW;
52 extern int __obstack_vprintf_chk (struct obstack *, int, const char *,
53                                   _G_va_list) __THROW;
54 #  endif
55
56 extern int __isoc99_fscanf (FILE *__restrict __stream,
57                             const char *__restrict __format, ...) __wur;
58 extern int __isoc99_scanf (const char *__restrict __format, ...) __wur;
59 extern int __isoc99_sscanf (const char *__restrict __s,
60                             const char *__restrict __format, ...) __THROW;
61 extern int __isoc99_vfscanf (FILE *__restrict __s,
62                              const char *__restrict __format,
63                              _G_va_list __arg) __wur;
64 extern int __isoc99_vscanf (const char *__restrict __format,
65                             _G_va_list __arg) __wur;
66 extern int __isoc99_vsscanf (const char *__restrict __s,
67                              const char *__restrict __format,
68                              _G_va_list __arg) __THROW;
69 libc_hidden_proto (__isoc99_vsscanf)
70 libc_hidden_proto (__isoc99_vfscanf)
71
72 /* Prototypes for compatibility functions.  */
73 extern FILE *__new_tmpfile (void);
74 extern FILE *__old_tmpfile (void);
75
76
77
78 #  define __need_size_t
79 #  include <stddef.h>
80 /* Generate a unique file name (and possibly open it).  */
81 extern int __path_search (char *__tmpl, size_t __tmpl_len,
82                           const char *__dir, const char *__pfx,
83                           int __try_tempdir);
84
85 extern int __gen_tempname (char *__tmpl, int __suffixlen, int __flags,
86                            int __kind);
87 /* The __kind argument to __gen_tempname may be one of: */
88 #  define __GT_FILE     0       /* create a file */
89 #  define __GT_DIR      1       /* create a directory */
90 #  define __GT_NOCREATE 2       /* just find a name not currently in use */
91
92 /* Print out MESSAGE on the error output and abort.  */
93 extern void __libc_fatal (const char *__message)
94      __attribute__ ((__noreturn__));
95 extern void __libc_message (int do_abort, const char *__fnt, ...);
96 extern void __fortify_fail (const char *msg)
97      __attribute__ ((__noreturn__)) internal_function;
98 libc_hidden_proto (__fortify_fail)
99
100 /* Acquire ownership of STREAM.  */
101 extern void __flockfile (FILE *__stream);
102
103 /* Relinquish the ownership granted for STREAM.  */
104 extern void __funlockfile (FILE *__stream);
105
106 /* Try to acquire ownership of STREAM but do not block if it is not
107    possible.  */
108 extern int __ftrylockfile (FILE *__stream);
109
110 extern int __getc_unlocked (FILE *__fp);
111 extern wint_t __getwc_unlocked (FILE *__fp);
112
113 extern int __fxprintf (FILE *__fp, const char *__fmt, ...)
114      __attribute__ ((__format__ (__printf__, 2, 3)));
115
116 extern const char *const _sys_errlist_internal[] attribute_hidden;
117 extern int _sys_nerr_internal attribute_hidden;
118
119 libc_hidden_proto (__asprintf)
120 #  if !defined NOT_IN_libc
121 extern _IO_FILE *_IO_new_fopen (const char*, const char*);
122 #   define fopen(fname, mode) _IO_new_fopen (fname, mode)
123 extern _IO_FILE *_IO_new_fdopen (int, const char*);
124 #   define fdopen(fd, mode) _IO_new_fdopen (fd, mode)
125 extern int _IO_new_fclose (_IO_FILE*);
126 #   define fclose(fp) _IO_new_fclose (fp)
127 extern int _IO_fputs (const char*, _IO_FILE*);
128 libc_hidden_proto (_IO_fputs)
129 #   define fputs(str, fp) _IO_fputs (str, fp)
130 extern int _IO_new_fsetpos (_IO_FILE *, const _IO_fpos_t *);
131 #   define fsetpos(fp, posp) _IO_new_fsetpos (fp, posp)
132 extern int _IO_new_fgetpos (_IO_FILE *, _IO_fpos_t *);
133 #   define fgetpos(fp, posp) _IO_new_fgetpos (fp, posp)
134 #  endif
135
136 libc_hidden_proto (dprintf)
137 libc_hidden_proto (fprintf)
138 libc_hidden_proto (vfprintf)
139 libc_hidden_proto (sprintf)
140 libc_hidden_proto (sscanf)
141 libc_hidden_proto (fwrite)
142 libc_hidden_proto (perror)
143 libc_hidden_proto (remove)
144 libc_hidden_proto (rewind)
145 libc_hidden_proto (fileno)
146 libc_hidden_proto (fwrite)
147 libc_hidden_proto (fseek)
148 libc_hidden_proto (ftello)
149 libc_hidden_proto (fflush)
150 libc_hidden_proto (fflush_unlocked)
151 libc_hidden_proto (fread_unlocked)
152 libc_hidden_proto (fwrite_unlocked)
153 libc_hidden_proto (fgets_unlocked)
154 libc_hidden_proto (fputs_unlocked)
155 libc_hidden_proto (fmemopen)
156 libc_hidden_proto (open_memstream)
157 libc_hidden_proto (__libc_fatal)
158 libc_hidden_proto (__vsprintf_chk)
159 libc_hidden_proto (__vsnprintf_chk)
160 libc_hidden_proto (__vfprintf_chk)
161 libc_hidden_proto (__vasprintf_chk)
162 libc_hidden_proto (__vdprintf_chk)
163 libc_hidden_proto (__obstack_vprintf_chk)
164
165 /* The <stdio.h> header does not include the declaration for gets
166    anymore when compiling with _GNU_SOURCE.  Provide a copy here.  */
167 extern char *gets (char *__s);
168 #  if __USE_FORTIFY_LEVEL > 0
169 extern char *__gets_chk (char *__str, size_t) __wur;
170 extern char *__REDIRECT (__gets_warn, (char *__str), gets)
171      __wur __warnattr ("please use fgets or getline instead, gets can't "
172                        "specify buffer size");
173
174 __fortify_function __wur char *
175 gets (char *__str)
176 {
177   if (__bos (__str) != (size_t) -1)
178     return __gets_chk (__str, __bos (__str));
179   return __gets_warn (__str);
180 }
181 #  endif
182
183 __END_DECLS
184 # endif
185
186 #endif