1 /* A GNU-like <stdio.h>.
2 
3    Copyright (C) 2004, 2007-2020 Free Software Foundation, Inc.
4 
5    This program is free software; you can redistribute it and/or modify
6    it under the terms of the GNU General Public License as published by
7    the Free Software Foundation; either version 3, or (at your option)
8    any later version.
9 
10    This program 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
13    GNU General Public License for more details.
14 
15    You should have received a copy of the GNU General Public License
16    along with this program; if not, see <https://www.gnu.org/licenses/>.  */
17 
18 #if __GNUC__ >= 3
19 @PRAGMA_SYSTEM_HEADER@
20 #endif
21 @PRAGMA_COLUMNS@
22 
23 #if defined __need_FILE || defined __need___FILE || defined _GL_ALREADY_INCLUDING_STDIO_H
24 /* Special invocation convention:
25    - Inside glibc header files.
26    - On OSF/1 5.1 we have a sequence of nested includes
27      <stdio.h> -> <getopt.h> -> <ctype.h> -> <sys/localedef.h> ->
28      <sys/lc_core.h> -> <nl_types.h> -> <mesg.h> -> <stdio.h>.
29      In this situation, the functions are not yet declared, therefore we cannot
30      provide the C++ aliases.  */
31 
32 #@INCLUDE_NEXT@ @NEXT_STDIO_H@
33 
34 #else
35 /* Normal invocation convention.  */
36 
37 #ifndef _@GUARD_PREFIX@_STDIO_H
38 
39 #define _GL_ALREADY_INCLUDING_STDIO_H
40 
41 /* The include_next requires a split double-inclusion guard.  */
42 #@INCLUDE_NEXT@ @NEXT_STDIO_H@
43 
44 #undef _GL_ALREADY_INCLUDING_STDIO_H
45 
46 #ifndef _@GUARD_PREFIX@_STDIO_H
47 #define _@GUARD_PREFIX@_STDIO_H
48 
49 /* Get va_list.  Needed on many systems, including glibc 2.8.  */
50 #include <stdarg.h>
51 
52 #include <stddef.h>
53 
54 /* Get off_t and ssize_t.  Needed on many systems, including glibc 2.8
55    and eglibc 2.11.2.
56    May also define off_t to a 64-bit type on native Windows.  */
57 #include <sys/types.h>
58 
59 /* The __attribute__ feature is available in gcc versions 2.5 and later.
60    The __-protected variants of the attributes 'format' and 'printf' are
61    accepted by gcc versions 2.6.4 (effectively 2.7) and later.
62    We enable _GL_ATTRIBUTE_FORMAT only if these are supported too, because
63    gnulib and libintl do '#define printf __printf__' when they override
64    the 'printf' function.  */
65 #ifndef _GL_ATTRIBUTE_FORMAT
66 # if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7)
67 #  define _GL_ATTRIBUTE_FORMAT(spec) __attribute__ ((__format__ spec))
68 # else
69 #  define _GL_ATTRIBUTE_FORMAT(spec) /* empty */
70 # endif
71 #endif
72 
73 /* _GL_ATTRIBUTE_FORMAT_PRINTF
74    indicates to GCC that the function takes a format string and arguments,
75    where the format string directives are the ones standardized by ISO C99
76    and POSIX.  */
77 #if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4)
78 # define _GL_ATTRIBUTE_FORMAT_PRINTF(formatstring_parameter, first_argument) \
79    _GL_ATTRIBUTE_FORMAT ((__gnu_printf__, formatstring_parameter, first_argument))
80 #else
81 # define _GL_ATTRIBUTE_FORMAT_PRINTF(formatstring_parameter, first_argument) \
82    _GL_ATTRIBUTE_FORMAT ((__printf__, formatstring_parameter, first_argument))
83 #endif
84 
85 /* _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM is like _GL_ATTRIBUTE_FORMAT_PRINTF,
86    except that it indicates to GCC that the supported format string directives
87    are the ones of the system printf(), rather than the ones standardized by
88    ISO C99 and POSIX.  */
89 #if GNULIB_PRINTF_ATTRIBUTE_FLAVOR_GNU
90 # define _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM(formatstring_parameter, first_argument) \
91   _GL_ATTRIBUTE_FORMAT_PRINTF (formatstring_parameter, first_argument)
92 #else
93 # define _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM(formatstring_parameter, first_argument) \
94   _GL_ATTRIBUTE_FORMAT ((__printf__, formatstring_parameter, first_argument))
95 #endif
96 
97 /* _GL_ATTRIBUTE_FORMAT_SCANF
98    indicates to GCC that the function takes a format string and arguments,
99    where the format string directives are the ones standardized by ISO C99
100    and POSIX.  */
101 #if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4)
102 # define _GL_ATTRIBUTE_FORMAT_SCANF(formatstring_parameter, first_argument) \
103    _GL_ATTRIBUTE_FORMAT ((__gnu_scanf__, formatstring_parameter, first_argument))
104 #else
105 # define _GL_ATTRIBUTE_FORMAT_SCANF(formatstring_parameter, first_argument) \
106    _GL_ATTRIBUTE_FORMAT ((__scanf__, formatstring_parameter, first_argument))
107 #endif
108 
109 /* _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM is like _GL_ATTRIBUTE_FORMAT_SCANF,
110    except that it indicates to GCC that the supported format string directives
111    are the ones of the system scanf(), rather than the ones standardized by
112    ISO C99 and POSIX.  */
113 #define _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM(formatstring_parameter, first_argument) \
114   _GL_ATTRIBUTE_FORMAT ((__scanf__, formatstring_parameter, first_argument))
115 
116 /* Solaris 10 and NetBSD 7.0 declare renameat in <unistd.h>, not in <stdio.h>.  */
117 /* But in any case avoid namespace pollution on glibc systems.  */
118 #if (@GNULIB_RENAMEAT@ || defined GNULIB_POSIXCHECK) && (defined __sun || defined __NetBSD__) \
119     && ! defined __GLIBC__
120 # include <unistd.h>
121 #endif
122 
123 /* Android 4.3 declares renameat in <sys/stat.h>, not in <stdio.h>.  */
124 /* But in any case avoid namespace pollution on glibc systems.  */
125 #if (@GNULIB_RENAMEAT@ || defined GNULIB_POSIXCHECK) && defined __ANDROID__ \
126     && ! defined __GLIBC__
127 # include <sys/stat.h>
128 #endif
129 
130 /* MSVC declares 'perror' in <stdlib.h>, not in <stdio.h>.  We must include
131    it before we  #define perror rpl_perror.  */
132 /* But in any case avoid namespace pollution on glibc systems.  */
133 #if (@GNULIB_PERROR@ || defined GNULIB_POSIXCHECK) \
134     && (defined _WIN32 && ! defined __CYGWIN__) \
135     && ! defined __GLIBC__
136 # include <stdlib.h>
137 #endif
138 
139 /* MSVC declares 'remove' in <io.h>, not in <stdio.h>.  We must include
140    it before we  #define remove rpl_remove.  */
141 /* MSVC declares 'rename' in <io.h>, not in <stdio.h>.  We must include
142    it before we  #define rename rpl_rename.  */
143 /* But in any case avoid namespace pollution on glibc systems.  */
144 #if (@GNULIB_REMOVE@ || @GNULIB_RENAME@ || defined GNULIB_POSIXCHECK) \
145     && (defined _WIN32 && ! defined __CYGWIN__) \
146     && ! defined __GLIBC__
147 # include <io.h>
148 #endif
149 
150 
151 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
152 
153 /* The definition of _GL_ARG_NONNULL is copied here.  */
154 
155 /* The definition of _GL_WARN_ON_USE is copied here.  */
156 
157 /* Macros for stringification.  */
158 #define _GL_STDIO_STRINGIZE(token) #token
159 #define _GL_STDIO_MACROEXPAND_AND_STRINGIZE(token) _GL_STDIO_STRINGIZE(token)
160 
161 /* When also using extern inline, suppress the use of static inline in
162    standard headers of problematic Apple configurations, as Libc at
163    least through Libc-825.26 (2013-04-09) mishandles it; see, e.g.,
164    <https://lists.gnu.org/r/bug-gnulib/2012-12/msg00023.html>.
165    Perhaps Apple will fix this some day.  */
166 #if (defined _GL_EXTERN_INLINE_IN_USE && defined __APPLE__ \
167      && defined __GNUC__ && defined __STDC__)
168 # undef putc_unlocked
169 #endif
170 
171 #if @GNULIB_DPRINTF@
172 # if @REPLACE_DPRINTF@
173 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
174 #   define dprintf rpl_dprintf
175 #  endif
176 _GL_FUNCDECL_RPL (dprintf, int, (int fd, const char *restrict format, ...)
177                                 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
178                                 _GL_ARG_NONNULL ((2)));
179 _GL_CXXALIAS_RPL (dprintf, int, (int fd, const char *restrict format, ...));
180 # else
181 #  if !@HAVE_DPRINTF@
182 _GL_FUNCDECL_SYS (dprintf, int, (int fd, const char *restrict format, ...)
183                                 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
184                                 _GL_ARG_NONNULL ((2)));
185 #  endif
186 _GL_CXXALIAS_SYS (dprintf, int, (int fd, const char *restrict format, ...));
187 # endif
188 _GL_CXXALIASWARN (dprintf);
189 #elif defined GNULIB_POSIXCHECK
190 # undef dprintf
191 # if HAVE_RAW_DECL_DPRINTF
192 _GL_WARN_ON_USE (dprintf, "dprintf is unportable - "
193                  "use gnulib module dprintf for portability");
194 # endif
195 #endif
196 
197 #if @GNULIB_FCLOSE@
198 /* Close STREAM and its underlying file descriptor.  */
199 # if @REPLACE_FCLOSE@
200 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
201 #   define fclose rpl_fclose
202 #  endif
203 _GL_FUNCDECL_RPL (fclose, int, (FILE *stream) _GL_ARG_NONNULL ((1)));
204 _GL_CXXALIAS_RPL (fclose, int, (FILE *stream));
205 # else
206 _GL_CXXALIAS_SYS (fclose, int, (FILE *stream));
207 # endif
208 # if __GLIBC__ >= 2
209 _GL_CXXALIASWARN (fclose);
210 # endif
211 #elif defined GNULIB_POSIXCHECK
212 # undef fclose
213 /* Assume fclose is always declared.  */
214 _GL_WARN_ON_USE (fclose, "fclose is not always POSIX compliant - "
215                  "use gnulib module fclose for portable POSIX compliance");
216 #endif
217 
218 #if @GNULIB_FDOPEN@
219 # if @REPLACE_FDOPEN@
220 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
221 #   undef fdopen
222 #   define fdopen rpl_fdopen
223 #  endif
224 _GL_FUNCDECL_RPL (fdopen, FILE *, (int fd, const char *mode)
225                                   _GL_ARG_NONNULL ((2)));
226 _GL_CXXALIAS_RPL (fdopen, FILE *, (int fd, const char *mode));
227 # else
228 _GL_CXXALIAS_SYS (fdopen, FILE *, (int fd, const char *mode));
229 # endif
230 _GL_CXXALIASWARN (fdopen);
231 #elif defined GNULIB_POSIXCHECK
232 # undef fdopen
233 /* Assume fdopen is always declared.  */
234 _GL_WARN_ON_USE (fdopen, "fdopen on native Windows platforms is not POSIX compliant - "
235                  "use gnulib module fdopen for portability");
236 #endif
237 
238 #if @GNULIB_FFLUSH@
239 /* Flush all pending data on STREAM according to POSIX rules.  Both
240    output and seekable input streams are supported.
241    Note! LOSS OF DATA can occur if fflush is applied on an input stream
242    that is _not_seekable_ or on an update stream that is _not_seekable_
243    and in which the most recent operation was input.  Seekability can
244    be tested with lseek(fileno(fp),0,SEEK_CUR).  */
245 # if @REPLACE_FFLUSH@
246 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
247 #   define fflush rpl_fflush
248 #  endif
249 _GL_FUNCDECL_RPL (fflush, int, (FILE *gl_stream));
250 _GL_CXXALIAS_RPL (fflush, int, (FILE *gl_stream));
251 # else
252 _GL_CXXALIAS_SYS (fflush, int, (FILE *gl_stream));
253 # endif
254 # if __GLIBC__ >= 2
255 _GL_CXXALIASWARN (fflush);
256 # endif
257 #elif defined GNULIB_POSIXCHECK
258 # undef fflush
259 /* Assume fflush is always declared.  */
260 _GL_WARN_ON_USE (fflush, "fflush is not always POSIX compliant - "
261                  "use gnulib module fflush for portable POSIX compliance");
262 #endif
263 
264 #if @GNULIB_FGETC@
265 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
266 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
267 #   undef fgetc
268 #   define fgetc rpl_fgetc
269 #  endif
270 _GL_FUNCDECL_RPL (fgetc, int, (FILE *stream) _GL_ARG_NONNULL ((1)));
271 _GL_CXXALIAS_RPL (fgetc, int, (FILE *stream));
272 # else
273 _GL_CXXALIAS_SYS (fgetc, int, (FILE *stream));
274 # endif
275 # if __GLIBC__ >= 2
276 _GL_CXXALIASWARN (fgetc);
277 # endif
278 #endif
279 
280 #if @GNULIB_FGETS@
281 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
282 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
283 #   undef fgets
284 #   define fgets rpl_fgets
285 #  endif
286 _GL_FUNCDECL_RPL (fgets, char *,
287                   (char *restrict s, int n, FILE *restrict stream)
288                   _GL_ARG_NONNULL ((1, 3)));
289 _GL_CXXALIAS_RPL (fgets, char *,
290                   (char *restrict s, int n, FILE *restrict stream));
291 # else
292 _GL_CXXALIAS_SYS (fgets, char *,
293                   (char *restrict s, int n, FILE *restrict stream));
294 # endif
295 # if __GLIBC__ >= 2
296 _GL_CXXALIASWARN (fgets);
297 # endif
298 #endif
299 
300 #if @GNULIB_FOPEN@
301 # if @REPLACE_FOPEN@
302 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
303 #   undef fopen
304 #   define fopen rpl_fopen
305 #  endif
306 _GL_FUNCDECL_RPL (fopen, FILE *,
307                   (const char *restrict filename, const char *restrict mode)
308                   _GL_ARG_NONNULL ((1, 2)));
309 _GL_CXXALIAS_RPL (fopen, FILE *,
310                   (const char *restrict filename, const char *restrict mode));
311 # else
312 _GL_CXXALIAS_SYS (fopen, FILE *,
313                   (const char *restrict filename, const char *restrict mode));
314 # endif
315 # if __GLIBC__ >= 2
316 _GL_CXXALIASWARN (fopen);
317 # endif
318 #elif defined GNULIB_POSIXCHECK
319 # undef fopen
320 /* Assume fopen is always declared.  */
321 _GL_WARN_ON_USE (fopen, "fopen on native Windows platforms is not POSIX compliant - "
322                  "use gnulib module fopen for portability");
323 #endif
324 
325 #if @GNULIB_FPRINTF_POSIX@ || @GNULIB_FPRINTF@
326 # if (@GNULIB_FPRINTF_POSIX@ && @REPLACE_FPRINTF@) \
327      || (@GNULIB_FPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
328 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
329 #   define fprintf rpl_fprintf
330 #  endif
331 #  define GNULIB_overrides_fprintf 1
332 #  if @GNULIB_FPRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
333 _GL_FUNCDECL_RPL (fprintf, int,
334                   (FILE *restrict fp, const char *restrict format, ...)
335                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
336                   _GL_ARG_NONNULL ((1, 2)));
337 #  else
338 _GL_FUNCDECL_RPL (fprintf, int,
339                   (FILE *restrict fp, const char *restrict format, ...)
340                   _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (2, 3)
341                   _GL_ARG_NONNULL ((1, 2)));
342 #  endif
343 _GL_CXXALIAS_RPL (fprintf, int,
344                   (FILE *restrict fp, const char *restrict format, ...));
345 # else
346 _GL_CXXALIAS_SYS (fprintf, int,
347                   (FILE *restrict fp, const char *restrict format, ...));
348 # endif
349 # if __GLIBC__ >= 2
350 _GL_CXXALIASWARN (fprintf);
351 # endif
352 #endif
353 #if !@GNULIB_FPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
354 # if !GNULIB_overrides_fprintf
355 #  undef fprintf
356 # endif
357 /* Assume fprintf is always declared.  */
358 _GL_WARN_ON_USE (fprintf, "fprintf is not always POSIX compliant - "
359                  "use gnulib module fprintf-posix for portable "
360                  "POSIX compliance");
361 #endif
362 
363 #if @GNULIB_FPURGE@
364 /* Discard all pending buffered I/O data on STREAM.
365    STREAM must not be wide-character oriented.
366    When discarding pending output, the file position is set back to where it
367    was before the write calls.  When discarding pending input, the file
368    position is advanced to match the end of the previously read input.
369    Return 0 if successful.  Upon error, return -1 and set errno.  */
370 # if @REPLACE_FPURGE@
371 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
372 #   define fpurge rpl_fpurge
373 #  endif
374 _GL_FUNCDECL_RPL (fpurge, int, (FILE *gl_stream) _GL_ARG_NONNULL ((1)));
375 _GL_CXXALIAS_RPL (fpurge, int, (FILE *gl_stream));
376 # else
377 #  if !@HAVE_DECL_FPURGE@
378 _GL_FUNCDECL_SYS (fpurge, int, (FILE *gl_stream) _GL_ARG_NONNULL ((1)));
379 #  endif
380 _GL_CXXALIAS_SYS (fpurge, int, (FILE *gl_stream));
381 # endif
382 _GL_CXXALIASWARN (fpurge);
383 #elif defined GNULIB_POSIXCHECK
384 # undef fpurge
385 # if HAVE_RAW_DECL_FPURGE
386 _GL_WARN_ON_USE (fpurge, "fpurge is not always present - "
387                  "use gnulib module fpurge for portability");
388 # endif
389 #endif
390 
391 #if @GNULIB_FPUTC@
392 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
393 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
394 #   undef fputc
395 #   define fputc rpl_fputc
396 #  endif
397 _GL_FUNCDECL_RPL (fputc, int, (int c, FILE *stream) _GL_ARG_NONNULL ((2)));
398 _GL_CXXALIAS_RPL (fputc, int, (int c, FILE *stream));
399 # else
400 _GL_CXXALIAS_SYS (fputc, int, (int c, FILE *stream));
401 # endif
402 # if __GLIBC__ >= 2
403 _GL_CXXALIASWARN (fputc);
404 # endif
405 #endif
406 
407 #if @GNULIB_FPUTS@
408 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
409 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
410 #   undef fputs
411 #   define fputs rpl_fputs
412 #  endif
413 _GL_FUNCDECL_RPL (fputs, int,
414                   (const char *restrict string, FILE *restrict stream)
415                   _GL_ARG_NONNULL ((1, 2)));
416 _GL_CXXALIAS_RPL (fputs, int,
417                   (const char *restrict string, FILE *restrict stream));
418 # else
419 _GL_CXXALIAS_SYS (fputs, int,
420                   (const char *restrict string, FILE *restrict stream));
421 # endif
422 # if __GLIBC__ >= 2
423 _GL_CXXALIASWARN (fputs);
424 # endif
425 #endif
426 
427 #if @GNULIB_FREAD@
428 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
429 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
430 #   undef fread
431 #   define fread rpl_fread
432 #  endif
433 _GL_FUNCDECL_RPL (fread, size_t,
434                   (void *restrict ptr, size_t s, size_t n,
435                    FILE *restrict stream)
436                   _GL_ARG_NONNULL ((4)));
437 _GL_CXXALIAS_RPL (fread, size_t,
438                   (void *restrict ptr, size_t s, size_t n,
439                    FILE *restrict stream));
440 # else
441 _GL_CXXALIAS_SYS (fread, size_t,
442                   (void *restrict ptr, size_t s, size_t n,
443                    FILE *restrict stream));
444 # endif
445 # if __GLIBC__ >= 2
446 _GL_CXXALIASWARN (fread);
447 # endif
448 #endif
449 
450 #if @GNULIB_FREOPEN@
451 # if @REPLACE_FREOPEN@
452 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
453 #   undef freopen
454 #   define freopen rpl_freopen
455 #  endif
456 _GL_FUNCDECL_RPL (freopen, FILE *,
457                   (const char *restrict filename, const char *restrict mode,
458                    FILE *restrict stream)
459                   _GL_ARG_NONNULL ((2, 3)));
460 _GL_CXXALIAS_RPL (freopen, FILE *,
461                   (const char *restrict filename, const char *restrict mode,
462                    FILE *restrict stream));
463 # else
464 _GL_CXXALIAS_SYS (freopen, FILE *,
465                   (const char *restrict filename, const char *restrict mode,
466                    FILE *restrict stream));
467 # endif
468 # if __GLIBC__ >= 2
469 _GL_CXXALIASWARN (freopen);
470 # endif
471 #elif defined GNULIB_POSIXCHECK
472 # undef freopen
473 /* Assume freopen is always declared.  */
474 _GL_WARN_ON_USE (freopen,
475                  "freopen on native Windows platforms is not POSIX compliant - "
476                  "use gnulib module freopen for portability");
477 #endif
478 
479 #if @GNULIB_FSCANF@
480 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
481 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
482 #   undef fscanf
483 #   define fscanf rpl_fscanf
484 #  endif
485 _GL_FUNCDECL_RPL (fscanf, int,
486                   (FILE *restrict stream, const char *restrict format, ...)
487                   _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (2, 3)
488                   _GL_ARG_NONNULL ((1, 2)));
489 _GL_CXXALIAS_RPL (fscanf, int,
490                   (FILE *restrict stream, const char *restrict format, ...));
491 # else
492 _GL_CXXALIAS_SYS (fscanf, int,
493                   (FILE *restrict stream, const char *restrict format, ...));
494 # endif
495 # if __GLIBC__ >= 2
496 _GL_CXXALIASWARN (fscanf);
497 # endif
498 #endif
499 
500 
501 /* Set up the following warnings, based on which modules are in use.
502    GNU Coding Standards discourage the use of fseek, since it imposes
503    an arbitrary limitation on some 32-bit hosts.  Remember that the
504    fseek module depends on the fseeko module, so we only have three
505    cases to consider:
506 
507    1. The developer is not using either module.  Issue a warning under
508    GNULIB_POSIXCHECK for both functions, to remind them that both
509    functions have bugs on some systems.  _GL_NO_LARGE_FILES has no
510    impact on this warning.
511 
512    2. The developer is using both modules.  They may be unaware of the
513    arbitrary limitations of fseek, so issue a warning under
514    GNULIB_POSIXCHECK.  On the other hand, they may be using both
515    modules intentionally, so the developer can define
516    _GL_NO_LARGE_FILES in the compilation units where the use of fseek
517    is safe, to silence the warning.
518 
519    3. The developer is using the fseeko module, but not fseek.  Gnulib
520    guarantees that fseek will still work around platform bugs in that
521    case, but we presume that the developer is aware of the pitfalls of
522    fseek and was trying to avoid it, so issue a warning even when
523    GNULIB_POSIXCHECK is undefined.  Again, _GL_NO_LARGE_FILES can be
524    defined to silence the warning in particular compilation units.
525    In C++ compilations with GNULIB_NAMESPACE, in order to avoid that
526    fseek gets defined as a macro, it is recommended that the developer
527    uses the fseek module, even if he is not calling the fseek function.
528 
529    Most gnulib clients that perform stream operations should fall into
530    category 3.  */
531 
532 #if @GNULIB_FSEEK@
533 # if defined GNULIB_POSIXCHECK && !defined _GL_NO_LARGE_FILES
534 #  define _GL_FSEEK_WARN /* Category 2, above.  */
535 #  undef fseek
536 # endif
537 # if @REPLACE_FSEEK@
538 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
539 #   undef fseek
540 #   define fseek rpl_fseek
541 #  endif
542 _GL_FUNCDECL_RPL (fseek, int, (FILE *fp, long offset, int whence)
543                               _GL_ARG_NONNULL ((1)));
544 _GL_CXXALIAS_RPL (fseek, int, (FILE *fp, long offset, int whence));
545 # else
546 _GL_CXXALIAS_SYS (fseek, int, (FILE *fp, long offset, int whence));
547 # endif
548 # if __GLIBC__ >= 2
549 _GL_CXXALIASWARN (fseek);
550 # endif
551 #endif
552 
553 #if @GNULIB_FSEEKO@
554 # if !@GNULIB_FSEEK@ && !defined _GL_NO_LARGE_FILES
555 #  define _GL_FSEEK_WARN /* Category 3, above.  */
556 #  undef fseek
557 # endif
558 # if @REPLACE_FSEEKO@
559 /* Provide an fseeko function that is aware of a preceding fflush(), and which
560    detects pipes.  */
561 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
562 #   undef fseeko
563 #   define fseeko rpl_fseeko
564 #  endif
565 _GL_FUNCDECL_RPL (fseeko, int, (FILE *fp, off_t offset, int whence)
566                                _GL_ARG_NONNULL ((1)));
567 _GL_CXXALIAS_RPL (fseeko, int, (FILE *fp, off_t offset, int whence));
568 # else
569 #  if ! @HAVE_DECL_FSEEKO@
570 _GL_FUNCDECL_SYS (fseeko, int, (FILE *fp, off_t offset, int whence)
571                                _GL_ARG_NONNULL ((1)));
572 #  endif
573 _GL_CXXALIAS_SYS (fseeko, int, (FILE *fp, off_t offset, int whence));
574 # endif
575 _GL_CXXALIASWARN (fseeko);
576 #elif defined GNULIB_POSIXCHECK
577 # define _GL_FSEEK_WARN /* Category 1, above.  */
578 # undef fseek
579 # undef fseeko
580 # if HAVE_RAW_DECL_FSEEKO
581 _GL_WARN_ON_USE (fseeko, "fseeko is unportable - "
582                  "use gnulib module fseeko for portability");
583 # endif
584 #endif
585 
586 #ifdef _GL_FSEEK_WARN
587 # undef _GL_FSEEK_WARN
588 /* Here, either fseek is undefined (but C89 guarantees that it is
589    declared), or it is defined as rpl_fseek (declared above).  */
590 _GL_WARN_ON_USE (fseek, "fseek cannot handle files larger than 4 GB "
591                  "on 32-bit platforms - "
592                  "use fseeko function for handling of large files");
593 #endif
594 
595 
596 /* ftell, ftello.  See the comments on fseek/fseeko.  */
597 
598 #if @GNULIB_FTELL@
599 # if defined GNULIB_POSIXCHECK && !defined _GL_NO_LARGE_FILES
600 #  define _GL_FTELL_WARN /* Category 2, above.  */
601 #  undef ftell
602 # endif
603 # if @REPLACE_FTELL@
604 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
605 #   undef ftell
606 #   define ftell rpl_ftell
607 #  endif
608 _GL_FUNCDECL_RPL (ftell, long, (FILE *fp) _GL_ARG_NONNULL ((1)));
609 _GL_CXXALIAS_RPL (ftell, long, (FILE *fp));
610 # else
611 _GL_CXXALIAS_SYS (ftell, long, (FILE *fp));
612 # endif
613 # if __GLIBC__ >= 2
614 _GL_CXXALIASWARN (ftell);
615 # endif
616 #endif
617 
618 #if @GNULIB_FTELLO@
619 # if !@GNULIB_FTELL@ && !defined _GL_NO_LARGE_FILES
620 #  define _GL_FTELL_WARN /* Category 3, above.  */
621 #  undef ftell
622 # endif
623 # if @REPLACE_FTELLO@
624 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
625 #   undef ftello
626 #   define ftello rpl_ftello
627 #  endif
628 _GL_FUNCDECL_RPL (ftello, off_t, (FILE *fp) _GL_ARG_NONNULL ((1)));
629 _GL_CXXALIAS_RPL (ftello, off_t, (FILE *fp));
630 # else
631 #  if ! @HAVE_DECL_FTELLO@
632 _GL_FUNCDECL_SYS (ftello, off_t, (FILE *fp) _GL_ARG_NONNULL ((1)));
633 #  endif
634 _GL_CXXALIAS_SYS (ftello, off_t, (FILE *fp));
635 # endif
636 _GL_CXXALIASWARN (ftello);
637 #elif defined GNULIB_POSIXCHECK
638 # define _GL_FTELL_WARN /* Category 1, above.  */
639 # undef ftell
640 # undef ftello
641 # if HAVE_RAW_DECL_FTELLO
642 _GL_WARN_ON_USE (ftello, "ftello is unportable - "
643                  "use gnulib module ftello for portability");
644 # endif
645 #endif
646 
647 #ifdef _GL_FTELL_WARN
648 # undef _GL_FTELL_WARN
649 /* Here, either ftell is undefined (but C89 guarantees that it is
650    declared), or it is defined as rpl_ftell (declared above).  */
651 _GL_WARN_ON_USE (ftell, "ftell cannot handle files larger than 4 GB "
652                  "on 32-bit platforms - "
653                  "use ftello function for handling of large files");
654 #endif
655 
656 
657 #if @GNULIB_FWRITE@
658 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
659 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
660 #   undef fwrite
661 #   define fwrite rpl_fwrite
662 #  endif
663 _GL_FUNCDECL_RPL (fwrite, size_t,
664                   (const void *restrict ptr, size_t s, size_t n,
665                    FILE *restrict stream)
666                   _GL_ARG_NONNULL ((1, 4)));
667 _GL_CXXALIAS_RPL (fwrite, size_t,
668                   (const void *restrict ptr, size_t s, size_t n,
669                    FILE *restrict stream));
670 # else
671 _GL_CXXALIAS_SYS (fwrite, size_t,
672                   (const void *restrict ptr, size_t s, size_t n,
673                    FILE *restrict stream));
674 
675 /* Work around bug 11959 when fortifying glibc 2.4 through 2.15
676    <https://sourceware.org/bugzilla/show_bug.cgi?id=11959>,
677    which sometimes causes an unwanted diagnostic for fwrite calls.
678    This affects only function declaration attributes under certain
679    versions of gcc and clang, and is not needed for C++.  */
680 #  if (0 < __USE_FORTIFY_LEVEL                                          \
681        && __GLIBC__ == 2 && 4 <= __GLIBC_MINOR__ && __GLIBC_MINOR__ <= 15 \
682        && 3 < __GNUC__ + (4 <= __GNUC_MINOR__)                          \
683        && !defined __cplusplus)
684 #   undef fwrite
685 #   undef fwrite_unlocked
686 extern size_t __REDIRECT (rpl_fwrite,
687                           (const void *__restrict, size_t, size_t,
688                            FILE *__restrict),
689                           fwrite);
690 extern size_t __REDIRECT (rpl_fwrite_unlocked,
691                           (const void *__restrict, size_t, size_t,
692                            FILE *__restrict),
693                           fwrite_unlocked);
694 #   define fwrite rpl_fwrite
695 #   define fwrite_unlocked rpl_fwrite_unlocked
696 #  endif
697 # endif
698 # if __GLIBC__ >= 2
699 _GL_CXXALIASWARN (fwrite);
700 # endif
701 #endif
702 
703 #if @GNULIB_GETC@
704 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
705 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
706 #   undef getc
707 #   define getc rpl_fgetc
708 #  endif
709 _GL_FUNCDECL_RPL (fgetc, int, (FILE *stream) _GL_ARG_NONNULL ((1)));
710 _GL_CXXALIAS_RPL_1 (getc, rpl_fgetc, int, (FILE *stream));
711 # else
712 _GL_CXXALIAS_SYS (getc, int, (FILE *stream));
713 # endif
714 # if __GLIBC__ >= 2
715 _GL_CXXALIASWARN (getc);
716 # endif
717 #endif
718 
719 #if @GNULIB_GETCHAR@
720 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
721 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
722 #   undef getchar
723 #   define getchar rpl_getchar
724 #  endif
725 _GL_FUNCDECL_RPL (getchar, int, (void));
726 _GL_CXXALIAS_RPL (getchar, int, (void));
727 # else
728 _GL_CXXALIAS_SYS (getchar, int, (void));
729 # endif
730 # if __GLIBC__ >= 2
731 _GL_CXXALIASWARN (getchar);
732 # endif
733 #endif
734 
735 #if @GNULIB_GETDELIM@
736 /* Read input, up to (and including) the next occurrence of DELIMITER, from
737    STREAM, store it in *LINEPTR (and NUL-terminate it).
738    *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
739    bytes of space.  It is realloc'd as necessary.
740    Return the number of bytes read and stored at *LINEPTR (not including the
741    NUL terminator), or -1 on error or EOF.  */
742 # if @REPLACE_GETDELIM@
743 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
744 #   undef getdelim
745 #   define getdelim rpl_getdelim
746 #  endif
747 _GL_FUNCDECL_RPL (getdelim, ssize_t,
748                   (char **restrict lineptr, size_t *restrict linesize,
749                    int delimiter,
750                    FILE *restrict stream)
751                   _GL_ARG_NONNULL ((1, 2, 4)));
752 _GL_CXXALIAS_RPL (getdelim, ssize_t,
753                   (char **restrict lineptr, size_t *restrict linesize,
754                    int delimiter,
755                    FILE *restrict stream));
756 # else
757 #  if !@HAVE_DECL_GETDELIM@
758 _GL_FUNCDECL_SYS (getdelim, ssize_t,
759                   (char **restrict lineptr, size_t *restrict linesize,
760                    int delimiter,
761                    FILE *restrict stream)
762                   _GL_ARG_NONNULL ((1, 2, 4)));
763 #  endif
764 _GL_CXXALIAS_SYS (getdelim, ssize_t,
765                   (char **restrict lineptr, size_t *restrict linesize,
766                    int delimiter,
767                    FILE *restrict stream));
768 # endif
769 _GL_CXXALIASWARN (getdelim);
770 #elif defined GNULIB_POSIXCHECK
771 # undef getdelim
772 # if HAVE_RAW_DECL_GETDELIM
773 _GL_WARN_ON_USE (getdelim, "getdelim is unportable - "
774                  "use gnulib module getdelim for portability");
775 # endif
776 #endif
777 
778 #if @GNULIB_GETLINE@
779 /* Read a line, up to (and including) the next newline, from STREAM, store it
780    in *LINEPTR (and NUL-terminate it).
781    *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
782    bytes of space.  It is realloc'd as necessary.
783    Return the number of bytes read and stored at *LINEPTR (not including the
784    NUL terminator), or -1 on error or EOF.  */
785 # if @REPLACE_GETLINE@
786 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
787 #   undef getline
788 #   define getline rpl_getline
789 #  endif
790 _GL_FUNCDECL_RPL (getline, ssize_t,
791                   (char **restrict lineptr, size_t *restrict linesize,
792                    FILE *restrict stream)
793                   _GL_ARG_NONNULL ((1, 2, 3)));
794 _GL_CXXALIAS_RPL (getline, ssize_t,
795                   (char **restrict lineptr, size_t *restrict linesize,
796                    FILE *restrict stream));
797 # else
798 #  if !@HAVE_DECL_GETLINE@
799 _GL_FUNCDECL_SYS (getline, ssize_t,
800                   (char **restrict lineptr, size_t *restrict linesize,
801                    FILE *restrict stream)
802                   _GL_ARG_NONNULL ((1, 2, 3)));
803 #  endif
804 _GL_CXXALIAS_SYS (getline, ssize_t,
805                   (char **restrict lineptr, size_t *restrict linesize,
806                    FILE *restrict stream));
807 # endif
808 # if @HAVE_DECL_GETLINE@
809 _GL_CXXALIASWARN (getline);
810 # endif
811 #elif defined GNULIB_POSIXCHECK
812 # undef getline
813 # if HAVE_RAW_DECL_GETLINE
814 _GL_WARN_ON_USE (getline, "getline is unportable - "
815                  "use gnulib module getline for portability");
816 # endif
817 #endif
818 
819 /* It is very rare that the developer ever has full control of stdin,
820    so any use of gets warrants an unconditional warning; besides, C11
821    removed it.  */
822 #undef gets
823 #if HAVE_RAW_DECL_GETS && !defined __cplusplus
824 _GL_WARN_ON_USE (gets, "gets is a security hole - use fgets instead");
825 #endif
826 
827 #if @GNULIB_OBSTACK_PRINTF@ || @GNULIB_OBSTACK_PRINTF_POSIX@
828 struct obstack;
829 /* Grow an obstack with formatted output.  Return the number of
830    bytes added to OBS.  No trailing nul byte is added, and the
831    object should be closed with obstack_finish before use.  Upon
832    memory allocation error, call obstack_alloc_failed_handler.  Upon
833    other error, return -1.  */
834 # if @REPLACE_OBSTACK_PRINTF@
835 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
836 #   define obstack_printf rpl_obstack_printf
837 #  endif
838 _GL_FUNCDECL_RPL (obstack_printf, int,
839                   (struct obstack *obs, const char *format, ...)
840                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
841                   _GL_ARG_NONNULL ((1, 2)));
842 _GL_CXXALIAS_RPL (obstack_printf, int,
843                   (struct obstack *obs, const char *format, ...));
844 # else
845 #  if !@HAVE_DECL_OBSTACK_PRINTF@
846 _GL_FUNCDECL_SYS (obstack_printf, int,
847                   (struct obstack *obs, const char *format, ...)
848                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
849                   _GL_ARG_NONNULL ((1, 2)));
850 #  endif
851 _GL_CXXALIAS_SYS (obstack_printf, int,
852                   (struct obstack *obs, const char *format, ...));
853 # endif
854 _GL_CXXALIASWARN (obstack_printf);
855 # if @REPLACE_OBSTACK_PRINTF@
856 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
857 #   define obstack_vprintf rpl_obstack_vprintf
858 #  endif
859 _GL_FUNCDECL_RPL (obstack_vprintf, int,
860                   (struct obstack *obs, const char *format, va_list args)
861                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
862                   _GL_ARG_NONNULL ((1, 2)));
863 _GL_CXXALIAS_RPL (obstack_vprintf, int,
864                   (struct obstack *obs, const char *format, va_list args));
865 # else
866 #  if !@HAVE_DECL_OBSTACK_PRINTF@
867 _GL_FUNCDECL_SYS (obstack_vprintf, int,
868                   (struct obstack *obs, const char *format, va_list args)
869                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
870                   _GL_ARG_NONNULL ((1, 2)));
871 #  endif
872 _GL_CXXALIAS_SYS (obstack_vprintf, int,
873                   (struct obstack *obs, const char *format, va_list args));
874 # endif
875 _GL_CXXALIASWARN (obstack_vprintf);
876 #endif
877 
878 #if @GNULIB_PCLOSE@
879 # if !@HAVE_PCLOSE@
880 _GL_FUNCDECL_SYS (pclose, int, (FILE *stream) _GL_ARG_NONNULL ((1)));
881 # endif
882 _GL_CXXALIAS_SYS (pclose, int, (FILE *stream));
883 _GL_CXXALIASWARN (pclose);
884 #elif defined GNULIB_POSIXCHECK
885 # undef pclose
886 # if HAVE_RAW_DECL_PCLOSE
887 _GL_WARN_ON_USE (pclose, "pclose is unportable - "
888                  "use gnulib module pclose for more portability");
889 # endif
890 #endif
891 
892 #if @GNULIB_PERROR@
893 /* Print a message to standard error, describing the value of ERRNO,
894    (if STRING is not NULL and not empty) prefixed with STRING and ": ",
895    and terminated with a newline.  */
896 # if @REPLACE_PERROR@
897 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
898 #   define perror rpl_perror
899 #  endif
900 _GL_FUNCDECL_RPL (perror, void, (const char *string));
901 _GL_CXXALIAS_RPL (perror, void, (const char *string));
902 # else
903 _GL_CXXALIAS_SYS (perror, void, (const char *string));
904 # endif
905 # if __GLIBC__ >= 2
906 _GL_CXXALIASWARN (perror);
907 # endif
908 #elif defined GNULIB_POSIXCHECK
909 # undef perror
910 /* Assume perror is always declared.  */
911 _GL_WARN_ON_USE (perror, "perror is not always POSIX compliant - "
912                  "use gnulib module perror for portability");
913 #endif
914 
915 #if @GNULIB_POPEN@
916 # if @REPLACE_POPEN@
917 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
918 #   undef popen
919 #   define popen rpl_popen
920 #  endif
921 _GL_FUNCDECL_RPL (popen, FILE *, (const char *cmd, const char *mode)
922                                  _GL_ARG_NONNULL ((1, 2)));
923 _GL_CXXALIAS_RPL (popen, FILE *, (const char *cmd, const char *mode));
924 # else
925 #  if !@HAVE_POPEN@
926 _GL_FUNCDECL_SYS (popen, FILE *, (const char *cmd, const char *mode)
927                                  _GL_ARG_NONNULL ((1, 2)));
928 #  endif
929 _GL_CXXALIAS_SYS (popen, FILE *, (const char *cmd, const char *mode));
930 # endif
931 _GL_CXXALIASWARN (popen);
932 #elif defined GNULIB_POSIXCHECK
933 # undef popen
934 # if HAVE_RAW_DECL_POPEN
935 _GL_WARN_ON_USE (popen, "popen is buggy on some platforms - "
936                  "use gnulib module popen or pipe for more portability");
937 # endif
938 #endif
939 
940 #if @GNULIB_PRINTF_POSIX@ || @GNULIB_PRINTF@
941 # if (@GNULIB_PRINTF_POSIX@ && @REPLACE_PRINTF@) \
942      || (@GNULIB_PRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
943 #  if defined __GNUC__
944 #   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
945 /* Don't break __attribute__((format(printf,M,N))).  */
946 #    define printf __printf__
947 #   endif
948 #   if @GNULIB_PRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
949 _GL_FUNCDECL_RPL_1 (__printf__, int,
950                     (const char *restrict format, ...)
951                     __asm__ (@ASM_SYMBOL_PREFIX@
952                              _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_printf))
953                     _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2)
954                     _GL_ARG_NONNULL ((1)));
955 #   else
956 _GL_FUNCDECL_RPL_1 (__printf__, int,
957                     (const char *restrict format, ...)
958                     __asm__ (@ASM_SYMBOL_PREFIX@
959                              _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_printf))
960                     _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (1, 2)
961                     _GL_ARG_NONNULL ((1)));
962 #   endif
963 _GL_CXXALIAS_RPL_1 (printf, __printf__, int, (const char *format, ...));
964 #  else
965 #   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
966 #    define printf rpl_printf
967 #   endif
968 _GL_FUNCDECL_RPL (printf, int,
969                   (const char *restrict format, ...)
970                   _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2)
971                   _GL_ARG_NONNULL ((1)));
972 _GL_CXXALIAS_RPL (printf, int, (const char *restrict format, ...));
973 #  endif
974 #  define GNULIB_overrides_printf 1
975 # else
976 _GL_CXXALIAS_SYS (printf, int, (const char *restrict format, ...));
977 # endif
978 # if __GLIBC__ >= 2
979 _GL_CXXALIASWARN (printf);
980 # endif
981 #endif
982 #if !@GNULIB_PRINTF_POSIX@ && defined GNULIB_POSIXCHECK
983 # if !GNULIB_overrides_printf
984 #  undef printf
985 # endif
986 /* Assume printf is always declared.  */
987 _GL_WARN_ON_USE (printf, "printf is not always POSIX compliant - "
988                  "use gnulib module printf-posix for portable "
989                  "POSIX compliance");
990 #endif
991 
992 #if @GNULIB_PUTC@
993 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
994 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
995 #   undef putc
996 #   define putc rpl_fputc
997 #  endif
998 _GL_FUNCDECL_RPL (fputc, int, (int c, FILE *stream) _GL_ARG_NONNULL ((2)));
999 _GL_CXXALIAS_RPL_1 (putc, rpl_fputc, int, (int c, FILE *stream));
1000 # else
1001 _GL_CXXALIAS_SYS (putc, int, (int c, FILE *stream));
1002 # endif
1003 # if __GLIBC__ >= 2
1004 _GL_CXXALIASWARN (putc);
1005 # endif
1006 #endif
1007 
1008 #if @GNULIB_PUTCHAR@
1009 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
1010 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1011 #   undef putchar
1012 #   define putchar rpl_putchar
1013 #  endif
1014 _GL_FUNCDECL_RPL (putchar, int, (int c));
1015 _GL_CXXALIAS_RPL (putchar, int, (int c));
1016 # else
1017 _GL_CXXALIAS_SYS (putchar, int, (int c));
1018 # endif
1019 # if __GLIBC__ >= 2
1020 _GL_CXXALIASWARN (putchar);
1021 # endif
1022 #endif
1023 
1024 #if @GNULIB_PUTS@
1025 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
1026 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1027 #   undef puts
1028 #   define puts rpl_puts
1029 #  endif
1030 _GL_FUNCDECL_RPL (puts, int, (const char *string) _GL_ARG_NONNULL ((1)));
1031 _GL_CXXALIAS_RPL (puts, int, (const char *string));
1032 # else
1033 _GL_CXXALIAS_SYS (puts, int, (const char *string));
1034 # endif
1035 # if __GLIBC__ >= 2
1036 _GL_CXXALIASWARN (puts);
1037 # endif
1038 #endif
1039 
1040 #if @GNULIB_REMOVE@
1041 # if @REPLACE_REMOVE@
1042 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1043 #   undef remove
1044 #   define remove rpl_remove
1045 #  endif
1046 _GL_FUNCDECL_RPL (remove, int, (const char *name) _GL_ARG_NONNULL ((1)));
1047 _GL_CXXALIAS_RPL (remove, int, (const char *name));
1048 # else
1049 _GL_CXXALIAS_SYS (remove, int, (const char *name));
1050 # endif
1051 # if __GLIBC__ >= 2
1052 _GL_CXXALIASWARN (remove);
1053 # endif
1054 #elif defined GNULIB_POSIXCHECK
1055 # undef remove
1056 /* Assume remove is always declared.  */
1057 _GL_WARN_ON_USE (remove, "remove cannot handle directories on some platforms - "
1058                  "use gnulib module remove for more portability");
1059 #endif
1060 
1061 #if @GNULIB_RENAME@
1062 # if @REPLACE_RENAME@
1063 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1064 #   undef rename
1065 #   define rename rpl_rename
1066 #  endif
1067 _GL_FUNCDECL_RPL (rename, int,
1068                   (const char *old_filename, const char *new_filename)
1069                   _GL_ARG_NONNULL ((1, 2)));
1070 _GL_CXXALIAS_RPL (rename, int,
1071                   (const char *old_filename, const char *new_filename));
1072 # else
1073 _GL_CXXALIAS_SYS (rename, int,
1074                   (const char *old_filename, const char *new_filename));
1075 # endif
1076 # if __GLIBC__ >= 2
1077 _GL_CXXALIASWARN (rename);
1078 # endif
1079 #elif defined GNULIB_POSIXCHECK
1080 # undef rename
1081 /* Assume rename is always declared.  */
1082 _GL_WARN_ON_USE (rename, "rename is buggy on some platforms - "
1083                  "use gnulib module rename for more portability");
1084 #endif
1085 
1086 #if @GNULIB_RENAMEAT@
1087 # if @REPLACE_RENAMEAT@
1088 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1089 #   undef renameat
1090 #   define renameat rpl_renameat
1091 #  endif
1092 _GL_FUNCDECL_RPL (renameat, int,
1093                   (int fd1, char const *file1, int fd2, char const *file2)
1094                   _GL_ARG_NONNULL ((2, 4)));
1095 _GL_CXXALIAS_RPL (renameat, int,
1096                   (int fd1, char const *file1, int fd2, char const *file2));
1097 # else
1098 #  if !@HAVE_RENAMEAT@
1099 _GL_FUNCDECL_SYS (renameat, int,
1100                   (int fd1, char const *file1, int fd2, char const *file2)
1101                   _GL_ARG_NONNULL ((2, 4)));
1102 #  endif
1103 _GL_CXXALIAS_SYS (renameat, int,
1104                   (int fd1, char const *file1, int fd2, char const *file2));
1105 # endif
1106 _GL_CXXALIASWARN (renameat);
1107 #elif defined GNULIB_POSIXCHECK
1108 # undef renameat
1109 # if HAVE_RAW_DECL_RENAMEAT
1110 _GL_WARN_ON_USE (renameat, "renameat is not portable - "
1111                  "use gnulib module renameat for portability");
1112 # endif
1113 #endif
1114 
1115 #if @GNULIB_SCANF@
1116 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
1117 #  if defined __GNUC__
1118 #   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1119 #    undef scanf
1120 /* Don't break __attribute__((format(scanf,M,N))).  */
1121 #    define scanf __scanf__
1122 #   endif
1123 _GL_FUNCDECL_RPL_1 (__scanf__, int,
1124                     (const char *restrict format, ...)
1125                     __asm__ (@ASM_SYMBOL_PREFIX@
1126                              _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_scanf))
1127                     _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 2)
1128                     _GL_ARG_NONNULL ((1)));
1129 _GL_CXXALIAS_RPL_1 (scanf, __scanf__, int, (const char *restrict format, ...));
1130 #  else
1131 #   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1132 #    undef scanf
1133 #    define scanf rpl_scanf
1134 #   endif
1135 _GL_FUNCDECL_RPL (scanf, int, (const char *restrict format, ...)
1136                               _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 2)
1137                               _GL_ARG_NONNULL ((1)));
1138 _GL_CXXALIAS_RPL (scanf, int, (const char *restrict format, ...));
1139 #  endif
1140 # else
1141 _GL_CXXALIAS_SYS (scanf, int, (const char *restrict format, ...));
1142 # endif
1143 # if __GLIBC__ >= 2
1144 _GL_CXXALIASWARN (scanf);
1145 # endif
1146 #endif
1147 
1148 #if @GNULIB_SNPRINTF@
1149 # if @REPLACE_SNPRINTF@
1150 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1151 #   define snprintf rpl_snprintf
1152 #  endif
1153 _GL_FUNCDECL_RPL (snprintf, int,
1154                   (char *restrict str, size_t size,
1155                    const char *restrict format, ...)
1156                   _GL_ATTRIBUTE_FORMAT_PRINTF (3, 4)
1157                   _GL_ARG_NONNULL ((3)));
1158 _GL_CXXALIAS_RPL (snprintf, int,
1159                   (char *restrict str, size_t size,
1160                    const char *restrict format, ...));
1161 # else
1162 #  if !@HAVE_DECL_SNPRINTF@
1163 _GL_FUNCDECL_SYS (snprintf, int,
1164                   (char *restrict str, size_t size,
1165                    const char *restrict format, ...)
1166                   _GL_ATTRIBUTE_FORMAT_PRINTF (3, 4)
1167                   _GL_ARG_NONNULL ((3)));
1168 #  endif
1169 _GL_CXXALIAS_SYS (snprintf, int,
1170                   (char *restrict str, size_t size,
1171                    const char *restrict format, ...));
1172 # endif
1173 _GL_CXXALIASWARN (snprintf);
1174 #elif defined GNULIB_POSIXCHECK
1175 # undef snprintf
1176 # if HAVE_RAW_DECL_SNPRINTF
1177 _GL_WARN_ON_USE (snprintf, "snprintf is unportable - "
1178                  "use gnulib module snprintf for portability");
1179 # endif
1180 #endif
1181 
1182 /* Some people would argue that all sprintf uses should be warned about
1183    (for example, OpenBSD issues a link warning for it),
1184    since it can cause security holes due to buffer overruns.
1185    However, we believe that sprintf can be used safely, and is more
1186    efficient than snprintf in those safe cases; and as proof of our
1187    belief, we use sprintf in several gnulib modules.  So this header
1188    intentionally avoids adding a warning to sprintf except when
1189    GNULIB_POSIXCHECK is defined.  */
1190 
1191 #if @GNULIB_SPRINTF_POSIX@
1192 # if @REPLACE_SPRINTF@
1193 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1194 #   define sprintf rpl_sprintf
1195 #  endif
1196 _GL_FUNCDECL_RPL (sprintf, int,
1197                   (char *restrict str, const char *restrict format, ...)
1198                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
1199                   _GL_ARG_NONNULL ((1, 2)));
1200 _GL_CXXALIAS_RPL (sprintf, int,
1201                   (char *restrict str, const char *restrict format, ...));
1202 # else
1203 _GL_CXXALIAS_SYS (sprintf, int,
1204                   (char *restrict str, const char *restrict format, ...));
1205 # endif
1206 # if __GLIBC__ >= 2
1207 _GL_CXXALIASWARN (sprintf);
1208 # endif
1209 #elif defined GNULIB_POSIXCHECK
1210 # undef sprintf
1211 /* Assume sprintf is always declared.  */
1212 _GL_WARN_ON_USE (sprintf, "sprintf is not always POSIX compliant - "
1213                  "use gnulib module sprintf-posix for portable "
1214                  "POSIX compliance");
1215 #endif
1216 
1217 #if @GNULIB_TMPFILE@
1218 # if @REPLACE_TMPFILE@
1219 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1220 #   define tmpfile rpl_tmpfile
1221 #  endif
1222 _GL_FUNCDECL_RPL (tmpfile, FILE *, (void));
1223 _GL_CXXALIAS_RPL (tmpfile, FILE *, (void));
1224 # else
1225 _GL_CXXALIAS_SYS (tmpfile, FILE *, (void));
1226 # endif
1227 # if __GLIBC__ >= 2
1228 _GL_CXXALIASWARN (tmpfile);
1229 # endif
1230 #elif defined GNULIB_POSIXCHECK
1231 # undef tmpfile
1232 # if HAVE_RAW_DECL_TMPFILE
1233 _GL_WARN_ON_USE (tmpfile, "tmpfile is not usable on mingw - "
1234                  "use gnulib module tmpfile for portability");
1235 # endif
1236 #endif
1237 
1238 #if @GNULIB_VASPRINTF@
1239 /* Write formatted output to a string dynamically allocated with malloc().
1240    If the memory allocation succeeds, store the address of the string in
1241    *RESULT and return the number of resulting bytes, excluding the trailing
1242    NUL.  Upon memory allocation error, or some other error, return -1.  */
1243 # if @REPLACE_VASPRINTF@
1244 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1245 #   define asprintf rpl_asprintf
1246 #  endif
1247 _GL_FUNCDECL_RPL (asprintf, int,
1248                   (char **result, const char *format, ...)
1249                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
1250                   _GL_ARG_NONNULL ((1, 2)));
1251 _GL_CXXALIAS_RPL (asprintf, int,
1252                   (char **result, const char *format, ...));
1253 # else
1254 #  if !@HAVE_VASPRINTF@
1255 _GL_FUNCDECL_SYS (asprintf, int,
1256                   (char **result, const char *format, ...)
1257                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
1258                   _GL_ARG_NONNULL ((1, 2)));
1259 #  endif
1260 _GL_CXXALIAS_SYS (asprintf, int,
1261                   (char **result, const char *format, ...));
1262 # endif
1263 _GL_CXXALIASWARN (asprintf);
1264 # if @REPLACE_VASPRINTF@
1265 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1266 #   define vasprintf rpl_vasprintf
1267 #  endif
1268 _GL_FUNCDECL_RPL (vasprintf, int,
1269                   (char **result, const char *format, va_list args)
1270                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1271                   _GL_ARG_NONNULL ((1, 2)));
1272 _GL_CXXALIAS_RPL (vasprintf, int,
1273                   (char **result, const char *format, va_list args));
1274 # else
1275 #  if !@HAVE_VASPRINTF@
1276 _GL_FUNCDECL_SYS (vasprintf, int,
1277                   (char **result, const char *format, va_list args)
1278                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1279                   _GL_ARG_NONNULL ((1, 2)));
1280 #  endif
1281 _GL_CXXALIAS_SYS (vasprintf, int,
1282                   (char **result, const char *format, va_list args));
1283 # endif
1284 _GL_CXXALIASWARN (vasprintf);
1285 #endif
1286 
1287 #if @GNULIB_VDPRINTF@
1288 # if @REPLACE_VDPRINTF@
1289 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1290 #   define vdprintf rpl_vdprintf
1291 #  endif
1292 _GL_FUNCDECL_RPL (vdprintf, int,
1293                   (int fd, const char *restrict format, va_list args)
1294                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1295                   _GL_ARG_NONNULL ((2)));
1296 _GL_CXXALIAS_RPL (vdprintf, int,
1297                   (int fd, const char *restrict format, va_list args));
1298 # else
1299 #  if !@HAVE_VDPRINTF@
1300 _GL_FUNCDECL_SYS (vdprintf, int,
1301                   (int fd, const char *restrict format, va_list args)
1302                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1303                   _GL_ARG_NONNULL ((2)));
1304 #  endif
1305 /* Need to cast, because on Solaris, the third parameter will likely be
1306                                                     __va_list args.  */
1307 _GL_CXXALIAS_SYS_CAST (vdprintf, int,
1308                        (int fd, const char *restrict format, va_list args));
1309 # endif
1310 # if __GLIBC__ >= 2
1311 _GL_CXXALIASWARN (vdprintf);
1312 # endif
1313 #elif defined GNULIB_POSIXCHECK
1314 # undef vdprintf
1315 # if HAVE_RAW_DECL_VDPRINTF
1316 _GL_WARN_ON_USE (vdprintf, "vdprintf is unportable - "
1317                  "use gnulib module vdprintf for portability");
1318 # endif
1319 #endif
1320 
1321 #if @GNULIB_VFPRINTF_POSIX@ || @GNULIB_VFPRINTF@
1322 # if (@GNULIB_VFPRINTF_POSIX@ && @REPLACE_VFPRINTF@) \
1323      || (@GNULIB_VFPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
1324 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1325 #   define vfprintf rpl_vfprintf
1326 #  endif
1327 #  define GNULIB_overrides_vfprintf 1
1328 #  if @GNULIB_VFPRINTF_POSIX@
1329 _GL_FUNCDECL_RPL (vfprintf, int,
1330                   (FILE *restrict fp,
1331                    const char *restrict format, va_list args)
1332                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1333                   _GL_ARG_NONNULL ((1, 2)));
1334 #  else
1335 _GL_FUNCDECL_RPL (vfprintf, int,
1336                   (FILE *restrict fp,
1337                    const char *restrict format, va_list args)
1338                   _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (2, 0)
1339                   _GL_ARG_NONNULL ((1, 2)));
1340 #  endif
1341 _GL_CXXALIAS_RPL (vfprintf, int,
1342                   (FILE *restrict fp,
1343                    const char *restrict format, va_list args));
1344 # else
1345 /* Need to cast, because on Solaris, the third parameter is
1346                                                       __va_list args
1347    and GCC's fixincludes did not change this to __gnuc_va_list.  */
1348 _GL_CXXALIAS_SYS_CAST (vfprintf, int,
1349                        (FILE *restrict fp,
1350                         const char *restrict format, va_list args));
1351 # endif
1352 # if __GLIBC__ >= 2
1353 _GL_CXXALIASWARN (vfprintf);
1354 # endif
1355 #endif
1356 #if !@GNULIB_VFPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
1357 # if !GNULIB_overrides_vfprintf
1358 #  undef vfprintf
1359 # endif
1360 /* Assume vfprintf is always declared.  */
1361 _GL_WARN_ON_USE (vfprintf, "vfprintf is not always POSIX compliant - "
1362                  "use gnulib module vfprintf-posix for portable "
1363                       "POSIX compliance");
1364 #endif
1365 
1366 #if @GNULIB_VFSCANF@
1367 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
1368 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1369 #   undef vfscanf
1370 #   define vfscanf rpl_vfscanf
1371 #  endif
1372 _GL_FUNCDECL_RPL (vfscanf, int,
1373                   (FILE *restrict stream,
1374                    const char *restrict format, va_list args)
1375                   _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (2, 0)
1376                   _GL_ARG_NONNULL ((1, 2)));
1377 _GL_CXXALIAS_RPL (vfscanf, int,
1378                   (FILE *restrict stream,
1379                    const char *restrict format, va_list args));
1380 # else
1381 _GL_CXXALIAS_SYS (vfscanf, int,
1382                   (FILE *restrict stream,
1383                    const char *restrict format, va_list args));
1384 # endif
1385 _GL_CXXALIASWARN (vfscanf);
1386 #endif
1387 
1388 #if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VPRINTF@
1389 # if (@GNULIB_VPRINTF_POSIX@ && @REPLACE_VPRINTF@) \
1390      || (@GNULIB_VPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
1391 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1392 #   define vprintf rpl_vprintf
1393 #  endif
1394 #  define GNULIB_overrides_vprintf 1
1395 #  if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
1396 _GL_FUNCDECL_RPL (vprintf, int, (const char *restrict format, va_list args)
1397                                 _GL_ATTRIBUTE_FORMAT_PRINTF (1, 0)
1398                                 _GL_ARG_NONNULL ((1)));
1399 #  else
1400 _GL_FUNCDECL_RPL (vprintf, int, (const char *restrict format, va_list args)
1401                                 _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (1, 0)
1402                                 _GL_ARG_NONNULL ((1)));
1403 #  endif
1404 _GL_CXXALIAS_RPL (vprintf, int, (const char *restrict format, va_list args));
1405 # else
1406 /* Need to cast, because on Solaris, the second parameter is
1407                                                           __va_list args
1408    and GCC's fixincludes did not change this to __gnuc_va_list.  */
1409 _GL_CXXALIAS_SYS_CAST (vprintf, int,
1410                        (const char *restrict format, va_list args));
1411 # endif
1412 # if __GLIBC__ >= 2
1413 _GL_CXXALIASWARN (vprintf);
1414 # endif
1415 #endif
1416 #if !@GNULIB_VPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
1417 # if !GNULIB_overrides_vprintf
1418 #  undef vprintf
1419 # endif
1420 /* Assume vprintf is always declared.  */
1421 _GL_WARN_ON_USE (vprintf, "vprintf is not always POSIX compliant - "
1422                  "use gnulib module vprintf-posix for portable "
1423                  "POSIX compliance");
1424 #endif
1425 
1426 #if @GNULIB_VSCANF@
1427 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
1428 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1429 #   undef vscanf
1430 #   define vscanf rpl_vscanf
1431 #  endif
1432 _GL_FUNCDECL_RPL (vscanf, int, (const char *restrict format, va_list args)
1433                                _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 0)
1434                                _GL_ARG_NONNULL ((1)));
1435 _GL_CXXALIAS_RPL (vscanf, int, (const char *restrict format, va_list args));
1436 # else
1437 _GL_CXXALIAS_SYS (vscanf, int, (const char *restrict format, va_list args));
1438 # endif
1439 _GL_CXXALIASWARN (vscanf);
1440 #endif
1441 
1442 #if @GNULIB_VSNPRINTF@
1443 # if @REPLACE_VSNPRINTF@
1444 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1445 #   define vsnprintf rpl_vsnprintf
1446 #  endif
1447 _GL_FUNCDECL_RPL (vsnprintf, int,
1448                   (char *restrict str, size_t size,
1449                    const char *restrict format, va_list args)
1450                   _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0)
1451                   _GL_ARG_NONNULL ((3)));
1452 _GL_CXXALIAS_RPL (vsnprintf, int,
1453                   (char *restrict str, size_t size,
1454                    const char *restrict format, va_list args));
1455 # else
1456 #  if !@HAVE_DECL_VSNPRINTF@
1457 _GL_FUNCDECL_SYS (vsnprintf, int,
1458                   (char *restrict str, size_t size,
1459                    const char *restrict format, va_list args)
1460                   _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0)
1461                   _GL_ARG_NONNULL ((3)));
1462 #  endif
1463 _GL_CXXALIAS_SYS (vsnprintf, int,
1464                   (char *restrict str, size_t size,
1465                    const char *restrict format, va_list args));
1466 # endif
1467 _GL_CXXALIASWARN (vsnprintf);
1468 #elif defined GNULIB_POSIXCHECK
1469 # undef vsnprintf
1470 # if HAVE_RAW_DECL_VSNPRINTF
1471 _GL_WARN_ON_USE (vsnprintf, "vsnprintf is unportable - "
1472                  "use gnulib module vsnprintf for portability");
1473 # endif
1474 #endif
1475 
1476 #if @GNULIB_VSPRINTF_POSIX@
1477 # if @REPLACE_VSPRINTF@
1478 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1479 #   define vsprintf rpl_vsprintf
1480 #  endif
1481 _GL_FUNCDECL_RPL (vsprintf, int,
1482                   (char *restrict str,
1483                    const char *restrict format, va_list args)
1484                   _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1485                   _GL_ARG_NONNULL ((1, 2)));
1486 _GL_CXXALIAS_RPL (vsprintf, int,
1487                   (char *restrict str,
1488                    const char *restrict format, va_list args));
1489 # else
1490 /* Need to cast, because on Solaris, the third parameter is
1491                                                        __va_list args
1492    and GCC's fixincludes did not change this to __gnuc_va_list.  */
1493 _GL_CXXALIAS_SYS_CAST (vsprintf, int,
1494                        (char *restrict str,
1495                         const char *restrict format, va_list args));
1496 # endif
1497 # if __GLIBC__ >= 2
1498 _GL_CXXALIASWARN (vsprintf);
1499 # endif
1500 #elif defined GNULIB_POSIXCHECK
1501 # undef vsprintf
1502 /* Assume vsprintf is always declared.  */
1503 _GL_WARN_ON_USE (vsprintf, "vsprintf is not always POSIX compliant - "
1504                  "use gnulib module vsprintf-posix for portable "
1505                       "POSIX compliance");
1506 #endif
1507 
1508 #endif /* _@GUARD_PREFIX@_STDIO_H */
1509 #endif /* _@GUARD_PREFIX@_STDIO_H */
1510 #endif
1511