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.
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.
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)
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
23 #ifdef PERL_IMPLICIT_SYS
33 # ifndef USE_CROSS_COMPILE
40 #define PERLIO_NOT_STDIO 0
41 #if !defined(PERLIO_IS_STDIO) && !defined(USE_SFIO)
47 * This file provides those parts of PerlIO abstraction
48 * which are not #defined in perlio.h.
49 * Which these are depends on various Configure #ifdef's
53 #define PERL_IN_PERLIO_C
56 #ifdef PERL_IMPLICIT_CONTEXT
64 /* Missing proto on LynxOS */
68 /* Call the callback or PerlIOBase, and return failure. */
69 #define Perl_PerlIO_or_Base(f, callback, base, failure, args) \
70 if (PerlIOValid(f)) { \
71 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;\
72 if (tab && tab->callback) \
73 return (*tab->callback) args; \
75 return PerlIOBase_ ## base args; \
78 SETERRNO(EBADF, SS_IVCHAN); \
81 /* Call the callback or fail, and return failure. */
82 #define Perl_PerlIO_or_fail(f, callback, failure, args) \
83 if (PerlIOValid(f)) { \
84 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;\
85 if (tab && tab->callback) \
86 return (*tab->callback) args; \
87 SETERRNO(EINVAL, LIB_INVARG); \
90 SETERRNO(EBADF, SS_IVCHAN); \
93 /* Call the callback or PerlIOBase, and be void. */
94 #define Perl_PerlIO_or_Base_void(f, callback, base, args) \
95 if (PerlIOValid(f)) { \
96 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;\
97 if (tab && tab->callback) \
98 (*tab->callback) args; \
100 PerlIOBase_ ## base args; \
103 SETERRNO(EBADF, SS_IVCHAN)
105 /* Call the callback or fail, and be void. */
106 #define Perl_PerlIO_or_fail_void(f, callback, args) \
107 if (PerlIOValid(f)) { \
108 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;\
109 if (tab && tab->callback) \
110 (*tab->callback) args; \
112 SETERRNO(EINVAL, LIB_INVARG); \
115 SETERRNO(EBADF, SS_IVCHAN)
117 #if defined(__osf__) && _XOPEN_SOURCE < 500
118 extern int fseeko(FILE *, off_t, int);
119 extern off_t ftello(FILE *);
124 EXTERN_C int perlsio_binmode(FILE *fp, int iotype, int mode);
127 perlsio_binmode(FILE *fp, int iotype, int mode)
130 * This used to be contents of do_binmode in doio.c
133 # if defined(atarist) || defined(__MINT__)
136 ((FILE *) fp)->_flag |= _IOBIN;
138 ((FILE *) fp)->_flag &= ~_IOBIN;
145 if (PerlLIO_setmode(fp, mode) != -1) {
147 if (PerlLIO_setmode(fileno(fp), mode) != -1) {
149 # if defined(WIN32) && defined(__BORLANDC__)
151 * The translation mode of the stream is maintained independent
153 * the translation mode of the fd in the Borland RTL (heavy
154 * digging through their runtime sources reveal). User has to
156 * the mode explicitly for the stream (though they don't
158 * this anywhere). GSAR 97-5-24
164 fp->flags &= ~_F_BIN;
172 # if defined(USEMYBINMODE)
174 if (my_binmode(fp, iotype, mode) != FALSE)
180 PERL_UNUSED_ARG(iotype);
181 PERL_UNUSED_ARG(mode);
189 #define O_ACCMODE 3 /* Assume traditional implementation */
193 PerlIO_intmode2str(int rawmode, char *mode, int *writing)
195 const int result = rawmode & O_ACCMODE;
200 ptype = IoTYPE_RDONLY;
203 ptype = IoTYPE_WRONLY;
211 *writing = (result != O_RDONLY);
213 if (result == O_RDONLY) {
217 else if (rawmode & O_APPEND) {
219 if (result != O_WRONLY)
224 if (result == O_WRONLY)
231 if (rawmode & O_BINARY)
237 #ifndef PERLIO_LAYERS
239 PerlIO_apply_layers(pTHX_ PerlIO *f, const char *mode, const char *names)
241 if (!names || !*names
242 || strEQ(names, ":crlf")
243 || strEQ(names, ":raw")
244 || strEQ(names, ":bytes")
248 Perl_croak(aTHX_ "Cannot apply \"%s\" in non-PerlIO perl", names);
256 PerlIO_destruct(pTHX)
261 PerlIO_binmode(pTHX_ PerlIO *fp, int iotype, int mode, const char *names)
264 PERL_UNUSED_ARG(iotype);
265 PERL_UNUSED_ARG(mode);
266 PERL_UNUSED_ARG(names);
269 return perlsio_binmode(fp, iotype, mode);
274 PerlIO_fdupopen(pTHX_ PerlIO *f, CLONE_PARAMS *param, int flags)
276 #if defined(PERL_MICRO) || defined(__SYMBIAN32__)
279 #ifdef PERL_IMPLICIT_SYS
280 return PerlSIO_fdupopen(f);
283 return win32_fdupopen(f);
286 const int fd = PerlLIO_dup(PerlIO_fileno(f));
290 const int omode = djgpp_get_stream_mode(f);
292 const int omode = fcntl(fd, F_GETFL);
294 PerlIO_intmode2str(omode,mode,NULL);
295 /* the r+ is a hack */
296 return PerlIO_fdopen(fd, mode);
301 SETERRNO(EBADF, SS_IVCHAN);
311 * De-mux PerlIO_openn() into fdopen, freopen and fopen type entries
315 PerlIO_openn(pTHX_ const char *layers, const char *mode, int fd,
316 int imode, int perm, PerlIO *old, int narg, SV **args)
320 Perl_croak(aTHX_ "More than one argument to open");
322 if (*args == &PL_sv_undef)
323 return PerlIO_tmpfile();
325 const char *name = SvPV_nolen_const(*args);
326 if (*mode == IoTYPE_NUMERIC) {
327 fd = PerlLIO_open3(name, imode, perm);
329 return PerlIO_fdopen(fd, mode + 1);
332 return PerlIO_reopen(name, mode, old);
335 return PerlIO_open(name, mode);
340 return PerlIO_fdopen(fd, (char *) mode);
345 XS(XS_PerlIO__Layer__find)
349 Perl_croak(aTHX_ "Usage class->find(name[,load])");
351 const char * const name = SvPV_nolen_const(ST(1));
352 ST(0) = (strEQ(name, "crlf")
353 || strEQ(name, "raw")) ? &PL_sv_yes : &PL_sv_undef;
360 Perl_boot_core_PerlIO(pTHX)
362 newXS("PerlIO::Layer::find", XS_PerlIO__Layer__find, __FILE__);
368 #ifdef PERLIO_IS_STDIO
375 * Does nothing (yet) except force this file to be included in perl
376 * binary. That allows this file to force inclusion of other functions
377 * that may be required by loadable extensions e.g. for
378 * FileHandle::tmpfile
382 #undef PerlIO_tmpfile
389 #else /* PERLIO_IS_STDIO */
397 * This section is just to make sure these functions get pulled in from
401 #undef PerlIO_tmpfile
413 * Force this file to be included in perl binary. Which allows this
414 * file to force inclusion of other functions that may be required by
415 * loadable extensions e.g. for FileHandle::tmpfile
419 * Hack sfio does its own 'autoflush' on stdout in common cases. Flush
420 * results in a lot of lseek()s to regular files and lot of small
423 sfset(sfstdout, SF_SHARE, 0);
426 /* This is not the reverse of PerlIO_exportFILE(), PerlIO_releaseFILE() is. */
428 PerlIO_importFILE(FILE *stdio, const char *mode)
430 const int fd = fileno(stdio);
431 if (!mode || !*mode) {
434 return PerlIO_fdopen(fd, mode);
438 PerlIO_findFILE(PerlIO *pio)
440 const int fd = PerlIO_fileno(pio);
441 FILE * const f = fdopen(fd, "r+");
443 if (!f && errno == EINVAL)
445 if (!f && errno == EINVAL)
452 /*======================================================================================*/
454 * Implement all the PerlIO interface ourselves.
460 * We _MUST_ have <unistd.h> if we are using lseek() and may have large
467 #include <sys/mman.h>
471 PerlIO_debug(const char *fmt, ...)
476 if (!PL_perlio_debug_fd) {
477 if (!PL_tainting && PL_uid == PL_euid && PL_gid == PL_egid) {
478 const char * const s = PerlEnv_getenv("PERLIO_DEBUG");
481 = PerlLIO_open3(s, O_WRONLY | O_CREAT | O_APPEND, 0666);
483 PL_perlio_debug_fd = -1;
485 /* tainting or set*id, so ignore the environment, and ensure we
486 skip these tests next time through. */
487 PL_perlio_debug_fd = -1;
490 if (PL_perlio_debug_fd > 0) {
493 const char * const s = CopFILE(PL_curcop);
494 /* Use fixed buffer as sv_catpvf etc. needs SVs */
496 const STRLEN len1 = my_snprintf(buffer, sizeof(buffer), "%.40s:%" IVdf " ", s ? s : "(none)", (IV) CopLINE(PL_curcop));
497 const STRLEN len2 = my_vsnprintf(buffer + len1, sizeof(buffer) - len1, fmt, ap);
498 PerlLIO_write(PL_perlio_debug_fd, buffer, len1 + len2);
500 const char *s = CopFILE(PL_curcop);
502 SV * const sv = newSVpvs("");
503 Perl_sv_catpvf(aTHX_ sv, "%s:%" IVdf " ", s ? s : "(none)",
504 (IV) CopLINE(PL_curcop));
505 Perl_sv_vcatpvf(aTHX_ sv, fmt, &ap);
507 s = SvPV_const(sv, len);
508 PerlLIO_write(PL_perlio_debug_fd, s, len);
515 /*--------------------------------------------------------------------------------------*/
518 * Inner level routines
522 * Table of pointers to the PerlIO structs (malloc'ed)
524 #define PERLIO_TABLE_SIZE 64
527 PerlIO_allocate(pTHX)
531 * Find a free slot in the table, allocating new table as necessary
536 while ((f = *last)) {
538 last = (PerlIO **) (f);
539 for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
545 Newxz(f,PERLIO_TABLE_SIZE,PerlIO);
553 #undef PerlIO_fdupopen
555 PerlIO_fdupopen(pTHX_ PerlIO *f, CLONE_PARAMS *param, int flags)
557 if (PerlIOValid(f)) {
558 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;
559 PerlIO_debug("fdupopen f=%p param=%p\n",(void*)f,(void*)param);
561 return (*tab->Dup)(aTHX_ PerlIO_allocate(aTHX), f, param, flags);
563 return PerlIOBase_dup(aTHX_ PerlIO_allocate(aTHX), f, param, flags);
567 SETERRNO(EBADF, SS_IVCHAN);
573 PerlIO_cleantable(pTHX_ PerlIO **tablep)
575 PerlIO * const table = *tablep;
578 PerlIO_cleantable(aTHX_(PerlIO **) & (table[0]));
579 for (i = PERLIO_TABLE_SIZE - 1; i > 0; i--) {
580 PerlIO * const f = table + i;
592 PerlIO_list_alloc(pTHX)
596 Newxz(list, 1, PerlIO_list_t);
602 PerlIO_list_free(pTHX_ PerlIO_list_t *list)
605 if (--list->refcnt == 0) {
608 for (i = 0; i < list->cur; i++) {
609 if (list->array[i].arg)
610 SvREFCNT_dec(list->array[i].arg);
612 Safefree(list->array);
620 PerlIO_list_push(pTHX_ PerlIO_list_t *list, PerlIO_funcs *funcs, SV *arg)
626 if (list->cur >= list->len) {
629 Renew(list->array, list->len, PerlIO_pair_t);
631 Newx(list->array, list->len, PerlIO_pair_t);
633 p = &(list->array[list->cur++]);
635 if ((p->arg = arg)) {
636 SvREFCNT_inc_simple_void_NN(arg);
641 PerlIO_clone_list(pTHX_ PerlIO_list_t *proto, CLONE_PARAMS *param)
643 PerlIO_list_t *list = NULL;
646 list = PerlIO_list_alloc(aTHX);
647 for (i=0; i < proto->cur; i++) {
649 if (proto->array[i].arg)
650 arg = PerlIO_sv_dup(aTHX_ proto->array[i].arg,param);
651 PerlIO_list_push(aTHX_ list, proto->array[i].funcs, arg);
658 PerlIO_clone(pTHX_ PerlInterpreter *proto, CLONE_PARAMS *param)
661 PerlIO **table = &proto->Iperlio;
664 PL_known_layers = PerlIO_clone_list(aTHX_ proto->Iknown_layers, param);
665 PL_def_layerlist = PerlIO_clone_list(aTHX_ proto->Idef_layerlist, param);
666 PerlIO_allocate(aTHX); /* root slot is never used */
667 PerlIO_debug("Clone %p from %p\n",(void*)aTHX,(void*)proto);
668 while ((f = *table)) {
670 table = (PerlIO **) (f++);
671 for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
673 (void) fp_dup(f, 0, param);
680 PERL_UNUSED_ARG(proto);
681 PERL_UNUSED_ARG(param);
686 PerlIO_destruct(pTHX)
689 PerlIO **table = &PL_perlio;
692 PerlIO_debug("Destruct %p\n",(void*)aTHX);
694 while ((f = *table)) {
696 table = (PerlIO **) (f++);
697 for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
701 if (l->tab->kind & PERLIO_K_DESTRUCT) {
702 PerlIO_debug("Destruct popping %s\n", l->tab->name);
716 PerlIO_pop(pTHX_ PerlIO *f)
718 const PerlIOl *l = *f;
720 PerlIO_debug("PerlIO_pop f=%p %s\n", (void*)f, l->tab->name);
721 if (l->tab->Popped) {
723 * If popped returns non-zero do not free its layer structure
724 * it has either done so itself, or it is shared and still in
727 if ((*l->tab->Popped) (aTHX_ f) != 0)
735 /* Return as an array the stack of layers on a filehandle. Note that
736 * the stack is returned top-first in the array, and there are three
737 * times as many array elements as there are layers in the stack: the
738 * first element of a layer triplet is the name, the second one is the
739 * arguments, and the third one is the flags. */
742 PerlIO_get_layers(pTHX_ PerlIO *f)
745 AV * const av = newAV();
747 if (PerlIOValid(f)) {
748 PerlIOl *l = PerlIOBase(f);
751 SV * const name = l->tab && l->tab->name ?
752 newSVpv(l->tab->name, 0) : &PL_sv_undef;
753 SV * const arg = l->tab && l->tab->Getarg ?
754 (*l->tab->Getarg)(aTHX_ &l, 0, 0) : &PL_sv_undef;
757 av_push(av, newSViv((IV)l->flags));
765 /*--------------------------------------------------------------------------------------*/
767 * XS Interface for perl code
771 PerlIO_find_layer(pTHX_ const char *name, STRLEN len, int load)
775 if ((SSize_t) len <= 0)
777 for (i = 0; i < PL_known_layers->cur; i++) {
778 PerlIO_funcs * const f = PL_known_layers->array[i].funcs;
779 if (memEQ(f->name, name, len) && f->name[len] == 0) {
780 PerlIO_debug("%.*s => %p\n", (int) len, name, (void*)f);
784 if (load && PL_subname && PL_def_layerlist
785 && PL_def_layerlist->cur >= 2) {
786 if (PL_in_load_module) {
787 Perl_croak(aTHX_ "Recursive call to Perl_load_module in PerlIO_find_layer");
790 SV * const pkgsv = newSVpvs("PerlIO");
791 SV * const layer = newSVpvn(name, len);
792 CV * const cv = get_cv("PerlIO::Layer::NoWarnings", FALSE);
794 SAVEINT(PL_in_load_module);
796 SAVEGENERICSV(PL_warnhook);
797 PL_warnhook = (SV *) (SvREFCNT_inc_simple_NN(cv));
801 * The two SVs are magically freed by load_module
803 Perl_load_module(aTHX_ 0, pkgsv, NULL, layer, NULL);
806 return PerlIO_find_layer(aTHX_ name, len, 0);
809 PerlIO_debug("Cannot find %.*s\n", (int) len, name);
813 #ifdef USE_ATTRIBUTES_FOR_PERLIO
816 perlio_mg_set(pTHX_ SV *sv, MAGIC *mg)
819 IO * const io = GvIOn((GV *) SvRV(sv));
820 PerlIO * const ifp = IoIFP(io);
821 PerlIO * const ofp = IoOFP(io);
822 Perl_warn(aTHX_ "set %" SVf " %p %p %p", sv, io, ifp, ofp);
828 perlio_mg_get(pTHX_ SV *sv, MAGIC *mg)
831 IO * const io = GvIOn((GV *) SvRV(sv));
832 PerlIO * const ifp = IoIFP(io);
833 PerlIO * const ofp = IoOFP(io);
834 Perl_warn(aTHX_ "get %" SVf " %p %p %p", sv, io, ifp, ofp);
840 perlio_mg_clear(pTHX_ SV *sv, MAGIC *mg)
842 Perl_warn(aTHX_ "clear %" SVf, sv);
847 perlio_mg_free(pTHX_ SV *sv, MAGIC *mg)
849 Perl_warn(aTHX_ "free %" SVf, sv);
853 MGVTBL perlio_vtab = {
861 XS(XS_io_MODIFY_SCALAR_ATTRIBUTES)
864 SV * const sv = SvRV(ST(1));
865 AV * const av = newAV();
869 sv_magic(sv, (SV *) av, PERL_MAGIC_ext, NULL, 0);
871 mg = mg_find(sv, PERL_MAGIC_ext);
872 mg->mg_virtual = &perlio_vtab;
874 Perl_warn(aTHX_ "attrib %" SVf, sv);
875 for (i = 2; i < items; i++) {
877 const char * const name = SvPV_const(ST(i), len);
878 SV * const layer = PerlIO_find_layer(aTHX_ name, len, 1);
880 av_push(av, SvREFCNT_inc_simple_NN(layer));
891 #endif /* USE_ATTIBUTES_FOR_PERLIO */
894 PerlIO_tab_sv(pTHX_ PerlIO_funcs *tab)
896 HV * const stash = gv_stashpvs("PerlIO::Layer", TRUE);
897 SV * const sv = sv_bless(newRV_noinc(newSViv(PTR2IV(tab))), stash);
901 XS(XS_PerlIO__Layer__NoWarnings)
903 /* This is used as a %SIG{__WARN__} handler to supress warnings
904 during loading of layers.
909 PerlIO_debug("warning:%s\n",SvPV_nolen_const(ST(0)));
913 XS(XS_PerlIO__Layer__find)
918 Perl_croak(aTHX_ "Usage class->find(name[,load])");
921 const char * const name = SvPV_const(ST(1), len);
922 const bool load = (items > 2) ? SvTRUE(ST(2)) : 0;
923 PerlIO_funcs * const layer = PerlIO_find_layer(aTHX_ name, len, load);
925 (layer) ? sv_2mortal(PerlIO_tab_sv(aTHX_ layer)) :
932 PerlIO_define_layer(pTHX_ PerlIO_funcs *tab)
935 if (!PL_known_layers)
936 PL_known_layers = PerlIO_list_alloc(aTHX);
937 PerlIO_list_push(aTHX_ PL_known_layers, tab, NULL);
938 PerlIO_debug("define %s %p\n", tab->name, (void*)tab);
942 PerlIO_parse_layers(pTHX_ PerlIO_list_t *av, const char *names)
946 const char *s = names;
948 while (isSPACE(*s) || *s == ':')
953 const char *as = NULL;
955 if (!isIDFIRST(*s)) {
957 * Message is consistent with how attribute lists are
958 * passed. Even though this means "foo : : bar" is
959 * seen as an invalid separator character.
961 const char q = ((*s == '\'') ? '"' : '\'');
962 if (ckWARN(WARN_LAYER))
963 Perl_warner(aTHX_ packWARN(WARN_LAYER),
964 "Invalid separator character %c%c%c in PerlIO layer specification %s",
966 SETERRNO(EINVAL, LIB_INVARG);
971 } while (isALNUM(*e));
987 * It's a nul terminated string, not allowed
988 * to \ the terminating null. Anything other
989 * character is passed over.
999 if (ckWARN(WARN_LAYER))
1000 Perl_warner(aTHX_ packWARN(WARN_LAYER),
1001 "Argument list not closed for PerlIO layer \"%.*s\"",
1013 PerlIO_funcs * const layer =
1014 PerlIO_find_layer(aTHX_ s, llen, 1);
1016 PerlIO_list_push(aTHX_ av, layer,
1022 if (ckWARN(WARN_LAYER))
1023 Perl_warner(aTHX_ packWARN(WARN_LAYER), "Unknown PerlIO layer \"%.*s\"",
1036 PerlIO_default_buffer(pTHX_ PerlIO_list_t *av)
1039 PERLIO_FUNCS_DECL(*tab) = &PerlIO_perlio;
1040 #ifdef PERLIO_USING_CRLF
1043 if (PerlIO_stdio.Set_ptrcnt)
1044 tab = &PerlIO_stdio;
1046 PerlIO_debug("Pushing %s\n", tab->name);
1047 PerlIO_list_push(aTHX_ av, PerlIO_find_layer(aTHX_ tab->name, 0, 0),
1052 PerlIO_arg_fetch(PerlIO_list_t *av, IV n)
1054 return av->array[n].arg;
1058 PerlIO_layer_fetch(pTHX_ PerlIO_list_t *av, IV n, PerlIO_funcs *def)
1060 if (n >= 0 && n < av->cur) {
1061 PerlIO_debug("Layer %" IVdf " is %s\n", n,
1062 av->array[n].funcs->name);
1063 return av->array[n].funcs;
1066 Perl_croak(aTHX_ "panic: PerlIO layer array corrupt");
1071 PerlIOPop_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
1073 PERL_UNUSED_ARG(mode);
1074 PERL_UNUSED_ARG(arg);
1075 PERL_UNUSED_ARG(tab);
1076 if (PerlIOValid(f)) {
1078 PerlIO_pop(aTHX_ f);
1084 PERLIO_FUNCS_DECL(PerlIO_remove) = {
1085 sizeof(PerlIO_funcs),
1088 PERLIO_K_DUMMY | PERLIO_K_UTF8,
1108 NULL, /* get_base */
1109 NULL, /* get_bufsiz */
1112 NULL, /* set_ptrcnt */
1116 PerlIO_default_layers(pTHX)
1119 if (!PL_def_layerlist) {
1120 const char * const s = (PL_tainting) ? NULL : PerlEnv_getenv("PERLIO");
1121 PERLIO_FUNCS_DECL(*osLayer) = &PerlIO_unix;
1122 PL_def_layerlist = PerlIO_list_alloc(aTHX);
1123 PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_unix));
1125 PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_win32));
1127 osLayer = &PerlIO_win32;
1130 PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_raw));
1131 PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_perlio));
1132 PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_stdio));
1133 PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_crlf));
1135 PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_mmap));
1137 PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_utf8));
1138 PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_remove));
1139 PerlIO_define_layer(aTHX_ PERLIO_FUNCS_CAST(&PerlIO_byte));
1140 PerlIO_list_push(aTHX_ PL_def_layerlist,
1141 PerlIO_find_layer(aTHX_ osLayer->name, 0, 0),
1144 PerlIO_parse_layers(aTHX_ PL_def_layerlist, s);
1147 PerlIO_default_buffer(aTHX_ PL_def_layerlist);
1150 if (PL_def_layerlist->cur < 2) {
1151 PerlIO_default_buffer(aTHX_ PL_def_layerlist);
1153 return PL_def_layerlist;
1157 Perl_boot_core_PerlIO(pTHX)
1159 #ifdef USE_ATTRIBUTES_FOR_PERLIO
1160 newXS("io::MODIFY_SCALAR_ATTRIBUTES", XS_io_MODIFY_SCALAR_ATTRIBUTES,
1163 newXS("PerlIO::Layer::find", XS_PerlIO__Layer__find, __FILE__);
1164 newXS("PerlIO::Layer::NoWarnings", XS_PerlIO__Layer__NoWarnings, __FILE__);
1168 PerlIO_default_layer(pTHX_ I32 n)
1171 PerlIO_list_t * const av = PerlIO_default_layers(aTHX);
1174 return PerlIO_layer_fetch(aTHX_ av, n, PERLIO_FUNCS_CAST(&PerlIO_stdio));
1177 #define PerlIO_default_top() PerlIO_default_layer(aTHX_ -1)
1178 #define PerlIO_default_btm() PerlIO_default_layer(aTHX_ 0)
1181 PerlIO_stdstreams(pTHX)
1185 PerlIO_allocate(aTHX);
1186 PerlIO_fdopen(0, "Ir" PERLIO_STDTEXT);
1187 PerlIO_fdopen(1, "Iw" PERLIO_STDTEXT);
1188 PerlIO_fdopen(2, "Iw" PERLIO_STDTEXT);
1193 PerlIO_push(pTHX_ PerlIO *f, PERLIO_FUNCS_DECL(*tab), const char *mode, SV *arg)
1195 if (tab->fsize != sizeof(PerlIO_funcs)) {
1197 Perl_croak(aTHX_ "Layer does not match this perl");
1201 if (tab->size < sizeof(PerlIOl)) {
1204 /* Real layer with a data area */
1207 Newxz(temp, tab->size, char);
1211 l->tab = (PerlIO_funcs*) tab;
1213 PerlIO_debug("PerlIO_push f=%p %s %s %p\n",
1214 (void*)f, tab->name,
1215 (mode) ? mode : "(Null)", (void*)arg);
1216 if (*l->tab->Pushed &&
1218 (aTHX_ f, mode, arg, (PerlIO_funcs*) tab) != 0) {
1219 PerlIO_pop(aTHX_ f);
1228 /* Pseudo-layer where push does its own stack adjust */
1229 PerlIO_debug("PerlIO_push f=%p %s %s %p\n", (void*)f, tab->name,
1230 (mode) ? mode : "(Null)", (void*)arg);
1232 (*tab->Pushed) (aTHX_ f, mode, arg, (PerlIO_funcs*) tab) != 0) {
1240 PerlIOBase_binmode(pTHX_ PerlIO *f)
1242 if (PerlIOValid(f)) {
1243 /* Is layer suitable for raw stream ? */
1244 if (PerlIOBase(f)->tab->kind & PERLIO_K_RAW) {
1245 /* Yes - turn off UTF-8-ness, to undo UTF-8 locale effects */
1246 PerlIOBase(f)->flags &= ~PERLIO_F_UTF8;
1249 /* Not suitable - pop it */
1250 PerlIO_pop(aTHX_ f);
1258 PerlIORaw_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
1260 PERL_UNUSED_ARG(mode);
1261 PERL_UNUSED_ARG(arg);
1262 PERL_UNUSED_ARG(tab);
1264 if (PerlIOValid(f)) {
1269 * Strip all layers that are not suitable for a raw stream
1272 while (t && (l = *t)) {
1273 if (l->tab->Binmode) {
1274 /* Has a handler - normal case */
1275 if ((*l->tab->Binmode)(aTHX_ f) == 0) {
1277 /* Layer still there - move down a layer */
1286 /* No handler - pop it */
1287 PerlIO_pop(aTHX_ t);
1290 if (PerlIOValid(f)) {
1291 PerlIO_debug(":raw f=%p :%s\n", (void*)f, PerlIOBase(f)->tab->name);
1299 PerlIO_apply_layera(pTHX_ PerlIO *f, const char *mode,
1300 PerlIO_list_t *layers, IV n, IV max)
1304 PerlIO_funcs * const tab = PerlIO_layer_fetch(aTHX_ layers, n, NULL);
1306 if (!PerlIO_push(aTHX_ f, tab, mode, PerlIOArg)) {
1317 PerlIO_apply_layers(pTHX_ PerlIO *f, const char *mode, const char *names)
1321 PerlIO_list_t * const layers = PerlIO_list_alloc(aTHX);
1322 code = PerlIO_parse_layers(aTHX_ layers, names);
1324 code = PerlIO_apply_layera(aTHX_ f, mode, layers, 0, layers->cur);
1326 PerlIO_list_free(aTHX_ layers);
1332 /*--------------------------------------------------------------------------------------*/
1334 * Given the abstraction above the public API functions
1338 PerlIO_binmode(pTHX_ PerlIO *f, int iotype, int mode, const char *names)
1340 PerlIO_debug("PerlIO_binmode f=%p %s %c %x %s\n", (void*)f,
1341 (PerlIOBase(f)) ? PerlIOBase(f)->tab->name : "(Null)",
1342 iotype, mode, (names) ? names : "(Null)");
1345 /* Do not flush etc. if (e.g.) switching encodings.
1346 if a pushed layer knows it needs to flush lower layers
1347 (for example :unix which is never going to call them)
1348 it can do the flush when it is pushed.
1350 return PerlIO_apply_layers(aTHX_ f, NULL, names) == 0 ? TRUE : FALSE;
1353 /* Fake 5.6 legacy of using this call to turn ON O_TEXT */
1354 #ifdef PERLIO_USING_CRLF
1355 /* Legacy binmode only has meaning if O_TEXT has a value distinct from
1356 O_BINARY so we can look for it in mode.
1358 if (!(mode & O_BINARY)) {
1360 /* FIXME?: Looking down the layer stack seems wrong,
1361 but is a way of reaching past (say) an encoding layer
1362 to flip CRLF-ness of the layer(s) below
1365 /* Perhaps we should turn on bottom-most aware layer
1366 e.g. Ilya's idea that UNIX TTY could serve
1368 if (PerlIOBase(f)->tab->kind & PERLIO_K_CANCRLF) {
1369 if (!(PerlIOBase(f)->flags & PERLIO_F_CRLF)) {
1370 /* Not in text mode - flush any pending stuff and flip it */
1372 PerlIOBase(f)->flags |= PERLIO_F_CRLF;
1374 /* Only need to turn it on in one layer so we are done */
1379 /* Not finding a CRLF aware layer presumably means we are binary
1380 which is not what was requested - so we failed
1381 We _could_ push :crlf layer but so could caller
1386 /* Legacy binmode is now _defined_ as being equivalent to pushing :raw
1387 So code that used to be here is now in PerlIORaw_pushed().
1389 return PerlIO_push(aTHX_ f, PERLIO_FUNCS_CAST(&PerlIO_raw), NULL, NULL) ? TRUE : FALSE;
1394 PerlIO__close(pTHX_ PerlIO *f)
1396 if (PerlIOValid(f)) {
1397 PerlIO_funcs * const tab = PerlIOBase(f)->tab;
1398 if (tab && tab->Close)
1399 return (*tab->Close)(aTHX_ f);
1401 return PerlIOBase_close(aTHX_ f);
1404 SETERRNO(EBADF, SS_IVCHAN);
1410 Perl_PerlIO_close(pTHX_ PerlIO *f)
1412 const int code = PerlIO__close(aTHX_ f);
1413 while (PerlIOValid(f)) {
1414 PerlIO_pop(aTHX_ f);
1420 Perl_PerlIO_fileno(pTHX_ PerlIO *f)
1423 Perl_PerlIO_or_Base(f, Fileno, fileno, -1, (aTHX_ f));
1427 static PerlIO_funcs *
1428 PerlIO_layer_from_ref(pTHX_ SV *sv)
1432 * For any scalar type load the handler which is bundled with perl
1434 if (SvTYPE(sv) < SVt_PVAV) {
1435 PerlIO_funcs *f = PerlIO_find_layer(aTHX_ STR_WITH_LEN("scalar"), 1);
1436 /* This isn't supposed to happen, since PerlIO::scalar is core,
1437 * but could happen anyway in smaller installs or with PAR */
1438 if (!f && ckWARN(WARN_LAYER))
1439 Perl_warner(aTHX_ packWARN(WARN_LAYER), "Unknown PerlIO layer \"scalar\"");
1444 * For other types allow if layer is known but don't try and load it
1446 switch (SvTYPE(sv)) {
1448 return PerlIO_find_layer(aTHX_ STR_WITH_LEN("Array"), 0);
1450 return PerlIO_find_layer(aTHX_ STR_WITH_LEN("Hash"), 0);
1452 return PerlIO_find_layer(aTHX_ STR_WITH_LEN("Code"), 0);
1454 return PerlIO_find_layer(aTHX_ STR_WITH_LEN("Glob"), 0);
1461 PerlIO_resolve_layers(pTHX_ const char *layers,
1462 const char *mode, int narg, SV **args)
1465 PerlIO_list_t *def = PerlIO_default_layers(aTHX);
1468 PerlIO_stdstreams(aTHX);
1470 SV * const arg = *args;
1472 * If it is a reference but not an object see if we have a handler
1475 if (SvROK(arg) && !sv_isobject(arg)) {
1476 PerlIO_funcs * const handler = PerlIO_layer_from_ref(aTHX_ SvRV(arg));
1478 def = PerlIO_list_alloc(aTHX);
1479 PerlIO_list_push(aTHX_ def, handler, &PL_sv_undef);
1483 * Don't fail if handler cannot be found :via(...) etc. may do
1484 * something sensible else we will just stringfy and open
1489 if (!layers || !*layers)
1490 layers = Perl_PerlIO_context_layers(aTHX_ mode);
1491 if (layers && *layers) {
1495 av = PerlIO_list_alloc(aTHX);
1496 for (i = 0; i < def->cur; i++) {
1497 PerlIO_list_push(aTHX_ av, def->array[i].funcs,
1504 if (PerlIO_parse_layers(aTHX_ av, layers) == 0) {
1508 PerlIO_list_free(aTHX_ av);
1520 PerlIO_openn(pTHX_ const char *layers, const char *mode, int fd,
1521 int imode, int perm, PerlIO *f, int narg, SV **args)
1524 if (!f && narg == 1 && *args == &PL_sv_undef) {
1525 if ((f = PerlIO_tmpfile())) {
1526 if (!layers || !*layers)
1527 layers = Perl_PerlIO_context_layers(aTHX_ mode);
1528 if (layers && *layers)
1529 PerlIO_apply_layers(aTHX_ f, mode, layers);
1533 PerlIO_list_t *layera;
1535 PerlIO_funcs *tab = NULL;
1536 if (PerlIOValid(f)) {
1538 * This is "reopen" - it is not tested as perl does not use it
1542 layera = PerlIO_list_alloc(aTHX);
1544 SV * const arg = (l->tab->Getarg)
1545 ? (*l->tab->Getarg) (aTHX_ &l, NULL, 0)
1547 PerlIO_list_push(aTHX_ layera, l->tab, arg);
1548 l = *PerlIONext(&l);
1552 layera = PerlIO_resolve_layers(aTHX_ layers, mode, narg, args);
1558 * Start at "top" of layer stack
1560 n = layera->cur - 1;
1562 PerlIO_funcs * const t = PerlIO_layer_fetch(aTHX_ layera, n, NULL);
1571 * Found that layer 'n' can do opens - call it
1573 if (narg > 1 && !(tab->kind & PERLIO_K_MULTIARG)) {
1574 Perl_croak(aTHX_ "More than one argument to open(,':%s')",tab->name);
1576 PerlIO_debug("openn(%s,'%s','%s',%d,%x,%o,%p,%d,%p)\n",
1577 tab->name, layers ? layers : "(Null)", mode, fd,
1578 imode, perm, (void*)f, narg, (void*)args);
1580 f = (*tab->Open) (aTHX_ tab, layera, n, mode, fd, imode, perm,
1583 SETERRNO(EINVAL, LIB_INVARG);
1587 if (n + 1 < layera->cur) {
1589 * More layers above the one that we used to open -
1592 if (PerlIO_apply_layera(aTHX_ f, mode, layera, n + 1, layera->cur) != 0) {
1593 /* If pushing layers fails close the file */
1600 PerlIO_list_free(aTHX_ layera);
1607 Perl_PerlIO_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
1609 Perl_PerlIO_or_Base(f, Read, read, -1, (aTHX_ f, vbuf, count));
1613 Perl_PerlIO_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
1615 Perl_PerlIO_or_Base(f, Unread, unread, -1, (aTHX_ f, vbuf, count));
1619 Perl_PerlIO_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
1621 Perl_PerlIO_or_fail(f, Write, -1, (aTHX_ f, vbuf, count));
1625 Perl_PerlIO_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
1627 Perl_PerlIO_or_fail(f, Seek, -1, (aTHX_ f, offset, whence));
1631 Perl_PerlIO_tell(pTHX_ PerlIO *f)
1633 Perl_PerlIO_or_fail(f, Tell, -1, (aTHX_ f));
1637 Perl_PerlIO_flush(pTHX_ PerlIO *f)
1642 const PerlIO_funcs *tab = PerlIOBase(f)->tab;
1644 if (tab && tab->Flush)
1645 return (*tab->Flush) (aTHX_ f);
1647 return 0; /* If no Flush defined, silently succeed. */
1650 PerlIO_debug("Cannot flush f=%p\n", (void*)f);
1651 SETERRNO(EBADF, SS_IVCHAN);
1657 * Is it good API design to do flush-all on NULL, a potentially
1658 * errorneous input? Maybe some magical value (PerlIO*
1659 * PERLIO_FLUSH_ALL = (PerlIO*)-1;)? Yes, stdio does similar
1660 * things on fflush(NULL), but should we be bound by their design
1663 PerlIO **table = &PL_perlio;
1665 while ((f = *table)) {
1667 table = (PerlIO **) (f++);
1668 for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
1669 if (*f && PerlIO_flush(f) != 0)
1679 PerlIOBase_flush_linebuf(pTHX)
1682 PerlIO **table = &PL_perlio;
1684 while ((f = *table)) {
1686 table = (PerlIO **) (f++);
1687 for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
1690 flags & (PERLIO_F_LINEBUF | PERLIO_F_CANWRITE))
1691 == (PERLIO_F_LINEBUF | PERLIO_F_CANWRITE))
1699 Perl_PerlIO_fill(pTHX_ PerlIO *f)
1701 Perl_PerlIO_or_fail(f, Fill, -1, (aTHX_ f));
1705 PerlIO_isutf8(PerlIO *f)
1708 return (PerlIOBase(f)->flags & PERLIO_F_UTF8) != 0;
1710 SETERRNO(EBADF, SS_IVCHAN);
1716 Perl_PerlIO_eof(pTHX_ PerlIO *f)
1718 Perl_PerlIO_or_Base(f, Eof, eof, -1, (aTHX_ f));
1722 Perl_PerlIO_error(pTHX_ PerlIO *f)
1724 Perl_PerlIO_or_Base(f, Error, error, -1, (aTHX_ f));
1728 Perl_PerlIO_clearerr(pTHX_ PerlIO *f)
1730 Perl_PerlIO_or_Base_void(f, Clearerr, clearerr, (aTHX_ f));
1734 Perl_PerlIO_setlinebuf(pTHX_ PerlIO *f)
1736 Perl_PerlIO_or_Base_void(f, Setlinebuf, setlinebuf, (aTHX_ f));
1740 PerlIO_has_base(PerlIO *f)
1742 if (PerlIOValid(f)) {
1743 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;
1746 return (tab->Get_base != NULL);
1747 SETERRNO(EINVAL, LIB_INVARG);
1750 SETERRNO(EBADF, SS_IVCHAN);
1756 PerlIO_fast_gets(PerlIO *f)
1758 if (PerlIOValid(f) && (PerlIOBase(f)->flags & PERLIO_F_FASTGETS)) {
1759 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;
1762 return (tab->Set_ptrcnt != NULL);
1763 SETERRNO(EINVAL, LIB_INVARG);
1766 SETERRNO(EBADF, SS_IVCHAN);
1772 PerlIO_has_cntptr(PerlIO *f)
1774 if (PerlIOValid(f)) {
1775 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;
1778 return (tab->Get_ptr != NULL && tab->Get_cnt != NULL);
1779 SETERRNO(EINVAL, LIB_INVARG);
1782 SETERRNO(EBADF, SS_IVCHAN);
1788 PerlIO_canset_cnt(PerlIO *f)
1790 if (PerlIOValid(f)) {
1791 const PerlIO_funcs * const tab = PerlIOBase(f)->tab;
1794 return (tab->Set_ptrcnt != NULL);
1795 SETERRNO(EINVAL, LIB_INVARG);
1798 SETERRNO(EBADF, SS_IVCHAN);
1804 Perl_PerlIO_get_base(pTHX_ PerlIO *f)
1806 Perl_PerlIO_or_fail(f, Get_base, NULL, (aTHX_ f));
1810 Perl_PerlIO_get_bufsiz(pTHX_ PerlIO *f)
1812 Perl_PerlIO_or_fail(f, Get_bufsiz, -1, (aTHX_ f));
1816 Perl_PerlIO_get_ptr(pTHX_ PerlIO *f)
1818 Perl_PerlIO_or_fail(f, Get_ptr, NULL, (aTHX_ f));
1822 Perl_PerlIO_get_cnt(pTHX_ PerlIO *f)
1824 Perl_PerlIO_or_fail(f, Get_cnt, -1, (aTHX_ f));
1828 Perl_PerlIO_set_cnt(pTHX_ PerlIO *f, int cnt)
1830 Perl_PerlIO_or_fail_void(f, Set_ptrcnt, (aTHX_ f, NULL, cnt));
1834 Perl_PerlIO_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, int cnt)
1836 Perl_PerlIO_or_fail_void(f, Set_ptrcnt, (aTHX_ f, ptr, cnt));
1840 /*--------------------------------------------------------------------------------------*/
1842 * utf8 and raw dummy layers
1846 PerlIOUtf8_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
1848 PERL_UNUSED_CONTEXT;
1849 PERL_UNUSED_ARG(mode);
1850 PERL_UNUSED_ARG(arg);
1851 if (PerlIOValid(f)) {
1852 if (tab->kind & PERLIO_K_UTF8)
1853 PerlIOBase(f)->flags |= PERLIO_F_UTF8;
1855 PerlIOBase(f)->flags &= ~PERLIO_F_UTF8;
1861 PERLIO_FUNCS_DECL(PerlIO_utf8) = {
1862 sizeof(PerlIO_funcs),
1865 PERLIO_K_DUMMY | PERLIO_K_UTF8,
1885 NULL, /* get_base */
1886 NULL, /* get_bufsiz */
1889 NULL, /* set_ptrcnt */
1892 PERLIO_FUNCS_DECL(PerlIO_byte) = {
1893 sizeof(PerlIO_funcs),
1916 NULL, /* get_base */
1917 NULL, /* get_bufsiz */
1920 NULL, /* set_ptrcnt */
1924 PerlIORaw_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
1925 IV n, const char *mode, int fd, int imode, int perm,
1926 PerlIO *old, int narg, SV **args)
1928 PerlIO_funcs * const tab = PerlIO_default_btm();
1929 PERL_UNUSED_ARG(self);
1930 if (tab && tab->Open)
1931 return (*tab->Open) (aTHX_ tab, layers, n - 1, mode, fd, imode, perm,
1933 SETERRNO(EINVAL, LIB_INVARG);
1937 PERLIO_FUNCS_DECL(PerlIO_raw) = {
1938 sizeof(PerlIO_funcs),
1961 NULL, /* get_base */
1962 NULL, /* get_bufsiz */
1965 NULL, /* set_ptrcnt */
1967 /*--------------------------------------------------------------------------------------*/
1968 /*--------------------------------------------------------------------------------------*/
1970 * "Methods" of the "base class"
1974 PerlIOBase_fileno(pTHX_ PerlIO *f)
1976 return PerlIOValid(f) ? PerlIO_fileno(PerlIONext(f)) : -1;
1980 PerlIO_modestr(PerlIO * f, char *buf)
1983 if (PerlIOValid(f)) {
1984 const IV flags = PerlIOBase(f)->flags;
1985 if (flags & PERLIO_F_APPEND) {
1987 if (flags & PERLIO_F_CANREAD) {
1991 else if (flags & PERLIO_F_CANREAD) {
1993 if (flags & PERLIO_F_CANWRITE)
1996 else if (flags & PERLIO_F_CANWRITE) {
1998 if (flags & PERLIO_F_CANREAD) {
2002 #ifdef PERLIO_USING_CRLF
2003 if (!(flags & PERLIO_F_CRLF))
2013 PerlIOBase_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
2015 PerlIOl * const l = PerlIOBase(f);
2016 PERL_UNUSED_CONTEXT;
2017 PERL_UNUSED_ARG(arg);
2019 l->flags &= ~(PERLIO_F_CANREAD | PERLIO_F_CANWRITE |
2020 PERLIO_F_TRUNCATE | PERLIO_F_APPEND);
2021 if (tab->Set_ptrcnt != NULL)
2022 l->flags |= PERLIO_F_FASTGETS;
2024 if (*mode == IoTYPE_NUMERIC || *mode == IoTYPE_IMPLICIT)
2028 l->flags |= PERLIO_F_CANREAD;
2031 l->flags |= PERLIO_F_APPEND | PERLIO_F_CANWRITE;
2034 l->flags |= PERLIO_F_TRUNCATE | PERLIO_F_CANWRITE;
2037 SETERRNO(EINVAL, LIB_INVARG);
2043 l->flags |= PERLIO_F_CANREAD | PERLIO_F_CANWRITE;
2046 l->flags &= ~PERLIO_F_CRLF;
2049 l->flags |= PERLIO_F_CRLF;
2052 SETERRNO(EINVAL, LIB_INVARG);
2059 l->flags |= l->next->flags &
2060 (PERLIO_F_CANREAD | PERLIO_F_CANWRITE | PERLIO_F_TRUNCATE |
2065 PerlIO_debug("PerlIOBase_pushed f=%p %s %s fl=%08" UVxf " (%s)\n",
2066 f, PerlIOBase(f)->tab->name, (omode) ? omode : "(Null)",
2067 l->flags, PerlIO_modestr(f, temp));
2073 PerlIOBase_popped(pTHX_ PerlIO *f)
2075 PERL_UNUSED_CONTEXT;
2081 PerlIOBase_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
2084 * Save the position as current head considers it
2086 const Off_t old = PerlIO_tell(f);
2087 PerlIO_push(aTHX_ f, PERLIO_FUNCS_CAST(&PerlIO_pending), "r", NULL);
2088 PerlIOSelf(f, PerlIOBuf)->posn = old;
2089 return PerlIOBuf_unread(aTHX_ f, vbuf, count);
2093 PerlIOBase_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
2095 STDCHAR *buf = (STDCHAR *) vbuf;
2097 if (!(PerlIOBase(f)->flags & PERLIO_F_CANREAD)) {
2098 PerlIOBase(f)->flags |= PERLIO_F_ERROR;
2099 SETERRNO(EBADF, SS_IVCHAN);
2105 SSize_t avail = PerlIO_get_cnt(f);
2108 take = ((SSize_t)count < avail) ? (SSize_t)count : avail;
2110 STDCHAR *ptr = PerlIO_get_ptr(f);
2111 Copy(ptr, buf, take, STDCHAR);
2112 PerlIO_set_ptrcnt(f, ptr + take, (avail -= take));
2115 if (avail == 0) /* set_ptrcnt could have reset avail */
2118 if (count > 0 && avail <= 0) {
2119 if (PerlIO_fill(f) != 0)
2124 return (buf - (STDCHAR *) vbuf);
2130 PerlIOBase_noop_ok(pTHX_ PerlIO *f)
2132 PERL_UNUSED_CONTEXT;
2138 PerlIOBase_noop_fail(pTHX_ PerlIO *f)
2140 PERL_UNUSED_CONTEXT;
2146 PerlIOBase_close(pTHX_ PerlIO *f)
2149 if (PerlIOValid(f)) {
2150 PerlIO *n = PerlIONext(f);
2151 code = PerlIO_flush(f);
2152 PerlIOBase(f)->flags &=
2153 ~(PERLIO_F_CANREAD | PERLIO_F_CANWRITE | PERLIO_F_OPEN);
2154 while (PerlIOValid(n)) {
2155 const PerlIO_funcs * const tab = PerlIOBase(n)->tab;
2156 if (tab && tab->Close) {
2157 if ((*tab->Close)(aTHX_ n) != 0)
2162 PerlIOBase(n)->flags &=
2163 ~(PERLIO_F_CANREAD | PERLIO_F_CANWRITE | PERLIO_F_OPEN);
2169 SETERRNO(EBADF, SS_IVCHAN);
2175 PerlIOBase_eof(pTHX_ PerlIO *f)
2177 PERL_UNUSED_CONTEXT;
2178 if (PerlIOValid(f)) {
2179 return (PerlIOBase(f)->flags & PERLIO_F_EOF) != 0;
2185 PerlIOBase_error(pTHX_ PerlIO *f)
2187 PERL_UNUSED_CONTEXT;
2188 if (PerlIOValid(f)) {
2189 return (PerlIOBase(f)->flags & PERLIO_F_ERROR) != 0;
2195 PerlIOBase_clearerr(pTHX_ PerlIO *f)
2197 if (PerlIOValid(f)) {
2198 PerlIO * const n = PerlIONext(f);
2199 PerlIOBase(f)->flags &= ~(PERLIO_F_ERROR | PERLIO_F_EOF);
2206 PerlIOBase_setlinebuf(pTHX_ PerlIO *f)
2208 PERL_UNUSED_CONTEXT;
2209 if (PerlIOValid(f)) {
2210 PerlIOBase(f)->flags |= PERLIO_F_LINEBUF;
2215 PerlIO_sv_dup(pTHX_ SV *arg, CLONE_PARAMS *param)
2221 return sv_dup(arg, param);
2224 return newSVsv(arg);
2227 PERL_UNUSED_ARG(param);
2228 return newSVsv(arg);
2233 PerlIOBase_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
2235 PerlIO * const nexto = PerlIONext(o);
2236 if (PerlIOValid(nexto)) {
2237 const PerlIO_funcs * const tab = PerlIOBase(nexto)->tab;
2238 if (tab && tab->Dup)
2239 f = (*tab->Dup)(aTHX_ f, nexto, param, flags);
2241 f = PerlIOBase_dup(aTHX_ f, nexto, param, flags);
2244 PerlIO_funcs * const self = PerlIOBase(o)->tab;
2247 PerlIO_debug("PerlIOBase_dup %s f=%p o=%p param=%p\n",
2248 self->name, (void*)f, (void*)o, (void*)param);
2250 arg = (*self->Getarg)(aTHX_ o, param, flags);
2254 f = PerlIO_push(aTHX_ f, self, PerlIO_modestr(o,buf), arg);
2262 /* PL_perlio_fd_refcnt[] is in intrpvar.h */
2264 /* Must be called with PL_perlio_mutex locked. */
2266 S_more_refcounted_fds(pTHX_ const int new_fd) {
2268 const int old_max = PL_perlio_fd_refcnt_size;
2269 const int new_max = 16 + (new_fd & ~15);
2272 PerlIO_debug("More fds - old=%d, need %d, new=%d\n",
2273 old_max, new_fd, new_max);
2275 if (new_fd < old_max) {
2279 assert (new_max > new_fd);
2282 (int*) PerlMemShared_realloc(PL_perlio_fd_refcnt, new_max * sizeof(int));
2286 MUTEX_UNLOCK(&PL_perlio_mutex);
2288 /* Can't use PerlIO to write as it allocates memory */
2289 PerlLIO_write(PerlIO_fileno(Perl_error_log),
2290 PL_no_mem, strlen(PL_no_mem));
2294 PL_perlio_fd_refcnt_size = new_max;
2295 PL_perlio_fd_refcnt = new_array;
2297 PerlIO_debug("Zeroing %p, %d\n",
2298 (void*)(new_array + old_max),
2301 Zero(new_array + old_max, new_max - old_max, int);
2308 /* MUTEX_INIT(&PL_perlio_mutex) is done in PERL_SYS_INIT3(). */
2309 PERL_UNUSED_CONTEXT;
2313 PerlIOUnix_refcnt_inc(int fd)
2320 MUTEX_LOCK(&PL_perlio_mutex);
2322 if (fd >= PL_perlio_fd_refcnt_size)
2323 S_more_refcounted_fds(aTHX_ fd);
2325 PL_perlio_fd_refcnt[fd]++;
2326 if (PL_perlio_fd_refcnt[fd] <= 0) {
2327 Perl_croak(aTHX_ "refcnt_inc: fd %d: %d <= 0\n",
2328 fd, PL_perlio_fd_refcnt[fd]);
2330 PerlIO_debug("refcnt_inc: fd %d refcnt=%d\n",
2331 fd, PL_perlio_fd_refcnt[fd]);
2334 MUTEX_UNLOCK(&PL_perlio_mutex);
2337 Perl_croak(aTHX_ "refcnt_inc: fd %d < 0\n", fd);
2342 PerlIOUnix_refcnt_dec(int fd)
2349 MUTEX_LOCK(&PL_perlio_mutex);
2351 if (fd >= PL_perlio_fd_refcnt_size) {
2352 Perl_croak(aTHX_ "refcnt_dec: fd %d >= refcnt_size %d\n",
2353 fd, PL_perlio_fd_refcnt_size);
2355 if (PL_perlio_fd_refcnt[fd] <= 0) {
2356 Perl_croak(aTHX_ "refcnt_dec: fd %d: %d <= 0\n",
2357 fd, PL_perlio_fd_refcnt[fd]);
2359 cnt = --PL_perlio_fd_refcnt[fd];
2360 PerlIO_debug("refcnt_dec: fd %d refcnt=%d\n", fd, cnt);
2362 MUTEX_UNLOCK(&PL_perlio_mutex);
2365 Perl_croak(aTHX_ "refcnt_dec: fd %d < 0\n", fd);
2371 PerlIO_cleanup(pTHX)
2376 PerlIO_debug("Cleanup layers for %p\n",(void*)aTHX);
2378 PerlIO_debug("Cleanup layers\n");
2381 /* Raise STDIN..STDERR refcount so we don't close them */
2382 for (i=0; i < 3; i++)
2383 PerlIOUnix_refcnt_inc(i);
2384 PerlIO_cleantable(aTHX_ &PL_perlio);
2385 /* Restore STDIN..STDERR refcount */
2386 for (i=0; i < 3; i++)
2387 PerlIOUnix_refcnt_dec(i);
2389 if (PL_known_layers) {
2390 PerlIO_list_free(aTHX_ PL_known_layers);
2391 PL_known_layers = NULL;
2393 if (PL_def_layerlist) {
2394 PerlIO_list_free(aTHX_ PL_def_layerlist);
2395 PL_def_layerlist = NULL;
2399 void PerlIO_teardown(pTHX) /* Call only from PERL_SYS_TERM(). */
2403 /* By now all filehandles should have been closed, so any
2404 * stray (non-STD-)filehandles indicate *possible* (PerlIO)
2407 for (i = 3; i < PL_perlio_fd_refcnt_size; i++) {
2408 if (PL_perlio_fd_refcnt[i])
2409 PerlIO_debug("PerlIO_cleanup: fd %d refcnt=%d\n",
2410 i, PL_perlio_fd_refcnt[i]);
2415 MUTEX_LOCK(&PL_perlio_mutex);
2417 if (PL_perlio_fd_refcnt_size /* Assuming initial size of zero. */
2418 && PL_perlio_fd_refcnt) {
2419 #ifdef PERL_TRACK_MEMPOOL
2420 Malloc_t ptr = (Malloc_t)((char*)PL_perlio_fd_refcnt-sTHX);
2421 struct perl_memory_debug_header *const header
2422 = (struct perl_memory_debug_header *)ptr;
2423 /* Only the thread that allocated us can free us. */
2424 if (header->interpreter == aTHX)
2427 PerlMemShared_free(PL_perlio_fd_refcnt); /* Not Safefree() because was allocated with PerlMemShared_realloc(). */
2428 PL_perlio_fd_refcnt = NULL;
2429 PL_perlio_fd_refcnt_size = 0;
2433 MUTEX_UNLOCK(&PL_perlio_mutex);
2439 /*--------------------------------------------------------------------------------------*/
2441 * Bottom-most level for UNIX-like case
2445 struct _PerlIO base; /* The generic part */
2446 int fd; /* UNIX like file descriptor */
2447 int oflags; /* open/fcntl flags */
2451 PerlIOUnix_oflags(const char *mode)
2454 if (*mode == IoTYPE_IMPLICIT || *mode == IoTYPE_NUMERIC)
2459 if (*++mode == '+') {
2466 oflags = O_CREAT | O_TRUNC;
2467 if (*++mode == '+') {
2476 oflags = O_CREAT | O_APPEND;
2477 if (*++mode == '+') {
2490 else if (*mode == 't') {
2492 oflags &= ~O_BINARY;
2496 * Always open in binary mode
2499 if (*mode || oflags == -1) {
2500 SETERRNO(EINVAL, LIB_INVARG);
2507 PerlIOUnix_fileno(pTHX_ PerlIO *f)
2509 PERL_UNUSED_CONTEXT;
2510 return PerlIOSelf(f, PerlIOUnix)->fd;
2514 PerlIOUnix_setfd(pTHX_ PerlIO *f, int fd, int imode)
2516 PerlIOUnix * const s = PerlIOSelf(f, PerlIOUnix);
2519 if (PerlLIO_fstat(fd, &st) == 0) {
2520 if (!S_ISREG(st.st_mode)) {
2521 PerlIO_debug("%d is not regular file\n",fd);
2522 PerlIOBase(f)->flags |= PERLIO_F_NOTREG;
2525 PerlIO_debug("%d _is_ a regular file\n",fd);
2531 PerlIOUnix_refcnt_inc(fd);
2532 PERL_UNUSED_CONTEXT;
2536 PerlIOUnix_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
2538 IV code = PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
2539 if (*PerlIONext(f)) {
2540 /* We never call down so do any pending stuff now */
2541 PerlIO_flush(PerlIONext(f));
2543 * XXX could (or should) we retrieve the oflags from the open file
2544 * handle rather than believing the "mode" we are passed in? XXX
2545 * Should the value on NULL mode be 0 or -1?
2547 PerlIOUnix_setfd(aTHX_ f, PerlIO_fileno(PerlIONext(f)),
2548 mode ? PerlIOUnix_oflags(mode) : -1);
2550 PerlIOBase(f)->flags |= PERLIO_F_OPEN;
2556 PerlIOUnix_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
2558 const int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2560 PERL_UNUSED_CONTEXT;
2561 if (PerlIOBase(f)->flags & PERLIO_F_NOTREG) {
2563 SETERRNO(ESPIPE, LIB_INVARG);
2565 SETERRNO(EINVAL, LIB_INVARG);
2569 new_loc = PerlLIO_lseek(fd, offset, whence);
2570 if (new_loc == (Off_t) - 1)
2572 PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
2577 PerlIOUnix_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
2578 IV n, const char *mode, int fd, int imode,
2579 int perm, PerlIO *f, int narg, SV **args)
2581 if (PerlIOValid(f)) {
2582 if (PerlIOBase(f)->flags & PERLIO_F_OPEN)
2583 (*PerlIOBase(f)->tab->Close)(aTHX_ f);
2586 if (*mode == IoTYPE_NUMERIC)
2589 imode = PerlIOUnix_oflags(mode);
2593 const char *path = SvPV_nolen_const(*args);
2594 fd = PerlLIO_open3(path, imode, perm);
2598 if (*mode == IoTYPE_IMPLICIT)
2601 f = PerlIO_allocate(aTHX);
2603 if (!PerlIOValid(f)) {
2604 if (!(f = PerlIO_push(aTHX_ f, self, mode, PerlIOArg))) {
2608 PerlIOUnix_setfd(aTHX_ f, fd, imode);
2609 PerlIOBase(f)->flags |= PERLIO_F_OPEN;
2610 if (*mode == IoTYPE_APPEND)
2611 PerlIOUnix_seek(aTHX_ f, 0, SEEK_END);
2618 * FIXME: pop layers ???
2626 PerlIOUnix_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
2628 const PerlIOUnix * const os = PerlIOSelf(o, PerlIOUnix);
2630 if (flags & PERLIO_DUP_FD) {
2631 fd = PerlLIO_dup(fd);
2634 f = PerlIOBase_dup(aTHX_ f, o, param, flags);
2636 /* If all went well overwrite fd in dup'ed lay with the dup()'ed fd */
2637 PerlIOUnix_setfd(aTHX_ f, fd, os->oflags);
2646 PerlIOUnix_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
2649 const int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2650 #ifdef PERLIO_STD_SPECIAL
2652 return PERLIO_STD_IN(fd, vbuf, count);
2654 if (!(PerlIOBase(f)->flags & PERLIO_F_CANREAD) ||
2655 PerlIOBase(f)->flags & (PERLIO_F_EOF|PERLIO_F_ERROR)) {
2659 const SSize_t len = PerlLIO_read(fd, vbuf, count);
2660 if (len >= 0 || errno != EINTR) {
2662 if (errno != EAGAIN) {
2663 PerlIOBase(f)->flags |= PERLIO_F_ERROR;
2666 else if (len == 0 && count != 0) {
2667 PerlIOBase(f)->flags |= PERLIO_F_EOF;
2678 PerlIOUnix_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
2681 const int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2682 #ifdef PERLIO_STD_SPECIAL
2683 if (fd == 1 || fd == 2)
2684 return PERLIO_STD_OUT(fd, vbuf, count);
2687 const SSize_t len = PerlLIO_write(fd, vbuf, count);
2688 if (len >= 0 || errno != EINTR) {
2690 if (errno != EAGAIN) {
2691 PerlIOBase(f)->flags |= PERLIO_F_ERROR;
2702 PerlIOUnix_tell(pTHX_ PerlIO *f)
2704 PERL_UNUSED_CONTEXT;
2706 return PerlLIO_lseek(PerlIOSelf(f, PerlIOUnix)->fd, 0, SEEK_CUR);
2711 PerlIOUnix_close(pTHX_ PerlIO *f)
2714 const int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2716 if (PerlIOBase(f)->flags & PERLIO_F_OPEN) {
2717 if (PerlIOUnix_refcnt_dec(fd) > 0) {
2718 PerlIOBase(f)->flags &= ~PERLIO_F_OPEN;
2723 SETERRNO(EBADF,SS_IVCHAN);
2726 while (PerlLIO_close(fd) != 0) {
2727 if (errno != EINTR) {
2734 PerlIOBase(f)->flags &= ~PERLIO_F_OPEN;
2739 PERLIO_FUNCS_DECL(PerlIO_unix) = {
2740 sizeof(PerlIO_funcs),
2747 PerlIOBase_binmode, /* binmode */
2757 PerlIOBase_noop_ok, /* flush */
2758 PerlIOBase_noop_fail, /* fill */
2761 PerlIOBase_clearerr,
2762 PerlIOBase_setlinebuf,
2763 NULL, /* get_base */
2764 NULL, /* get_bufsiz */
2767 NULL, /* set_ptrcnt */
2770 /*--------------------------------------------------------------------------------------*/
2775 #if defined(VMS) && !defined(STDIO_BUFFER_WRITABLE)
2776 /* perl5.8 - This ensures the last minute VMS ungetc fix is not
2777 broken by the last second glibc 2.3 fix
2779 #define STDIO_BUFFER_WRITABLE
2784 struct _PerlIO base;
2785 FILE *stdio; /* The stream */
2789 PerlIOStdio_fileno(pTHX_ PerlIO *f)
2791 PERL_UNUSED_CONTEXT;
2793 if (PerlIOValid(f)) {
2794 FILE * const s = PerlIOSelf(f, PerlIOStdio)->stdio;
2796 return PerlSIO_fileno(s);
2803 PerlIOStdio_mode(const char *mode, char *tmode)
2805 char * const ret = tmode;
2811 #if defined(PERLIO_USING_CRLF) || defined(__CYGWIN__)
2819 PerlIOStdio_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
2822 if (PerlIOValid(f) && PerlIOValid(n = PerlIONext(f))) {
2823 PerlIO_funcs * const toptab = PerlIOBase(n)->tab;
2824 if (toptab == tab) {
2825 /* Top is already stdio - pop self (duplicate) and use original */
2826 PerlIO_pop(aTHX_ f);
2829 const int fd = PerlIO_fileno(n);
2832 if (fd >= 0 && (stdio = PerlSIO_fdopen(fd,
2833 mode = PerlIOStdio_mode(mode, tmode)))) {
2834 PerlIOSelf(f, PerlIOStdio)->stdio = stdio;
2835 /* We never call down so do any pending stuff now */
2836 PerlIO_flush(PerlIONext(f));
2843 return PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
2848 PerlIO_importFILE(FILE *stdio, const char *mode)
2854 if (!mode || !*mode) {
2855 /* We need to probe to see how we can open the stream
2856 so start with read/write and then try write and read
2857 we dup() so that we can fclose without loosing the fd.
2859 Note that the errno value set by a failing fdopen
2860 varies between stdio implementations.
2862 const int fd = PerlLIO_dup(fileno(stdio));
2863 FILE *f2 = PerlSIO_fdopen(fd, (mode = "r+"));
2865 f2 = PerlSIO_fdopen(fd, (mode = "w"));
2868 f2 = PerlSIO_fdopen(fd, (mode = "r"));
2871 /* Don't seem to be able to open */
2877 if ((f = PerlIO_push(aTHX_(f = PerlIO_allocate(aTHX)), PERLIO_FUNCS_CAST(&PerlIO_stdio), mode, NULL))) {
2878 s = PerlIOSelf(f, PerlIOStdio);
2886 PerlIOStdio_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
2887 IV n, const char *mode, int fd, int imode,
2888 int perm, PerlIO *f, int narg, SV **args)
2891 if (PerlIOValid(f)) {
2892 const char * const path = SvPV_nolen_const(*args);
2893 PerlIOStdio * const s = PerlIOSelf(f, PerlIOStdio);
2895 PerlIOUnix_refcnt_dec(fileno(s->stdio));
2896 stdio = PerlSIO_freopen(path, (mode = PerlIOStdio_mode(mode, tmode)),
2901 PerlIOUnix_refcnt_inc(fileno(s->stdio));
2906 const char * const path = SvPV_nolen_const(*args);
2907 if (*mode == IoTYPE_NUMERIC) {
2909 fd = PerlLIO_open3(path, imode, perm);
2913 bool appended = FALSE;
2915 /* Cygwin wants its 'b' early. */
2917 mode = PerlIOStdio_mode(mode, tmode);
2919 stdio = PerlSIO_fopen(path, mode);
2922 f = PerlIO_allocate(aTHX);
2925 mode = PerlIOStdio_mode(mode, tmode);
2926 f = PerlIO_push(aTHX_ f, self, mode, PerlIOArg);
2928 PerlIOSelf(f, PerlIOStdio)->stdio = stdio;
2929 PerlIOUnix_refcnt_inc(fileno(stdio));
2931 PerlSIO_fclose(stdio);
2943 if (*mode == IoTYPE_IMPLICIT) {
2950 stdio = PerlSIO_stdin;
2953 stdio = PerlSIO_stdout;
2956 stdio = PerlSIO_stderr;
2961 stdio = PerlSIO_fdopen(fd, mode =
2962 PerlIOStdio_mode(mode, tmode));
2966 f = PerlIO_allocate(aTHX);
2968 if ((f = PerlIO_push(aTHX_ f, self, mode, PerlIOArg))) {
2969 PerlIOSelf(f, PerlIOStdio)->stdio = stdio;
2970 PerlIOUnix_refcnt_inc(fileno(stdio));
2980 PerlIOStdio_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
2982 /* This assumes no layers underneath - which is what
2983 happens, but is not how I remember it. NI-S 2001/10/16
2985 if ((f = PerlIOBase_dup(aTHX_ f, o, param, flags))) {
2986 FILE *stdio = PerlIOSelf(o, PerlIOStdio)->stdio;
2987 const int fd = fileno(stdio);
2989 if (flags & PERLIO_DUP_FD) {
2990 const int dfd = PerlLIO_dup(fileno(stdio));
2992 stdio = PerlSIO_fdopen(dfd, PerlIO_modestr(o,mode));
2997 /* FIXME: To avoid messy error recovery if dup fails
2998 re-use the existing stdio as though flag was not set
3002 stdio = PerlSIO_fdopen(fd, PerlIO_modestr(o,mode));
3004 PerlIOSelf(f, PerlIOStdio)->stdio = stdio;
3005 PerlIOUnix_refcnt_inc(fileno(stdio));
3011 PerlIOStdio_invalidate_fileno(pTHX_ FILE *f)
3013 PERL_UNUSED_CONTEXT;
3015 /* XXX this could use PerlIO_canset_fileno() and
3016 * PerlIO_set_fileno() support from Configure
3018 # if defined(__UCLIBC__)
3019 /* uClibc must come before glibc because it defines __GLIBC__ as well. */
3022 # elif defined(__GLIBC__)
3023 /* There may be a better way for GLIBC:
3024 - libio.h defines a flag to not close() on cleanup
3028 # elif defined(__sun__)
3031 # elif defined(__hpux)
3035 /* Next one ->_file seems to be a reasonable fallback, i.e. if
3036 your platform does not have special entry try this one.
3037 [For OSF only have confirmation for Tru64 (alpha)
3038 but assume other OSFs will be similar.]
3040 # elif defined(_AIX) || defined(__osf__) || defined(__irix__)
3043 # elif defined(__FreeBSD__)
3044 /* There may be a better way on FreeBSD:
3045 - we could insert a dummy func in the _close function entry
3046 f->_close = (int (*)(void *)) dummy_close;
3050 # elif defined(__OpenBSD__)
3051 /* There may be a better way on OpenBSD:
3052 - we could insert a dummy func in the _close function entry
3053 f->_close = (int (*)(void *)) dummy_close;
3057 # elif defined(__EMX__)
3058 /* f->_flags &= ~_IOOPEN; */ /* Will leak stream->_buffer */
3061 # elif defined(__CYGWIN__)
3062 /* There may be a better way on CYGWIN:
3063 - we could insert a dummy func in the _close function entry
3064 f->_close = (int (*)(void *)) dummy_close;
3068 # elif defined(WIN32)
3069 # if defined(__BORLANDC__)
3070 f->fd = PerlLIO_dup(fileno(f));
3071 # elif defined(UNDER_CE)
3072 /* WIN_CE does not have access to FILE internals, it hardly has FILE
3081 /* Sarathy's code did this - we fall back to a dup/dup2 hack
3082 (which isn't thread safe) instead
3084 # error "Don't know how to set FILE.fileno on your platform"
3092 PerlIOStdio_close(pTHX_ PerlIO *f)
3094 FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3100 const int fd = fileno(stdio);
3105 #ifdef SOCKS5_VERSION_NAME
3106 /* Socks lib overrides close() but stdio isn't linked to
3107 that library (though we are) - so we must call close()
3108 on sockets on stdio's behalf.
3111 Sock_size_t optlen = sizeof(int);
3112 if (getsockopt(fd, SOL_SOCKET, SO_TYPE, (void *) &optval, &optlen) == 0)
3115 if (PerlIOUnix_refcnt_dec(fd) > 0) /* File descriptor still in use */
3118 /* For STD* handles, don't close stdio, since we shared the FILE *, too. */
3119 if (stdio == stdin) /* Some stdios are buggy fflush-ing inputs */
3121 if (stdio == stdout || stdio == stderr)
3122 return PerlIO_flush(f);
3123 /* Tricky - must fclose(stdio) to free memory but not close(fd)
3124 Use Sarathy's trick from maint-5.6 to invalidate the
3125 fileno slot of the FILE *
3127 result = PerlIO_flush(f);
3129 invalidate = PerlIOStdio_invalidate_fileno(aTHX_ stdio);
3131 dupfd = PerlLIO_dup(fd);
3133 result = PerlSIO_fclose(stdio);
3134 /* We treat error from stdio as success if we invalidated
3135 errno may NOT be expected EBADF
3137 if (invalidate && result != 0) {
3141 #ifdef SOCKS5_VERSION_NAME
3142 /* in SOCKS' case, let close() determine return value */
3146 PerlLIO_dup2(dupfd,fd);
3147 PerlLIO_close(dupfd);
3154 PerlIOStdio_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
3157 FILE * const s = PerlIOSelf(f, PerlIOStdio)->stdio;
3161 STDCHAR *buf = (STDCHAR *) vbuf;
3163 * Perl is expecting PerlIO_getc() to fill the buffer Linux's
3164 * stdio does not do that for fread()
3166 const int ch = PerlSIO_fgetc(s);
3173 got = PerlSIO_fread(vbuf, 1, count, s);
3174 if (got == 0 && PerlSIO_ferror(s))
3176 if (got >= 0 || errno != EINTR)
3179 SETERRNO(0,0); /* just in case */
3185 PerlIOStdio_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3188 FILE * const s = PerlIOSelf(f, PerlIOStdio)->stdio;
3190 #ifdef STDIO_BUFFER_WRITABLE
3191 if (PerlIO_fast_gets(f) && PerlIO_has_base(f)) {
3192 STDCHAR *buf = ((STDCHAR *) vbuf) + count;
3193 STDCHAR *base = PerlIO_get_base(f);
3194 SSize_t cnt = PerlIO_get_cnt(f);
3195 STDCHAR *ptr = PerlIO_get_ptr(f);
3196 SSize_t avail = ptr - base;
3198 if (avail > count) {
3202 Move(buf-avail,ptr,avail,STDCHAR);
3205 PerlIO_set_ptrcnt(f,ptr,cnt+avail);
3206 if (PerlSIO_feof(s) && unread >= 0)
3207 PerlSIO_clearerr(s);
3212 if (PerlIO_has_cntptr(f)) {
3213 /* We can get pointer to buffer but not its base
3214 Do ungetc() but check chars are ending up in the
3217 STDCHAR *eptr = (STDCHAR*)PerlSIO_get_ptr(s);
3218 STDCHAR *buf = ((STDCHAR *) vbuf) + count;
3220 const int ch = *--buf & 0xFF;
3221 if (ungetc(ch,s) != ch) {
3222 /* ungetc did not work */
3225 if ((STDCHAR*)PerlSIO_get_ptr(s) != --eptr || ((*eptr & 0xFF) != ch)) {
3226 /* Did not change pointer as expected */
3227 fgetc(s); /* get char back again */
3237 unread += PerlIOBase_unread(aTHX_ f, vbuf, count);
3243 PerlIOStdio_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3248 got = PerlSIO_fwrite(vbuf, 1, count,
3249 PerlIOSelf(f, PerlIOStdio)->stdio);
3250 if (got >= 0 || errno != EINTR)
3253 SETERRNO(0,0); /* just in case */
3259 PerlIOStdio_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
3261 FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3262 PERL_UNUSED_CONTEXT;
3264 return PerlSIO_fseek(stdio, offset, whence);
3268 PerlIOStdio_tell(pTHX_ PerlIO *f)
3270 FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3271 PERL_UNUSED_CONTEXT;
3273 return PerlSIO_ftell(stdio);
3277 PerlIOStdio_flush(pTHX_ PerlIO *f)
3279 FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3280 PERL_UNUSED_CONTEXT;
3282 if (PerlIOBase(f)->flags & PERLIO_F_CANWRITE) {
3283 return PerlSIO_fflush(stdio);
3289 * FIXME: This discards ungetc() and pre-read stuff which is not
3290 * right if this is just a "sync" from a layer above Suspect right
3291 * design is to do _this_ but not have layer above flush this
3292 * layer read-to-read
3295 * Not writeable - sync by attempting a seek
3297 const int err = errno;
3298 if (PerlSIO_fseek(stdio, (Off_t) 0, SEEK_CUR) != 0)
3306 PerlIOStdio_eof(pTHX_ PerlIO *f)
3308 PERL_UNUSED_CONTEXT;
3310 return PerlSIO_feof(PerlIOSelf(f, PerlIOStdio)->stdio);
3314 PerlIOStdio_error(pTHX_ PerlIO *f)
3316 PERL_UNUSED_CONTEXT;
3318 return PerlSIO_ferror(PerlIOSelf(f, PerlIOStdio)->stdio);
3322 PerlIOStdio_clearerr(pTHX_ PerlIO *f)
3324 PERL_UNUSED_CONTEXT;
3326 PerlSIO_clearerr(PerlIOSelf(f, PerlIOStdio)->stdio);
3330 PerlIOStdio_setlinebuf(pTHX_ PerlIO *f)
3332 PERL_UNUSED_CONTEXT;
3334 #ifdef HAS_SETLINEBUF
3335 PerlSIO_setlinebuf(PerlIOSelf(f, PerlIOStdio)->stdio);
3337 PerlSIO_setvbuf(PerlIOSelf(f, PerlIOStdio)->stdio, NULL, _IOLBF, 0);
3343 PerlIOStdio_get_base(pTHX_ PerlIO *f)
3345 FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3346 return (STDCHAR*)PerlSIO_get_base(stdio);
3350 PerlIOStdio_get_bufsiz(pTHX_ PerlIO *f)
3352 FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3353 return PerlSIO_get_bufsiz(stdio);
3357 #ifdef USE_STDIO_PTR
3359 PerlIOStdio_get_ptr(pTHX_ PerlIO *f)
3361 FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3362 return (STDCHAR*)PerlSIO_get_ptr(stdio);
3366 PerlIOStdio_get_cnt(pTHX_ PerlIO *f)
3368 FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3369 return PerlSIO_get_cnt(stdio);
3373 PerlIOStdio_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
3375 FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3377 #ifdef STDIO_PTR_LVALUE
3378 PerlSIO_set_ptr(stdio, (void*)ptr); /* LHS STDCHAR* cast non-portable */
3379 #ifdef STDIO_PTR_LVAL_SETS_CNT
3380 if (PerlSIO_get_cnt(stdio) != (cnt)) {
3381 assert(PerlSIO_get_cnt(stdio) == (cnt));
3384 #if (!defined(STDIO_PTR_LVAL_NOCHANGE_CNT))
3386 * Setting ptr _does_ change cnt - we are done
3390 #else /* STDIO_PTR_LVALUE */
3392 #endif /* STDIO_PTR_LVALUE */
3395 * Now (or only) set cnt
3397 #ifdef STDIO_CNT_LVALUE
3398 PerlSIO_set_cnt(stdio, cnt);
3399 #else /* STDIO_CNT_LVALUE */
3400 #if (defined(STDIO_PTR_LVALUE) && defined(STDIO_PTR_LVAL_SETS_CNT))
3401 PerlSIO_set_ptr(stdio,
3402 PerlSIO_get_ptr(stdio) + (PerlSIO_get_cnt(stdio) -
3404 #else /* STDIO_PTR_LVAL_SETS_CNT */
3406 #endif /* STDIO_PTR_LVAL_SETS_CNT */
3407 #endif /* STDIO_CNT_LVALUE */
3414 PerlIOStdio_fill(pTHX_ PerlIO *f)
3416 FILE * const stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3418 PERL_UNUSED_CONTEXT;
3421 * fflush()ing read-only streams can cause trouble on some stdio-s
3423 if ((PerlIOBase(f)->flags & PERLIO_F_CANWRITE)) {
3424 if (PerlSIO_fflush(stdio) != 0)
3427 c = PerlSIO_fgetc(stdio);
3431 #if (defined(STDIO_PTR_LVALUE) && (defined(STDIO_CNT_LVALUE) || defined(STDIO_PTR_LVAL_SETS_CNT)))
3433 #ifdef STDIO_BUFFER_WRITABLE
3434 if (PerlIO_fast_gets(f) && PerlIO_has_base(f)) {
3435 /* Fake ungetc() to the real buffer in case system's ungetc
3438 STDCHAR *base = (STDCHAR*)PerlSIO_get_base(stdio);
3439 SSize_t cnt = PerlSIO_get_cnt(stdio);
3440 STDCHAR *ptr = (STDCHAR*)PerlSIO_get_ptr(stdio);
3441 if (ptr == base+1) {
3442 *--ptr = (STDCHAR) c;
3443 PerlIOStdio_set_ptrcnt(aTHX_ f,ptr,cnt+1);
3444 if (PerlSIO_feof(stdio))
3445 PerlSIO_clearerr(stdio);
3451 if (PerlIO_has_cntptr(f)) {
3453 if (PerlIOStdio_unread(aTHX_ f,&ch,1) == 1) {
3460 /* An ungetc()d char is handled separately from the regular
3461 * buffer, so we stuff it in the buffer ourselves.
3462 * Should never get called as should hit code above
3464 *(--((*stdio)->_ptr)) = (unsigned char) c;
3467 /* If buffer snoop scheme above fails fall back to
3470 if (PerlSIO_ungetc(c, stdio) != c)
3478 PERLIO_FUNCS_DECL(PerlIO_stdio) = {
3479 sizeof(PerlIO_funcs),
3481 sizeof(PerlIOStdio),
3482 PERLIO_K_BUFFERED|PERLIO_K_RAW,
3486 PerlIOBase_binmode, /* binmode */
3500 PerlIOStdio_clearerr,
3501 PerlIOStdio_setlinebuf,
3503 PerlIOStdio_get_base,
3504 PerlIOStdio_get_bufsiz,
3509 #ifdef USE_STDIO_PTR
3510 PerlIOStdio_get_ptr,
3511 PerlIOStdio_get_cnt,
3512 # if defined(HAS_FAST_STDIO) && defined(USE_FAST_STDIO)
3513 PerlIOStdio_set_ptrcnt,
3516 # endif /* HAS_FAST_STDIO && USE_FAST_STDIO */
3521 #endif /* USE_STDIO_PTR */
3524 /* Note that calls to PerlIO_exportFILE() are reversed using
3525 * PerlIO_releaseFILE(), not importFILE. */
3527 PerlIO_exportFILE(PerlIO * f, const char *mode)
3531 if (PerlIOValid(f)) {
3534 if (!mode || !*mode) {
3535 mode = PerlIO_modestr(f, buf);
3537 stdio = PerlSIO_fdopen(PerlIO_fileno(f), mode);
3541 /* De-link any lower layers so new :stdio sticks */
3543 if ((f2 = PerlIO_push(aTHX_ f, PERLIO_FUNCS_CAST(&PerlIO_stdio), buf, NULL))) {
3544 PerlIOStdio *s = PerlIOSelf((f = f2), PerlIOStdio);
3546 /* Link previous lower layers under new one */
3550 /* restore layers list */
3560 PerlIO_findFILE(PerlIO *f)
3564 if (l->tab == &PerlIO_stdio) {
3565 PerlIOStdio *s = PerlIOSelf(&l, PerlIOStdio);
3568 l = *PerlIONext(&l);
3570 /* Uses fallback "mode" via PerlIO_modestr() in PerlIO_exportFILE */
3571 return PerlIO_exportFILE(f, NULL);
3574 /* Use this to reverse PerlIO_exportFILE calls. */
3576 PerlIO_releaseFILE(PerlIO *p, FILE *f)
3581 if (l->tab == &PerlIO_stdio) {
3582 PerlIOStdio *s = PerlIOSelf(&l, PerlIOStdio);
3583 if (s->stdio == f) {
3585 PerlIO_pop(aTHX_ p);
3594 /*--------------------------------------------------------------------------------------*/
3596 * perlio buffer layer
3600 PerlIOBuf_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
3602 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3603 const int fd = PerlIO_fileno(f);
3604 if (fd >= 0 && PerlLIO_isatty(fd)) {
3605 PerlIOBase(f)->flags |= PERLIO_F_LINEBUF | PERLIO_F_TTY;
3607 if (*PerlIONext(f)) {
3608 const Off_t posn = PerlIO_tell(PerlIONext(f));
3609 if (posn != (Off_t) - 1) {
3613 return PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
3617 PerlIOBuf_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
3618 IV n, const char *mode, int fd, int imode, int perm,
3619 PerlIO *f, int narg, SV **args)
3621 if (PerlIOValid(f)) {
3622 PerlIO *next = PerlIONext(f);
3624 PerlIO_layer_fetch(aTHX_ layers, n - 1, PerlIOBase(next)->tab);
3625 if (tab && tab->Open)
3627 (*tab->Open)(aTHX_ tab, layers, n - 1, mode, fd, imode, perm,
3629 if (!next || (*PerlIOBase(f)->tab->Pushed) (aTHX_ f, mode, PerlIOArg, self) != 0) {
3634 PerlIO_funcs *tab = PerlIO_layer_fetch(aTHX_ layers, n - 1, PerlIO_default_btm());
3636 if (*mode == IoTYPE_IMPLICIT) {
3642 if (tab && tab->Open)
3643 f = (*tab->Open)(aTHX_ tab, layers, n - 1, mode, fd, imode, perm,
3646 SETERRNO(EINVAL, LIB_INVARG);
3648 if (PerlIO_push(aTHX_ f, self, mode, PerlIOArg) == 0) {
3650 * if push fails during open, open fails. close will pop us.
3655 fd = PerlIO_fileno(f);
3656 if (init && fd == 2) {
3658 * Initial stderr is unbuffered
3660 PerlIOBase(f)->flags |= PERLIO_F_UNBUF;
3662 #ifdef PERLIO_USING_CRLF
3663 # ifdef PERLIO_IS_BINMODE_FD
3664 if (PERLIO_IS_BINMODE_FD(fd))
3665 PerlIO_binmode(aTHX_ f, '<'/*not used*/, O_BINARY, NULL);
3669 * do something about failing setmode()? --jhi
3671 PerlLIO_setmode(fd, O_BINARY);
3680 * This "flush" is akin to sfio's sync in that it handles files in either
3681 * read or write state. For write state, we put the postponed data through
3682 * the next layers. For read state, we seek() the next layers to the
3683 * offset given by current position in the buffer, and discard the buffer
3684 * state (XXXX supposed to be for seek()able buffers only, but now it is done
3685 * in any case?). Then the pass the stick further in chain.
3688 PerlIOBuf_flush(pTHX_ PerlIO *f)
3690 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3692 PerlIO *n = PerlIONext(f);
3693 if (PerlIOBase(f)->flags & PERLIO_F_WRBUF) {
3695 * write() the buffer
3697 const STDCHAR *buf = b->buf;
3698 const STDCHAR *p = buf;
3699 while (p < b->ptr) {
3700 SSize_t count = PerlIO_write(n, p, b->ptr - p);
3704 else if (count < 0 || PerlIO_error(n)) {
3705 PerlIOBase(f)->flags |= PERLIO_F_ERROR;
3710 b->posn += (p - buf);
3712 else if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
3713 STDCHAR *buf = PerlIO_get_base(f);
3715 * Note position change
3717 b->posn += (b->ptr - buf);
3718 if (b->ptr < b->end) {
3719 /* We did not consume all of it - try and seek downstream to
3720 our logical position
3722 if (PerlIOValid(n) && PerlIO_seek(n, b->posn, SEEK_SET) == 0) {
3723 /* Reload n as some layers may pop themselves on seek */
3724 b->posn = PerlIO_tell(n = PerlIONext(f));
3727 /* Seek failed (e.g. pipe or tty). Do NOT clear buffer or pre-read
3728 data is lost for good - so return saying "ok" having undone
3731 b->posn -= (b->ptr - buf);
3736 b->ptr = b->end = b->buf;
3737 PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
3738 /* We check for Valid because of dubious decision to make PerlIO_flush(NULL) flush all */
3739 if (PerlIOValid(n) && PerlIO_flush(n) != 0)
3744 /* This discards the content of the buffer after b->ptr, and rereads
3745 * the buffer from the position off in the layer downstream; here off
3746 * is at offset corresponding to b->ptr - b->buf.
3749 PerlIOBuf_fill(pTHX_ PerlIO *f)
3751 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3752 PerlIO *n = PerlIONext(f);
3755 * Down-stream flush is defined not to loose read data so is harmless.
3756 * we would not normally be fill'ing if there was data left in anycase.
3758 if (PerlIO_flush(f) != 0) /* XXXX Check that its seek() succeeded?! */
3760 if (PerlIOBase(f)->flags & PERLIO_F_TTY)
3761 PerlIOBase_flush_linebuf(aTHX);
3764 PerlIO_get_base(f); /* allocate via vtable */
3766 assert(b->buf); /* The b->buf does get allocated via the vtable system. */
3768 b->ptr = b->end = b->buf;
3770 if (!PerlIOValid(n)) {
3771 PerlIOBase(f)->flags |= PERLIO_F_EOF;
3775 if (PerlIO_fast_gets(n)) {
3777 * Layer below is also buffered. We do _NOT_ want to call its
3778 * ->Read() because that will loop till it gets what we asked for
3779 * which may hang on a pipe etc. Instead take anything it has to
3780 * hand, or ask it to fill _once_.
3782 avail = PerlIO_get_cnt(n);
3784 avail = PerlIO_fill(n);
3786 avail = PerlIO_get_cnt(n);
3788 if (!PerlIO_error(n) && PerlIO_eof(n))
3793 STDCHAR *ptr = PerlIO_get_ptr(n);
3794 const SSize_t cnt = avail;
3795 if (avail > (SSize_t)b->bufsiz)
3797 Copy(ptr, b->buf, avail, STDCHAR);
3798 PerlIO_set_ptrcnt(n, ptr + avail, cnt - avail);
3802 avail = PerlIO_read(n, b->ptr, b->bufsiz);
3806 PerlIOBase(f)->flags |= PERLIO_F_EOF;
3808 PerlIOBase(f)->flags |= PERLIO_F_ERROR;
3811 b->end = b->buf + avail;
3812 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
3817 PerlIOBuf_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
3819 if (PerlIOValid(f)) {
3820 const PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3823 return PerlIOBase_read(aTHX_ f, vbuf, count);
3829 PerlIOBuf_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3831 const STDCHAR *buf = (const STDCHAR *) vbuf + count;
3832 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3835 if (PerlIOBase(f)->flags & PERLIO_F_WRBUF)
3840 if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
3842 * Buffer is already a read buffer, we can overwrite any chars
3843 * which have been read back to buffer start
3845 avail = (b->ptr - b->buf);
3849 * Buffer is idle, set it up so whole buffer is available for
3853 b->end = b->buf + avail;
3855 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
3857 * Buffer extends _back_ from where we are now
3859 b->posn -= b->bufsiz;
3861 if (avail > (SSize_t) count) {
3863 * If we have space for more than count, just move count
3871 * In simple stdio-like ungetc() case chars will be already
3874 if (buf != b->ptr) {
3875 Copy(buf, b->ptr, avail, STDCHAR);
3879 PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
3883 unread += PerlIOBase_unread(aTHX_ f, vbuf, count);
3889 PerlIOBuf_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3891 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3892 const STDCHAR *buf = (const STDCHAR *) vbuf;
3893 const STDCHAR *flushptr = buf;
3897 if (!(PerlIOBase(f)->flags & PERLIO_F_CANWRITE))
3899 if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
3900 if (PerlIO_flush(f) != 0) {
3904 if (PerlIOBase(f)->flags & PERLIO_F_LINEBUF) {
3905 flushptr = buf + count;
3906 while (flushptr > buf && *(flushptr - 1) != '\n')
3910 SSize_t avail = b->bufsiz - (b->ptr - b->buf);
3911 if ((SSize_t) count < avail)
3913 if (flushptr > buf && flushptr <= buf + avail)
3914 avail = flushptr - buf;
3915 PerlIOBase(f)->flags |= PERLIO_F_WRBUF;
3917 Copy(buf, b->ptr, avail, STDCHAR);
3922 if (buf == flushptr)
3925 if (b->ptr >= (b->buf + b->bufsiz))
3928 if (PerlIOBase(f)->flags & PERLIO_F_UNBUF)
3934 PerlIOBuf_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
3937 if ((code = PerlIO_flush(f)) == 0) {
3938 PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
3939 code = PerlIO_seek(PerlIONext(f), offset, whence);
3941 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3942 b->posn = PerlIO_tell(PerlIONext(f));
3949 PerlIOBuf_tell(pTHX_ PerlIO *f)
3951 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3953 * b->posn is file position where b->buf was read, or will be written
3955 Off_t posn = b->posn;
3956 if ((PerlIOBase(f)->flags & PERLIO_F_APPEND) &&
3957 (PerlIOBase(f)->flags & PERLIO_F_WRBUF)) {
3959 /* As O_APPEND files are normally shared in some sense it is better
3964 /* when file is NOT shared then this is sufficient */
3965 PerlIO_seek(PerlIONext(f),0, SEEK_END);
3967 posn = b->posn = PerlIO_tell(PerlIONext(f));
3971 * If buffer is valid adjust position by amount in buffer
3973 posn += (b->ptr - b->buf);
3979 PerlIOBuf_popped(pTHX_ PerlIO *f)
3981 const IV code = PerlIOBase_popped(aTHX_ f);
3982 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3983 if (b->buf && b->buf != (STDCHAR *) & b->oneword) {
3986 b->ptr = b->end = b->buf = NULL;
3987 PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
3992 PerlIOBuf_close(pTHX_ PerlIO *f)
3994 const IV code = PerlIOBase_close(aTHX_ f);
3995 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
3996 if (b->buf && b->buf != (STDCHAR *) & b->oneword) {
3999 b->ptr = b->end = b->buf = NULL;
4000 PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
4005 PerlIOBuf_get_ptr(pTHX_ PerlIO *f)
4007 const PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4014 PerlIOBuf_get_cnt(pTHX_ PerlIO *f)
4016 const PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4019 if (PerlIOBase(f)->flags & PERLIO_F_RDBUF)
4020 return (b->end - b->ptr);
4025 PerlIOBuf_get_base(pTHX_ PerlIO *f)
4027 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4028 PERL_UNUSED_CONTEXT;
4033 b->buf = Newxz(b->buf,b->bufsiz, STDCHAR);
4035 b->buf = (STDCHAR *) & b->oneword;
4036 b->bufsiz = sizeof(b->oneword);
4038 b->end = b->ptr = b->buf;
4044 PerlIOBuf_bufsiz(pTHX_ PerlIO *f)
4046 const PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4049 return (b->end - b->buf);
4053 PerlIOBuf_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
4055 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4059 if (PerlIO_get_cnt(f) != cnt || b->ptr < b->buf) {
4060 assert(PerlIO_get_cnt(f) == cnt);
4061 assert(b->ptr >= b->buf);
4063 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
4067 PerlIOBuf_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
4069 return PerlIOBase_dup(aTHX_ f, o, param, flags);
4074 PERLIO_FUNCS_DECL(PerlIO_perlio) = {
4075 sizeof(PerlIO_funcs),
4078 PERLIO_K_BUFFERED|PERLIO_K_RAW,
4082 PerlIOBase_binmode, /* binmode */
4096 PerlIOBase_clearerr,
4097 PerlIOBase_setlinebuf,
4102 PerlIOBuf_set_ptrcnt,
4105 /*--------------------------------------------------------------------------------------*/
4107 * Temp layer to hold unread chars when cannot do it any other way
4111 PerlIOPending_fill(pTHX_ PerlIO *f)
4114 * Should never happen
4121 PerlIOPending_close(pTHX_ PerlIO *f)
4124 * A tad tricky - flush pops us, then we close new top
4127 return PerlIO_close(f);
4131 PerlIOPending_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
4134 * A tad tricky - flush pops us, then we seek new top
4137 return PerlIO_seek(f, offset, whence);
4142 PerlIOPending_flush(pTHX_ PerlIO *f)
4144 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4145 if (b->buf && b->buf != (STDCHAR *) & b->oneword) {
4149 PerlIO_pop(aTHX_ f);
4154 PerlIOPending_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
4160 PerlIOBuf_set_ptrcnt(aTHX_ f, ptr, cnt);
4165 PerlIOPending_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
4167 const IV code = PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
4168 PerlIOl * const l = PerlIOBase(f);
4170 * Our PerlIO_fast_gets must match what we are pushed on, or sv_gets()
4171 * etc. get muddled when it changes mid-string when we auto-pop.
4173 l->flags = (l->flags & ~(PERLIO_F_FASTGETS | PERLIO_F_UTF8)) |
4174 (PerlIOBase(PerlIONext(f))->
4175 flags & (PERLIO_F_FASTGETS | PERLIO_F_UTF8));
4180 PerlIOPending_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
4182 SSize_t avail = PerlIO_get_cnt(f);
4184 if ((SSize_t)count < avail)
4187 got = PerlIOBuf_read(aTHX_ f, vbuf, avail);
4188 if (got >= 0 && got < (SSize_t)count) {
4189 const SSize_t more =
4190 PerlIO_read(f, ((STDCHAR *) vbuf) + got, count - got);
4191 if (more >= 0 || got == 0)
4197 PERLIO_FUNCS_DECL(PerlIO_pending) = {
4198 sizeof(PerlIO_funcs),
4201 PERLIO_K_BUFFERED|PERLIO_K_RAW, /* not sure about RAW here */
4202 PerlIOPending_pushed,
4205 PerlIOBase_binmode, /* binmode */
4214 PerlIOPending_close,
4215 PerlIOPending_flush,
4219 PerlIOBase_clearerr,
4220 PerlIOBase_setlinebuf,
4225 PerlIOPending_set_ptrcnt,
4230 /*--------------------------------------------------------------------------------------*/
4232 * crlf - translation On read translate CR,LF to "\n" we do this by
4233 * overriding ptr/cnt entries to hand back a line at a time and keeping a
4234 * record of which nl we "lied" about. On write translate "\n" to CR,LF
4236 * c->nl points on the first byte of CR LF pair when it is temporarily
4237 * replaced by LF, or to the last CR of the buffer. In the former case
4238 * the caller thinks that the buffer ends at c->nl + 1, in the latter
4239 * that it ends at c->nl; these two cases can be distinguished by
4240 * *c->nl. c->nl is set during _getcnt() call, and unset during
4241 * _unread() and _flush() calls.
4242 * It only matters for read operations.
4246 PerlIOBuf base; /* PerlIOBuf stuff */
4247 STDCHAR *nl; /* Position of crlf we "lied" about in the
4251 /* Inherit the PERLIO_F_UTF8 flag from previous layer.
4252 * Otherwise the :crlf layer would always revert back to
4256 S_inherit_utf8_flag(PerlIO *f)
4258 PerlIO *g = PerlIONext(f);
4259 if (PerlIOValid(g)) {
4260 if (PerlIOBase(g)->flags & PERLIO_F_UTF8) {
4261 PerlIOBase(f)->flags |= PERLIO_F_UTF8;
4267 PerlIOCrlf_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
4270 PerlIOBase(f)->flags |= PERLIO_F_CRLF;
4271 code = PerlIOBuf_pushed(aTHX_ f, mode, arg, tab);
4273 PerlIO_debug("PerlIOCrlf_pushed f=%p %s %s fl=%08" UVxf "\n",
4274 f, PerlIOBase(f)->tab->name, (mode) ? mode : "(Null)",
4275 PerlIOBase(f)->flags);
4278 /* Enable the first CRLF capable layer you can find, but if none
4279 * found, the one we just pushed is fine. This results in at
4280 * any given moment at most one CRLF-capable layer being enabled
4281 * in the whole layer stack. */
4282 PerlIO *g = PerlIONext(f);
4283 while (PerlIOValid(g)) {
4284 PerlIOl *b = PerlIOBase(g);
4285 if (b && b->tab == &PerlIO_crlf) {
4286 if (!(b->flags & PERLIO_F_CRLF))
4287 b->flags |= PERLIO_F_CRLF;
4288 S_inherit_utf8_flag(g);
4289 PerlIO_pop(aTHX_ f);
4295 S_inherit_utf8_flag(f);
4301 PerlIOCrlf_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4303 PerlIOCrlf * const c = PerlIOSelf(f, PerlIOCrlf);
4304 if (c->nl) { /* XXXX Shouldn't it be done only if b->ptr > c->nl? */
4308 if (!(PerlIOBase(f)->flags & PERLIO_F_CRLF))
4309 return PerlIOBuf_unread(aTHX_ f, vbuf, count);
4311 const STDCHAR *buf = (const STDCHAR *) vbuf + count;
4312 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
4314 if (PerlIOBase(f)->flags & PERLIO_F_WRBUF)
4319 if (!(PerlIOBase(f)->flags & PERLIO_F_RDBUF)) {
4320 b->end = b->ptr = b->buf + b->bufsiz;
4321 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
4322 b->posn -= b->bufsiz;
4324 while (count > 0 && b->ptr > b->buf) {
4325 const int ch = *--buf;
4327 if (b->ptr - 2 >= b->buf) {
4334 /* If b->ptr - 1 == b->buf, we are undoing reading 0xa */
4335 *--(b->ptr) = 0xa; /* Works even if 0xa == '\r' */
4351 /* XXXX This code assumes that buffer size >=2, but does not check it... */
4353 PerlIOCrlf_get_cnt(pTHX_ PerlIO *f)
4355 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4358 if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
4359 PerlIOCrlf * const c = PerlIOSelf(f, PerlIOCrlf);
4360 if ((PerlIOBase(f)->flags & PERLIO_F_CRLF) && (!c->nl || *c->nl == 0xd)) {
4361 STDCHAR *nl = (c->nl) ? c->nl : b->ptr;
4363 while (nl < b->end && *nl != 0xd)
4365 if (nl < b->end && *nl == 0xd) {
4367 if (nl + 1 < b->end) {
4374 * Not CR,LF but just CR
4382 * Blast - found CR as last char in buffer
4387 * They may not care, defer work as long as
4391 return (nl - b->ptr);
4395 b->ptr++; /* say we have read it as far as
4396 * flush() is concerned */
4397 b->buf++; /* Leave space in front of buffer */
4398 /* Note as we have moved buf up flush's
4400 will naturally make posn point at CR
4402 b->bufsiz--; /* Buffer is thus smaller */
4403 code = PerlIO_fill(f); /* Fetch some more */
4404 b->bufsiz++; /* Restore size for next time */
4405 b->buf--; /* Point at space */
4406 b->ptr = nl = b->buf; /* Which is what we hand
4408 *nl = 0xd; /* Fill in the CR */
4410 goto test; /* fill() call worked */
4412 * CR at EOF - just fall through
4414 /* Should we clear EOF though ??? */
4419 return (((c->nl) ? (c->nl + 1) : b->end) - b->ptr);
4425 PerlIOCrlf_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
4427 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4428 PerlIOCrlf * const c = PerlIOSelf(f, PerlIOCrlf);
4434 if (ptr == b->end && *c->nl == 0xd) {
4435 /* Defered CR at end of buffer case - we lied about count */
4448 * Test code - delete when it works ...
4450 IV flags = PerlIOBase(f)->flags;
4451 STDCHAR *chk = (c->nl) ? (c->nl+1) : b->end;
4452 if (ptr+cnt == c->nl && c->nl+1 == b->end && *c->nl == 0xd) {
4453 /* Defered CR at end of buffer case - we lied about count */
4459 Perl_croak(aTHX_ "ptr wrong %p != %p fl=%08" UVxf
4460 " nl=%p e=%p for %d", ptr, chk, flags, c->nl,
4468 * They have taken what we lied about
4476 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
4480 PerlIOCrlf_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4482 if (!(PerlIOBase(f)->flags & PERLIO_F_CRLF))
4483 return PerlIOBuf_write(aTHX_ f, vbuf, count);
4485 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4486 const STDCHAR *buf = (const STDCHAR *) vbuf;
4487 const STDCHAR * const ebuf = buf + count;
4490 if (!(PerlIOBase(f)->flags & PERLIO_F_CANWRITE))
4492 while (buf < ebuf) {
4493 const STDCHAR * const eptr = b->buf + b->bufsiz;
4494 PerlIOBase(f)->flags |= PERLIO_F_WRBUF;
4495 while (buf < ebuf && b->ptr < eptr) {
4497 if ((b->ptr + 2) > eptr) {
4505 *(b->ptr)++ = 0xd; /* CR */
4506 *(b->ptr)++ = 0xa; /* LF */
4508 if (PerlIOBase(f)->flags & PERLIO_F_LINEBUF) {
4515 *(b->ptr)++ = *buf++;
4517 if (b->ptr >= eptr) {
4523 if (PerlIOBase(f)->flags & PERLIO_F_UNBUF)
4525 return (buf - (STDCHAR *) vbuf);
4530 PerlIOCrlf_flush(pTHX_ PerlIO *f)
4532 PerlIOCrlf * const c = PerlIOSelf(f, PerlIOCrlf);
4537 return PerlIOBuf_flush(aTHX_ f);
4541 PerlIOCrlf_binmode(pTHX_ PerlIO *f)
4543 if ((PerlIOBase(f)->flags & PERLIO_F_CRLF)) {
4544 /* In text mode - flush any pending stuff and flip it */
4545 PerlIOBase(f)->flags &= ~PERLIO_F_CRLF;
4546 #ifndef PERLIO_USING_CRLF
4547 /* CRLF is unusual case - if this is just the :crlf layer pop it */
4548 if (PerlIOBase(f)->tab == &PerlIO_crlf) {
4549 PerlIO_pop(aTHX_ f);
4556 PERLIO_FUNCS_DECL(PerlIO_crlf) = {
4557 sizeof(PerlIO_funcs),
4560 PERLIO_K_BUFFERED | PERLIO_K_CANCRLF | PERLIO_K_RAW,
4562 PerlIOBuf_popped, /* popped */
4564 PerlIOCrlf_binmode, /* binmode */
4568 PerlIOBuf_read, /* generic read works with ptr/cnt lies */
4569 PerlIOCrlf_unread, /* Put CR,LF in buffer for each '\n' */
4570 PerlIOCrlf_write, /* Put CR,LF in buffer for each '\n' */
4578 PerlIOBase_clearerr,
4579 PerlIOBase_setlinebuf,
4584 PerlIOCrlf_set_ptrcnt,
4588 /*--------------------------------------------------------------------------------------*/
4590 * mmap as "buffer" layer
4594 PerlIOBuf base; /* PerlIOBuf stuff */
4595 Mmap_t mptr; /* Mapped address */
4596 Size_t len; /* mapped length */
4597 STDCHAR *bbuf; /* malloced buffer if map fails */
4601 PerlIOMmap_map(pTHX_ PerlIO *f)
4604 PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4605 const IV flags = PerlIOBase(f)->flags;
4609 if (flags & PERLIO_F_CANREAD) {
4610 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4611 const int fd = PerlIO_fileno(f);
4613 code = Fstat(fd, &st);
4614 if (code == 0 && S_ISREG(st.st_mode)) {
4615 SSize_t len = st.st_size - b->posn;
4618 if (PL_mmap_page_size <= 0)
4619 Perl_croak(aTHX_ "panic: bad pagesize %" IVdf,
4623 * This is a hack - should never happen - open should
4626 b->posn = PerlIO_tell(PerlIONext(f));
4628 posn = (b->posn / PL_mmap_page_size) * PL_mmap_page_size;
4629 len = st.st_size - posn;
4630 m->mptr = mmap(NULL, len, PROT_READ, MAP_SHARED, fd, posn);
4631 if (m->mptr && m->mptr != (Mmap_t) - 1) {
4632 #if 0 && defined(HAS_MADVISE) && defined(MADV_SEQUENTIAL)
4633 madvise(m->mptr, len, MADV_SEQUENTIAL);
4635 #if 0 && defined(HAS_MADVISE) && defined(MADV_WILLNEED)
4636 madvise(m->mptr, len, MADV_WILLNEED);
4638 PerlIOBase(f)->flags =
4639 (flags & ~PERLIO_F_EOF) | PERLIO_F_RDBUF;
4640 b->end = ((STDCHAR *) m->mptr) + len;
4641 b->buf = ((STDCHAR *) m->mptr) + (b->posn - posn);
4650 PerlIOBase(f)->flags =
4651 flags | PERLIO_F_EOF | PERLIO_F_RDBUF;
4653 b->ptr = b->end = b->ptr;
4662 PerlIOMmap_unmap(pTHX_ PerlIO *f)
4664 PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4667 PerlIOBuf * const b = &m->base;
4669 /* The munmap address argument is tricky: depending on the
4670 * standard it is either "void *" or "caddr_t" (which is
4671 * usually "char *" (signed or unsigned). If we cast it
4672 * to "void *", those that have it caddr_t and an uptight
4673 * C++ compiler, will freak out. But casting it as char*
4674 * should work. Maybe. (Using Mmap_t figured out by
4675 * Configure doesn't always work, apparently.) */
4676 code = munmap((char*)m->mptr, m->len);
4680 if (PerlIO_seek(PerlIONext(f), b->posn, SEEK_SET) != 0)
4683 b->ptr = b->end = b->buf;
4684 PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
4690 PerlIOMmap_get_base(pTHX_ PerlIO *f)
4692 PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4693 PerlIOBuf * const b = &m->base;
4694 if (b->buf && (PerlIOBase(f)->flags & PERLIO_F_RDBUF)) {
4696 * Already have a readbuffer in progress
4702 * We have a write buffer or flushed PerlIOBuf read buffer
4704 m->bbuf = b->buf; /* save it in case we need it again */
4705 b->buf = NULL; /* Clear to trigger below */
4708 PerlIOMmap_map(aTHX_ f); /* Try and map it */
4711 * Map did not work - recover PerlIOBuf buffer if we have one
4716 b->ptr = b->end = b->buf;
4719 return PerlIOBuf_get_base(aTHX_ f);
4723 PerlIOMmap_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4725 PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4726 PerlIOBuf * const b = &m->base;
4727 if (PerlIOBase(f)->flags & PERLIO_F_WRBUF)
4729 if (b->ptr && (b->ptr - count) >= b->buf
4730 && memEQ(b->ptr - count, vbuf, count)) {
4732 PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
4737 * Loose the unwritable mapped buffer
4741 * If flush took the "buffer" see if we have one from before
4743 if (!b->buf && m->bbuf)
4746 PerlIOBuf_get_base(aTHX_ f);
4750 return PerlIOBuf_unread(aTHX_ f, vbuf, count);
4754 PerlIOMmap_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4756 PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4757 PerlIOBuf * const b = &m->base;
4759 if (!b->buf || !(PerlIOBase(f)->flags & PERLIO_F_WRBUF)) {
4761 * No, or wrong sort of, buffer
4764 if (PerlIOMmap_unmap(aTHX_ f) != 0)
4768 * If unmap took the "buffer" see if we have one from before
4770 if (!b->buf && m->bbuf)
4773 PerlIOBuf_get_base(aTHX_ f);
4777 return PerlIOBuf_write(aTHX_ f, vbuf, count);
4781 PerlIOMmap_flush(pTHX_ PerlIO *f)
4783 PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4784 PerlIOBuf * const b = &m->base;
4785 IV code = PerlIOBuf_flush(aTHX_ f);
4787 * Now we are "synced" at PerlIOBuf level
4794 if (PerlIOMmap_unmap(aTHX_ f) != 0)
4799 * We seem to have a PerlIOBuf buffer which was not mapped
4800 * remember it in case we need one later
4809 PerlIOMmap_fill(pTHX_ PerlIO *f)
4811 PerlIOBuf * const b = PerlIOSelf(f, PerlIOBuf);
4812 IV code = PerlIO_flush(f);
4813 if (code == 0 && !b->buf) {
4814 code = PerlIOMmap_map(aTHX_ f);
4816 if (code == 0 && !(PerlIOBase(f)->flags & PERLIO_F_RDBUF)) {
4817 code = PerlIOBuf_fill(aTHX_ f);
4823 PerlIOMmap_close(pTHX_ PerlIO *f)
4825 PerlIOMmap * const m = PerlIOSelf(f, PerlIOMmap);
4826 PerlIOBuf * const b = &m->base;
4827 IV code = PerlIO_flush(f);
4831 b->ptr = b->end = b->buf;
4833 if (PerlIOBuf_close(aTHX_ f) != 0)
4839 PerlIOMmap_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
4841 return PerlIOBase_dup(aTHX_ f, o, param, flags);
4845 PERLIO_FUNCS_DECL(PerlIO_mmap) = {
4846 sizeof(PerlIO_funcs),
4849 PERLIO_K_BUFFERED|PERLIO_K_RAW,
4853 PerlIOBase_binmode, /* binmode */
4867 PerlIOBase_clearerr,
4868 PerlIOBase_setlinebuf,
4869 PerlIOMmap_get_base,
4873 PerlIOBuf_set_ptrcnt,
4876 #endif /* HAS_MMAP */
4879 Perl_PerlIO_stdin(pTHX)
4883 PerlIO_stdstreams(aTHX);
4885 return &PL_perlio[1];
4889 Perl_PerlIO_stdout(pTHX)
4893 PerlIO_stdstreams(aTHX);
4895 return &PL_perlio[2];
4899 Perl_PerlIO_stderr(pTHX)
4903 PerlIO_stdstreams(aTHX);
4905 return &PL_perlio[3];
4908 /*--------------------------------------------------------------------------------------*/
4911 PerlIO_getname(PerlIO *f, char *buf)
4916 bool exported = FALSE;
4917 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
4919 stdio = PerlIO_exportFILE(f,0);
4923 name = fgetname(stdio, buf);
4924 if (exported) PerlIO_releaseFILE(f,stdio);
4929 PERL_UNUSED_ARG(buf);
4930 Perl_croak(aTHX_ "Don't know how to get file name");
4936 /*--------------------------------------------------------------------------------------*/
4938 * Functions which can be called on any kind of PerlIO implemented in
4942 #undef PerlIO_fdopen
4944 PerlIO_fdopen(int fd, const char *mode)
4947 return PerlIO_openn(aTHX_ NULL, mode, fd, 0, 0, NULL, 0, NULL);
4952 PerlIO_open(const char *path, const char *mode)
4955 SV *name = sv_2mortal(newSVpv(path, 0));
4956 return PerlIO_openn(aTHX_ NULL, mode, -1, 0, 0, NULL, 1, &name);
4959 #undef Perlio_reopen
4961 PerlIO_reopen(const char *path, const char *mode, PerlIO *f)
4964 SV *name = sv_2mortal(newSVpv(path,0));
4965 return PerlIO_openn(aTHX_ NULL, mode, -1, 0, 0, f, 1, &name);
4970 PerlIO_getc(PerlIO *f)
4974 if ( 1 == PerlIO_read(f, buf, 1) ) {
4975 return (unsigned char) buf[0];
4980 #undef PerlIO_ungetc
4982 PerlIO_ungetc(PerlIO *f, int ch)
4987 if (PerlIO_unread(f, &buf, 1) == 1)
4995 PerlIO_putc(PerlIO *f, int ch)
4999 return PerlIO_write(f, &buf, 1);
5004 PerlIO_puts(PerlIO *f, const char *s)
5007 return PerlIO_write(f, s, strlen(s));
5010 #undef PerlIO_rewind
5012 PerlIO_rewind(PerlIO *f)
5015 PerlIO_seek(f, (Off_t) 0, SEEK_SET);
5019 #undef PerlIO_vprintf
5021 PerlIO_vprintf(PerlIO *f, const char *fmt, va_list ap)
5024 SV * const sv = newSVpvs("");
5030 Perl_va_copy(ap, apc);
5031 sv_vcatpvf(sv, fmt, &apc);
5033 sv_vcatpvf(sv, fmt, &ap);
5035 s = SvPV_const(sv, len);
5036 wrote = PerlIO_write(f, s, len);
5041 #undef PerlIO_printf
5043 PerlIO_printf(PerlIO *f, const char *fmt, ...)
5048 result = PerlIO_vprintf(f, fmt, ap);
5053 #undef PerlIO_stdoutf
5055 PerlIO_stdoutf(const char *fmt, ...)
5061 result = PerlIO_vprintf(PerlIO_stdout(), fmt, ap);
5066 #undef PerlIO_tmpfile
5068 PerlIO_tmpfile(void)
5073 const int fd = win32_tmpfd();
5075 f = PerlIO_fdopen(fd, "w+b");
5077 # if defined(HAS_MKSTEMP) && ! defined(VMS) && ! defined(OS2)
5078 SV * const sv = newSVpvs("/tmp/PerlIO_XXXXXX");
5080 * I have no idea how portable mkstemp() is ... NI-S
5082 const int fd = mkstemp(SvPVX(sv));
5084 f = PerlIO_fdopen(fd, "w+");
5086 PerlIOBase(f)->flags |= PERLIO_F_TEMP;
5087 PerlLIO_unlink(SvPVX_const(sv));
5090 # else /* !HAS_MKSTEMP, fallback to stdio tmpfile(). */
5091 FILE * const stdio = PerlSIO_tmpfile();
5094 f = PerlIO_fdopen(fileno(stdio), "w+");
5096 # endif /* else HAS_MKSTEMP */
5097 #endif /* else WIN32 */
5104 #endif /* USE_SFIO */
5105 #endif /* PERLIO_IS_STDIO */
5107 /*======================================================================================*/
5109 * Now some functions in terms of above which may be needed even if we are
5110 * not in true PerlIO mode
5113 Perl_PerlIO_context_layers(pTHX_ const char *mode)
5116 const char *type = NULL;
5118 * Need to supply default layer info from open.pm
5120 if (PL_curcop && PL_curcop->cop_hints & HINT_LEXICAL_IO) {
5122 = Perl_refcounted_he_fetch(aTHX_ PL_curcop->cop_hints_hash, 0,
5127 type = SvPV_const(layers, len);
5128 if (type && mode && mode[0] != 'r') {
5130 * Skip to write part, which is separated by a '\0'
5132 STRLEN read_len = strlen(type);
5133 if (read_len < len) {
5134 type += read_len + 1;
5144 #undef PerlIO_setpos
5146 PerlIO_setpos(PerlIO *f, SV *pos)
5151 const Off_t * const posn = (Off_t *) SvPV(pos, len);
5152 if (f && len == sizeof(Off_t))
5153 return PerlIO_seek(f, *posn, SEEK_SET);
5155 SETERRNO(EINVAL, SS_IVCHAN);
5159 #undef PerlIO_setpos
5161 PerlIO_setpos(PerlIO *f, SV *pos)
5166 Fpos_t * const fpos = (Fpos_t *) SvPV(pos, len);
5167 if (f && len == sizeof(Fpos_t)) {
5168 #if defined(USE_64_BIT_STDIO) && defined(USE_FSETPOS64)
5169 return fsetpos64(f, fpos);
5171 return fsetpos(f, fpos);
5175 SETERRNO(EINVAL, SS_IVCHAN);
5181 #undef PerlIO_getpos
5183 PerlIO_getpos(PerlIO *f, SV *pos)
5186 Off_t posn = PerlIO_tell(f);
5187 sv_setpvn(pos, (char *) &posn, sizeof(posn));
5188 return (posn == (Off_t) - 1) ? -1 : 0;
5191 #undef PerlIO_getpos
5193 PerlIO_getpos(PerlIO *f, SV *pos)
5198 #if defined(USE_64_BIT_STDIO) && defined(USE_FSETPOS64)
5199 code = fgetpos64(f, &fpos);
5201 code = fgetpos(f, &fpos);
5203 sv_setpvn(pos, (char *) &fpos, sizeof(fpos));
5208 #if (defined(PERLIO_IS_STDIO) || !defined(USE_SFIO)) && !defined(HAS_VPRINTF)
5211 vprintf(char *pat, char *args)
5213 _doprnt(pat, args, stdout);
5214 return 0; /* wrong, but perl doesn't use the return
5219 vfprintf(FILE *fd, char *pat, char *args)
5221 _doprnt(pat, args, fd);
5222 return 0; /* wrong, but perl doesn't use the return
5228 #ifndef PerlIO_vsprintf
5230 PerlIO_vsprintf(char *s, int n, const char *fmt, va_list ap)
5233 const int val = my_vsnprintf(s, n > 0 ? n : 0, fmt, ap);
5234 PERL_UNUSED_CONTEXT;
5236 #ifndef PERL_MY_VSNPRINTF_GUARDED
5237 if (val < 0 || (n > 0 ? val >= n : 0)) {
5238 Perl_croak(aTHX_ "panic: my_vsnprintf overflow in PerlIO_vsprintf\n");
5245 #ifndef PerlIO_sprintf
5247 PerlIO_sprintf(char *s, int n, const char *fmt, ...)
5252 result = PerlIO_vsprintf(s, n, fmt, ap);
5260 * c-indentation-style: bsd
5262 * indent-tabs-mode: t
5265 * ex: set ts=8 sts=4 sw=4 noet: