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