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