1 /* Checking macros for stdio functions. Declarations only.
2 Copyright (C) 2004-2023 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
10 The GNU C Library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, see
17 <https://www.gnu.org/licenses/>. */
19 #ifndef _BITS_STDIO2_DEC_H
20 #define _BITS_STDIO2_DEC_H 1
23 # error "Never include <bits/stdio2-decl.h> directly; use <stdio.h> instead."
26 extern int __sprintf_chk (char *__restrict __s
, int __flag
, size_t __slen
,
27 const char *__restrict __format
, ...) __THROW
28 __attr_access ((__write_only__
, 1, 3));
29 extern int __vsprintf_chk (char *__restrict __s
, int __flag
, size_t __slen
,
30 const char *__restrict __format
,
31 __gnuc_va_list __ap
) __THROW
32 __attr_access ((__write_only__
, 1, 3));
34 #if defined __USE_ISOC99 || defined __USE_UNIX98
36 extern int __snprintf_chk (char *__restrict __s
, size_t __n
, int __flag
,
37 size_t __slen
, const char *__restrict __format
,
39 __attr_access ((__write_only__
, 1, 2));
40 extern int __vsnprintf_chk (char *__restrict __s
, size_t __n
, int __flag
,
41 size_t __slen
, const char *__restrict __format
,
42 __gnuc_va_list __ap
) __THROW
43 __attr_access ((__write_only__
, 1, 2));
47 #if __USE_FORTIFY_LEVEL > 1
49 extern int __fprintf_chk (FILE *__restrict __stream
, int __flag
,
50 const char *__restrict __format
, ...)
52 extern int __printf_chk (int __flag
, const char *__restrict __format
, ...);
53 extern int __vfprintf_chk (FILE *__restrict __stream
, int __flag
,
54 const char *__restrict __format
,
55 __gnuc_va_list __ap
) __nonnull ((1));
56 extern int __vprintf_chk (int __flag
, const char *__restrict __format
,
59 # ifdef __USE_XOPEN2K8
60 extern int __dprintf_chk (int __fd
, int __flag
, const char *__restrict __fmt
,
61 ...) __attribute__ ((__format__ (__printf__
, 3, 4)));
62 extern int __vdprintf_chk (int __fd
, int __flag
,
63 const char *__restrict __fmt
, __gnuc_va_list __arg
)
64 __attribute__ ((__format__ (__printf__
, 3, 0)));
69 extern int __asprintf_chk (char **__restrict __ptr
, int __flag
,
70 const char *__restrict __fmt
, ...)
71 __THROW
__attribute__ ((__format__ (__printf__
, 3, 4))) __wur
;
72 extern int __vasprintf_chk (char **__restrict __ptr
, int __flag
,
73 const char *__restrict __fmt
, __gnuc_va_list __arg
)
74 __THROW
__attribute__ ((__format__ (__printf__
, 3, 0))) __wur
;
75 extern int __obstack_printf_chk (struct obstack
*__restrict __obstack
,
76 int __flag
, const char *__restrict __format
,
78 __THROW
__attribute__ ((__format__ (__printf__
, 3, 4)));
79 extern int __obstack_vprintf_chk (struct obstack
*__restrict __obstack
,
81 const char *__restrict __format
,
82 __gnuc_va_list __args
)
83 __THROW
__attribute__ ((__format__ (__printf__
, 3, 0)));
88 #if __GLIBC_USE (DEPRECATED_GETS)
89 extern char *__REDIRECT (__gets_warn
, (char *__str
), gets
)
90 __wur
__warnattr ("please use fgets or getline instead, gets can't "
91 "specify buffer size");
93 extern char *__gets_chk (char *__str
, size_t) __wur
;
96 extern char *__REDIRECT (__fgets_alias
,
97 (char *__restrict __s
, int __n
,
98 FILE *__restrict __stream
), fgets
)
99 __wur
__attr_access ((__write_only__
, 1, 2));
100 extern char *__REDIRECT (__fgets_chk_warn
,
101 (char *__restrict __s
, size_t __size
, int __n
,
102 FILE *__restrict __stream
), __fgets_chk
)
103 __wur
__warnattr ("fgets called with bigger size than length "
104 "of destination buffer");
106 extern char *__fgets_chk (char *__restrict __s
, size_t __size
, int __n
,
107 FILE *__restrict __stream
)
108 __wur
__attr_access ((__write_only__
, 1, 3)) __nonnull ((4));
110 extern size_t __REDIRECT (__fread_alias
,
111 (void *__restrict __ptr
, size_t __size
,
112 size_t __n
, FILE *__restrict __stream
),
114 extern size_t __REDIRECT (__fread_chk_warn
,
115 (void *__restrict __ptr
, size_t __ptrlen
,
116 size_t __size
, size_t __n
,
117 FILE *__restrict __stream
),
119 __wur
__warnattr ("fread called with bigger size * nmemb than length "
120 "of destination buffer");
122 extern size_t __fread_chk (void *__restrict __ptr
, size_t __ptrlen
,
123 size_t __size
, size_t __n
,
124 FILE *__restrict __stream
) __wur
__nonnull ((5));
127 extern char *__REDIRECT_FORTIFY (__fgets_unlocked_alias
,
128 (char *__restrict __s
, int __n
,
129 FILE *__restrict __stream
), fgets_unlocked
)
130 __wur
__attr_access ((__write_only__
, 1, 2));
131 extern char *__REDIRECT (__fgets_unlocked_chk_warn
,
132 (char *__restrict __s
, size_t __size
, int __n
,
133 FILE *__restrict __stream
), __fgets_unlocked_chk
)
134 __wur
__warnattr ("fgets_unlocked called with bigger size than length "
135 "of destination buffer");
138 extern char *__fgets_unlocked_chk (char *__restrict __s
, size_t __size
,
139 int __n
, FILE *__restrict __stream
)
140 __wur
__attr_access ((__write_only__
, 1, 3)) __nonnull ((4));
144 # undef fread_unlocked
145 extern size_t __REDIRECT (__fread_unlocked_alias
,
146 (void *__restrict __ptr
, size_t __size
,
147 size_t __n
, FILE *__restrict __stream
),
148 fread_unlocked
) __wur
;
149 extern size_t __REDIRECT (__fread_unlocked_chk_warn
,
150 (void *__restrict __ptr
, size_t __ptrlen
,
151 size_t __size
, size_t __n
,
152 FILE *__restrict __stream
),
153 __fread_unlocked_chk
)
154 __wur
__warnattr ("fread_unlocked called with bigger size * nmemb than "
155 "length of destination buffer");
157 extern size_t __fread_unlocked_chk (void *__restrict __ptr
, size_t __ptrlen
,
158 size_t __size
, size_t __n
,
159 FILE *__restrict __stream
)
160 __wur
__nonnull ((5));
163 #endif /* bits/stdio2-decl.h. */