2 * perlio.c Copyright (c) 1996-2002, 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.
13 * If we have ActivePerl-like PERL_IMPLICIT_SYS then we need a dTHX to get
14 * at the dispatch tables, even when we do not need it for other reasons.
15 * Invent a dSYS macro to abstract this out
17 #ifdef PERL_IMPLICIT_SYS
30 #define PERLIO_NOT_STDIO 0
31 #if !defined(PERLIO_IS_STDIO) && !defined(USE_SFIO)
37 * This file provides those parts of PerlIO abstraction
38 * which are not #defined in perlio.h.
39 * Which these are depends on various Configure #ifdef's
43 #define PERL_IN_PERLIO_C
46 #ifdef PERL_IMPLICIT_CONTEXT
54 perlsio_binmode(FILE *fp, int iotype, int mode)
57 * This used to be contents of do_binmode in doio.c
60 # if defined(atarist) || defined(__MINT__)
63 ((FILE *) fp)->_flag |= _IOBIN;
65 ((FILE *) fp)->_flag &= ~_IOBIN;
72 if (PerlLIO_setmode(fp, mode) != -1) {
74 if (PerlLIO_setmode(fileno(fp), mode) != -1) {
76 # if defined(WIN32) && defined(__BORLANDC__)
78 * The translation mode of the stream is maintained independent of
79 * the translation mode of the fd in the Borland RTL (heavy
80 * digging through their runtime sources reveal). User has to set
81 * the mode explicitly for the stream (though they don't document
82 * this anywhere). GSAR 97-5-24
96 # if defined(USEMYBINMODE)
98 if (my_binmode(fp, iotype, mode) != FALSE)
109 #define O_ACCMODE 3 /* Assume traditional implementation */
113 PerlIO_intmode2str(int rawmode, char *mode, int *writing)
115 int result = rawmode & O_ACCMODE;
120 ptype = IoTYPE_RDONLY;
123 ptype = IoTYPE_WRONLY;
131 *writing = (result != O_RDONLY);
133 if (result == O_RDONLY) {
137 else if (rawmode & O_APPEND) {
139 if (result != O_WRONLY)
144 if (result == O_WRONLY)
151 if (rawmode & O_BINARY)
157 #ifndef PERLIO_LAYERS
159 PerlIO_apply_layers(pTHX_ PerlIO *f, const char *mode, const char *names)
161 if (!names || !*names
162 || strEQ(names, ":crlf")
163 || strEQ(names, ":raw")
164 || strEQ(names, ":bytes")
168 Perl_croak(aTHX_ "Cannot apply \"%s\" in non-PerlIO perl", names);
176 PerlIO_destruct(pTHX)
181 PerlIO_binmode(pTHX_ PerlIO *fp, int iotype, int mode, const char *names)
186 return perlsio_binmode(fp, iotype, mode);
191 PerlIO_fdupopen(pTHX_ PerlIO *f, CLONE_PARAMS *param, int flags)
196 #ifdef PERL_IMPLICIT_SYS
197 return PerlSIO_fdupopen(f);
200 return win32_fdupopen(f);
203 int fd = PerlLIO_dup(PerlIO_fileno(f));
206 int omode = fcntl(fd, F_GETFL);
208 omode = djgpp_get_stream_mode(f);
210 PerlIO_intmode2str(omode,mode,NULL);
211 /* the r+ is a hack */
212 return PerlIO_fdopen(fd, mode);
217 SETERRNO(EBADF, SS_IVCHAN);
227 * De-mux PerlIO_openn() into fdopen, freopen and fopen type entries
231 PerlIO_openn(pTHX_ const char *layers, const char *mode, int fd,
232 int imode, int perm, PerlIO *old, int narg, SV **args)
236 Perl_croak(aTHX_ "More than one argument to open");
238 if (*args == &PL_sv_undef)
239 return PerlIO_tmpfile();
241 char *name = SvPV_nolen(*args);
243 fd = PerlLIO_open3(name, imode, perm);
245 return PerlIO_fdopen(fd, (char *) mode + 1);
248 return PerlIO_reopen(name, mode, old);
251 return PerlIO_open(name, mode);
256 return PerlIO_fdopen(fd, (char *) mode);
261 XS(XS_PerlIO__Layer__find)
265 Perl_croak(aTHX_ "Usage class->find(name[,load])");
267 char *name = SvPV_nolen(ST(1));
268 ST(0) = (strEQ(name, "crlf")
269 || strEQ(name, "raw")) ? &PL_sv_yes : &PL_sv_undef;
276 Perl_boot_core_PerlIO(pTHX)
278 newXS("PerlIO::Layer::find", XS_PerlIO__Layer__find, __FILE__);
284 #ifdef PERLIO_IS_STDIO
290 * Does nothing (yet) except force this file to be included in perl
291 * binary. That allows this file to force inclusion of other functions
292 * that may be required by loadable extensions e.g. for
293 * FileHandle::tmpfile
297 #undef PerlIO_tmpfile
304 #else /* PERLIO_IS_STDIO */
312 * This section is just to make sure these functions get pulled in from
316 #undef PerlIO_tmpfile
327 * Force this file to be included in perl binary. Which allows this
328 * file to force inclusion of other functions that may be required by
329 * loadable extensions e.g. for FileHandle::tmpfile
333 * Hack sfio does its own 'autoflush' on stdout in common cases. Flush
334 * results in a lot of lseek()s to regular files and lot of small
337 sfset(sfstdout, SF_SHARE, 0);
340 /* This is not the reverse of PerlIO_exportFILE(), PerlIO_releaseFILE() is. */
342 PerlIO_importFILE(FILE *stdio, const char *mode)
344 int fd = fileno(stdio);
345 if (!mode || !*mode) {
348 return PerlIO_fdopen(fd, mode);
352 PerlIO_findFILE(PerlIO *pio)
354 int fd = PerlIO_fileno(pio);
355 FILE *f = fdopen(fd, "r+");
357 if (!f && errno == EINVAL)
359 if (!f && errno == EINVAL)
366 /*======================================================================================*/
368 * Implement all the PerlIO interface ourselves.
374 * We _MUST_ have <unistd.h> if we are using lseek() and may have large
381 #include <sys/mman.h>
385 void PerlIO_debug(const char *fmt, ...)
386 __attribute__ ((format(__printf__, 1, 2)));
389 PerlIO_debug(const char *fmt, ...)
396 char *s = PerlEnv_getenv("PERLIO_DEBUG");
398 dbg = PerlLIO_open3(s, O_WRONLY | O_CREAT | O_APPEND, 0666);
405 /* Use fixed buffer as sv_catpvf etc. needs SVs */
409 s = CopFILE(PL_curcop);
412 sprintf(buffer, "%s:%" IVdf " ", s, (IV) CopLINE(PL_curcop));
413 len = strlen(buffer);
414 vsprintf(buffer+len, fmt, ap);
415 PerlLIO_write(dbg, buffer, strlen(buffer));
417 SV *sv = newSVpvn("", 0);
420 s = CopFILE(PL_curcop);
423 Perl_sv_catpvf(aTHX_ sv, "%s:%" IVdf " ", s,
424 (IV) CopLINE(PL_curcop));
425 Perl_sv_vcatpvf(aTHX_ sv, fmt, &ap);
428 PerlLIO_write(dbg, s, len);
435 /*--------------------------------------------------------------------------------------*/
438 * Inner level routines
442 * Table of pointers to the PerlIO structs (malloc'ed)
444 #define PERLIO_TABLE_SIZE 64
447 PerlIO_allocate(pTHX)
450 * Find a free slot in the table, allocating new table as necessary
455 while ((f = *last)) {
457 last = (PerlIO **) (f);
458 for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
464 Newz('I',f,PERLIO_TABLE_SIZE,PerlIO);
472 #undef PerlIO_fdupopen
474 PerlIO_fdupopen(pTHX_ PerlIO *f, CLONE_PARAMS *param, int flags)
476 if (PerlIOValid(f)) {
477 PerlIO_funcs *tab = PerlIOBase(f)->tab;
479 PerlIO_debug("fdupopen f=%p param=%p\n",(void*)f,(void*)param);
480 new = (*tab->Dup)(aTHX_ PerlIO_allocate(aTHX),f,param, flags);
484 SETERRNO(EBADF, SS_IVCHAN);
490 PerlIO_cleantable(pTHX_ PerlIO **tablep)
492 PerlIO *table = *tablep;
495 PerlIO_cleantable(aTHX_(PerlIO **) & (table[0]));
496 for (i = PERLIO_TABLE_SIZE - 1; i > 0; i--) {
497 PerlIO *f = table + i;
509 PerlIO_list_alloc(pTHX)
512 Newz('L', list, 1, PerlIO_list_t);
518 PerlIO_list_free(pTHX_ PerlIO_list_t *list)
521 if (--list->refcnt == 0) {
524 for (i = 0; i < list->cur; i++) {
525 if (list->array[i].arg)
526 SvREFCNT_dec(list->array[i].arg);
528 Safefree(list->array);
536 PerlIO_list_push(pTHX_ PerlIO_list_t *list, PerlIO_funcs *funcs, SV *arg)
539 if (list->cur >= list->len) {
542 Renew(list->array, list->len, PerlIO_pair_t);
544 New('l', list->array, list->len, PerlIO_pair_t);
546 p = &(list->array[list->cur++]);
548 if ((p->arg = arg)) {
554 PerlIO_clone_list(pTHX_ PerlIO_list_t *proto, CLONE_PARAMS *param)
556 PerlIO_list_t *list = (PerlIO_list_t *) NULL;
559 list = PerlIO_list_alloc(aTHX);
560 for (i=0; i < proto->cur; i++) {
562 if (proto->array[i].arg)
563 arg = PerlIO_sv_dup(aTHX_ proto->array[i].arg,param);
564 PerlIO_list_push(aTHX_ list, proto->array[i].funcs, arg);
571 PerlIO_clone(pTHX_ PerlInterpreter *proto, CLONE_PARAMS *param)
574 PerlIO **table = &proto->Iperlio;
577 PL_known_layers = PerlIO_clone_list(aTHX_ proto->Iknown_layers, param);
578 PL_def_layerlist = PerlIO_clone_list(aTHX_ proto->Idef_layerlist, param);
579 PerlIO_allocate(aTHX); /* root slot is never used */
580 PerlIO_debug("Clone %p from %p\n",aTHX,proto);
581 while ((f = *table)) {
583 table = (PerlIO **) (f++);
584 for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
586 (void) fp_dup(f, 0, param);
595 PerlIO_destruct(pTHX)
597 PerlIO **table = &PL_perlio;
600 PerlIO_debug("Destruct %p\n",aTHX);
602 while ((f = *table)) {
604 table = (PerlIO **) (f++);
605 for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
609 if (l->tab->kind & PERLIO_K_DESTRUCT) {
610 PerlIO_debug("Destruct popping %s\n", l->tab->name);
624 PerlIO_pop(pTHX_ PerlIO *f)
628 PerlIO_debug("PerlIO_pop f=%p %s\n", (void*)f, l->tab->name);
629 if (l->tab->Popped) {
631 * If popped returns non-zero do not free its layer structure
632 * it has either done so itself, or it is shared and still in
635 if ((*l->tab->Popped) (aTHX_ f) != 0)
643 /*--------------------------------------------------------------------------------------*/
645 * XS Interface for perl code
649 PerlIO_find_layer(pTHX_ const char *name, STRLEN len, int load)
652 if ((SSize_t) len <= 0)
654 for (i = 0; i < PL_known_layers->cur; i++) {
655 PerlIO_funcs *f = PL_known_layers->array[i].funcs;
656 if (memEQ(f->name, name, len)) {
657 PerlIO_debug("%.*s => %p\n", (int) len, name, (void*)f);
661 if (load && PL_subname && PL_def_layerlist
662 && PL_def_layerlist->cur >= 2) {
663 if (PL_in_load_module) {
664 Perl_croak(aTHX_ "Recursive call to Perl_load_module in PerlIO_find_layer");
667 SV *pkgsv = newSVpvn("PerlIO", 6);
668 SV *layer = newSVpvn(name, len);
669 CV *cv = get_cv("PerlIO::Layer::NoWarnings", FALSE);
671 SAVEINT(PL_in_load_module);
673 SAVESPTR(PL_warnhook);
674 PL_warnhook = (SV *) cv;
678 * The two SVs are magically freed by load_module
680 Perl_load_module(aTHX_ 0, pkgsv, Nullsv, layer, Nullsv);
683 return PerlIO_find_layer(aTHX_ name, len, 0);
686 PerlIO_debug("Cannot find %.*s\n", (int) len, name);
690 #ifdef USE_ATTRIBUTES_FOR_PERLIO
693 perlio_mg_set(pTHX_ SV *sv, MAGIC *mg)
696 IO *io = GvIOn((GV *) SvRV(sv));
697 PerlIO *ifp = IoIFP(io);
698 PerlIO *ofp = IoOFP(io);
699 Perl_warn(aTHX_ "set %" SVf " %p %p %p", sv, io, ifp, ofp);
705 perlio_mg_get(pTHX_ SV *sv, MAGIC *mg)
708 IO *io = GvIOn((GV *) SvRV(sv));
709 PerlIO *ifp = IoIFP(io);
710 PerlIO *ofp = IoOFP(io);
711 Perl_warn(aTHX_ "get %" SVf " %p %p %p", sv, io, ifp, ofp);
717 perlio_mg_clear(pTHX_ SV *sv, MAGIC *mg)
719 Perl_warn(aTHX_ "clear %" SVf, sv);
724 perlio_mg_free(pTHX_ SV *sv, MAGIC *mg)
726 Perl_warn(aTHX_ "free %" SVf, sv);
730 MGVTBL perlio_vtab = {
738 XS(XS_io_MODIFY_SCALAR_ATTRIBUTES)
741 SV *sv = SvRV(ST(1));
746 sv_magic(sv, (SV *) av, PERL_MAGIC_ext, NULL, 0);
748 mg = mg_find(sv, PERL_MAGIC_ext);
749 mg->mg_virtual = &perlio_vtab;
751 Perl_warn(aTHX_ "attrib %" SVf, sv);
752 for (i = 2; i < items; i++) {
754 const char *name = SvPV(ST(i), len);
755 SV *layer = PerlIO_find_layer(aTHX_ name, len, 1);
757 av_push(av, SvREFCNT_inc(layer));
768 #endif /* USE_ATTIBUTES_FOR_PERLIO */
771 PerlIO_tab_sv(pTHX_ PerlIO_funcs *tab)
773 HV *stash = gv_stashpv("PerlIO::Layer", TRUE);
774 SV *sv = sv_bless(newRV_noinc(newSViv(PTR2IV(tab))), stash);
778 XS(XS_PerlIO__Layer__NoWarnings)
780 /* This is used as a %SIG{__WARN__} handler to supress warnings
781 during loading of layers.
785 PerlIO_debug("warning:%s\n",SvPV_nolen(ST(0)));
789 XS(XS_PerlIO__Layer__find)
793 Perl_croak(aTHX_ "Usage class->find(name[,load])");
796 char *name = SvPV(ST(1), len);
797 bool load = (items > 2) ? SvTRUE(ST(2)) : 0;
798 PerlIO_funcs *layer = PerlIO_find_layer(aTHX_ name, len, load);
800 (layer) ? sv_2mortal(PerlIO_tab_sv(aTHX_ layer)) :
807 PerlIO_define_layer(pTHX_ PerlIO_funcs *tab)
809 if (!PL_known_layers)
810 PL_known_layers = PerlIO_list_alloc(aTHX);
811 PerlIO_list_push(aTHX_ PL_known_layers, tab, Nullsv);
812 PerlIO_debug("define %s %p\n", tab->name, (void*)tab);
816 PerlIO_parse_layers(pTHX_ PerlIO_list_t *av, const char *names)
819 const char *s = names;
821 while (isSPACE(*s) || *s == ':')
826 const char *as = Nullch;
828 if (!isIDFIRST(*s)) {
830 * Message is consistent with how attribute lists are
831 * passed. Even though this means "foo : : bar" is
832 * seen as an invalid separator character.
834 char q = ((*s == '\'') ? '"' : '\'');
835 if (ckWARN(WARN_LAYER))
836 Perl_warner(aTHX_ packWARN(WARN_LAYER),
837 "perlio: invalid separator character %c%c%c in layer specification list %s",
839 SETERRNO(EINVAL, LIB_INVARG);
844 } while (isALNUM(*e));
860 * It's a nul terminated string, not allowed
861 * to \ the terminating null. Anything other
862 * character is passed over.
872 if (ckWARN(WARN_LAYER))
873 Perl_warner(aTHX_ packWARN(WARN_LAYER),
874 "perlio: argument list not closed for layer \"%.*s\"",
886 bool warn_layer = ckWARN(WARN_LAYER);
887 PerlIO_funcs *layer =
888 PerlIO_find_layer(aTHX_ s, llen, 1);
890 PerlIO_list_push(aTHX_ av, layer,
897 Perl_warner(aTHX_ packWARN(WARN_LAYER), "perlio: unknown layer \"%.*s\"",
910 PerlIO_default_buffer(pTHX_ PerlIO_list_t *av)
912 PerlIO_funcs *tab = &PerlIO_perlio;
913 #ifdef PERLIO_USING_CRLF
916 if (PerlIO_stdio.Set_ptrcnt)
919 PerlIO_debug("Pushing %s\n", tab->name);
920 PerlIO_list_push(aTHX_ av, PerlIO_find_layer(aTHX_ tab->name, 0, 0),
925 PerlIO_arg_fetch(PerlIO_list_t *av, IV n)
927 return av->array[n].arg;
931 PerlIO_layer_fetch(pTHX_ PerlIO_list_t *av, IV n, PerlIO_funcs *def)
933 if (n >= 0 && n < av->cur) {
934 PerlIO_debug("Layer %" IVdf " is %s\n", n,
935 av->array[n].funcs->name);
936 return av->array[n].funcs;
939 Perl_croak(aTHX_ "panic: PerlIO layer array corrupt");
944 PerlIOPop_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
946 if (PerlIOValid(f)) {
954 PerlIO_funcs PerlIO_remove = {
955 sizeof(PerlIO_funcs),
958 PERLIO_K_DUMMY | PERLIO_K_UTF8,
977 NULL, /* get_bufsiz */
980 NULL, /* set_ptrcnt */
984 PerlIO_default_layers(pTHX)
986 if (!PL_def_layerlist) {
987 const char *s = (PL_tainting) ? Nullch : PerlEnv_getenv("PERLIO");
988 PerlIO_funcs *osLayer = &PerlIO_unix;
989 PL_def_layerlist = PerlIO_list_alloc(aTHX);
990 PerlIO_define_layer(aTHX_ & PerlIO_unix);
991 #if defined(WIN32) && !defined(UNDER_CE)
992 PerlIO_define_layer(aTHX_ & PerlIO_win32);
994 osLayer = &PerlIO_win32;
997 PerlIO_define_layer(aTHX_ & PerlIO_raw);
998 PerlIO_define_layer(aTHX_ & PerlIO_perlio);
999 PerlIO_define_layer(aTHX_ & PerlIO_stdio);
1000 PerlIO_define_layer(aTHX_ & PerlIO_crlf);
1002 PerlIO_define_layer(aTHX_ & PerlIO_mmap);
1004 PerlIO_define_layer(aTHX_ & PerlIO_utf8);
1005 PerlIO_define_layer(aTHX_ & PerlIO_remove);
1006 PerlIO_define_layer(aTHX_ & PerlIO_byte);
1007 PerlIO_list_push(aTHX_ PL_def_layerlist,
1008 PerlIO_find_layer(aTHX_ osLayer->name, 0, 0),
1011 PerlIO_parse_layers(aTHX_ PL_def_layerlist, s);
1014 PerlIO_default_buffer(aTHX_ PL_def_layerlist);
1017 if (PL_def_layerlist->cur < 2) {
1018 PerlIO_default_buffer(aTHX_ PL_def_layerlist);
1020 return PL_def_layerlist;
1024 Perl_boot_core_PerlIO(pTHX)
1026 #ifdef USE_ATTRIBUTES_FOR_PERLIO
1027 newXS("io::MODIFY_SCALAR_ATTRIBUTES", XS_io_MODIFY_SCALAR_ATTRIBUTES,
1030 newXS("PerlIO::Layer::find", XS_PerlIO__Layer__find, __FILE__);
1031 newXS("PerlIO::Layer::NoWarnings", XS_PerlIO__Layer__NoWarnings, __FILE__);
1035 PerlIO_default_layer(pTHX_ I32 n)
1037 PerlIO_list_t *av = PerlIO_default_layers(aTHX);
1040 return PerlIO_layer_fetch(aTHX_ av, n, &PerlIO_stdio);
1043 #define PerlIO_default_top() PerlIO_default_layer(aTHX_ -1)
1044 #define PerlIO_default_btm() PerlIO_default_layer(aTHX_ 0)
1047 PerlIO_stdstreams(pTHX)
1050 PerlIO_allocate(aTHX);
1051 PerlIO_fdopen(0, "Ir" PERLIO_STDTEXT);
1052 PerlIO_fdopen(1, "Iw" PERLIO_STDTEXT);
1053 PerlIO_fdopen(2, "Iw" PERLIO_STDTEXT);
1058 PerlIO_push(pTHX_ PerlIO *f, PerlIO_funcs *tab, const char *mode, SV *arg)
1060 if (tab->fsize != sizeof(PerlIO_funcs)) {
1062 Perl_croak(aTHX_ "Layer does not match this perl");
1066 if (tab->size < sizeof(PerlIOl)) {
1069 /* Real layer with a data area */
1070 Newc('L',l,tab->size,char,PerlIOl);
1072 Zero(l, tab->size, char);
1076 PerlIO_debug("PerlIO_push f=%p %s %s %p\n", (void*)f, tab->name,
1077 (mode) ? mode : "(Null)", (void*)arg);
1078 if ((*l->tab->Pushed) (aTHX_ f, mode, arg, tab) != 0) {
1079 PerlIO_pop(aTHX_ f);
1085 /* Pseudo-layer where push does its own stack adjust */
1086 PerlIO_debug("PerlIO_push f=%p %s %s %p\n", (void*)f, tab->name,
1087 (mode) ? mode : "(Null)", (void*)arg);
1088 if ((*tab->Pushed) (aTHX_ f, mode, arg, tab) != 0) {
1096 PerlIOBase_binmode(pTHX_ PerlIO *f)
1098 if (PerlIOValid(f)) {
1099 /* Is layer suitable for raw stream ? */
1100 if (PerlIOBase(f)->tab->kind & PERLIO_K_RAW) {
1101 /* Yes - turn off UTF-8-ness, to undo UTF-8 locale effects */
1102 PerlIOBase(f)->flags &= ~PERLIO_F_UTF8;
1105 /* Not suitable - pop it */
1106 PerlIO_pop(aTHX_ f);
1114 PerlIORaw_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
1117 if (PerlIOValid(f)) {
1122 * Strip all layers that are not suitable for a raw stream
1125 while (t && (l = *t)) {
1126 if (l->tab->Binmode) {
1127 /* Has a handler - normal case */
1128 if ((*l->tab->Binmode)(aTHX_ f) == 0) {
1130 /* Layer still there - move down a layer */
1139 /* No handler - pop it */
1140 PerlIO_pop(aTHX_ t);
1143 if (PerlIOValid(f)) {
1144 PerlIO_debug(":raw f=%p :%s\n", (void*)f, PerlIOBase(f)->tab->name);
1152 PerlIO_apply_layera(pTHX_ PerlIO *f, const char *mode,
1153 PerlIO_list_t *layers, IV n, IV max)
1157 PerlIO_funcs *tab = PerlIO_layer_fetch(aTHX_ layers, n, NULL);
1159 if (!PerlIO_push(aTHX_ f, tab, mode, PerlIOArg)) {
1170 PerlIO_apply_layers(pTHX_ PerlIO *f, const char *mode, const char *names)
1174 PerlIO_list_t *layers = PerlIO_list_alloc(aTHX);
1175 code = PerlIO_parse_layers(aTHX_ layers, names);
1177 code = PerlIO_apply_layera(aTHX_ f, mode, layers, 0, layers->cur);
1179 PerlIO_list_free(aTHX_ layers);
1185 /*--------------------------------------------------------------------------------------*/
1187 * Given the abstraction above the public API functions
1191 PerlIO_binmode(pTHX_ PerlIO *f, int iotype, int mode, const char *names)
1193 PerlIO_debug("PerlIO_binmode f=%p %s %c %x %s\n",
1194 (void*)f, PerlIOBase(f)->tab->name, iotype, mode,
1195 (names) ? names : "(Null)");
1197 /* Do not flush etc. if (e.g.) switching encodings.
1198 if a pushed layer knows it needs to flush lower layers
1199 (for example :unix which is never going to call them)
1200 it can do the flush when it is pushed.
1202 return PerlIO_apply_layers(aTHX_ f, NULL, names) == 0 ? TRUE : FALSE;
1205 /* Fake 5.6 legacy of using this call to turn ON O_TEXT */
1206 #ifdef PERLIO_USING_CRLF
1207 /* Legacy binmode only has meaning if O_TEXT has a value distinct from
1208 O_BINARY so we can look for it in mode.
1210 if (!(mode & O_BINARY)) {
1212 /* FIXME?: Looking down the layer stack seems wrong,
1213 but is a way of reaching past (say) an encoding layer
1214 to flip CRLF-ness of the layer(s) below
1217 /* Perhaps we should turn on bottom-most aware layer
1218 e.g. Ilya's idea that UNIX TTY could serve
1220 if (PerlIOBase(f)->tab->kind & PERLIO_K_CANCRLF) {
1221 if (!(PerlIOBase(f)->flags & PERLIO_F_CRLF)) {
1222 /* Not in text mode - flush any pending stuff and flip it */
1224 PerlIOBase(f)->flags |= PERLIO_F_CRLF;
1226 /* Only need to turn it on in one layer so we are done */
1231 /* Not finding a CRLF aware layer presumably means we are binary
1232 which is not what was requested - so we failed
1233 We _could_ push :crlf layer but so could caller
1238 /* Legacy binmode is now _defined_ as being equivalent to pushing :raw
1239 So code that used to be here is now in PerlIORaw_pushed().
1241 return PerlIO_push(aTHX_ f, &PerlIO_raw, Nullch, Nullsv) ? TRUE : FALSE;
1246 PerlIO__close(pTHX_ PerlIO *f)
1249 return (*PerlIOBase(f)->tab->Close) (aTHX_ f);
1251 SETERRNO(EBADF, SS_IVCHAN);
1257 Perl_PerlIO_close(pTHX_ PerlIO *f)
1260 if (PerlIOValid(f)) {
1261 code = (*PerlIOBase(f)->tab->Close) (aTHX_ f);
1263 PerlIO_pop(aTHX_ f);
1270 Perl_PerlIO_fileno(pTHX_ PerlIO *f)
1273 return (*PerlIOBase(f)->tab->Fileno) (aTHX_ f);
1275 SETERRNO(EBADF, SS_IVCHAN);
1281 PerlIO_context_layers(pTHX_ const char *mode)
1283 const char *type = NULL;
1285 * Need to supply default layer info from open.pm
1288 SV *layers = PL_curcop->cop_io;
1291 type = SvPV(layers, len);
1292 if (type && mode[0] != 'r') {
1294 * Skip to write part
1296 const char *s = strchr(type, 0);
1297 if (s && (STRLEN)(s - type) < len) {
1306 static PerlIO_funcs *
1307 PerlIO_layer_from_ref(pTHX_ SV *sv)
1310 * For any scalar type load the handler which is bundled with perl
1312 if (SvTYPE(sv) < SVt_PVAV)
1313 return PerlIO_find_layer(aTHX_ "scalar", 6, 1);
1316 * For other types allow if layer is known but don't try and load it
1318 switch (SvTYPE(sv)) {
1320 return PerlIO_find_layer(aTHX_ "Array", 5, 0);
1322 return PerlIO_find_layer(aTHX_ "Hash", 4, 0);
1324 return PerlIO_find_layer(aTHX_ "Code", 4, 0);
1326 return PerlIO_find_layer(aTHX_ "Glob", 4, 0);
1332 PerlIO_resolve_layers(pTHX_ const char *layers,
1333 const char *mode, int narg, SV **args)
1335 PerlIO_list_t *def = PerlIO_default_layers(aTHX);
1338 PerlIO_stdstreams(aTHX);
1342 * If it is a reference but not an object see if we have a handler
1345 if (SvROK(arg) && !sv_isobject(arg)) {
1346 PerlIO_funcs *handler = PerlIO_layer_from_ref(aTHX_ SvRV(arg));
1348 def = PerlIO_list_alloc(aTHX);
1349 PerlIO_list_push(aTHX_ def, handler, &PL_sv_undef);
1353 * Don't fail if handler cannot be found :via(...) etc. may do
1354 * something sensible else we will just stringfy and open
1360 layers = PerlIO_context_layers(aTHX_ mode);
1361 if (layers && *layers) {
1365 av = PerlIO_list_alloc(aTHX);
1366 for (i = 0; i < def->cur; i++) {
1367 PerlIO_list_push(aTHX_ av, def->array[i].funcs,
1374 if (PerlIO_parse_layers(aTHX_ av, layers) == 0) {
1378 PerlIO_list_free(aTHX_ av);
1379 return (PerlIO_list_t *) NULL;
1390 PerlIO_openn(pTHX_ const char *layers, const char *mode, int fd,
1391 int imode, int perm, PerlIO *f, int narg, SV **args)
1393 if (!f && narg == 1 && *args == &PL_sv_undef) {
1394 if ((f = PerlIO_tmpfile())) {
1396 layers = PerlIO_context_layers(aTHX_ mode);
1397 if (layers && *layers)
1398 PerlIO_apply_layers(aTHX_ f, mode, layers);
1402 PerlIO_list_t *layera = NULL;
1404 PerlIO_funcs *tab = NULL;
1405 if (PerlIOValid(f)) {
1407 * This is "reopen" - it is not tested as perl does not use it
1411 layera = PerlIO_list_alloc(aTHX);
1413 SV *arg = (l->tab->Getarg)
1414 ? (*l->tab->Getarg) (aTHX_ &l, NULL, 0)
1416 PerlIO_list_push(aTHX_ layera, l->tab, arg);
1417 l = *PerlIONext(&l);
1421 layera = PerlIO_resolve_layers(aTHX_ layers, mode, narg, args);
1427 * Start at "top" of layer stack
1429 n = layera->cur - 1;
1431 PerlIO_funcs *t = PerlIO_layer_fetch(aTHX_ layera, n, NULL);
1440 * Found that layer 'n' can do opens - call it
1442 if (narg > 1 && !(tab->kind & PERLIO_K_MULTIARG)) {
1443 Perl_croak(aTHX_ "More than one argument to open(,':%s')",tab->name);
1445 PerlIO_debug("openn(%s,'%s','%s',%d,%x,%o,%p,%d,%p)\n",
1446 tab->name, layers, mode, fd, imode, perm,
1447 (void*)f, narg, (void*)args);
1448 f = (*tab->Open) (aTHX_ tab, layera, n, mode, fd, imode, perm,
1451 if (n + 1 < layera->cur) {
1453 * More layers above the one that we used to open -
1456 if (PerlIO_apply_layera(aTHX_ f, mode, layera, n + 1, layera->cur) != 0) {
1457 /* If pushing layers fails close the file */
1464 PerlIO_list_free(aTHX_ layera);
1471 Perl_PerlIO_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
1474 return (*PerlIOBase(f)->tab->Read) (aTHX_ f, vbuf, count);
1476 SETERRNO(EBADF, SS_IVCHAN);
1482 Perl_PerlIO_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
1485 return (*PerlIOBase(f)->tab->Unread) (aTHX_ f, vbuf, count);
1487 SETERRNO(EBADF, SS_IVCHAN);
1493 Perl_PerlIO_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
1496 return (*PerlIOBase(f)->tab->Write) (aTHX_ f, vbuf, count);
1498 SETERRNO(EBADF, SS_IVCHAN);
1504 Perl_PerlIO_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
1507 return (*PerlIOBase(f)->tab->Seek) (aTHX_ f, offset, whence);
1509 SETERRNO(EBADF, SS_IVCHAN);
1515 Perl_PerlIO_tell(pTHX_ PerlIO *f)
1518 return (*PerlIOBase(f)->tab->Tell) (aTHX_ f);
1520 SETERRNO(EBADF, SS_IVCHAN);
1526 Perl_PerlIO_flush(pTHX_ PerlIO *f)
1530 PerlIO_funcs *tab = PerlIOBase(f)->tab;
1531 if (tab && tab->Flush) {
1532 return (*tab->Flush) (aTHX_ f);
1535 PerlIO_debug("Cannot flush f=%p :%s\n", (void*)f, tab->name);
1536 SETERRNO(EBADF, SS_IVCHAN);
1541 PerlIO_debug("Cannot flush f=%p\n", (void*)f);
1542 SETERRNO(EBADF, SS_IVCHAN);
1548 * Is it good API design to do flush-all on NULL, a potentially
1549 * errorneous input? Maybe some magical value (PerlIO*
1550 * PERLIO_FLUSH_ALL = (PerlIO*)-1;)? Yes, stdio does similar
1551 * things on fflush(NULL), but should we be bound by their design
1554 PerlIO **table = &PL_perlio;
1556 while ((f = *table)) {
1558 table = (PerlIO **) (f++);
1559 for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
1560 if (*f && PerlIO_flush(f) != 0)
1570 PerlIOBase_flush_linebuf(pTHX)
1572 PerlIO **table = &PL_perlio;
1574 while ((f = *table)) {
1576 table = (PerlIO **) (f++);
1577 for (i = 1; i < PERLIO_TABLE_SIZE; i++) {
1580 flags & (PERLIO_F_LINEBUF | PERLIO_F_CANWRITE))
1581 == (PERLIO_F_LINEBUF | PERLIO_F_CANWRITE))
1589 Perl_PerlIO_fill(pTHX_ PerlIO *f)
1592 return (*PerlIOBase(f)->tab->Fill) (aTHX_ f);
1594 SETERRNO(EBADF, SS_IVCHAN);
1600 PerlIO_isutf8(PerlIO *f)
1603 return (PerlIOBase(f)->flags & PERLIO_F_UTF8) != 0;
1605 SETERRNO(EBADF, SS_IVCHAN);
1611 Perl_PerlIO_eof(pTHX_ PerlIO *f)
1614 return (*PerlIOBase(f)->tab->Eof) (aTHX_ f);
1616 SETERRNO(EBADF, SS_IVCHAN);
1622 Perl_PerlIO_error(pTHX_ PerlIO *f)
1625 return (*PerlIOBase(f)->tab->Error) (aTHX_ f);
1627 SETERRNO(EBADF, SS_IVCHAN);
1633 Perl_PerlIO_clearerr(pTHX_ PerlIO *f)
1636 (*PerlIOBase(f)->tab->Clearerr) (aTHX_ f);
1638 SETERRNO(EBADF, SS_IVCHAN);
1642 Perl_PerlIO_setlinebuf(pTHX_ PerlIO *f)
1645 (*PerlIOBase(f)->tab->Setlinebuf) (aTHX_ f);
1647 SETERRNO(EBADF, SS_IVCHAN);
1651 PerlIO_has_base(PerlIO *f)
1653 if (PerlIOValid(f)) {
1654 return (PerlIOBase(f)->tab->Get_base != NULL);
1660 PerlIO_fast_gets(PerlIO *f)
1662 if (PerlIOValid(f) && (PerlIOBase(f)->flags & PERLIO_F_FASTGETS)) {
1663 PerlIO_funcs *tab = PerlIOBase(f)->tab;
1664 return (tab->Set_ptrcnt != NULL);
1670 PerlIO_has_cntptr(PerlIO *f)
1672 if (PerlIOValid(f)) {
1673 PerlIO_funcs *tab = PerlIOBase(f)->tab;
1674 return (tab->Get_ptr != NULL && tab->Get_cnt != NULL);
1680 PerlIO_canset_cnt(PerlIO *f)
1682 if (PerlIOValid(f)) {
1683 PerlIOl *l = PerlIOBase(f);
1684 return (l->tab->Set_ptrcnt != NULL);
1690 Perl_PerlIO_get_base(pTHX_ PerlIO *f)
1693 return (*PerlIOBase(f)->tab->Get_base) (aTHX_ f);
1698 Perl_PerlIO_get_bufsiz(pTHX_ PerlIO *f)
1701 return (*PerlIOBase(f)->tab->Get_bufsiz) (aTHX_ f);
1706 Perl_PerlIO_get_ptr(pTHX_ PerlIO *f)
1708 if (PerlIOValid(f)) {
1709 PerlIO_funcs *tab = PerlIOBase(f)->tab;
1710 if (tab->Get_ptr == NULL)
1712 return (*tab->Get_ptr) (aTHX_ f);
1718 Perl_PerlIO_get_cnt(pTHX_ PerlIO *f)
1720 if (PerlIOValid(f)) {
1721 PerlIO_funcs *tab = PerlIOBase(f)->tab;
1722 if (tab->Get_cnt == NULL)
1724 return (*tab->Get_cnt) (aTHX_ f);
1730 Perl_PerlIO_set_cnt(pTHX_ PerlIO *f, int cnt)
1732 if (PerlIOValid(f)) {
1733 (*PerlIOBase(f)->tab->Set_ptrcnt) (aTHX_ f, NULL, cnt);
1738 Perl_PerlIO_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, int cnt)
1740 if (PerlIOValid(f)) {
1741 PerlIO_funcs *tab = PerlIOBase(f)->tab;
1742 if (tab->Set_ptrcnt == NULL) {
1743 Perl_croak(aTHX_ "PerlIO buffer snooping abuse");
1745 (*PerlIOBase(f)->tab->Set_ptrcnt) (aTHX_ f, ptr, cnt);
1750 /*--------------------------------------------------------------------------------------*/
1752 * utf8 and raw dummy layers
1756 PerlIOUtf8_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
1758 if (PerlIOValid(f)) {
1759 if (tab->kind & PERLIO_K_UTF8)
1760 PerlIOBase(f)->flags |= PERLIO_F_UTF8;
1762 PerlIOBase(f)->flags &= ~PERLIO_F_UTF8;
1768 PerlIO_funcs PerlIO_utf8 = {
1769 sizeof(PerlIO_funcs),
1772 PERLIO_K_DUMMY | PERLIO_K_UTF8,
1790 NULL, /* get_base */
1791 NULL, /* get_bufsiz */
1794 NULL, /* set_ptrcnt */
1797 PerlIO_funcs PerlIO_byte = {
1798 sizeof(PerlIO_funcs),
1819 NULL, /* get_base */
1820 NULL, /* get_bufsiz */
1823 NULL, /* set_ptrcnt */
1827 PerlIORaw_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
1828 IV n, const char *mode, int fd, int imode, int perm,
1829 PerlIO *old, int narg, SV **args)
1831 PerlIO_funcs *tab = PerlIO_default_btm();
1832 return (*tab->Open) (aTHX_ tab, layers, n - 1, mode, fd, imode, perm,
1836 PerlIO_funcs PerlIO_raw = {
1837 sizeof(PerlIO_funcs),
1858 NULL, /* get_base */
1859 NULL, /* get_bufsiz */
1862 NULL, /* set_ptrcnt */
1864 /*--------------------------------------------------------------------------------------*/
1865 /*--------------------------------------------------------------------------------------*/
1867 * "Methods" of the "base class"
1871 PerlIOBase_fileno(pTHX_ PerlIO *f)
1873 return PerlIOValid(f) ? PerlIO_fileno(PerlIONext(f)) : -1;
1877 PerlIO_modestr(PerlIO * f, char *buf)
1880 if (PerlIOValid(f)) {
1881 IV flags = PerlIOBase(f)->flags;
1882 if (flags & PERLIO_F_APPEND) {
1884 if (flags & PERLIO_F_CANREAD) {
1888 else if (flags & PERLIO_F_CANREAD) {
1890 if (flags & PERLIO_F_CANWRITE)
1893 else if (flags & PERLIO_F_CANWRITE) {
1895 if (flags & PERLIO_F_CANREAD) {
1899 #ifdef PERLIO_USING_CRLF
1900 if (!(flags & PERLIO_F_CRLF))
1910 PerlIOBase_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
1912 PerlIOl *l = PerlIOBase(f);
1914 const char *omode = mode;
1917 l->flags &= ~(PERLIO_F_CANREAD | PERLIO_F_CANWRITE |
1918 PERLIO_F_TRUNCATE | PERLIO_F_APPEND);
1919 if (tab->Set_ptrcnt != NULL)
1920 l->flags |= PERLIO_F_FASTGETS;
1922 if (*mode == '#' || *mode == 'I')
1926 l->flags |= PERLIO_F_CANREAD;
1929 l->flags |= PERLIO_F_APPEND | PERLIO_F_CANWRITE;
1932 l->flags |= PERLIO_F_TRUNCATE | PERLIO_F_CANWRITE;
1935 SETERRNO(EINVAL, LIB_INVARG);
1941 l->flags |= PERLIO_F_CANREAD | PERLIO_F_CANWRITE;
1944 l->flags &= ~PERLIO_F_CRLF;
1947 l->flags |= PERLIO_F_CRLF;
1950 SETERRNO(EINVAL, LIB_INVARG);
1957 l->flags |= l->next->flags &
1958 (PERLIO_F_CANREAD | PERLIO_F_CANWRITE | PERLIO_F_TRUNCATE |
1963 PerlIO_debug("PerlIOBase_pushed f=%p %s %s fl=%08" UVxf " (%s)\n",
1964 f, PerlIOBase(f)->tab->name, (omode) ? omode : "(Null)",
1965 l->flags, PerlIO_modestr(f, temp));
1971 PerlIOBase_popped(pTHX_ PerlIO *f)
1977 PerlIOBase_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
1980 * Save the position as current head considers it
1982 Off_t old = PerlIO_tell(f);
1984 PerlIO_push(aTHX_ f, &PerlIO_pending, "r", Nullsv);
1985 PerlIOSelf(f, PerlIOBuf)->posn = old;
1986 done = PerlIOBuf_unread(aTHX_ f, vbuf, count);
1991 PerlIOBase_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
1993 STDCHAR *buf = (STDCHAR *) vbuf;
1995 if (!(PerlIOBase(f)->flags & PERLIO_F_CANREAD))
1998 SSize_t avail = PerlIO_get_cnt(f);
2001 take = ((SSize_t)count < avail) ? count : avail;
2003 STDCHAR *ptr = PerlIO_get_ptr(f);
2004 Copy(ptr, buf, take, STDCHAR);
2005 PerlIO_set_ptrcnt(f, ptr + take, (avail -= take));
2009 if (count > 0 && avail <= 0) {
2010 if (PerlIO_fill(f) != 0)
2014 return (buf - (STDCHAR *) vbuf);
2020 PerlIOBase_noop_ok(pTHX_ PerlIO *f)
2026 PerlIOBase_noop_fail(pTHX_ PerlIO *f)
2032 PerlIOBase_close(pTHX_ PerlIO *f)
2035 PerlIO *n = PerlIONext(f);
2036 if (PerlIO_flush(f) != 0)
2038 if (PerlIOValid(n) && (*PerlIOBase(n)->tab->Close)(aTHX_ n) != 0)
2040 PerlIOBase(f)->flags &=
2041 ~(PERLIO_F_CANREAD | PERLIO_F_CANWRITE | PERLIO_F_OPEN);
2046 PerlIOBase_eof(pTHX_ PerlIO *f)
2048 if (PerlIOValid(f)) {
2049 return (PerlIOBase(f)->flags & PERLIO_F_EOF) != 0;
2055 PerlIOBase_error(pTHX_ PerlIO *f)
2057 if (PerlIOValid(f)) {
2058 return (PerlIOBase(f)->flags & PERLIO_F_ERROR) != 0;
2064 PerlIOBase_clearerr(pTHX_ PerlIO *f)
2066 if (PerlIOValid(f)) {
2067 PerlIO *n = PerlIONext(f);
2068 PerlIOBase(f)->flags &= ~(PERLIO_F_ERROR | PERLIO_F_EOF);
2075 PerlIOBase_setlinebuf(pTHX_ PerlIO *f)
2077 if (PerlIOValid(f)) {
2078 PerlIOBase(f)->flags |= PERLIO_F_LINEBUF;
2083 PerlIO_sv_dup(pTHX_ SV *arg, CLONE_PARAMS *param)
2089 return sv_dup(arg, param);
2092 return newSVsv(arg);
2095 return newSVsv(arg);
2100 PerlIOBase_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
2102 PerlIO *nexto = PerlIONext(o);
2103 if (PerlIOValid(nexto)) {
2104 PerlIO_funcs *tab = PerlIOBase(nexto)->tab;
2105 f = (*tab->Dup)(aTHX_ f, nexto, param, flags);
2108 PerlIO_funcs *self = PerlIOBase(o)->tab;
2111 PerlIO_debug("PerlIOBase_dup %s f=%p o=%p param=%p\n",
2112 self->name, (void*)f, (void*)o, (void*)param);
2114 arg = (*self->Getarg)(aTHX_ o,param,flags);
2116 f = PerlIO_push(aTHX_ f, self, PerlIO_modestr(o,buf), arg);
2124 #define PERLIO_MAX_REFCOUNTABLE_FD 2048
2126 perl_mutex PerlIO_mutex;
2128 int PerlIO_fd_refcnt[PERLIO_MAX_REFCOUNTABLE_FD];
2133 /* Place holder for stdstreams call ??? */
2135 MUTEX_INIT(&PerlIO_mutex);
2140 PerlIOUnix_refcnt_inc(int fd)
2142 if (fd >= 0 && fd < PERLIO_MAX_REFCOUNTABLE_FD) {
2144 MUTEX_LOCK(&PerlIO_mutex);
2146 PerlIO_fd_refcnt[fd]++;
2147 PerlIO_debug("fd %d refcnt=%d\n",fd,PerlIO_fd_refcnt[fd]);
2149 MUTEX_UNLOCK(&PerlIO_mutex);
2155 PerlIOUnix_refcnt_dec(int fd)
2158 if (fd >= 0 && fd < PERLIO_MAX_REFCOUNTABLE_FD) {
2160 MUTEX_LOCK(&PerlIO_mutex);
2162 cnt = --PerlIO_fd_refcnt[fd];
2163 PerlIO_debug("fd %d refcnt=%d\n",fd,cnt);
2165 MUTEX_UNLOCK(&PerlIO_mutex);
2172 PerlIO_cleanup(pTHX)
2176 PerlIO_debug("Cleanup layers for %p\n",aTHX);
2178 PerlIO_debug("Cleanup layers\n");
2180 /* Raise STDIN..STDERR refcount so we don't close them */
2181 for (i=0; i < 3; i++)
2182 PerlIOUnix_refcnt_inc(i);
2183 PerlIO_cleantable(aTHX_ &PL_perlio);
2184 /* Restore STDIN..STDERR refcount */
2185 for (i=0; i < 3; i++)
2186 PerlIOUnix_refcnt_dec(i);
2188 if (PL_known_layers) {
2189 PerlIO_list_free(aTHX_ PL_known_layers);
2190 PL_known_layers = NULL;
2192 if(PL_def_layerlist) {
2193 PerlIO_list_free(aTHX_ PL_def_layerlist);
2194 PL_def_layerlist = NULL;
2200 /*--------------------------------------------------------------------------------------*/
2202 * Bottom-most level for UNIX-like case
2206 struct _PerlIO base; /* The generic part */
2207 int fd; /* UNIX like file descriptor */
2208 int oflags; /* open/fcntl flags */
2212 PerlIOUnix_oflags(const char *mode)
2215 if (*mode == 'I' || *mode == '#')
2220 if (*++mode == '+') {
2227 oflags = O_CREAT | O_TRUNC;
2228 if (*++mode == '+') {
2237 oflags = O_CREAT | O_APPEND;
2238 if (*++mode == '+') {
2251 else if (*mode == 't') {
2253 oflags &= ~O_BINARY;
2257 * Always open in binary mode
2260 if (*mode || oflags == -1) {
2261 SETERRNO(EINVAL, LIB_INVARG);
2268 PerlIOUnix_fileno(pTHX_ PerlIO *f)
2270 return PerlIOSelf(f, PerlIOUnix)->fd;
2274 PerlIOUnix_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
2276 IV code = PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
2277 PerlIOUnix *s = PerlIOSelf(f, PerlIOUnix);
2278 if (*PerlIONext(f)) {
2279 /* We never call down so do any pending stuff now */
2280 PerlIO_flush(PerlIONext(f));
2281 s->fd = PerlIO_fileno(PerlIONext(f));
2283 * XXX could (or should) we retrieve the oflags from the open file
2284 * handle rather than believing the "mode" we are passed in? XXX
2285 * Should the value on NULL mode be 0 or -1?
2287 s->oflags = mode ? PerlIOUnix_oflags(mode) : -1;
2289 PerlIOBase(f)->flags |= PERLIO_F_OPEN;
2294 PerlIOUnix_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
2295 IV n, const char *mode, int fd, int imode,
2296 int perm, PerlIO *f, int narg, SV **args)
2298 if (PerlIOValid(f)) {
2299 if (PerlIOBase(f)->flags & PERLIO_F_OPEN)
2300 (*PerlIOBase(f)->tab->Close)(aTHX_ f);
2303 char *path = SvPV_nolen(*args);
2307 imode = PerlIOUnix_oflags(mode);
2311 fd = PerlLIO_open3(path, imode, perm);
2319 f = PerlIO_allocate(aTHX);
2321 if (!PerlIOValid(f)) {
2322 if (!(f = PerlIO_push(aTHX_ f, self, mode, PerlIOArg))) {
2326 s = PerlIOSelf(f, PerlIOUnix);
2329 PerlIOBase(f)->flags |= PERLIO_F_OPEN;
2330 PerlIOUnix_refcnt_inc(fd);
2336 * FIXME: pop layers ???
2344 PerlIOUnix_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
2346 PerlIOUnix *os = PerlIOSelf(o, PerlIOUnix);
2348 if (flags & PERLIO_DUP_FD) {
2349 fd = PerlLIO_dup(fd);
2351 if (fd >= 0 && fd < PERLIO_MAX_REFCOUNTABLE_FD) {
2352 f = PerlIOBase_dup(aTHX_ f, o, param, flags);
2354 /* If all went well overwrite fd in dup'ed lay with the dup()'ed fd */
2355 PerlIOUnix *s = PerlIOSelf(f, PerlIOUnix);
2357 PerlIOUnix_refcnt_inc(fd);
2366 PerlIOUnix_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
2368 int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2369 if (!(PerlIOBase(f)->flags & PERLIO_F_CANREAD) ||
2370 PerlIOBase(f)->flags & (PERLIO_F_EOF|PERLIO_F_ERROR)) {
2374 SSize_t len = PerlLIO_read(fd, vbuf, count);
2375 if (len >= 0 || errno != EINTR) {
2377 PerlIOBase(f)->flags |= PERLIO_F_ERROR;
2378 else if (len == 0 && count != 0)
2379 PerlIOBase(f)->flags |= PERLIO_F_EOF;
2387 PerlIOUnix_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
2389 int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2391 SSize_t len = PerlLIO_write(fd, vbuf, count);
2392 if (len >= 0 || errno != EINTR) {
2394 PerlIOBase(f)->flags |= PERLIO_F_ERROR;
2402 PerlIOUnix_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
2405 PerlLIO_lseek(PerlIOSelf(f, PerlIOUnix)->fd, offset, whence);
2406 PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
2407 return (new == (Off_t) - 1) ? -1 : 0;
2411 PerlIOUnix_tell(pTHX_ PerlIO *f)
2413 return PerlLIO_lseek(PerlIOSelf(f, PerlIOUnix)->fd, 0, SEEK_CUR);
2418 PerlIOUnix_close(pTHX_ PerlIO *f)
2420 int fd = PerlIOSelf(f, PerlIOUnix)->fd;
2422 if (PerlIOBase(f)->flags & PERLIO_F_OPEN) {
2423 if (PerlIOUnix_refcnt_dec(fd) > 0) {
2424 PerlIOBase(f)->flags &= ~PERLIO_F_OPEN;
2429 SETERRNO(EBADF,SS_IVCHAN);
2432 while (PerlLIO_close(fd) != 0) {
2433 if (errno != EINTR) {
2440 PerlIOBase(f)->flags &= ~PERLIO_F_OPEN;
2445 PerlIO_funcs PerlIO_unix = {
2446 sizeof(PerlIO_funcs),
2453 PerlIOBase_binmode, /* binmode */
2463 PerlIOBase_noop_ok, /* flush */
2464 PerlIOBase_noop_fail, /* fill */
2467 PerlIOBase_clearerr,
2468 PerlIOBase_setlinebuf,
2469 NULL, /* get_base */
2470 NULL, /* get_bufsiz */
2473 NULL, /* set_ptrcnt */
2476 /*--------------------------------------------------------------------------------------*/
2481 #if defined(VMS) && !defined(STDIO_BUFFER_WRITABLE)
2482 /* perl5.8 - This ensures the last minute VMS ungetc fix is not
2483 broken by the last second glibc 2.3 fix
2485 #define STDIO_BUFFER_WRITABLE
2490 struct _PerlIO base;
2491 FILE *stdio; /* The stream */
2495 PerlIOStdio_fileno(pTHX_ PerlIO *f)
2498 if (PerlIOValid(f) && (s = PerlIOSelf(f, PerlIOStdio)->stdio)) {
2499 return PerlSIO_fileno(s);
2506 PerlIOStdio_mode(const char *mode, char *tmode)
2512 #ifdef PERLIO_USING_CRLF
2520 PerlIOStdio_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
2523 if (PerlIOValid(f) && PerlIOValid(n = PerlIONext(f))) {
2524 PerlIO_funcs *toptab = PerlIOBase(n)->tab;
2525 if (toptab == tab) {
2526 /* Top is already stdio - pop self (duplicate) and use original */
2527 PerlIO_pop(aTHX_ f);
2530 int fd = PerlIO_fileno(n);
2533 if (fd >= 0 && (stdio = PerlSIO_fdopen(fd,
2534 mode = PerlIOStdio_mode(mode, tmode)))) {
2535 PerlIOSelf(f, PerlIOStdio)->stdio = stdio;
2536 /* We never call down so do any pending stuff now */
2537 PerlIO_flush(PerlIONext(f));
2544 return PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
2549 PerlIO_importFILE(FILE *stdio, const char *mode)
2555 if (!mode || !*mode) {
2556 /* We need to probe to see how we can open the stream
2557 so start with read/write and then try write and read
2558 we dup() so that we can fclose without loosing the fd.
2560 Note that the errno value set by a failing fdopen
2561 varies between stdio implementations.
2563 int fd = PerlLIO_dup(fileno(stdio));
2564 FILE *f2 = PerlSIO_fdopen(fd, (mode = "r+"));
2566 f2 = PerlSIO_fdopen(fd, (mode = "w"));
2569 f2 = PerlSIO_fdopen(fd, (mode = "r"));
2572 /* Don't seem to be able to open */
2578 if ((f = PerlIO_push(aTHX_(f = PerlIO_allocate(aTHX)), &PerlIO_stdio, mode, Nullsv))) {
2579 s = PerlIOSelf(f, PerlIOStdio);
2587 PerlIOStdio_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
2588 IV n, const char *mode, int fd, int imode,
2589 int perm, PerlIO *f, int narg, SV **args)
2592 if (PerlIOValid(f)) {
2593 char *path = SvPV_nolen(*args);
2594 PerlIOStdio *s = PerlIOSelf(f, PerlIOStdio);
2596 PerlIOUnix_refcnt_dec(fileno(s->stdio));
2597 stdio = PerlSIO_freopen(path, (mode = PerlIOStdio_mode(mode, tmode)),
2602 PerlIOUnix_refcnt_inc(fileno(s->stdio));
2607 char *path = SvPV_nolen(*args);
2610 fd = PerlLIO_open3(path, imode, perm);
2613 FILE *stdio = PerlSIO_fopen(path, mode);
2617 f = PerlIO_allocate(aTHX);
2619 if ((f = PerlIO_push(aTHX_ f, self,
2620 (mode = PerlIOStdio_mode(mode, tmode)),
2622 s = PerlIOSelf(f, PerlIOStdio);
2624 PerlIOUnix_refcnt_inc(fileno(s->stdio));
2643 stdio = PerlSIO_stdin;
2646 stdio = PerlSIO_stdout;
2649 stdio = PerlSIO_stderr;
2654 stdio = PerlSIO_fdopen(fd, mode =
2655 PerlIOStdio_mode(mode, tmode));
2660 f = PerlIO_allocate(aTHX);
2662 if ((f = PerlIO_push(aTHX_ f, self, mode, PerlIOArg))) {
2663 s = PerlIOSelf(f, PerlIOStdio);
2665 PerlIOUnix_refcnt_inc(fileno(s->stdio));
2675 PerlIOStdio_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
2677 /* This assumes no layers underneath - which is what
2678 happens, but is not how I remember it. NI-S 2001/10/16
2680 if ((f = PerlIOBase_dup(aTHX_ f, o, param, flags))) {
2681 FILE *stdio = PerlIOSelf(o, PerlIOStdio)->stdio;
2682 int fd = fileno(stdio);
2684 if (flags & PERLIO_DUP_FD) {
2685 int dfd = PerlLIO_dup(fileno(stdio));
2687 stdio = PerlSIO_fdopen(dfd, PerlIO_modestr(o,mode));
2691 /* FIXME: To avoid messy error recovery if dup fails
2692 re-use the existing stdio as though flag was not set
2696 stdio = PerlSIO_fdopen(fd, PerlIO_modestr(o,mode));
2698 PerlIOSelf(f, PerlIOStdio)->stdio = stdio;
2699 PerlIOUnix_refcnt_inc(fileno(stdio));
2705 PerlIOStdio_invalidate_fileno(pTHX_ FILE *f)
2707 /* XXX this could use PerlIO_canset_fileno() and
2708 * PerlIO_set_fileno() support from Configure
2710 # if defined(__GLIBC__)
2711 /* There may be a better way for GLIBC:
2712 - libio.h defines a flag to not close() on cleanup
2716 # elif defined(__sun__)
2718 /* On solaris, if _LP64 is defined, the FILE structure is this:
2724 * It turns out that the fd is stored in the top 32 bits of
2725 * file->__pad[4]. The lower 32 bits contain flags. file->pad[5] appears
2726 * to contain a pointer or offset into another structure. All the
2727 * remaining fields are zero.
2729 * We set the top bits to -1 (0xFFFFFFFF).
2731 f->__pad[4] |= 0xffffffff00000000L;
2732 assert(fileno(f) == 0xffffffff);
2733 # else /* !defined(_LP64) */
2734 /* _file is just a unsigned char :-(
2735 Not clear why we dup() rather than using -1
2736 even if that would be treated as 0xFF - so will
2739 f->_file = PerlLIO_dup(fileno(f));
2740 # endif /* defined(_LP64) */
2742 # elif defined(__hpux)
2746 /* Next one ->_file seems to be a reasonable fallback, i.e. if
2747 your platform does not have special entry try this one.
2748 [For OSF only have confirmation for Tru64 (alpha)
2749 but assume other OSFs will be similar.]
2751 # elif defined(_AIX) || defined(__osf__) || defined(__irix__)
2754 # elif defined(__FreeBSD__)
2755 /* There may be a better way on FreeBSD:
2756 - we could insert a dummy func in the _close function entry
2757 f->_close = (int (*)(void *)) dummy_close;
2761 # elif defined(__CYGWIN__)
2762 /* There may be a better way on CYGWIN:
2763 - we could insert a dummy func in the _close function entry
2764 f->_close = (int (*)(void *)) dummy_close;
2768 # elif defined(WIN32)
2769 # if defined(__BORLANDC__)
2770 f->fd = PerlLIO_dup(fileno(f));
2771 # elif defined(UNDER_CE)
2772 /* WIN_CE does not have access to FILE internals, it hardly has FILE
2781 /* Sarathy's code did this - we fall back to a dup/dup2 hack
2782 (which isn't thread safe) instead
2784 # error "Don't know how to set FILE.fileno on your platform"
2791 PerlIOStdio_close(pTHX_ PerlIO *f)
2793 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
2799 int fd = fileno(stdio);
2805 #ifdef SOCKS5_VERSION_NAME
2806 /* Socks lib overrides close() but stdio isn't linked to
2807 that library (though we are) - so we must call close()
2808 on sockets on stdio's behalf.
2811 Sock_size_t optlen = sizeof(int);
2812 if (getsockopt(fd, SOL_SOCKET, SO_TYPE, (void *) &optval, &optlen) == 0) {
2817 if (PerlIOUnix_refcnt_dec(fd) > 0) {
2818 /* File descriptor still in use */
2823 /* For STD* handles don't close the stdio at all
2824 this is because we have shared the FILE * too
2826 if (stdio == stdin) {
2827 /* Some stdios are buggy fflush-ing inputs */
2830 else if (stdio == stdout || stdio == stderr) {
2831 return PerlIO_flush(f);
2833 /* Tricky - must fclose(stdio) to free memory but not close(fd)
2834 Use Sarathy's trick from maint-5.6 to invalidate the
2835 fileno slot of the FILE *
2837 result = PerlIO_flush(f);
2839 if (!(invalidate = PerlIOStdio_invalidate_fileno(aTHX_ stdio))) {
2840 dupfd = PerlLIO_dup(fd);
2843 result = PerlSIO_fclose(stdio);
2844 /* We treat error from stdio as success if we invalidated
2845 errno may NOT be expected EBADF
2847 if (invalidate && result != 0) {
2852 /* in SOCKS case let close() determine return value */
2856 PerlLIO_dup2(dupfd,fd);
2864 PerlIOStdio_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
2866 FILE *s = PerlIOSelf(f, PerlIOStdio)->stdio;
2870 STDCHAR *buf = (STDCHAR *) vbuf;
2872 * Perl is expecting PerlIO_getc() to fill the buffer Linux's
2873 * stdio does not do that for fread()
2875 int ch = PerlSIO_fgetc(s);
2882 got = PerlSIO_fread(vbuf, 1, count, s);
2883 if (got || errno != EINTR)
2886 errno = 0; /* just in case */
2892 PerlIOStdio_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
2895 FILE *s = PerlIOSelf(f, PerlIOStdio)->stdio;
2897 #ifdef STDIO_BUFFER_WRITABLE
2898 if (PerlIO_fast_gets(f) && PerlIO_has_base(f)) {
2899 STDCHAR *buf = ((STDCHAR *) vbuf) + count;
2900 STDCHAR *base = PerlIO_get_base(f);
2901 SSize_t cnt = PerlIO_get_cnt(f);
2902 STDCHAR *ptr = PerlIO_get_ptr(f);
2903 SSize_t avail = ptr - base;
2905 if (avail > count) {
2909 Move(buf-avail,ptr,avail,STDCHAR);
2912 PerlIO_set_ptrcnt(f,ptr,cnt+avail);
2913 if (PerlSIO_feof(s) && unread >= 0)
2914 PerlSIO_clearerr(s);
2919 if (PerlIO_has_cntptr(f)) {
2920 /* We can get pointer to buffer but not its base
2921 Do ungetc() but check chars are ending up in the
2924 STDCHAR *eptr = (STDCHAR*)PerlSIO_get_ptr(s);
2925 STDCHAR *buf = ((STDCHAR *) vbuf) + count;
2927 int ch = *--buf & 0xFF;
2928 if (ungetc(ch,s) != ch) {
2929 /* ungetc did not work */
2932 if ((STDCHAR*)PerlSIO_get_ptr(s) != --eptr || ((*eptr & 0xFF) != ch)) {
2933 /* Did not change pointer as expected */
2934 fgetc(s); /* get char back again */
2944 unread += PerlIOBase_unread(aTHX_ f, vbuf, count);
2950 PerlIOStdio_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
2954 got = PerlSIO_fwrite(vbuf, 1, count,
2955 PerlIOSelf(f, PerlIOStdio)->stdio);
2956 if (got || errno != EINTR)
2959 errno = 0; /* just in case */
2965 PerlIOStdio_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
2967 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
2968 return PerlSIO_fseek(stdio, offset, whence);
2972 PerlIOStdio_tell(pTHX_ PerlIO *f)
2974 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
2975 return PerlSIO_ftell(stdio);
2979 PerlIOStdio_flush(pTHX_ PerlIO *f)
2981 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
2982 if (PerlIOBase(f)->flags & PERLIO_F_CANWRITE) {
2983 return PerlSIO_fflush(stdio);
2988 * FIXME: This discards ungetc() and pre-read stuff which is not
2989 * right if this is just a "sync" from a layer above Suspect right
2990 * design is to do _this_ but not have layer above flush this
2991 * layer read-to-read
2994 * Not writeable - sync by attempting a seek
2997 if (PerlSIO_fseek(stdio, (Off_t) 0, SEEK_CUR) != 0)
3005 PerlIOStdio_eof(pTHX_ PerlIO *f)
3007 return PerlSIO_feof(PerlIOSelf(f, PerlIOStdio)->stdio);
3011 PerlIOStdio_error(pTHX_ PerlIO *f)
3013 return PerlSIO_ferror(PerlIOSelf(f, PerlIOStdio)->stdio);
3017 PerlIOStdio_clearerr(pTHX_ PerlIO *f)
3019 PerlSIO_clearerr(PerlIOSelf(f, PerlIOStdio)->stdio);
3023 PerlIOStdio_setlinebuf(pTHX_ PerlIO *f)
3025 #ifdef HAS_SETLINEBUF
3026 PerlSIO_setlinebuf(PerlIOSelf(f, PerlIOStdio)->stdio);
3028 PerlSIO_setvbuf(PerlIOSelf(f, PerlIOStdio)->stdio, Nullch, _IOLBF, 0);
3034 PerlIOStdio_get_base(pTHX_ PerlIO *f)
3036 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3037 return (STDCHAR*)PerlSIO_get_base(stdio);
3041 PerlIOStdio_get_bufsiz(pTHX_ PerlIO *f)
3043 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3044 return PerlSIO_get_bufsiz(stdio);
3048 #ifdef USE_STDIO_PTR
3050 PerlIOStdio_get_ptr(pTHX_ PerlIO *f)
3052 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3053 return (STDCHAR*)PerlSIO_get_ptr(stdio);
3057 PerlIOStdio_get_cnt(pTHX_ PerlIO *f)
3059 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3060 return PerlSIO_get_cnt(stdio);
3064 PerlIOStdio_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
3066 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3068 #ifdef STDIO_PTR_LVALUE
3069 PerlSIO_set_ptr(stdio, (void*)ptr); /* LHS STDCHAR* cast non-portable */
3070 #ifdef STDIO_PTR_LVAL_SETS_CNT
3071 if (PerlSIO_get_cnt(stdio) != (cnt)) {
3072 assert(PerlSIO_get_cnt(stdio) == (cnt));
3075 #if (!defined(STDIO_PTR_LVAL_NOCHANGE_CNT))
3077 * Setting ptr _does_ change cnt - we are done
3081 #else /* STDIO_PTR_LVALUE */
3083 #endif /* STDIO_PTR_LVALUE */
3086 * Now (or only) set cnt
3088 #ifdef STDIO_CNT_LVALUE
3089 PerlSIO_set_cnt(stdio, cnt);
3090 #else /* STDIO_CNT_LVALUE */
3091 #if (defined(STDIO_PTR_LVALUE) && defined(STDIO_PTR_LVAL_SETS_CNT))
3092 PerlSIO_set_ptr(stdio,
3093 PerlSIO_get_ptr(stdio) + (PerlSIO_get_cnt(stdio) -
3095 #else /* STDIO_PTR_LVAL_SETS_CNT */
3097 #endif /* STDIO_PTR_LVAL_SETS_CNT */
3098 #endif /* STDIO_CNT_LVALUE */
3105 PerlIOStdio_fill(pTHX_ PerlIO *f)
3107 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
3110 * fflush()ing read-only streams can cause trouble on some stdio-s
3112 if ((PerlIOBase(f)->flags & PERLIO_F_CANWRITE)) {
3113 if (PerlSIO_fflush(stdio) != 0)
3116 c = PerlSIO_fgetc(stdio);
3120 #if (defined(STDIO_PTR_LVALUE) && (defined(STDIO_CNT_LVALUE) || defined(STDIO_PTR_LVAL_SETS_CNT)))
3122 #ifdef STDIO_BUFFER_WRITABLE
3123 if (PerlIO_fast_gets(f) && PerlIO_has_base(f)) {
3124 /* Fake ungetc() to the real buffer in case system's ungetc
3127 STDCHAR *base = (STDCHAR*)PerlSIO_get_base(stdio);
3128 SSize_t cnt = PerlSIO_get_cnt(stdio);
3129 STDCHAR *ptr = (STDCHAR*)PerlSIO_get_ptr(stdio);
3130 if (ptr == base+1) {
3131 *--ptr = (STDCHAR) c;
3132 PerlIOStdio_set_ptrcnt(aTHX_ f,ptr,cnt+1);
3133 if (PerlSIO_feof(stdio))
3134 PerlSIO_clearerr(stdio);
3140 if (PerlIO_has_cntptr(f)) {
3142 if (PerlIOStdio_unread(aTHX_ f,&ch,1) == 1) {
3149 /* An ungetc()d char is handled separately from the regular
3150 * buffer, so we stuff it in the buffer ourselves.
3151 * Should never get called as should hit code above
3153 *(--((*stdio)->_ptr)) = (unsigned char) c;
3156 /* If buffer snoop scheme above fails fall back to
3159 if (PerlSIO_ungetc(c, stdio) != c)
3167 PerlIO_funcs PerlIO_stdio = {
3168 sizeof(PerlIO_funcs),
3170 sizeof(PerlIOStdio),
3171 PERLIO_K_BUFFERED|PERLIO_K_RAW,
3175 PerlIOBase_binmode, /* binmode */
3189 PerlIOStdio_clearerr,
3190 PerlIOStdio_setlinebuf,
3192 PerlIOStdio_get_base,
3193 PerlIOStdio_get_bufsiz,
3198 #ifdef USE_STDIO_PTR
3199 PerlIOStdio_get_ptr,
3200 PerlIOStdio_get_cnt,
3201 #if (defined(STDIO_PTR_LVALUE) && (defined(STDIO_CNT_LVALUE) || defined(STDIO_PTR_LVAL_SETS_CNT)))
3202 PerlIOStdio_set_ptrcnt
3203 #else /* STDIO_PTR_LVALUE */
3205 #endif /* STDIO_PTR_LVALUE */
3206 #else /* USE_STDIO_PTR */
3210 #endif /* USE_STDIO_PTR */
3213 /* Note that calls to PerlIO_exportFILE() are reversed using
3214 * PerlIO_releaseFILE(), not importFILE. */
3216 PerlIO_exportFILE(PerlIO * f, const char *mode)
3220 if (PerlIOValid(f)) {
3223 if (!mode || !*mode) {
3224 mode = PerlIO_modestr(f, buf);
3226 stdio = PerlSIO_fdopen(PerlIO_fileno(f), mode);
3229 /* De-link any lower layers so new :stdio sticks */
3231 if ((f = PerlIO_push(aTHX_ f, &PerlIO_stdio, buf, Nullsv))) {
3232 PerlIOStdio *s = PerlIOSelf(f, PerlIOStdio);
3234 /* Link previous lower layers under new one */
3238 /* restore layers list */
3248 PerlIO_findFILE(PerlIO *f)
3252 if (l->tab == &PerlIO_stdio) {
3253 PerlIOStdio *s = PerlIOSelf(&l, PerlIOStdio);
3256 l = *PerlIONext(&l);
3258 /* Uses fallback "mode" via PerlIO_modestr() in PerlIO_exportFILE */
3259 return PerlIO_exportFILE(f, Nullch);
3262 /* Use this to reverse PerlIO_exportFILE calls. */
3264 PerlIO_releaseFILE(PerlIO *p, FILE *f)
3268 if (l->tab == &PerlIO_stdio) {
3269 PerlIOStdio *s = PerlIOSelf(&l, PerlIOStdio);
3270 if (s->stdio == f) {
3272 PerlIO_pop(aTHX_ p);
3281 /*--------------------------------------------------------------------------------------*/
3283 * perlio buffer layer
3287 PerlIOBuf_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
3289 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3290 int fd = PerlIO_fileno(f);
3291 if (fd >= 0 && PerlLIO_isatty(fd)) {
3292 PerlIOBase(f)->flags |= PERLIO_F_LINEBUF | PERLIO_F_TTY;
3294 if (*PerlIONext(f)) {
3295 Off_t posn = PerlIO_tell(PerlIONext(f));
3296 if (posn != (Off_t) - 1) {
3300 return PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
3304 PerlIOBuf_open(pTHX_ PerlIO_funcs *self, PerlIO_list_t *layers,
3305 IV n, const char *mode, int fd, int imode, int perm,
3306 PerlIO *f, int narg, SV **args)
3308 if (PerlIOValid(f)) {
3309 PerlIO *next = PerlIONext(f);
3310 PerlIO_funcs *tab = PerlIO_layer_fetch(aTHX_ layers, n - 1, PerlIOBase(next)->tab);
3311 next = (*tab->Open) (aTHX_ tab, layers, n - 1, mode, fd, imode, perm,
3313 if (!next || (*PerlIOBase(f)->tab->Pushed) (aTHX_ f, mode, PerlIOArg, self) != 0) {
3318 PerlIO_funcs *tab = PerlIO_layer_fetch(aTHX_ layers, n - 1, PerlIO_default_btm());
3326 f = (*tab->Open) (aTHX_ tab, layers, n - 1, mode, fd, imode, perm,
3329 if (PerlIO_push(aTHX_ f, self, mode, PerlIOArg) == 0) {
3331 * if push fails during open, open fails. close will pop us.
3336 fd = PerlIO_fileno(f);
3337 if (init && fd == 2) {
3339 * Initial stderr is unbuffered
3341 PerlIOBase(f)->flags |= PERLIO_F_UNBUF;
3343 #ifdef PERLIO_USING_CRLF
3344 # ifdef PERLIO_IS_BINMODE_FD
3345 if (PERLIO_IS_BINMODE_FD(fd))
3346 PerlIO_binmode(f, '<'/*not used*/, O_BINARY, Nullch);
3350 * do something about failing setmode()? --jhi
3352 PerlLIO_setmode(fd, O_BINARY);
3361 * This "flush" is akin to sfio's sync in that it handles files in either
3362 * read or write state
3365 PerlIOBuf_flush(pTHX_ PerlIO *f)
3367 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3369 PerlIO *n = PerlIONext(f);
3370 if (PerlIOBase(f)->flags & PERLIO_F_WRBUF) {
3372 * write() the buffer
3374 STDCHAR *buf = b->buf;
3376 while (p < b->ptr) {
3377 SSize_t count = PerlIO_write(n, p, b->ptr - p);
3381 else if (count < 0 || PerlIO_error(n)) {
3382 PerlIOBase(f)->flags |= PERLIO_F_ERROR;
3387 b->posn += (p - buf);
3389 else if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
3390 STDCHAR *buf = PerlIO_get_base(f);
3392 * Note position change
3394 b->posn += (b->ptr - buf);
3395 if (b->ptr < b->end) {
3396 /* We did not consume all of it - try and seek downstream to
3397 our logical position
3399 if (PerlIOValid(n) && PerlIO_seek(n, b->posn, SEEK_SET) == 0) {
3400 /* Reload n as some layers may pop themselves on seek */
3401 b->posn = PerlIO_tell(n = PerlIONext(f));
3404 /* Seek failed (e.g. pipe or tty). Do NOT clear buffer or pre-read
3405 data is lost for good - so return saying "ok" having undone
3408 b->posn -= (b->ptr - buf);
3413 b->ptr = b->end = b->buf;
3414 PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
3415 /* We check for Valid because of dubious decision to make PerlIO_flush(NULL) flush all */
3416 if (PerlIOValid(n) && PerlIO_flush(n) != 0)
3422 PerlIOBuf_fill(pTHX_ PerlIO *f)
3424 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3425 PerlIO *n = PerlIONext(f);
3428 * Down-stream flush is defined not to loose read data so is harmless.
3429 * we would not normally be fill'ing if there was data left in anycase.
3431 if (PerlIO_flush(f) != 0)
3433 if (PerlIOBase(f)->flags & PERLIO_F_TTY)
3434 PerlIOBase_flush_linebuf(aTHX);
3437 PerlIO_get_base(f); /* allocate via vtable */
3439 b->ptr = b->end = b->buf;
3441 if (!PerlIOValid(n)) {
3442 PerlIOBase(f)->flags |= PERLIO_F_EOF;
3446 if (PerlIO_fast_gets(n)) {
3448 * Layer below is also buffered. We do _NOT_ want to call its
3449 * ->Read() because that will loop till it gets what we asked for
3450 * which may hang on a pipe etc. Instead take anything it has to
3451 * hand, or ask it to fill _once_.
3453 avail = PerlIO_get_cnt(n);
3455 avail = PerlIO_fill(n);
3457 avail = PerlIO_get_cnt(n);
3459 if (!PerlIO_error(n) && PerlIO_eof(n))
3464 STDCHAR *ptr = PerlIO_get_ptr(n);
3465 SSize_t cnt = avail;
3466 if (avail > (SSize_t)b->bufsiz)
3468 Copy(ptr, b->buf, avail, STDCHAR);
3469 PerlIO_set_ptrcnt(n, ptr + avail, cnt - avail);
3473 avail = PerlIO_read(n, b->ptr, b->bufsiz);
3477 PerlIOBase(f)->flags |= PERLIO_F_EOF;
3479 PerlIOBase(f)->flags |= PERLIO_F_ERROR;
3482 b->end = b->buf + avail;
3483 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
3488 PerlIOBuf_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
3490 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3491 if (PerlIOValid(f)) {
3494 return PerlIOBase_read(aTHX_ f, vbuf, count);
3500 PerlIOBuf_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3502 const STDCHAR *buf = (const STDCHAR *) vbuf + count;
3503 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3506 if (PerlIOBase(f)->flags & PERLIO_F_WRBUF)
3511 if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
3513 * Buffer is already a read buffer, we can overwrite any chars
3514 * which have been read back to buffer start
3516 avail = (b->ptr - b->buf);
3520 * Buffer is idle, set it up so whole buffer is available for
3524 b->end = b->buf + avail;
3526 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
3528 * Buffer extends _back_ from where we are now
3530 b->posn -= b->bufsiz;
3532 if (avail > (SSize_t) count) {
3534 * If we have space for more than count, just move count
3542 * In simple stdio-like ungetc() case chars will be already
3545 if (buf != b->ptr) {
3546 Copy(buf, b->ptr, avail, STDCHAR);
3550 PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
3554 unread += PerlIOBase_unread(aTHX_ f, vbuf, count);
3560 PerlIOBuf_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3562 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3563 const STDCHAR *buf = (const STDCHAR *) vbuf;
3567 if (!(PerlIOBase(f)->flags & PERLIO_F_CANWRITE))
3569 if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
3570 if (PerlIO_flush(f) != 0) {
3575 SSize_t avail = b->bufsiz - (b->ptr - b->buf);
3576 if ((SSize_t) count < avail)
3578 PerlIOBase(f)->flags |= PERLIO_F_WRBUF;
3579 if (PerlIOBase(f)->flags & PERLIO_F_LINEBUF) {
3594 Copy(buf, b->ptr, avail, STDCHAR);
3601 if (b->ptr >= (b->buf + b->bufsiz))
3604 if (PerlIOBase(f)->flags & PERLIO_F_UNBUF)
3610 PerlIOBuf_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
3613 if ((code = PerlIO_flush(f)) == 0) {
3614 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3615 PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
3616 code = PerlIO_seek(PerlIONext(f), offset, whence);
3618 b->posn = PerlIO_tell(PerlIONext(f));
3625 PerlIOBuf_tell(pTHX_ PerlIO *f)
3627 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3629 * b->posn is file position where b->buf was read, or will be written
3631 Off_t posn = b->posn;
3632 if ((PerlIOBase(f)->flags & PERLIO_F_APPEND) &&
3633 (PerlIOBase(f)->flags & PERLIO_F_WRBUF)) {
3635 /* As O_APPEND files are normally shared in some sense it is better
3640 /* when file is NOT shared then this is sufficient */
3641 PerlIO_seek(PerlIONext(f),0, SEEK_END);
3643 posn = b->posn = PerlIO_tell(PerlIONext(f));
3647 * If buffer is valid adjust position by amount in buffer
3649 posn += (b->ptr - b->buf);
3655 PerlIOBuf_popped(pTHX_ PerlIO *f)
3657 IV code = PerlIOBase_popped(aTHX_ f);
3658 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3659 if (b->buf && b->buf != (STDCHAR *) & b->oneword) {
3663 b->ptr = b->end = b->buf;
3664 PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
3669 PerlIOBuf_close(pTHX_ PerlIO *f)
3671 IV code = PerlIOBase_close(aTHX_ f);
3672 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3673 if (b->buf && b->buf != (STDCHAR *) & b->oneword) {
3677 b->ptr = b->end = b->buf;
3678 PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
3683 PerlIOBuf_get_ptr(pTHX_ PerlIO *f)
3685 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3692 PerlIOBuf_get_cnt(pTHX_ PerlIO *f)
3694 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3697 if (PerlIOBase(f)->flags & PERLIO_F_RDBUF)
3698 return (b->end - b->ptr);
3703 PerlIOBuf_get_base(pTHX_ PerlIO *f)
3705 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3710 Newz('B',b->buf,b->bufsiz, STDCHAR);
3712 b->buf = (STDCHAR *) & b->oneword;
3713 b->bufsiz = sizeof(b->oneword);
3722 PerlIOBuf_bufsiz(pTHX_ PerlIO *f)
3724 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3727 return (b->end - b->buf);
3731 PerlIOBuf_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
3733 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3737 if (PerlIO_get_cnt(f) != cnt || b->ptr < b->buf) {
3738 assert(PerlIO_get_cnt(f) == cnt);
3739 assert(b->ptr >= b->buf);
3741 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
3745 PerlIOBuf_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
3747 return PerlIOBase_dup(aTHX_ f, o, param, flags);
3752 PerlIO_funcs PerlIO_perlio = {
3753 sizeof(PerlIO_funcs),
3756 PERLIO_K_BUFFERED|PERLIO_K_RAW,
3760 PerlIOBase_binmode, /* binmode */
3774 PerlIOBase_clearerr,
3775 PerlIOBase_setlinebuf,
3780 PerlIOBuf_set_ptrcnt,
3783 /*--------------------------------------------------------------------------------------*/
3785 * Temp layer to hold unread chars when cannot do it any other way
3789 PerlIOPending_fill(pTHX_ PerlIO *f)
3792 * Should never happen
3799 PerlIOPending_close(pTHX_ PerlIO *f)
3802 * A tad tricky - flush pops us, then we close new top
3805 return PerlIO_close(f);
3809 PerlIOPending_seek(pTHX_ PerlIO *f, Off_t offset, int whence)
3812 * A tad tricky - flush pops us, then we seek new top
3815 return PerlIO_seek(f, offset, whence);
3820 PerlIOPending_flush(pTHX_ PerlIO *f)
3822 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3823 if (b->buf && b->buf != (STDCHAR *) & b->oneword) {
3827 PerlIO_pop(aTHX_ f);
3832 PerlIOPending_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
3838 PerlIOBuf_set_ptrcnt(aTHX_ f, ptr, cnt);
3843 PerlIOPending_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
3845 IV code = PerlIOBase_pushed(aTHX_ f, mode, arg, tab);
3846 PerlIOl *l = PerlIOBase(f);
3848 * Our PerlIO_fast_gets must match what we are pushed on, or sv_gets()
3849 * etc. get muddled when it changes mid-string when we auto-pop.
3851 l->flags = (l->flags & ~(PERLIO_F_FASTGETS | PERLIO_F_UTF8)) |
3852 (PerlIOBase(PerlIONext(f))->
3853 flags & (PERLIO_F_FASTGETS | PERLIO_F_UTF8));
3858 PerlIOPending_read(pTHX_ PerlIO *f, void *vbuf, Size_t count)
3860 SSize_t avail = PerlIO_get_cnt(f);
3862 if ((SSize_t)count < avail)
3865 got = PerlIOBuf_read(aTHX_ f, vbuf, avail);
3866 if (got >= 0 && got < (SSize_t)count) {
3868 PerlIO_read(f, ((STDCHAR *) vbuf) + got, count - got);
3869 if (more >= 0 || got == 0)
3875 PerlIO_funcs PerlIO_pending = {
3876 sizeof(PerlIO_funcs),
3879 PERLIO_K_BUFFERED|PERLIO_K_RAW, /* not sure about RAW here */
3880 PerlIOPending_pushed,
3883 PerlIOBase_binmode, /* binmode */
3892 PerlIOPending_close,
3893 PerlIOPending_flush,
3897 PerlIOBase_clearerr,
3898 PerlIOBase_setlinebuf,
3903 PerlIOPending_set_ptrcnt,
3908 /*--------------------------------------------------------------------------------------*/
3910 * crlf - translation On read translate CR,LF to "\n" we do this by
3911 * overriding ptr/cnt entries to hand back a line at a time and keeping a
3912 * record of which nl we "lied" about. On write translate "\n" to CR,LF
3916 PerlIOBuf base; /* PerlIOBuf stuff */
3917 STDCHAR *nl; /* Position of crlf we "lied" about in the
3922 PerlIOCrlf_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab)
3925 PerlIOBase(f)->flags |= PERLIO_F_CRLF;
3926 code = PerlIOBuf_pushed(aTHX_ f, mode, arg, tab);
3928 PerlIO_debug("PerlIOCrlf_pushed f=%p %s %s fl=%08" UVxf "\n",
3929 f, PerlIOBase(f)->tab->name, (mode) ? mode : "(Null)",
3930 PerlIOBase(f)->flags);
3937 PerlIOCrlf_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
3939 PerlIOCrlf *c = PerlIOSelf(f, PerlIOCrlf);
3944 if (!(PerlIOBase(f)->flags & PERLIO_F_CRLF))
3945 return PerlIOBuf_unread(aTHX_ f, vbuf, count);
3947 const STDCHAR *buf = (const STDCHAR *) vbuf + count;
3948 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3950 if (PerlIOBase(f)->flags & PERLIO_F_WRBUF)
3955 if (!(PerlIOBase(f)->flags & PERLIO_F_RDBUF)) {
3956 b->end = b->ptr = b->buf + b->bufsiz;
3957 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
3958 b->posn -= b->bufsiz;
3960 while (count > 0 && b->ptr > b->buf) {
3963 if (b->ptr - 2 >= b->buf) {
3986 PerlIOCrlf_get_cnt(pTHX_ PerlIO *f)
3988 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
3991 if (PerlIOBase(f)->flags & PERLIO_F_RDBUF) {
3992 PerlIOCrlf *c = PerlIOSelf(f, PerlIOCrlf);
3993 if ((PerlIOBase(f)->flags & PERLIO_F_CRLF) && (!c->nl || *c->nl == 0xd)) {
3994 STDCHAR *nl = (c->nl) ? c->nl : b->ptr;
3996 while (nl < b->end && *nl != 0xd)
3998 if (nl < b->end && *nl == 0xd) {
4000 if (nl + 1 < b->end) {
4007 * Not CR,LF but just CR
4015 * Blast - found CR as last char in buffer
4020 * They may not care, defer work as long as
4024 return (nl - b->ptr);
4028 b->ptr++; /* say we have read it as far as
4029 * flush() is concerned */
4030 b->buf++; /* Leave space in front of buffer */
4031 /* Note as we have moved buf up flush's
4033 will naturally make posn point at CR
4035 b->bufsiz--; /* Buffer is thus smaller */
4036 code = PerlIO_fill(f); /* Fetch some more */
4037 b->bufsiz++; /* Restore size for next time */
4038 b->buf--; /* Point at space */
4039 b->ptr = nl = b->buf; /* Which is what we hand
4041 *nl = 0xd; /* Fill in the CR */
4043 goto test; /* fill() call worked */
4045 * CR at EOF - just fall through
4047 /* Should we clear EOF though ??? */
4052 return (((c->nl) ? (c->nl + 1) : b->end) - b->ptr);
4058 PerlIOCrlf_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt)
4060 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
4061 PerlIOCrlf *c = PerlIOSelf(f, PerlIOCrlf);
4067 if (ptr == b->end && *c->nl == 0xd) {
4068 /* Defered CR at end of buffer case - we lied about count */
4080 * Test code - delete when it works ...
4082 IV flags = PerlIOBase(f)->flags;
4083 STDCHAR *chk = (c->nl) ? (c->nl+1) : b->end;
4084 if (ptr+cnt == c->nl && c->nl+1 == b->end && *c->nl == 0xd) {
4085 /* Defered CR at end of buffer case - we lied about count */
4091 Perl_croak(aTHX_ "ptr wrong %p != %p fl=%08" UVxf
4092 " nl=%p e=%p for %d", ptr, chk, flags, c->nl,
4100 * They have taken what we lied about
4108 PerlIOBase(f)->flags |= PERLIO_F_RDBUF;
4112 PerlIOCrlf_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4114 if (!(PerlIOBase(f)->flags & PERLIO_F_CRLF))
4115 return PerlIOBuf_write(aTHX_ f, vbuf, count);
4117 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
4118 const STDCHAR *buf = (const STDCHAR *) vbuf;
4119 const STDCHAR *ebuf = buf + count;
4122 if (!(PerlIOBase(f)->flags & PERLIO_F_CANWRITE))
4124 while (buf < ebuf) {
4125 STDCHAR *eptr = b->buf + b->bufsiz;
4126 PerlIOBase(f)->flags |= PERLIO_F_WRBUF;
4127 while (buf < ebuf && b->ptr < eptr) {
4129 if ((b->ptr + 2) > eptr) {
4137 *(b->ptr)++ = 0xd; /* CR */
4138 *(b->ptr)++ = 0xa; /* LF */
4140 if (PerlIOBase(f)->flags & PERLIO_F_LINEBUF) {
4150 if (b->ptr >= eptr) {
4156 if (PerlIOBase(f)->flags & PERLIO_F_UNBUF)
4158 return (buf - (STDCHAR *) vbuf);
4163 PerlIOCrlf_flush(pTHX_ PerlIO *f)
4165 PerlIOCrlf *c = PerlIOSelf(f, PerlIOCrlf);
4170 return PerlIOBuf_flush(aTHX_ f);
4174 PerlIOCrlf_binmode(pTHX_ PerlIO *f)
4176 if ((PerlIOBase(f)->flags & PERLIO_F_CRLF)) {
4177 /* In text mode - flush any pending stuff and flip it */
4178 PerlIOBase(f)->flags &= ~PERLIO_F_CRLF;
4179 #ifndef PERLIO_USING_CRLF
4180 /* CRLF is unusual case - if this is just the :crlf layer pop it */
4181 if (PerlIOBase(f)->tab == &PerlIO_crlf) {
4182 PerlIO_pop(aTHX_ f);
4189 PerlIO_funcs PerlIO_crlf = {
4190 sizeof(PerlIO_funcs),
4193 PERLIO_K_BUFFERED | PERLIO_K_CANCRLF | PERLIO_K_RAW,
4195 PerlIOBuf_popped, /* popped */
4197 PerlIOCrlf_binmode, /* binmode */
4201 PerlIOBuf_read, /* generic read works with ptr/cnt lies
4203 PerlIOCrlf_unread, /* Put CR,LF in buffer for each '\n' */
4204 PerlIOCrlf_write, /* Put CR,LF in buffer for each '\n' */
4212 PerlIOBase_clearerr,
4213 PerlIOBase_setlinebuf,
4218 PerlIOCrlf_set_ptrcnt,
4222 /*--------------------------------------------------------------------------------------*/
4224 * mmap as "buffer" layer
4228 PerlIOBuf base; /* PerlIOBuf stuff */
4229 Mmap_t mptr; /* Mapped address */
4230 Size_t len; /* mapped length */
4231 STDCHAR *bbuf; /* malloced buffer if map fails */
4234 static size_t page_size = 0;
4237 PerlIOMmap_map(pTHX_ PerlIO *f)
4239 PerlIOMmap *m = PerlIOSelf(f, PerlIOMmap);
4240 IV flags = PerlIOBase(f)->flags;
4244 if (flags & PERLIO_F_CANREAD) {
4245 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
4246 int fd = PerlIO_fileno(f);
4248 code = Fstat(fd, &st);
4249 if (code == 0 && S_ISREG(st.st_mode)) {
4250 SSize_t len = st.st_size - b->posn;
4254 #if defined(HAS_SYSCONF) && (defined(_SC_PAGESIZE) || defined(_SC_PAGE_SIZE))
4256 SETERRNO(0, SS_NORMAL);
4257 # ifdef _SC_PAGESIZE
4258 page_size = sysconf(_SC_PAGESIZE);
4260 page_size = sysconf(_SC_PAGE_SIZE);
4262 if ((long) page_size < 0) {
4267 (void) SvUPGRADE(error, SVt_PV);
4268 msg = SvPVx(error, n_a);
4269 Perl_croak(aTHX_ "panic: sysconf: %s",
4274 "panic: sysconf: pagesize unknown");
4278 # ifdef HAS_GETPAGESIZE
4279 page_size = getpagesize();
4281 # if defined(I_SYS_PARAM) && defined(PAGESIZE)
4282 page_size = PAGESIZE; /* compiletime, bad */
4286 if ((IV) page_size <= 0)
4287 Perl_croak(aTHX_ "panic: bad pagesize %" IVdf,
4292 * This is a hack - should never happen - open should
4295 b->posn = PerlIO_tell(PerlIONext(f));
4297 posn = (b->posn / page_size) * page_size;
4298 len = st.st_size - posn;
4299 m->mptr = mmap(NULL, len, PROT_READ, MAP_SHARED, fd, posn);
4300 if (m->mptr && m->mptr != (Mmap_t) - 1) {
4301 #if 0 && defined(HAS_MADVISE) && defined(MADV_SEQUENTIAL)
4302 madvise(m->mptr, len, MADV_SEQUENTIAL);
4304 #if 0 && defined(HAS_MADVISE) && defined(MADV_WILLNEED)
4305 madvise(m->mptr, len, MADV_WILLNEED);
4307 PerlIOBase(f)->flags =
4308 (flags & ~PERLIO_F_EOF) | PERLIO_F_RDBUF;
4309 b->end = ((STDCHAR *) m->mptr) + len;
4310 b->buf = ((STDCHAR *) m->mptr) + (b->posn - posn);
4319 PerlIOBase(f)->flags =
4320 flags | PERLIO_F_EOF | PERLIO_F_RDBUF;
4322 b->ptr = b->end = b->ptr;
4331 PerlIOMmap_unmap(pTHX_ PerlIO *f)
4333 PerlIOMmap *m = PerlIOSelf(f, PerlIOMmap);
4334 PerlIOBuf *b = &m->base;
4338 code = munmap(m->mptr, m->len);
4342 if (PerlIO_seek(PerlIONext(f), b->posn, SEEK_SET) != 0)
4345 b->ptr = b->end = b->buf;
4346 PerlIOBase(f)->flags &= ~(PERLIO_F_RDBUF | PERLIO_F_WRBUF);
4352 PerlIOMmap_get_base(pTHX_ PerlIO *f)
4354 PerlIOMmap *m = PerlIOSelf(f, PerlIOMmap);
4355 PerlIOBuf *b = &m->base;
4356 if (b->buf && (PerlIOBase(f)->flags & PERLIO_F_RDBUF)) {
4358 * Already have a readbuffer in progress
4364 * We have a write buffer or flushed PerlIOBuf read buffer
4366 m->bbuf = b->buf; /* save it in case we need it again */
4367 b->buf = NULL; /* Clear to trigger below */
4370 PerlIOMmap_map(aTHX_ f); /* Try and map it */
4373 * Map did not work - recover PerlIOBuf buffer if we have one
4378 b->ptr = b->end = b->buf;
4381 return PerlIOBuf_get_base(aTHX_ f);
4385 PerlIOMmap_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4387 PerlIOMmap *m = PerlIOSelf(f, PerlIOMmap);
4388 PerlIOBuf *b = &m->base;
4389 if (PerlIOBase(f)->flags & PERLIO_F_WRBUF)
4391 if (b->ptr && (b->ptr - count) >= b->buf
4392 && memEQ(b->ptr - count, vbuf, count)) {
4394 PerlIOBase(f)->flags &= ~PERLIO_F_EOF;
4399 * Loose the unwritable mapped buffer
4403 * If flush took the "buffer" see if we have one from before
4405 if (!b->buf && m->bbuf)
4408 PerlIOBuf_get_base(aTHX_ f);
4412 return PerlIOBuf_unread(aTHX_ f, vbuf, count);
4416 PerlIOMmap_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count)
4418 PerlIOMmap *m = PerlIOSelf(f, PerlIOMmap);
4419 PerlIOBuf *b = &m->base;
4420 if (!b->buf || !(PerlIOBase(f)->flags & PERLIO_F_WRBUF)) {
4422 * No, or wrong sort of, buffer
4425 if (PerlIOMmap_unmap(aTHX_ f) != 0)
4429 * If unmap took the "buffer" see if we have one from before
4431 if (!b->buf && m->bbuf)
4434 PerlIOBuf_get_base(aTHX_ f);
4438 return PerlIOBuf_write(aTHX_ f, vbuf, count);
4442 PerlIOMmap_flush(pTHX_ PerlIO *f)
4444 PerlIOMmap *m = PerlIOSelf(f, PerlIOMmap);
4445 PerlIOBuf *b = &m->base;
4446 IV code = PerlIOBuf_flush(aTHX_ f);
4448 * Now we are "synced" at PerlIOBuf level
4455 if (PerlIOMmap_unmap(aTHX_ f) != 0)
4460 * We seem to have a PerlIOBuf buffer which was not mapped
4461 * remember it in case we need one later
4470 PerlIOMmap_fill(pTHX_ PerlIO *f)
4472 PerlIOBuf *b = PerlIOSelf(f, PerlIOBuf);
4473 IV code = PerlIO_flush(f);
4474 if (code == 0 && !b->buf) {
4475 code = PerlIOMmap_map(aTHX_ f);
4477 if (code == 0 && !(PerlIOBase(f)->flags & PERLIO_F_RDBUF)) {
4478 code = PerlIOBuf_fill(aTHX_ f);
4484 PerlIOMmap_close(pTHX_ PerlIO *f)
4486 PerlIOMmap *m = PerlIOSelf(f, PerlIOMmap);
4487 PerlIOBuf *b = &m->base;
4488 IV code = PerlIO_flush(f);
4492 b->ptr = b->end = b->buf;
4494 if (PerlIOBuf_close(aTHX_ f) != 0)
4500 PerlIOMmap_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags)
4502 return PerlIOBase_dup(aTHX_ f, o, param, flags);
4506 PerlIO_funcs PerlIO_mmap = {
4507 sizeof(PerlIO_funcs),
4510 PERLIO_K_BUFFERED|PERLIO_K_RAW,
4514 PerlIOBase_binmode, /* binmode */
4528 PerlIOBase_clearerr,
4529 PerlIOBase_setlinebuf,
4530 PerlIOMmap_get_base,
4534 PerlIOBuf_set_ptrcnt,
4537 #endif /* HAS_MMAP */
4540 Perl_PerlIO_stdin(pTHX)
4543 PerlIO_stdstreams(aTHX);
4545 return &PL_perlio[1];
4549 Perl_PerlIO_stdout(pTHX)
4552 PerlIO_stdstreams(aTHX);
4554 return &PL_perlio[2];
4558 Perl_PerlIO_stderr(pTHX)
4561 PerlIO_stdstreams(aTHX);
4563 return &PL_perlio[3];
4566 /*--------------------------------------------------------------------------------------*/
4569 PerlIO_getname(PerlIO *f, char *buf)
4574 FILE *stdio = PerlIOSelf(f, PerlIOStdio)->stdio;
4576 name = fgetname(stdio, buf);
4578 Perl_croak(aTHX_ "Don't know how to get file name");
4584 /*--------------------------------------------------------------------------------------*/
4586 * Functions which can be called on any kind of PerlIO implemented in
4590 #undef PerlIO_fdopen
4592 PerlIO_fdopen(int fd, const char *mode)
4595 return PerlIO_openn(aTHX_ Nullch, mode, fd, 0, 0, NULL, 0, NULL);
4600 PerlIO_open(const char *path, const char *mode)
4603 SV *name = sv_2mortal(newSVpvn(path, strlen(path)));
4604 return PerlIO_openn(aTHX_ Nullch, mode, -1, 0, 0, NULL, 1, &name);
4607 #undef Perlio_reopen
4609 PerlIO_reopen(const char *path, const char *mode, PerlIO *f)
4612 SV *name = sv_2mortal(newSVpvn(path, strlen(path)));
4613 return PerlIO_openn(aTHX_ Nullch, mode, -1, 0, 0, f, 1, &name);
4618 PerlIO_getc(PerlIO *f)
4622 SSize_t count = PerlIO_read(f, buf, 1);
4624 return (unsigned char) buf[0];
4629 #undef PerlIO_ungetc
4631 PerlIO_ungetc(PerlIO *f, int ch)
4636 if (PerlIO_unread(f, &buf, 1) == 1)
4644 PerlIO_putc(PerlIO *f, int ch)
4648 return PerlIO_write(f, &buf, 1);
4653 PerlIO_puts(PerlIO *f, const char *s)
4656 STRLEN len = strlen(s);
4657 return PerlIO_write(f, s, len);
4660 #undef PerlIO_rewind
4662 PerlIO_rewind(PerlIO *f)
4665 PerlIO_seek(f, (Off_t) 0, SEEK_SET);
4669 #undef PerlIO_vprintf
4671 PerlIO_vprintf(PerlIO *f, const char *fmt, va_list ap)
4674 SV *sv = newSVpvn("", 0);
4680 Perl_va_copy(ap, apc);
4681 sv_vcatpvf(sv, fmt, &apc);
4683 sv_vcatpvf(sv, fmt, &ap);
4686 wrote = PerlIO_write(f, s, len);
4691 #undef PerlIO_printf
4693 PerlIO_printf(PerlIO *f, const char *fmt, ...)
4698 result = PerlIO_vprintf(f, fmt, ap);
4703 #undef PerlIO_stdoutf
4705 PerlIO_stdoutf(const char *fmt, ...)
4711 result = PerlIO_vprintf(PerlIO_stdout(), fmt, ap);
4716 #undef PerlIO_tmpfile
4718 PerlIO_tmpfile(void)
4721 * I have no idea how portable mkstemp() is ...
4723 #if defined(WIN32) || !defined(HAVE_MKSTEMP)
4726 FILE *stdio = PerlSIO_tmpfile();
4728 if ((f = PerlIO_push(aTHX_(PerlIO_allocate(aTHX)), &PerlIO_stdio, "w+", Nullsv))) {
4729 PerlIOStdio *s = PerlIOSelf(f, PerlIOStdio);
4736 SV *sv = newSVpv("/tmp/PerlIO_XXXXXX", 0);
4737 int fd = mkstemp(SvPVX(sv));
4740 f = PerlIO_fdopen(fd, "w+");
4742 PerlIOBase(f)->flags |= PERLIO_F_TEMP;
4744 PerlLIO_unlink(SvPVX(sv));
4754 #endif /* USE_SFIO */
4755 #endif /* PERLIO_IS_STDIO */
4757 /*======================================================================================*/
4759 * Now some functions in terms of above which may be needed even if we are
4760 * not in true PerlIO mode
4764 #undef PerlIO_setpos
4766 PerlIO_setpos(PerlIO *f, SV *pos)
4771 Off_t *posn = (Off_t *) SvPV(pos, len);
4772 if (f && len == sizeof(Off_t))
4773 return PerlIO_seek(f, *posn, SEEK_SET);
4775 SETERRNO(EINVAL, SS_IVCHAN);
4779 #undef PerlIO_setpos
4781 PerlIO_setpos(PerlIO *f, SV *pos)
4786 Fpos_t *fpos = (Fpos_t *) SvPV(pos, len);
4787 if (f && len == sizeof(Fpos_t)) {
4788 #if defined(USE_64_BIT_STDIO) && defined(USE_FSETPOS64)
4789 return fsetpos64(f, fpos);
4791 return fsetpos(f, fpos);
4795 SETERRNO(EINVAL, SS_IVCHAN);
4801 #undef PerlIO_getpos
4803 PerlIO_getpos(PerlIO *f, SV *pos)
4806 Off_t posn = PerlIO_tell(f);
4807 sv_setpvn(pos, (char *) &posn, sizeof(posn));
4808 return (posn == (Off_t) - 1) ? -1 : 0;
4811 #undef PerlIO_getpos
4813 PerlIO_getpos(PerlIO *f, SV *pos)
4818 #if defined(USE_64_BIT_STDIO) && defined(USE_FSETPOS64)
4819 code = fgetpos64(f, &fpos);
4821 code = fgetpos(f, &fpos);
4823 sv_setpvn(pos, (char *) &fpos, sizeof(fpos));
4828 #if (defined(PERLIO_IS_STDIO) || !defined(USE_SFIO)) && !defined(HAS_VPRINTF)
4831 vprintf(char *pat, char *args)
4833 _doprnt(pat, args, stdout);
4834 return 0; /* wrong, but perl doesn't use the return
4839 vfprintf(FILE *fd, char *pat, char *args)
4841 _doprnt(pat, args, fd);
4842 return 0; /* wrong, but perl doesn't use the return
4848 #ifndef PerlIO_vsprintf
4850 PerlIO_vsprintf(char *s, int n, const char *fmt, va_list ap)
4852 int val = vsprintf(s, fmt, ap);
4854 if (strlen(s) >= (STRLEN) n) {
4856 (void) PerlIO_puts(Perl_error_log,
4857 "panic: sprintf overflow - memory corrupted!\n");
4865 #ifndef PerlIO_sprintf
4867 PerlIO_sprintf(char *s, int n, const char *fmt, ...)
4872 result = PerlIO_vsprintf(s, n, fmt, ap);