1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21 
  22 /*
  23  * Copyright (c) 1989, 2010, Oracle and/or its affiliates. All rights reserved.
  24  */
  25 
  26 /*      Copyright (c) 1988 AT&T     */
  27 /*        All Rights Reserved   */
  28 
  29 /*
  30  * User-visible pieces of the ANSI C standard I/O package.
  31  */
  32 
  33 #ifndef _STDIO_H
  34 #define _STDIO_H
  35 
  36 #include <sys/feature_tests.h>
  37 
  38 #ifdef  __cplusplus
  39 extern "C" {
  40 #endif
  41 
  42 /*
  43  * Do all of our 'redefine_extname' processing before
  44  * declarations of the associated functions are seen.
  45  * This is necessary to keep gcc happy.
  46  */
  47 #if defined(__PRAGMA_REDEFINE_EXTNAME)
  48 
  49 /* large file compilation environment setup */
  50 #if !defined(_LP64) && _FILE_OFFSET_BITS == 64
  51 #pragma redefine_extname        fopen           fopen64
  52 #pragma redefine_extname        freopen         freopen64
  53 #pragma redefine_extname        tmpfile         tmpfile64
  54 #pragma redefine_extname        fgetpos         fgetpos64
  55 #pragma redefine_extname        fsetpos         fsetpos64
  56 #if defined(_LARGEFILE_SOURCE)
  57 #pragma redefine_extname        fseeko          fseeko64
  58 #pragma redefine_extname        ftello          ftello64
  59 #endif  /* _LARGEFILE_SOURCE */
  60 #endif  /* !defined(_LP64) && _FILE_OFFSET_BITS == 64 */
  61 
  62 /* In the LP64 compilation environment, all APIs are already large file */
  63 #if defined(_LP64) && defined(_LARGEFILE64_SOURCE)
  64 #pragma redefine_extname        fopen64         fopen
  65 #pragma redefine_extname        freopen64       freopen
  66 #pragma redefine_extname        tmpfile64       tmpfile
  67 #pragma redefine_extname        fgetpos64       fgetpos
  68 #pragma redefine_extname        fsetpos64       fsetpos
  69 #if defined(_LARGEFILE_SOURCE)
  70 #pragma redefine_extname        fseeko64        fseeko
  71 #pragma redefine_extname        ftello64        ftello
  72 #endif  /* _LARGEFILE_SOURCE */
  73 #endif  /* defined(_LP64) && defined(_LARGEFILE64_SOURCE) */
  74 
  75 #endif  /* __PRAGMA_REDEFINE_EXTNAME */
  76 
  77 #ifdef  __cplusplus
  78 }
  79 #endif
  80 
  81 #include <iso/stdio_iso.h>
  82 
  83 /*
  84  * If feature test macros are set that enable interfaces that use types
  85  * defined in <sys/types.h>, get those types by doing the include.
  86  *
  87  * Note that in asking for the interfaces associated with this feature test
  88  * macro one also asks for definitions of the POSIX types.
  89  */
  90 
  91 /*
  92  * Allow global visibility for symbols defined in
  93  * C++ "std" namespace in <iso/stdio_iso.h>.
  94  */
  95 #if __cplusplus >= 199711L
  96 using std::FILE;
  97 using std::size_t;
  98 using std::fpos_t;
  99 using std::remove;
 100 using std::rename;
 101 using std::tmpfile;
 102 using std::tmpnam;
 103 using std::fclose;
 104 using std::fflush;
 105 using std::fopen;
 106 using std::freopen;
 107 using std::setbuf;
 108 using std::setvbuf;
 109 using std::fprintf;
 110 using std::fscanf;
 111 using std::printf;
 112 using std::scanf;
 113 using std::sprintf;
 114 using std::sscanf;
 115 using std::vfprintf;
 116 using std::vprintf;
 117 using std::vsprintf;
 118 using std::fgetc;
 119 using std::fgets;
 120 using std::fputc;
 121 using std::fputs;
 122 using std::getc;
 123 using std::getchar;
 124 using std::gets;
 125 using std::putc;
 126 using std::putchar;
 127 using std::puts;
 128 using std::ungetc;
 129 using std::fread;
 130 using std::fwrite;
 131 using std::fgetpos;
 132 using std::fseek;
 133 using std::fsetpos;
 134 using std::ftell;
 135 using std::rewind;
 136 using std::clearerr;
 137 using std::feof;
 138 using std::ferror;
 139 using std::perror;
 140 #ifndef _LP64
 141 using std::__filbuf;
 142 using std::__flsbuf;
 143 #endif  /* _LP64 */
 144 #endif  /*  __cplusplus >= 199711L */
 145 
 146 /*
 147  * This header needs to be included here because it relies on the global
 148  * visibility of FILE and size_t in the C++ environment.
 149  */
 150 #include <iso/stdio_c99.h>
 151 
 152 #ifdef  __cplusplus
 153 extern "C" {
 154 #endif
 155 
 156 #if defined(_LARGEFILE_SOURCE) || defined(_XPG5)
 157 #ifndef _OFF_T
 158 #define _OFF_T
 159 #if defined(_LP64) || _FILE_OFFSET_BITS == 32
 160 typedef long            off_t;
 161 #else
 162 typedef __longlong_t    off_t;
 163 #endif
 164 #ifdef  _LARGEFILE64_SOURCE
 165 #ifdef _LP64
 166 typedef off_t           off64_t;
 167 #else
 168 typedef __longlong_t    off64_t;
 169 #endif
 170 #endif /* _LARGEFILE64_SOURCE */
 171 #endif /* _OFF_T */
 172 #endif /* _LARGEFILE_SOURCE */
 173 
 174 #ifdef _LARGEFILE64_SOURCE
 175 #ifdef _LP64
 176 typedef fpos_t          fpos64_t;
 177 #else
 178 typedef __longlong_t    fpos64_t;
 179 #endif
 180 #endif /* _LARGEFILE64_SOURCE */
 181 
 182 /*
 183  * XPG4 requires that va_list be defined in <stdio.h> "as described in
 184  * <stdarg.h>".  ANSI-C and POSIX require that the namespace of <stdio.h>
 185  * not be polluted with this name.
 186  */
 187 #if defined(_XPG4) && !defined(_VA_LIST)
 188 #define _VA_LIST
 189 typedef __va_list va_list;
 190 #endif  /* defined(_XPG4 && !defined(_VA_LIST) */
 191 
 192 #if defined(__EXTENSIONS__) || !defined(_STRICT_STDC) || \
 193                 defined(__XOPEN_OR_POSIX)
 194 
 195 #define L_ctermid       9
 196 
 197 /* Marked LEGACY in SUSv2 and removed in SUSv3 */
 198 #if !defined(_XPG6) || defined(__EXTENSIONS__)
 199 #define L_cuserid       9
 200 #endif
 201 
 202 #endif /* defined(__EXTENSIONS__) || !defined(_STRICT_STDC) ... */
 203 
 204 #if defined(__EXTENSIONS__) || \
 205         (!defined(_STRICT_STDC) && !defined(_POSIX_C_SOURCE)) || \
 206         defined(_XOPEN_SOURCE)
 207 
 208 #define P_tmpdir        "/var/tmp/"
 209 #endif /* defined(__EXTENSIONS__) || (!defined(_STRICT_STDC) ... */
 210 
 211 #ifndef _STDIO_ALLOCATE
 212 extern unsigned char     _sibuf[], _sobuf[];
 213 #endif
 214 
 215 /* large file compilation environment setup */
 216 #if !defined(_LP64) && _FILE_OFFSET_BITS == 64
 217 #if !defined(__PRAGMA_REDEFINE_EXTNAME)
 218 #if defined(__STDC__)
 219 extern FILE     *fopen64(const char *, const char *);
 220 extern FILE     *freopen64(const char *, const char *, FILE *);
 221 extern FILE     *tmpfile64(void);
 222 extern int      fgetpos64(FILE *, fpos_t *);
 223 extern int      fsetpos64(FILE *, const fpos_t *);
 224 #else   /* defined(__STDC__) */
 225 extern FILE     *fopen64();
 226 extern FILE     *freopen64();
 227 extern FILE     *tmpfile64();
 228 extern int      fgetpos64();
 229 extern int      fsetpos64();
 230 #endif  /* defined(__STDC__) */
 231 #define fopen                   fopen64
 232 #define freopen                 freopen64
 233 #define tmpfile                 tmpfile64
 234 #define fgetpos                 fgetpos64
 235 #define fsetpos                 fsetpos64
 236 #ifdef  _LARGEFILE_SOURCE
 237 #define fseeko                  fseeko64
 238 #define ftello                  ftello64
 239 #endif
 240 #endif  /* !__PRAGMA_REDEFINE_EXTNAME */
 241 #endif  /* !_LP64 && _FILE_OFFSET_BITS == 64 */
 242 
 243 #ifndef _LP64
 244 extern unsigned char    *_bufendtab[];
 245 extern FILE             *_lastbuf;
 246 #endif
 247 
 248 /* In the LP64 compilation environment, all APIs are already large file */
 249 #if defined(_LP64) && defined(_LARGEFILE64_SOURCE)
 250 #if !defined(__PRAGMA_REDEFINE_EXTNAME)
 251 #define fopen64         fopen
 252 #define freopen64       freopen
 253 #define tmpfile64       tmpfile
 254 #define fgetpos64       fgetpos
 255 #define fsetpos64       fsetpos
 256 #ifdef  _LARGEFILE_SOURCE
 257 #define fseeko64        fseeko
 258 #define ftello64        ftello
 259 #endif
 260 #endif  /* !__PRAGMA_REDEFINE_EXTNAME */
 261 #endif  /* _LP64 && _LARGEFILE64_SOURCE */
 262 
 263 #ifndef _SSIZE_T
 264 #define _SSIZE_T
 265 #if defined(_LP64) || defined(_I32LPx)
 266 typedef long    ssize_t;        /* size of something in bytes or -1 */
 267 #else
 268 typedef int     ssize_t;        /* (historical version) */
 269 #endif
 270 #endif  /* !_SSIZE_T */
 271 
 272 #if defined(__STDC__)
 273 
 274 #if defined(__EXTENSIONS__) || \
 275         (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
 276         defined(_REENTRANT)
 277 extern char     *tmpnam_r(char *);
 278 #endif
 279 
 280 #if defined(__EXTENSIONS__) || \
 281         (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX))
 282 extern int fcloseall(void);
 283 extern void setbuffer(FILE *, char *, size_t);
 284 extern int setlinebuf(FILE *);
 285 /* PRINTFLIKE2 */
 286 extern int asprintf(char **, const char *, ...);
 287 /* PRINTFLIKE2 */
 288 extern int vasprintf(char **, const char *, __va_list);
 289 #endif
 290 
 291 #if defined(__EXTENSIONS__) || \
 292         (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX))
 293         /* || defined(_XPG7) */
 294 extern ssize_t getdelim(char **_RESTRICT_KYWD, size_t *_RESTRICT_KYWD,
 295         int, FILE *_RESTRICT_KYWD);
 296 extern ssize_t getline(char **_RESTRICT_KYWD, size_t *_RESTRICT_KYWD,
 297         FILE *_RESTRICT_KYWD);
 298 #endif  /* __EXTENSIONS__ ... */
 299 
 300 /*
 301  * The following are known to POSIX and XOPEN, but not to ANSI-C.
 302  */
 303 #if defined(__EXTENSIONS__) || \
 304         !defined(_STRICT_STDC) || defined(__XOPEN_OR_POSIX)
 305 
 306 extern FILE     *fdopen(int, const char *);
 307 extern char     *ctermid(char *);
 308 extern int      fileno(FILE *);
 309 
 310 #endif  /* defined(__EXTENSIONS__) || !defined(_STRICT_STDC) ... */
 311 
 312 /*
 313  * The following are known to POSIX.1c, but not to ANSI-C or XOPEN.
 314  */
 315 #if defined(__EXTENSIONS__) || defined(_REENTRANT) || \
 316         (_POSIX_C_SOURCE - 0 >= 199506L)
 317 extern void     flockfile(FILE *);
 318 extern int      ftrylockfile(FILE *);
 319 extern void     funlockfile(FILE *);
 320 extern int      getc_unlocked(FILE *);
 321 extern int      getchar_unlocked(void);
 322 extern int      putc_unlocked(int, FILE *);
 323 extern int      putchar_unlocked(int);
 324 
 325 #endif  /* defined(__EXTENSIONS__) || defined(_REENTRANT).. */
 326 
 327 /*
 328  * The following are known to XOPEN, but not to ANSI-C or POSIX.
 329  */
 330 #if defined(__EXTENSIONS__) || !defined(_STRICT_STDC) || \
 331         defined(_XOPEN_SOURCE)
 332 extern FILE     *popen(const char *, const char *);
 333 extern char     *tempnam(const char *, const char *);
 334 extern int      pclose(FILE *);
 335 #if !defined(_XOPEN_SOURCE)
 336 extern int      getsubopt(char **, char *const *, char **);
 337 #endif /* !defined(_XOPEN_SOURCE) */
 338 
 339 /* Marked LEGACY in SUSv2 and removed in SUSv3 */
 340 #if !defined(_XPG6) || defined(__EXTENSIONS__)
 341 extern char     *cuserid(char *);
 342 extern int      getopt(int, char *const *, const char *);
 343 extern char     *optarg;
 344 extern int      optind, opterr, optopt;
 345 extern int      getw(FILE *);
 346 extern int      putw(int, FILE *);
 347 #endif /* !defined(_XPG6) || defined(__EXTENSIONS__) */
 348 
 349 #endif  /* defined(__EXTENSIONS__) || !defined(_STRICT_STDC) ... */
 350 
 351 /*
 352  * The following are defined as part of the Large File Summit interfaces.
 353  */
 354 #if defined(_LARGEFILE_SOURCE) || defined(_XPG5)
 355 extern int      fseeko(FILE *, off_t, int);
 356 extern off_t    ftello(FILE *);
 357 #endif
 358 
 359 /*
 360  * The following are defined as part of the transitional Large File Summit
 361  * interfaces.
 362  */
 363 #if defined(_LARGEFILE64_SOURCE) && !((_FILE_OFFSET_BITS == 64) && \
 364             !defined(__PRAGMA_REDEFINE_EXTNAME))
 365 extern FILE     *fopen64(const char *, const char *);
 366 extern FILE     *freopen64(const char *, const char *, FILE *);
 367 extern FILE     *tmpfile64(void);
 368 extern int      fgetpos64(FILE *, fpos64_t *);
 369 extern int      fsetpos64(FILE *, const fpos64_t *);
 370 extern int      fseeko64(FILE *, off64_t, int);
 371 extern off64_t  ftello64(FILE *);
 372 #endif
 373 
 374 #else   /* !defined __STDC__ */
 375 
 376 #ifndef _LP64
 377 #define _bufend(p)      ((fileno(p) < _NFILE) ? _bufendtab[fileno(p)] : \
 378                         (unsigned char *)_realbufend(p))
 379 #define _bufsiz(p)      (_bufend(p) - (p)->_base)
 380 #endif  /*      _LP64   */
 381 
 382 #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) || \
 383         defined(_REENTRANT)
 384 extern char     *tmpnam_r();
 385 #endif
 386 
 387 #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)
 388 extern int fcloseall();
 389 extern void setbuffer();
 390 extern int setlinebuf();
 391 extern int asprintf();
 392 extern int vasprintf();
 393 #endif
 394 
 395 #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)
 396         /* || defined(_XPG7) */
 397 extern ssize_t getdelim();
 398 extern ssize_t getline();
 399 #endif  /* __EXTENSIONS__ ... */
 400 
 401 #if defined(__EXTENSIONS__) || defined(__XOPEN_OR_POSIX)
 402 extern FILE     *fdopen();
 403 extern char     *ctermid();
 404 extern int      fileno();
 405 #endif  /* defined(__EXTENSIONS__) || defined(__XOPEN_OR_POSIX) */
 406 
 407 #if defined(__EXTENSIONS__) || defined(_REENTRANT) || \
 408             (_POSIX_C_SOURCE - 0 >= 199506L)
 409 extern void     flockfile();
 410 extern int      ftrylockfile();
 411 extern void     funlockfile();
 412 extern int      getc_unlocked();
 413 extern int      getchar_unlocked();
 414 extern int      putc_unlocked();
 415 extern int      putchar_unlocked();
 416 #endif  /* defined(__EXTENSIONS__) || defined(_REENTRANT).. */
 417 
 418 #if defined(__EXTENSIONS__) || defined(_XOPEN_SOURCE)
 419 extern FILE     *popen();
 420 extern char     *tempnam();
 421 extern int      pclose();
 422 
 423 #if !defined(_XOPEN_SOURCE)
 424 extern int      getsubopt();
 425 #endif /* !defined(_XOPEN_SOURCE) */
 426 
 427 #if !defined(_XPG6) || defined(__EXTENSIONS__)
 428 extern char     *cuserid();
 429 extern int      getopt();
 430 extern char     *optarg;
 431 extern int      optind, opterr, optopt;
 432 extern int      getw();
 433 extern int      putw();
 434 #endif /* !defined(_XPG6) || defined(__EXTENSIONS__) */
 435 
 436 #endif  /* defined(__EXTENSIONS__) || defined(_XOPEN_SOURCE) */
 437 
 438 #if defined(_LARGEFILE_SOURCE) || defined(_XPG5)
 439 extern int      fseeko();
 440 extern off_t    ftello();
 441 #endif
 442 
 443 #if defined(_LARGEFILE64_SOURCE) && !((_FILE_OFFSET_BITS == 64) && \
 444             !defined(__PRAGMA_REDEFINE_EXTNAME))
 445 extern FILE     *fopen64();
 446 extern FILE     *freopen64();
 447 extern FILE     *tmpfile64();
 448 extern int      fgetpos64();
 449 extern int      fsetpos64();
 450 extern int      fseeko64();
 451 extern off64_t  ftello64();
 452 #endif
 453 
 454 #endif  /* __STDC__ */
 455 
 456 #if !defined(__lint)
 457 
 458 #if defined(__EXTENSIONS__) || defined(_REENTRANT) || \
 459             (_POSIX_C_SOURCE - 0 >= 199506L)
 460 #ifndef _LP64
 461 #ifdef  __STDC__
 462 #define getc_unlocked(p)        (--(p)->_cnt < 0 \
 463                                         ? __filbuf(p) \
 464                                         : (int)*(p)->_ptr++)
 465 #define putc_unlocked(x, p)     (--(p)->_cnt < 0 \
 466                                         ? __flsbuf((x), (p)) \
 467                                         : (int)(*(p)->_ptr++ = \
 468                                         (unsigned char) (x)))
 469 #else
 470 #define getc_unlocked(p)        (--(p)->_cnt < 0 \
 471                                         ? _filbuf(p) \
 472                                         : (int)*(p)->_ptr++)
 473 #define putc_unlocked(x, p)     (--(p)->_cnt < 0 \
 474                                         ? _flsbuf((x), (p)) \
 475                                         : (int)(*(p)->_ptr++ = \
 476                                         (unsigned char) (x)))
 477 #endif  /* __STDC__ */
 478 #endif  /* _LP64 */
 479 #define getchar_unlocked()      getc_unlocked(stdin)
 480 #define putchar_unlocked(x)     putc_unlocked((x), stdout)
 481 #endif  /* defined(__EXTENSIONS__) || defined(_REENTRANT).. */
 482 
 483 #endif  /* !defined(__lint) */
 484 
 485 #ifdef  __cplusplus
 486 }
 487 #endif
 488 
 489 #endif  /* _STDIO_H */