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