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