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