HCoop / bpt / guile.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
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
af07e104 3 Copyright (C) 2004, 2007-2013 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
005de2e8 16 along with this program; if not, see <http://www.gnu.org/licenses/>. */
c4b681fd
LC		 17
18#if __GNUC__ >= 3
19@PRAGMA_SYSTEM_HEADER@
20#endif
0f00f2c3 21@PRAGMA_COLUMNS@
c4b681fd 22
ab4d62ad
LC		 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. */
c4b681fd
LC		 31
32#@INCLUDE_NEXT@ @NEXT_STDIO_H@
33
34#else
35/* Normal invocation convention. */
36
3d458a81 37#ifndef _@GUARD_PREFIX@_STDIO_H
c4b681fd 38
ab4d62ad
LC		 39#define _GL_ALREADY_INCLUDING_STDIO_H
40
c4b681fd
LC		 41/* The include_next requires a split double-inclusion guard. */
42#@INCLUDE_NEXT@ @NEXT_STDIO_H@
43
ab4d62ad
LC		 44#undef _GL_ALREADY_INCLUDING_STDIO_H
45
3d458a81
AW		 46#ifndef _@GUARD_PREFIX@_STDIO_H
47#define _@GUARD_PREFIX@_STDIO_H
c4b681fd 48
61cd9dc9 49/* Get va_list. Needed on many systems, including glibc 2.8. */
c4b681fd 50#include <stdarg.h>
61cd9dc9 51
c4b681fd
LC		 52#include <stddef.h>
53
49114fd4 54/* Get off_t and ssize_t. Needed on many systems, including glibc 2.8
005de2e8
LC		 55 and eglibc 2.11.2.
56 May also define off_t to a 64-bit type on native Windows. */
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 577
af07e104 578/* Work around bug 11959 when fortifying glibc 2.4 through 2.15
dd7d0148
LC		 579 <http://sources.redhat.com/bugzilla/show_bug.cgi?id=11959>,
580 which sometimes causes an unwanted diagnostic for fwrite calls.
af07e104
AW		 581 This affects only function declaration attributes under certain
582 versions of gcc, and is not needed for C++. */
583# if (0 < __USE_FORTIFY_LEVEL \
584 && __GLIBC__ == 2 && 4 <= __GLIBC_MINOR__ && __GLIBC_MINOR__ <= 15 \
585 && 3 < __GNUC__ + (4 <= __GNUC_MINOR__) \
586 && !defined __cplusplus)
dd7d0148 587# undef fwrite
af07e104 588# define fwrite(a, b, c, d) ({size_t __r = fwrite (a, b, c, d); __r; })
dd7d0148 589# endif
f4c79b3c
LC		 590# endif
591_GL_CXXALIASWARN (fwrite);
c4b681fd
LC		 592#endif
593
dd7d0148
LC		 594#if @GNULIB_GETC@
595# if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
596# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
597# undef getc
598# define getc rpl_fgetc
599# endif
600_GL_FUNCDECL_RPL (fgetc, int, (FILE *stream) _GL_ARG_NONNULL ((1)));
601_GL_CXXALIAS_RPL_1 (getc, rpl_fgetc, int, (FILE *stream));
602# else
603_GL_CXXALIAS_SYS (getc, int, (FILE *stream));
604# endif
605_GL_CXXALIASWARN (getc);
606#endif
607
608#if @GNULIB_GETCHAR@
609# if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
610# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
611# undef getchar
612# define getchar rpl_getchar
613# endif
614_GL_FUNCDECL_RPL (getchar, int, (void));
615_GL_CXXALIAS_RPL (getchar, int, (void));
616# else
617_GL_CXXALIAS_SYS (getchar, int, (void));
618# endif
619_GL_CXXALIASWARN (getchar);
620#endif
621
c4b681fd 622#if @GNULIB_GETDELIM@
c4b681fd
LC		 623/* Read input, up to (and including) the next occurrence of DELIMITER, from
624 STREAM, store it in *LINEPTR (and NUL-terminate it).
625 *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
626 bytes of space. It is realloc'd as necessary.
627 Return the number of bytes read and stored at *LINEPTR (not including the
628 NUL terminator), or -1 on error or EOF. */
f4c79b3c
LC		 629# if @REPLACE_GETDELIM@
630# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
631# undef getdelim
632# define getdelim rpl_getdelim
633# endif
634_GL_FUNCDECL_RPL (getdelim, ssize_t,
635 (char **lineptr, size_t *linesize, int delimiter,
636 FILE *stream)
637 _GL_ARG_NONNULL ((1, 2, 4)));
638_GL_CXXALIAS_RPL (getdelim, ssize_t,
639 (char **lineptr, size_t *linesize, int delimiter,
640 FILE *stream));
641# else
642# if !@HAVE_DECL_GETDELIM@
643_GL_FUNCDECL_SYS (getdelim, ssize_t,
644 (char **lineptr, size_t *linesize, int delimiter,
645 FILE *stream)
646 _GL_ARG_NONNULL ((1, 2, 4)));
647# endif
648_GL_CXXALIAS_SYS (getdelim, ssize_t,
649 (char **lineptr, size_t *linesize, int delimiter,
650 FILE *stream));
c4b681fd 651# endif
f4c79b3c 652_GL_CXXALIASWARN (getdelim);
c4b681fd
LC		 653#elif defined GNULIB_POSIXCHECK
654# undef getdelim
61cd9dc9
LC		 655# if HAVE_RAW_DECL_GETDELIM
656_GL_WARN_ON_USE (getdelim, "getdelim is unportable - "
657 "use gnulib module getdelim for portability");
658# endif
c4b681fd
LC		 659#endif
660
661#if @GNULIB_GETLINE@
c4b681fd
LC		 662/* Read a line, up to (and including) the next newline, from STREAM, store it
663 in *LINEPTR (and NUL-terminate it).
664 *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
665 bytes of space. It is realloc'd as necessary.
666 Return the number of bytes read and stored at *LINEPTR (not including the
667 NUL terminator), or -1 on error or EOF. */
f4c79b3c
LC		 668# if @REPLACE_GETLINE@
669# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
670# undef getline
671# define getline rpl_getline
672# endif
673_GL_FUNCDECL_RPL (getline, ssize_t,
674 (char **lineptr, size_t *linesize, FILE *stream)
675 _GL_ARG_NONNULL ((1, 2, 3)));
676_GL_CXXALIAS_RPL (getline, ssize_t,
677 (char **lineptr, size_t *linesize, FILE *stream));
678# else
679# if !@HAVE_DECL_GETLINE@
680_GL_FUNCDECL_SYS (getline, ssize_t,
681 (char **lineptr, size_t *linesize, FILE *stream)
682 _GL_ARG_NONNULL ((1, 2, 3)));
683# endif
684_GL_CXXALIAS_SYS (getline, ssize_t,
685 (char **lineptr, size_t *linesize, FILE *stream));
c4b681fd 686# endif
a927b6c1 687# if @HAVE_DECL_GETLINE@
f4c79b3c 688_GL_CXXALIASWARN (getline);
a927b6c1 689# endif
c4b681fd
LC		 690#elif defined GNULIB_POSIXCHECK
691# undef getline
61cd9dc9
LC		 692# if HAVE_RAW_DECL_GETLINE
693_GL_WARN_ON_USE (getline, "getline is unportable - "
694 "use gnulib module getline for portability");
695# endif
c4b681fd
LC		 696#endif
697
dd7d0148 698/* It is very rare that the developer ever has full control of stdin,
005de2e8
LC		 699 so any use of gets warrants an unconditional warning; besides, C11
700 removed it. */
701#undef gets
702#if HAVE_RAW_DECL_GETS
dd7d0148
LC		 703_GL_WARN_ON_USE (gets, "gets is a security hole - use fgets instead");
704#endif
705
706
61cd9dc9 707#if @GNULIB_OBSTACK_PRINTF@ || @GNULIB_OBSTACK_PRINTF_POSIX@
f4c79b3c
LC		 708struct obstack;
709/* Grow an obstack with formatted output. Return the number of
710 bytes added to OBS. No trailing nul byte is added, and the
711 object should be closed with obstack_finish before use. Upon
712 memory allocation error, call obstack_alloc_failed_handler. Upon
713 other error, return -1. */
8912421c 714# if @REPLACE_OBSTACK_PRINTF@
f4c79b3c
LC		 715# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
716# define obstack_printf rpl_obstack_printf
717# endif
718_GL_FUNCDECL_RPL (obstack_printf, int,
719 (struct obstack *obs, const char *format, ...)
49114fd4 720 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
f4c79b3c
LC		 721 _GL_ARG_NONNULL ((1, 2)));
722_GL_CXXALIAS_RPL (obstack_printf, int,
723 (struct obstack *obs, const char *format, ...));
724# else
725# if !@HAVE_DECL_OBSTACK_PRINTF@
726_GL_FUNCDECL_SYS (obstack_printf, int,
727 (struct obstack *obs, const char *format, ...)
49114fd4 728 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
f4c79b3c
LC		 729 _GL_ARG_NONNULL ((1, 2)));
730# endif
731_GL_CXXALIAS_SYS (obstack_printf, int,
732 (struct obstack *obs, const char *format, ...));
8912421c 733# endif
f4c79b3c
LC		 734_GL_CXXALIASWARN (obstack_printf);
735# if @REPLACE_OBSTACK_PRINTF@
736# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
737# define obstack_vprintf rpl_obstack_vprintf
738# endif
739_GL_FUNCDECL_RPL (obstack_vprintf, int,
740 (struct obstack *obs, const char *format, va_list args)
49114fd4 741 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
f4c79b3c
LC		 742 _GL_ARG_NONNULL ((1, 2)));
743_GL_CXXALIAS_RPL (obstack_vprintf, int,
744 (struct obstack *obs, const char *format, va_list args));
745# else
746# if !@HAVE_DECL_OBSTACK_PRINTF@
747_GL_FUNCDECL_SYS (obstack_vprintf, int,
748 (struct obstack *obs, const char *format, va_list args)
49114fd4 749 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
f4c79b3c
LC		 750 _GL_ARG_NONNULL ((1, 2)));
751# endif
752_GL_CXXALIAS_SYS (obstack_vprintf, int,
753 (struct obstack *obs, const char *format, va_list args));
8912421c 754# endif
f4c79b3c 755_GL_CXXALIASWARN (obstack_vprintf);
8912421c
LC		 756#endif
757
35428fb6
LC		 758#if @GNULIB_PCLOSE@
759# if !@HAVE_PCLOSE@
760_GL_FUNCDECL_SYS (pclose, int, (FILE *stream) _GL_ARG_NONNULL ((1)));
761# endif
762_GL_CXXALIAS_SYS (pclose, int, (FILE *stream));
763_GL_CXXALIASWARN (pclose);
764#elif defined GNULIB_POSIXCHECK
765# undef pclose
766# if HAVE_RAW_DECL_PCLOSE
005de2e8 767_GL_WARN_ON_USE (pclose, "pclose is unportable - "
35428fb6
LC		 768 "use gnulib module pclose for more portability");
769# endif
770#endif
771
c4b681fd 772#if @GNULIB_PERROR@
c4b681fd
LC		 773/* Print a message to standard error, describing the value of ERRNO,
774 (if STRING is not NULL and not empty) prefixed with STRING and ": ",
775 and terminated with a newline. */
f4c79b3c
LC		 776# if @REPLACE_PERROR@
777# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
778# define perror rpl_perror
779# endif
780_GL_FUNCDECL_RPL (perror, void, (const char *string));
781_GL_CXXALIAS_RPL (perror, void, (const char *string));
782# else
783_GL_CXXALIAS_SYS (perror, void, (const char *string));
c4b681fd 784# endif
f4c79b3c 785_GL_CXXALIASWARN (perror);
c4b681fd
LC		 786#elif defined GNULIB_POSIXCHECK
787# undef perror
61cd9dc9
LC		 788/* Assume perror is always declared. */
789_GL_WARN_ON_USE (perror, "perror is not always POSIX compliant - "
790 "use gnulib module perror for portability");
c4b681fd
LC		 791#endif
792
8912421c
LC		 793#if @GNULIB_POPEN@
794# if @REPLACE_POPEN@
f4c79b3c
LC		 795# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
796# undef popen
797# define popen rpl_popen
798# endif
799_GL_FUNCDECL_RPL (popen, FILE *, (const char *cmd, const char *mode)
800 _GL_ARG_NONNULL ((1, 2)));
801_GL_CXXALIAS_RPL (popen, FILE *, (const char *cmd, const char *mode));
802# else
35428fb6
LC		 803# if !@HAVE_POPEN@
804_GL_FUNCDECL_SYS (popen, FILE *, (const char *cmd, const char *mode)
805 _GL_ARG_NONNULL ((1, 2)));
806# endif
f4c79b3c 807_GL_CXXALIAS_SYS (popen, FILE *, (const char *cmd, const char *mode));
8912421c 808# endif
f4c79b3c 809_GL_CXXALIASWARN (popen);
8912421c
LC		 810#elif defined GNULIB_POSIXCHECK
811# undef popen
61cd9dc9
LC		 812# if HAVE_RAW_DECL_POPEN
813_GL_WARN_ON_USE (popen, "popen is buggy on some platforms - "
814 "use gnulib module popen or pipe for more portability");
815# endif
8912421c
LC		 816#endif
817
f4c79b3c
LC		 818#if @GNULIB_PRINTF_POSIX@ || @GNULIB_PRINTF@
819# if (@GNULIB_PRINTF_POSIX@ && @REPLACE_PRINTF@) \
dd7d0148 820 || (@GNULIB_PRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
a927b6c1
LC		 821# if defined __GNUC__
822# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
8912421c 823/* Don't break __attribute__((format(printf,M,N))). */
a927b6c1
LC		 824# define printf __printf__
825# endif
dd7d0148 826# if @GNULIB_PRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
f4c79b3c
LC		 827_GL_FUNCDECL_RPL_1 (__printf__, int,
828 (const char *format, ...)
a927b6c1
LC		 829 __asm__ (@ASM_SYMBOL_PREFIX@
830 _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_printf))
49114fd4 831 _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2)
f4c79b3c 832 _GL_ARG_NONNULL ((1)));
dd7d0148
LC		 833# else
834_GL_FUNCDECL_RPL_1 (__printf__, int,
835 (const char *format, ...)
836 __asm__ (@ASM_SYMBOL_PREFIX@
837 _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_printf))
838 _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (1, 2)
839 _GL_ARG_NONNULL ((1)));
840# endif
f4c79b3c 841_GL_CXXALIAS_RPL_1 (printf, __printf__, int, (const char *format, ...));
a927b6c1 842# else
49114fd4
LC		 843# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
844# define printf rpl_printf
845# endif
a927b6c1
LC		 846_GL_FUNCDECL_RPL (printf, int,
847 (const char *format, ...)
49114fd4 848 _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2)
a927b6c1 849 _GL_ARG_NONNULL ((1)));
9157d901 850_GL_CXXALIAS_RPL (printf, int, (const char *format, ...));
a927b6c1
LC		 851# endif
852# define GNULIB_overrides_printf 1
f4c79b3c
LC		 853# else
854_GL_CXXALIAS_SYS (printf, int, (const char *format, ...));
855# endif
856_GL_CXXALIASWARN (printf);
857#endif
858#if !@GNULIB_PRINTF_POSIX@ && defined GNULIB_POSIXCHECK
859# if !GNULIB_overrides_printf
860# undef printf
8912421c 861# endif
61cd9dc9
LC		 862/* Assume printf is always declared. */
863_GL_WARN_ON_USE (printf, "printf is not always POSIX compliant - "
864 "use gnulib module printf-posix for portable "
865 "POSIX compliance");
8912421c
LC		 866#endif
867
f4c79b3c 868#if @GNULIB_PUTC@
dd7d0148 869# if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
f4c79b3c
LC		 870# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
871# undef putc
872# define putc rpl_fputc
873# endif
874_GL_FUNCDECL_RPL (fputc, int, (int c, FILE *stream) _GL_ARG_NONNULL ((2)));
875_GL_CXXALIAS_RPL_1 (putc, rpl_fputc, int, (int c, FILE *stream));
876# else
877_GL_CXXALIAS_SYS (putc, int, (int c, FILE *stream));
878# endif
879_GL_CXXALIASWARN (putc);
8912421c
LC		 880#endif
881
f4c79b3c 882#if @GNULIB_PUTCHAR@
dd7d0148 883# if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
f4c79b3c
LC		 884# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
885# undef putchar
886# define putchar rpl_putchar
887# endif
888_GL_FUNCDECL_RPL (putchar, int, (int c));
889_GL_CXXALIAS_RPL (putchar, int, (int c));
890# else
891_GL_CXXALIAS_SYS (putchar, int, (int c));
892# endif
893_GL_CXXALIASWARN (putchar);
8912421c
LC		 894#endif
895
f4c79b3c 896#if @GNULIB_PUTS@
dd7d0148 897# if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)
f4c79b3c
LC		 898# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
899# undef puts
900# define puts rpl_puts
901# endif
902_GL_FUNCDECL_RPL (puts, int, (const char *string) _GL_ARG_NONNULL ((1)));
903_GL_CXXALIAS_RPL (puts, int, (const char *string));
904# else
905_GL_CXXALIAS_SYS (puts, int, (const char *string));
906# endif
907_GL_CXXALIASWARN (puts);
8912421c
LC		 908#endif
909
910#if @GNULIB_REMOVE@
911# if @REPLACE_REMOVE@
f4c79b3c
LC		 912# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
913# undef remove
914# define remove rpl_remove
915# endif
916_GL_FUNCDECL_RPL (remove, int, (const char *name) _GL_ARG_NONNULL ((1)));
917_GL_CXXALIAS_RPL (remove, int, (const char *name));
918# else
919_GL_CXXALIAS_SYS (remove, int, (const char *name));
8912421c 920# endif
f4c79b3c 921_GL_CXXALIASWARN (remove);
8912421c
LC		 922#elif defined GNULIB_POSIXCHECK
923# undef remove
61cd9dc9
LC		 924/* Assume remove is always declared. */
925_GL_WARN_ON_USE (remove, "remove cannot handle directories on some platforms - "
926 "use gnulib module remove for more portability");
8912421c
LC		 927#endif
928
929#if @GNULIB_RENAME@
930# if @REPLACE_RENAME@
f4c79b3c
LC		 931# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
932# undef rename
933# define rename rpl_rename
934# endif
935_GL_FUNCDECL_RPL (rename, int,
936 (const char *old_filename, const char *new_filename)
937 _GL_ARG_NONNULL ((1, 2)));
938_GL_CXXALIAS_RPL (rename, int,
939 (const char *old_filename, const char *new_filename));
940# else
941_GL_CXXALIAS_SYS (rename, int,
942 (const char *old_filename, const char *new_filename));
943# endif
944_GL_CXXALIASWARN (rename);
8912421c
LC		 945#elif defined GNULIB_POSIXCHECK
946# undef rename
61cd9dc9
LC		 947/* Assume rename is always declared. */
948_GL_WARN_ON_USE (rename, "rename is buggy on some platforms - "
949 "use gnulib module rename for more portability");
8912421c
LC		 950#endif
951
952#if @GNULIB_RENAMEAT@
953# if @REPLACE_RENAMEAT@
f4c79b3c
LC		 954# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
955# undef renameat
956# define renameat rpl_renameat
957# endif
958_GL_FUNCDECL_RPL (renameat, int,
959 (int fd1, char const *file1, int fd2, char const *file2)
960 _GL_ARG_NONNULL ((2, 4)));
961_GL_CXXALIAS_RPL (renameat, int,
962 (int fd1, char const *file1, int fd2, char const *file2));
963# else
964# if !@HAVE_RENAMEAT@
965_GL_FUNCDECL_SYS (renameat, int,
966 (int fd1, char const *file1, int fd2, char const *file2)
967 _GL_ARG_NONNULL ((2, 4)));
968# endif
969_GL_CXXALIAS_SYS (renameat, int,
970 (int fd1, char const *file1, int fd2, char const *file2));
8912421c 971# endif
f4c79b3c 972_GL_CXXALIASWARN (renameat);
8912421c
LC		 973#elif defined GNULIB_POSIXCHECK
974# undef renameat
61cd9dc9
LC		 975# if HAVE_RAW_DECL_RENAMEAT
976_GL_WARN_ON_USE (renameat, "renameat is not portable - "
977 "use gnulib module renameat for portability");
978# endif
8912421c
LC		 979#endif
980
dd7d0148
LC		 981#if @GNULIB_SCANF@
982# if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
983# if defined __GNUC__
984# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
985# undef scanf
986/* Don't break __attribute__((format(scanf,M,N))). */
987# define scanf __scanf__
988# endif
989_GL_FUNCDECL_RPL_1 (__scanf__, int,
990 (const char *format, ...)
991 __asm__ (@ASM_SYMBOL_PREFIX@
992 _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_scanf))
993 _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 2)
994 _GL_ARG_NONNULL ((1)));
995_GL_CXXALIAS_RPL_1 (scanf, __scanf__, int, (const char *format, ...));
996# else
997# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
998# undef scanf
999# define scanf rpl_scanf
1000# endif
1001_GL_FUNCDECL_RPL (scanf, int, (const char *format, ...)
1002 _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 2)
1003 _GL_ARG_NONNULL ((1)));
1004_GL_CXXALIAS_RPL (scanf, int, (const char *format, ...));
1005# endif
1006# else
1007_GL_CXXALIAS_SYS (scanf, int, (const char *format, ...));
1008# endif
1009_GL_CXXALIASWARN (scanf);
1010#endif
1011
8912421c
LC		 1012#if @GNULIB_SNPRINTF@
1013# if @REPLACE_SNPRINTF@
f4c79b3c
LC		 1014# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1015# define snprintf rpl_snprintf
1016# endif
1017_GL_FUNCDECL_RPL (snprintf, int,
1018 (char *str, size_t size, const char *format, ...)
49114fd4 1019 _GL_ATTRIBUTE_FORMAT_PRINTF (3, 4)
f4c79b3c
LC		 1020 _GL_ARG_NONNULL ((3)));
1021_GL_CXXALIAS_RPL (snprintf, int,
1022 (char *str, size_t size, const char *format, ...));
1023# else
1024# if !@HAVE_DECL_SNPRINTF@
1025_GL_FUNCDECL_SYS (snprintf, int,
1026 (char *str, size_t size, const char *format, ...)
49114fd4 1027 _GL_ATTRIBUTE_FORMAT_PRINTF (3, 4)
f4c79b3c
LC		 1028 _GL_ARG_NONNULL ((3)));
1029# endif
1030_GL_CXXALIAS_SYS (snprintf, int,
1031 (char *str, size_t size, const char *format, ...));
8912421c 1032# endif
f4c79b3c 1033_GL_CXXALIASWARN (snprintf);
8912421c
LC		 1034#elif defined GNULIB_POSIXCHECK
1035# undef snprintf
61cd9dc9
LC		 1036# if HAVE_RAW_DECL_SNPRINTF
1037_GL_WARN_ON_USE (snprintf, "snprintf is unportable - "
1038 "use gnulib module snprintf for portability");
1039# endif
8912421c
LC		 1040#endif
1041
005de2e8
LC		 1042/* Some people would argue that all sprintf uses should be warned about
1043 (for example, OpenBSD issues a link warning for it),
1044 since it can cause security holes due to buffer overruns.
61cd9dc9
LC		 1045 However, we believe that sprintf can be used safely, and is more
1046 efficient than snprintf in those safe cases; and as proof of our
1047 belief, we use sprintf in several gnulib modules. So this header
1048 intentionally avoids adding a warning to sprintf except when
1049 GNULIB_POSIXCHECK is defined. */
1050
8912421c
LC		 1051#if @GNULIB_SPRINTF_POSIX@
1052# if @REPLACE_SPRINTF@
f4c79b3c
LC		 1053# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1054# define sprintf rpl_sprintf
1055# endif
1056_GL_FUNCDECL_RPL (sprintf, int, (char *str, const char *format, ...)
49114fd4 1057 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
f4c79b3c
LC		 1058 _GL_ARG_NONNULL ((1, 2)));
1059_GL_CXXALIAS_RPL (sprintf, int, (char *str, const char *format, ...));
1060# else
1061_GL_CXXALIAS_SYS (sprintf, int, (char *str, const char *format, ...));
1062# endif
1063_GL_CXXALIASWARN (sprintf);
8912421c
LC		 1064#elif defined GNULIB_POSIXCHECK
1065# undef sprintf
61cd9dc9
LC		 1066/* Assume sprintf is always declared. */
1067_GL_WARN_ON_USE (sprintf, "sprintf is not always POSIX compliant - "
1068 "use gnulib module sprintf-posix for portable "
1069 "POSIX compliance");
8912421c
LC		 1070#endif
1071
a927b6c1
LC		 1072#if @GNULIB_TMPFILE@
1073# if @REPLACE_TMPFILE@
1074# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1075# define tmpfile rpl_tmpfile
1076# endif
1077_GL_FUNCDECL_RPL (tmpfile, FILE *, (void));
1078_GL_CXXALIAS_RPL (tmpfile, FILE *, (void));
1079# else
1080_GL_CXXALIAS_SYS (tmpfile, FILE *, (void));
1081# endif
1082_GL_CXXALIASWARN (tmpfile);
1083#elif defined GNULIB_POSIXCHECK
1084# undef tmpfile
1085# if HAVE_RAW_DECL_TMPFILE
1086_GL_WARN_ON_USE (tmpfile, "tmpfile is not usable on mingw - "
1087 "use gnulib module tmpfile for portability");
1088# endif
1089#endif
1090
8912421c 1091#if @GNULIB_VASPRINTF@
f4c79b3c
LC		 1092/* Write formatted output to a string dynamically allocated with malloc().
1093 If the memory allocation succeeds, store the address of the string in
1094 *RESULT and return the number of resulting bytes, excluding the trailing
1095 NUL. Upon memory allocation error, or some other error, return -1. */
8912421c 1096# if @REPLACE_VASPRINTF@
f4c79b3c
LC		 1097# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1098# define asprintf rpl_asprintf
1099# endif
1100_GL_FUNCDECL_RPL (asprintf, int,
1101 (char **result, const char *format, ...)
49114fd4 1102 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
f4c79b3c
LC		 1103 _GL_ARG_NONNULL ((1, 2)));
1104_GL_CXXALIAS_RPL (asprintf, int,
1105 (char **result, const char *format, ...));
1106# else
1107# if !@HAVE_VASPRINTF@
1108_GL_FUNCDECL_SYS (asprintf, int,
1109 (char **result, const char *format, ...)
49114fd4 1110 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
f4c79b3c
LC		 1111 _GL_ARG_NONNULL ((1, 2)));
1112# endif
1113_GL_CXXALIAS_SYS (asprintf, int,
1114 (char **result, const char *format, ...));
8912421c 1115# endif
f4c79b3c
LC		 1116_GL_CXXALIASWARN (asprintf);
1117# if @REPLACE_VASPRINTF@
1118# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1119# define vasprintf rpl_vasprintf
1120# endif
1121_GL_FUNCDECL_RPL (vasprintf, int,
1122 (char **result, const char *format, va_list args)
49114fd4 1123 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
f4c79b3c
LC		 1124 _GL_ARG_NONNULL ((1, 2)));
1125_GL_CXXALIAS_RPL (vasprintf, int,
1126 (char **result, const char *format, va_list args));
1127# else
1128# if !@HAVE_VASPRINTF@
1129_GL_FUNCDECL_SYS (vasprintf, int,
1130 (char **result, const char *format, va_list args)
49114fd4 1131 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
f4c79b3c
LC		 1132 _GL_ARG_NONNULL ((1, 2)));
1133# endif
1134_GL_CXXALIAS_SYS (vasprintf, int,
1135 (char **result, const char *format, va_list args));
8912421c 1136# endif
f4c79b3c 1137_GL_CXXALIASWARN (vasprintf);
8912421c
LC		 1138#endif
1139
1140#if @GNULIB_VDPRINTF@
1141# if @REPLACE_VDPRINTF@
f4c79b3c
LC		 1142# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1143# define vdprintf rpl_vdprintf
1144# endif
1145_GL_FUNCDECL_RPL (vdprintf, int, (int fd, const char *format, va_list args)
49114fd4 1146 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
f4c79b3c
LC		 1147 _GL_ARG_NONNULL ((2)));
1148_GL_CXXALIAS_RPL (vdprintf, int, (int fd, const char *format, va_list args));
1149# else
1150# if !@HAVE_VDPRINTF@
1151_GL_FUNCDECL_SYS (vdprintf, int, (int fd, const char *format, va_list args)
49114fd4 1152 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
f4c79b3c
LC		 1153 _GL_ARG_NONNULL ((2)));
1154# endif
a927b6c1
LC		 1155/* Need to cast, because on Solaris, the third parameter will likely be
1156 __va_list args. */
1157_GL_CXXALIAS_SYS_CAST (vdprintf, int,
1158 (int fd, const char *format, va_list args));
8912421c 1159# endif
f4c79b3c 1160_GL_CXXALIASWARN (vdprintf);
8912421c
LC		 1161#elif defined GNULIB_POSIXCHECK
1162# undef vdprintf
61cd9dc9
LC		 1163# if HAVE_RAW_DECL_VDPRINTF
1164_GL_WARN_ON_USE (vdprintf, "vdprintf is unportable - "
1165 "use gnulib module vdprintf for portability");
1166# endif
8912421c
LC		 1167#endif
1168
f4c79b3c
LC		 1169#if @GNULIB_VFPRINTF_POSIX@ || @GNULIB_VFPRINTF@
1170# if (@GNULIB_VFPRINTF_POSIX@ && @REPLACE_VFPRINTF@) \
dd7d0148 1171 || (@GNULIB_VFPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
f4c79b3c
LC		 1172# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1173# define vfprintf rpl_vfprintf
1174# endif
1175# define GNULIB_overrides_vfprintf 1
dd7d0148 1176# if @GNULIB_VFPRINTF_POSIX@
f4c79b3c 1177_GL_FUNCDECL_RPL (vfprintf, int, (FILE *fp, const char *format, va_list args)
49114fd4 1178 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
f4c79b3c 1179 _GL_ARG_NONNULL ((1, 2)));
dd7d0148
LC		 1180# else
1181_GL_FUNCDECL_RPL (vfprintf, int, (FILE *fp, const char *format, va_list args)
1182 _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (2, 0)
1183 _GL_ARG_NONNULL ((1, 2)));
1184# endif
f4c79b3c
LC		 1185_GL_CXXALIAS_RPL (vfprintf, int, (FILE *fp, const char *format, va_list args));
1186# else
a927b6c1
LC		 1187/* Need to cast, because on Solaris, the third parameter is
1188 __va_list args
1189 and GCC's fixincludes did not change this to __gnuc_va_list. */
1190_GL_CXXALIAS_SYS_CAST (vfprintf, int,
1191 (FILE *fp, const char *format, va_list args));
f4c79b3c
LC		 1192# endif
1193_GL_CXXALIASWARN (vfprintf);
1194#endif
1195#if !@GNULIB_VFPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
1196# if !GNULIB_overrides_vfprintf
1197# undef vfprintf
8912421c 1198# endif
61cd9dc9
LC		 1199/* Assume vfprintf is always declared. */
1200_GL_WARN_ON_USE (vfprintf, "vfprintf is not always POSIX compliant - "
1201 "use gnulib module vfprintf-posix for portable "
1202 "POSIX compliance");
8912421c
LC		 1203#endif
1204
dd7d0148
LC		 1205#if @GNULIB_VFSCANF@
1206# if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
1207# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1208# undef vfscanf
1209# define vfscanf rpl_vfscanf
1210# endif
1211_GL_FUNCDECL_RPL (vfscanf, int,
1212 (FILE *stream, const char *format, va_list args)
1213 _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (2, 0)
1214 _GL_ARG_NONNULL ((1, 2)));
1215_GL_CXXALIAS_RPL (vfscanf, int,
1216 (FILE *stream, const char *format, va_list args));
1217# else
1218_GL_CXXALIAS_SYS (vfscanf, int,
1219 (FILE *stream, const char *format, va_list args));
1220# endif
1221_GL_CXXALIASWARN (vfscanf);
1222#endif
1223
f4c79b3c
LC		 1224#if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VPRINTF@
1225# if (@GNULIB_VPRINTF_POSIX@ && @REPLACE_VPRINTF@) \
dd7d0148 1226 || (@GNULIB_VPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
f4c79b3c
LC		 1227# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1228# define vprintf rpl_vprintf
1229# endif
1230# define GNULIB_overrides_vprintf 1
dd7d0148 1231# if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
f4c79b3c 1232_GL_FUNCDECL_RPL (vprintf, int, (const char *format, va_list args)
49114fd4 1233 _GL_ATTRIBUTE_FORMAT_PRINTF (1, 0)
f4c79b3c 1234 _GL_ARG_NONNULL ((1)));
dd7d0148
LC		 1235# else
1236_GL_FUNCDECL_RPL (vprintf, int, (const char *format, va_list args)
1237 _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (1, 0)
1238 _GL_ARG_NONNULL ((1)));
1239# endif
f4c79b3c
LC		 1240_GL_CXXALIAS_RPL (vprintf, int, (const char *format, va_list args));
1241# else
a927b6c1
LC		 1242/* Need to cast, because on Solaris, the second parameter is
1243 __va_list args
1244 and GCC's fixincludes did not change this to __gnuc_va_list. */
1245_GL_CXXALIAS_SYS_CAST (vprintf, int, (const char *format, va_list args));
f4c79b3c
LC		 1246# endif
1247_GL_CXXALIASWARN (vprintf);
1248#endif
1249#if !@GNULIB_VPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
1250# if !GNULIB_overrides_vprintf
1251# undef vprintf
8912421c 1252# endif
61cd9dc9
LC		 1253/* Assume vprintf is always declared. */
1254_GL_WARN_ON_USE (vprintf, "vprintf is not always POSIX compliant - "
1255 "use gnulib module vprintf-posix for portable "
1256 "POSIX compliance");
8912421c
LC		 1257#endif
1258
dd7d0148
LC		 1259#if @GNULIB_VSCANF@
1260# if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
1261# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1262# undef vscanf
1263# define vscanf rpl_vscanf
1264# endif
1265_GL_FUNCDECL_RPL (vscanf, int, (const char *format, va_list args)
1266 _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 0)
1267 _GL_ARG_NONNULL ((1)));
1268_GL_CXXALIAS_RPL (vscanf, int, (const char *format, va_list args));
1269# else
1270_GL_CXXALIAS_SYS (vscanf, int, (const char *format, va_list args));
1271# endif
1272_GL_CXXALIASWARN (vscanf);
1273#endif
1274
8912421c
LC		 1275#if @GNULIB_VSNPRINTF@
1276# if @REPLACE_VSNPRINTF@
f4c79b3c
LC		 1277# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1278# define vsnprintf rpl_vsnprintf
1279# endif
1280_GL_FUNCDECL_RPL (vsnprintf, int,
1281 (char *str, size_t size, const char *format, va_list args)
49114fd4 1282 _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0)
f4c79b3c
LC		 1283 _GL_ARG_NONNULL ((3)));
1284_GL_CXXALIAS_RPL (vsnprintf, int,
1285 (char *str, size_t size, const char *format, va_list args));
1286# else
1287# if !@HAVE_DECL_VSNPRINTF@
1288_GL_FUNCDECL_SYS (vsnprintf, int,
1289 (char *str, size_t size, const char *format, va_list args)
49114fd4 1290 _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0)
f4c79b3c
LC		 1291 _GL_ARG_NONNULL ((3)));
1292# endif
1293_GL_CXXALIAS_SYS (vsnprintf, int,
1294 (char *str, size_t size, const char *format, va_list args));
8912421c 1295# endif
f4c79b3c 1296_GL_CXXALIASWARN (vsnprintf);
8912421c
LC		 1297#elif defined GNULIB_POSIXCHECK
1298# undef vsnprintf
61cd9dc9
LC		 1299# if HAVE_RAW_DECL_VSNPRINTF
1300_GL_WARN_ON_USE (vsnprintf, "vsnprintf is unportable - "
1301 "use gnulib module vsnprintf for portability");
1302# endif
8912421c
LC		 1303#endif
1304
1305#if @GNULIB_VSPRINTF_POSIX@
1306# if @REPLACE_VSPRINTF@
f4c79b3c
LC		 1307# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1308# define vsprintf rpl_vsprintf
1309# endif
1310_GL_FUNCDECL_RPL (vsprintf, int,
1311 (char *str, const char *format, va_list args)
49114fd4 1312 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
f4c79b3c
LC		 1313 _GL_ARG_NONNULL ((1, 2)));
1314_GL_CXXALIAS_RPL (vsprintf, int,
1315 (char *str, const char *format, va_list args));
1316# else
a927b6c1
LC		 1317/* Need to cast, because on Solaris, the third parameter is
1318 __va_list args
1319 and GCC's fixincludes did not change this to __gnuc_va_list. */
1320_GL_CXXALIAS_SYS_CAST (vsprintf, int,
1321 (char *str, const char *format, va_list args));
f4c79b3c
LC		 1322# endif
1323_GL_CXXALIASWARN (vsprintf);
8912421c
LC		 1324#elif defined GNULIB_POSIXCHECK
1325# undef vsprintf
61cd9dc9
LC		 1326/* Assume vsprintf is always declared. */
1327_GL_WARN_ON_USE (vsprintf, "vsprintf is not always POSIX compliant - "
1328 "use gnulib module vsprintf-posix for portable "
1329 "POSIX compliance");
8912421c
LC		 1330#endif
1331
3d458a81
AW		 1332#endif /* _@GUARD_PREFIX@_STDIO_H */
1333#endif /* _@GUARD_PREFIX@_STDIO_H */
c4b681fd 1334#endif
Unnamed repository; edit this file 'description' to name the repository.