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