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