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