| 1 | /* A GNU-like <stdio.h>. |
| 2 | |
| 3 | Copyright (C) 2004, 2007-2011 Free Software Foundation, Inc. |
| 4 | |
| 5 | This program is free software; you can redistribute it and/or modify |
| 6 | it under the terms of the GNU General Public License as published by |
| 7 | the Free Software Foundation; either version 3, or (at your option) |
| 8 | any later version. |
| 9 | |
| 10 | This program is distributed in the hope that it will be useful, |
| 11 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 13 | GNU General Public License for more details. |
| 14 | |
| 15 | You should have received a copy of the GNU General Public License |
| 16 | along with this program; if not, 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 |
| 22 | @PRAGMA_COLUMNS@ |
| 23 | |
| 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. */ |
| 32 | |
| 33 | #@INCLUDE_NEXT@ @NEXT_STDIO_H@ |
| 34 | |
| 35 | #else |
| 36 | /* Normal invocation convention. */ |
| 37 | |
| 38 | #ifndef _@GUARD_PREFIX@_STDIO_H |
| 39 | |
| 40 | #define _GL_ALREADY_INCLUDING_STDIO_H |
| 41 | |
| 42 | /* The include_next requires a split double-inclusion guard. */ |
| 43 | #@INCLUDE_NEXT@ @NEXT_STDIO_H@ |
| 44 | |
| 45 | #undef _GL_ALREADY_INCLUDING_STDIO_H |
| 46 | |
| 47 | #ifndef _@GUARD_PREFIX@_STDIO_H |
| 48 | #define _@GUARD_PREFIX@_STDIO_H |
| 49 | |
| 50 | /* Get va_list. Needed on many systems, including glibc 2.8. */ |
| 51 | #include <stdarg.h> |
| 52 | |
| 53 | #include <stddef.h> |
| 54 | |
| 55 | /* Get off_t and ssize_t. Needed on many systems, including glibc 2.8 |
| 56 | and eglibc 2.11.2. */ |
| 57 | #include <sys/types.h> |
| 58 | |
| 59 | /* The __attribute__ feature is available in gcc versions 2.5 and later. |
| 60 | The __-protected variants of the attributes 'format' and 'printf' are |
| 61 | accepted by gcc versions 2.6.4 (effectively 2.7) and later. |
| 62 | We enable _GL_ATTRIBUTE_FORMAT only if these are supported too, because |
| 63 | gnulib and libintl do '#define printf __printf__' when they override |
| 64 | the 'printf' function. */ |
| 65 | #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 */ |
| 69 | #endif |
| 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) \ |
| 88 | _GL_ATTRIBUTE_FORMAT ((__printf__, formatstring_parameter, first_argument)) |
| 89 | |
| 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 | |
| 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 | |
| 116 | |
| 117 | /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */ |
| 118 | |
| 119 | /* The definition of _GL_ARG_NONNULL is copied here. */ |
| 120 | |
| 121 | /* The definition of _GL_WARN_ON_USE is copied here. */ |
| 122 | |
| 123 | /* Macros for stringification. */ |
| 124 | #define _GL_STDIO_STRINGIZE(token) #token |
| 125 | #define _GL_STDIO_MACROEXPAND_AND_STRINGIZE(token) _GL_STDIO_STRINGIZE(token) |
| 126 | |
| 127 | |
| 128 | #if @GNULIB_DPRINTF@ |
| 129 | # if @REPLACE_DPRINTF@ |
| 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, ...) |
| 134 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3) |
| 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, ...) |
| 140 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3) |
| 141 | _GL_ARG_NONNULL ((2))); |
| 142 | # endif |
| 143 | _GL_CXXALIAS_SYS (dprintf, int, (int fd, const char *format, ...)); |
| 144 | # endif |
| 145 | _GL_CXXALIASWARN (dprintf); |
| 146 | #elif defined GNULIB_POSIXCHECK |
| 147 | # undef dprintf |
| 148 | # if HAVE_RAW_DECL_DPRINTF |
| 149 | _GL_WARN_ON_USE (dprintf, "dprintf is unportable - " |
| 150 | "use gnulib module dprintf for portability"); |
| 151 | # endif |
| 152 | #endif |
| 153 | |
| 154 | #if @GNULIB_FCLOSE@ |
| 155 | /* Close STREAM and its underlying file descriptor. */ |
| 156 | # if @REPLACE_FCLOSE@ |
| 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)); |
| 164 | # endif |
| 165 | _GL_CXXALIASWARN (fclose); |
| 166 | #elif defined GNULIB_POSIXCHECK |
| 167 | # undef fclose |
| 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"); |
| 171 | #endif |
| 172 | |
| 173 | #if @GNULIB_FFLUSH@ |
| 174 | /* Flush all pending data on STREAM according to POSIX rules. Both |
| 175 | output and seekable input streams are supported. |
| 176 | Note! LOSS OF DATA can occur if fflush is applied on an input stream |
| 177 | that is _not_seekable_ or on an update stream that is _not_seekable_ |
| 178 | and in which the most recent operation was input. Seekability can |
| 179 | be tested with lseek(fileno(fp),0,SEEK_CUR). */ |
| 180 | # if @REPLACE_FFLUSH@ |
| 181 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 182 | # define fflush rpl_fflush |
| 183 | # endif |
| 184 | _GL_FUNCDECL_RPL (fflush, int, (FILE *gl_stream)); |
| 185 | _GL_CXXALIAS_RPL (fflush, int, (FILE *gl_stream)); |
| 186 | # else |
| 187 | _GL_CXXALIAS_SYS (fflush, int, (FILE *gl_stream)); |
| 188 | # endif |
| 189 | _GL_CXXALIASWARN (fflush); |
| 190 | #elif defined GNULIB_POSIXCHECK |
| 191 | # undef fflush |
| 192 | /* Assume fflush is always declared. */ |
| 193 | _GL_WARN_ON_USE (fflush, "fflush is not always POSIX compliant - " |
| 194 | "use gnulib module fflush for portable POSIX compliance"); |
| 195 | #endif |
| 196 | |
| 197 | #if @GNULIB_FGETC@ |
| 198 | # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@ |
| 199 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 200 | # undef fgetc |
| 201 | # define fgetc rpl_fgetc |
| 202 | # endif |
| 203 | _GL_FUNCDECL_RPL (fgetc, int, (FILE *stream) _GL_ARG_NONNULL ((1))); |
| 204 | _GL_CXXALIAS_RPL (fgetc, int, (FILE *stream)); |
| 205 | # else |
| 206 | _GL_CXXALIAS_SYS (fgetc, int, (FILE *stream)); |
| 207 | # endif |
| 208 | _GL_CXXALIASWARN (fgetc); |
| 209 | #endif |
| 210 | |
| 211 | #if @GNULIB_FGETS@ |
| 212 | # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@ |
| 213 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 214 | # undef fgets |
| 215 | # define fgets rpl_fgets |
| 216 | # endif |
| 217 | _GL_FUNCDECL_RPL (fgets, char *, (char *s, int n, FILE *stream) |
| 218 | _GL_ARG_NONNULL ((1, 3))); |
| 219 | _GL_CXXALIAS_RPL (fgets, char *, (char *s, int n, FILE *stream)); |
| 220 | # else |
| 221 | _GL_CXXALIAS_SYS (fgets, char *, (char *s, int n, FILE *stream)); |
| 222 | # endif |
| 223 | _GL_CXXALIASWARN (fgets); |
| 224 | #endif |
| 225 | |
| 226 | #if @GNULIB_FOPEN@ |
| 227 | # if @REPLACE_FOPEN@ |
| 228 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 229 | # undef fopen |
| 230 | # define fopen rpl_fopen |
| 231 | # endif |
| 232 | _GL_FUNCDECL_RPL (fopen, FILE *, (const char *filename, const char *mode) |
| 233 | _GL_ARG_NONNULL ((1, 2))); |
| 234 | _GL_CXXALIAS_RPL (fopen, FILE *, (const char *filename, const char *mode)); |
| 235 | # else |
| 236 | _GL_CXXALIAS_SYS (fopen, FILE *, (const char *filename, const char *mode)); |
| 237 | # endif |
| 238 | _GL_CXXALIASWARN (fopen); |
| 239 | #elif defined GNULIB_POSIXCHECK |
| 240 | # undef fopen |
| 241 | /* Assume fopen is always declared. */ |
| 242 | _GL_WARN_ON_USE (fopen, "fopen on Win32 platforms is not POSIX compatible - " |
| 243 | "use gnulib module fopen for portability"); |
| 244 | #endif |
| 245 | |
| 246 | #if @GNULIB_FPRINTF_POSIX@ || @GNULIB_FPRINTF@ |
| 247 | # if (@GNULIB_FPRINTF_POSIX@ && @REPLACE_FPRINTF@) \ |
| 248 | || (@GNULIB_FPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)) |
| 249 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 250 | # define fprintf rpl_fprintf |
| 251 | # endif |
| 252 | # define GNULIB_overrides_fprintf 1 |
| 253 | # if @GNULIB_FPRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@ |
| 254 | _GL_FUNCDECL_RPL (fprintf, int, (FILE *fp, const char *format, ...) |
| 255 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3) |
| 256 | _GL_ARG_NONNULL ((1, 2))); |
| 257 | # else |
| 258 | _GL_FUNCDECL_RPL (fprintf, int, (FILE *fp, const char *format, ...) |
| 259 | _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (2, 3) |
| 260 | _GL_ARG_NONNULL ((1, 2))); |
| 261 | # endif |
| 262 | _GL_CXXALIAS_RPL (fprintf, int, (FILE *fp, const char *format, ...)); |
| 263 | # else |
| 264 | _GL_CXXALIAS_SYS (fprintf, int, (FILE *fp, const char *format, ...)); |
| 265 | # endif |
| 266 | _GL_CXXALIASWARN (fprintf); |
| 267 | #endif |
| 268 | #if !@GNULIB_FPRINTF_POSIX@ && defined GNULIB_POSIXCHECK |
| 269 | # if !GNULIB_overrides_fprintf |
| 270 | # undef fprintf |
| 271 | # endif |
| 272 | /* Assume fprintf is always declared. */ |
| 273 | _GL_WARN_ON_USE (fprintf, "fprintf is not always POSIX compliant - " |
| 274 | "use gnulib module fprintf-posix for portable " |
| 275 | "POSIX compliance"); |
| 276 | #endif |
| 277 | |
| 278 | #if @GNULIB_FPURGE@ |
| 279 | /* Discard all pending buffered I/O data on STREAM. |
| 280 | STREAM must not be wide-character oriented. |
| 281 | When discarding pending output, the file position is set back to where it |
| 282 | was before the write calls. When discarding pending input, the file |
| 283 | position is advanced to match the end of the previously read input. |
| 284 | Return 0 if successful. Upon error, return -1 and set errno. */ |
| 285 | # if @REPLACE_FPURGE@ |
| 286 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 287 | # define fpurge rpl_fpurge |
| 288 | # endif |
| 289 | _GL_FUNCDECL_RPL (fpurge, int, (FILE *gl_stream) _GL_ARG_NONNULL ((1))); |
| 290 | _GL_CXXALIAS_RPL (fpurge, int, (FILE *gl_stream)); |
| 291 | # else |
| 292 | # if !@HAVE_DECL_FPURGE@ |
| 293 | _GL_FUNCDECL_SYS (fpurge, int, (FILE *gl_stream) _GL_ARG_NONNULL ((1))); |
| 294 | # endif |
| 295 | _GL_CXXALIAS_SYS (fpurge, int, (FILE *gl_stream)); |
| 296 | # endif |
| 297 | _GL_CXXALIASWARN (fpurge); |
| 298 | #elif defined GNULIB_POSIXCHECK |
| 299 | # undef fpurge |
| 300 | # if HAVE_RAW_DECL_FPURGE |
| 301 | _GL_WARN_ON_USE (fpurge, "fpurge is not always present - " |
| 302 | "use gnulib module fpurge for portability"); |
| 303 | # endif |
| 304 | #endif |
| 305 | |
| 306 | #if @GNULIB_FPUTC@ |
| 307 | # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@) |
| 308 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 309 | # undef fputc |
| 310 | # define fputc rpl_fputc |
| 311 | # endif |
| 312 | _GL_FUNCDECL_RPL (fputc, int, (int c, FILE *stream) _GL_ARG_NONNULL ((2))); |
| 313 | _GL_CXXALIAS_RPL (fputc, int, (int c, FILE *stream)); |
| 314 | # else |
| 315 | _GL_CXXALIAS_SYS (fputc, int, (int c, FILE *stream)); |
| 316 | # endif |
| 317 | _GL_CXXALIASWARN (fputc); |
| 318 | #endif |
| 319 | |
| 320 | #if @GNULIB_FPUTS@ |
| 321 | # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@) |
| 322 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 323 | # undef fputs |
| 324 | # define fputs rpl_fputs |
| 325 | # endif |
| 326 | _GL_FUNCDECL_RPL (fputs, int, (const char *string, FILE *stream) |
| 327 | _GL_ARG_NONNULL ((1, 2))); |
| 328 | _GL_CXXALIAS_RPL (fputs, int, (const char *string, FILE *stream)); |
| 329 | # else |
| 330 | _GL_CXXALIAS_SYS (fputs, int, (const char *string, FILE *stream)); |
| 331 | # endif |
| 332 | _GL_CXXALIASWARN (fputs); |
| 333 | #endif |
| 334 | |
| 335 | #if @GNULIB_FREAD@ |
| 336 | # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@ |
| 337 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 338 | # undef fread |
| 339 | # define fread rpl_fread |
| 340 | # endif |
| 341 | _GL_FUNCDECL_RPL (fread, size_t, (void *ptr, size_t s, size_t n, FILE *stream) |
| 342 | _GL_ARG_NONNULL ((4))); |
| 343 | _GL_CXXALIAS_RPL (fread, size_t, (void *ptr, size_t s, size_t n, FILE *stream)); |
| 344 | # else |
| 345 | _GL_CXXALIAS_SYS (fread, size_t, (void *ptr, size_t s, size_t n, FILE *stream)); |
| 346 | # endif |
| 347 | _GL_CXXALIASWARN (fread); |
| 348 | #endif |
| 349 | |
| 350 | #if @GNULIB_FREOPEN@ |
| 351 | # if @REPLACE_FREOPEN@ |
| 352 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 353 | # undef freopen |
| 354 | # define freopen rpl_freopen |
| 355 | # endif |
| 356 | _GL_FUNCDECL_RPL (freopen, FILE *, |
| 357 | (const char *filename, const char *mode, FILE *stream) |
| 358 | _GL_ARG_NONNULL ((2, 3))); |
| 359 | _GL_CXXALIAS_RPL (freopen, FILE *, |
| 360 | (const char *filename, const char *mode, FILE *stream)); |
| 361 | # else |
| 362 | _GL_CXXALIAS_SYS (freopen, FILE *, |
| 363 | (const char *filename, const char *mode, FILE *stream)); |
| 364 | # endif |
| 365 | _GL_CXXALIASWARN (freopen); |
| 366 | #elif defined GNULIB_POSIXCHECK |
| 367 | # undef freopen |
| 368 | /* Assume freopen is always declared. */ |
| 369 | _GL_WARN_ON_USE (freopen, |
| 370 | "freopen on Win32 platforms is not POSIX compatible - " |
| 371 | "use gnulib module freopen for portability"); |
| 372 | #endif |
| 373 | |
| 374 | #if @GNULIB_FSCANF@ |
| 375 | # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@ |
| 376 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 377 | # undef fscanf |
| 378 | # define fscanf rpl_fscanf |
| 379 | # endif |
| 380 | _GL_FUNCDECL_RPL (fscanf, int, (FILE *stream, const char *format, ...) |
| 381 | _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (2, 3) |
| 382 | _GL_ARG_NONNULL ((1, 2))); |
| 383 | _GL_CXXALIAS_RPL (fscanf, int, (FILE *stream, const char *format, ...)); |
| 384 | # else |
| 385 | _GL_CXXALIAS_SYS (fscanf, int, (FILE *stream, const char *format, ...)); |
| 386 | # endif |
| 387 | _GL_CXXALIASWARN (fscanf); |
| 388 | #endif |
| 389 | |
| 390 | |
| 391 | /* Set up the following warnings, based on which modules are in use. |
| 392 | GNU Coding Standards discourage the use of fseek, since it imposes |
| 393 | an arbitrary limitation on some 32-bit hosts. Remember that the |
| 394 | fseek module depends on the fseeko module, so we only have three |
| 395 | cases to consider: |
| 396 | |
| 397 | 1. The developer is not using either module. Issue a warning under |
| 398 | GNULIB_POSIXCHECK for both functions, to remind them that both |
| 399 | functions have bugs on some systems. _GL_NO_LARGE_FILES has no |
| 400 | impact on this warning. |
| 401 | |
| 402 | 2. The developer is using both modules. They may be unaware of the |
| 403 | arbitrary limitations of fseek, so issue a warning under |
| 404 | GNULIB_POSIXCHECK. On the other hand, they may be using both |
| 405 | modules intentionally, so the developer can define |
| 406 | _GL_NO_LARGE_FILES in the compilation units where the use of fseek |
| 407 | is safe, to silence the warning. |
| 408 | |
| 409 | 3. The developer is using the fseeko module, but not fseek. Gnulib |
| 410 | guarantees that fseek will still work around platform bugs in that |
| 411 | case, but we presume that the developer is aware of the pitfalls of |
| 412 | fseek and was trying to avoid it, so issue a warning even when |
| 413 | GNULIB_POSIXCHECK is undefined. Again, _GL_NO_LARGE_FILES can be |
| 414 | defined to silence the warning in particular compilation units. |
| 415 | In C++ compilations with GNULIB_NAMESPACE, in order to avoid that |
| 416 | fseek gets defined as a macro, it is recommended that the developer |
| 417 | uses the fseek module, even if he is not calling the fseek function. |
| 418 | |
| 419 | Most gnulib clients that perform stream operations should fall into |
| 420 | category 3. */ |
| 421 | |
| 422 | #if @GNULIB_FSEEK@ |
| 423 | # if defined GNULIB_POSIXCHECK && !defined _GL_NO_LARGE_FILES |
| 424 | # define _GL_FSEEK_WARN /* Category 2, above. */ |
| 425 | # undef fseek |
| 426 | # endif |
| 427 | # if @REPLACE_FSEEK@ |
| 428 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 429 | # undef fseek |
| 430 | # define fseek rpl_fseek |
| 431 | # endif |
| 432 | _GL_FUNCDECL_RPL (fseek, int, (FILE *fp, long offset, int whence) |
| 433 | _GL_ARG_NONNULL ((1))); |
| 434 | _GL_CXXALIAS_RPL (fseek, int, (FILE *fp, long offset, int whence)); |
| 435 | # else |
| 436 | _GL_CXXALIAS_SYS (fseek, int, (FILE *fp, long offset, int whence)); |
| 437 | # endif |
| 438 | _GL_CXXALIASWARN (fseek); |
| 439 | #endif |
| 440 | |
| 441 | #if @GNULIB_FSEEKO@ |
| 442 | # if !@GNULIB_FSEEK@ && !defined _GL_NO_LARGE_FILES |
| 443 | # define _GL_FSEEK_WARN /* Category 3, above. */ |
| 444 | # undef fseek |
| 445 | # endif |
| 446 | # if @REPLACE_FSEEKO@ |
| 447 | /* Provide an fseeko function that is aware of a preceding fflush(), and which |
| 448 | detects pipes. */ |
| 449 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 450 | # undef fseeko |
| 451 | # define fseeko rpl_fseeko |
| 452 | # endif |
| 453 | _GL_FUNCDECL_RPL (fseeko, int, (FILE *fp, off_t offset, int whence) |
| 454 | _GL_ARG_NONNULL ((1))); |
| 455 | _GL_CXXALIAS_RPL (fseeko, int, (FILE *fp, off_t offset, int whence)); |
| 456 | # else |
| 457 | # if ! @HAVE_DECL_FSEEKO@ |
| 458 | _GL_FUNCDECL_SYS (fseeko, int, (FILE *fp, off_t offset, int whence) |
| 459 | _GL_ARG_NONNULL ((1))); |
| 460 | # endif |
| 461 | _GL_CXXALIAS_SYS (fseeko, int, (FILE *fp, off_t offset, int whence)); |
| 462 | # endif |
| 463 | _GL_CXXALIASWARN (fseeko); |
| 464 | # if (@REPLACE_FSEEKO@ || !@HAVE_FSEEKO@) && !@GNULIB_FSEEK@ |
| 465 | /* Provide an fseek function that is consistent with fseeko. */ |
| 466 | /* In order to avoid that fseek gets defined as a macro here, the |
| 467 | developer can request the 'fseek' module. */ |
| 468 | # if !GNULIB_defined_fseek_function |
| 469 | # undef fseek |
| 470 | # define fseek rpl_fseek |
| 471 | static inline int _GL_ARG_NONNULL ((1)) |
| 472 | rpl_fseek (FILE *fp, long offset, int whence) |
| 473 | { |
| 474 | # if @REPLACE_FSEEKO@ |
| 475 | return rpl_fseeko (fp, offset, whence); |
| 476 | # else |
| 477 | return fseeko (fp, offset, whence); |
| 478 | # endif |
| 479 | } |
| 480 | # define GNULIB_defined_fseek_function 1 |
| 481 | # endif |
| 482 | # endif |
| 483 | #elif defined GNULIB_POSIXCHECK |
| 484 | # define _GL_FSEEK_WARN /* Category 1, above. */ |
| 485 | # undef fseek |
| 486 | # undef fseeko |
| 487 | # if HAVE_RAW_DECL_FSEEKO |
| 488 | _GL_WARN_ON_USE (fseeko, "fseeko is unportable - " |
| 489 | "use gnulib module fseeko for portability"); |
| 490 | # endif |
| 491 | #endif |
| 492 | |
| 493 | #ifdef _GL_FSEEK_WARN |
| 494 | # undef _GL_FSEEK_WARN |
| 495 | /* Here, either fseek is undefined (but C89 guarantees that it is |
| 496 | declared), or it is defined as rpl_fseek (declared above). */ |
| 497 | _GL_WARN_ON_USE (fseek, "fseek cannot handle files larger than 4 GB " |
| 498 | "on 32-bit platforms - " |
| 499 | "use fseeko function for handling of large files"); |
| 500 | #endif |
| 501 | |
| 502 | |
| 503 | /* ftell, ftello. See the comments on fseek/fseeko. */ |
| 504 | |
| 505 | #if @GNULIB_FTELL@ |
| 506 | # if defined GNULIB_POSIXCHECK && !defined _GL_NO_LARGE_FILES |
| 507 | # define _GL_FTELL_WARN /* Category 2, above. */ |
| 508 | # undef ftell |
| 509 | # endif |
| 510 | # if @REPLACE_FTELL@ |
| 511 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 512 | # undef ftell |
| 513 | # define ftell rpl_ftell |
| 514 | # endif |
| 515 | _GL_FUNCDECL_RPL (ftell, long, (FILE *fp) _GL_ARG_NONNULL ((1))); |
| 516 | _GL_CXXALIAS_RPL (ftell, long, (FILE *fp)); |
| 517 | # else |
| 518 | _GL_CXXALIAS_SYS (ftell, long, (FILE *fp)); |
| 519 | # endif |
| 520 | _GL_CXXALIASWARN (ftell); |
| 521 | #endif |
| 522 | |
| 523 | #if @GNULIB_FTELLO@ |
| 524 | # if !@GNULIB_FTELL@ && !defined _GL_NO_LARGE_FILES |
| 525 | # define _GL_FTELL_WARN /* Category 3, above. */ |
| 526 | # undef ftell |
| 527 | # endif |
| 528 | # if @REPLACE_FTELLO@ |
| 529 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 530 | # undef ftello |
| 531 | # define ftello rpl_ftello |
| 532 | # endif |
| 533 | _GL_FUNCDECL_RPL (ftello, off_t, (FILE *fp) _GL_ARG_NONNULL ((1))); |
| 534 | _GL_CXXALIAS_RPL (ftello, off_t, (FILE *fp)); |
| 535 | # else |
| 536 | # if ! @HAVE_DECL_FTELLO@ |
| 537 | _GL_FUNCDECL_SYS (ftello, off_t, (FILE *fp) _GL_ARG_NONNULL ((1))); |
| 538 | # endif |
| 539 | _GL_CXXALIAS_SYS (ftello, off_t, (FILE *fp)); |
| 540 | # endif |
| 541 | _GL_CXXALIASWARN (ftello); |
| 542 | # if (@REPLACE_FTELLO@ || !@HAVE_FTELLO@) && !@GNULIB_FTELL@ |
| 543 | /* Provide an ftell function that is consistent with ftello. */ |
| 544 | /* In order to avoid that ftell gets defined as a macro here, the |
| 545 | developer can request the 'ftell' module. */ |
| 546 | # if !GNULIB_defined_ftell_function |
| 547 | # undef ftell |
| 548 | # define ftell rpl_ftell |
| 549 | static inline long _GL_ARG_NONNULL ((1)) |
| 550 | rpl_ftell (FILE *f) |
| 551 | { |
| 552 | # if @REPLACE_FTELLO@ |
| 553 | return rpl_ftello (f); |
| 554 | # else |
| 555 | return ftello (f); |
| 556 | # endif |
| 557 | } |
| 558 | # define GNULIB_defined_ftell_function 1 |
| 559 | # endif |
| 560 | # endif |
| 561 | #elif defined GNULIB_POSIXCHECK |
| 562 | # define _GL_FTELL_WARN /* Category 1, above. */ |
| 563 | # undef ftell |
| 564 | # undef ftello |
| 565 | # if HAVE_RAW_DECL_FTELLO |
| 566 | _GL_WARN_ON_USE (ftello, "ftello is unportable - " |
| 567 | "use gnulib module ftello for portability"); |
| 568 | # endif |
| 569 | #endif |
| 570 | |
| 571 | #ifdef _GL_FTELL_WARN |
| 572 | # undef _GL_FTELL_WARN |
| 573 | /* Here, either ftell is undefined (but C89 guarantees that it is |
| 574 | declared), or it is defined as rpl_ftell (declared above). */ |
| 575 | _GL_WARN_ON_USE (ftell, "ftell cannot handle files larger than 4 GB " |
| 576 | "on 32-bit platforms - " |
| 577 | "use ftello function for handling of large files"); |
| 578 | #endif |
| 579 | |
| 580 | |
| 581 | #if @GNULIB_FWRITE@ |
| 582 | # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@) |
| 583 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 584 | # undef fwrite |
| 585 | # define fwrite rpl_fwrite |
| 586 | # endif |
| 587 | _GL_FUNCDECL_RPL (fwrite, size_t, |
| 588 | (const void *ptr, size_t s, size_t n, FILE *stream) |
| 589 | _GL_ARG_NONNULL ((1, 4))); |
| 590 | _GL_CXXALIAS_RPL (fwrite, size_t, |
| 591 | (const void *ptr, size_t s, size_t n, FILE *stream)); |
| 592 | # else |
| 593 | _GL_CXXALIAS_SYS (fwrite, size_t, |
| 594 | (const void *ptr, size_t s, size_t n, FILE *stream)); |
| 595 | |
| 596 | /* Work around glibc bug 11959 |
| 597 | <http://sources.redhat.com/bugzilla/show_bug.cgi?id=11959>, |
| 598 | which sometimes causes an unwanted diagnostic for fwrite calls. |
| 599 | This affects only function declaration attributes, so it's not |
| 600 | needed for C++. */ |
| 601 | # if !defined __cplusplus && 0 < __USE_FORTIFY_LEVEL |
| 602 | static inline size_t _GL_ARG_NONNULL ((1, 4)) |
| 603 | rpl_fwrite (const void *ptr, size_t s, size_t n, FILE *stream) |
| 604 | { |
| 605 | size_t r = fwrite (ptr, s, n, stream); |
| 606 | (void) r; |
| 607 | return r; |
| 608 | } |
| 609 | # undef fwrite |
| 610 | # define fwrite rpl_fwrite |
| 611 | # endif |
| 612 | # endif |
| 613 | _GL_CXXALIASWARN (fwrite); |
| 614 | #endif |
| 615 | |
| 616 | #if @GNULIB_GETC@ |
| 617 | # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@ |
| 618 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 619 | # undef getc |
| 620 | # define getc rpl_fgetc |
| 621 | # endif |
| 622 | _GL_FUNCDECL_RPL (fgetc, int, (FILE *stream) _GL_ARG_NONNULL ((1))); |
| 623 | _GL_CXXALIAS_RPL_1 (getc, rpl_fgetc, int, (FILE *stream)); |
| 624 | # else |
| 625 | _GL_CXXALIAS_SYS (getc, int, (FILE *stream)); |
| 626 | # endif |
| 627 | _GL_CXXALIASWARN (getc); |
| 628 | #endif |
| 629 | |
| 630 | #if @GNULIB_GETCHAR@ |
| 631 | # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@ |
| 632 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 633 | # undef getchar |
| 634 | # define getchar rpl_getchar |
| 635 | # endif |
| 636 | _GL_FUNCDECL_RPL (getchar, int, (void)); |
| 637 | _GL_CXXALIAS_RPL (getchar, int, (void)); |
| 638 | # else |
| 639 | _GL_CXXALIAS_SYS (getchar, int, (void)); |
| 640 | # endif |
| 641 | _GL_CXXALIASWARN (getchar); |
| 642 | #endif |
| 643 | |
| 644 | #if @GNULIB_GETDELIM@ |
| 645 | /* Read input, up to (and including) the next occurrence of DELIMITER, from |
| 646 | STREAM, store it in *LINEPTR (and NUL-terminate it). |
| 647 | *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE |
| 648 | bytes of space. It is realloc'd as necessary. |
| 649 | Return the number of bytes read and stored at *LINEPTR (not including the |
| 650 | NUL terminator), or -1 on error or EOF. */ |
| 651 | # if @REPLACE_GETDELIM@ |
| 652 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 653 | # undef getdelim |
| 654 | # define getdelim rpl_getdelim |
| 655 | # endif |
| 656 | _GL_FUNCDECL_RPL (getdelim, ssize_t, |
| 657 | (char **lineptr, size_t *linesize, int delimiter, |
| 658 | FILE *stream) |
| 659 | _GL_ARG_NONNULL ((1, 2, 4))); |
| 660 | _GL_CXXALIAS_RPL (getdelim, ssize_t, |
| 661 | (char **lineptr, size_t *linesize, int delimiter, |
| 662 | FILE *stream)); |
| 663 | # else |
| 664 | # if !@HAVE_DECL_GETDELIM@ |
| 665 | _GL_FUNCDECL_SYS (getdelim, ssize_t, |
| 666 | (char **lineptr, size_t *linesize, int delimiter, |
| 667 | FILE *stream) |
| 668 | _GL_ARG_NONNULL ((1, 2, 4))); |
| 669 | # endif |
| 670 | _GL_CXXALIAS_SYS (getdelim, ssize_t, |
| 671 | (char **lineptr, size_t *linesize, int delimiter, |
| 672 | FILE *stream)); |
| 673 | # endif |
| 674 | _GL_CXXALIASWARN (getdelim); |
| 675 | #elif defined GNULIB_POSIXCHECK |
| 676 | # undef getdelim |
| 677 | # if HAVE_RAW_DECL_GETDELIM |
| 678 | _GL_WARN_ON_USE (getdelim, "getdelim is unportable - " |
| 679 | "use gnulib module getdelim for portability"); |
| 680 | # endif |
| 681 | #endif |
| 682 | |
| 683 | #if @GNULIB_GETLINE@ |
| 684 | /* Read a line, up to (and including) the next newline, from STREAM, store it |
| 685 | in *LINEPTR (and NUL-terminate it). |
| 686 | *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE |
| 687 | bytes of space. It is realloc'd as necessary. |
| 688 | Return the number of bytes read and stored at *LINEPTR (not including the |
| 689 | NUL terminator), or -1 on error or EOF. */ |
| 690 | # if @REPLACE_GETLINE@ |
| 691 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 692 | # undef getline |
| 693 | # define getline rpl_getline |
| 694 | # endif |
| 695 | _GL_FUNCDECL_RPL (getline, ssize_t, |
| 696 | (char **lineptr, size_t *linesize, FILE *stream) |
| 697 | _GL_ARG_NONNULL ((1, 2, 3))); |
| 698 | _GL_CXXALIAS_RPL (getline, ssize_t, |
| 699 | (char **lineptr, size_t *linesize, FILE *stream)); |
| 700 | # else |
| 701 | # if !@HAVE_DECL_GETLINE@ |
| 702 | _GL_FUNCDECL_SYS (getline, ssize_t, |
| 703 | (char **lineptr, size_t *linesize, FILE *stream) |
| 704 | _GL_ARG_NONNULL ((1, 2, 3))); |
| 705 | # endif |
| 706 | _GL_CXXALIAS_SYS (getline, ssize_t, |
| 707 | (char **lineptr, size_t *linesize, FILE *stream)); |
| 708 | # endif |
| 709 | # if @HAVE_DECL_GETLINE@ |
| 710 | _GL_CXXALIASWARN (getline); |
| 711 | # endif |
| 712 | #elif defined GNULIB_POSIXCHECK |
| 713 | # undef getline |
| 714 | # if HAVE_RAW_DECL_GETLINE |
| 715 | _GL_WARN_ON_USE (getline, "getline is unportable - " |
| 716 | "use gnulib module getline for portability"); |
| 717 | # endif |
| 718 | #endif |
| 719 | |
| 720 | #if @GNULIB_GETS@ |
| 721 | # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@ |
| 722 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 723 | # undef gets |
| 724 | # define gets rpl_gets |
| 725 | # endif |
| 726 | _GL_FUNCDECL_RPL (gets, char *, (char *s) _GL_ARG_NONNULL ((1))); |
| 727 | _GL_CXXALIAS_RPL (gets, char *, (char *s)); |
| 728 | # else |
| 729 | _GL_CXXALIAS_SYS (gets, char *, (char *s)); |
| 730 | # undef gets |
| 731 | # endif |
| 732 | _GL_CXXALIASWARN (gets); |
| 733 | /* It is very rare that the developer ever has full control of stdin, |
| 734 | so any use of gets warrants an unconditional warning. Assume it is |
| 735 | always declared, since it is required by C89. */ |
| 736 | _GL_WARN_ON_USE (gets, "gets is a security hole - use fgets instead"); |
| 737 | #endif |
| 738 | |
| 739 | |
| 740 | #if @GNULIB_OBSTACK_PRINTF@ || @GNULIB_OBSTACK_PRINTF_POSIX@ |
| 741 | struct obstack; |
| 742 | /* Grow an obstack with formatted output. Return the number of |
| 743 | bytes added to OBS. No trailing nul byte is added, and the |
| 744 | object should be closed with obstack_finish before use. Upon |
| 745 | memory allocation error, call obstack_alloc_failed_handler. Upon |
| 746 | other error, return -1. */ |
| 747 | # if @REPLACE_OBSTACK_PRINTF@ |
| 748 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 749 | # define obstack_printf rpl_obstack_printf |
| 750 | # endif |
| 751 | _GL_FUNCDECL_RPL (obstack_printf, int, |
| 752 | (struct obstack *obs, const char *format, ...) |
| 753 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3) |
| 754 | _GL_ARG_NONNULL ((1, 2))); |
| 755 | _GL_CXXALIAS_RPL (obstack_printf, int, |
| 756 | (struct obstack *obs, const char *format, ...)); |
| 757 | # else |
| 758 | # if !@HAVE_DECL_OBSTACK_PRINTF@ |
| 759 | _GL_FUNCDECL_SYS (obstack_printf, int, |
| 760 | (struct obstack *obs, const char *format, ...) |
| 761 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3) |
| 762 | _GL_ARG_NONNULL ((1, 2))); |
| 763 | # endif |
| 764 | _GL_CXXALIAS_SYS (obstack_printf, int, |
| 765 | (struct obstack *obs, const char *format, ...)); |
| 766 | # endif |
| 767 | _GL_CXXALIASWARN (obstack_printf); |
| 768 | # if @REPLACE_OBSTACK_PRINTF@ |
| 769 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 770 | # define obstack_vprintf rpl_obstack_vprintf |
| 771 | # endif |
| 772 | _GL_FUNCDECL_RPL (obstack_vprintf, int, |
| 773 | (struct obstack *obs, const char *format, va_list args) |
| 774 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0) |
| 775 | _GL_ARG_NONNULL ((1, 2))); |
| 776 | _GL_CXXALIAS_RPL (obstack_vprintf, int, |
| 777 | (struct obstack *obs, const char *format, va_list args)); |
| 778 | # else |
| 779 | # if !@HAVE_DECL_OBSTACK_PRINTF@ |
| 780 | _GL_FUNCDECL_SYS (obstack_vprintf, int, |
| 781 | (struct obstack *obs, const char *format, va_list args) |
| 782 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0) |
| 783 | _GL_ARG_NONNULL ((1, 2))); |
| 784 | # endif |
| 785 | _GL_CXXALIAS_SYS (obstack_vprintf, int, |
| 786 | (struct obstack *obs, const char *format, va_list args)); |
| 787 | # endif |
| 788 | _GL_CXXALIASWARN (obstack_vprintf); |
| 789 | #endif |
| 790 | |
| 791 | #if @GNULIB_PERROR@ |
| 792 | /* Print a message to standard error, describing the value of ERRNO, |
| 793 | (if STRING is not NULL and not empty) prefixed with STRING and ": ", |
| 794 | and terminated with a newline. */ |
| 795 | # if @REPLACE_PERROR@ |
| 796 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 797 | # define perror rpl_perror |
| 798 | # endif |
| 799 | _GL_FUNCDECL_RPL (perror, void, (const char *string)); |
| 800 | _GL_CXXALIAS_RPL (perror, void, (const char *string)); |
| 801 | # else |
| 802 | _GL_CXXALIAS_SYS (perror, void, (const char *string)); |
| 803 | # endif |
| 804 | _GL_CXXALIASWARN (perror); |
| 805 | #elif defined GNULIB_POSIXCHECK |
| 806 | # undef perror |
| 807 | /* Assume perror is always declared. */ |
| 808 | _GL_WARN_ON_USE (perror, "perror is not always POSIX compliant - " |
| 809 | "use gnulib module perror for portability"); |
| 810 | #endif |
| 811 | |
| 812 | #if @GNULIB_POPEN@ |
| 813 | # if @REPLACE_POPEN@ |
| 814 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 815 | # undef popen |
| 816 | # define popen rpl_popen |
| 817 | # endif |
| 818 | _GL_FUNCDECL_RPL (popen, FILE *, (const char *cmd, const char *mode) |
| 819 | _GL_ARG_NONNULL ((1, 2))); |
| 820 | _GL_CXXALIAS_RPL (popen, FILE *, (const char *cmd, const char *mode)); |
| 821 | # else |
| 822 | _GL_CXXALIAS_SYS (popen, FILE *, (const char *cmd, const char *mode)); |
| 823 | # endif |
| 824 | _GL_CXXALIASWARN (popen); |
| 825 | #elif defined GNULIB_POSIXCHECK |
| 826 | # undef popen |
| 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 |
| 831 | #endif |
| 832 | |
| 833 | #if @GNULIB_PRINTF_POSIX@ || @GNULIB_PRINTF@ |
| 834 | # if (@GNULIB_PRINTF_POSIX@ && @REPLACE_PRINTF@) \ |
| 835 | || (@GNULIB_PRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)) |
| 836 | # if defined __GNUC__ |
| 837 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 838 | /* Don't break __attribute__((format(printf,M,N))). */ |
| 839 | # define printf __printf__ |
| 840 | # endif |
| 841 | # if @GNULIB_PRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@ |
| 842 | _GL_FUNCDECL_RPL_1 (__printf__, int, |
| 843 | (const char *format, ...) |
| 844 | __asm__ (@ASM_SYMBOL_PREFIX@ |
| 845 | _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_printf)) |
| 846 | _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2) |
| 847 | _GL_ARG_NONNULL ((1))); |
| 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 |
| 856 | _GL_CXXALIAS_RPL_1 (printf, __printf__, int, (const char *format, ...)); |
| 857 | # else |
| 858 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 859 | # define printf rpl_printf |
| 860 | # endif |
| 861 | _GL_FUNCDECL_RPL (printf, int, |
| 862 | (const char *format, ...) |
| 863 | _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2) |
| 864 | _GL_ARG_NONNULL ((1))); |
| 865 | _GL_CXXALIAS_RPL (printf, int, (const char *format, ...)); |
| 866 | # endif |
| 867 | # define GNULIB_overrides_printf 1 |
| 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 |
| 876 | # endif |
| 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"); |
| 881 | #endif |
| 882 | |
| 883 | #if @GNULIB_PUTC@ |
| 884 | # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@) |
| 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); |
| 895 | #endif |
| 896 | |
| 897 | #if @GNULIB_PUTCHAR@ |
| 898 | # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@) |
| 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); |
| 909 | #endif |
| 910 | |
| 911 | #if @GNULIB_PUTS@ |
| 912 | # if @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@) |
| 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); |
| 923 | #endif |
| 924 | |
| 925 | #if @GNULIB_REMOVE@ |
| 926 | # if @REPLACE_REMOVE@ |
| 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)); |
| 935 | # endif |
| 936 | _GL_CXXALIASWARN (remove); |
| 937 | #elif defined GNULIB_POSIXCHECK |
| 938 | # undef remove |
| 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"); |
| 942 | #endif |
| 943 | |
| 944 | #if @GNULIB_RENAME@ |
| 945 | # if @REPLACE_RENAME@ |
| 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); |
| 960 | #elif defined GNULIB_POSIXCHECK |
| 961 | # undef rename |
| 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"); |
| 965 | #endif |
| 966 | |
| 967 | #if @GNULIB_RENAMEAT@ |
| 968 | # if @REPLACE_RENAMEAT@ |
| 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)); |
| 986 | # endif |
| 987 | _GL_CXXALIASWARN (renameat); |
| 988 | #elif defined GNULIB_POSIXCHECK |
| 989 | # undef renameat |
| 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 |
| 994 | #endif |
| 995 | |
| 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 | |
| 1027 | #if @GNULIB_SNPRINTF@ |
| 1028 | # if @REPLACE_SNPRINTF@ |
| 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, ...) |
| 1034 | _GL_ATTRIBUTE_FORMAT_PRINTF (3, 4) |
| 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, ...) |
| 1042 | _GL_ATTRIBUTE_FORMAT_PRINTF (3, 4) |
| 1043 | _GL_ARG_NONNULL ((3))); |
| 1044 | # endif |
| 1045 | _GL_CXXALIAS_SYS (snprintf, int, |
| 1046 | (char *str, size_t size, const char *format, ...)); |
| 1047 | # endif |
| 1048 | _GL_CXXALIASWARN (snprintf); |
| 1049 | #elif defined GNULIB_POSIXCHECK |
| 1050 | # undef snprintf |
| 1051 | # if HAVE_RAW_DECL_SNPRINTF |
| 1052 | _GL_WARN_ON_USE (snprintf, "snprintf is unportable - " |
| 1053 | "use gnulib module snprintf for portability"); |
| 1054 | # endif |
| 1055 | #endif |
| 1056 | |
| 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 | |
| 1066 | #if @GNULIB_SPRINTF_POSIX@ |
| 1067 | # if @REPLACE_SPRINTF@ |
| 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, ...) |
| 1072 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3) |
| 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); |
| 1079 | #elif defined GNULIB_POSIXCHECK |
| 1080 | # undef sprintf |
| 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"); |
| 1085 | #endif |
| 1086 | |
| 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 | |
| 1106 | #if @GNULIB_VASPRINTF@ |
| 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. */ |
| 1111 | # if @REPLACE_VASPRINTF@ |
| 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, ...) |
| 1117 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3) |
| 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, ...) |
| 1125 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3) |
| 1126 | _GL_ARG_NONNULL ((1, 2))); |
| 1127 | # endif |
| 1128 | _GL_CXXALIAS_SYS (asprintf, int, |
| 1129 | (char **result, const char *format, ...)); |
| 1130 | # endif |
| 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) |
| 1138 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0) |
| 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) |
| 1146 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0) |
| 1147 | _GL_ARG_NONNULL ((1, 2))); |
| 1148 | # endif |
| 1149 | _GL_CXXALIAS_SYS (vasprintf, int, |
| 1150 | (char **result, const char *format, va_list args)); |
| 1151 | # endif |
| 1152 | _GL_CXXALIASWARN (vasprintf); |
| 1153 | #endif |
| 1154 | |
| 1155 | #if @GNULIB_VDPRINTF@ |
| 1156 | # if @REPLACE_VDPRINTF@ |
| 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) |
| 1161 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0) |
| 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) |
| 1167 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0) |
| 1168 | _GL_ARG_NONNULL ((2))); |
| 1169 | # endif |
| 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)); |
| 1174 | # endif |
| 1175 | _GL_CXXALIASWARN (vdprintf); |
| 1176 | #elif defined GNULIB_POSIXCHECK |
| 1177 | # undef vdprintf |
| 1178 | # if HAVE_RAW_DECL_VDPRINTF |
| 1179 | _GL_WARN_ON_USE (vdprintf, "vdprintf is unportable - " |
| 1180 | "use gnulib module vdprintf for portability"); |
| 1181 | # endif |
| 1182 | #endif |
| 1183 | |
| 1184 | #if @GNULIB_VFPRINTF_POSIX@ || @GNULIB_VFPRINTF@ |
| 1185 | # if (@GNULIB_VFPRINTF_POSIX@ && @REPLACE_VFPRINTF@) \ |
| 1186 | || (@GNULIB_VFPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)) |
| 1187 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 1188 | # define vfprintf rpl_vfprintf |
| 1189 | # endif |
| 1190 | # define GNULIB_overrides_vfprintf 1 |
| 1191 | # if @GNULIB_VFPRINTF_POSIX@ |
| 1192 | _GL_FUNCDECL_RPL (vfprintf, int, (FILE *fp, const char *format, va_list args) |
| 1193 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0) |
| 1194 | _GL_ARG_NONNULL ((1, 2))); |
| 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 |
| 1200 | _GL_CXXALIAS_RPL (vfprintf, int, (FILE *fp, const char *format, va_list args)); |
| 1201 | # else |
| 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)); |
| 1207 | # endif |
| 1208 | _GL_CXXALIASWARN (vfprintf); |
| 1209 | #endif |
| 1210 | #if !@GNULIB_VFPRINTF_POSIX@ && defined GNULIB_POSIXCHECK |
| 1211 | # if !GNULIB_overrides_vfprintf |
| 1212 | # undef vfprintf |
| 1213 | # endif |
| 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"); |
| 1218 | #endif |
| 1219 | |
| 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 | |
| 1239 | #if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VPRINTF@ |
| 1240 | # if (@GNULIB_VPRINTF_POSIX@ && @REPLACE_VPRINTF@) \ |
| 1241 | || (@GNULIB_VPRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@)) |
| 1242 | # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| 1243 | # define vprintf rpl_vprintf |
| 1244 | # endif |
| 1245 | # define GNULIB_overrides_vprintf 1 |
| 1246 | # if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@ |
| 1247 | _GL_FUNCDECL_RPL (vprintf, int, (const char *format, va_list args) |
| 1248 | _GL_ATTRIBUTE_FORMAT_PRINTF (1, 0) |
| 1249 | _GL_ARG_NONNULL ((1))); |
| 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 |
| 1255 | _GL_CXXALIAS_RPL (vprintf, int, (const char *format, va_list args)); |
| 1256 | # else |
| 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)); |
| 1261 | # endif |
| 1262 | _GL_CXXALIASWARN (vprintf); |
| 1263 | #endif |
| 1264 | #if !@GNULIB_VPRINTF_POSIX@ && defined GNULIB_POSIXCHECK |
| 1265 | # if !GNULIB_overrides_vprintf |
| 1266 | # undef vprintf |
| 1267 | # endif |
| 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"); |
| 1272 | #endif |
| 1273 | |
| 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 | |
| 1290 | #if @GNULIB_VSNPRINTF@ |
| 1291 | # if @REPLACE_VSNPRINTF@ |
| 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) |
| 1297 | _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0) |
| 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) |
| 1305 | _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0) |
| 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)); |
| 1310 | # endif |
| 1311 | _GL_CXXALIASWARN (vsnprintf); |
| 1312 | #elif defined GNULIB_POSIXCHECK |
| 1313 | # undef vsnprintf |
| 1314 | # if HAVE_RAW_DECL_VSNPRINTF |
| 1315 | _GL_WARN_ON_USE (vsnprintf, "vsnprintf is unportable - " |
| 1316 | "use gnulib module vsnprintf for portability"); |
| 1317 | # endif |
| 1318 | #endif |
| 1319 | |
| 1320 | #if @GNULIB_VSPRINTF_POSIX@ |
| 1321 | # if @REPLACE_VSPRINTF@ |
| 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) |
| 1327 | _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0) |
| 1328 | _GL_ARG_NONNULL ((1, 2))); |
| 1329 | _GL_CXXALIAS_RPL (vsprintf, int, |
| 1330 | (char *str, const char *format, va_list args)); |
| 1331 | # else |
| 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)); |
| 1337 | # endif |
| 1338 | _GL_CXXALIASWARN (vsprintf); |
| 1339 | #elif defined GNULIB_POSIXCHECK |
| 1340 | # undef vsprintf |
| 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"); |
| 1345 | #endif |
| 1346 | |
| 1347 | |
| 1348 | #endif /* _@GUARD_PREFIX@_STDIO_H */ |
| 1349 | #endif /* _@GUARD_PREFIX@_STDIO_H */ |
| 1350 | #endif |