perlio.c

   1 /*
   2  * perlio.c Copyright (c) 1996-2006, Nick Ing-Simmons You may distribute
   3  * under the terms of either the GNU General Public License or the
   4  * Artistic License, as specified in the README file.
   5  */
   6
   7 /*
   8  * Hour after hour for nearly three weary days he had jogged up and down,
   9  * over passes, and through long dales, and across many streams.
  10  */
  11
  12 /* This file contains the functions needed to implement PerlIO, which
  13  * is Perl's private replacement for the C stdio library. This is used
  14  * by default unless you compile with -Uuseperlio or run with
  15  * PERLIO=:stdio (but don't do this unless you know what you're doing)
  16  */
  17
  18 /*
  19  * If we have ActivePerl-like PERL_IMPLICIT_SYS then we need a dTHX to get
  20  * at the dispatch tables, even when we do not need it for other reasons.
  21  * Invent a dSYS macro to abstract this out
  22  */
  23 #ifdef PERL_IMPLICIT_SYS
  24 #define dSYS dTHX
  25 #else
  26 #define dSYS dNOOP
  27 #endif
  28
  29 #define VOIDUSED 1
  30 #ifdef PERL_MICRO
  31 #   include "uconfig.h"
  32 #else
  33 #   include "config.h"
  34 #endif
  35
  36 #define PERLIO_NOT_STDIO 0
  37 #if !defined(PERLIO_IS_STDIO) && !defined(USE_SFIO)
  38 /*
  39  * #define PerlIO FILE
  40  */
  41 #endif
  42 /*
  43  * This file provides those parts of PerlIO abstraction
  44  * which are not #defined in perlio.h.
  45  * Which these are depends on various Configure #ifdef's
  46  */
  47
  48 #include "EXTERN.h"
  49 #define PERL_IN_PERLIO_C
  50 #include "perl.h"
  51
  52 #ifdef PERL_IMPLICIT_CONTEXT
  53 #undef dSYS
  54 #define dSYS dTHX
  55 #endif
  56
  57 #include "XSUB.h"
  58
  59 #ifdef __Lynx__
  60 /* Missing proto on LynxOS */
  61 int mkstemp(char*);
  62 #endif
  63
  64 /* Call the callback or PerlIOBase, and return failure. */
  65 #define Perl_PerlIO_or_Base(f, callback, base, failure, args)   \
  66         if (PerlIOValid(f)) {                                   \
  67                 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;\
  68                 if (tab && tab->callback)                       \
  69                         return (*tab->callback) args;           \
  70                 else                                            \
  71                         return PerlIOBase_ ## base args;        \
  72         }                                                       \
  73         else                                                    \
  74                 SETERRNO(EBADF, SS_IVCHAN);                     \
  75         return failure
  76
  77 /* Call the callback or fail, and return failure. */
  78 #define Perl_PerlIO_or_fail(f, callback, failure, args)         \
  79         if (PerlIOValid(f)) {                                   \
  80                 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;\
  81                 if (tab && tab->callback)                       \
  82                         return (*tab->callback) args;           \
  83                 SETERRNO(EINVAL, LIB_INVARG);                   \
  84         }                                                       \
  85         else                                                    \
  86                 SETERRNO(EBADF, SS_IVCHAN);                     \
  87         return failure
  88
  89 /* Call the callback or PerlIOBase, and be void. */
  90 #define Perl_PerlIO_or_Base_void(f, callback, base, args)       \
  91         if (PerlIOValid(f)) {                                   \
  92                 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;\
  93                 if (tab && tab->callback)                       \
  94                         (*tab->callback) args;                  \
  95                 else                                            \
  96                         PerlIOBase_ ## base args;               \
  97         }                                                       \
  98         else                                                    \
  99                 SETERRNO(EBADF, SS_IVCHAN)
 100
 101 /* Call the callback or fail, and be void. */
 102 #define Perl_PerlIO_or_fail_void(f, callback, args)             \
 103         if (PerlIOValid(f)) {                                   \
 104                 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;\
 105                 if (tab && tab->callback)                       \
 106                         (*tab->callback) args;                  \
 107                 else                                            \
 108                         SETERRNO(EINVAL, LIB_INVARG);           \
 109         }                                                       \
 110         else                                                    \
 111                 SETERRNO(EBADF, SS_IVCHAN)
 112
 113 #ifndef USE_SFIO
 114 int
 115 perlsio_binmode(FILE *fp, int iotype, int mode)
 116 {
 117     /*
 118      * This used to be contents of do_binmode in doio.c
 119      */
 120 #ifdef DOSISH
 121 #  if defined(atarist) || defined(__MINT__)
 122     if (!fflush(fp)) {
 123         if (mode & O_BINARY)
 124             ((FILE *) fp)->_flag |= _IOBIN;
 125         else
 126             ((FILE *) fp)->_flag &= ~_IOBIN;
 127         return 1;
 128     }
 129     return 0;
 130 #  else
 131     dTHX;
 132 #ifdef NETWARE
 133     if (PerlLIO_setmode(fp, mode) != -1) {
 134 #else
 135     if (PerlLIO_setmode(fileno(fp), mode) != -1) {
 136 #endif
 137 #    if defined(WIN32) && defined(__BORLANDC__)
 138         /*
 139          * The translation mode of the stream is maintained independent
 140 of
 141          * the translation mode of the fd in the Borland RTL (heavy
 142          * digging through their runtime sources reveal).  User has to
 143 set
 144          * the mode explicitly for the stream (though they don't
 145 document
 146          * this anywhere). GSAR 97-5-24
 147          */
 148         fseek(fp, 0L, 0);
 149         if (mode & O_BINARY)
 150             fp->flags |= _F_BIN;
 151         else
 152             fp->flags &= ~_F_BIN;
 153 #    endif
 154         return 1;
 155     }
 156     else
 157         return 0;
 158 #  endif
 159 #else
 160 #  if defined(USEMYBINMODE)
 161     dTHX;
 162     if (my_binmode(fp, iotype, mode) != FALSE)
 163         return 1;
 164     else
 165         return 0;
 166 #  else
 167     PERL_UNUSED_ARG(fp);
 168     PERL_UNUSED_ARG(iotype);
 169     PERL_UNUSED_ARG(mode);
 170     return 1;
 171 #  endif
 172 #endif
 173 }
 174 #endif /* sfio */
 175
 176 #ifndef O_ACCMODE
 177 #define O_ACCMODE 3             /* Assume traditional implementation */
 178 #endif
 179
 180 int
 181 PerlIO_intmode2str(int rawmode, char *mode, int *writing)
 182 {
 183     const int result = rawmode & O_ACCMODE;
 184     int ix = 0;
 185     int ptype;
 186     switch (result) {
 187     case O_RDONLY:
 188         ptype = IoTYPE_RDONLY;
 189         break;
 190     case O_WRONLY:
 191         ptype = IoTYPE_WRONLY;
 192         break;
 193     case O_RDWR:
 194     default:
 195         ptype = IoTYPE_RDWR;
 196         break;
 197     }
 198     if (writing)
 199         *writing = (result != O_RDONLY);
 200
 201     if (result == O_RDONLY) {
 202         mode[ix++] = 'r';
 203     }
 204 #ifdef O_APPEND
 205     else if (rawmode & O_APPEND) {
 206         mode[ix++] = 'a';
 207         if (result != O_WRONLY)
 208             mode[ix++] = '+';
 209     }
 210 #endif
 211     else {
 212         if (result == O_WRONLY)
 213             mode[ix++] = 'w';
 214         else {
 215             mode[ix++] = 'r';
 216             mode[ix++] = '+';
 217         }
 218     }
 219     if (rawmode & O_BINARY)
 220         mode[ix++] = 'b';
 221     mode[ix] = '\0';
 222     return ptype;
 223 }
 224
 225 #ifndef PERLIO_LAYERS
 226 int
 227 PerlIO_apply_layers(pTHX_ PerlIO *f, const char *mode, const char *names)
 228 {
 229     if (!names || !*names
 230         || strEQ(names, ":crlf")
 231         || strEQ(names, ":raw")
 232         || strEQ(names, ":bytes")
 233        ) {
 234         return 0;
 235     }
 236     Perl_croak(aTHX_ "Cannot apply \"%s\" in non-PerlIO perl", names);
 237     /*
 238      * NOTREACHED
 239      */
 240     return -1;
 241 }
 242
 243 void
 244 PerlIO_destruct(pTHX)
 245 {
 246 }
 247
 248 int
 249 PerlIO_binmode(pTHX_ PerlIO *fp, int iotype, int mode, const char *names)
 250 {
 251 #ifdef USE_SFIO
 252     PERL_UNUSED_ARG(iotype);
 253     PERL_UNUSED_ARG(mode);
 254     PERL_UNUSED_ARG(names);
 255     return 1;
 256 #else
 257     return perlsio_binmode(fp, iotype, mode);
 258 #endif
 259 }
 260
 261 PerlIO *
 262 PerlIO_fdupopen(pTHX_ PerlIO *f, CLONE_PARAMS *param, int flags)
 263 {
 264 #if defined(PERL_MICRO) || defined(__SYMBIAN32__)
 265     return NULL;
 266 #else
 267 #ifdef PERL_IMPLICIT_SYS
 268     return PerlSIO_fdupopen(f);
 269 #else
 270 #ifdef WIN32
 271     return win32_fdupopen(f);
 272 #else
 273     if (f) {
 274         const int fd = PerlLIO_dup(PerlIO_fileno(f));
 275         if (fd >= 0) {
 276             char mode[8];
 277 #ifdef DJGPP
 278             const int omode = djgpp_get_stream_mode(f);
 279 #else
 280             const int omode = fcntl(fd, F_GETFL);
 281 #endif
 282             PerlIO_intmode2str(omode,mode,NULL);
 283             /* the r+ is a hack */
 284             return PerlIO_fdopen(fd, mode);
 285         }
 286         return NULL;
 287     }
 288     else {
 289         SETERRNO(EBADF, SS_IVCHAN);
 290     }
 291 #endif
 292     return NULL;
 293 #endif
 294 #endif
 295 }
 296
 297
 298 /*
 299  * De-mux PerlIO_openn() into fdopen, freopen and fopen type entries
 300  */
 301
 302 PerlIO *
 303 PerlIO_openn(pTHX_ const char *layers, const char *mode, int fd,
 304              int imode, int perm, PerlIO *old, int narg, SV **args)
 305 {
 306     if (narg) {
 307         if (narg > 1) {
 308             Perl_croak(aTHX_ "More than one argument to open");
 309         }
 310         if (*args == &PL_sv_undef)
 311             return PerlIO_tmpfile();
 312         else {
 313             const char *name = SvPV_nolen_const(*args);
 314             if (*mode == IoTYPE_NUMERIC) {
 315                 fd = PerlLIO_open3(name, imode, perm);
 316                 if (fd >= 0)
 317                     return PerlIO_fdopen(fd, mode + 1);
 318             }
 319             else if (old) {
 320                 return PerlIO_reopen(name, mode, old);
 321             }
 322             else {
 323                 return PerlIO_open(name, mode);
 324             }
 325         }
 326     }
 327     else {
 328         return PerlIO_fdopen(fd, (char *) mode);
 329     }
 330     return NULL;
 331 }
 332
 333 XS(XS_PerlIO__Layer__find)
 334 {
 335     dXSARGS;
 336     if (items < 2)
 337         Perl_croak(aTHX_ "Usage class->find(name[,load])");
 338     else {
 339         const char * const name = SvPV_nolen_const(ST(1));
 340         ST(0) = (strEQ(name, "crlf")
 341                  || strEQ(name, "raw")) ? &PL_sv_yes : &PL_sv_undef;
 342         XSRETURN(1);
 343     }
 344 }
 345
 346
 347 void
 348 Perl_boot_core_PerlIO(pTHX)
 349 {
 350     newXS("PerlIO::Layer::find", XS_PerlIO__Layer__find, __FILE__);
 351 }
 352
 353 #endif
 354
 355
 356 #ifdef PERLIO_IS_STDIO
 357
 358 void
 359 PerlIO_init(pTHX)
 360 {
 361     /*
 362      * Does nothing (yet) except force this file to be included in perl
 363      * binary. That allows this file to force inclusion of other functions
 364      * that may be required by loadable extensions e.g. for
 365      * FileHandle::tmpfile
 366      */
 367 }
 368
 369 #undef PerlIO_tmpfile
 370 PerlIO *
 371 PerlIO_tmpfile(void)
 372 {
 373     return tmpfile();
 374 }
 375
 376 #else                           /* PERLIO_IS_STDIO */
 377
 378 #ifdef USE_SFIO
 379
 380 #undef HAS_FSETPOS
 381 #undef HAS_FGETPOS
 382
 383 /*
 384  * This section is just to make sure these functions get pulled in from
 385  * libsfio.a
 386  */
 387
 388 #undef PerlIO_tmpfile
 389 PerlIO *
 390 PerlIO_tmpfile(void)
 391 {
 392     return sftmp(0);
 393 }
 394
 395 void
 396 PerlIO_init(pTHX)
 397 {
 398     /*
 399      * Force this file to be included in perl binary. Which allows this
 400      * file to force inclusion of other functions that may be required by
 401      * loadable extensions e.g. for FileHandle::tmpfile
 402      */
 403
 404     /*
 405      * Hack sfio does its own 'autoflush' on stdout in common cases. Flush
 406      * results in a lot of lseek()s to regular files and lot of small
 407      * writes to pipes.
 408      */
 409     sfset(sfstdout, SF_SHARE, 0);
 410 }
 411
 412 /* This is not the reverse of PerlIO_exportFILE(), PerlIO_releaseFILE() is. */
 413 PerlIO *
 414 PerlIO_importFILE(FILE *stdio, const char *mode)
 415 {
 416     const int fd = fileno(stdio);
 417     if (!mode || !*mode) {
 418         mode = "r+";
 419     }
 420     return PerlIO_fdopen(fd, mode);
 421 }
 422
 423 FILE *
 424 PerlIO_findFILE(PerlIO *pio)
 425 {
 426     const int fd = PerlIO_fileno(pio);
 427     FILE * const f = fdopen(fd, "r+");
 428     PerlIO_flush(pio);
 429     if (!f && errno == EINVAL)
 430         f = fdopen(fd, "w");
 431     if (!f && errno == EINVAL)
 432         f = fdopen(fd, "r");
 433     return f;
 434 }
 435
 436
 437 #else                           /* USE_SFIO */
 438 /*======================================================================================*/
 439 /*
 440  * Implement all the PerlIO interface ourselves.
 441  */
 442
 443 #include "perliol.h"
 444
 445 /*
 446  * We _MUST_ have <unistd.h> if we are using lseek() and may have large
 447  * files
 448  */
 449 #ifdef I_UNISTD
 450 #include <unistd.h>
 451 #endif
 452 #ifdef HAS_MMAP
 453 #include <sys/mman.h>
 454 #endif
 455
 456 void
 457 PerlIO_debug(const char *fmt, ...)
 458 {
 459     va_list ap;
 460     dSYS;
 461     va_start(ap, fmt);
 462     if (!PL_perlio_debug_fd && !PL_tainting && PL_uid == PL_euid && PL_gid == PL_egid) {
 463         const char * const s = PerlEnv_getenv("PERLIO_DEBUG");
 464         if (s && *s)
 465             PL_perlio_debug_fd = PerlLIO_open3(s, O_WRONLY | O_CREAT | O_APPEND, 0666);
 466         else
 467             PL_perlio_debug_fd = -1;
 468     }
 469     if (PL_perlio_debug_fd > 0) {
 470         dTHX;
 471 #ifdef USE_ITHREADS
 472         const char * const s = CopFILE(PL_curcop);
 473         /* Use fixed buffer as sv_catpvf etc. needs SVs */
 474         char buffer[1024];
 475         const STRLEN len = my_sprintf(buffer, "%.40s:%" IVdf " ", s ? s : "(none)", (IV) CopLINE(PL_curcop));
 476         const STRLEN len2 = vsprintf(buffer+len, fmt, ap);
 477         PerlLIO_write(PL_perlio_debug_fd, buffer, len + len2);
 478 #else
 479         const char *s = CopFILE(PL_curcop);
 480         STRLEN len;
 481         SV * const sv = newSVpvs("");
 482         Perl_sv_catpvf(aTHX_ sv, "%s:%" IVdf " ", s ? s : "(none)",
 483                        (IV) CopLINE(PL_curcop));
 484         Perl_sv_vcatpvf(aTHX_ sv, fmt, &ap);
 485
 486         s = SvPV_const(sv, len);
 487         PerlLIO_write(PL_perlio_debug_fd, s, len);
 488         SvREFCNT_dec(sv);
 489 #endif
 490     }
 491     va_end(ap);
 492 }
 493
 494 /*--------------------------------------------------------------------------------------*/
 495
 496 /*
 497  * Inner level routines
 498  */
 499
 500 /*
 501  * Table of pointers to the PerlIO structs (malloc'ed)
 502  */
 503 #define PERLIO_TABLE_SIZE 64
 504
 505 PerlIO *
 506 PerlIO_allocate(pTHX)
 507 {
 508     dVAR;
 509     /*
 510      * Find a free slot in the table, allocating new table as necessary
 511      */
 512     PerlIO **last;
 513     PerlIO *f;
 514     last = &PL_perlio;
 515     while ((f = *last)) {
 516         int i;
 517         last = (PerlIO **) (f);
 518         for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
 519             if (!*++f) {
 520                 return f;
 521             }
 522         }
 523     }
 524     Newxz(f,PERLIO_TABLE_SIZE,PerlIO);
 525     if (!f) {
 526         return NULL;
 527     }
 528     *last = f;
 529     return f + 1;
 530 }
 531
 532 #undef PerlIO_fdupopen
 533 PerlIO *
 534 PerlIO_fdupopen(pTHX_ PerlIO *f, CLONE_PARAMS *param, int flags)
 535 {
 536     if (PerlIOValid(f)) {
 537         const PerlIO_funcs * const tab = PerlIOBase(f)->tab;
 538         PerlIO_debug("fdupopen f=%p param=%p\n",(void*)f,(void*)param);
 539         if (tab && tab->Dup)
 540              return (*tab->Dup)(aTHX_ PerlIO_allocate(aTHX), f, param, flags);
 541         else {
 542              return PerlIOBase_dup(aTHX_ PerlIO_allocate(aTHX), f, param, flags);
 543         }
 544     }
 545     else
 546          SETERRNO(EBADF, SS_IVCHAN);
 547
 548     return NULL;
 549 }
 550
 551 void
 552 PerlIO_cleantable(pTHX_ PerlIO **tablep)
 553 {
 554     PerlIO * const table = *tablep;
 555     if (table) {
 556         int i;
 557         PerlIO_cleantable(aTHX_(PerlIO **) & (table[0]));
 558         for (i = PERLIO_TABLE_SIZE - 1; i > 0; i--) {
 559             PerlIO * const f = table + i;
 560             if (*f) {
 561                 PerlIO_close(f);
 562             }
 563         }
 564         Safefree(table);
 565         *tablep = NULL;
 566     }
 567 }
 568
 569
 570 PerlIO_list_t *
 571 PerlIO_list_alloc(pTHX)
 572 {
 573     PerlIO_list_t *list;
 574     Newxz(list, 1, PerlIO_list_t);
 575     list->refcnt = 1;
 576     return list;
 577 }
 578
 579 void
 580 PerlIO_list_free(pTHX_ PerlIO_list_t *list)
 581 {
 582     if (list) {
 583         if (--list->refcnt == 0) {
 584             if (list->array) {
 585                 IV i;
 586                 for (i = 0; i < list->cur; i++) {
 587                     if (list->array[i].arg)
 588                         SvREFCNT_dec(list->array[i].arg);
 589                 }
 590                 Safefree(list->array);
 591             }
 592             Safefree(list);
 593         }
 594     }
 595 }
 596
 597 void
 598 PerlIO_list_push(pTHX_ PerlIO_list_t *list, PerlIO_funcs *funcs, SV *arg)
 599 {
 600     dVAR;
 601     PerlIO_pair_t *p;
 602     if (list->cur >= list->len) {
 603         list->len += 8;
 604         if (list->array)
 605             Renew(list->array, list->len, PerlIO_pair_t);
 606         else
 607             Newx(list->array, list->len, PerlIO_pair_t);
 608     }
 609     p = &(list->array[list->cur++]);
 610     p->funcs = funcs;
 611     if ((p->arg = arg)) {
 612         (void)SvREFCNT_inc(arg);
 613     }
 614 }
 615
 616 PerlIO_list_t *
 617 PerlIO_clone_list(pTHX_ PerlIO_list_t *proto, CLONE_PARAMS *param)
 618 {
 619     PerlIO_list_t *list = (PerlIO_list_t *) NULL;
 620     if (proto) {
 621         int i;
 622         list = PerlIO_list_alloc(aTHX);
 623         for (i=0; i < proto->cur; i++) {
 624             SV *arg = NULL;
 625             if (proto->array[i].arg)
 626                 arg = PerlIO_sv_dup(aTHX_ proto->array[i].arg,param);
 627             PerlIO_list_push(aTHX_ list, proto->array[i].funcs, arg);
 628         }
 629     }
 630     return list;
 631 }
 632
 633 void
 634 PerlIO_clone(pTHX_ PerlInterpreter *proto, CLONE_PARAMS *param)
 635 {
 636 #ifdef USE_ITHREADS
 637     PerlIO **table = &proto->Iperlio;
 638     PerlIO *f;
 639     PL_perlio = NULL;
 640     PL_known_layers = PerlIO_clone_list(aTHX_ proto->Iknown_layers, param);
 641     PL_def_layerlist = PerlIO_clone_list(aTHX_ proto->Idef_layerlist, param);
 642     PerlIO_allocate(aTHX); /* root slot is never used */
 643     PerlIO_debug("Clone %p from %p\n",aTHX,proto);
 644     while ((f = *table)) {
 645             int i;
 646             table = (PerlIO **) (f++);
 647             for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
 648                 if (*f) {
 649                     (void) fp_dup(f, 0, param);
 650                 }
 651                 f++;
 652             }
 653         }
 654 #else
 655     PERL_UNUSED_ARG(proto);
 656     PERL_UNUSED_ARG(param);
 657 #endif
 658 }
 659
 660 void
 661 PerlIO_destruct(pTHX)
 662 {
 663     dVAR;
 664     PerlIO **table = &PL_perlio;
 665     PerlIO *f;
 666 #ifdef USE_ITHREADS
 667     PerlIO_debug("Destruct %p\n",aTHX);
 668 #endif
 669     while ((f = *table)) {
 670         int i;
 671         table = (PerlIO **) (f++);
 672         for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
 673             PerlIO *x = f;
 674             const PerlIOl *l;
 675             while ((l = *x)) {
 676                 if (l->tab->kind & PERLIO_K_DESTRUCT) {
 677                     PerlIO_debug("Destruct popping %s\n", l->tab->name);
 678                     PerlIO_flush(x);
 679                     PerlIO_pop(aTHX_ x);
 680                 }
 681                 else {
 682                     x = PerlIONext(x);
 683                 }
 684             }
 685             f++;
 686         }
 687     }
 688 }
 689
 690 void
 691 PerlIO_pop(pTHX_ PerlIO *f)
 692 {
 693     const PerlIOl *l = *f;
 694     if (l) {
 695         PerlIO_debug("PerlIO_pop f=%p %s\n", (void*)f, l->tab->name);
 696         if (l->tab->Popped) {
 697             /*
 698              * If popped returns non-zero do not free its layer structure
 699              * it has either done so itself, or it is shared and still in
 700              * use
 701              */
 702             if ((*l->tab->Popped) (aTHX_ f) != 0)
 703                 return;
 704         }
 705         *f = l->next;
 706         Safefree(l);
 707     }
 708 }
 709
 710 /* Return as an array the stack of layers on a filehandle.  Note that
 711  * the stack is returned top-first in the array, and there are three
 712  * times as many array elements as there are layers in the stack: the
 713  * first element of a layer triplet is the name, the second one is the
 714  * arguments, and the third one is the flags. */
 715
 716 AV *
 717 PerlIO_get_layers(pTHX_ PerlIO *f)
 718 {
 719     dVAR;
 720     AV * const av = newAV();
 721
 722     if (PerlIOValid(f)) {
 723         PerlIOl *l = PerlIOBase(f);
 724
 725         while (l) {
 726             SV * const name = l->tab && l->tab->name ?
 727             newSVpv(l->tab->name, 0) : &PL_sv_undef;
 728             SV * const arg = l->tab && l->tab->Getarg ?
 729             (*l->tab->Getarg)(aTHX_ &l, 0, 0) : &PL_sv_undef;
 730             av_push(av, name);
 731             av_push(av, arg);
 732             av_push(av, newSViv((IV)l->flags));
 733             l = l->next;
 734         }
 735     }
 736
 737     return av;
 738 }
 739
 740 /*--------------------------------------------------------------------------------------*/
 741 /*
 742  * XS Interface for perl code
 743  */
 744
 745 PerlIO_funcs *
 746 PerlIO_find_layer(pTHX_ const char *name, STRLEN len, int load)
 747 {
 748     dVAR;
 749     IV i;
 750     if ((SSize_t) len <= 0)
 751         len = strlen(name);
 752     for (i = 0; i < PL_known_layers->cur; i++) {
 753         PerlIO_funcs * const f = PL_known_layers->array[i].funcs;
 754         if (memEQ(f->name, name, len) && f->name[len] == 0) {
 755             PerlIO_debug("%.*s => %p\n", (int) len, name, (void*)f);
 756             return f;
 757         }
 758     }
 759     if (load && PL_subname && PL_def_layerlist
 760         && PL_def_layerlist->cur >= 2) {
 761         if (PL_in_load_module) {
 762             Perl_croak(aTHX_ "Recursive call to Perl_load_module in PerlIO_find_layer");
 763             return NULL;
 764         } else {
 765             SV * const pkgsv = newSVpvs("PerlIO");
 766             SV * const layer = newSVpvn(name, len);
 767             CV * const cv    = get_cv("PerlIO::Layer::NoWarnings", FALSE);
 768             ENTER;
 769             SAVEINT(PL_in_load_module);
 770             if (cv) {
 771                 SAVEGENERICSV(PL_warnhook);
 772                 (void)SvREFCNT_inc(cv);
 773                 PL_warnhook = (SV *) cv;
 774             }
 775             PL_in_load_module++;
 776             /*
 777              * The two SVs are magically freed by load_module
 778              */
 779             Perl_load_module(aTHX_ 0, pkgsv, NULL, layer, NULL);
 780             PL_in_load_module--;
 781             LEAVE;
 782             return PerlIO_find_layer(aTHX_ name, len, 0);
 783         }
 784     }
 785     PerlIO_debug("Cannot find %.*s\n", (int) len, name);
 786     return NULL;
 787 }
 788
 789 #ifdef USE_ATTRIBUTES_FOR_PERLIO
 790
 791 static int
 792 perlio_mg_set(pTHX_ SV *sv, MAGIC *mg)
 793 {
 794     if (SvROK(sv)) {
 795         IO * const io = GvIOn((GV *) SvRV(sv));
 796         PerlIO * const ifp = IoIFP(io);
 797         PerlIO * const ofp = IoOFP(io);
 798         Perl_warn(aTHX_ "set %" SVf " %p %p %p", sv, io, ifp, ofp);
 799     }
 800     return 0;
 801 }
 802
 803 static int
 804 perlio_mg_get(pTHX_ SV *sv, MAGIC *mg)
 805 {
 806     if (SvROK(sv)) {
 807         IO * const io = GvIOn((GV *) SvRV(sv));
 808         PerlIO * const ifp = IoIFP(io);
 809         PerlIO * const ofp = IoOFP(io);
 810         Perl_warn(aTHX_ "get %" SVf " %p %p %p", sv, io, ifp, ofp);
 811     }
 812     return 0;
 813 }
 814
 815 static int
 816 perlio_mg_clear(pTHX_ SV *sv, MAGIC *mg)
 817 {
 818     Perl_warn(aTHX_ "clear %" SVf, sv);
 819     return 0;
 820 }
 821
 822 static int
 823 perlio_mg_free(pTHX_ SV *sv, MAGIC *mg)
 824 {
 825     Perl_warn(aTHX_ "free %" SVf, sv);
 826     return 0;
 827 }
 828
 829 MGVTBL perlio_vtab = {
 830     perlio_mg_get,
 831     perlio_mg_set,
 832     NULL,                       /* len */
 833     perlio_mg_clear,
 834     perlio_mg_free
 835 };
 836
 837 XS(XS_io_MODIFY_SCALAR_ATTRIBUTES)
 838 {
 839     dXSARGS;
 840     SV * const sv = SvRV(ST(1));
 841     AV * const av = newAV();
 842     MAGIC *mg;
 843     int count = 0;
 844     int i;
 845     sv_magic(sv, (SV *) av, PERL_MAGIC_ext, NULL, 0);
 846     SvRMAGICAL_off(sv);
 847     mg = mg_find(sv, PERL_MAGIC_ext);
 848     mg->mg_virtual = &perlio_vtab;
 849     mg_magical(sv);
 850     Perl_warn(aTHX_ "attrib %" SVf, sv);
 851     for (i = 2; i < items; i++) {
 852         STRLEN len;
 853         const char * const name = SvPV_const(ST(i), len);
 854         SV * const layer = PerlIO_find_layer(aTHX_ name, len, 1);
 855         if (layer) {
 856             av_push(av, SvREFCNT_inc(layer));
 857         }
 858         else {
 859             ST(count) = ST(i);
 860             count++;
 861         }
 862     }
 863     SvREFCNT_dec(av);
 864     XSRETURN(count);
 865 }
 866
 867 #endif                          /* USE_ATTIBUTES_FOR_PERLIO */
 868
 869 SV *
 870 PerlIO_tab_sv(pTHX_ PerlIO_funcs *tab)
 871 {
 872     HV * const stash = gv_stashpvs("PerlIO::Layer", TRUE);
 873     SV * const sv = sv_bless(newRV_noinc(newSViv(PTR2IV(tab))), stash);
 874     return sv;
 875 }
 876
 877 XS(XS_PerlIO__Layer__NoWarnings)
 878 {
 879     /* This is used as a %SIG{__WARN__} handler to supress warnings
 880        during loading of layers.
 881      */
 882     dVAR;
 883     dXSARGS;
 884     if (items)
 885         PerlIO_debug("warning:%s\n",SvPV_nolen_const(ST(0)));
 886     XSRETURN(0);
 887 }
 888
 889 XS(XS_PerlIO__Layer__find)
 890 {
 891     dVAR;
 892     dXSARGS;
 893     if (items < 2)
 894         Perl_croak(aTHX_ "Usage class->find(name[,load])");
 895     else {
 896         STRLEN len;
 897         const char * const name = SvPV_const(ST(1), len);
 898         const bool load = (items > 2) ? SvTRUE(ST(2)) : 0;
 899         PerlIO_funcs * const layer = PerlIO_find_layer(aTHX_ name, len, load);
 900         ST(0) =
 901             (layer) ? sv_2mortal(PerlIO_tab_sv(aTHX_ layer)) :
 902             &PL_sv_undef;
 903         XSRETURN(1);
 904     }
 905 }
 906
 907 void
 908 PerlIO_define_layer(pTHX_ PerlIO_funcs *tab)
 909 {
 910     dVAR;
 911     if (!PL_known_layers)
 912         PL_known_layers = PerlIO_list_alloc(aTHX);
 913     PerlIO_list_push(aTHX_ PL_known_layers, tab, NULL);
 914     PerlIO_debug("define %s %p\n", tab->name, (void*)tab);
 915 }
 916
 917 int
 918 PerlIO_parse_layers(pTHX_ PerlIO_list_t *av, const char *names)
 919 {
 920     dVAR;
 921     if (names) {
 922         const char *s = names;
 923         while (*s) {
 924             while (isSPACE(*s) || *s == ':')
 925                 s++;
 926             if (*s) {
 927                 STRLEN llen = 0;
 928                 const char *e = s;
 929                 const char *as = NULL;
 930                 STRLEN alen = 0;
 931                 if (!isIDFIRST(*s)) {
 932                     /*
 933                      * Message is consistent with how attribute lists are
 934                      * passed. Even though this means "foo : : bar" is
 935                      * seen as an invalid separator character.
 936                      */
 937                     const char q = ((*s == '\'') ? '"' : '\'');
 938                     if (ckWARN(WARN_LAYER))
 939                         Perl_warner(aTHX_ packWARN(WARN_LAYER),
 940                               "Invalid separator character %c%c%c in PerlIO layer specification %s",
 941                               q, *s, q, s);
 942                     SETERRNO(EINVAL, LIB_INVARG);
 943                     return -1;
 944                 }
 945                 do {
 946                     e++;
 947                 } while (isALNUM(*e));
 948                 llen = e - s;
 949                 if (*e == '(') {
 950                     int nesting = 1;
 951                     as = ++e;
 952                     while (nesting) {
 953                         switch (*e++) {
 954                         case ')':
 955                             if (--nesting == 0)
 956                                 alen = (e - 1) - as;
 957                             break;
 958                         case '(':
 959                             ++nesting;
 960                             break;
 961                         case '\\':
 962                             /*
 963                              * It's a nul terminated string, not allowed
 964                              * to \ the terminating null. Anything other
 965                              * character is passed over.
 966                              */
 967                             if (*e++) {
 968                                 break;
 969                             }
 970                             /*
 971                              * Drop through
 972                              */
 973                         case '\0':
 974                             e--;
 975                             if (ckWARN(WARN_LAYER))
 976                                 Perl_warner(aTHX_ packWARN(WARN_LAYER),
 977                                       "Argument list not closed for PerlIO layer \"%.*s\"",
 978                                       (int) (e - s), s);
 979                             return -1;
 980                         default:
 981                             /*
 982                              * boring.
 983                              */
 984                             break;
 985                         }
 986                     }
 987                 }
 988                 if (e > s) {
 989                     PerlIO_funcs * const layer =
 990                         PerlIO_find_layer(aTHX_ s, llen, 1);
 991                     if (layer) {
 992                         PerlIO_list_push(aTHX_ av, layer,
 993                                          (as) ? newSVpvn(as,
 994                                                          alen) :
 995                                          &PL_sv_undef);
 996                     }
 997                     else {
 998                         if (ckWARN(WARN_LAYER))
 999                             Perl_warner(aTHX_ packWARN(WARN_LAYER), "Unknown PerlIO layer \"%.*s\"",
1000                                   (int) llen, s);
1001                         return -1;
1002                     }
1003                 }
1004                 s = e;
1005             }
1006         }
1007     }
1008     return 0;
1009 }
1010
1011 void
1012 PerlIO_default_buffer(pTHX_ PerlIO_list_t *av)
1013 {
1014     dVAR;
1015     PERLIO_FUNCS_DECL(*tab) = &PerlIO_perlio;
1016 #ifdef PERLIO_USING_CRLF
1017     tab = &PerlIO_crlf;
1018 #else
1019     if (PerlIO_stdio.Set_ptrcnt)
1020         tab = &PerlIO_stdio;
1021 #endif
1022     PerlIO_debug("Pushing %s\n", tab->name);
1023     PerlIO_list_push(aTHX_ av, PerlIO_find_layer(aTHX_ tab->name, 0, 0),
1024                      &PL_sv_undef);
1025 }
1026
1027 SV *
1028 PerlIO_arg_fetch(PerlIO_list_t *av, IV n)
1029 {
1030     return av->array[n].arg;
1031 }
1032
1033 PerlIO_funcs *
1034 PerlIO_layer_fetch(pTHX_ PerlIO_list_t *av, IV n, PerlIO_funcs *def)
1035 {
1036     if (n >= 0 && n < av->cur) {
1037         PerlIO_debug("Layer %" IVdf " is %s\n", n,
1038                      av->array[n].funcs->name);
1039         return av->array[n].funcs;
1040     }
1041     if (!def)
1042         Perl_croak(aTHX_ "panic: PerlIO layer array corrupt");
1043     return def;
1044 }
1045
1046 IV
1047 PerlIOPop_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
1048 {
1049     PERL_UNUSED_ARG(mode);
1050     PERL_UNUSED_ARG(arg);
1051     PERL_UNUSED_ARG(tab);
1052     if (PerlIOValid(f)) {
1053         PerlIO_flush(f);
1054         PerlIO_pop(aTHX_ f);
1055         return 0;
1056     }
1057     return -1;
1058 }
1059
1060 PERLIO_FUNCS_DECL(PerlIO_remove) = {
1061     sizeof(PerlIO_funcs),
1062     "pop",
1063     0,
1064     PERLIO_K_DUMMY | PERLIO_K_UTF8,
1065     PerlIOPop_pushed,
1066     NULL,
1067     NULL,
1068     NULL,
1069     NULL,
1070     NULL,
1071     NULL,
1072     NULL,
1073     NULL,
1074     NULL,
1075     NULL,
1076     NULL,
1077     NULL,
1078     NULL,                       /* flush */
1079     NULL,                       /* fill */
1080     NULL,
1081     NULL,
1082     NULL,
1083     NULL,
1084     NULL,                       /* get_base */
1085     NULL,                       /* get_bufsiz */
1086     NULL,                       /* get_ptr */
1087     NULL,                       /* get_cnt */
1088     NULL,                       /* set_ptrcnt */
1089 };
1090
1091 PerlIO_list_t *
1092 PerlIO_default_layers(pTHX)
1093 {
1094     dVAR;
1095     if (!PL_def_layerlist) {
1096         const char * const s = (PL_tainting) ? NULL : PerlEnv_getenv("PERLIO");
1097         PERLIO_FUNCS_DECL(*osLayer) = &PerlIO_unix;
1098         PL_def_layerlist = PerlIO_list_alloc(aTHX);
1099         PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_unix));
1100 #if defined(WIN32)
1101         PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_win32));
1102 #if 0
1103         osLayer = &PerlIO_win32;
1104 #endif
1105 #endif
1106         PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_raw));
1107         PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_perlio));
1108         PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_stdio));
1109         PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_crlf));
1110 #ifdef HAS_MMAP
1111         PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_mmap));
1112 #endif
1113         PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_utf8));
1114         PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_remove));
1115         PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_byte));
1116         PerlIO_list_push(aTHX_ PL_def_layerlist,
1117                          PerlIO_find_layer(aTHX_ osLayer->name, 0, 0),
1118                          &PL_sv_undef);
1119         if (s) {
1120             PerlIO_parse_layers(aTHX_ PL_def_layerlist, s);
1121         }
1122         else {
1123             PerlIO_default_buffer(aTHX_ PL_def_layerlist);
1124         }
1125     }
1126     if (PL_def_layerlist->cur < 2) {
1127         PerlIO_default_buffer(aTHX_ PL_def_layerlist);
1128     }
1129     return PL_def_layerlist;
1130 }
1131
1132 void
1133 Perl_boot_core_PerlIO(pTHX)
1134 {
1135 #ifdef USE_ATTRIBUTES_FOR_PERLIO
1136     newXS("io::MODIFY_SCALAR_ATTRIBUTES", XS_io_MODIFY_SCALAR_ATTRIBUTES,
1137           __FILE__);
1138 #endif
1139     newXS("PerlIO::Layer::find", XS_PerlIO__Layer__find, __FILE__);
1140     newXS("PerlIO::Layer::NoWarnings", XS_PerlIO__Layer__NoWarnings, __FILE__);
1141 }
1142
1143 PerlIO_funcs *
1144 PerlIO_default_layer(pTHX_ I32 n)
1145 {
1146     dVAR;
1147     PerlIO_list_t * const av = PerlIO_default_layers(aTHX);
1148     if (n < 0)
1149         n += av->cur;
1150     return PerlIO_layer_fetch(aTHX_ av, n, PERLIO_FUNCS_CAST(&PerlIO_stdio));
1151 }
1152
1153 #define PerlIO_default_top() PerlIO_default_layer(aTHX_ -1)
1154 #define PerlIO_default_btm() PerlIO_default_layer(aTHX_ 0)
1155
1156 void
1157 PerlIO_stdstreams(pTHX)
1158 {
1159     dVAR;
1160     if (!PL_perlio) {
1161         PerlIO_allocate(aTHX);
1162         PerlIO_fdopen(0, "Ir" PERLIO_STDTEXT);
1163         PerlIO_fdopen(1, "Iw" PERLIO_STDTEXT);
1164         PerlIO_fdopen(2, "Iw" PERLIO_STDTEXT);
1165     }
1166 }
1167
1168 PerlIO *
1169 PerlIO_push(pTHX_ PerlIO *f, PERLIO_FUNCS_DECL(*tab), const char *mode, SV *arg)
1170 {
1171     if (tab->fsize != sizeof(PerlIO_funcs)) {
1172       mismatch:
1173         Perl_croak(aTHX_ "Layer does not match this perl");
1174     }
1175     if (tab->size) {
1176         PerlIOl *l;
1177         if (tab->size < sizeof(PerlIOl)) {
1178             goto mismatch;
1179         }
1180         /* Real layer with a data area */
1181         Newxc(l,tab->size,char,PerlIOl);
1182         if (l && f) {
1183             Zero(l, tab->size, char);
1184             l->next = *f;
1185             l->tab = (PerlIO_funcs*) tab;
1186             *f = l;
1187             PerlIO_debug("PerlIO_push f=%p %s %s %p\n", (void*)f, tab->name,
1188                         (mode) ? mode : "(Null)", (void*)arg);
1189             if (*l->tab->Pushed &&
1190                 (*l->tab->Pushed) (aTHX_ f, mode, arg, (PerlIO_funcs*) tab) != 0) {
1191                 PerlIO_pop(aTHX_ f);
1192                 return NULL;
1193             }
1194         }
1195     }
1196     else if (f) {
1197         /* Pseudo-layer where push does its own stack adjust */
1198         PerlIO_debug("PerlIO_push f=%p %s %s %p\n", (void*)f, tab->name,
1199                      (mode) ? mode : "(Null)", (void*)arg);
1200         if (tab->Pushed &&
1201             (*tab->Pushed) (aTHX_ f, mode, arg, (PerlIO_funcs*) tab) != 0) {
1202              return NULL;
1203         }
1204     }
1205     return f;
1206 }
1207
1208 IV
1209 PerlIOBase_binmode(pTHX_ PerlIO *f)
1210 {
1211    if (PerlIOValid(f)) {
1212         /* Is layer suitable for raw stream ? */
1213         if (PerlIOBase(f)->tab->kind & PERLIO_K_RAW) {
1214             /* Yes - turn off UTF-8-ness, to undo UTF-8 locale effects */
1215             PerlIOBase(f)->flags &= ~PERLIO_F_UTF8;
1216         }
1217         else {
1218             /* Not suitable - pop it */
1219             PerlIO_pop(aTHX_ f);
1220         }
1221         return 0;
1222    }
1223    return -1;
1224 }
1225
1226 IV
1227 PerlIORaw_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
1228 {
1229     PERL_UNUSED_ARG(mode);
1230     PERL_UNUSED_ARG(arg);
1231     PERL_UNUSED_ARG(tab);
1232
1233     if (PerlIOValid(f)) {
1234         PerlIO *t;
1235         const PerlIOl *l;
1236         PerlIO_flush(f);
1237         /*
1238          * Strip all layers that are not suitable for a raw stream
1239          */
1240         t = f;
1241         while (t && (l = *t)) {
1242             if (l->tab->Binmode) {
1243                 /* Has a handler - normal case */
1244                 if ((*l->tab->Binmode)(aTHX_ f) == 0) {
1245                     if (*t == l) {
1246                         /* Layer still there - move down a layer */
1247                         t = PerlIONext(t);
1248                     }
1249                 }
1250                 else {
1251                     return -1;
1252                 }
1253             }
1254             else {
1255                 /* No handler - pop it */
1256                 PerlIO_pop(aTHX_ t);
1257             }
1258         }
1259         if (PerlIOValid(f)) {
1260             PerlIO_debug(":raw f=%p :%s\n", (void*)f, PerlIOBase(f)->tab->name);
1261             return 0;
1262         }
1263     }
1264     return -1;
1265 }
1266
1267 int
1268 PerlIO_apply_layera(pTHX_ PerlIO *f, const char *mode,
1269                     PerlIO_list_t *layers, IV n, IV max)
1270 {
1271     int code = 0;
1272     while (n < max) {
1273         PerlIO_funcs * const tab = PerlIO_layer_fetch(aTHX_ layers, n, NULL);
1274         if (tab) {
1275             if (!PerlIO_push(aTHX_ f, tab, mode, PerlIOArg)) {
1276                 code = -1;
1277                 break;
1278             }
1279         }
1280         n++;
1281     }
1282     return code;
1283 }
1284
1285 int
1286 PerlIO_apply_layers(pTHX_ PerlIO *f, const char *mode, const char *names)
1287 {
1288     int code = 0;
1289     if (f && names) {
1290         PerlIO_list_t * const layers = PerlIO_list_alloc(aTHX);
1291         code = PerlIO_parse_layers(aTHX_ layers, names);
1292         if (code == 0) {
1293             code = PerlIO_apply_layera(aTHX_ f, mode, layers, 0, layers->cur);
1294         }
1295         PerlIO_list_free(aTHX_ layers);
1296     }
1297     return code;
1298 }
1299
1300
1301 /*--------------------------------------------------------------------------------------*/
1302 /*
1303  * Given the abstraction above the public API functions
1304  */
1305
1306 int
1307 PerlIO_binmode(pTHX_ PerlIO *f, int iotype, int mode, const char *names)
1308 {
1309     PerlIO_debug("PerlIO_binmode f=%p %s %c %x %s\n", (void*)f,
1310                  (PerlIOBase(f)) ? PerlIOBase(f)->tab->name : "(Null)",
1311                  iotype, mode, (names) ? names : "(Null)");
1312
1313     if (names) {
1314         /* Do not flush etc. if (e.g.) switching encodings.
1315            if a pushed layer knows it needs to flush lower layers
1316            (for example :unix which is never going to call them)
1317            it can do the flush when it is pushed.
1318          */
1319         return PerlIO_apply_layers(aTHX_ f, NULL, names) == 0 ? TRUE : FALSE;
1320     }
1321     else {
1322         /* Fake 5.6 legacy of using this call to turn ON O_TEXT */
1323 #ifdef PERLIO_USING_CRLF
1324         /* Legacy binmode only has meaning if O_TEXT has a value distinct from
1325            O_BINARY so we can look for it in mode.
1326          */
1327         if (!(mode & O_BINARY)) {
1328             /* Text mode */
1329             /* FIXME?: Looking down the layer stack seems wrong,
1330                but is a way of reaching past (say) an encoding layer
1331                to flip CRLF-ness of the layer(s) below
1332              */
1333             while (*f) {
1334                 /* Perhaps we should turn on bottom-most aware layer
1335                    e.g. Ilya's idea that UNIX TTY could serve
1336                  */
1337                 if (PerlIOBase(f)->tab->kind & PERLIO_K_CANCRLF) {
1338                     if (!(PerlIOBase(f)->flags & PERLIO_F_CRLF)) {
1339                         /* Not in text mode - flush any pending stuff and flip it */
1340                         PerlIO_flush(f);
1341                         PerlIOBase(f)->flags |= PERLIO_F_CRLF;
1342                     }
1343                     /* Only need to turn it on in one layer so we are done */
1344                     return TRUE;
1345                 }
1346                 f = PerlIONext(f);
1347             }
1348             /* Not finding a CRLF aware layer presumably means we are binary
1349                which is not what was requested - so we failed
1350                We _could_ push :crlf layer but so could caller
1351              */
1352             return FALSE;
1353         }
1354 #endif
1355         /* Legacy binmode is now _defined_ as being equivalent to pushing :raw
1356            So code that used to be here is now in PerlIORaw_pushed().
1357          */
1358         return PerlIO_push(aTHX_ f, PERLIO_FUNCS_CAST(&PerlIO_raw), NULL, NULL) ? TRUE : FALSE;
1359     }
1360 }
1361
1362 int
1363 PerlIO__close(pTHX_ PerlIO *f)
1364 {
1365     if (PerlIOValid(f)) {
1366         PerlIO_funcs * const tab = PerlIOBase(f)->tab;
1367         if (tab && tab->Close)
1368             return (*tab->Close)(aTHX_ f);
1369         else
1370             return PerlIOBase_close(aTHX_ f);
1371     }
1372     else {
1373         SETERRNO(EBADF, SS_IVCHAN);
1374         return -1;
1375     }
1376 }
1377
1378 int
1379 Perl_PerlIO_close(pTHX_ PerlIO *f)
1380 {
1381     const int code = PerlIO__close(aTHX_ f);
1382     while (PerlIOValid(f)) {
1383         PerlIO_pop(aTHX_ f);
1384     }
1385     return code;
1386 }
1387
1388 int
1389 Perl_PerlIO_fileno(pTHX_ PerlIO *f)
1390 {
1391     dVAR;
1392      Perl_PerlIO_or_Base(f, Fileno, fileno, -1, (aTHX_ f));
1393 }
1394
1395 static const char *
1396 PerlIO_context_layers(pTHX_ const char *mode)
1397 {
1398     dVAR;
1399     const char *type = NULL;
1400     /*
1401      * Need to supply default layer info from open.pm
1402      */
1403     if (PL_curcop) {
1404         SV * const layers = PL_curcop->cop_io;
1405         if (layers) {
1406             STRLEN len;
1407             type = SvPV_const(layers, len);
1408             if (type && mode[0] != 'r') {
1409                 /*
1410                  * Skip to write part
1411                  */
1412                 const char * const s = strchr(type, 0);
1413                 if (s && (STRLEN)(s - type) < len) {
1414                     type = s + 1;
1415                 }
1416             }
1417         }
1418     }
1419     return type;
1420 }
1421
1422 static PerlIO_funcs *
1423 PerlIO_layer_from_ref(pTHX_ SV *sv)
1424 {
1425     dVAR;
1426     /*
1427      * For any scalar type load the handler which is bundled with perl
1428      */
1429     if (SvTYPE(sv) < SVt_PVAV)
1430         return PerlIO_find_layer(aTHX_ STR_WITH_LEN("scalar"), 1);
1431
1432     /*
1433      * For other types allow if layer is known but don't try and load it
1434      */
1435     switch (SvTYPE(sv)) {
1436     case SVt_PVAV:
1437         return PerlIO_find_layer(aTHX_ STR_WITH_LEN("Array"), 0);
1438     case SVt_PVHV:
1439         return PerlIO_find_layer(aTHX_ STR_WITH_LEN("Hash"), 0);
1440     case SVt_PVCV:
1441         return PerlIO_find_layer(aTHX_ STR_WITH_LEN("Code"), 0);
1442     case SVt_PVGV:
1443         return PerlIO_find_layer(aTHX_ STR_WITH_LEN("Glob"), 0);
1444     }
1445     return NULL;
1446 }
1447
1448 PerlIO_list_t *
1449 PerlIO_resolve_layers(pTHX_ const char *layers,
1450                       const char *mode, int narg, SV **args)
1451 {
1452     dVAR;
1453     PerlIO_list_t *def = PerlIO_default_layers(aTHX);
1454     int incdef = 1;
1455     if (!PL_perlio)
1456         PerlIO_stdstreams(aTHX);
1457     if (narg) {
1458         SV * const arg = *args;
1459         /*
1460          * If it is a reference but not an object see if we have a handler
1461          * for it
1462          */
1463         if (SvROK(arg) && !sv_isobject(arg)) {
1464             PerlIO_funcs * const handler = PerlIO_layer_from_ref(aTHX_ SvRV(arg));
1465             if (handler) {
1466                 def = PerlIO_list_alloc(aTHX);
1467                 PerlIO_list_push(aTHX_ def, handler, &PL_sv_undef);
1468                 incdef = 0;
1469             }
1470             /*
1471              * Don't fail if handler cannot be found :via(...) etc. may do
1472              * something sensible else we will just stringfy and open
1473              * resulting string.
1474              */
1475         }
1476     }
1477     if (!layers || !*layers)
1478         layers = PerlIO_context_layers(aTHX_ mode);
1479     if (layers && *layers) {
1480         PerlIO_list_t *av;
1481         if (incdef) {
1482             IV i;
1483             av = PerlIO_list_alloc(aTHX);
1484             for (i = 0; i < def->cur; i++) {
1485                 PerlIO_list_push(aTHX_ av, def->array[i].funcs,
1486                                  def->array[i].arg);
1487             }
1488         }
1489         else {
1490             av = def;
1491         }
1492         if (PerlIO_parse_layers(aTHX_ av, layers) == 0) {
1493              return av;
1494         }
1495         else {
1496             PerlIO_list_free(aTHX_ av);
1497             return (PerlIO_list_t *) NULL;
1498         }
1499     }
1500     else {
1501         if (incdef)
1502             def->refcnt++;
1503         return def;
1504     }
1505 }
1506
1507 PerlIO *
1508 PerlIO_openn(pTHX_ const char *layers, const char *mode, int fd,
1509              int imode, int perm, PerlIO *f, int narg, SV **args)
1510 {
1511     dVAR;
1512     if (!f && narg == 1 && *args == &PL_sv_undef) {
1513         if ((f = PerlIO_tmpfile())) {
1514             if (!layers || !*layers)
1515                 layers = PerlIO_context_layers(aTHX_ mode);
1516             if (layers && *layers)
1517                 PerlIO_apply_layers(aTHX_ f, mode, layers);
1518         }
1519     }
1520     else {
1521         PerlIO_list_t *layera;
1522         IV n;
1523         PerlIO_funcs *tab = NULL;
1524         if (PerlIOValid(f)) {
1525             /*
1526              * This is "reopen" - it is not tested as perl does not use it
1527              * yet
1528              */
1529             PerlIOl *l = *f;
1530             layera = PerlIO_list_alloc(aTHX);
1531             while (l) {
1532                 SV * const arg = (l->tab->Getarg)
1533                         ? (*l->tab->Getarg) (aTHX_ &l, NULL, 0)
1534                         : &PL_sv_undef;
1535                 PerlIO_list_push(aTHX_ layera, l->tab, arg);
1536                 l = *PerlIONext(&l);
1537             }
1538         }
1539         else {
1540             layera = PerlIO_resolve_layers(aTHX_ layers, mode, narg, args);
1541             if (!layera) {
1542                 return NULL;
1543             }
1544         }
1545         /*
1546          * Start at "top" of layer stack
1547          */
1548         n = layera->cur - 1;
1549         while (n >= 0) {
1550             PerlIO_funcs * const t = PerlIO_layer_fetch(aTHX_ layera, n, NULL);
1551             if (t && t->Open) {
1552                 tab = t;
1553                 break;
1554             }
1555             n--;
1556         }
1557         if (tab) {
1558             /*
1559              * Found that layer 'n' can do opens - call it
1560              */
1561             if (narg > 1 && !(tab->kind & PERLIO_K_MULTIARG)) {
1562                 Perl_croak(aTHX_ "More than one argument to open(,':%s')",tab->name);
1563             }
1564             PerlIO_debug("openn(%s,'%s','%s',%d,%x,%o,%p,%d,%p)\n",
1565                          tab->name, layers ? layers : "(Null)", mode, fd,
1566                          imode, perm, (void*)f, narg, (void*)args);
1567             if (tab->Open)
1568                  f = (*tab->Open) (aTHX_ tab, layera, n, mode, fd, imode, perm,
1569                                    f, narg, args);
1570             else {
1571                  SETERRNO(EINVAL, LIB_INVARG);
1572                  f = NULL;
1573             }
1574             if (f) {
1575                 if (n + 1 < layera->cur) {
1576                     /*
1577                      * More layers above the one that we used to open -
1578                      * apply them now
1579                      */
1580                     if (PerlIO_apply_layera(aTHX_ f, mode, layera, n + 1, layera->cur) != 0) {
1581                         /* If pushing layers fails close the file */
1582                         PerlIO_close(f);
1583                         f = NULL;
1584                     }
1585                 }
1586             }
1587         }
1588         PerlIO_list_free(aTHX_ layera);
1589     }
1590     return f;
1591 }
1592
1593
1594 SSize_t
1595 Perl_PerlIO_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
1596 {
1597      Perl_PerlIO_or_Base(f, Read, read, -1, (aTHX_ f, vbuf, count));
1598 }
1599
1600 SSize_t
1601 Perl_PerlIO_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
1602 {
1603      Perl_PerlIO_or_Base(f, Unread, unread, -1, (aTHX_ f, vbuf, count));
1604 }
1605
1606 SSize_t
1607 Perl_PerlIO_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
1608 {
1609      Perl_PerlIO_or_fail(f, Write, -1, (aTHX_ f, vbuf, count));
1610 }
1611
1612 int
1613 Perl_PerlIO_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
1614 {
1615      Perl_PerlIO_or_fail(f, Seek, -1, (aTHX_ f, offset, whence));
1616 }
1617
1618 Off_t
1619 Perl_PerlIO_tell(pTHX_ PerlIO *f)
1620 {
1621      Perl_PerlIO_or_fail(f, Tell, -1, (aTHX_ f));
1622 }
1623
1624 int
1625 Perl_PerlIO_flush(pTHX_ PerlIO *f)
1626 {
1627     dVAR;
1628     if (f) {
1629         if (*f) {
1630             const PerlIO_funcs *tab = PerlIOBase(f)->tab;
1631
1632             if (tab && tab->Flush)
1633                 return (*tab->Flush) (aTHX_ f);
1634             else
1635                  return 0; /* If no Flush defined, silently succeed. */
1636         }
1637         else {
1638             PerlIO_debug("Cannot flush f=%p\n", (void*)f);
1639             SETERRNO(EBADF, SS_IVCHAN);
1640             return -1;
1641         }
1642     }
1643     else {
1644         /*
1645          * Is it good API design to do flush-all on NULL, a potentially
1646          * errorneous input? Maybe some magical value (PerlIO*
1647          * PERLIO_FLUSH_ALL = (PerlIO*)-1;)? Yes, stdio does similar
1648          * things on fflush(NULL), but should we be bound by their design
1649          * decisions? --jhi
1650          */
1651         PerlIO **table = &PL_perlio;
1652         int code = 0;
1653         while ((f = *table)) {
1654             int i;
1655             table = (PerlIO **) (f++);
1656             for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
1657                 if (*f && PerlIO_flush(f) != 0)
1658                     code = -1;
1659                 f++;
1660             }
1661         }
1662         return code;
1663     }
1664 }
1665
1666 void
1667 PerlIOBase_flush_linebuf(pTHX)
1668 {
1669     dVAR;
1670     PerlIO **table = &PL_perlio;
1671     PerlIO *f;
1672     while ((f = *table)) {
1673         int i;
1674         table = (PerlIO **) (f++);
1675         for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
1676             if (*f
1677                 && (PerlIOBase(f)->
1678                     flags & (PERLIO_F_LINEBUF | PERLIO_F_CANWRITE))
1679                 == (PERLIO_F_LINEBUF | PERLIO_F_CANWRITE))
1680                 PerlIO_flush(f);
1681             f++;
1682         }
1683     }
1684 }
1685
1686 int
1687 Perl_PerlIO_fill(pTHX_ PerlIO *f)
1688 {
1689      Perl_PerlIO_or_fail(f, Fill, -1, (aTHX_ f));
1690 }
1691
1692 int
1693 PerlIO_isutf8(PerlIO *f)
1694 {
1695      if (PerlIOValid(f))
1696           return (PerlIOBase(f)->flags & PERLIO_F_UTF8) != 0;
1697      else
1698           SETERRNO(EBADF, SS_IVCHAN);
1699
1700      return -1;
1701 }
1702
1703 int
1704 Perl_PerlIO_eof(pTHX_ PerlIO *f)
1705 {
1706      Perl_PerlIO_or_Base(f, Eof, eof, -1, (aTHX_ f));
1707 }
1708
1709 int
1710 Perl_PerlIO_error(pTHX_ PerlIO *f)
1711 {
1712      Perl_PerlIO_or_Base(f, Error, error, -1, (aTHX_ f));
1713 }
1714
1715 void
1716 Perl_PerlIO_clearerr(pTHX_ PerlIO *f)
1717 {
1718      Perl_PerlIO_or_Base_void(f, Clearerr, clearerr, (aTHX_ f));
1719 }
1720
1721 void
1722 Perl_PerlIO_setlinebuf(pTHX_ PerlIO *f)
1723 {
1724      Perl_PerlIO_or_Base_void(f, Setlinebuf, setlinebuf, (aTHX_ f));
1725 }
1726
1727 int
1728 PerlIO_has_base(PerlIO *f)
1729 {
1730      if (PerlIOValid(f)) {
1731           const PerlIO_funcs * const tab = PerlIOBase(f)->tab;
1732
1733           if (tab)
1734                return (tab->Get_base != NULL);
1735           SETERRNO(EINVAL, LIB_INVARG);
1736      }
1737      else
1738           SETERRNO(EBADF, SS_IVCHAN);
1739
1740      return 0;
1741 }
1742
1743 int
1744 PerlIO_fast_gets(PerlIO *f)
1745 {
1746     if (PerlIOValid(f) && (PerlIOBase(f)->flags & PERLIO_F_FASTGETS)) {
1747          const PerlIO_funcs * const tab = PerlIOBase(f)->tab;
1748
1749          if (tab)
1750               return (tab->Set_ptrcnt != NULL);
1751          SETERRNO(EINVAL, LIB_INVARG);
1752     }
1753     else
1754          SETERRNO(EBADF, SS_IVCHAN);
1755
1756     return 0;
1757 }
1758
1759 int
1760 PerlIO_has_cntptr(PerlIO *f)
1761 {
1762     if (PerlIOValid(f)) {
1763         const PerlIO_funcs * const tab = PerlIOBase(f)->tab;
1764
1765         if (tab)
1766              return (tab->Get_ptr != NULL && tab->Get_cnt != NULL);
1767           SETERRNO(EINVAL, LIB_INVARG);
1768     }
1769     else
1770          SETERRNO(EBADF, SS_IVCHAN);
1771
1772     return 0;
1773 }
1774
1775 int
1776 PerlIO_canset_cnt(PerlIO *f)
1777 {
1778     if (PerlIOValid(f)) {
1779           const PerlIO_funcs * const tab = PerlIOBase(f)->tab;
1780
1781           if (tab)
1782                return (tab->Set_ptrcnt != NULL);
1783           SETERRNO(EINVAL, LIB_INVARG);
1784     }
1785     else
1786          SETERRNO(EBADF, SS_IVCHAN);
1787
1788     return 0;
1789 }
1790
1791 STDCHAR *
1792 Perl_PerlIO_get_base(pTHX_ PerlIO *f)
1793 {
1794      Perl_PerlIO_or_fail(f, Get_base, NULL, (aTHX_ f));
1795 }
1796
1797 int
1798 Perl_PerlIO_get_bufsiz(pTHX_ PerlIO *f)
1799 {
1800      Perl_PerlIO_or_fail(f, Get_bufsiz, -1, (aTHX_ f));
1801 }
1802
1803 STDCHAR *
1804 Perl_PerlIO_get_ptr(pTHX_ PerlIO *f)
1805 {
1806      Perl_PerlIO_or_fail(f, Get_ptr, NULL, (aTHX_ f));
1807 }
1808
1809 int
1810 Perl_PerlIO_get_cnt(pTHX_ PerlIO *f)
1811 {
1812      Perl_PerlIO_or_fail(f, Get_cnt, -1, (aTHX_ f));
1813 }
1814
1815 void
1816 Perl_PerlIO_set_cnt(pTHX_ PerlIO *f, int cnt)
1817 {
1818      Perl_PerlIO_or_fail_void(f, Set_ptrcnt, (aTHX_ f, NULL, cnt));
1819 }
1820
1821 void
1822 Perl_PerlIO_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, int cnt)
1823 {
1824      Perl_PerlIO_or_fail_void(f, Set_ptrcnt, (aTHX_ f, ptr, cnt));
1825 }
1826
1827
1828 /*--------------------------------------------------------------------------------------*/
1829 /*
1830  * utf8 and raw dummy layers
1831  */
1832
1833 IV
1834 PerlIOUtf8_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
1835 {
1836     PERL_UNUSED_ARG(mode);
1837     PERL_UNUSED_ARG(arg);
1838     if (PerlIOValid(f)) {
1839         if (tab->kind & PERLIO_K_UTF8)
1840             PerlIOBase(f)->flags |= PERLIO_F_UTF8;
1841         else
1842             PerlIOBase(f)->flags &= ~PERLIO_F_UTF8;
1843         return 0;
1844     }
1845     return -1;
1846 }
1847
1848 PERLIO_FUNCS_DECL(PerlIO_utf8) = {
1849     sizeof(PerlIO_funcs),
1850     "utf8",
1851     0,
1852     PERLIO_K_DUMMY | PERLIO_K_UTF8,
1853     PerlIOUtf8_pushed,
1854     NULL,
1855     NULL,
1856     NULL,
1857     NULL,
1858     NULL,
1859     NULL,
1860     NULL,
1861     NULL,
1862     NULL,
1863     NULL,
1864     NULL,
1865     NULL,
1866     NULL,                       /* flush */
1867     NULL,                       /* fill */
1868     NULL,
1869     NULL,
1870     NULL,
1871     NULL,
1872     NULL,                       /* get_base */
1873     NULL,                       /* get_bufsiz */
1874     NULL,                       /* get_ptr */
1875     NULL,                       /* get_cnt */
1876     NULL,                       /* set_ptrcnt */
1877 };
1878
1879 PERLIO_FUNCS_DECL(PerlIO_byte) = {
1880     sizeof(PerlIO_funcs),
1881     "bytes",
1882     0,
1883     PERLIO_K_DUMMY,
1884     PerlIOUtf8_pushed,
1885     NULL,
1886     NULL,
1887     NULL,
1888     NULL,
1889     NULL,
1890     NULL,
1891     NULL,
1892     NULL,
1893     NULL,
1894     NULL,
1895     NULL,
1896     NULL,
1897     NULL,                       /* flush */
1898     NULL,                       /* fill */
1899     NULL,
1900     NULL,
1901     NULL,
1902     NULL,
1903     NULL,                       /* get_base */
1904     NULL,                       /* get_bufsiz */
1905     NULL,                       /* get_ptr */
1906     NULL,                       /* get_cnt */
1907     NULL,                       /* set_ptrcnt */
1908 };
1909
1910 PerlIO *
1911 PerlIORaw_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
1912                IV n, const char *mode, int fd, int imode, int perm,
1913                PerlIO *old, int narg, SV **args)
1914 {
1915     PerlIO_funcs * const tab = PerlIO_default_btm();
1916     PERL_UNUSED_ARG(self);
1917     if (tab && tab->Open)
1918          return (*tab->Open) (aTHX_ tab, layers, n - 1, mode, fd, imode, perm,
1919                               old, narg, args);
1920     SETERRNO(EINVAL, LIB_INVARG);
1921     return NULL;
1922 }
1923
1924 PERLIO_FUNCS_DECL(PerlIO_raw) = {
1925     sizeof(PerlIO_funcs),
1926     "raw",
1927     0,
1928     PERLIO_K_DUMMY,
1929     PerlIORaw_pushed,
1930     PerlIOBase_popped,
1931     PerlIORaw_open,
1932     NULL,
1933     NULL,
1934     NULL,
1935     NULL,
1936     NULL,
1937     NULL,
1938     NULL,
1939     NULL,
1940     NULL,
1941     NULL,
1942     NULL,                       /* flush */
1943     NULL,                       /* fill */
1944     NULL,
1945     NULL,
1946     NULL,
1947     NULL,
1948     NULL,                       /* get_base */
1949     NULL,                       /* get_bufsiz */
1950     NULL,                       /* get_ptr */
1951     NULL,                       /* get_cnt */
1952     NULL,                       /* set_ptrcnt */
1953 };
1954 /*--------------------------------------------------------------------------------------*/
1955 /*--------------------------------------------------------------------------------------*/
1956 /*
1957  * "Methods" of the "base class"
1958  */
1959
1960 IV
1961 PerlIOBase_fileno(pTHX_ PerlIO *f)
1962 {
1963     return PerlIOValid(f) ? PerlIO_fileno(PerlIONext(f)) : -1;
1964 }
1965
1966 char *
1967 PerlIO_modestr(PerlIO * f, char *buf)
1968 {
1969     char *s = buf;
1970     if (PerlIOValid(f)) {
1971         const IV flags = PerlIOBase(f)->flags;
1972         if (flags & PERLIO_F_APPEND) {
1973             *s++ = 'a';
1974             if (flags & PERLIO_F_CANREAD) {
1975                 *s++ = '+';
1976             }
1977         }
1978         else if (flags & PERLIO_F_CANREAD) {
1979             *s++ = 'r';
1980             if (flags & PERLIO_F_CANWRITE)
1981                 *s++ = '+';
1982         }
1983         else if (flags & PERLIO_F_CANWRITE) {
1984             *s++ = 'w';
1985             if (flags & PERLIO_F_CANREAD) {
1986                 *s++ = '+';
1987             }
1988         }
1989 #ifdef PERLIO_USING_CRLF
1990         if (!(flags & PERLIO_F_CRLF))
1991             *s++ = 'b';
1992 #endif
1993     }
1994     *s = '\0';
1995     return buf;
1996 }
1997
1998
1999 IV
2000 PerlIOBase_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
2001 {
2002     PerlIOl * const l = PerlIOBase(f);
2003     PERL_UNUSED_ARG(arg);
2004
2005     l->flags &= ~(PERLIO_F_CANREAD | PERLIO_F_CANWRITE |
2006                   PERLIO_F_TRUNCATE | PERLIO_F_APPEND);
2007     if (tab->Set_ptrcnt != NULL)
2008         l->flags |= PERLIO_F_FASTGETS;
2009     if (mode) {
2010         if (*mode == IoTYPE_NUMERIC || *mode == IoTYPE_IMPLICIT)
2011             mode++;
2012         switch (*mode++) {
2013         case 'r':
2014             l->flags |= PERLIO_F_CANREAD;
2015             break;
2016         case 'a':
2017             l->flags |= PERLIO_F_APPEND | PERLIO_F_CANWRITE;
2018             break;
2019         case 'w':
2020             l->flags |= PERLIO_F_TRUNCATE | PERLIO_F_CANWRITE;
2021             break;
2022         default:
2023             SETERRNO(EINVAL, LIB_INVARG);
2024             return -1;
2025         }
2026         while (*mode) {
2027             switch (*mode++) {
2028             case '+':
2029                 l->flags |= PERLIO_F_CANREAD | PERLIO_F_CANWRITE;
2030                 break;
2031             case 'b':
2032                 l->flags &= ~PERLIO_F_CRLF;
2033                 break;
2034             case 't':
2035                 l->flags |= PERLIO_F_CRLF;
2036                 break;
2037             default:
2038                 SETERRNO(EINVAL, LIB_INVARG);
2039                 return -1;
2040             }
2041         }
2042     }
2043     else {
2044         if (l->next) {
2045             l->flags |= l->next->flags &
2046                 (PERLIO_F_CANREAD | PERLIO_F_CANWRITE | PERLIO_F_TRUNCATE |
2047                  PERLIO_F_APPEND);
2048         }
2049     }
2050 #if 0
2051     PerlIO_debug("PerlIOBase_pushed f=%p %s %s fl=%08" UVxf " (%s)\n",
2052                  f, PerlIOBase(f)->tab->name, (omode) ? omode : "(Null)",
2053                  l->flags, PerlIO_modestr(f, temp));
2054 #endif
2055     return 0;
2056 }
2057
2058 IV
2059 PerlIOBase_popped(pTHX_ PerlIO *f)
2060 {
2061     PERL_UNUSED_ARG(f);
2062     return 0;
2063 }
2064
2065 SSize_t
2066 PerlIOBase_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
2067 {
2068     /*
2069      * Save the position as current head considers it
2070      */
2071     const Off_t old = PerlIO_tell(f);
2072     PerlIO_push(aTHX_ f, PERLIO_FUNCS_CAST(&PerlIO_pending), "r", NULL);
2073     PerlIOSelf(f, PerlIOBuf)->posn = old;
2074     return PerlIOBuf_unread(aTHX_ f, vbuf, count);
2075 }
2076
2077 SSize_t
2078 PerlIOBase_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
2079 {
2080     STDCHAR *buf = (STDCHAR *) vbuf;
2081     if (f) {
2082         if (!(PerlIOBase(f)->flags & PERLIO_F_CANREAD)) {
2083             PerlIOBase(f)->flags |= PERLIO_F_ERROR;
2084             SETERRNO(EBADF, SS_IVCHAN);
2085             return 0;
2086         }
2087         while (count > 0) {
2088          get_cnt:
2089           {
2090             SSize_t avail = PerlIO_get_cnt(f);
2091             SSize_t take = 0;
2092             if (avail > 0)
2093                 take = ((SSize_t)count < avail) ? count : avail;
2094             if (take > 0) {
2095                 STDCHAR *ptr = PerlIO_get_ptr(f);
2096                 Copy(ptr, buf, take, STDCHAR);
2097                 PerlIO_set_ptrcnt(f, ptr + take, (avail -= take));
2098                 count -= take;
2099                 buf += take;
2100                 if (avail == 0)         /* set_ptrcnt could have reset avail */
2101                     goto get_cnt;
2102             }
2103             if (count > 0 && avail <= 0) {
2104                 if (PerlIO_fill(f) != 0)
2105                     break;
2106             }
2107           }
2108         }
2109         return (buf - (STDCHAR *) vbuf);
2110     }
2111     return 0;
2112 }
2113
2114 IV
2115 PerlIOBase_noop_ok(pTHX_ PerlIO *f)
2116 {
2117     PERL_UNUSED_ARG(f);
2118     return 0;
2119 }
2120
2121 IV
2122 PerlIOBase_noop_fail(pTHX_ PerlIO *f)
2123 {
2124     PERL_UNUSED_ARG(f);
2125     return -1;
2126 }
2127
2128 IV
2129 PerlIOBase_close(pTHX_ PerlIO *f)
2130 {
2131     IV code = -1;
2132     if (PerlIOValid(f)) {
2133         PerlIO *n = PerlIONext(f);
2134         code = PerlIO_flush(f);
2135         PerlIOBase(f)->flags &=
2136            ~(PERLIO_F_CANREAD | PERLIO_F_CANWRITE | PERLIO_F_OPEN);
2137         while (PerlIOValid(n)) {
2138             const PerlIO_funcs * const tab = PerlIOBase(n)->tab;
2139             if (tab && tab->Close) {
2140                 if ((*tab->Close)(aTHX_ n) != 0)
2141                     code = -1;
2142                 break;
2143             }
2144             else {
2145                 PerlIOBase(n)->flags &=
2146                     ~(PERLIO_F_CANREAD | PERLIO_F_CANWRITE | PERLIO_F_OPEN);
2147             }
2148             n = PerlIONext(n);
2149         }
2150     }
2151     else {
2152         SETERRNO(EBADF, SS_IVCHAN);
2153     }
2154     return code;
2155 }
2156
2157 IV
2158 PerlIOBase_eof(pTHX_ PerlIO *f)
2159 {
2160     if (PerlIOValid(f)) {
2161         return (PerlIOBase(f)->flags & PERLIO_F_EOF) != 0;
2162     }
2163     return 1;
2164 }
2165
2166 IV
2167 PerlIOBase_error(pTHX_ PerlIO *f)
2168 {
2169     if (PerlIOValid(f)) {
2170         return (PerlIOBase(f)->flags & PERLIO_F_ERROR) != 0;
2171     }
2172     return 1;
2173 }
2174
2175 void
2176 PerlIOBase_clearerr(pTHX_ PerlIO *f)
2177 {
2178     if (PerlIOValid(f)) {
2179         PerlIO * const n = PerlIONext(f);
2180         PerlIOBase(f)->flags &= ~(PERLIO_F_ERROR | PERLIO_F_EOF);
2181         if (PerlIOValid(n))
2182             PerlIO_clearerr(n);
2183     }
2184 }
2185
2186 void
2187 PerlIOBase_setlinebuf(pTHX_ PerlIO *f)
2188 {
2189     if (PerlIOValid(f)) {
2190         PerlIOBase(f)->flags |= PERLIO_F_LINEBUF;
2191     }
2192 }
2193
2194 SV *
2195 PerlIO_sv_dup(pTHX_ SV *arg, CLONE_PARAMS *param)
2196 {
2197     if (!arg)
2198         return NULL;
2199 #ifdef sv_dup
2200     if (param) {
2201         return sv_dup(arg, param);
2202     }
2203     else {
2204         return newSVsv(arg);
2205     }
2206 #else
2207     PERL_UNUSED_ARG(param);
2208     return newSVsv(arg);
2209 #endif
2210 }
2211
2212 PerlIO *
2213 PerlIOBase_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
2214 {
2215     PerlIO * const nexto = PerlIONext(o);
2216     if (PerlIOValid(nexto)) {
2217         const PerlIO_funcs * const tab = PerlIOBase(nexto)->tab;
2218         if (tab && tab->Dup)
2219             f = (*tab->Dup)(aTHX_ f, nexto, param, flags);
2220         else
2221             f = PerlIOBase_dup(aTHX_ f, nexto, param, flags);
2222     }
2223     if (f) {
2224         PerlIO_funcs * const self = PerlIOBase(o)->tab;
2225         SV *arg;
2226         char buf[8];
2227         PerlIO_debug("PerlIOBase_dup %s f=%p o=%p param=%p\n",
2228                      self->name, (void*)f, (void*)o, (void*)param);
2229         if (self->Getarg)
2230             arg = (*self->Getarg)(aTHX_ o, param, flags);
2231         else {
2232             arg = NULL;
2233         }
2234         f = PerlIO_push(aTHX_ f, self, PerlIO_modestr(o,buf), arg);
2235         if (arg) {
2236             SvREFCNT_dec(arg);
2237         }
2238     }
2239     return f;
2240 }
2241
2242 #ifdef USE_THREADS
2243 perl_mutex PerlIO_mutex;
2244 #endif
2245
2246 /* PL_perlio_fd_refcnt[] is in intrpvar.h */
2247
2248 /* Must be called with PerlIO_mutex locked.  */
2249 static void
2250 S_more_refcounted_fds(pTHX_ const int new_fd) {
2251     const int old_max = PL_perlio_fd_refcnt_size;
2252     const int new_max = 16 + (new_fd & ~15);
2253     int *new_array;
2254
2255     PerlIO_debug("More fds - old=%d, need %d, new=%d\n",
2256                  old_max, new_fd, new_max);
2257
2258     if (new_fd < old_max) {
2259         return;
2260     }
2261
2262     assert (new_max > new_fd);
2263
2264     new_array
2265         = PerlMemShared_realloc(PL_perlio_fd_refcnt, new_max * sizeof(int));
2266
2267     if (!new_array) {
2268 #ifdef USE_THREADS
2269         MUTEX_UNLOCK(&PerlIO_mutex);
2270 #endif
2271         /* Can't use PerlIO to write as it allocates memory */
2272         PerlLIO_write(PerlIO_fileno(Perl_error_log),
2273                       PL_no_mem, strlen(PL_no_mem));
2274         my_exit(1);
2275     }
2276
2277     PL_perlio_fd_refcnt_size = new_max;
2278     PL_perlio_fd_refcnt = new_array;
2279
2280     PerlIO_debug("Zeroing %p, %d\n", new_array + old_max, new_max - old_max);
2281
2282     Zero(new_array + old_max, new_max - old_max, int);
2283 }
2284
2285
2286 void
2287 PerlIO_init(pTHX)
2288 {
2289  /* Place holder for stdstreams call ??? */
2290 #ifdef USE_THREADS
2291     MUTEX_INIT(&PerlIO_mutex);
2292 #endif
2293 }
2294
2295 void
2296 PerlIOUnix_refcnt_inc(int fd)
2297 {
2298     dTHX;
2299     if (fd >= 0) {
2300         dVAR;
2301
2302 #ifdef USE_THREADS
2303         MUTEX_LOCK(&PerlIO_mutex);
2304 #endif
2305         if (fd >= PL_perlio_fd_refcnt_size)
2306             S_more_refcounted_fds(aTHX_ fd);
2307
2308         PL_perlio_fd_refcnt[fd]++;
2309         PerlIO_debug("fd %d refcnt=%d\n",fd,PL_perlio_fd_refcnt[fd]);
2310
2311 #ifdef USE_THREADS
2312         MUTEX_UNLOCK(&PerlIO_mutex);
2313 #endif
2314     }
2315 }
2316
2317 int
2318 PerlIOUnix_refcnt_dec(int fd)
2319 {
2320     dTHX;
2321     int cnt = 0;
2322     if (fd >= 0) {
2323         dVAR;
2324 #ifdef USE_THREADS
2325         MUTEX_LOCK(&PerlIO_mutex);
2326 #endif
2327         /* XXX should this be a panic?  */
2328         if (fd >= PL_perlio_fd_refcnt_size)
2329             S_more_refcounted_fds(aTHX_ fd);
2330
2331         /* XXX should this be a panic if it drops below 0?  */
2332         cnt = --PL_perlio_fd_refcnt[fd];
2333         PerlIO_debug("fd %d refcnt=%d\n",fd,cnt);
2334 #ifdef USE_THREADS
2335         MUTEX_UNLOCK(&PerlIO_mutex);
2336 #endif
2337     }
2338     return cnt;
2339 }
2340
2341 void
2342 PerlIO_cleanup(pTHX)
2343 {
2344     dVAR;
2345     int i;
2346 #ifdef USE_ITHREADS
2347     PerlIO_debug("Cleanup layers for %p\n",aTHX);
2348 #else
2349     PerlIO_debug("Cleanup layers\n");
2350 #endif
2351     /* Raise STDIN..STDERR refcount so we don't close them */
2352     for (i=0; i < 3; i++)
2353         PerlIOUnix_refcnt_inc(i);
2354     PerlIO_cleantable(aTHX_ &PL_perlio);
2355     /* Restore STDIN..STDERR refcount */
2356     for (i=0; i < 3; i++)
2357         PerlIOUnix_refcnt_dec(i);
2358
2359     if (PL_known_layers) {
2360         PerlIO_list_free(aTHX_ PL_known_layers);
2361         PL_known_layers = NULL;
2362     }
2363     if (PL_def_layerlist) {
2364         PerlIO_list_free(aTHX_ PL_def_layerlist);
2365         PL_def_layerlist = NULL;
2366     }
2367 }
2368
2369
2370
2371 /*--------------------------------------------------------------------------------------*/
2372 /*
2373  * Bottom-most level for UNIX-like case
2374  */
2375
2376 typedef struct {
2377     struct _PerlIO base;        /* The generic part */
2378     int fd;                     /* UNIX like file descriptor */
2379     int oflags;                 /* open/fcntl flags */
2380 } PerlIOUnix;
2381
2382 int
2383 PerlIOUnix_oflags(const char *mode)
2384 {
2385     int oflags = -1;
2386     if (*mode == IoTYPE_IMPLICIT || *mode == IoTYPE_NUMERIC)
2387         mode++;
2388     switch (*mode) {
2389     case 'r':
2390         oflags = O_RDONLY;
2391         if (*++mode == '+') {
2392             oflags = O_RDWR;
2393             mode++;
2394         }
2395         break;
2396
2397     case 'w':
2398         oflags = O_CREAT | O_TRUNC;
2399         if (*++mode == '+') {
2400             oflags |= O_RDWR;
2401             mode++;
2402         }
2403         else
2404             oflags |= O_WRONLY;
2405         break;
2406
2407     case 'a':
2408         oflags = O_CREAT | O_APPEND;
2409         if (*++mode == '+') {
2410             oflags |= O_RDWR;
2411             mode++;
2412         }
2413         else
2414             oflags |= O_WRONLY;
2415         break;
2416     }
2417     if (*mode == 'b') {
2418         oflags |= O_BINARY;
2419         oflags &= ~O_TEXT;
2420         mode++;
2421     }
2422     else if (*mode == 't') {
2423         oflags |= O_TEXT;
2424         oflags &= ~O_BINARY;
2425         mode++;
2426     }
2427     /*
2428      * Always open in binary mode
2429      */
2430     oflags |= O_BINARY;
2431     if (*mode || oflags == -1) {
2432         SETERRNO(EINVAL, LIB_INVARG);
2433         oflags = -1;
2434     }
2435     return oflags;
2436 }
2437
2438 IV
2439 PerlIOUnix_fileno(pTHX_ PerlIO *f)
2440 {
2441     return PerlIOSelf(f, PerlIOUnix)->fd;
2442 }
2443
2444 static void
2445 PerlIOUnix_setfd(pTHX_ PerlIO *f, int fd, int imode)
2446 {
2447     PerlIOUnix * const s = PerlIOSelf(f, PerlIOUnix);
2448 #if defined(WIN32)
2449     Stat_t st;
2450     if (PerlLIO_fstat(fd, &st) == 0) {
2451         if (!S_ISREG(st.st_mode)) {
2452             PerlIO_debug("%d is not regular file\n",fd);
2453             PerlIOBase(f)->flags |= PERLIO_F_NOTREG;
2454         }
2455         else {
2456             PerlIO_debug("%d _is_ a regular file\n",fd);
2457         }
2458     }
2459 #endif
2460     s->fd = fd;
2461     s->oflags = imode;
2462     PerlIOUnix_refcnt_inc(fd);
2463 }
2464
2465 IV
2466 PerlIOUnix_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
2467 {
2468     IV code = PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
2469     if (*PerlIONext(f)) {
2470         /* We never call down so do any pending stuff now */
2471         PerlIO_flush(PerlIONext(f));
2472         /*
2473          * XXX could (or should) we retrieve the oflags from the open file
2474          * handle rather than believing the "mode" we are passed in? XXX
2475          * Should the value on NULL mode be 0 or -1?
2476          */
2477         PerlIOUnix_setfd(aTHX_ f, PerlIO_fileno(PerlIONext(f)),
2478                          mode ? PerlIOUnix_oflags(mode) : -1);
2479     }
2480     PerlIOBase(f)->flags |= PERLIO_F_OPEN;
2481
2482     return code;
2483 }
2484
2485 IV
2486 PerlIOUnix_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
2487 {
2488     const int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2489     Off_t new_loc;
2490     if (PerlIOBase(f)->flags & PERLIO_F_NOTREG) {
2491 #ifdef  ESPIPE
2492         SETERRNO(ESPIPE, LIB_INVARG);
2493 #else
2494         SETERRNO(EINVAL, LIB_INVARG);
2495 #endif
2496         return -1;
2497     }
2498     new_loc = PerlLIO_lseek(fd, offset, whence);
2499     if (new_loc == (Off_t) - 1)
2500         return -1;
2501     PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
2502     return  0;
2503 }
2504
2505 PerlIO *
2506 PerlIOUnix_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
2507                 IV n, const char *mode, int fd, int imode,
2508                 int perm, PerlIO *f, int narg, SV **args)
2509 {
2510     if (PerlIOValid(f)) {
2511         if (PerlIOBase(f)->flags & PERLIO_F_OPEN)
2512             (*PerlIOBase(f)->tab->Close)(aTHX_ f);
2513     }
2514     if (narg > 0) {
2515         if (*mode == IoTYPE_NUMERIC)
2516             mode++;
2517         else {
2518             imode = PerlIOUnix_oflags(mode);
2519             perm = 0666;
2520         }
2521         if (imode != -1) {
2522             const char *path = SvPV_nolen_const(*args);
2523             fd = PerlLIO_open3(path, imode, perm);
2524         }
2525     }
2526     if (fd >= 0) {
2527         if (*mode == IoTYPE_IMPLICIT)
2528             mode++;
2529         if (!f) {
2530             f = PerlIO_allocate(aTHX);
2531         }
2532         if (!PerlIOValid(f)) {
2533             if (!(f = PerlIO_push(aTHX_ f, self, mode, PerlIOArg))) {
2534                 return NULL;
2535             }
2536         }
2537         PerlIOUnix_setfd(aTHX_ f, fd, imode);
2538         PerlIOBase(f)->flags |= PERLIO_F_OPEN;
2539         if (*mode == IoTYPE_APPEND)
2540             PerlIOUnix_seek(aTHX_ f, 0, SEEK_END);
2541         return f;
2542     }
2543     else {
2544         if (f) {
2545             /*EMPTY*/;
2546             /*
2547              * FIXME: pop layers ???
2548              */
2549         }
2550         return NULL;
2551     }
2552 }
2553
2554 PerlIO *
2555 PerlIOUnix_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
2556 {
2557     const PerlIOUnix * const os = PerlIOSelf(o, PerlIOUnix);
2558     int fd = os->fd;
2559     if (flags & PERLIO_DUP_FD) {
2560         fd = PerlLIO_dup(fd);
2561     }
2562     if (fd >= 0) {
2563         f = PerlIOBase_dup(aTHX_ f, o, param, flags);
2564         if (f) {
2565             /* If all went well overwrite fd in dup'ed lay with the dup()'ed fd */
2566             PerlIOUnix_setfd(aTHX_ f, fd, os->oflags);
2567             return f;
2568         }
2569     }
2570     return NULL;
2571 }
2572
2573
2574 SSize_t
2575 PerlIOUnix_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
2576 {
2577     dVAR;
2578     const int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2579 #ifdef PERLIO_STD_SPECIAL
2580     if (fd == 0)
2581         return PERLIO_STD_IN(fd, vbuf, count);
2582 #endif
2583     if (!(PerlIOBase(f)->flags & PERLIO_F_CANREAD) ||
2584          PerlIOBase(f)->flags & (PERLIO_F_EOF|PERLIO_F_ERROR)) {
2585         return 0;
2586     }
2587     while (1) {
2588         const SSize_t len = PerlLIO_read(fd, vbuf, count);
2589         if (len >= 0 || errno != EINTR) {
2590             if (len < 0) {
2591                 if (errno != EAGAIN) {
2592                     PerlIOBase(f)->flags |= PERLIO_F_ERROR;
2593                 }
2594             }
2595             else if (len == 0 && count != 0) {
2596                 PerlIOBase(f)->flags |= PERLIO_F_EOF;
2597                 SETERRNO(0,0);
2598             }
2599             return len;
2600         }
2601         PERL_ASYNC_CHECK();
2602     }
2603     /*NOTREACHED*/
2604 }
2605
2606 SSize_t
2607 PerlIOUnix_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
2608 {
2609     dVAR;
2610     const int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2611 #ifdef PERLIO_STD_SPECIAL
2612     if (fd == 1 || fd == 2)
2613         return PERLIO_STD_OUT(fd, vbuf, count);
2614 #endif
2615     while (1) {
2616         const SSize_t len = PerlLIO_write(fd, vbuf, count);
2617         if (len >= 0 || errno != EINTR) {
2618             if (len < 0) {
2619                 if (errno != EAGAIN) {
2620                     PerlIOBase(f)->flags |= PERLIO_F_ERROR;
2621                 }
2622             }
2623             return len;
2624         }
2625         PERL_ASYNC_CHECK();
2626     }
2627     /*NOTREACHED*/
2628 }
2629
2630 Off_t
2631 PerlIOUnix_tell(pTHX_ PerlIO *f)
2632 {
2633     return PerlLIO_lseek(PerlIOSelf(f, PerlIOUnix)->fd, 0, SEEK_CUR);
2634 }
2635
2636
2637 IV
2638 PerlIOUnix_close(pTHX_ PerlIO *f)
2639 {
2640     dVAR;
2641     const int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2642     int code = 0;
2643     if (PerlIOBase(f)->flags & PERLIO_F_OPEN) {
2644         if (PerlIOUnix_refcnt_dec(fd) > 0) {
2645             PerlIOBase(f)->flags &= ~PERLIO_F_OPEN;
2646             return 0;
2647         }
2648     }
2649     else {
2650         SETERRNO(EBADF,SS_IVCHAN);
2651         return -1;
2652     }
2653     while (PerlLIO_close(fd) != 0) {
2654         if (errno != EINTR) {
2655             code = -1;
2656             break;
2657         }
2658         PERL_ASYNC_CHECK();
2659     }
2660     if (code == 0) {
2661         PerlIOBase(f)->flags &= ~PERLIO_F_OPEN;
2662     }
2663     return code;
2664 }
2665
2666 PERLIO_FUNCS_DECL(PerlIO_unix) = {
2667     sizeof(PerlIO_funcs),
2668     "unix",
2669     sizeof(PerlIOUnix),
2670     PERLIO_K_RAW,
2671     PerlIOUnix_pushed,
2672     PerlIOBase_popped,
2673     PerlIOUnix_open,
2674     PerlIOBase_binmode,         /* binmode */
2675     NULL,
2676     PerlIOUnix_fileno,
2677     PerlIOUnix_dup,
2678     PerlIOUnix_read,
2679     PerlIOBase_unread,
2680     PerlIOUnix_write,
2681     PerlIOUnix_seek,
2682     PerlIOUnix_tell,
2683     PerlIOUnix_close,
2684     PerlIOBase_noop_ok,         /* flush */
2685     PerlIOBase_noop_fail,       /* fill */
2686     PerlIOBase_eof,
2687     PerlIOBase_error,
2688     PerlIOBase_clearerr,
2689     PerlIOBase_setlinebuf,
2690     NULL,                       /* get_base */
2691     NULL,                       /* get_bufsiz */
2692     NULL,                       /* get_ptr */
2693     NULL,                       /* get_cnt */
2694     NULL,                       /* set_ptrcnt */
2695 };
2696
2697 /*--------------------------------------------------------------------------------------*/
2698 /*
2699  * stdio as a layer
2700  */
2701
2702 #if defined(VMS) && !defined(STDIO_BUFFER_WRITABLE)
2703 /* perl5.8 - This ensures the last minute VMS ungetc fix is not
2704    broken by the last second glibc 2.3 fix
2705  */
2706 #define STDIO_BUFFER_WRITABLE
2707 #endif
2708
2709
2710 typedef struct {
2711     struct _PerlIO base;
2712     FILE *stdio;                /* The stream */
2713 } PerlIOStdio;
2714
2715 IV
2716 PerlIOStdio_fileno(pTHX_ PerlIO *f)
2717 {
2718     if (PerlIOValid(f)) {
2719         FILE * const s = PerlIOSelf(f, PerlIOStdio)->stdio;
2720         if (s)
2721             return PerlSIO_fileno(s);
2722     }
2723     errno = EBADF;
2724     return -1;
2725 }
2726
2727 char *
2728 PerlIOStdio_mode(const char *mode, char *tmode)
2729 {
2730     char * const ret = tmode;
2731     if (mode) {
2732         while (*mode) {
2733             *tmode++ = *mode++;
2734         }
2735     }
2736 #if defined(PERLIO_USING_CRLF) || defined(__CYGWIN__)
2737     *tmode++ = 'b';
2738 #endif
2739     *tmode = '\0';
2740     return ret;
2741 }
2742
2743 IV
2744 PerlIOStdio_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
2745 {
2746     PerlIO *n;
2747     if (PerlIOValid(f) && PerlIOValid(n = PerlIONext(f))) {
2748         PerlIO_funcs * const toptab = PerlIOBase(n)->tab;
2749         if (toptab == tab) {
2750             /* Top is already stdio - pop self (duplicate) and use original */
2751             PerlIO_pop(aTHX_ f);
2752             return 0;
2753         } else {
2754             const int fd = PerlIO_fileno(n);
2755             char tmode[8];
2756             FILE *stdio;
2757             if (fd >= 0 && (stdio  = PerlSIO_fdopen(fd,
2758                             mode = PerlIOStdio_mode(mode, tmode)))) {
2759                 PerlIOSelf(f, PerlIOStdio)->stdio = stdio;
2760                 /* We never call down so do any pending stuff now */
2761                 PerlIO_flush(PerlIONext(f));
2762             }
2763             else {
2764                 return -1;
2765             }
2766         }
2767     }
2768     return PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
2769 }
2770
2771
2772 PerlIO *
2773 PerlIO_importFILE(FILE *stdio, const char *mode)
2774 {
2775     dTHX;
2776     PerlIO *f = NULL;
2777     if (stdio) {
2778         PerlIOStdio *s;
2779         if (!mode || !*mode) {
2780             /* We need to probe to see how we can open the stream
2781                so start with read/write and then try write and read
2782                we dup() so that we can fclose without loosing the fd.
2783
2784                Note that the errno value set by a failing fdopen
2785                varies between stdio implementations.
2786              */
2787             const int fd = PerlLIO_dup(fileno(stdio));
2788             FILE *f2 = PerlSIO_fdopen(fd, (mode = "r+"));
2789             if (!f2) {
2790                 f2 = PerlSIO_fdopen(fd, (mode = "w"));
2791             }
2792             if (!f2) {
2793                 f2 = PerlSIO_fdopen(fd, (mode = "r"));
2794             }
2795             if (!f2) {
2796                 /* Don't seem to be able to open */
2797                 PerlLIO_close(fd);
2798                 return f;
2799             }
2800             fclose(f2);
2801         }
2802         if ((f = PerlIO_push(aTHX_(f = PerlIO_allocate(aTHX)), PERLIO_FUNCS_CAST(&PerlIO_stdio), mode, NULL))) {
2803             s = PerlIOSelf(f, PerlIOStdio);
2804             s->stdio = stdio;
2805         }
2806     }
2807     return f;
2808 }
2809
2810 PerlIO *
2811 PerlIOStdio_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
2812                  IV n, const char *mode, int fd, int imode,
2813                  int perm, PerlIO *f, int narg, SV **args)
2814 {
2815     char tmode[8];
2816     if (PerlIOValid(f)) {
2817         const char * const path = SvPV_nolen_const(*args);
2818         PerlIOStdio * const s = PerlIOSelf(f, PerlIOStdio);
2819         FILE *stdio;
2820         PerlIOUnix_refcnt_dec(fileno(s->stdio));
2821         stdio = PerlSIO_freopen(path, (mode = PerlIOStdio_mode(mode, tmode)),
2822                             s->stdio);
2823         if (!s->stdio)
2824             return NULL;
2825         s->stdio = stdio;
2826         PerlIOUnix_refcnt_inc(fileno(s->stdio));
2827         return f;
2828     }
2829     else {
2830         if (narg > 0) {
2831             const char * const path = SvPV_nolen_const(*args);
2832             if (*mode == IoTYPE_NUMERIC) {
2833                 mode++;
2834                 fd = PerlLIO_open3(path, imode, perm);
2835             }
2836             else {
2837                 FILE *stdio;
2838                 bool appended = FALSE;
2839 #ifdef __CYGWIN__
2840                 /* Cygwin wants its 'b' early. */
2841                 appended = TRUE;
2842                 mode = PerlIOStdio_mode(mode, tmode);
2843 #endif
2844                 stdio = PerlSIO_fopen(path, mode);
2845                 if (stdio) {
2846                     PerlIOStdio *s;
2847                     if (!f) {
2848                         f = PerlIO_allocate(aTHX);
2849                     }
2850                     if (!appended)
2851                         mode = PerlIOStdio_mode(mode, tmode);
2852                     f = PerlIO_push(aTHX_ f, self, mode, PerlIOArg);
2853                     if (f) {
2854                         s = PerlIOSelf(f, PerlIOStdio);
2855                         s->stdio = stdio;
2856                         PerlIOUnix_refcnt_inc(fileno(s->stdio));
2857                     }
2858                     return f;
2859                 }
2860                 else {
2861                     return NULL;
2862                 }
2863             }
2864         }
2865         if (fd >= 0) {
2866             FILE *stdio = NULL;
2867             int init = 0;
2868             if (*mode == IoTYPE_IMPLICIT) {
2869                 init = 1;
2870                 mode++;
2871             }
2872             if (init) {
2873                 switch (fd) {
2874                 case 0:
2875                     stdio = PerlSIO_stdin;
2876                     break;
2877                 case 1:
2878                     stdio = PerlSIO_stdout;
2879                     break;
2880                 case 2:
2881                     stdio = PerlSIO_stderr;
2882                     break;
2883                 }
2884             }
2885             else {
2886                 stdio = PerlSIO_fdopen(fd, mode =
2887                                        PerlIOStdio_mode(mode, tmode));
2888             }
2889             if (stdio) {
2890                 if (!f) {
2891                     f = PerlIO_allocate(aTHX);
2892                 }
2893                 if ((f = PerlIO_push(aTHX_ f, self, mode, PerlIOArg))) {
2894                     PerlIOStdio * const s = PerlIOSelf(f, PerlIOStdio);
2895                     s->stdio = stdio;
2896                     PerlIOUnix_refcnt_inc(fileno(s->stdio));
2897                 }
2898                 return f;
2899             }
2900         }
2901     }
2902     return NULL;
2903 }
2904
2905 PerlIO *
2906 PerlIOStdio_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
2907 {
2908     /* This assumes no layers underneath - which is what
2909        happens, but is not how I remember it. NI-S 2001/10/16
2910      */
2911     if ((f = PerlIOBase_dup(aTHX_ f, o, param, flags))) {
2912         FILE *stdio = PerlIOSelf(o, PerlIOStdio)->stdio;
2913         const int fd = fileno(stdio);
2914         char mode[8];
2915         if (flags & PERLIO_DUP_FD) {
2916             const int dfd = PerlLIO_dup(fileno(stdio));
2917             if (dfd >= 0) {
2918                 stdio = PerlSIO_fdopen(dfd, PerlIO_modestr(o,mode));
2919                 goto set_this;
2920             }
2921             else {
2922                 /*EMPTY*/;
2923                 /* FIXME: To avoid messy error recovery if dup fails
2924                    re-use the existing stdio as though flag was not set
2925                  */
2926             }
2927         }
2928         stdio = PerlSIO_fdopen(fd, PerlIO_modestr(o,mode));
2929     set_this:
2930         PerlIOSelf(f, PerlIOStdio)->stdio = stdio;
2931         PerlIOUnix_refcnt_inc(fileno(stdio));
2932     }
2933     return f;
2934 }
2935
2936 static int
2937 PerlIOStdio_invalidate_fileno(pTHX_ FILE *f)
2938 {
2939     /* XXX this could use PerlIO_canset_fileno() and
2940      * PerlIO_set_fileno() support from Configure
2941      */
2942 #  if defined(__UCLIBC__)
2943     /* uClibc must come before glibc because it defines __GLIBC__ as well. */
2944     f->__filedes = -1;
2945     return 1;
2946 #  elif defined(__GLIBC__)
2947     /* There may be a better way for GLIBC:
2948         - libio.h defines a flag to not close() on cleanup
2949      */
2950     f->_fileno = -1;
2951     return 1;
2952 #  elif defined(__sun__)
2953 #    if defined(_LP64)
2954     /* On solaris, if _LP64 is defined, the FILE structure is this:
2955      *
2956      *  struct FILE {
2957      *      long __pad[16];
2958      *  };
2959      *
2960      * It turns out that the fd is stored in the top 32 bits of
2961      * file->__pad[4]. The lower 32 bits contain flags. file->pad[5] appears
2962      * to contain a pointer or offset into another structure. All the
2963      * remaining fields are zero.
2964      *
2965      * We set the top bits to -1 (0xFFFFFFFF).
2966      */
2967     f->__pad[4] |= 0xffffffff00000000L;
2968     assert(fileno(f) == 0xffffffff);
2969 #    else /* !defined(_LP64) */
2970     /* _file is just a unsigned char :-(
2971        Not clear why we dup() rather than using -1
2972        even if that would be treated as 0xFF - so will
2973        a dup fail ...
2974      */
2975     f->_file = PerlLIO_dup(fileno(f));
2976 #    endif /* defined(_LP64) */
2977     return 1;
2978 #  elif defined(__hpux)
2979     f->__fileH = 0xff;
2980     f->__fileL = 0xff;
2981     return 1;
2982    /* Next one ->_file seems to be a reasonable fallback, i.e. if
2983       your platform does not have special entry try this one.
2984       [For OSF only have confirmation for Tru64 (alpha)
2985       but assume other OSFs will be similar.]
2986     */
2987 #  elif defined(_AIX) || defined(__osf__) || defined(__irix__)
2988     f->_file = -1;
2989     return 1;
2990 #  elif defined(__FreeBSD__)
2991     /* There may be a better way on FreeBSD:
2992         - we could insert a dummy func in the _close function entry
2993         f->_close = (int (*)(void *)) dummy_close;
2994      */
2995     f->_file = -1;
2996     return 1;
2997 #  elif defined(__OpenBSD__)
2998     /* There may be a better way on OpenBSD:
2999         - we could insert a dummy func in the _close function entry
3000         f->_close = (int (*)(void *)) dummy_close;
3001      */
3002     f->_file = -1;
3003     return 1;
3004 #  elif defined(__EMX__)
3005     /* f->_flags &= ~_IOOPEN; */        /* Will leak stream->_buffer */
3006     f->_handle = -1;
3007     return 1;
3008 #  elif defined(__CYGWIN__)
3009     /* There may be a better way on CYGWIN:
3010         - we could insert a dummy func in the _close function entry
3011         f->_close = (int (*)(void *)) dummy_close;
3012      */
3013     f->_file = -1;
3014     return 1;
3015 #  elif defined(WIN32)
3016 #    if defined(__BORLANDC__)
3017     f->fd = PerlLIO_dup(fileno(f));
3018 #    elif defined(UNDER_CE)
3019     /* WIN_CE does not have access to FILE internals, it hardly has FILE
3020        structure at all
3021      */
3022 #    else
3023     f->_file = -1;
3024 #    endif
3025     return 1;
3026 #  else
3027 #if 0
3028     /* Sarathy's code did this - we fall back to a dup/dup2 hack
3029        (which isn't thread safe) instead
3030      */
3031 #    error "Don't know how to set FILE.fileno on your platform"
3032 #endif
3033     PERL_UNUSED_ARG(f);
3034     return 0;
3035 #  endif
3036 }
3037
3038 IV
3039 PerlIOStdio_close(pTHX_ PerlIO *f)
3040 {
3041     FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3042     if (!stdio) {
3043         errno = EBADF;
3044         return -1;
3045     }
3046     else {
3047         const int fd = fileno(stdio);
3048         int socksfd = 0;
3049         int invalidate = 0;
3050         IV result = 0;
3051         int saveerr = 0;
3052         int dupfd = 0;
3053 #ifdef SOCKS5_VERSION_NAME
3054         /* Socks lib overrides close() but stdio isn't linked to
3055            that library (though we are) - so we must call close()
3056            on sockets on stdio's behalf.
3057          */
3058         int optval;
3059         Sock_size_t optlen = sizeof(int);
3060         if (getsockopt(fd, SOL_SOCKET, SO_TYPE, (void *) &optval, &optlen) == 0) {
3061             socksfd = 1;
3062             invalidate = 1;
3063         }
3064 #endif
3065         if (PerlIOUnix_refcnt_dec(fd) > 0) {
3066             /* File descriptor still in use */
3067             invalidate = 1;
3068             socksfd = 0;
3069         }
3070         if (invalidate) {
3071             /* For STD* handles don't close the stdio at all
3072                this is because we have shared the FILE * too
3073              */
3074             if (stdio == stdin) {
3075                 /* Some stdios are buggy fflush-ing inputs */
3076                 return 0;
3077             }
3078             else if (stdio == stdout || stdio == stderr) {
3079                 return PerlIO_flush(f);
3080             }
3081             /* Tricky - must fclose(stdio) to free memory but not close(fd)
3082                Use Sarathy's trick from maint-5.6 to invalidate the
3083                fileno slot of the FILE *
3084             */
3085             result = PerlIO_flush(f);
3086             saveerr = errno;
3087             if (!(invalidate = PerlIOStdio_invalidate_fileno(aTHX_ stdio))) {
3088                 dupfd = PerlLIO_dup(fd);
3089             }
3090         }
3091         result = PerlSIO_fclose(stdio);
3092         /* We treat error from stdio as success if we invalidated
3093            errno may NOT be expected EBADF
3094          */
3095         if (invalidate && result != 0) {
3096             errno = saveerr;
3097             result = 0;
3098         }
3099         if (socksfd) {
3100             /* in SOCKS case let close() determine return value */
3101             result = close(fd);
3102         }
3103         if (dupfd) {
3104             PerlLIO_dup2(dupfd,fd);
3105             PerlLIO_close(dupfd);
3106         }
3107         return result;
3108     }
3109 }
3110
3111 SSize_t
3112 PerlIOStdio_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
3113 {
3114     dVAR;
3115     FILE * const s = PerlIOSelf(f, PerlIOStdio)->stdio;
3116     SSize_t got = 0;
3117     for (;;) {
3118         if (count == 1) {
3119             STDCHAR *buf = (STDCHAR *) vbuf;
3120             /*
3121              * Perl is expecting PerlIO_getc() to fill the buffer Linux's
3122              * stdio does not do that for fread()
3123              */
3124             const int ch = PerlSIO_fgetc(s);
3125             if (ch != EOF) {
3126                 *buf = ch;
3127                 got = 1;
3128             }
3129         }
3130         else
3131             got = PerlSIO_fread(vbuf, 1, count, s);
3132         if (got == 0 && PerlSIO_ferror(s))
3133             got = -1;
3134         if (got >= 0 || errno != EINTR)
3135             break;
3136         PERL_ASYNC_CHECK();
3137         SETERRNO(0,0);  /* just in case */
3138     }
3139     return got;
3140 }
3141
3142 SSize_t
3143 PerlIOStdio_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3144 {
3145     SSize_t unread = 0;
3146     FILE * const s = PerlIOSelf(f, PerlIOStdio)->stdio;
3147
3148 #ifdef STDIO_BUFFER_WRITABLE
3149     if (PerlIO_fast_gets(f) && PerlIO_has_base(f)) {
3150         STDCHAR *buf = ((STDCHAR *) vbuf) + count;
3151         STDCHAR *base = PerlIO_get_base(f);
3152         SSize_t cnt   = PerlIO_get_cnt(f);
3153         STDCHAR *ptr  = PerlIO_get_ptr(f);
3154         SSize_t avail = ptr - base;
3155         if (avail > 0) {
3156             if (avail > count) {
3157                 avail = count;
3158             }
3159             ptr -= avail;
3160             Move(buf-avail,ptr,avail,STDCHAR);
3161             count -= avail;
3162             unread += avail;
3163             PerlIO_set_ptrcnt(f,ptr,cnt+avail);
3164             if (PerlSIO_feof(s) && unread >= 0)
3165                 PerlSIO_clearerr(s);
3166         }
3167     }
3168     else
3169 #endif
3170     if (PerlIO_has_cntptr(f)) {
3171         /* We can get pointer to buffer but not its base
3172            Do ungetc() but check chars are ending up in the
3173            buffer
3174          */
3175         STDCHAR *eptr = (STDCHAR*)PerlSIO_get_ptr(s);
3176         STDCHAR *buf = ((STDCHAR *) vbuf) + count;
3177         while (count > 0) {
3178             const int ch = *--buf & 0xFF;
3179             if (ungetc(ch,s) != ch) {
3180                 /* ungetc did not work */
3181                 break;
3182             }
3183             if ((STDCHAR*)PerlSIO_get_ptr(s) != --eptr || ((*eptr & 0xFF) != ch)) {
3184                 /* Did not change pointer as expected */
3185                 fgetc(s);  /* get char back again */
3186                 break;
3187             }
3188             /* It worked ! */
3189             count--;
3190             unread++;
3191         }
3192     }
3193
3194     if (count > 0) {
3195         unread += PerlIOBase_unread(aTHX_ f, vbuf, count);
3196     }
3197     return unread;
3198 }
3199
3200 SSize_t
3201 PerlIOStdio_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3202 {
3203     dVAR;
3204     SSize_t got;
3205     for (;;) {
3206         got = PerlSIO_fwrite(vbuf, 1, count,
3207                               PerlIOSelf(f, PerlIOStdio)->stdio);
3208         if (got >= 0 || errno != EINTR)
3209             break;
3210         PERL_ASYNC_CHECK();
3211         SETERRNO(0,0);  /* just in case */
3212     }
3213     return got;
3214 }
3215
3216 IV
3217 PerlIOStdio_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
3218 {
3219     FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3220     return PerlSIO_fseek(stdio, offset, whence);
3221 }
3222
3223 Off_t
3224 PerlIOStdio_tell(pTHX_ PerlIO *f)
3225 {
3226     FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3227     return PerlSIO_ftell(stdio);
3228 }
3229
3230 IV
3231 PerlIOStdio_flush(pTHX_ PerlIO *f)
3232 {
3233     FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3234     if (PerlIOBase(f)->flags & PERLIO_F_CANWRITE) {
3235         return PerlSIO_fflush(stdio);
3236     }
3237     else {
3238         /*EMPTY*/;
3239 #if 0
3240         /*
3241          * FIXME: This discards ungetc() and pre-read stuff which is not
3242          * right if this is just a "sync" from a layer above Suspect right
3243          * design is to do _this_ but not have layer above flush this
3244          * layer read-to-read
3245          */
3246         /*
3247          * Not writeable - sync by attempting a seek
3248          */
3249         const int err = errno;
3250         if (PerlSIO_fseek(stdio, (Off_t) 0, SEEK_CUR) != 0)
3251             errno = err;
3252 #endif
3253     }
3254     return 0;
3255 }
3256
3257 IV
3258 PerlIOStdio_eof(pTHX_ PerlIO *f)
3259 {
3260     return PerlSIO_feof(PerlIOSelf(f, PerlIOStdio)->stdio);
3261 }
3262
3263 IV
3264 PerlIOStdio_error(pTHX_ PerlIO *f)
3265 {
3266     return PerlSIO_ferror(PerlIOSelf(f, PerlIOStdio)->stdio);
3267 }
3268
3269 void
3270 PerlIOStdio_clearerr(pTHX_ PerlIO *f)
3271 {
3272     PerlSIO_clearerr(PerlIOSelf(f, PerlIOStdio)->stdio);
3273 }
3274
3275 void
3276 PerlIOStdio_setlinebuf(pTHX_ PerlIO *f)
3277 {
3278 #ifdef HAS_SETLINEBUF
3279     PerlSIO_setlinebuf(PerlIOSelf(f, PerlIOStdio)->stdio);
3280 #else
3281     PerlSIO_setvbuf(PerlIOSelf(f, PerlIOStdio)->stdio, NULL, _IOLBF, 0);
3282 #endif
3283 }
3284
3285 #ifdef FILE_base
3286 STDCHAR *
3287 PerlIOStdio_get_base(pTHX_ PerlIO *f)
3288 {
3289     FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3290     return (STDCHAR*)PerlSIO_get_base(stdio);
3291 }
3292
3293 Size_t
3294 PerlIOStdio_get_bufsiz(pTHX_ PerlIO *f)
3295 {
3296     FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3297     return PerlSIO_get_bufsiz(stdio);
3298 }
3299 #endif
3300
3301 #ifdef USE_STDIO_PTR
3302 STDCHAR *
3303 PerlIOStdio_get_ptr(pTHX_ PerlIO *f)
3304 {
3305     FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3306     return (STDCHAR*)PerlSIO_get_ptr(stdio);
3307 }
3308
3309 SSize_t
3310 PerlIOStdio_get_cnt(pTHX_ PerlIO *f)
3311 {
3312     FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3313     return PerlSIO_get_cnt(stdio);
3314 }
3315
3316 void
3317 PerlIOStdio_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
3318 {
3319     FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3320     if (ptr != NULL) {
3321 #ifdef STDIO_PTR_LVALUE
3322         PerlSIO_set_ptr(stdio, (void*)ptr); /* LHS STDCHAR* cast non-portable */
3323 #ifdef STDIO_PTR_LVAL_SETS_CNT
3324         if (PerlSIO_get_cnt(stdio) != (cnt)) {
3325             assert(PerlSIO_get_cnt(stdio) == (cnt));
3326         }
3327 #endif
3328 #if (!defined(STDIO_PTR_LVAL_NOCHANGE_CNT))
3329         /*
3330          * Setting ptr _does_ change cnt - we are done
3331          */
3332         return;
3333 #endif
3334 #else                           /* STDIO_PTR_LVALUE */
3335         PerlProc_abort();
3336 #endif                          /* STDIO_PTR_LVALUE */
3337     }
3338     /*
3339      * Now (or only) set cnt
3340      */
3341 #ifdef STDIO_CNT_LVALUE
3342     PerlSIO_set_cnt(stdio, cnt);
3343 #else                           /* STDIO_CNT_LVALUE */
3344 #if (defined(STDIO_PTR_LVALUE) && defined(STDIO_PTR_LVAL_SETS_CNT))
3345     PerlSIO_set_ptr(stdio,
3346                     PerlSIO_get_ptr(stdio) + (PerlSIO_get_cnt(stdio) -
3347                                               cnt));
3348 #else                           /* STDIO_PTR_LVAL_SETS_CNT */
3349     PerlProc_abort();
3350 #endif                          /* STDIO_PTR_LVAL_SETS_CNT */
3351 #endif                          /* STDIO_CNT_LVALUE */
3352 }
3353
3354
3355 #endif
3356
3357 IV
3358 PerlIOStdio_fill(pTHX_ PerlIO *f)
3359 {
3360     FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3361     int c;
3362     /*
3363      * fflush()ing read-only streams can cause trouble on some stdio-s
3364      */
3365     if ((PerlIOBase(f)->flags & PERLIO_F_CANWRITE)) {
3366         if (PerlSIO_fflush(stdio) != 0)
3367             return EOF;
3368     }
3369     c = PerlSIO_fgetc(stdio);
3370     if (c == EOF)
3371         return EOF;
3372
3373 #if (defined(STDIO_PTR_LVALUE) && (defined(STDIO_CNT_LVALUE) || defined(STDIO_PTR_LVAL_SETS_CNT)))
3374
3375 #ifdef STDIO_BUFFER_WRITABLE
3376     if (PerlIO_fast_gets(f) && PerlIO_has_base(f)) {
3377         /* Fake ungetc() to the real buffer in case system's ungetc
3378            goes elsewhere
3379          */
3380         STDCHAR *base = (STDCHAR*)PerlSIO_get_base(stdio);
3381         SSize_t cnt   = PerlSIO_get_cnt(stdio);
3382         STDCHAR *ptr  = (STDCHAR*)PerlSIO_get_ptr(stdio);
3383         if (ptr == base+1) {
3384             *--ptr = (STDCHAR) c;
3385             PerlIOStdio_set_ptrcnt(aTHX_ f,ptr,cnt+1);
3386             if (PerlSIO_feof(stdio))
3387                 PerlSIO_clearerr(stdio);
3388             return 0;
3389         }
3390     }
3391     else
3392 #endif
3393     if (PerlIO_has_cntptr(f)) {
3394         STDCHAR ch = c;
3395         if (PerlIOStdio_unread(aTHX_ f,&ch,1) == 1) {
3396             return 0;
3397         }
3398     }
3399 #endif
3400
3401 #if defined(VMS)
3402     /* An ungetc()d char is handled separately from the regular
3403      * buffer, so we stuff it in the buffer ourselves.
3404      * Should never get called as should hit code above
3405      */
3406     *(--((*stdio)->_ptr)) = (unsigned char) c;
3407     (*stdio)->_cnt++;
3408 #else
3409     /* If buffer snoop scheme above fails fall back to
3410        using ungetc().
3411      */
3412     if (PerlSIO_ungetc(c, stdio) != c)
3413         return EOF;
3414 #endif
3415     return 0;
3416 }
3417
3418
3419
3420 PERLIO_FUNCS_DECL(PerlIO_stdio) = {
3421     sizeof(PerlIO_funcs),
3422     "stdio",
3423     sizeof(PerlIOStdio),
3424     PERLIO_K_BUFFERED|PERLIO_K_RAW,
3425     PerlIOStdio_pushed,
3426     PerlIOBase_popped,
3427     PerlIOStdio_open,
3428     PerlIOBase_binmode,         /* binmode */
3429     NULL,
3430     PerlIOStdio_fileno,
3431     PerlIOStdio_dup,
3432     PerlIOStdio_read,
3433     PerlIOStdio_unread,
3434     PerlIOStdio_write,
3435     PerlIOStdio_seek,
3436     PerlIOStdio_tell,
3437     PerlIOStdio_close,
3438     PerlIOStdio_flush,
3439     PerlIOStdio_fill,
3440     PerlIOStdio_eof,
3441     PerlIOStdio_error,
3442     PerlIOStdio_clearerr,
3443     PerlIOStdio_setlinebuf,
3444 #ifdef FILE_base
3445     PerlIOStdio_get_base,
3446     PerlIOStdio_get_bufsiz,
3447 #else
3448     NULL,
3449     NULL,
3450 #endif
3451 #ifdef USE_STDIO_PTR
3452     PerlIOStdio_get_ptr,
3453     PerlIOStdio_get_cnt,
3454 #   if defined(HAS_FAST_STDIO) && defined(USE_FAST_STDIO)
3455     PerlIOStdio_set_ptrcnt,
3456 #   else
3457     NULL,
3458 #   endif /* HAS_FAST_STDIO && USE_FAST_STDIO */
3459 #else
3460     NULL,
3461     NULL,
3462     NULL,
3463 #endif /* USE_STDIO_PTR */
3464 };
3465
3466 /* Note that calls to PerlIO_exportFILE() are reversed using
3467  * PerlIO_releaseFILE(), not importFILE. */
3468 FILE *
3469 PerlIO_exportFILE(PerlIO * f, const char *mode)
3470 {
3471     dTHX;
3472     FILE *stdio = NULL;
3473     if (PerlIOValid(f)) {
3474         char buf[8];
3475         PerlIO_flush(f);
3476         if (!mode || !*mode) {
3477             mode = PerlIO_modestr(f, buf);
3478         }
3479         stdio = PerlSIO_fdopen(PerlIO_fileno(f), mode);
3480         if (stdio) {
3481             PerlIOl *l = *f;
3482             PerlIO *f2;
3483             /* De-link any lower layers so new :stdio sticks */
3484             *f = NULL;
3485             if ((f2 = PerlIO_push(aTHX_ f, PERLIO_FUNCS_CAST(&PerlIO_stdio), buf, NULL))) {
3486                 PerlIOStdio *s = PerlIOSelf((f = f2), PerlIOStdio);
3487                 s->stdio = stdio;
3488                 /* Link previous lower layers under new one */
3489                 *PerlIONext(f) = l;
3490             }
3491             else {
3492                 /* restore layers list */
3493                 *f = l;
3494             }
3495         }
3496     }
3497     return stdio;
3498 }
3499
3500
3501 FILE *
3502 PerlIO_findFILE(PerlIO *f)
3503 {
3504     PerlIOl *l = *f;
3505     while (l) {
3506         if (l->tab == &PerlIO_stdio) {
3507             PerlIOStdio *s = PerlIOSelf(&l, PerlIOStdio);
3508             return s->stdio;
3509         }
3510         l = *PerlIONext(&l);
3511     }
3512     /* Uses fallback "mode" via PerlIO_modestr() in PerlIO_exportFILE */
3513     return PerlIO_exportFILE(f, NULL);
3514 }
3515
3516 /* Use this to reverse PerlIO_exportFILE calls. */
3517 void
3518 PerlIO_releaseFILE(PerlIO *p, FILE *f)
3519 {
3520     dVAR;
3521     PerlIOl *l;
3522     while ((l = *p)) {
3523         if (l->tab == &PerlIO_stdio) {
3524             PerlIOStdio *s = PerlIOSelf(&l, PerlIOStdio);
3525             if (s->stdio == f) {
3526                 dTHX;
3527                 PerlIO_pop(aTHX_ p);
3528                 return;
3529             }
3530         }
3531         p = PerlIONext(p);
3532     }
3533     return;
3534 }
3535
3536 /*--------------------------------------------------------------------------------------*/
3537 /*
3538  * perlio buffer layer
3539  */
3540
3541 IV
3542 PerlIOBuf_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
3543 {
3544     PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3545     const int fd = PerlIO_fileno(f);
3546     if (fd >= 0 && PerlLIO_isatty(fd)) {
3547         PerlIOBase(f)->flags |= PERLIO_F_LINEBUF | PERLIO_F_TTY;
3548     }
3549     if (*PerlIONext(f)) {
3550         const Off_t posn = PerlIO_tell(PerlIONext(f));
3551         if (posn != (Off_t) - 1) {
3552             b->posn = posn;
3553         }
3554     }
3555     return PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
3556 }
3557
3558 PerlIO *
3559 PerlIOBuf_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
3560                IV n, const char *mode, int fd, int imode, int perm,
3561                PerlIO *f, int narg, SV **args)
3562 {
3563     if (PerlIOValid(f)) {
3564         PerlIO *next = PerlIONext(f);
3565         PerlIO_funcs *tab =
3566              PerlIO_layer_fetch(aTHX_ layers, n - 1, PerlIOBase(next)->tab);
3567         if (tab && tab->Open)
3568              next =
3569                   (*tab->Open)(aTHX_ tab, layers, n - 1, mode, fd, imode, perm,
3570                                next, narg, args);
3571         if (!next || (*PerlIOBase(f)->tab->Pushed) (aTHX_ f, mode, PerlIOArg, self) != 0) {
3572             return NULL;
3573         }
3574     }
3575     else {
3576         PerlIO_funcs *tab = PerlIO_layer_fetch(aTHX_ layers, n - 1, PerlIO_default_btm());
3577         int init = 0;
3578         if (*mode == IoTYPE_IMPLICIT) {
3579             init = 1;
3580             /*
3581              * mode++;
3582              */
3583         }
3584         if (tab && tab->Open)
3585              f = (*tab->Open)(aTHX_ tab, layers, n - 1, mode, fd, imode, perm,
3586                               f, narg, args);
3587         else
3588              SETERRNO(EINVAL, LIB_INVARG);
3589         if (f) {
3590             if (PerlIO_push(aTHX_ f, self, mode, PerlIOArg) == 0) {
3591                 /*
3592                  * if push fails during open, open fails. close will pop us.
3593                  */
3594                 PerlIO_close (f);
3595                 return NULL;
3596             } else {
3597                 fd = PerlIO_fileno(f);
3598                 if (init && fd == 2) {
3599                     /*
3600                      * Initial stderr is unbuffered
3601                      */
3602                     PerlIOBase(f)->flags |= PERLIO_F_UNBUF;
3603                 }
3604 #ifdef PERLIO_USING_CRLF
3605 #  ifdef PERLIO_IS_BINMODE_FD
3606                 if (PERLIO_IS_BINMODE_FD(fd))
3607                     PerlIO_binmode(aTHX_ f,  '<'/*not used*/, O_BINARY, NULL);
3608                 else
3609 #  endif
3610                 /*
3611                  * do something about failing setmode()? --jhi
3612                  */
3613                 PerlLIO_setmode(fd, O_BINARY);
3614 #endif
3615             }
3616         }
3617     }
3618     return f;
3619 }
3620
3621 /*
3622  * This "flush" is akin to sfio's sync in that it handles files in either
3623  * read or write state.  For write state, we put the postponed data through
3624  * the next layers.  For read state, we seek() the next layers to the
3625  * offset given by current position in the buffer, and discard the buffer
3626  * state (XXXX supposed to be for seek()able buffers only, but now it is done
3627  * in any case?).  Then the pass the stick further in chain.
3628  */
3629 IV
3630 PerlIOBuf_flush(pTHX_ PerlIO *f)
3631 {
3632     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3633     int code = 0;
3634     PerlIO *n = PerlIONext(f);
3635     if (PerlIOBase(f)->flags & PERLIO_F_WRBUF) {
3636         /*
3637          * write() the buffer
3638          */
3639         const STDCHAR *buf = b->buf;
3640         const STDCHAR *p = buf;
3641         while (p < b->ptr) {
3642             SSize_t count = PerlIO_write(n, p, b->ptr - p);
3643             if (count > 0) {
3644                 p += count;
3645             }
3646             else if (count < 0 || PerlIO_error(n)) {
3647                 PerlIOBase(f)->flags |= PERLIO_F_ERROR;
3648                 code = -1;
3649                 break;
3650             }
3651         }
3652         b->posn += (p - buf);
3653     }
3654     else if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
3655         STDCHAR *buf = PerlIO_get_base(f);
3656         /*
3657          * Note position change
3658          */
3659         b->posn += (b->ptr - buf);
3660         if (b->ptr < b->end) {
3661             /* We did not consume all of it - try and seek downstream to
3662                our logical position
3663              */
3664             if (PerlIOValid(n) && PerlIO_seek(n, b->posn, SEEK_SET) == 0) {
3665                 /* Reload n as some layers may pop themselves on seek */
3666                 b->posn = PerlIO_tell(n = PerlIONext(f));
3667             }
3668             else {
3669                 /* Seek failed (e.g. pipe or tty). Do NOT clear buffer or pre-read
3670                    data is lost for good - so return saying "ok" having undone
3671                    the position adjust
3672                  */
3673                 b->posn -= (b->ptr - buf);
3674                 return code;
3675             }
3676         }
3677     }
3678     b->ptr = b->end = b->buf;
3679     PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
3680     /* We check for Valid because of dubious decision to make PerlIO_flush(NULL) flush all */
3681     if (PerlIOValid(n) && PerlIO_flush(n) != 0)
3682         code = -1;
3683     return code;
3684 }
3685
3686 /* This discards the content of the buffer after b->ptr, and rereads
3687  * the buffer from the position off in the layer downstream; here off
3688  * is at offset corresponding to b->ptr - b->buf.
3689  */
3690 IV
3691 PerlIOBuf_fill(pTHX_ PerlIO *f)
3692 {
3693     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3694     PerlIO *n = PerlIONext(f);
3695     SSize_t avail;
3696     /*
3697      * Down-stream flush is defined not to loose read data so is harmless.
3698      * we would not normally be fill'ing if there was data left in anycase.
3699      */
3700     if (PerlIO_flush(f) != 0)   /* XXXX Check that its seek() succeeded?! */
3701         return -1;
3702     if (PerlIOBase(f)->flags & PERLIO_F_TTY)
3703         PerlIOBase_flush_linebuf(aTHX);
3704
3705     if (!b->buf)
3706         PerlIO_get_base(f);     /* allocate via vtable */
3707
3708     b->ptr = b->end = b->buf;
3709
3710     if (!PerlIOValid(n)) {
3711         PerlIOBase(f)->flags |= PERLIO_F_EOF;
3712         return -1;
3713     }
3714
3715     if (PerlIO_fast_gets(n)) {
3716         /*
3717          * Layer below is also buffered. We do _NOT_ want to call its
3718          * ->Read() because that will loop till it gets what we asked for
3719          * which may hang on a pipe etc. Instead take anything it has to
3720          * hand, or ask it to fill _once_.
3721          */
3722         avail = PerlIO_get_cnt(n);
3723         if (avail <= 0) {
3724             avail = PerlIO_fill(n);
3725             if (avail == 0)
3726                 avail = PerlIO_get_cnt(n);
3727             else {
3728                 if (!PerlIO_error(n) && PerlIO_eof(n))
3729                     avail = 0;
3730             }
3731         }
3732         if (avail > 0) {
3733             STDCHAR *ptr = PerlIO_get_ptr(n);
3734             const SSize_t cnt = avail;
3735             if (avail > (SSize_t)b->bufsiz)
3736                 avail = b->bufsiz;
3737             Copy(ptr, b->buf, avail, STDCHAR);
3738             PerlIO_set_ptrcnt(n, ptr + avail, cnt - avail);
3739         }
3740     }
3741     else {
3742         avail = PerlIO_read(n, b->ptr, b->bufsiz);
3743     }
3744     if (avail <= 0) {
3745         if (avail == 0)
3746             PerlIOBase(f)->flags |= PERLIO_F_EOF;
3747         else
3748             PerlIOBase(f)->flags |= PERLIO_F_ERROR;
3749         return -1;
3750     }
3751     b->end = b->buf + avail;
3752     PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
3753     return 0;
3754 }
3755
3756 SSize_t
3757 PerlIOBuf_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
3758 {
3759     if (PerlIOValid(f)) {
3760         const PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3761         if (!b->ptr)
3762             PerlIO_get_base(f);
3763         return PerlIOBase_read(aTHX_ f, vbuf, count);
3764     }
3765     return 0;
3766 }
3767
3768 SSize_t
3769 PerlIOBuf_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3770 {
3771     const STDCHAR *buf = (const STDCHAR *) vbuf + count;
3772     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3773     SSize_t unread = 0;
3774     SSize_t avail;
3775     if (PerlIOBase(f)->flags & PERLIO_F_WRBUF)
3776         PerlIO_flush(f);
3777     if (!b->buf)
3778         PerlIO_get_base(f);
3779     if (b->buf) {
3780         if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
3781             /*
3782              * Buffer is already a read buffer, we can overwrite any chars
3783              * which have been read back to buffer start
3784              */
3785             avail = (b->ptr - b->buf);
3786         }
3787         else {
3788             /*
3789              * Buffer is idle, set it up so whole buffer is available for
3790              * unread
3791              */
3792             avail = b->bufsiz;
3793             b->end = b->buf + avail;
3794             b->ptr = b->end;
3795             PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
3796             /*
3797              * Buffer extends _back_ from where we are now
3798              */
3799             b->posn -= b->bufsiz;
3800         }
3801         if (avail > (SSize_t) count) {
3802             /*
3803              * If we have space for more than count, just move count
3804              */
3805             avail = count;
3806         }
3807         if (avail > 0) {
3808             b->ptr -= avail;
3809             buf -= avail;
3810             /*
3811              * In simple stdio-like ungetc() case chars will be already
3812              * there
3813              */
3814             if (buf != b->ptr) {
3815                 Copy(buf, b->ptr, avail, STDCHAR);
3816             }
3817             count -= avail;
3818             unread += avail;
3819             PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
3820         }
3821     }
3822     if (count > 0) {
3823         unread += PerlIOBase_unread(aTHX_ f, vbuf, count);
3824     }
3825     return unread;
3826 }
3827
3828 SSize_t
3829 PerlIOBuf_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3830 {
3831     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3832     const STDCHAR *buf = (const STDCHAR *) vbuf;
3833     const STDCHAR *flushptr = buf;
3834     Size_t written = 0;
3835     if (!b->buf)
3836         PerlIO_get_base(f);
3837     if (!(PerlIOBase(f)->flags & PERLIO_F_CANWRITE))
3838         return 0;
3839     if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
3840         if (PerlIO_flush(f) != 0) {
3841             return 0;
3842         }
3843     }
3844     if (PerlIOBase(f)->flags & PERLIO_F_LINEBUF) {
3845         flushptr = buf + count;
3846         while (flushptr > buf && *(flushptr - 1) != '\n')
3847             --flushptr;
3848     }
3849     while (count > 0) {
3850         SSize_t avail = b->bufsiz - (b->ptr - b->buf);
3851         if ((SSize_t) count < avail)
3852             avail = count;
3853         if (flushptr > buf && flushptr <= buf + avail)
3854             avail = flushptr - buf;
3855         PerlIOBase(f)->flags |= PERLIO_F_WRBUF;
3856         if (avail) {
3857             Copy(buf, b->ptr, avail, STDCHAR);
3858             count -= avail;
3859             buf += avail;
3860             written += avail;
3861             b->ptr += avail;
3862             if (buf == flushptr)
3863                 PerlIO_flush(f);
3864         }
3865         if (b->ptr >= (b->buf + b->bufsiz))
3866             PerlIO_flush(f);
3867     }
3868     if (PerlIOBase(f)->flags & PERLIO_F_UNBUF)
3869         PerlIO_flush(f);
3870     return written;
3871 }
3872
3873 IV
3874 PerlIOBuf_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
3875 {
3876     IV code;
3877     if ((code = PerlIO_flush(f)) == 0) {
3878         PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
3879         code = PerlIO_seek(PerlIONext(f), offset, whence);
3880         if (code == 0) {
3881             PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3882             b->posn = PerlIO_tell(PerlIONext(f));
3883         }
3884     }
3885     return code;
3886 }
3887
3888 Off_t
3889 PerlIOBuf_tell(pTHX_ PerlIO *f)
3890 {
3891     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3892     /*
3893      * b->posn is file position where b->buf was read, or will be written
3894      */
3895     Off_t posn = b->posn;
3896     if ((PerlIOBase(f)->flags & PERLIO_F_APPEND) &&
3897         (PerlIOBase(f)->flags & PERLIO_F_WRBUF)) {
3898 #if 1
3899         /* As O_APPEND files are normally shared in some sense it is better
3900            to flush :
3901          */
3902         PerlIO_flush(f);
3903 #else
3904         /* when file is NOT shared then this is sufficient */
3905         PerlIO_seek(PerlIONext(f),0, SEEK_END);
3906 #endif
3907         posn = b->posn = PerlIO_tell(PerlIONext(f));
3908     }
3909     if (b->buf) {
3910         /*
3911          * If buffer is valid adjust position by amount in buffer
3912          */
3913         posn += (b->ptr - b->buf);
3914     }
3915     return posn;
3916 }
3917
3918 IV
3919 PerlIOBuf_popped(pTHX_ PerlIO *f)
3920 {
3921     const IV code = PerlIOBase_popped(aTHX_ f);
3922     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3923     if (b->buf && b->buf != (STDCHAR *) & b->oneword) {
3924         Safefree(b->buf);
3925     }
3926     b->ptr = b->end = b->buf = NULL;
3927     PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
3928     return code;
3929 }
3930
3931 IV
3932 PerlIOBuf_close(pTHX_ PerlIO *f)
3933 {
3934     const IV code = PerlIOBase_close(aTHX_ f);
3935     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3936     if (b->buf && b->buf != (STDCHAR *) & b->oneword) {
3937         Safefree(b->buf);
3938     }
3939     b->ptr = b->end = b->buf = NULL;
3940     PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
3941     return code;
3942 }
3943
3944 STDCHAR *
3945 PerlIOBuf_get_ptr(pTHX_ PerlIO *f)
3946 {
3947     const PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3948     if (!b->buf)
3949         PerlIO_get_base(f);
3950     return b->ptr;
3951 }
3952
3953 SSize_t
3954 PerlIOBuf_get_cnt(pTHX_ PerlIO *f)
3955 {
3956     const PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3957     if (!b->buf)
3958         PerlIO_get_base(f);
3959     if (PerlIOBase(f)->flags & PERLIO_F_RDBUF)
3960         return (b->end - b->ptr);
3961     return 0;
3962 }
3963
3964 STDCHAR *
3965 PerlIOBuf_get_base(pTHX_ PerlIO *f)
3966 {
3967     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3968     if (!b->buf) {
3969         if (!b->bufsiz)
3970             b->bufsiz = 4096;
3971         b->buf = Newxz(b->buf,b->bufsiz, STDCHAR);
3972         if (!b->buf) {
3973             b->buf = (STDCHAR *) & b->oneword;
3974             b->bufsiz = sizeof(b->oneword);
3975         }
3976         b->end = b->ptr = b->buf;
3977     }
3978     return b->buf;
3979 }
3980
3981 Size_t
3982 PerlIOBuf_bufsiz(pTHX_ PerlIO *f)
3983 {
3984     const PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3985     if (!b->buf)
3986         PerlIO_get_base(f);
3987     return (b->end - b->buf);
3988 }
3989
3990 void
3991 PerlIOBuf_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
3992 {
3993     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3994     if (!b->buf)
3995         PerlIO_get_base(f);
3996     b->ptr = ptr;
3997     if (PerlIO_get_cnt(f) != cnt || b->ptr < b->buf) {
3998         assert(PerlIO_get_cnt(f) == cnt);
3999         assert(b->ptr >= b->buf);
4000     }
4001     PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
4002 }
4003
4004 PerlIO *
4005 PerlIOBuf_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
4006 {
4007  return PerlIOBase_dup(aTHX_ f, o, param, flags);
4008 }
4009
4010
4011
4012 PERLIO_FUNCS_DECL(PerlIO_perlio) = {
4013     sizeof(PerlIO_funcs),
4014     "perlio",
4015     sizeof(PerlIOBuf),
4016     PERLIO_K_BUFFERED|PERLIO_K_RAW,
4017     PerlIOBuf_pushed,
4018     PerlIOBuf_popped,
4019     PerlIOBuf_open,
4020     PerlIOBase_binmode,         /* binmode */
4021     NULL,
4022     PerlIOBase_fileno,
4023     PerlIOBuf_dup,
4024     PerlIOBuf_read,
4025     PerlIOBuf_unread,
4026     PerlIOBuf_write,
4027     PerlIOBuf_seek,
4028     PerlIOBuf_tell,
4029     PerlIOBuf_close,
4030     PerlIOBuf_flush,
4031     PerlIOBuf_fill,
4032     PerlIOBase_eof,
4033     PerlIOBase_error,
4034     PerlIOBase_clearerr,
4035     PerlIOBase_setlinebuf,
4036     PerlIOBuf_get_base,
4037     PerlIOBuf_bufsiz,
4038     PerlIOBuf_get_ptr,
4039     PerlIOBuf_get_cnt,
4040     PerlIOBuf_set_ptrcnt,
4041 };
4042
4043 /*--------------------------------------------------------------------------------------*/
4044 /*
4045  * Temp layer to hold unread chars when cannot do it any other way
4046  */
4047
4048 IV
4049 PerlIOPending_fill(pTHX_ PerlIO *f)
4050 {
4051     /*
4052      * Should never happen
4053      */
4054     PerlIO_flush(f);
4055     return 0;
4056 }
4057
4058 IV
4059 PerlIOPending_close(pTHX_ PerlIO *f)
4060 {
4061     /*
4062      * A tad tricky - flush pops us, then we close new top
4063      */
4064     PerlIO_flush(f);
4065     return PerlIO_close(f);
4066 }
4067
4068 IV
4069 PerlIOPending_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
4070 {
4071     /*
4072      * A tad tricky - flush pops us, then we seek new top
4073      */
4074     PerlIO_flush(f);
4075     return PerlIO_seek(f, offset, whence);
4076 }
4077
4078
4079 IV
4080 PerlIOPending_flush(pTHX_ PerlIO *f)
4081 {
4082     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4083     if (b->buf && b->buf != (STDCHAR *) & b->oneword) {
4084         Safefree(b->buf);
4085         b->buf = NULL;
4086     }
4087     PerlIO_pop(aTHX_ f);
4088     return 0;
4089 }
4090
4091 void
4092 PerlIOPending_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
4093 {
4094     if (cnt <= 0) {
4095         PerlIO_flush(f);
4096     }
4097     else {
4098         PerlIOBuf_set_ptrcnt(aTHX_ f, ptr, cnt);
4099     }
4100 }
4101
4102 IV
4103 PerlIOPending_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
4104 {
4105     const IV code = PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
4106     PerlIOl * const l = PerlIOBase(f);
4107     /*
4108      * Our PerlIO_fast_gets must match what we are pushed on, or sv_gets()
4109      * etc. get muddled when it changes mid-string when we auto-pop.
4110      */
4111     l->flags = (l->flags & ~(PERLIO_F_FASTGETS | PERLIO_F_UTF8)) |
4112         (PerlIOBase(PerlIONext(f))->
4113          flags & (PERLIO_F_FASTGETS | PERLIO_F_UTF8));
4114     return code;
4115 }
4116
4117 SSize_t
4118 PerlIOPending_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
4119 {
4120     SSize_t avail = PerlIO_get_cnt(f);
4121     SSize_t got = 0;
4122     if ((SSize_t)count < avail)
4123         avail = count;
4124     if (avail > 0)
4125         got = PerlIOBuf_read(aTHX_ f, vbuf, avail);
4126     if (got >= 0 && got < (SSize_t)count) {
4127         const SSize_t more =
4128             PerlIO_read(f, ((STDCHAR *) vbuf) + got, count - got);
4129         if (more >= 0 || got == 0)
4130             got += more;
4131     }
4132     return got;
4133 }
4134
4135 PERLIO_FUNCS_DECL(PerlIO_pending) = {
4136     sizeof(PerlIO_funcs),
4137     "pending",
4138     sizeof(PerlIOBuf),
4139     PERLIO_K_BUFFERED|PERLIO_K_RAW,  /* not sure about RAW here */
4140     PerlIOPending_pushed,
4141     PerlIOBuf_popped,
4142     NULL,
4143     PerlIOBase_binmode,         /* binmode */
4144     NULL,
4145     PerlIOBase_fileno,
4146     PerlIOBuf_dup,
4147     PerlIOPending_read,
4148     PerlIOBuf_unread,
4149     PerlIOBuf_write,
4150     PerlIOPending_seek,
4151     PerlIOBuf_tell,
4152     PerlIOPending_close,
4153     PerlIOPending_flush,
4154     PerlIOPending_fill,
4155     PerlIOBase_eof,
4156     PerlIOBase_error,
4157     PerlIOBase_clearerr,
4158     PerlIOBase_setlinebuf,
4159     PerlIOBuf_get_base,
4160     PerlIOBuf_bufsiz,
4161     PerlIOBuf_get_ptr,
4162     PerlIOBuf_get_cnt,
4163     PerlIOPending_set_ptrcnt,
4164 };
4165
4166
4167
4168 /*--------------------------------------------------------------------------------------*/
4169 /*
4170  * crlf - translation On read translate CR,LF to "\n" we do this by
4171  * overriding ptr/cnt entries to hand back a line at a time and keeping a
4172  * record of which nl we "lied" about. On write translate "\n" to CR,LF
4173  *
4174  * c->nl points on the first byte of CR LF pair when it is temporarily
4175  * replaced by LF, or to the last CR of the buffer.  In the former case
4176  * the caller thinks that the buffer ends at c->nl + 1, in the latter
4177  * that it ends at c->nl; these two cases can be distinguished by
4178  * *c->nl.  c->nl is set during _getcnt() call, and unset during
4179  * _unread() and _flush() calls.
4180  * It only matters for read operations.
4181  */
4182
4183 typedef struct {
4184     PerlIOBuf base;             /* PerlIOBuf stuff */
4185     STDCHAR *nl;                /* Position of crlf we "lied" about in the
4186                                  * buffer */
4187 } PerlIOCrlf;
4188
4189 IV
4190 PerlIOCrlf_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
4191 {
4192     IV code;
4193     PerlIOBase(f)->flags |= PERLIO_F_CRLF;
4194     code = PerlIOBuf_pushed(aTHX_ f, mode, arg, tab);
4195 #if 0
4196     PerlIO_debug("PerlIOCrlf_pushed f=%p %s %s fl=%08" UVxf "\n",
4197                  f, PerlIOBase(f)->tab->name, (mode) ? mode : "(Null)",
4198                  PerlIOBase(f)->flags);
4199 #endif
4200     {
4201       /* Enable the first CRLF capable layer you can find, but if none
4202        * found, the one we just pushed is fine.  This results in at
4203        * any given moment at most one CRLF-capable layer being enabled
4204        * in the whole layer stack. */
4205          PerlIO *g = PerlIONext(f);
4206          while (g && *g) {
4207               PerlIOl *b = PerlIOBase(g);
4208               if (b && b->tab == &PerlIO_crlf) {
4209                    if (!(b->flags & PERLIO_F_CRLF))
4210                         b->flags |= PERLIO_F_CRLF;
4211                    PerlIO_pop(aTHX_ f);
4212                    return code;
4213               }
4214               g = PerlIONext(g);
4215          }
4216     }
4217     return code;
4218 }
4219
4220
4221 SSize_t
4222 PerlIOCrlf_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4223 {
4224     PerlIOCrlf * const c = PerlIOSelf(f, PerlIOCrlf);
4225     if (c->nl) {        /* XXXX Shouldn't it be done only if b->ptr > c->nl? */
4226         *(c->nl) = 0xd;
4227         c->nl = NULL;
4228     }
4229     if (!(PerlIOBase(f)->flags & PERLIO_F_CRLF))
4230         return PerlIOBuf_unread(aTHX_ f, vbuf, count);
4231     else {
4232         const STDCHAR *buf = (const STDCHAR *) vbuf + count;
4233         PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
4234         SSize_t unread = 0;
4235         if (PerlIOBase(f)->flags & PERLIO_F_WRBUF)
4236             PerlIO_flush(f);
4237         if (!b->buf)
4238             PerlIO_get_base(f);
4239         if (b->buf) {
4240             if (!(PerlIOBase(f)->flags & PERLIO_F_RDBUF)) {
4241                 b->end = b->ptr = b->buf + b->bufsiz;
4242                 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
4243                 b->posn -= b->bufsiz;
4244             }
4245             while (count > 0 && b->ptr > b->buf) {
4246                 const int ch = *--buf;
4247                 if (ch == '\n') {
4248                     if (b->ptr - 2 >= b->buf) {
4249                         *--(b->ptr) = 0xa;
4250                         *--(b->ptr) = 0xd;
4251                         unread++;
4252                         count--;
4253                     }
4254                     else {
4255                     /* If b->ptr - 1 == b->buf, we are undoing reading 0xa */
4256                         *--(b->ptr) = 0xa;      /* Works even if 0xa == '\r' */
4257                         unread++;
4258                         count--;
4259                     }
4260                 }
4261                 else {
4262                     *--(b->ptr) = ch;
4263                     unread++;
4264                     count--;
4265                 }
4266             }
4267         }
4268         return unread;
4269     }
4270 }
4271
4272 /* XXXX This code assumes that buffer size >=2, but does not check it... */
4273 SSize_t
4274 PerlIOCrlf_get_cnt(pTHX_ PerlIO *f)
4275 {
4276     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4277     if (!b->buf)
4278         PerlIO_get_base(f);
4279     if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
4280         PerlIOCrlf * const c = PerlIOSelf(f, PerlIOCrlf);
4281         if ((PerlIOBase(f)->flags & PERLIO_F_CRLF) && (!c->nl || *c->nl == 0xd)) {
4282             STDCHAR *nl = (c->nl) ? c->nl : b->ptr;
4283           scan:
4284             while (nl < b->end && *nl != 0xd)
4285                 nl++;
4286             if (nl < b->end && *nl == 0xd) {
4287               test:
4288                 if (nl + 1 < b->end) {
4289                     if (nl[1] == 0xa) {
4290                         *nl = '\n';
4291                         c->nl = nl;
4292                     }
4293                     else {
4294                         /*
4295                          * Not CR,LF but just CR
4296                          */
4297                         nl++;
4298                         goto scan;
4299                     }
4300                 }
4301                 else {
4302                     /*
4303                      * Blast - found CR as last char in buffer
4304                      */
4305
4306                     if (b->ptr < nl) {
4307                         /*
4308                          * They may not care, defer work as long as
4309                          * possible
4310                          */
4311                         c->nl = nl;
4312                         return (nl - b->ptr);
4313                     }
4314                     else {
4315                         int code;
4316                         b->ptr++;       /* say we have read it as far as
4317                                          * flush() is concerned */
4318                         b->buf++;       /* Leave space in front of buffer */
4319                         /* Note as we have moved buf up flush's
4320                            posn += ptr-buf
4321                            will naturally make posn point at CR
4322                          */
4323                         b->bufsiz--;    /* Buffer is thus smaller */
4324                         code = PerlIO_fill(f);  /* Fetch some more */
4325                         b->bufsiz++;    /* Restore size for next time */
4326                         b->buf--;       /* Point at space */
4327                         b->ptr = nl = b->buf;   /* Which is what we hand
4328                                                  * off */
4329                         *nl = 0xd;      /* Fill in the CR */
4330                         if (code == 0)
4331                             goto test;  /* fill() call worked */
4332                         /*
4333                          * CR at EOF - just fall through
4334                          */
4335                         /* Should we clear EOF though ??? */
4336                     }
4337                 }
4338             }
4339         }
4340         return (((c->nl) ? (c->nl + 1) : b->end) - b->ptr);
4341     }
4342     return 0;
4343 }
4344
4345 void
4346 PerlIOCrlf_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
4347 {
4348     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4349     PerlIOCrlf * const c = PerlIOSelf(f, PerlIOCrlf);
4350     if (!b->buf)
4351         PerlIO_get_base(f);
4352     if (!ptr) {
4353         if (c->nl) {
4354             ptr = c->nl + 1;
4355             if (ptr == b->end && *c->nl == 0xd) {
4356                 /* Defered CR at end of buffer case - we lied about count */
4357                 ptr--;
4358             }
4359         }
4360         else {
4361             ptr = b->end;
4362         }
4363         ptr -= cnt;
4364     }
4365     else {
4366         /*EMPTY*/;
4367 #if 0
4368         /*
4369          * Test code - delete when it works ...
4370          */
4371         IV flags = PerlIOBase(f)->flags;
4372         STDCHAR *chk = (c->nl) ? (c->nl+1) : b->end;
4373         if (ptr+cnt == c->nl && c->nl+1 == b->end && *c->nl == 0xd) {
4374           /* Defered CR at end of buffer case - we lied about count */
4375           chk--;
4376         }
4377         chk -= cnt;
4378
4379         if (ptr != chk ) {
4380             Perl_croak(aTHX_ "ptr wrong %p != %p fl=%08" UVxf
4381                        " nl=%p e=%p for %d", ptr, chk, flags, c->nl,
4382                        b->end, cnt);
4383         }
4384 #endif
4385     }
4386     if (c->nl) {
4387         if (ptr > c->nl) {
4388             /*
4389              * They have taken what we lied about
4390              */
4391             *(c->nl) = 0xd;
4392             c->nl = NULL;
4393             ptr++;
4394         }
4395     }
4396     b->ptr = ptr;
4397     PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
4398 }
4399
4400 SSize_t
4401 PerlIOCrlf_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4402 {
4403     if (!(PerlIOBase(f)->flags & PERLIO_F_CRLF))
4404         return PerlIOBuf_write(aTHX_ f, vbuf, count);
4405     else {
4406         PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4407         const STDCHAR *buf = (const STDCHAR *) vbuf;
4408         const STDCHAR * const ebuf = buf + count;
4409         if (!b->buf)
4410             PerlIO_get_base(f);
4411         if (!(PerlIOBase(f)->flags & PERLIO_F_CANWRITE))
4412             return 0;
4413         while (buf < ebuf) {
4414             const STDCHAR * const eptr = b->buf + b->bufsiz;
4415             PerlIOBase(f)->flags |= PERLIO_F_WRBUF;
4416             while (buf < ebuf && b->ptr < eptr) {
4417                 if (*buf == '\n') {
4418                     if ((b->ptr + 2) > eptr) {
4419                         /*
4420                          * Not room for both
4421                          */
4422                         PerlIO_flush(f);
4423                         break;
4424                     }
4425                     else {
4426                         *(b->ptr)++ = 0xd;      /* CR */
4427                         *(b->ptr)++ = 0xa;      /* LF */
4428                         buf++;
4429                         if (PerlIOBase(f)->flags & PERLIO_F_LINEBUF) {
4430                             PerlIO_flush(f);
4431                             break;
4432                         }
4433                     }
4434                 }
4435                 else {
4436                     *(b->ptr)++ = *buf++;
4437                 }
4438                 if (b->ptr >= eptr) {
4439                     PerlIO_flush(f);
4440                     break;
4441                 }
4442             }
4443         }
4444         if (PerlIOBase(f)->flags & PERLIO_F_UNBUF)
4445             PerlIO_flush(f);
4446         return (buf - (STDCHAR *) vbuf);
4447     }
4448 }
4449
4450 IV
4451 PerlIOCrlf_flush(pTHX_ PerlIO *f)
4452 {
4453     PerlIOCrlf * const c = PerlIOSelf(f, PerlIOCrlf);
4454     if (c->nl) {
4455         *(c->nl) = 0xd;
4456         c->nl = NULL;
4457     }
4458     return PerlIOBuf_flush(aTHX_ f);
4459 }
4460
4461 IV
4462 PerlIOCrlf_binmode(pTHX_ PerlIO *f)
4463 {
4464     if ((PerlIOBase(f)->flags & PERLIO_F_CRLF)) {
4465         /* In text mode - flush any pending stuff and flip it */
4466         PerlIOBase(f)->flags &= ~PERLIO_F_CRLF;
4467 #ifndef PERLIO_USING_CRLF
4468         /* CRLF is unusual case - if this is just the :crlf layer pop it */
4469         if (PerlIOBase(f)->tab == &PerlIO_crlf) {
4470                 PerlIO_pop(aTHX_ f);
4471         }
4472 #endif
4473     }
4474     return 0;
4475 }
4476
4477 PERLIO_FUNCS_DECL(PerlIO_crlf) = {
4478     sizeof(PerlIO_funcs),
4479     "crlf",
4480     sizeof(PerlIOCrlf),
4481     PERLIO_K_BUFFERED | PERLIO_K_CANCRLF | PERLIO_K_RAW,
4482     PerlIOCrlf_pushed,
4483     PerlIOBuf_popped,         /* popped */
4484     PerlIOBuf_open,
4485     PerlIOCrlf_binmode,       /* binmode */
4486     NULL,
4487     PerlIOBase_fileno,
4488     PerlIOBuf_dup,
4489     PerlIOBuf_read,             /* generic read works with ptr/cnt lies */
4490     PerlIOCrlf_unread,          /* Put CR,LF in buffer for each '\n' */
4491     PerlIOCrlf_write,           /* Put CR,LF in buffer for each '\n' */
4492     PerlIOBuf_seek,
4493     PerlIOBuf_tell,
4494     PerlIOBuf_close,
4495     PerlIOCrlf_flush,
4496     PerlIOBuf_fill,
4497     PerlIOBase_eof,
4498     PerlIOBase_error,
4499     PerlIOBase_clearerr,
4500     PerlIOBase_setlinebuf,
4501     PerlIOBuf_get_base,
4502     PerlIOBuf_bufsiz,
4503     PerlIOBuf_get_ptr,
4504     PerlIOCrlf_get_cnt,
4505     PerlIOCrlf_set_ptrcnt,
4506 };
4507
4508 #ifdef HAS_MMAP
4509 /*--------------------------------------------------------------------------------------*/
4510 /*
4511  * mmap as "buffer" layer
4512  */
4513
4514 typedef struct {
4515     PerlIOBuf base;             /* PerlIOBuf stuff */
4516     Mmap_t mptr;                /* Mapped address */
4517     Size_t len;                 /* mapped length */
4518     STDCHAR *bbuf;              /* malloced buffer if map fails */
4519 } PerlIOMmap;
4520
4521 IV
4522 PerlIOMmap_map(pTHX_ PerlIO *f)
4523 {
4524     dVAR;
4525     PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4526     const IV flags = PerlIOBase(f)->flags;
4527     IV code = 0;
4528     if (m->len)
4529         abort();
4530     if (flags & PERLIO_F_CANREAD) {
4531         PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4532         const int fd = PerlIO_fileno(f);
4533         Stat_t st;
4534         code = Fstat(fd, &st);
4535         if (code == 0 && S_ISREG(st.st_mode)) {
4536             SSize_t len = st.st_size - b->posn;
4537             if (len > 0) {
4538                 Off_t posn;
4539                 if (PL_mmap_page_size <= 0)
4540                   Perl_croak(aTHX_ "panic: bad pagesize %" IVdf,
4541                              PL_mmap_page_size);
4542                 if (b->posn < 0) {
4543                     /*
4544                      * This is a hack - should never happen - open should
4545                      * have set it !
4546                      */
4547                     b->posn = PerlIO_tell(PerlIONext(f));
4548                 }
4549                 posn = (b->posn / PL_mmap_page_size) * PL_mmap_page_size;
4550                 len = st.st_size - posn;
4551                 m->mptr = mmap(NULL, len, PROT_READ, MAP_SHARED, fd, posn);
4552                 if (m->mptr && m->mptr != (Mmap_t) - 1) {
4553 #if 0 && defined(HAS_MADVISE) && defined(MADV_SEQUENTIAL)
4554                     madvise(m->mptr, len, MADV_SEQUENTIAL);
4555 #endif
4556 #if 0 && defined(HAS_MADVISE) && defined(MADV_WILLNEED)
4557                     madvise(m->mptr, len, MADV_WILLNEED);
4558 #endif
4559                     PerlIOBase(f)->flags =
4560                         (flags & ~PERLIO_F_EOF) | PERLIO_F_RDBUF;
4561                     b->end = ((STDCHAR *) m->mptr) + len;
4562                     b->buf = ((STDCHAR *) m->mptr) + (b->posn - posn);
4563                     b->ptr = b->buf;
4564                     m->len = len;
4565                 }
4566                 else {
4567                     b->buf = NULL;
4568                 }
4569             }
4570             else {
4571                 PerlIOBase(f)->flags =
4572                     flags | PERLIO_F_EOF | PERLIO_F_RDBUF;
4573                 b->buf = NULL;
4574                 b->ptr = b->end = b->ptr;
4575                 code = -1;
4576             }
4577         }
4578     }
4579     return code;
4580 }
4581
4582 IV
4583 PerlIOMmap_unmap(pTHX_ PerlIO *f)
4584 {
4585     PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4586     IV code = 0;
4587     if (m->len) {
4588         PerlIOBuf * const b = &m->base;
4589         if (b->buf) {
4590             code = munmap(m->mptr, m->len);
4591             b->buf = NULL;
4592             m->len = 0;
4593             m->mptr = NULL;
4594             if (PerlIO_seek(PerlIONext(f), b->posn, SEEK_SET) != 0)
4595                 code = -1;
4596         }
4597         b->ptr = b->end = b->buf;
4598         PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
4599     }
4600     return code;
4601 }
4602
4603 STDCHAR *
4604 PerlIOMmap_get_base(pTHX_ PerlIO *f)
4605 {
4606     PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4607     PerlIOBuf * const b = &m->base;
4608     if (b->buf && (PerlIOBase(f)->flags & PERLIO_F_RDBUF)) {
4609         /*
4610          * Already have a readbuffer in progress
4611          */
4612         return b->buf;
4613     }
4614     if (b->buf) {
4615         /*
4616          * We have a write buffer or flushed PerlIOBuf read buffer
4617          */
4618         m->bbuf = b->buf;       /* save it in case we need it again */
4619         b->buf = NULL;          /* Clear to trigger below */
4620     }
4621     if (!b->buf) {
4622         PerlIOMmap_map(aTHX_ f);        /* Try and map it */
4623         if (!b->buf) {
4624             /*
4625              * Map did not work - recover PerlIOBuf buffer if we have one
4626              */
4627             b->buf = m->bbuf;
4628         }
4629     }
4630     b->ptr = b->end = b->buf;
4631     if (b->buf)
4632         return b->buf;
4633     return PerlIOBuf_get_base(aTHX_ f);
4634 }
4635
4636 SSize_t
4637 PerlIOMmap_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4638 {
4639     PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4640     PerlIOBuf * const b = &m->base;
4641     if (PerlIOBase(f)->flags & PERLIO_F_WRBUF)
4642         PerlIO_flush(f);
4643     if (b->ptr && (b->ptr - count) >= b->buf
4644         && memEQ(b->ptr - count, vbuf, count)) {
4645         b->ptr -= count;
4646         PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
4647         return count;
4648     }
4649     if (m->len) {
4650         /*
4651          * Loose the unwritable mapped buffer
4652          */
4653         PerlIO_flush(f);
4654         /*
4655          * If flush took the "buffer" see if we have one from before
4656          */
4657         if (!b->buf && m->bbuf)
4658             b->buf = m->bbuf;
4659         if (!b->buf) {
4660             PerlIOBuf_get_base(aTHX_ f);
4661             m->bbuf = b->buf;
4662         }
4663     }
4664     return PerlIOBuf_unread(aTHX_ f, vbuf, count);
4665 }
4666
4667 SSize_t
4668 PerlIOMmap_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4669 {
4670     PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4671     PerlIOBuf * const b = &m->base;
4672
4673     if (!b->buf || !(PerlIOBase(f)->flags & PERLIO_F_WRBUF)) {
4674         /*
4675          * No, or wrong sort of, buffer
4676          */
4677         if (m->len) {
4678             if (PerlIOMmap_unmap(aTHX_ f) != 0)
4679                 return 0;
4680         }
4681         /*
4682          * If unmap took the "buffer" see if we have one from before
4683          */
4684         if (!b->buf && m->bbuf)
4685             b->buf = m->bbuf;
4686         if (!b->buf) {
4687             PerlIOBuf_get_base(aTHX_ f);
4688             m->bbuf = b->buf;
4689         }
4690     }
4691     return PerlIOBuf_write(aTHX_ f, vbuf, count);
4692 }
4693
4694 IV
4695 PerlIOMmap_flush(pTHX_ PerlIO *f)
4696 {
4697     PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4698     PerlIOBuf * const b = &m->base;
4699     IV code = PerlIOBuf_flush(aTHX_ f);
4700     /*
4701      * Now we are "synced" at PerlIOBuf level
4702      */
4703     if (b->buf) {
4704         if (m->len) {
4705             /*
4706              * Unmap the buffer
4707              */
4708             if (PerlIOMmap_unmap(aTHX_ f) != 0)
4709                 code = -1;
4710         }
4711         else {
4712             /*
4713              * We seem to have a PerlIOBuf buffer which was not mapped
4714              * remember it in case we need one later
4715              */
4716             m->bbuf = b->buf;
4717         }
4718     }
4719     return code;
4720 }
4721
4722 IV
4723 PerlIOMmap_fill(pTHX_ PerlIO *f)
4724 {
4725     PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4726     IV code = PerlIO_flush(f);
4727     if (code == 0 && !b->buf) {
4728         code = PerlIOMmap_map(aTHX_ f);
4729     }
4730     if (code == 0 && !(PerlIOBase(f)->flags & PERLIO_F_RDBUF)) {
4731         code = PerlIOBuf_fill(aTHX_ f);
4732     }
4733     return code;
4734 }
4735
4736 IV
4737 PerlIOMmap_close(pTHX_ PerlIO *f)
4738 {
4739     PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4740     PerlIOBuf * const b = &m->base;
4741     IV code = PerlIO_flush(f);
4742     if (m->bbuf) {
4743         b->buf = m->bbuf;
4744         m->bbuf = NULL;
4745         b->ptr = b->end = b->buf;
4746     }
4747     if (PerlIOBuf_close(aTHX_ f) != 0)
4748         code = -1;
4749     return code;
4750 }
4751
4752 PerlIO *
4753 PerlIOMmap_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
4754 {
4755  return PerlIOBase_dup(aTHX_ f, o, param, flags);
4756 }
4757
4758
4759 PERLIO_FUNCS_DECL(PerlIO_mmap) = {
4760     sizeof(PerlIO_funcs),
4761     "mmap",
4762     sizeof(PerlIOMmap),
4763     PERLIO_K_BUFFERED|PERLIO_K_RAW,
4764     PerlIOBuf_pushed,
4765     PerlIOBuf_popped,
4766     PerlIOBuf_open,
4767     PerlIOBase_binmode,         /* binmode */
4768     NULL,
4769     PerlIOBase_fileno,
4770     PerlIOMmap_dup,
4771     PerlIOBuf_read,
4772     PerlIOMmap_unread,
4773     PerlIOMmap_write,
4774     PerlIOBuf_seek,
4775     PerlIOBuf_tell,
4776     PerlIOBuf_close,
4777     PerlIOMmap_flush,
4778     PerlIOMmap_fill,
4779     PerlIOBase_eof,
4780     PerlIOBase_error,
4781     PerlIOBase_clearerr,
4782     PerlIOBase_setlinebuf,
4783     PerlIOMmap_get_base,
4784     PerlIOBuf_bufsiz,
4785     PerlIOBuf_get_ptr,
4786     PerlIOBuf_get_cnt,
4787     PerlIOBuf_set_ptrcnt,
4788 };
4789
4790 #endif                          /* HAS_MMAP */
4791
4792 PerlIO *
4793 Perl_PerlIO_stdin(pTHX)
4794 {
4795     dVAR;
4796     if (!PL_perlio) {
4797         PerlIO_stdstreams(aTHX);
4798     }
4799     return &PL_perlio[1];
4800 }
4801
4802 PerlIO *
4803 Perl_PerlIO_stdout(pTHX)
4804 {
4805     dVAR;
4806     if (!PL_perlio) {
4807         PerlIO_stdstreams(aTHX);
4808     }
4809     return &PL_perlio[2];
4810 }
4811
4812 PerlIO *
4813 Perl_PerlIO_stderr(pTHX)
4814 {
4815     dVAR;
4816     if (!PL_perlio) {
4817         PerlIO_stdstreams(aTHX);
4818     }
4819     return &PL_perlio[3];
4820 }
4821
4822 /*--------------------------------------------------------------------------------------*/
4823
4824 char *
4825 PerlIO_getname(PerlIO *f, char *buf)
4826 {
4827     dTHX;
4828 #ifdef VMS
4829     char *name = NULL;
4830     bool exported = FALSE;
4831     FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
4832     if (!stdio) {
4833         stdio = PerlIO_exportFILE(f,0);
4834         exported = TRUE;
4835     }
4836     if (stdio) {
4837         name = fgetname(stdio, buf);
4838         if (exported) PerlIO_releaseFILE(f,stdio);
4839     }
4840     return name;
4841 #else
4842     PERL_UNUSED_ARG(f);
4843     PERL_UNUSED_ARG(buf);
4844     Perl_croak(aTHX_ "Don't know how to get file name");
4845     return NULL;
4846 #endif
4847 }
4848
4849
4850 /*--------------------------------------------------------------------------------------*/
4851 /*
4852  * Functions which can be called on any kind of PerlIO implemented in
4853  * terms of above
4854  */
4855
4856 #undef PerlIO_fdopen
4857 PerlIO *
4858 PerlIO_fdopen(int fd, const char *mode)
4859 {
4860     dTHX;
4861     return PerlIO_openn(aTHX_ NULL, mode, fd, 0, 0, NULL, 0, NULL);
4862 }
4863
4864 #undef PerlIO_open
4865 PerlIO *
4866 PerlIO_open(const char *path, const char *mode)
4867 {
4868     dTHX;
4869     SV *name = sv_2mortal(newSVpv(path, 0));
4870     return PerlIO_openn(aTHX_ NULL, mode, -1, 0, 0, NULL, 1, &name);
4871 }
4872
4873 #undef Perlio_reopen
4874 PerlIO *
4875 PerlIO_reopen(const char *path, const char *mode, PerlIO *f)
4876 {
4877     dTHX;
4878     SV *name = sv_2mortal(newSVpv(path,0));
4879     return PerlIO_openn(aTHX_ NULL, mode, -1, 0, 0, f, 1, &name);
4880 }
4881
4882 #undef PerlIO_getc
4883 int
4884 PerlIO_getc(PerlIO *f)
4885 {
4886     dTHX;
4887     STDCHAR buf[1];
4888     if ( 1 == PerlIO_read(f, buf, 1) ) {
4889         return (unsigned char) buf[0];
4890     }
4891     return EOF;
4892 }
4893
4894 #undef PerlIO_ungetc
4895 int
4896 PerlIO_ungetc(PerlIO *f, int ch)
4897 {
4898     dTHX;
4899     if (ch != EOF) {
4900         STDCHAR buf = ch;
4901         if (PerlIO_unread(f, &buf, 1) == 1)
4902             return ch;
4903     }
4904     return EOF;
4905 }
4906
4907 #undef PerlIO_putc
4908 int
4909 PerlIO_putc(PerlIO *f, int ch)
4910 {
4911     dTHX;
4912     STDCHAR buf = ch;
4913     return PerlIO_write(f, &buf, 1);
4914 }
4915
4916 #undef PerlIO_puts
4917 int
4918 PerlIO_puts(PerlIO *f, const char *s)
4919 {
4920     dTHX;
4921     return PerlIO_write(f, s, strlen(s));
4922 }
4923
4924 #undef PerlIO_rewind
4925 void
4926 PerlIO_rewind(PerlIO *f)
4927 {
4928     dTHX;
4929     PerlIO_seek(f, (Off_t) 0, SEEK_SET);
4930     PerlIO_clearerr(f);
4931 }
4932
4933 #undef PerlIO_vprintf
4934 int
4935 PerlIO_vprintf(PerlIO *f, const char *fmt, va_list ap)
4936 {
4937     dTHX;
4938     SV * const sv = newSVpvs("");
4939     const char *s;
4940     STRLEN len;
4941     SSize_t wrote;
4942 #ifdef NEED_VA_COPY
4943     va_list apc;
4944     Perl_va_copy(ap, apc);
4945     sv_vcatpvf(sv, fmt, &apc);
4946 #else
4947     sv_vcatpvf(sv, fmt, &ap);
4948 #endif
4949     s = SvPV_const(sv, len);
4950     wrote = PerlIO_write(f, s, len);
4951     SvREFCNT_dec(sv);
4952     return wrote;
4953 }
4954
4955 #undef PerlIO_printf
4956 int
4957 PerlIO_printf(PerlIO *f, const char *fmt, ...)
4958 {
4959     va_list ap;
4960     int result;
4961     va_start(ap, fmt);
4962     result = PerlIO_vprintf(f, fmt, ap);
4963     va_end(ap);
4964     return result;
4965 }
4966
4967 #undef PerlIO_stdoutf
4968 int
4969 PerlIO_stdoutf(const char *fmt, ...)
4970 {
4971     dTHX;
4972     va_list ap;
4973     int result;
4974     va_start(ap, fmt);
4975     result = PerlIO_vprintf(PerlIO_stdout(), fmt, ap);
4976     va_end(ap);
4977     return result;
4978 }
4979
4980 #undef PerlIO_tmpfile
4981 PerlIO *
4982 PerlIO_tmpfile(void)
4983 {
4984      dTHX;
4985      PerlIO *f = NULL;
4986 #ifdef WIN32
4987      const int fd = win32_tmpfd();
4988      if (fd >= 0)
4989           f = PerlIO_fdopen(fd, "w+b");
4990 #else /* WIN32 */
4991 #    if defined(HAS_MKSTEMP) && ! defined(VMS) && ! defined(OS2)
4992      SV * const sv = newSVpvs("/tmp/PerlIO_XXXXXX");
4993      /*
4994       * I have no idea how portable mkstemp() is ... NI-S
4995       */
4996      const int fd = mkstemp(SvPVX(sv));
4997      if (fd >= 0) {
4998           f = PerlIO_fdopen(fd, "w+");
4999           if (f)
5000                PerlIOBase(f)->flags |= PERLIO_F_TEMP;
5001           PerlLIO_unlink(SvPVX_const(sv));
5002           SvREFCNT_dec(sv);
5003      }
5004 #    else       /* !HAS_MKSTEMP, fallback to stdio tmpfile(). */
5005      FILE * const stdio = PerlSIO_tmpfile();
5006
5007      if (stdio) {
5008           if ((f = PerlIO_push(aTHX_(PerlIO_allocate(aTHX)),
5009                                PERLIO_FUNCS_CAST(&PerlIO_stdio),
5010                                "w+", NULL))) {
5011                PerlIOStdio * const s = PerlIOSelf(f, PerlIOStdio);
5012
5013                if (s)
5014                     s->stdio = stdio;
5015           }
5016      }
5017 #    endif /* else HAS_MKSTEMP */
5018 #endif /* else WIN32 */
5019      return f;
5020 }
5021
5022 #undef HAS_FSETPOS
5023 #undef HAS_FGETPOS
5024
5025 #endif                          /* USE_SFIO */
5026 #endif                          /* PERLIO_IS_STDIO */
5027
5028 /*======================================================================================*/
5029 /*
5030  * Now some functions in terms of above which may be needed even if we are
5031  * not in true PerlIO mode
5032  */
5033
5034 #ifndef HAS_FSETPOS
5035 #undef PerlIO_setpos
5036 int
5037 PerlIO_setpos(PerlIO *f, SV *pos)
5038 {
5039     dTHX;
5040     if (SvOK(pos)) {
5041         STRLEN len;
5042         const Off_t * const posn = (Off_t *) SvPV(pos, len);
5043         if (f && len == sizeof(Off_t))
5044             return PerlIO_seek(f, *posn, SEEK_SET);
5045     }
5046     SETERRNO(EINVAL, SS_IVCHAN);
5047     return -1;
5048 }
5049 #else
5050 #undef PerlIO_setpos
5051 int
5052 PerlIO_setpos(PerlIO *f, SV *pos)
5053 {
5054     dTHX;
5055     if (SvOK(pos)) {
5056         STRLEN len;
5057         Fpos_t * const fpos = (Fpos_t *) SvPV(pos, len);
5058         if (f && len == sizeof(Fpos_t)) {
5059 #if defined(USE_64_BIT_STDIO) && defined(USE_FSETPOS64)
5060             return fsetpos64(f, fpos);
5061 #else
5062             return fsetpos(f, fpos);
5063 #endif
5064         }
5065     }
5066     SETERRNO(EINVAL, SS_IVCHAN);
5067     return -1;
5068 }
5069 #endif
5070
5071 #ifndef HAS_FGETPOS
5072 #undef PerlIO_getpos
5073 int
5074 PerlIO_getpos(PerlIO *f, SV *pos)
5075 {
5076     dTHX;
5077     Off_t posn = PerlIO_tell(f);
5078     sv_setpvn(pos, (char *) &posn, sizeof(posn));
5079     return (posn == (Off_t) - 1) ? -1 : 0;
5080 }
5081 #else
5082 #undef PerlIO_getpos
5083 int
5084 PerlIO_getpos(PerlIO *f, SV *pos)
5085 {
5086     dTHX;
5087     Fpos_t fpos;
5088     int code;
5089 #if defined(USE_64_BIT_STDIO) && defined(USE_FSETPOS64)
5090     code = fgetpos64(f, &fpos);
5091 #else
5092     code = fgetpos(f, &fpos);
5093 #endif
5094     sv_setpvn(pos, (char *) &fpos, sizeof(fpos));
5095     return code;
5096 }
5097 #endif
5098
5099 #if (defined(PERLIO_IS_STDIO) || !defined(USE_SFIO)) && !defined(HAS_VPRINTF)
5100
5101 int
5102 vprintf(char *pat, char *args)
5103 {
5104     _doprnt(pat, args, stdout);
5105     return 0;                   /* wrong, but perl doesn't use the return
5106                                  * value */
5107 }
5108
5109 int
5110 vfprintf(FILE *fd, char *pat, char *args)
5111 {
5112     _doprnt(pat, args, fd);
5113     return 0;                   /* wrong, but perl doesn't use the return
5114                                  * value */
5115 }
5116
5117 #endif
5118
5119 #ifndef PerlIO_vsprintf
5120 int
5121 PerlIO_vsprintf(char *s, int n, const char *fmt, va_list ap)
5122 {
5123     dVAR;
5124     const int val = vsprintf(s, fmt, ap);
5125     if (n >= 0) {
5126         if (strlen(s) >= (STRLEN) n) {
5127             dTHX;
5128             (void) PerlIO_puts(Perl_error_log,
5129                                "panic: sprintf overflow - memory corrupted!\n");
5130             my_exit(1);
5131         }
5132     }
5133     return val;
5134 }
5135 #endif
5136
5137 #ifndef PerlIO_sprintf
5138 int
5139 PerlIO_sprintf(char *s, int n, const char *fmt, ...)
5140 {
5141     va_list ap;
5142     int result;
5143     va_start(ap, fmt);
5144     result = PerlIO_vsprintf(s, n, fmt, ap);
5145     va_end(ap);
5146     return result;
5147 }
5148 #endif
5149
5150 /*
5151  * Local variables:
5152  * c-indentation-style: bsd
5153  * c-basic-offset: 4
5154  * indent-tabs-mode: t
5155  * End:
5156  *
5157  * ex: set ts=8 sts=4 sw=4 noet:
5158  */