1 /* A GNU-like <stdio.h>.
3 Copyright (C) 2004, 2007-2020 Free Software Foundation, Inc.
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 2, or (at your option)
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.
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/>. */
19 @PRAGMA_SYSTEM_HEADER@
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. */
32 #@INCLUDE_NEXT@ @NEXT_STDIO_H@
35 /* Normal invocation convention. */
37 #ifndef _@GUARD_PREFIX@_STDIO_H
39 #define _GL_ALREADY_INCLUDING_STDIO_H
41 /* The include_next requires a split double-inclusion guard. */
42 #@INCLUDE_NEXT@ @NEXT_STDIO_H@
44 #undef _GL_ALREADY_INCLUDING_STDIO_H
46 #ifndef _@GUARD_PREFIX@_STDIO_H
47 #define _@GUARD_PREFIX@_STDIO_H
49 /* Get va_list. Needed on many systems, including glibc 2.8. */
54 /* Get off_t and ssize_t. Needed on many systems, including glibc 2.8
56 May also define off_t to a 64-bit type on native Windows. */
57 #include <sys/types.h>
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) || defined __clang__
67 # define _GL_ATTRIBUTE_FORMAT(spec) __attribute__ ((__format__ spec))
69 # define _GL_ATTRIBUTE_FORMAT(spec) /* empty */
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
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))
81 # define _GL_ATTRIBUTE_FORMAT_PRINTF(formatstring_parameter, first_argument) \
82 _GL_ATTRIBUTE_FORMAT ((__printf__, formatstring_parameter, first_argument))
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
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)
93 # define _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM(formatstring_parameter, first_argument) \
94 _GL_ATTRIBUTE_FORMAT ((__printf__, formatstring_parameter, first_argument))
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
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))
105 # define _GL_ATTRIBUTE_FORMAT_SCANF(formatstring_parameter, first_argument) \
106 _GL_ATTRIBUTE_FORMAT ((__scanf__, formatstring_parameter, first_argument))
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))
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__
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>
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__
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__
151 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
153 /* The definition of _GL_ARG_NONNULL is copied here. */
155 /* The definition of _GL_WARN_ON_USE is copied here. */
157 /* Macros for stringification. */
158 #define _GL_STDIO_STRINGIZE(token) #token
159 #define _GL_STDIO_MACROEXPAND_AND_STRINGIZE(token) _GL_STDIO_STRINGIZE(token)
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
172 # if @REPLACE_DPRINTF@
173 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
174 # define dprintf rpl_dprintf
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
, ...));
182 _GL_FUNCDECL_SYS (dprintf
, int, (int fd
, const char *restrict format
, ...)
183 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
184 _GL_ARG_NONNULL ((2)));
186 _GL_CXXALIAS_SYS (dprintf
, int, (int fd
, const char *restrict format
, ...));
188 _GL_CXXALIASWARN (dprintf
);
189 #elif defined GNULIB_POSIXCHECK
191 # if HAVE_RAW_DECL_DPRINTF
192 _GL_WARN_ON_USE (dprintf
, "dprintf is unportable - "
193 "use gnulib module dprintf for portability");
198 /* Close STREAM and its underlying file descriptor. */
199 # if @REPLACE_FCLOSE@
200 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
201 # define fclose rpl_fclose
203 _GL_FUNCDECL_RPL (fclose
, int, (FILE *stream
) _GL_ARG_NONNULL ((1)));
204 _GL_CXXALIAS_RPL (fclose
, int, (FILE *stream
));
206 _GL_CXXALIAS_SYS (fclose
, int, (FILE *stream
));
209 _GL_CXXALIASWARN (fclose
);
211 #elif defined GNULIB_POSIXCHECK
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");
218 #if defined _WIN32 && !defined __CYGWIN__
220 # define fcloseall _fcloseall
224 # if @REPLACE_FDOPEN@
225 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
227 # define fdopen rpl_fdopen
229 _GL_FUNCDECL_RPL (fdopen
, FILE *, (int fd
, const char *mode
)
230 _GL_ARG_NONNULL ((2)));
231 _GL_CXXALIAS_RPL (fdopen
, FILE *, (int fd
, const char *mode
));
232 # elif defined _WIN32 && !defined __CYGWIN__
233 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
235 # define fdopen _fdopen
237 _GL_CXXALIAS_MDA (fdopen
, FILE *, (int fd
, const char *mode
));
239 _GL_CXXALIAS_SYS (fdopen
, FILE *, (int fd
, const char *mode
));
241 _GL_CXXALIASWARN (fdopen
);
242 #elif defined GNULIB_POSIXCHECK
244 /* Assume fdopen is always declared. */
245 _GL_WARN_ON_USE (fdopen
, "fdopen on native Windows platforms is not POSIX compliant - "
246 "use gnulib module fdopen for portability");
247 #elif defined _WIN32 && !defined __CYGWIN__
249 # define fdopen _fdopen
253 /* Flush all pending data on STREAM according to POSIX rules. Both
254 output and seekable input streams are supported.
255 Note! LOSS OF DATA can occur if fflush is applied on an input stream
256 that is _not_seekable_ or on an update stream that is _not_seekable_
257 and in which the most recent operation was input. Seekability can
258 be tested with lseek(fileno(fp),0,SEEK_CUR). */
259 # if @REPLACE_FFLUSH@
260 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
261 # define fflush rpl_fflush
263 _GL_FUNCDECL_RPL (fflush
, int, (FILE *gl_stream
));
264 _GL_CXXALIAS_RPL (fflush
, int, (FILE *gl_stream
));
266 _GL_CXXALIAS_SYS (fflush
, int, (FILE *gl_stream
));
269 _GL_CXXALIASWARN (fflush
);
271 #elif defined GNULIB_POSIXCHECK
273 /* Assume fflush is always declared. */
274 _GL_WARN_ON_USE (fflush
, "fflush is not always POSIX compliant - "
275 "use gnulib module fflush for portable POSIX compliance");
279 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
280 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
282 # define fgetc rpl_fgetc
284 _GL_FUNCDECL_RPL (fgetc
, int, (FILE *stream
) _GL_ARG_NONNULL ((1)));
285 _GL_CXXALIAS_RPL (fgetc
, int, (FILE *stream
));
287 _GL_CXXALIAS_SYS (fgetc
, int, (FILE *stream
));
290 _GL_CXXALIASWARN (fgetc
);
295 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
296 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
298 # define fgets rpl_fgets
300 _GL_FUNCDECL_RPL (fgets
, char *,
301 (char *restrict s
, int n
, FILE *restrict stream
)
302 _GL_ARG_NONNULL ((1, 3)));
303 _GL_CXXALIAS_RPL (fgets
, char *,
304 (char *restrict s
, int n
, FILE *restrict stream
));
306 _GL_CXXALIAS_SYS (fgets
, char *,
307 (char *restrict s
, int n
, FILE *restrict stream
));
310 _GL_CXXALIASWARN (fgets
);
314 #if defined _WIN32 && !defined __CYGWIN__
316 # define fileno _fileno
321 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
323 # define fopen rpl_fopen
325 _GL_FUNCDECL_RPL (fopen
, FILE *,
326 (const char *restrict filename
, const char *restrict mode
)
327 _GL_ARG_NONNULL ((1, 2)));
328 _GL_CXXALIAS_RPL (fopen
, FILE *,
329 (const char *restrict filename
, const char *restrict mode
));
331 _GL_CXXALIAS_SYS (fopen
, FILE *,
332 (const char *restrict filename
, const char *restrict mode
));
335 _GL_CXXALIASWARN (fopen
);
337 #elif defined GNULIB_POSIXCHECK
339 /* Assume fopen is always declared. */
340 _GL_WARN_ON_USE (fopen
, "fopen on native Windows platforms is not POSIX compliant - "
341 "use gnulib module fopen for portability");
344 #if @GNULIB_FPRINTF_POSIX@ || @GNULIB_FPRINTF@
345 # if (@GNULIB_FPRINTF_POSIX@ && @REPLACE_FPRINTF@) \
346 || (@GNULIB_FPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
347 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
348 # define fprintf rpl_fprintf
350 # define GNULIB_overrides_fprintf 1
351 # if @GNULIB_FPRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
352 _GL_FUNCDECL_RPL (fprintf
, int,
353 (FILE *restrict fp
, const char *restrict format
, ...)
354 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
355 _GL_ARG_NONNULL ((1, 2)));
357 _GL_FUNCDECL_RPL (fprintf
, int,
358 (FILE *restrict fp
, const char *restrict format
, ...)
359 _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (2, 3)
360 _GL_ARG_NONNULL ((1, 2)));
362 _GL_CXXALIAS_RPL (fprintf
, int,
363 (FILE *restrict fp
, const char *restrict format
, ...));
365 _GL_CXXALIAS_SYS (fprintf
, int,
366 (FILE *restrict fp
, const char *restrict format
, ...));
369 _GL_CXXALIASWARN (fprintf
);
372 #if !@GNULIB_FPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
373 # if !GNULIB_overrides_fprintf
376 /* Assume fprintf is always declared. */
377 _GL_WARN_ON_USE (fprintf
, "fprintf is not always POSIX compliant - "
378 "use gnulib module fprintf-posix for portable "
383 /* Discard all pending buffered I/O data on STREAM.
384 STREAM must not be wide-character oriented.
385 When discarding pending output, the file position is set back to where it
386 was before the write calls. When discarding pending input, the file
387 position is advanced to match the end of the previously read input.
388 Return 0 if successful. Upon error, return -1 and set errno. */
389 # if @REPLACE_FPURGE@
390 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
391 # define fpurge rpl_fpurge
393 _GL_FUNCDECL_RPL (fpurge
, int, (FILE *gl_stream
) _GL_ARG_NONNULL ((1)));
394 _GL_CXXALIAS_RPL (fpurge
, int, (FILE *gl_stream
));
396 # if !@HAVE_DECL_FPURGE@
397 _GL_FUNCDECL_SYS (fpurge
, int, (FILE *gl_stream
) _GL_ARG_NONNULL ((1)));
399 _GL_CXXALIAS_SYS (fpurge
, int, (FILE *gl_stream
));
401 _GL_CXXALIASWARN (fpurge
);
402 #elif defined GNULIB_POSIXCHECK
404 # if HAVE_RAW_DECL_FPURGE
405 _GL_WARN_ON_USE (fpurge
, "fpurge is not always present - "
406 "use gnulib module fpurge for portability");
411 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
412 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
414 # define fputc rpl_fputc
416 _GL_FUNCDECL_RPL (fputc
, int, (int c
, FILE *stream
) _GL_ARG_NONNULL ((2)));
417 _GL_CXXALIAS_RPL (fputc
, int, (int c
, FILE *stream
));
419 _GL_CXXALIAS_SYS (fputc
, int, (int c
, FILE *stream
));
422 _GL_CXXALIASWARN (fputc
);
427 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
428 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
430 # define fputs rpl_fputs
432 _GL_FUNCDECL_RPL (fputs
, int,
433 (const char *restrict string
, FILE *restrict stream
)
434 _GL_ARG_NONNULL ((1, 2)));
435 _GL_CXXALIAS_RPL (fputs
, int,
436 (const char *restrict string
, FILE *restrict stream
));
438 _GL_CXXALIAS_SYS (fputs
, int,
439 (const char *restrict string
, FILE *restrict stream
));
442 _GL_CXXALIASWARN (fputs
);
447 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
448 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
450 # define fread rpl_fread
452 _GL_FUNCDECL_RPL (fread
, size_t,
453 (void *restrict ptr
, size_t s
, size_t n
,
454 FILE *restrict stream
)
455 _GL_ARG_NONNULL ((4)));
456 _GL_CXXALIAS_RPL (fread
, size_t,
457 (void *restrict ptr
, size_t s
, size_t n
,
458 FILE *restrict stream
));
460 _GL_CXXALIAS_SYS (fread
, size_t,
461 (void *restrict ptr
, size_t s
, size_t n
,
462 FILE *restrict stream
));
465 _GL_CXXALIASWARN (fread
);
470 # if @REPLACE_FREOPEN@
471 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
473 # define freopen rpl_freopen
475 _GL_FUNCDECL_RPL (freopen
, FILE *,
476 (const char *restrict filename
, const char *restrict mode
,
477 FILE *restrict stream
)
478 _GL_ARG_NONNULL ((2, 3)));
479 _GL_CXXALIAS_RPL (freopen
, FILE *,
480 (const char *restrict filename
, const char *restrict mode
,
481 FILE *restrict stream
));
483 _GL_CXXALIAS_SYS (freopen
, FILE *,
484 (const char *restrict filename
, const char *restrict mode
,
485 FILE *restrict stream
));
488 _GL_CXXALIASWARN (freopen
);
490 #elif defined GNULIB_POSIXCHECK
492 /* Assume freopen is always declared. */
493 _GL_WARN_ON_USE (freopen
,
494 "freopen on native Windows platforms is not POSIX compliant - "
495 "use gnulib module freopen for portability");
499 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
500 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
502 # define fscanf rpl_fscanf
504 _GL_FUNCDECL_RPL (fscanf
, int,
505 (FILE *restrict stream
, const char *restrict format
, ...)
506 _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (2, 3)
507 _GL_ARG_NONNULL ((1, 2)));
508 _GL_CXXALIAS_RPL (fscanf
, int,
509 (FILE *restrict stream
, const char *restrict format
, ...));
511 _GL_CXXALIAS_SYS (fscanf
, int,
512 (FILE *restrict stream
, const char *restrict format
, ...));
515 _GL_CXXALIASWARN (fscanf
);
520 /* Set up the following warnings, based on which modules are in use.
521 GNU Coding Standards discourage the use of fseek, since it imposes
522 an arbitrary limitation on some 32-bit hosts. Remember that the
523 fseek module depends on the fseeko module, so we only have three
526 1. The developer is not using either module. Issue a warning under
527 GNULIB_POSIXCHECK for both functions, to remind them that both
528 functions have bugs on some systems. _GL_NO_LARGE_FILES has no
529 impact on this warning.
531 2. The developer is using both modules. They may be unaware of the
532 arbitrary limitations of fseek, so issue a warning under
533 GNULIB_POSIXCHECK. On the other hand, they may be using both
534 modules intentionally, so the developer can define
535 _GL_NO_LARGE_FILES in the compilation units where the use of fseek
536 is safe, to silence the warning.
538 3. The developer is using the fseeko module, but not fseek. Gnulib
539 guarantees that fseek will still work around platform bugs in that
540 case, but we presume that the developer is aware of the pitfalls of
541 fseek and was trying to avoid it, so issue a warning even when
542 GNULIB_POSIXCHECK is undefined. Again, _GL_NO_LARGE_FILES can be
543 defined to silence the warning in particular compilation units.
544 In C++ compilations with GNULIB_NAMESPACE, in order to avoid that
545 fseek gets defined as a macro, it is recommended that the developer
546 uses the fseek module, even if he is not calling the fseek function.
548 Most gnulib clients that perform stream operations should fall into
552 # if defined GNULIB_POSIXCHECK && !defined _GL_NO_LARGE_FILES
553 # define _GL_FSEEK_WARN /* Category 2, above. */
557 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
559 # define fseek rpl_fseek
561 _GL_FUNCDECL_RPL (fseek
, int, (FILE *fp
, long offset
, int whence
)
562 _GL_ARG_NONNULL ((1)));
563 _GL_CXXALIAS_RPL (fseek
, int, (FILE *fp
, long offset
, int whence
));
565 _GL_CXXALIAS_SYS (fseek
, int, (FILE *fp
, long offset
, int whence
));
568 _GL_CXXALIASWARN (fseek
);
573 # if !@GNULIB_FSEEK@ && !defined _GL_NO_LARGE_FILES
574 # define _GL_FSEEK_WARN /* Category 3, above. */
577 # if @REPLACE_FSEEKO@
578 /* Provide an fseeko function that is aware of a preceding fflush(), and which
580 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
582 # define fseeko rpl_fseeko
584 _GL_FUNCDECL_RPL (fseeko
, int, (FILE *fp
, off_t offset
, int whence
)
585 _GL_ARG_NONNULL ((1)));
586 _GL_CXXALIAS_RPL (fseeko
, int, (FILE *fp
, off_t offset
, int whence
));
588 # if ! @HAVE_DECL_FSEEKO@
589 _GL_FUNCDECL_SYS (fseeko
, int, (FILE *fp
, off_t offset
, int whence
)
590 _GL_ARG_NONNULL ((1)));
592 _GL_CXXALIAS_SYS (fseeko
, int, (FILE *fp
, off_t offset
, int whence
));
594 _GL_CXXALIASWARN (fseeko
);
595 #elif defined GNULIB_POSIXCHECK
596 # define _GL_FSEEK_WARN /* Category 1, above. */
599 # if HAVE_RAW_DECL_FSEEKO
600 _GL_WARN_ON_USE (fseeko
, "fseeko is unportable - "
601 "use gnulib module fseeko for portability");
605 #ifdef _GL_FSEEK_WARN
606 # undef _GL_FSEEK_WARN
607 /* Here, either fseek is undefined (but C89 guarantees that it is
608 declared), or it is defined as rpl_fseek (declared above). */
609 _GL_WARN_ON_USE (fseek
, "fseek cannot handle files larger than 4 GB "
610 "on 32-bit platforms - "
611 "use fseeko function for handling of large files");
615 /* ftell, ftello. See the comments on fseek/fseeko. */
618 # if defined GNULIB_POSIXCHECK && !defined _GL_NO_LARGE_FILES
619 # define _GL_FTELL_WARN /* Category 2, above. */
623 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
625 # define ftell rpl_ftell
627 _GL_FUNCDECL_RPL (ftell
, long, (FILE *fp
) _GL_ARG_NONNULL ((1)));
628 _GL_CXXALIAS_RPL (ftell
, long, (FILE *fp
));
630 _GL_CXXALIAS_SYS (ftell
, long, (FILE *fp
));
633 _GL_CXXALIASWARN (ftell
);
638 # if !@GNULIB_FTELL@ && !defined _GL_NO_LARGE_FILES
639 # define _GL_FTELL_WARN /* Category 3, above. */
642 # if @REPLACE_FTELLO@
643 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
645 # define ftello rpl_ftello
647 _GL_FUNCDECL_RPL (ftello
, off_t
, (FILE *fp
) _GL_ARG_NONNULL ((1)));
648 _GL_CXXALIAS_RPL (ftello
, off_t
, (FILE *fp
));
650 # if ! @HAVE_DECL_FTELLO@
651 _GL_FUNCDECL_SYS (ftello
, off_t
, (FILE *fp
) _GL_ARG_NONNULL ((1)));
653 _GL_CXXALIAS_SYS (ftello
, off_t
, (FILE *fp
));
655 _GL_CXXALIASWARN (ftello
);
656 #elif defined GNULIB_POSIXCHECK
657 # define _GL_FTELL_WARN /* Category 1, above. */
660 # if HAVE_RAW_DECL_FTELLO
661 _GL_WARN_ON_USE (ftello
, "ftello is unportable - "
662 "use gnulib module ftello for portability");
666 #ifdef _GL_FTELL_WARN
667 # undef _GL_FTELL_WARN
668 /* Here, either ftell is undefined (but C89 guarantees that it is
669 declared), or it is defined as rpl_ftell (declared above). */
670 _GL_WARN_ON_USE (ftell
, "ftell cannot handle files larger than 4 GB "
671 "on 32-bit platforms - "
672 "use ftello function for handling of large files");
677 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
678 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
680 # define fwrite rpl_fwrite
682 _GL_FUNCDECL_RPL (fwrite
, size_t,
683 (const void *restrict ptr
, size_t s
, size_t n
,
684 FILE *restrict stream
)
685 _GL_ARG_NONNULL ((1, 4)));
686 _GL_CXXALIAS_RPL (fwrite
, size_t,
687 (const void *restrict ptr
, size_t s
, size_t n
,
688 FILE *restrict stream
));
690 _GL_CXXALIAS_SYS (fwrite
, size_t,
691 (const void *restrict ptr
, size_t s
, size_t n
,
692 FILE *restrict stream
));
694 /* Work around bug 11959 when fortifying glibc 2.4 through 2.15
695 <https://sourceware.org/bugzilla/show_bug.cgi?id=11959>,
696 which sometimes causes an unwanted diagnostic for fwrite calls.
697 This affects only function declaration attributes under certain
698 versions of gcc and clang, and is not needed for C++. */
699 # if (0 < __USE_FORTIFY_LEVEL \
700 && __GLIBC__ == 2 && 4 <= __GLIBC_MINOR__ && __GLIBC_MINOR__ <= 15 \
701 && 3 < __GNUC__ + (4 <= __GNUC_MINOR__) \
702 && !defined __cplusplus)
704 # undef fwrite_unlocked
705 extern size_t __REDIRECT (rpl_fwrite
,
706 (const void *__restrict
, size_t, size_t,
709 extern size_t __REDIRECT (rpl_fwrite_unlocked
,
710 (const void *__restrict
, size_t, size_t,
713 # define fwrite rpl_fwrite
714 # define fwrite_unlocked rpl_fwrite_unlocked
718 _GL_CXXALIASWARN (fwrite
);
723 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
724 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
726 # define getc rpl_fgetc
728 _GL_FUNCDECL_RPL (fgetc
, int, (FILE *stream
) _GL_ARG_NONNULL ((1)));
729 _GL_CXXALIAS_RPL_1 (getc
, rpl_fgetc
, int, (FILE *stream
));
731 _GL_CXXALIAS_SYS (getc
, int, (FILE *stream
));
734 _GL_CXXALIASWARN (getc
);
739 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
740 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
742 # define getchar rpl_getchar
744 _GL_FUNCDECL_RPL (getchar
, int, (void));
745 _GL_CXXALIAS_RPL (getchar
, int, (void));
747 _GL_CXXALIAS_SYS (getchar
, int, (void));
750 _GL_CXXALIASWARN (getchar
);
754 #if @GNULIB_GETDELIM@
755 /* Read input, up to (and including) the next occurrence of DELIMITER, from
756 STREAM, store it in *LINEPTR (and NUL-terminate it).
757 *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
758 bytes of space. It is realloc'd as necessary.
759 Return the number of bytes read and stored at *LINEPTR (not including the
760 NUL terminator), or -1 on error or EOF. */
761 # if @REPLACE_GETDELIM@
762 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
764 # define getdelim rpl_getdelim
766 _GL_FUNCDECL_RPL (getdelim
, ssize_t
,
767 (char **restrict lineptr
, size_t *restrict linesize
,
769 FILE *restrict stream
)
770 _GL_ARG_NONNULL ((1, 2, 4)));
771 _GL_CXXALIAS_RPL (getdelim
, ssize_t
,
772 (char **restrict lineptr
, size_t *restrict linesize
,
774 FILE *restrict stream
));
776 # if !@HAVE_DECL_GETDELIM@
777 _GL_FUNCDECL_SYS (getdelim
, ssize_t
,
778 (char **restrict lineptr
, size_t *restrict linesize
,
780 FILE *restrict stream
)
781 _GL_ARG_NONNULL ((1, 2, 4)));
783 _GL_CXXALIAS_SYS (getdelim
, ssize_t
,
784 (char **restrict lineptr
, size_t *restrict linesize
,
786 FILE *restrict stream
));
788 _GL_CXXALIASWARN (getdelim
);
789 #elif defined GNULIB_POSIXCHECK
791 # if HAVE_RAW_DECL_GETDELIM
792 _GL_WARN_ON_USE (getdelim
, "getdelim is unportable - "
793 "use gnulib module getdelim for portability");
798 /* Read a line, up to (and including) the next newline, from STREAM, store it
799 in *LINEPTR (and NUL-terminate it).
800 *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
801 bytes of space. It is realloc'd as necessary.
802 Return the number of bytes read and stored at *LINEPTR (not including the
803 NUL terminator), or -1 on error or EOF. */
804 # if @REPLACE_GETLINE@
805 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
807 # define getline rpl_getline
809 _GL_FUNCDECL_RPL (getline
, ssize_t
,
810 (char **restrict lineptr
, size_t *restrict linesize
,
811 FILE *restrict stream
)
812 _GL_ARG_NONNULL ((1, 2, 3)));
813 _GL_CXXALIAS_RPL (getline
, ssize_t
,
814 (char **restrict lineptr
, size_t *restrict linesize
,
815 FILE *restrict stream
));
817 # if !@HAVE_DECL_GETLINE@
818 _GL_FUNCDECL_SYS (getline
, ssize_t
,
819 (char **restrict lineptr
, size_t *restrict linesize
,
820 FILE *restrict stream
)
821 _GL_ARG_NONNULL ((1, 2, 3)));
823 _GL_CXXALIAS_SYS (getline
, ssize_t
,
824 (char **restrict lineptr
, size_t *restrict linesize
,
825 FILE *restrict stream
));
827 # if @HAVE_DECL_GETLINE@
828 _GL_CXXALIASWARN (getline
);
830 #elif defined GNULIB_POSIXCHECK
832 # if HAVE_RAW_DECL_GETLINE
833 _GL_WARN_ON_USE (getline
, "getline is unportable - "
834 "use gnulib module getline for portability");
838 /* It is very rare that the developer ever has full control of stdin,
839 so any use of gets warrants an unconditional warning; besides, C11
842 #if HAVE_RAW_DECL_GETS && !defined __cplusplus
843 _GL_WARN_ON_USE (gets
, "gets is a security hole - use fgets instead");
846 #if defined _WIN32 && !defined __CYGWIN__
851 #if @GNULIB_OBSTACK_PRINTF@ || @GNULIB_OBSTACK_PRINTF_POSIX@
853 /* Grow an obstack with formatted output. Return the number of
854 bytes added to OBS. No trailing nul byte is added, and the
855 object should be closed with obstack_finish before use. Upon
856 memory allocation error, call obstack_alloc_failed_handler. Upon
857 other error, return -1. */
858 # if @REPLACE_OBSTACK_PRINTF@
859 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
860 # define obstack_printf rpl_obstack_printf
862 _GL_FUNCDECL_RPL (obstack_printf
, int,
863 (struct obstack
*obs
, const char *format
, ...)
864 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
865 _GL_ARG_NONNULL ((1, 2)));
866 _GL_CXXALIAS_RPL (obstack_printf
, int,
867 (struct obstack
*obs
, const char *format
, ...));
869 # if !@HAVE_DECL_OBSTACK_PRINTF@
870 _GL_FUNCDECL_SYS (obstack_printf
, int,
871 (struct obstack
*obs
, const char *format
, ...)
872 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
873 _GL_ARG_NONNULL ((1, 2)));
875 _GL_CXXALIAS_SYS (obstack_printf
, int,
876 (struct obstack
*obs
, const char *format
, ...));
878 _GL_CXXALIASWARN (obstack_printf
);
879 # if @REPLACE_OBSTACK_PRINTF@
880 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
881 # define obstack_vprintf rpl_obstack_vprintf
883 _GL_FUNCDECL_RPL (obstack_vprintf
, int,
884 (struct obstack
*obs
, const char *format
, va_list args
)
885 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
886 _GL_ARG_NONNULL ((1, 2)));
887 _GL_CXXALIAS_RPL (obstack_vprintf
, int,
888 (struct obstack
*obs
, const char *format
, va_list args
));
890 # if !@HAVE_DECL_OBSTACK_PRINTF@
891 _GL_FUNCDECL_SYS (obstack_vprintf
, int,
892 (struct obstack
*obs
, const char *format
, va_list args
)
893 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
894 _GL_ARG_NONNULL ((1, 2)));
896 _GL_CXXALIAS_SYS (obstack_vprintf
, int,
897 (struct obstack
*obs
, const char *format
, va_list args
));
899 _GL_CXXALIASWARN (obstack_vprintf
);
904 _GL_FUNCDECL_SYS (pclose
, int, (FILE *stream
) _GL_ARG_NONNULL ((1)));
906 _GL_CXXALIAS_SYS (pclose
, int, (FILE *stream
));
907 _GL_CXXALIASWARN (pclose
);
908 #elif defined GNULIB_POSIXCHECK
910 # if HAVE_RAW_DECL_PCLOSE
911 _GL_WARN_ON_USE (pclose
, "pclose is unportable - "
912 "use gnulib module pclose for more portability");
917 /* Print a message to standard error, describing the value of ERRNO,
918 (if STRING is not NULL and not empty) prefixed with STRING and ": ",
919 and terminated with a newline. */
920 # if @REPLACE_PERROR@
921 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
922 # define perror rpl_perror
924 _GL_FUNCDECL_RPL (perror
, void, (const char *string
));
925 _GL_CXXALIAS_RPL (perror
, void, (const char *string
));
927 _GL_CXXALIAS_SYS (perror
, void, (const char *string
));
930 _GL_CXXALIASWARN (perror
);
932 #elif defined GNULIB_POSIXCHECK
934 /* Assume perror is always declared. */
935 _GL_WARN_ON_USE (perror
, "perror is not always POSIX compliant - "
936 "use gnulib module perror for portability");
941 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
943 # define popen rpl_popen
945 _GL_FUNCDECL_RPL (popen
, FILE *, (const char *cmd
, const char *mode
)
946 _GL_ARG_NONNULL ((1, 2)));
947 _GL_CXXALIAS_RPL (popen
, FILE *, (const char *cmd
, const char *mode
));
950 _GL_FUNCDECL_SYS (popen
, FILE *, (const char *cmd
, const char *mode
)
951 _GL_ARG_NONNULL ((1, 2)));
953 _GL_CXXALIAS_SYS (popen
, FILE *, (const char *cmd
, const char *mode
));
955 _GL_CXXALIASWARN (popen
);
956 #elif defined GNULIB_POSIXCHECK
958 # if HAVE_RAW_DECL_POPEN
959 _GL_WARN_ON_USE (popen
, "popen is buggy on some platforms - "
960 "use gnulib module popen or pipe for more portability");
964 #if @GNULIB_PRINTF_POSIX@ || @GNULIB_PRINTF@
965 # if (@GNULIB_PRINTF_POSIX@ && @REPLACE_PRINTF@) \
966 || (@GNULIB_PRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
967 # if defined __GNUC__ || defined __clang__
968 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
969 /* Don't break __attribute__((format(printf,M,N))). */
970 # define printf __printf__
972 # if @GNULIB_PRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
973 _GL_FUNCDECL_RPL_1 (__printf__
, int,
974 (const char *restrict format
, ...)
975 __asm__ (@ASM_SYMBOL_PREFIX@
976 _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_printf
))
977 _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2)
978 _GL_ARG_NONNULL ((1)));
980 _GL_FUNCDECL_RPL_1 (__printf__
, int,
981 (const char *restrict format
, ...)
982 __asm__ (@ASM_SYMBOL_PREFIX@
983 _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_printf
))
984 _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (1, 2)
985 _GL_ARG_NONNULL ((1)));
987 _GL_CXXALIAS_RPL_1 (printf
, __printf__
, int, (const char *format
, ...));
989 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
990 # define printf rpl_printf
992 _GL_FUNCDECL_RPL (printf
, int,
993 (const char *restrict format
, ...)
994 _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2)
995 _GL_ARG_NONNULL ((1)));
996 _GL_CXXALIAS_RPL (printf
, int, (const char *restrict format
, ...));
998 # define GNULIB_overrides_printf 1
1000 _GL_CXXALIAS_SYS (printf
, int, (const char *restrict format
, ...));
1003 _GL_CXXALIASWARN (printf
);
1006 #if !@GNULIB_PRINTF_POSIX@ && defined GNULIB_POSIXCHECK
1007 # if !GNULIB_overrides_printf
1010 /* Assume printf is always declared. */
1011 _GL_WARN_ON_USE (printf
, "printf is not always POSIX compliant - "
1012 "use gnulib module printf-posix for portable "
1013 "POSIX compliance");
1017 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
1018 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1020 # define putc rpl_fputc
1022 _GL_FUNCDECL_RPL (fputc
, int, (int c
, FILE *stream
) _GL_ARG_NONNULL ((2)));
1023 _GL_CXXALIAS_RPL_1 (putc
, rpl_fputc
, int, (int c
, FILE *stream
));
1025 _GL_CXXALIAS_SYS (putc
, int, (int c
, FILE *stream
));
1028 _GL_CXXALIASWARN (putc
);
1032 #if @GNULIB_PUTCHAR@
1033 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
1034 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1036 # define putchar rpl_putchar
1038 _GL_FUNCDECL_RPL (putchar
, int, (int c
));
1039 _GL_CXXALIAS_RPL (putchar
, int, (int c
));
1041 _GL_CXXALIAS_SYS (putchar
, int, (int c
));
1044 _GL_CXXALIASWARN (putchar
);
1049 # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
1050 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1052 # define puts rpl_puts
1054 _GL_FUNCDECL_RPL (puts
, int, (const char *string
) _GL_ARG_NONNULL ((1)));
1055 _GL_CXXALIAS_RPL (puts
, int, (const char *string
));
1057 _GL_CXXALIAS_SYS (puts
, int, (const char *string
));
1060 _GL_CXXALIASWARN (puts
);
1064 #if defined _WIN32 && !defined __CYGWIN__
1070 # if @REPLACE_REMOVE@
1071 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1073 # define remove rpl_remove
1075 _GL_FUNCDECL_RPL (remove
, int, (const char *name
) _GL_ARG_NONNULL ((1)));
1076 _GL_CXXALIAS_RPL (remove
, int, (const char *name
));
1078 _GL_CXXALIAS_SYS (remove
, int, (const char *name
));
1081 _GL_CXXALIASWARN (remove
);
1083 #elif defined GNULIB_POSIXCHECK
1085 /* Assume remove is always declared. */
1086 _GL_WARN_ON_USE (remove
, "remove cannot handle directories on some platforms - "
1087 "use gnulib module remove for more portability");
1091 # if @REPLACE_RENAME@
1092 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1094 # define rename rpl_rename
1096 _GL_FUNCDECL_RPL (rename
, int,
1097 (const char *old_filename
, const char *new_filename
)
1098 _GL_ARG_NONNULL ((1, 2)));
1099 _GL_CXXALIAS_RPL (rename
, int,
1100 (const char *old_filename
, const char *new_filename
));
1102 _GL_CXXALIAS_SYS (rename
, int,
1103 (const char *old_filename
, const char *new_filename
));
1106 _GL_CXXALIASWARN (rename
);
1108 #elif defined GNULIB_POSIXCHECK
1110 /* Assume rename is always declared. */
1111 _GL_WARN_ON_USE (rename
, "rename is buggy on some platforms - "
1112 "use gnulib module rename for more portability");
1115 #if @GNULIB_RENAMEAT@
1116 # if @REPLACE_RENAMEAT@
1117 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1119 # define renameat rpl_renameat
1121 _GL_FUNCDECL_RPL (renameat
, int,
1122 (int fd1
, char const *file1
, int fd2
, char const *file2
)
1123 _GL_ARG_NONNULL ((2, 4)));
1124 _GL_CXXALIAS_RPL (renameat
, int,
1125 (int fd1
, char const *file1
, int fd2
, char const *file2
));
1127 # if !@HAVE_RENAMEAT@
1128 _GL_FUNCDECL_SYS (renameat
, int,
1129 (int fd1
, char const *file1
, int fd2
, char const *file2
)
1130 _GL_ARG_NONNULL ((2, 4)));
1132 _GL_CXXALIAS_SYS (renameat
, int,
1133 (int fd1
, char const *file1
, int fd2
, char const *file2
));
1135 _GL_CXXALIASWARN (renameat
);
1136 #elif defined GNULIB_POSIXCHECK
1138 # if HAVE_RAW_DECL_RENAMEAT
1139 _GL_WARN_ON_USE (renameat
, "renameat is not portable - "
1140 "use gnulib module renameat for portability");
1145 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
1146 # if defined __GNUC__ || defined __clang__
1147 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1149 /* Don't break __attribute__((format(scanf,M,N))). */
1150 # define scanf __scanf__
1152 _GL_FUNCDECL_RPL_1 (__scanf__
, int,
1153 (const char *restrict format
, ...)
1154 __asm__ (@ASM_SYMBOL_PREFIX@
1155 _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_scanf
))
1156 _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 2)
1157 _GL_ARG_NONNULL ((1)));
1158 _GL_CXXALIAS_RPL_1 (scanf
, __scanf__
, int, (const char *restrict format
, ...));
1160 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1162 # define scanf rpl_scanf
1164 _GL_FUNCDECL_RPL (scanf
, int, (const char *restrict format
, ...)
1165 _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 2)
1166 _GL_ARG_NONNULL ((1)));
1167 _GL_CXXALIAS_RPL (scanf
, int, (const char *restrict format
, ...));
1170 _GL_CXXALIAS_SYS (scanf
, int, (const char *restrict format
, ...));
1173 _GL_CXXALIASWARN (scanf
);
1177 #if @GNULIB_SNPRINTF@
1178 # if @REPLACE_SNPRINTF@
1179 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1180 # define snprintf rpl_snprintf
1182 _GL_FUNCDECL_RPL (snprintf
, int,
1183 (char *restrict str
, size_t size
,
1184 const char *restrict format
, ...)
1185 _GL_ATTRIBUTE_FORMAT_PRINTF (3, 4)
1186 _GL_ARG_NONNULL ((3)));
1187 _GL_CXXALIAS_RPL (snprintf
, int,
1188 (char *restrict str
, size_t size
,
1189 const char *restrict format
, ...));
1191 # if !@HAVE_DECL_SNPRINTF@
1192 _GL_FUNCDECL_SYS (snprintf
, int,
1193 (char *restrict str
, size_t size
,
1194 const char *restrict format
, ...)
1195 _GL_ATTRIBUTE_FORMAT_PRINTF (3, 4)
1196 _GL_ARG_NONNULL ((3)));
1198 _GL_CXXALIAS_SYS (snprintf
, int,
1199 (char *restrict str
, size_t size
,
1200 const char *restrict format
, ...));
1203 _GL_CXXALIASWARN (snprintf
);
1205 #elif defined GNULIB_POSIXCHECK
1207 # if HAVE_RAW_DECL_SNPRINTF
1208 _GL_WARN_ON_USE (snprintf
, "snprintf is unportable - "
1209 "use gnulib module snprintf for portability");
1213 /* Some people would argue that all sprintf uses should be warned about
1214 (for example, OpenBSD issues a link warning for it),
1215 since it can cause security holes due to buffer overruns.
1216 However, we believe that sprintf can be used safely, and is more
1217 efficient than snprintf in those safe cases; and as proof of our
1218 belief, we use sprintf in several gnulib modules. So this header
1219 intentionally avoids adding a warning to sprintf except when
1220 GNULIB_POSIXCHECK is defined. */
1222 #if @GNULIB_SPRINTF_POSIX@
1223 # if @REPLACE_SPRINTF@
1224 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1225 # define sprintf rpl_sprintf
1227 _GL_FUNCDECL_RPL (sprintf
, int,
1228 (char *restrict str
, const char *restrict format
, ...)
1229 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
1230 _GL_ARG_NONNULL ((1, 2)));
1231 _GL_CXXALIAS_RPL (sprintf
, int,
1232 (char *restrict str
, const char *restrict format
, ...));
1234 _GL_CXXALIAS_SYS (sprintf
, int,
1235 (char *restrict str
, const char *restrict format
, ...));
1238 _GL_CXXALIASWARN (sprintf
);
1240 #elif defined GNULIB_POSIXCHECK
1242 /* Assume sprintf is always declared. */
1243 _GL_WARN_ON_USE (sprintf
, "sprintf is not always POSIX compliant - "
1244 "use gnulib module sprintf-posix for portable "
1245 "POSIX compliance");
1248 #if defined _WIN32 && !defined __CYGWIN__
1250 # define tempnam _tempnam
1253 #if @GNULIB_TMPFILE@
1254 # if @REPLACE_TMPFILE@
1255 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1256 # define tmpfile rpl_tmpfile
1258 _GL_FUNCDECL_RPL (tmpfile
, FILE *, (void));
1259 _GL_CXXALIAS_RPL (tmpfile
, FILE *, (void));
1261 _GL_CXXALIAS_SYS (tmpfile
, FILE *, (void));
1264 _GL_CXXALIASWARN (tmpfile
);
1266 #elif defined GNULIB_POSIXCHECK
1268 # if HAVE_RAW_DECL_TMPFILE
1269 _GL_WARN_ON_USE (tmpfile
, "tmpfile is not usable on mingw - "
1270 "use gnulib module tmpfile for portability");
1274 #if @GNULIB_VASPRINTF@
1275 /* Write formatted output to a string dynamically allocated with malloc().
1276 If the memory allocation succeeds, store the address of the string in
1277 *RESULT and return the number of resulting bytes, excluding the trailing
1278 NUL. Upon memory allocation error, or some other error, return -1. */
1279 # if @REPLACE_VASPRINTF@
1280 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1281 # define asprintf rpl_asprintf
1283 _GL_FUNCDECL_RPL (asprintf
, int,
1284 (char **result
, const char *format
, ...)
1285 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
1286 _GL_ARG_NONNULL ((1, 2)));
1287 _GL_CXXALIAS_RPL (asprintf
, int,
1288 (char **result
, const char *format
, ...));
1290 # if !@HAVE_VASPRINTF@
1291 _GL_FUNCDECL_SYS (asprintf
, int,
1292 (char **result
, const char *format
, ...)
1293 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
1294 _GL_ARG_NONNULL ((1, 2)));
1296 _GL_CXXALIAS_SYS (asprintf
, int,
1297 (char **result
, const char *format
, ...));
1299 _GL_CXXALIASWARN (asprintf
);
1300 # if @REPLACE_VASPRINTF@
1301 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1302 # define vasprintf rpl_vasprintf
1304 _GL_FUNCDECL_RPL (vasprintf
, int,
1305 (char **result
, const char *format
, va_list args
)
1306 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1307 _GL_ARG_NONNULL ((1, 2)));
1308 _GL_CXXALIAS_RPL (vasprintf
, int,
1309 (char **result
, const char *format
, va_list args
));
1311 # if !@HAVE_VASPRINTF@
1312 _GL_FUNCDECL_SYS (vasprintf
, int,
1313 (char **result
, const char *format
, va_list args
)
1314 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1315 _GL_ARG_NONNULL ((1, 2)));
1317 _GL_CXXALIAS_SYS (vasprintf
, int,
1318 (char **result
, const char *format
, va_list args
));
1320 _GL_CXXALIASWARN (vasprintf
);
1323 #if @GNULIB_VDPRINTF@
1324 # if @REPLACE_VDPRINTF@
1325 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1326 # define vdprintf rpl_vdprintf
1328 _GL_FUNCDECL_RPL (vdprintf
, int,
1329 (int fd
, const char *restrict format
, va_list args
)
1330 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1331 _GL_ARG_NONNULL ((2)));
1332 _GL_CXXALIAS_RPL (vdprintf
, int,
1333 (int fd
, const char *restrict format
, va_list args
));
1335 # if !@HAVE_VDPRINTF@
1336 _GL_FUNCDECL_SYS (vdprintf
, int,
1337 (int fd
, const char *restrict format
, va_list args
)
1338 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1339 _GL_ARG_NONNULL ((2)));
1341 /* Need to cast, because on Solaris, the third parameter will likely be
1343 _GL_CXXALIAS_SYS_CAST (vdprintf
, int,
1344 (int fd
, const char *restrict format
, va_list args
));
1347 _GL_CXXALIASWARN (vdprintf
);
1349 #elif defined GNULIB_POSIXCHECK
1351 # if HAVE_RAW_DECL_VDPRINTF
1352 _GL_WARN_ON_USE (vdprintf
, "vdprintf is unportable - "
1353 "use gnulib module vdprintf for portability");
1357 #if @GNULIB_VFPRINTF_POSIX@ || @GNULIB_VFPRINTF@
1358 # if (@GNULIB_VFPRINTF_POSIX@ && @REPLACE_VFPRINTF@) \
1359 || (@GNULIB_VFPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
1360 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1361 # define vfprintf rpl_vfprintf
1363 # define GNULIB_overrides_vfprintf 1
1364 # if @GNULIB_VFPRINTF_POSIX@
1365 _GL_FUNCDECL_RPL (vfprintf
, int,
1367 const char *restrict format
, va_list args
)
1368 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1369 _GL_ARG_NONNULL ((1, 2)));
1371 _GL_FUNCDECL_RPL (vfprintf
, int,
1373 const char *restrict format
, va_list args
)
1374 _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (2, 0)
1375 _GL_ARG_NONNULL ((1, 2)));
1377 _GL_CXXALIAS_RPL (vfprintf
, int,
1379 const char *restrict format
, va_list args
));
1381 /* Need to cast, because on Solaris, the third parameter is
1383 and GCC's fixincludes did not change this to __gnuc_va_list. */
1384 _GL_CXXALIAS_SYS_CAST (vfprintf
, int,
1386 const char *restrict format
, va_list args
));
1389 _GL_CXXALIASWARN (vfprintf
);
1392 #if !@GNULIB_VFPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
1393 # if !GNULIB_overrides_vfprintf
1396 /* Assume vfprintf is always declared. */
1397 _GL_WARN_ON_USE (vfprintf
, "vfprintf is not always POSIX compliant - "
1398 "use gnulib module vfprintf-posix for portable "
1399 "POSIX compliance");
1402 #if @GNULIB_VFSCANF@
1403 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
1404 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1406 # define vfscanf rpl_vfscanf
1408 _GL_FUNCDECL_RPL (vfscanf
, int,
1409 (FILE *restrict stream
,
1410 const char *restrict format
, va_list args
)
1411 _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (2, 0)
1412 _GL_ARG_NONNULL ((1, 2)));
1413 _GL_CXXALIAS_RPL (vfscanf
, int,
1414 (FILE *restrict stream
,
1415 const char *restrict format
, va_list args
));
1417 _GL_CXXALIAS_SYS (vfscanf
, int,
1418 (FILE *restrict stream
,
1419 const char *restrict format
, va_list args
));
1422 _GL_CXXALIASWARN (vfscanf
);
1426 #if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VPRINTF@
1427 # if (@GNULIB_VPRINTF_POSIX@ && @REPLACE_VPRINTF@) \
1428 || (@GNULIB_VPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
1429 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1430 # define vprintf rpl_vprintf
1432 # define GNULIB_overrides_vprintf 1
1433 # if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
1434 _GL_FUNCDECL_RPL (vprintf
, int, (const char *restrict format
, va_list args
)
1435 _GL_ATTRIBUTE_FORMAT_PRINTF (1, 0)
1436 _GL_ARG_NONNULL ((1)));
1438 _GL_FUNCDECL_RPL (vprintf
, int, (const char *restrict format
, va_list args
)
1439 _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (1, 0)
1440 _GL_ARG_NONNULL ((1)));
1442 _GL_CXXALIAS_RPL (vprintf
, int, (const char *restrict format
, va_list args
));
1444 /* Need to cast, because on Solaris, the second parameter is
1446 and GCC's fixincludes did not change this to __gnuc_va_list. */
1447 _GL_CXXALIAS_SYS_CAST (vprintf
, int,
1448 (const char *restrict format
, va_list args
));
1451 _GL_CXXALIASWARN (vprintf
);
1454 #if !@GNULIB_VPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
1455 # if !GNULIB_overrides_vprintf
1458 /* Assume vprintf is always declared. */
1459 _GL_WARN_ON_USE (vprintf
, "vprintf is not always POSIX compliant - "
1460 "use gnulib module vprintf-posix for portable "
1461 "POSIX compliance");
1465 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
1466 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1468 # define vscanf rpl_vscanf
1470 _GL_FUNCDECL_RPL (vscanf
, int, (const char *restrict format
, va_list args
)
1471 _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 0)
1472 _GL_ARG_NONNULL ((1)));
1473 _GL_CXXALIAS_RPL (vscanf
, int, (const char *restrict format
, va_list args
));
1475 _GL_CXXALIAS_SYS (vscanf
, int, (const char *restrict format
, va_list args
));
1478 _GL_CXXALIASWARN (vscanf
);
1482 #if @GNULIB_VSNPRINTF@
1483 # if @REPLACE_VSNPRINTF@
1484 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1485 # define vsnprintf rpl_vsnprintf
1487 _GL_FUNCDECL_RPL (vsnprintf
, int,
1488 (char *restrict str
, size_t size
,
1489 const char *restrict format
, va_list args
)
1490 _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0)
1491 _GL_ARG_NONNULL ((3)));
1492 _GL_CXXALIAS_RPL (vsnprintf
, int,
1493 (char *restrict str
, size_t size
,
1494 const char *restrict format
, va_list args
));
1496 # if !@HAVE_DECL_VSNPRINTF@
1497 _GL_FUNCDECL_SYS (vsnprintf
, int,
1498 (char *restrict str
, size_t size
,
1499 const char *restrict format
, va_list args
)
1500 _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0)
1501 _GL_ARG_NONNULL ((3)));
1503 _GL_CXXALIAS_SYS (vsnprintf
, int,
1504 (char *restrict str
, size_t size
,
1505 const char *restrict format
, va_list args
));
1508 _GL_CXXALIASWARN (vsnprintf
);
1510 #elif defined GNULIB_POSIXCHECK
1512 # if HAVE_RAW_DECL_VSNPRINTF
1513 _GL_WARN_ON_USE (vsnprintf
, "vsnprintf is unportable - "
1514 "use gnulib module vsnprintf for portability");
1518 #if @GNULIB_VSPRINTF_POSIX@
1519 # if @REPLACE_VSPRINTF@
1520 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1521 # define vsprintf rpl_vsprintf
1523 _GL_FUNCDECL_RPL (vsprintf
, int,
1524 (char *restrict str
,
1525 const char *restrict format
, va_list args
)
1526 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
1527 _GL_ARG_NONNULL ((1, 2)));
1528 _GL_CXXALIAS_RPL (vsprintf
, int,
1529 (char *restrict str
,
1530 const char *restrict format
, va_list args
));
1532 /* Need to cast, because on Solaris, the third parameter is
1534 and GCC's fixincludes did not change this to __gnuc_va_list. */
1535 _GL_CXXALIAS_SYS_CAST (vsprintf
, int,
1536 (char *restrict str
,
1537 const char *restrict format
, va_list args
));
1540 _GL_CXXALIASWARN (vsprintf
);
1542 #elif defined GNULIB_POSIXCHECK
1544 /* Assume vsprintf is always declared. */
1545 _GL_WARN_ON_USE (vsprintf
, "vsprintf is not always POSIX compliant - "
1546 "use gnulib module vsprintf-posix for portable "
1547 "POSIX compliance");
1550 #endif /* _@GUARD_PREFIX@_STDIO_H */
1551 #endif /* _@GUARD_PREFIX@_STDIO_H */