Commit | Line | Data |
---|---|---|
76ced9ad NIS |
1 | #ifndef _PERLIOL_H |
2 | #define _PERLIOL_H | |
3 | ||
14a5cf38 JH |
4 | typedef struct { |
5 | PerlIO_funcs *funcs; | |
6 | SV *arg; | |
fcf2db38 NIS |
7 | } PerlIO_pair_t; |
8 | ||
3a1ee7e8 | 9 | struct PerlIO_list_s { |
14a5cf38 JH |
10 | IV refcnt; |
11 | IV cur; | |
12 | IV len; | |
13 | PerlIO_pair_t *array; | |
3a1ee7e8 | 14 | }; |
fcf2db38 | 15 | |
14a5cf38 | 16 | struct _PerlIO_funcs { |
2dc2558e | 17 | Size_t fsize; |
14a5cf38 JH |
18 | char *name; |
19 | Size_t size; | |
c9e984e3 | 20 | U32 kind; |
2dc2558e | 21 | IV (*Pushed) (pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab); |
f62ce20a | 22 | IV (*Popped) (pTHX_ PerlIO *f); |
14a5cf38 JH |
23 | PerlIO *(*Open) (pTHX_ PerlIO_funcs *tab, |
24 | PerlIO_list_t *layers, IV n, | |
25 | const char *mode, | |
26 | int fd, int imode, int perm, | |
27 | PerlIO *old, int narg, SV **args); | |
86e05cf2 | 28 | IV (*Binmode)(pTHX_ PerlIO *f); |
ecdeb87c | 29 | SV *(*Getarg) (pTHX_ PerlIO *f, CLONE_PARAMS *param, int flags); |
f62ce20a | 30 | IV (*Fileno) (pTHX_ PerlIO *f); |
ecdeb87c | 31 | PerlIO *(*Dup) (pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags); |
14a5cf38 | 32 | /* Unix-like functions - cf sfio line disciplines */ |
f62ce20a NIS |
33 | SSize_t(*Read) (pTHX_ PerlIO *f, void *vbuf, Size_t count); |
34 | SSize_t(*Unread) (pTHX_ PerlIO *f, const void *vbuf, Size_t count); | |
35 | SSize_t(*Write) (pTHX_ PerlIO *f, const void *vbuf, Size_t count); | |
36 | IV (*Seek) (pTHX_ PerlIO *f, Off_t offset, int whence); | |
37 | Off_t(*Tell) (pTHX_ PerlIO *f); | |
38 | IV (*Close) (pTHX_ PerlIO *f); | |
14a5cf38 | 39 | /* Stdio-like buffered IO functions */ |
f62ce20a NIS |
40 | IV (*Flush) (pTHX_ PerlIO *f); |
41 | IV (*Fill) (pTHX_ PerlIO *f); | |
42 | IV (*Eof) (pTHX_ PerlIO *f); | |
43 | IV (*Error) (pTHX_ PerlIO *f); | |
44 | void (*Clearerr) (pTHX_ PerlIO *f); | |
45 | void (*Setlinebuf) (pTHX_ PerlIO *f); | |
14a5cf38 | 46 | /* Perl's snooping functions */ |
f62ce20a NIS |
47 | STDCHAR *(*Get_base) (pTHX_ PerlIO *f); |
48 | Size_t(*Get_bufsiz) (pTHX_ PerlIO *f); | |
49 | STDCHAR *(*Get_ptr) (pTHX_ PerlIO *f); | |
50 | SSize_t(*Get_cnt) (pTHX_ PerlIO *f); | |
51 | void (*Set_ptrcnt) (pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt); | |
76ced9ad NIS |
52 | }; |
53 | ||
f5b9d040 NIS |
54 | /*--------------------------------------------------------------------------------------*/ |
55 | /* Kind values */ | |
5e2ab84b NIS |
56 | #define PERLIO_K_RAW 0x00000001 |
57 | #define PERLIO_K_BUFFERED 0x00000002 | |
f5b9d040 | 58 | #define PERLIO_K_CANCRLF 0x00000004 |
5e2ab84b | 59 | #define PERLIO_K_FASTGETS 0x00000008 |
dfebf958 | 60 | #define PERLIO_K_DUMMY 0x00000010 |
26fb694e | 61 | #define PERLIO_K_UTF8 0x00008000 |
13621cfb | 62 | #define PERLIO_K_DESTRUCT 0x00010000 |
7cf31beb | 63 | #define PERLIO_K_MULTIARG 0x00020000 |
f5b9d040 NIS |
64 | |
65 | /*--------------------------------------------------------------------------------------*/ | |
14a5cf38 JH |
66 | struct _PerlIO { |
67 | PerlIOl *next; /* Lower layer */ | |
68 | PerlIO_funcs *tab; /* Functions for this layer */ | |
4b069b44 | 69 | U32 flags; /* Various flags for state */ |
76ced9ad NIS |
70 | }; |
71 | ||
72 | /*--------------------------------------------------------------------------------------*/ | |
73 | ||
74 | /* Flag values */ | |
5e2ab84b NIS |
75 | #define PERLIO_F_EOF 0x00000100 |
76 | #define PERLIO_F_CANWRITE 0x00000200 | |
77 | #define PERLIO_F_CANREAD 0x00000400 | |
78 | #define PERLIO_F_ERROR 0x00000800 | |
79 | #define PERLIO_F_TRUNCATE 0x00001000 | |
80 | #define PERLIO_F_APPEND 0x00002000 | |
81 | #define PERLIO_F_CRLF 0x00004000 | |
82 | #define PERLIO_F_UTF8 0x00008000 | |
83 | #define PERLIO_F_UNBUF 0x00010000 | |
84 | #define PERLIO_F_WRBUF 0x00020000 | |
85 | #define PERLIO_F_RDBUF 0x00040000 | |
86 | #define PERLIO_F_LINEBUF 0x00080000 | |
87 | #define PERLIO_F_TEMP 0x00100000 | |
88 | #define PERLIO_F_OPEN 0x00200000 | |
89 | #define PERLIO_F_FASTGETS 0x00400000 | |
a9c883f6 | 90 | #define PERLIO_F_TTY 0x00800000 |
6caa5a9c | 91 | #define PERLIO_F_NOTREG 0x01000000 |
76ced9ad NIS |
92 | |
93 | #define PerlIOBase(f) (*(f)) | |
94 | #define PerlIOSelf(f,type) ((type *)PerlIOBase(f)) | |
95 | #define PerlIONext(f) (&(PerlIOBase(f)->next)) | |
04892f78 | 96 | #define PerlIOValid(f) ((f) && *(f)) |
76ced9ad NIS |
97 | |
98 | /*--------------------------------------------------------------------------------------*/ | |
26fb694e NIS |
99 | /* Data exports - EXT rather than extern is needed for Cygwin */ |
100 | EXT PerlIO_funcs PerlIO_unix; | |
101 | EXT PerlIO_funcs PerlIO_perlio; | |
102 | EXT PerlIO_funcs PerlIO_stdio; | |
103 | EXT PerlIO_funcs PerlIO_crlf; | |
104 | EXT PerlIO_funcs PerlIO_utf8; | |
105 | EXT PerlIO_funcs PerlIO_byte; | |
106 | EXT PerlIO_funcs PerlIO_raw; | |
7ea3cd40 | 107 | EXT PerlIO_funcs PerlIO_pending; |
76ced9ad | 108 | #ifdef HAS_MMAP |
26fb694e | 109 | EXT PerlIO_funcs PerlIO_mmap; |
76ced9ad | 110 | #endif |
0c4128ad NIS |
111 | #ifdef WIN32 |
112 | EXT PerlIO_funcs PerlIO_win32; | |
113 | #endif | |
5f1a76d0 | 114 | extern PerlIO *PerlIO_allocate(pTHX); |
14a5cf38 | 115 | extern SV *PerlIO_arg_fetch(PerlIO_list_t *av, IV n); |
fcf2db38 | 116 | #define PerlIOArg PerlIO_arg_fetch(layers,n) |
76ced9ad | 117 | |
35990314 | 118 | #ifdef PERLIO_USING_CRLF |
f5b9d040 NIS |
119 | #define PERLIO_STDTEXT "t" |
120 | #else | |
121 | #define PERLIO_STDTEXT "" | |
122 | #endif | |
123 | ||
76ced9ad NIS |
124 | /*--------------------------------------------------------------------------------------*/ |
125 | /* Generic, or stub layer functions */ | |
126 | ||
f62ce20a | 127 | extern IV PerlIOBase_fileno(pTHX_ PerlIO *f); |
ecdeb87c | 128 | extern PerlIO *PerlIOBase_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags); |
2dc2558e | 129 | extern IV PerlIOBase_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab); |
f62ce20a | 130 | extern IV PerlIOBase_popped(pTHX_ PerlIO *f); |
86e05cf2 | 131 | extern IV PerlIOBase_binmode(pTHX_ PerlIO *f); |
f62ce20a NIS |
132 | extern SSize_t PerlIOBase_read(pTHX_ PerlIO *f, void *vbuf, Size_t count); |
133 | extern SSize_t PerlIOBase_unread(pTHX_ PerlIO *f, const void *vbuf, | |
14a5cf38 | 134 | Size_t count); |
f62ce20a NIS |
135 | extern IV PerlIOBase_eof(pTHX_ PerlIO *f); |
136 | extern IV PerlIOBase_error(pTHX_ PerlIO *f); | |
137 | extern void PerlIOBase_clearerr(pTHX_ PerlIO *f); | |
138 | extern IV PerlIOBase_close(pTHX_ PerlIO *f); | |
139 | extern void PerlIOBase_setlinebuf(pTHX_ PerlIO *f); | |
140 | extern void PerlIOBase_flush_linebuf(pTHX); | |
14a5cf38 | 141 | |
f62ce20a NIS |
142 | extern IV PerlIOBase_noop_ok(pTHX_ PerlIO *f); |
143 | extern IV PerlIOBase_noop_fail(pTHX_ PerlIO *f); | |
76ced9ad NIS |
144 | |
145 | /*--------------------------------------------------------------------------------------*/ | |
146 | /* perlio buffer layer | |
147 | As this is reasonably generic its struct and "methods" are declared here | |
148 | so they can be used to "inherit" from it. | |
149 | */ | |
150 | ||
14a5cf38 JH |
151 | typedef struct { |
152 | struct _PerlIO base; /* Base "class" info */ | |
153 | STDCHAR *buf; /* Start of buffer */ | |
154 | STDCHAR *end; /* End of valid part of buffer */ | |
155 | STDCHAR *ptr; /* Current position in buffer */ | |
156 | Off_t posn; /* Offset of buf into the file */ | |
157 | Size_t bufsiz; /* Real size of buffer */ | |
158 | IV oneword; /* Emergency buffer */ | |
76ced9ad NIS |
159 | } PerlIOBuf; |
160 | ||
d9dac8cd NIS |
161 | extern int PerlIO_apply_layera(pTHX_ PerlIO *f, const char *mode, |
162 | PerlIO_list_t *layers, IV n, IV max); | |
163 | extern int PerlIO_parse_layers(pTHX_ PerlIO_list_t *av, const char *names); | |
164 | extern void PerlIO_list_free(pTHX_ PerlIO_list_t *list); | |
165 | extern PerlIO_funcs *PerlIO_layer_fetch(pTHX_ PerlIO_list_t *av, IV n, PerlIO_funcs *def); | |
166 | ||
167 | ||
8cf8f3d1 | 168 | extern SV *PerlIO_sv_dup(pTHX_ SV *arg, CLONE_PARAMS *param); |
14a5cf38 JH |
169 | extern PerlIO *PerlIOBuf_open(pTHX_ PerlIO_funcs *self, |
170 | PerlIO_list_t *layers, IV n, | |
171 | const char *mode, int fd, int imode, | |
172 | int perm, PerlIO *old, int narg, SV **args); | |
2dc2558e | 173 | extern IV PerlIOBuf_pushed(pTHX_ PerlIO *f, const char *mode, SV *arg, PerlIO_funcs *tab); |
44798d05 | 174 | extern IV PerlIOBuf_popped(pTHX_ PerlIO *f); |
ecdeb87c | 175 | extern PerlIO *PerlIOBuf_dup(pTHX_ PerlIO *f, PerlIO *o, CLONE_PARAMS *param, int flags); |
f62ce20a NIS |
176 | extern SSize_t PerlIOBuf_read(pTHX_ PerlIO *f, void *vbuf, Size_t count); |
177 | extern SSize_t PerlIOBuf_unread(pTHX_ PerlIO *f, const void *vbuf, Size_t count); | |
178 | extern SSize_t PerlIOBuf_write(pTHX_ PerlIO *f, const void *vbuf, Size_t count); | |
179 | extern IV PerlIOBuf_seek(pTHX_ PerlIO *f, Off_t offset, int whence); | |
180 | extern Off_t PerlIOBuf_tell(pTHX_ PerlIO *f); | |
181 | extern IV PerlIOBuf_close(pTHX_ PerlIO *f); | |
182 | extern IV PerlIOBuf_flush(pTHX_ PerlIO *f); | |
183 | extern IV PerlIOBuf_fill(pTHX_ PerlIO *f); | |
184 | extern STDCHAR *PerlIOBuf_get_base(pTHX_ PerlIO *f); | |
185 | extern Size_t PerlIOBuf_bufsiz(pTHX_ PerlIO *f); | |
186 | extern STDCHAR *PerlIOBuf_get_ptr(pTHX_ PerlIO *f); | |
187 | extern SSize_t PerlIOBuf_get_cnt(pTHX_ PerlIO *f); | |
188 | extern void PerlIOBuf_set_ptrcnt(pTHX_ PerlIO *f, STDCHAR * ptr, SSize_t cnt); | |
14a5cf38 JH |
189 | |
190 | extern int PerlIOUnix_oflags(const char *mode); | |
0c4128ad | 191 | |
76ced9ad NIS |
192 | /*--------------------------------------------------------------------------------------*/ |
193 | ||
14a5cf38 | 194 | #endif /* _PERLIOL_H */ |