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