ViewVC Help

View File | Revision Log | Show Annotations | Download File

/cvs/IO-AIO/AIO.xs

Comparing IO-AIO/AIO.xs (file contents):
Revision 1.52 by root, Sun Oct 22 22:14:54 2006 UTC vs.
Revision 1.143 by root, Sat Jun 6 19:44:17 2009 UTC

1	#define _REENTRANT 1	1	#include "libeio/xthread.h"
		2
2	#include <errno.h>	3	#include <errno.h>
3		4
4	#include "EXTERN.h"	5	#include "EXTERN.h"
5	#include "perl.h"	6	#include "perl.h"
6	#include "XSUB.h"	7	#include "XSUB.h"
7		8
8	#include "autoconf/config.h"
9
10	#include <pthread.h>
11
12	#include <stddef.h>	9	#include <stddef.h>
		10	#include <stdlib.h>
13	#include <errno.h>	11	#include <errno.h>
14	#include <sys/time.h>
15	#include <sys/select.h>
16	#include <sys/types.h>	12	#include <sys/types.h>
17	#include <sys/stat.h>	13	#include <sys/stat.h>
18	#include <limits.h>	14	#include <limits.h>
19	#include <unistd.h>
20	#include <fcntl.h>	15	#include <fcntl.h>
21	#include <signal.h>
22	#include <sched.h>	16	#include <sched.h>
23		17
24	#if HAVE_SENDFILE	18	/* perl namespace pollution */
25	# if __linux	19	#undef VERSION
26	# include <sys/sendfile.h>	20
27	# elif __freebsd	21	#ifdef _WIN32
28	# include <sys/socket.h>	22
29	# include <sys/uio.h>	23	# define EIO_STRUCT_DIRENT Direntry_t
30	# elif __hpux	24	# undef malloc
31	# include <sys/socket.h>	25	# undef free
32	# elif __solaris /* not yet */	26
33	# include <sys/sendfile.h>	27	// perl overrides all those nice win32 functions
		28	# undef open
		29	# undef read
		30	# undef write
		31	# undef send
		32	# undef recv
		33	# undef stat
		34	# undef fstat
		35	# define lstat stat
		36	# undef truncate
		37	# undef ftruncate
		38	# undef open
		39	# undef close
		40	# undef unlink
		41	# undef rmdir
		42	# undef rename
		43	# undef lseek
		44
		45	# define chown(a,b,c) (errno = ENOSYS, -1)
		46	# define fchown(a,b,c) (errno = ENOSYS, -1)
		47	# define fchmod(a,b) (errno = ENOSYS, -1)
		48	# define symlink(a,b) (errno = ENOSYS, -1)
		49	# define readlink(a,b,c) (errno = ENOSYS, -1)
		50	# define mknod(a,b,c) (errno = ENOSYS, -1)
		51	# define truncate(a,b) (errno = ENOSYS, -1)
		52	# define ftruncate(fd,o) chsize ((fd), (o))
		53	# define fsync(fd) _commit (fd)
		54	# define opendir(fd) (errno = ENOSYS, 0)
		55	# define readdir(fd) (errno = ENOSYS, -1)
		56	# define closedir(fd) (errno = ENOSYS, -1)
		57	# define mkdir(a,b) mkdir (a)
		58
34	# else	59	#else
35	# error sendfile support requested but not available	60
36	# endif	61	# include <sys/time.h>
		62	# include <sys/select.h>
		63	# include <unistd.h>
		64	# include <utime.h>
		65	# include <signal.h>
		66	# define EIO_STRUCT_DIRENT struct dirent
		67
37	#endif	68	#endif
38		69
39	/* used for struct dirent, AIX doesn't provide it */	70	/* perl stupidly overrides readdir and maybe others */
40	#ifndef NAME_MAX	71	/* with thread-unsafe versions, imagine that :( */
41	# define NAME_MAX 4096	72	#undef readdir
		73	#undef opendir
		74	#undef closedir
		75
		76	#define EIO_STRUCT_STAT Stat_t
		77
		78	/* use NV for 32 bit perls as it allows larger offsets */
		79	#if IVSIZE >= 8
		80	# define SvVAL64 SvIV
		81	#else
		82	# define SvVAL64 SvNV
42	#endif	83	#endif
43		84
44	#if __ia64	85	/*****************************************************************************/
45	# define STACKSIZE 65536	86
		87	#if __GNUC__ >= 3
		88	# define expect(expr,value) __builtin_expect ((expr),(value))
46	#else	89	#else
47	# define STACKSIZE 8192	90	# define expect(expr,value) (expr)
48	#endif	91	#endif
49		92
50	enum {	93	#define expect_false(expr) expect ((expr) != 0, 0)
51	REQ_QUIT,	94	#define expect_true(expr) expect ((expr) != 0, 1)
52	REQ_OPEN, REQ_CLOSE,	95
53	REQ_READ, REQ_WRITE, REQ_READAHEAD,	96	/*****************************************************************************/
54	REQ_SENDFILE,	97
55	REQ_STAT, REQ_LSTAT, REQ_FSTAT,	98	static HV *stash;
56	REQ_FSYNC, REQ_FDATASYNC,	99	typedef SV SV8; /* byte-sv, used for argument-checking */
57	REQ_UNLINK, REQ_RMDIR, REQ_RENAME,
58	REQ_READDIR,
59	REQ_LINK, REQ_SYMLINK,
60	REQ_SLEEP,
61	REQ_GROUP,
62	};
63		100
64	#define AIO_REQ_KLASS "IO::AIO::REQ"	101	#define AIO_REQ_KLASS "IO::AIO::REQ"
65	#define AIO_GRP_KLASS "IO::AIO::GRP"	102	#define AIO_GRP_KLASS "IO::AIO::GRP"
66		103
67	typedef struct aio_cb	104	#define EIO_REQ_MEMBERS \
68	{
69	struct aio_cb *volatile next;
70
71	struct aio_cb *grp, *grp_prev, *grp_next, *grp_first;
72
73	SV *self; /* the perl counterpart of this request, if any */
74
75	SV *data, *callback;	105	SV *callback; \
76	SV *fh, *fh2;	106	SV *sv1, *sv2; \
77	void *dataptr, *data2ptr;
78	Stat_t *statdata;
79	off_t offset;
80	size_t length;
81	ssize_t result;
82
83	int type;
84	int fd, fd2;
85	int errorno;
86	STRLEN dataoffset;	107	STRLEN stroffset; \
87	mode_t mode; /* open */	108	SV *self;
88	unsigned char cancelled;
89	} aio_cb;
90		109
		110	#define EIO_NO_WRAPPERS 1
		111
		112	#include "libeio/eio.h"
		113
		114	static int req_invoke (eio_req *req);
		115	#define EIO_FINISH(req) req_invoke (req)
		116	static void req_destroy (eio_req *grp);
		117	#define EIO_DESTROY(req) req_destroy (req)
		118
		119	enum {
		120	FLAG_SV2_RO_OFF = 0x40, /* data was set readonly */
		121	};
		122
		123	#include "libeio/eio.c"
		124
91	typedef aio_cb *aio_req;	125	typedef eio_req *aio_req;
92	typedef aio_cb *aio_req_ornot;	126	typedef eio_req *aio_req_ornot;
93		127
94	static int started, wanted;	128	static SV *on_next_submit;
95	static volatile int nreqs;	129	static int next_pri = EIO_PRI_DEFAULT;
96	static int max_outstanding = 1<<30;	130	static int max_outstanding;
97	static int respipe [2];
98		131
99	static pthread_mutex_t reslock = PTHREAD_MUTEX_INITIALIZER;	132	static int respipe_osf [2], respipe [2] = { -1, -1 };
100	static pthread_mutex_t reqlock = PTHREAD_MUTEX_INITIALIZER;
101	static pthread_cond_t reqwait = PTHREAD_COND_INITIALIZER;
102		133
103	static volatile aio_req reqs, reqe; /* queue start, queue end */	134	static void req_destroy (aio_req req);
104	static volatile aio_req ress, rese; /* queue start, queue end */
105
106	static void req_invoke (aio_req req);	135	static void req_cancel (aio_req req);
107	static void req_free (aio_req req);	136
		137	static void want_poll (void)
		138	{
		139	/* write a dummy byte to the pipe so fh becomes ready */
		140	respipe_write (respipe_osf [1], (const void *)&respipe_osf, 1);
		141	}
		142
		143	static void done_poll (void)
		144	{
		145	/* read any signals sent by the worker threads */
		146	char buf [4];
		147	while (respipe_read (respipe [0], buf, 4) == 4)
		148	;
		149	}
108		150
109	/* must be called at most once */	151	/* must be called at most once */
110	static SV *req_sv (aio_req req, const char *klass)	152	static SV *req_sv (aio_req req, const char *klass)
111	{	153	{
112	if (!req->self)	154	if (!req->self)
…		…
118	return sv_2mortal (sv_bless (newRV_inc (req->self), gv_stashpv (klass, 1)));	160	return sv_2mortal (sv_bless (newRV_inc (req->self), gv_stashpv (klass, 1)));
119	}	161	}
120		162
121	static aio_req SvAIO_REQ (SV *sv)	163	static aio_req SvAIO_REQ (SV *sv)
122	{	164	{
		165	MAGIC *mg;
		166
123	if (!sv_derived_from (sv, AIO_REQ_KLASS) || !SvROK (sv))	167	if (!sv_derived_from (sv, AIO_REQ_KLASS) || !SvROK (sv))
124	croak ("object of class " AIO_REQ_KLASS " expected");	168	croak ("object of class " AIO_REQ_KLASS " expected");
125		169
126	MAGIC *mg = mg_find (SvRV (sv), PERL_MAGIC_ext);	170	mg = mg_find (SvRV (sv), PERL_MAGIC_ext);
127		171
128	return mg ? (aio_req)mg->mg_ptr : 0;	172	return mg ? (aio_req)mg->mg_ptr : 0;
129	}	173	}
130		174
131	static void aio_grp_feed (aio_req grp)	175	static void aio_grp_feed (aio_req grp)
132	{	176	{
133	while (grp->length < grp->fd2)	177	if (grp->sv2 && SvOK (grp->sv2))
134	{	178	{
135	int old_len = grp->length;	179	dSP;
136		180
137	if (grp->fh2 && SvOK (grp->fh2))	181	ENTER;
		182	SAVETMPS;
		183	PUSHMARK (SP);
		184	XPUSHs (req_sv (grp, AIO_GRP_KLASS));
		185	PUTBACK;
		186	call_sv (grp->sv2, G_VOID | G_EVAL | G_KEEPERR);
		187	SPAGAIN;
		188	FREETMPS;
		189	LEAVE;
		190	}
		191	}
		192
		193	static void req_submit (eio_req *req)
		194	{
		195	eio_submit (req);
		196
		197	if (expect_false (on_next_submit))
		198	{
		199	dSP;
		200	SV *cb = sv_2mortal (on_next_submit);
		201
		202	on_next_submit = 0;
		203
		204	PUSHMARK (SP);
		205	PUTBACK;
		206	call_sv (cb, G_DISCARD | G_EVAL);
		207	}
		208	}
		209
		210	static int req_invoke (eio_req *req)
		211	{
		212	dSP;
		213
		214	if (req->flags & FLAG_SV2_RO_OFF)
		215	SvREADONLY_off (req->sv2);
		216
		217	if (!EIO_CANCELLED (req) && req->callback)
		218	{
		219	ENTER;
		220	SAVETMPS;
		221	PUSHMARK (SP);
		222	EXTEND (SP, 1);
		223
		224	switch (req->type)
138	{	225	{
139	dSP;	226	case EIO_READDIR:
		227	{
		228	SV *rv = &PL_sv_undef;
140		229
141	ENTER;	230	if (req->result >= 0)
142	SAVETMPS;	231	{
143	PUSHMARK (SP);	232	int i;
144	XPUSHs (req_sv (grp, AIO_GRP_KLASS));	233	char *buf = req->ptr2;
145	PUTBACK;	234	AV *av = newAV ();
146	call_sv (grp->fh2, G_VOID | G_EVAL);	235
147	SPAGAIN;	236	av_extend (av, req->result - 1);
148	FREETMPS;	237
149	LEAVE;	238	for (i = 0; i < req->result; ++i)
		239	{
		240	if (req->int1 & EIO_READDIR_DENTS)
		241	{
		242	eio_dirent *ent = (eio_dirent *)buf;
		243	SV *namesv = newSVpvn (ent->name, ent->namelen);
		244
		245	if (req->int1 & EIO_READDIR_CUSTOM2)
		246	{
		247	static SV *sv_type [EIO_DT_MAX + 1]; /* type sv cache */
		248	AV *avent = newAV ();
		249
		250	av_extend (avent, 2);
		251
		252	if (!sv_type [ent->type])
		253	{
		254	sv_type [ent->type] = newSViv (ent->type);
		255	SvREADONLY_on (sv_type [ent->type]);
		256	}
		257
		258	av_store (avent, 0, namesv);
		259	av_store (avent, 1, SvREFCNT_inc (sv_type [ent->type]));
		260	av_store (avent, 2, IVSIZE >= 8 ? newSVuv (ent->inode) : newSVnv (ent->inode));
		261
		262	av_store (av, i, newRV_noinc ((SV *)avent));
		263	}
		264	else
		265	av_store (av, i, namesv);
		266
		267	buf += sizeof (eio_dirent);
		268	}
		269	else
		270	{
		271	SV *name = newSVpv (buf, 0);
		272	av_store (av, i, name);
		273	buf += SvCUR (name) + 1;
		274	}
		275	}
		276
		277	rv = sv_2mortal (newRV_noinc ((SV *)av));
		278	}
		279
		280	PUSHs (rv);
		281
		282	if (req->int1 & EIO_READDIR_CUSTOM1)
		283	XPUSHs (sv_2mortal (newSViv (req->int1 & ~(EIO_READDIR_CUSTOM1 | EIO_READDIR_CUSTOM2))));
		284	}
		285	break;
		286
		287	case EIO_OPEN:
		288	{
		289	/* convert fd to fh */
		290	SV *fh = &PL_sv_undef;
		291
		292	if (req->result >= 0)
		293	{
		294	GV *gv = (GV *)sv_newmortal ();
		295	int flags = req->int1 & (O_RDONLY | O_WRONLY | O_RDWR);
		296	char sym [64];
		297	int symlen;
		298
		299	symlen = snprintf (sym, sizeof (sym), "fd#%d", req->result);
		300	gv_init (gv, stash, sym, symlen, 0);
		301
		302	symlen = snprintf (
		303	sym,
		304	sizeof (sym),
		305	"%s&=%d",
		306	flags == O_RDONLY ? "<" : flags == O_WRONLY ? ">" : "+<",
		307	req->result
		308	);
		309
		310	if (do_open (gv, sym, symlen, 0, 0, 0, 0))
		311	fh = (SV *)gv;
		312	}
		313
		314	PUSHs (fh);
		315	}
		316	break;
		317
		318	case EIO_GROUP:
		319	req->int1 = 2; /* mark group as finished */
		320
		321	if (req->sv1)
		322	{
		323	int i;
		324	AV *av = (AV *)req->sv1;
		325
		326	EXTEND (SP, AvFILL (av) + 1);
		327	for (i = 0; i <= AvFILL (av); ++i)
		328	PUSHs (*av_fetch (av, i, 0));
		329	}
		330	break;
		331
		332	case EIO_NOP:
		333	case EIO_BUSY:
		334	break;
		335
		336	case EIO_READLINK:
		337	if (req->result > 0)
		338	PUSHs (sv_2mortal (newSVpvn (req->ptr2, req->result)));
		339	break;
		340
		341	case EIO_STAT:
		342	case EIO_LSTAT:
		343	case EIO_FSTAT:
		344	PL_laststype = req->type == EIO_LSTAT ? OP_LSTAT : OP_STAT;
		345	PL_laststatval = req->result;
		346	PL_statcache = *(EIO_STRUCT_STAT *)(req->ptr2);
		347	PUSHs (sv_2mortal (newSViv (req->result)));
		348	break;
		349
		350	case EIO_READ:
		351	{
		352	SvCUR_set (req->sv2, req->stroffset + (req->result > 0 ? req->result : 0));
		353	*SvEND (req->sv2) = 0;
		354	SvPOK_only (req->sv2);
		355	SvSETMAGIC (req->sv2);
		356	PUSHs (sv_2mortal (newSViv (req->result)));
		357	}
		358	break;
		359
		360	case EIO_DUP2:
		361	if (req->result > 0)
		362	req->result = 0;
		363	/* FALLTHROUGH */
		364
		365	default:
		366	PUSHs (sv_2mortal (newSViv (req->result)));
		367	break;
150	}	368	}
151		369
152	/* stop if no progress has been made */	370	errno = req->errorno;
153	if (old_len == grp->length)	371
154	{	372	PUTBACK;
155	SvREFCNT_dec (grp->fh2);	373	call_sv (req->callback, G_VOID | G_EVAL | G_DISCARD);
156	grp->fh2 = 0;	374	SPAGAIN;
157	break;	375
158	}	376	FREETMPS;
		377	LEAVE;
		378
		379	PUTBACK;
159	}	380	}
160	}
161		381
162	static void aio_grp_dec (aio_req grp)	382	return !!SvTRUE (ERRSV);
163	{
164	--grp->length;
165
166	/* call feeder, if applicable */
167	aio_grp_feed (grp);
168
169	/* finish, if done */
170	if (!grp->length && grp->fd)
171	{
172	req_invoke (grp);
173	req_free (grp);
174	}
175	}	383	}
176		384
177	static void poll_wait ()
178	{
179	if (nreqs && !ress)
180	{
181	fd_set rfd;
182	FD_ZERO(&rfd);
183	FD_SET(respipe [0], &rfd);
184
185	select (respipe [0] + 1, &rfd, 0, 0, 0);
186	}
187	}
188
189	static void req_invoke (aio_req req)
190	{
191	dSP;
192	int errorno = errno;
193
194	if (req->cancelled || !SvOK (req->callback))
195	return;
196
197	errno = req->errorno;
198
199	ENTER;
200	SAVETMPS;
201	PUSHMARK (SP);
202	EXTEND (SP, 1);
203
204	switch (req->type)
205	{
206	case REQ_READDIR:
207	{
208	SV *rv = &PL_sv_undef;
209
210	if (req->result >= 0)
211	{
212	char *buf = req->data2ptr;
213	AV *av = newAV ();
214
215	while (req->result)
216	{
217	SV *sv = newSVpv (buf, 0);
218
219	av_push (av, sv);
220	buf += SvCUR (sv) + 1;
221	req->result--;
222	}
223
224	rv = sv_2mortal (newRV_noinc ((SV *)av));
225	}
226
227	PUSHs (rv);
228	}
229	break;
230
231	case REQ_OPEN:
232	{
233	/* convert fd to fh */
234	SV *fh;
235
236	PUSHs (sv_2mortal (newSViv (req->result)));
237	PUTBACK;
238	call_pv ("IO::AIO::_fd2fh", G_SCALAR | G_EVAL);
239	SPAGAIN;
240
241	fh = SvREFCNT_inc (POPs);
242
243	PUSHMARK (SP);
244	XPUSHs (sv_2mortal (fh));
245	}
246	break;
247
248	case REQ_GROUP:
249	req->fd = 2; /* mark group as finished */
250
251	if (req->data)
252	{
253	int i;
254	AV *av = (AV *)req->data;
255
256	EXTEND (SP, AvFILL (av) + 1);
257	for (i = 0; i <= AvFILL (av); ++i)
258	PUSHs (*av_fetch (av, i, 0));
259	}
260	break;
261
262	case REQ_SLEEP:
263	break;
264
265	default:
266	PUSHs (sv_2mortal (newSViv (req->result)));
267	break;
268	}
269
270
271	PUTBACK;
272	call_sv (req->callback, G_VOID | G_EVAL);
273	SPAGAIN;
274
275	FREETMPS;
276	LEAVE;
277
278	errno = errorno;
279
280	if (SvTRUE (ERRSV))
281	{
282	req_free (req);
283	croak (0);
284	}
285	}
286
287	static void req_free (aio_req req)	385	static void req_destroy (aio_req req)
288	{	386	{
289	if (req->grp)
290	{
291	aio_req grp = req->grp;
292
293	/* unlink request */
294	if (req->grp_next) req->grp_next->grp_prev = req->grp_prev;
295	if (req->grp_prev) req->grp_prev->grp_next = req->grp_next;
296
297	if (grp->grp_first == req)
298	grp->grp_first = req->grp_next;
299
300	aio_grp_dec (grp);
301	}
302
303	if (req->self)	387	if (req->self)
304	{	388	{
305	sv_unmagic (req->self, PERL_MAGIC_ext);	389	sv_unmagic (req->self, PERL_MAGIC_ext);
306	SvREFCNT_dec (req->self);	390	SvREFCNT_dec (req->self);
307	}	391	}
308		392
309	SvREFCNT_dec (req->data);
310	SvREFCNT_dec (req->fh);	393	SvREFCNT_dec (req->sv1);
311	SvREFCNT_dec (req->fh2);	394	SvREFCNT_dec (req->sv2);
312	SvREFCNT_dec (req->callback);	395	SvREFCNT_dec (req->callback);
313	Safefree (req->statdata);
314
315	if (req->type == REQ_READDIR && req->result >= 0)
316	free (req->data2ptr);
317		396
318	Safefree (req);	397	Safefree (req);
319	}	398	}
320		399
321	static void req_cancel (aio_req req)	400	static void req_cancel_subs (aio_req grp)
322	{	401	{
323	req->cancelled = 1;	402	aio_req sub;
324		403
325	if (req->type == REQ_GROUP)	404	if (grp->type != EIO_GROUP)
		405	return;
		406
		407	SvREFCNT_dec (grp->sv2);
		408	grp->sv2 = 0;
		409
		410	eio_grp_cancel (grp);
		411	}
		412
		413	#ifdef USE_SOCKETS_AS_HANDLES
		414	# define TO_SOCKET(x) (win32_get_osfhandle (x))
		415	#else
		416	# define TO_SOCKET(x) (x)
		417	#endif
		418
		419	static void
		420	create_respipe (void)
		421	{
		422	int old_readfd = respipe [0];
		423
		424	if (respipe [1] >= 0)
		425	respipe_close (TO_SOCKET (respipe [1]));
		426
		427	#ifdef _WIN32
		428	if (PerlSock_socketpair (AF_UNIX, SOCK_STREAM, 0, respipe))
		429	#else
		430	if (pipe (respipe))
		431	#endif
		432	croak ("unable to initialize result pipe");
		433
		434	if (old_readfd >= 0)
326	{	435	{
327	aio_req sub;	436	if (dup2 (TO_SOCKET (respipe [0]), TO_SOCKET (old_readfd)) < 0)
		437	croak ("unable to initialize result pipe(2)");
328		438
329	for (sub = req->grp_first; sub; sub = sub->grp_next)	439	respipe_close (respipe [0]);
330	req_cancel (sub);	440	respipe [0] = old_readfd;
331	}	441	}
332	}
333		442
		443	#ifdef _WIN32
		444	int arg = 1;
		445	if (ioctlsocket (TO_SOCKET (respipe [0]), FIONBIO, &arg)
		446	|| ioctlsocket (TO_SOCKET (respipe [1]), FIONBIO, &arg))
		447	#else
		448	if (fcntl (respipe [0], F_SETFL, O_NONBLOCK)
		449	|| fcntl (respipe [1], F_SETFL, O_NONBLOCK))
		450	#endif
		451	croak ("unable to initialize result pipe(3)");
		452
		453	respipe_osf [0] = TO_SOCKET (respipe [0]);
		454	respipe_osf [1] = TO_SOCKET (respipe [1]);
		455	}
		456
		457	static void poll_wait (void)
		458	{
		459	fd_set rfd;
		460
		461	while (eio_nreqs ())
		462	{
		463	int size;
		464
		465	X_LOCK (reslock);
		466	size = res_queue.size;
		467	X_UNLOCK (reslock);
		468
		469	if (size)
		470	return;
		471
		472	etp_maybe_start_thread ();
		473
		474	FD_ZERO (&rfd);
		475	FD_SET (respipe [0], &rfd);
		476
		477	PerlSock_select (respipe [0] + 1, &rfd, 0, 0, 0);
		478	}
		479	}
		480
334	static int poll_cb ()	481	static int poll_cb (void)
335	{	482	{
336	dSP;
337	int count = 0;
338	int do_croak = 0;
339	aio_req req;
340
341	for (;;)	483	for (;;)
342	{	484	{
343	pthread_mutex_lock (&reslock);	485	int res = eio_poll ();
344	req = ress;
345		486
346	if (req)	487	if (res > 0)
347	{
348	ress = req->next;
349
350	if (!ress)
351	{
352	/* read any signals sent by the worker threads */
353	char buf [32];
354	while (read (respipe [0], buf, 32) == 32)
355	;
356
357	rese = 0;
358	}
359	}
360
361	pthread_mutex_unlock (&reslock);
362
363	if (!req)
364	break;	488	croak (0);
365		489
366	--nreqs;	490	if (!max_outstanding || max_outstanding > eio_nreqs ())
		491	return res;
367		492
368	if (req->type == REQ_QUIT)	493	poll_wait ();
369	started--;
370	else if (req->type == REQ_GROUP && req->length)
371	{
372	req->fd = 1; /* mark request as delayed */
373	continue;
374	}
375	else
376	{
377	if (req->type == REQ_READ)
378	SvCUR_set (req->data, req->dataoffset + (req->result > 0 ? req->result : 0));
379
380	if (req->data2ptr && (req->type == REQ_READ || req->type == REQ_WRITE))
381	SvREADONLY_off (req->data);
382
383	if (req->statdata)
384	{
385	PL_laststype = req->type == REQ_LSTAT ? OP_LSTAT : OP_STAT;
386	PL_laststatval = req->result;
387	PL_statcache = *(req->statdata);
388	}
389
390	req_invoke (req);
391
392	count++;
393	}
394
395	req_free (req);
396	}	494	}
397
398	return count;
399	}	495	}
400		496
401	static void *aio_proc(void *arg);
402
403	static void start_thread (void)	497	static void atfork_child (void)
404	{	498	{
405	sigset_t fullsigset, oldsigset;	499	create_respipe ();
406	pthread_t tid;
407	pthread_attr_t attr;
408
409	pthread_attr_init (&attr);
410	pthread_attr_setstacksize (&attr, STACKSIZE);
411	pthread_attr_setdetachstate (&attr, PTHREAD_CREATE_DETACHED);
412
413	sigfillset (&fullsigset);
414	sigprocmask (SIG_SETMASK, &fullsigset, &oldsigset);
415
416	if (pthread_create (&tid, &attr, aio_proc, 0) == 0)
417	started++;
418
419	sigprocmask (SIG_SETMASK, &oldsigset, 0);
420	}	500	}
421		501
422	static void req_send (aio_req req)	502	static SV *
		503	get_cb (SV *cb_sv)
423	{	504	{
424	while (started < wanted && nreqs >= started)	505	HV *st;
425	start_thread ();	506	GV *gvp;
		507	CV *cv;
426		508
427	++nreqs;	509	if (!SvOK (cb_sv))
428
429	pthread_mutex_lock (&reqlock);
430
431	req->next = 0;
432
433	if (reqe)
434	{
435	reqe->next = req;
436	reqe = req;
437	}
438	else
439	reqe = reqs = req;
440
441	pthread_cond_signal (&reqwait);
442	pthread_mutex_unlock (&reqlock);
443
444	if (nreqs > max_outstanding)
445	for (;;)
446	{
447	poll_cb ();
448
449	if (nreqs <= max_outstanding)
450	break;
451
452	poll_wait ();
453	}
454	}
455
456	static void end_thread (void)
457	{
458	aio_req req;
459	Newz (0, req, 1, aio_cb);
460	req->type = REQ_QUIT;
461
462	req_send (req);
463	}
464
465	static void min_parallel (int nthreads)
466	{
467	if (wanted < nthreads)
468	wanted = nthreads;
469	}
470
471	static void max_parallel (int nthreads)
472	{
473	int cur = started;
474
475	if (wanted > nthreads)
476	wanted = nthreads;
477
478	while (cur > wanted)
479	{
480	end_thread ();
481	cur--;
482	}
483
484	while (started > wanted)
485	{
486	poll_wait ();
487	poll_cb ();
488	}
489	}
490
491	static void create_pipe ()
492	{
493	if (pipe (respipe))
494	croak ("unable to initialize result pipe");
495
496	if (fcntl (respipe [0], F_SETFL, O_NONBLOCK))
497	croak ("cannot set result pipe to nonblocking mode");
498
499	if (fcntl (respipe [1], F_SETFL, O_NONBLOCK))
500	croak ("cannot set result pipe to nonblocking mode");
501	}
502
503	/*****************************************************************************/
504	/* work around various missing functions */
505
506	#if !HAVE_PREADWRITE
507	# define pread aio_pread
508	# define pwrite aio_pwrite
509
510	/*
511	* make our pread/pwrite safe against themselves, but not against
512	* normal read/write by using a mutex. slows down execution a lot,
513	* but that's your problem, not mine.
514	*/
515	static pthread_mutex_t preadwritelock = PTHREAD_MUTEX_INITIALIZER;
516
517	static ssize_t pread (int fd, void *buf, size_t count, off_t offset)
518	{
519	ssize_t res;
520	off_t ooffset;
521
522	pthread_mutex_lock (&preadwritelock);
523	ooffset = lseek (fd, 0, SEEK_CUR);
524	lseek (fd, offset, SEEK_SET);
525	res = read (fd, buf, count);
526	lseek (fd, ooffset, SEEK_SET);
527	pthread_mutex_unlock (&preadwritelock);
528
529	return res;
530	}
531
532	static ssize_t pwrite (int fd, void *buf, size_t count, off_t offset)
533	{
534	ssize_t res;
535	off_t ooffset;
536
537	pthread_mutex_lock (&preadwritelock);
538	ooffset = lseek (fd, 0, SEEK_CUR);
539	lseek (fd, offset, SEEK_SET);
540	res = write (fd, buf, count);
541	lseek (fd, offset, SEEK_SET);
542	pthread_mutex_unlock (&preadwritelock);
543
544	return res;
545	}
546	#endif
547
548	#if !HAVE_FDATASYNC
549	# define fdatasync fsync
550	#endif
551
552	#if !HAVE_READAHEAD
553	# define readahead aio_readahead
554
555	static ssize_t readahead (int fd, off_t offset, size_t count)
556	{
557	char readahead_buf[4096];
558
559	while (count > 0)
560	{
561	size_t len = count < sizeof (readahead_buf) ? count : sizeof (readahead_buf);
562
563	pread (fd, readahead_buf, len, offset);
564	offset += len;
565	count -= len;
566	}
567
568	errno = 0;
569	}
570	#endif
571
572	#if !HAVE_READDIR_R
573	# define readdir_r aio_readdir_r
574
575	static pthread_mutex_t readdirlock = PTHREAD_MUTEX_INITIALIZER;
576
577	static int readdir_r (DIR *dirp, struct dirent *ent, struct dirent **res)
578	{
579	struct dirent *e;
580	int errorno;
581
582	pthread_mutex_lock (&readdirlock);
583
584	e = readdir (dirp);
585	errorno = errno;
586
587	if (e)
588	{
589	*res = ent;
590	strcpy (ent->d_name, e->d_name);
591	}
592	else
593	*res = 0;
594
595	pthread_mutex_unlock (&readdirlock);
596
597	errno = errorno;
598	return e ? 0 : -1;
599	}
600	#endif
601
602	/* sendfile always needs emulation */
603	static ssize_t sendfile_ (int ofd, int ifd, off_t offset, size_t count)
604	{
605	ssize_t res;
606
607	if (!count)
608	return 0;	510	return 0;
609		511
610	#if HAVE_SENDFILE	512	cv = sv_2cv (cb_sv, &st, &gvp, 0);
611	# if __linux
612	res = sendfile (ofd, ifd, &offset, count);
613		513
614	# elif __freebsd	514	if (!cv)
615	/*	515	croak ("IO::AIO callback must be undef or a CODE reference");
616	* Of course, the freebsd sendfile is a dire hack with no thoughts
617	* wasted on making it similar to other I/O functions.
618	*/
619	{
620	off_t sbytes;
621	res = sendfile (ifd, ofd, offset, count, 0, &sbytes, 0);
622		516
623	if (res < 0 && sbytes)	517	return (SV *)cv;
624	/* maybe only on EAGAIN only: as usual, the manpage leaves you guessing */
625	res = sbytes;
626	}
627
628	# elif __hpux
629	res = sendfile (ofd, ifd, offset, count, 0, 0);
630
631	# elif __solaris
632	{
633	struct sendfilevec vec;
634	size_t sbytes;
635
636	vec.sfv_fd = ifd;
637	vec.sfv_flag = 0;
638	vec.sfv_off = offset;
639	vec.sfv_len = count;
640
641	res = sendfilev (ofd, &vec, 1, &sbytes);
642
643	if (res < 0 && sbytes)
644	res = sbytes;
645	}
646
647	# endif
648	#else
649	res = -1;
650	errno = ENOSYS;
651	#endif
652
653	if (res < 0
654	&& (errno == ENOSYS || errno == EINVAL || errno == ENOTSOCK
655	#if __solaris
656	|| errno == EAFNOSUPPORT || errno == EPROTOTYPE
657	#endif
658	)
659	)
660	{
661	/* emulate sendfile. this is a major pain in the ass */
662	char buf[4096];
663	res = 0;
664
665	while (count)
666	{
667	ssize_t cnt;
668
669	cnt = pread (ifd, buf, count > 4096 ? 4096 : count, offset);
670
671	if (cnt <= 0)
672	{
673	if (cnt && !res) res = -1;
674	break;
675	}
676
677	cnt = write (ofd, buf, cnt);
678
679	if (cnt <= 0)
680	{
681	if (cnt && !res) res = -1;
682	break;
683	}
684
685	offset += cnt;
686	res += cnt;
687	count -= cnt;
688	}
689	}
690
691	return res;
692	}
693
694	/* read a full directory */
695	static int scandir_ (const char *path, void **namesp)
696	{
697	DIR *dirp = opendir (path);
698	union
699	{
700	struct dirent d;
701	char b [offsetof (struct dirent, d_name) + NAME_MAX + 1];
702	} u;
703	struct dirent *entp;
704	char *name, *names;
705	int memlen = 4096;
706	int memofs = 0;
707	int res = 0;
708	int errorno;
709
710	if (!dirp)
711	return -1;
712
713	names = malloc (memlen);
714
715	for (;;)
716	{
717	errno = 0, readdir_r (dirp, &u.d, &entp);
718
719	if (!entp)
720	break;
721
722	name = entp->d_name;
723
724	if (name [0] != '.' || (name [1] && (name [1] != '.' || name [2])))
725	{
726	int len = strlen (name) + 1;
727
728	res++;
729
730	while (memofs + len > memlen)
731	{
732	memlen *= 2;
733	names = realloc (names, memlen);
734	if (!names)
735	break;
736	}
737
738	memcpy (names + memofs, name, len);
739	memofs += len;
740	}
741	}
742
743	errorno = errno;
744	closedir (dirp);
745
746	if (errorno)
747	{
748	free (names);
749	errno = errorno;
750	res = -1;
751	}
752
753	*namesp = (void *)names;
754	return res;
755	}
756
757	/*****************************************************************************/
758
759	static void *aio_proc (void *thr_arg)
760	{
761	aio_req req;
762	int type;
763
764	do
765	{
766	pthread_mutex_lock (&reqlock);
767
768	for (;;)
769	{
770	req = reqs;
771
772	if (reqs)
773	{
774	reqs = reqs->next;
775	if (!reqs) reqe = 0;
776	}
777
778	if (req)
779	break;
780
781	pthread_cond_wait (&reqwait, &reqlock);
782	}
783
784	pthread_mutex_unlock (&reqlock);
785
786	errno = 0; /* strictly unnecessary */
787
788	if (!req->cancelled)
789	switch (type = req->type) /* remember type for QUIT check */
790	{
791	case REQ_READ: req->result = pread (req->fd, req->dataptr, req->length, req->offset); break;
792	case REQ_WRITE: req->result = pwrite (req->fd, req->dataptr, req->length, req->offset); break;
793
794	case REQ_READAHEAD: req->result = readahead (req->fd, req->offset, req->length); break;
795	case REQ_SENDFILE: req->result = sendfile_ (req->fd, req->fd2, req->offset, req->length); break;
796
797	case REQ_STAT: req->result = stat (req->dataptr, req->statdata); break;
798	case REQ_LSTAT: req->result = lstat (req->dataptr, req->statdata); break;
799	case REQ_FSTAT: req->result = fstat (req->fd , req->statdata); break;
800
801	case REQ_OPEN: req->result = open (req->dataptr, req->fd, req->mode); break;
802	case REQ_CLOSE: req->result = close (req->fd); break;
803	case REQ_UNLINK: req->result = unlink (req->dataptr); break;
804	case REQ_RMDIR: req->result = rmdir (req->dataptr); break;
805	case REQ_RENAME: req->result = rename (req->data2ptr, req->dataptr); break;
806	case REQ_LINK: req->result = link (req->data2ptr, req->dataptr); break;
807	case REQ_SYMLINK: req->result = symlink (req->data2ptr, req->dataptr); break;
808
809	case REQ_FDATASYNC: req->result = fdatasync (req->fd); break;
810	case REQ_FSYNC: req->result = fsync (req->fd); break;
811	case REQ_READDIR: req->result = scandir_ (req->dataptr, &req->data2ptr); break;
812
813	case REQ_SLEEP:
814	{
815	struct timeval tv;
816
817	tv.tv_sec = req->fd;
818	tv.tv_usec = req->fd2;
819
820	req->result = select (0, 0, 0, 0, &tv);
821	}
822
823	case REQ_QUIT:
824	break;
825
826	default:
827	req->result = ENOSYS;
828	break;
829	}
830
831	req->errorno = errno;
832
833	pthread_mutex_lock (&reslock);
834
835	req->next = 0;
836
837	if (rese)
838	{
839	rese->next = req;
840	rese = req;
841	}
842	else
843	{
844	rese = ress = req;
845
846	/* write a dummy byte to the pipe so fh becomes ready */
847	write (respipe [1], &respipe, 1);
848	}
849
850	pthread_mutex_unlock (&reslock);
851	}
852	while (type != REQ_QUIT);
853
854	return 0;
855	}
856
857	/*****************************************************************************/
858
859	static void atfork_prepare (void)
860	{
861	pthread_mutex_lock (&reqlock);
862	pthread_mutex_lock (&reslock);
863	#if !HAVE_PREADWRITE
864	pthread_mutex_lock (&preadwritelock);
865	#endif
866	#if !HAVE_READDIR_R
867	pthread_mutex_lock (&readdirlock);
868	#endif
869	}
870
871	static void atfork_parent (void)
872	{
873	#if !HAVE_READDIR_R
874	pthread_mutex_unlock (&readdirlock);
875	#endif
876	#if !HAVE_PREADWRITE
877	pthread_mutex_unlock (&preadwritelock);
878	#endif
879	pthread_mutex_unlock (&reslock);
880	pthread_mutex_unlock (&reqlock);
881	}
882
883	static void atfork_child (void)
884	{
885	aio_req prv;
886
887	started = 0;
888
889	while (reqs)
890	{
891	prv = reqs;
892	reqs = prv->next;
893	req_free (prv);
894	}
895
896	reqs = reqe = 0;
897
898	while (ress)
899	{
900	prv = ress;
901	ress = prv->next;
902	req_free (prv);
903	}
904
905	ress = rese = 0;
906
907	close (respipe [0]);
908	close (respipe [1]);
909	create_pipe ();
910
911	atfork_parent ();
912	}	518	}
913		519
914	#define dREQ \	520	#define dREQ \
		521	SV *cb_cv; \
915	aio_req req; \	522	aio_req req; \
		523	int req_pri = next_pri; \
		524	next_pri = EIO_PRI_DEFAULT; \
916	\	525	\
917	if (SvOK (callback) && !SvROK (callback)) \	526	cb_cv = get_cb (callback); \
918	croak ("callback must be undef or of reference type"); \
919	\	527	\
920	Newz (0, req, 1, aio_cb); \	528	Newz (0, req, 1, eio_req); \
921	if (!req) \	529	if (!req) \
922	croak ("out of memory during aio_req allocation"); \	530	croak ("out of memory during eio_req allocation"); \
923	\	531	\
924	req->callback = newSVsv (callback)	532	req->callback = SvREFCNT_inc (cb_cv); \
		533	req->pri = req_pri
925		534
926	#define REQ_SEND \	535	#define REQ_SEND \
		536	PUTBACK; \
927	req_send (req); \	537	req_submit (req); \
		538	SPAGAIN; \
928	\	539	\
929	if (GIMME_V != G_VOID) \	540	if (GIMME_V != G_VOID) \
930	XPUSHs (req_sv (req, AIO_REQ_KLASS));	541	XPUSHs (req_sv (req, AIO_REQ_KLASS));
931		542
		543	static int
		544	extract_fd (SV *fh, int wr)
		545	{
		546	int fd = PerlIO_fileno (wr ? IoOFP (sv_2io (fh)) : IoIFP (sv_2io (fh)));
		547
		548	if (fd < 0)
		549	croak ("illegal fh argument, either not an OS file or read/write mode mismatch");
		550
		551	return fd;
		552	}
		553
932	MODULE = IO::AIO PACKAGE = IO::AIO	554	MODULE = IO::AIO PACKAGE = IO::AIO
933		555
934	PROTOTYPES: ENABLE	556	PROTOTYPES: ENABLE
935		557
936	BOOT:	558	BOOT:
937	{	559	{
938	HV *stash = gv_stashpv ("IO::AIO", 1);	560	stash = gv_stashpv ("IO::AIO", 1);
939	newCONSTSUB (stash, "EXDEV", newSViv (EXDEV));
940	newCONSTSUB (stash, "O_RDONLY", newSViv (O_RDONLY));
941	newCONSTSUB (stash, "O_WRONLY", newSViv (O_WRONLY));
942		561
		562	static const struct {
		563	const char *name;
		564	IV iv;
		565	} *civ, const_iv[] = {
		566	# define const_iv(name, value) { # name, (IV) value },
		567	# define const_eio(name) { # name, (IV) EIO_ ## name },
		568	const_iv (EXDEV , EXDEV)
		569	const_iv (ENOSYS , ENOSYS)
		570	const_iv (O_RDONLY, O_RDONLY)
		571	const_iv (O_WRONLY, O_WRONLY)
		572	const_iv (O_CREAT , O_CREAT)
		573	const_iv (O_TRUNC , O_TRUNC)
		574	#ifndef _WIN32
		575	const_iv (S_IFIFO , S_IFIFO)
		576	#endif
		577	const_eio (SYNC_FILE_RANGE_WAIT_BEFORE)
		578	const_eio (SYNC_FILE_RANGE_WRITE)
		579	const_eio (SYNC_FILE_RANGE_WAIT_AFTER)
		580
		581	const_eio (READDIR_DENTS)
		582	const_eio (READDIR_DIRS_FIRST)
		583	const_eio (READDIR_STAT_ORDER)
		584	const_eio (READDIR_FOUND_UNKNOWN)
		585
		586	const_eio (DT_UNKNOWN)
		587	const_eio (DT_FIFO)
		588	const_eio (DT_CHR)
		589	const_eio (DT_DIR)
		590	const_eio (DT_BLK)
		591	const_eio (DT_REG)
		592	const_eio (DT_LNK)
		593	const_eio (DT_SOCK)
		594	const_eio (DT_WHT)
		595	};
		596
		597	for (civ = const_iv + sizeof (const_iv) / sizeof (const_iv [0]); civ-- > const_iv; )
		598	newCONSTSUB (stash, (char *)civ->name, newSViv (civ->iv));
		599
943	create_pipe ();	600	create_respipe ();
944	pthread_atfork (atfork_prepare, atfork_parent, atfork_child);
945	}
946		601
		602	if (eio_init (want_poll, done_poll) < 0)
		603	croak ("IO::AIO: unable to initialise eio library");
		604
		605	/* atfork child called in fifo order, so before eio's handler */
		606	X_THREAD_ATFORK (0, 0, atfork_child);
		607	}
		608
947	void	609	void
948	min_parallel (nthreads)	610	max_poll_reqs (int nreqs)
949	int nthreads
950	PROTOTYPE: $	611	PROTOTYPE: $
		612	CODE:
		613	eio_set_max_poll_reqs (nreqs);
951		614
952	void	615	void
953	max_parallel (nthreads)	616	max_poll_time (double nseconds)
954	int nthreads
955	PROTOTYPE: $	617	PROTOTYPE: $
956
957	int
958	max_outstanding (nreqs)
959	int nreqs
960	PROTOTYPE: $
961	CODE:	618	CODE:
962	RETVAL = max_outstanding;	619	eio_set_max_poll_time (nseconds);
		620
		621	void
		622	min_parallel (int nthreads)
		623	PROTOTYPE: $
		624	CODE:
		625	eio_set_min_parallel (nthreads);
		626
		627	void
		628	max_parallel (int nthreads)
		629	PROTOTYPE: $
		630	CODE:
		631	eio_set_max_parallel (nthreads);
		632
		633	void
		634	max_idle (int nthreads)
		635	PROTOTYPE: $
		636	CODE:
		637	eio_set_max_idle (nthreads);
		638
		639	void
		640	max_outstanding (int maxreqs)
		641	PROTOTYPE: $
		642	CODE:
963	max_outstanding = nreqs;	643	max_outstanding = maxreqs;
964		644
965	void	645	void
966	aio_open (pathname,flags,mode,callback=&PL_sv_undef)	646	aio_open (SV8 *pathname, int flags, int mode, SV *callback=&PL_sv_undef)
967	SV * pathname
968	int flags
969	int mode
970	SV * callback
971	PROTOTYPE: $$$;$	647	PROTOTYPE: $$$;$
972	PPCODE:	648	PPCODE:
973	{	649	{
974	dREQ;	650	dREQ;
975		651
976	req->type = REQ_OPEN;	652	req->type = EIO_OPEN;
977	req->data = newSVsv (pathname);	653	req->sv1 = newSVsv (pathname);
978	req->dataptr = SvPVbyte_nolen (req->data);	654	req->ptr1 = SvPVbyte_nolen (req->sv1);
979	req->fd = flags;	655	req->int1 = flags;
980	req->mode = mode;	656	req->int2 = mode;
981		657
982	REQ_SEND;	658	REQ_SEND;
983	}	659	}
984		660
985	void	661	void
986	aio_close (fh,callback=&PL_sv_undef)	662	aio_fsync (SV *fh, SV *callback=&PL_sv_undef)
987	SV * fh
988	SV * callback
989	PROTOTYPE: $;$	663	PROTOTYPE: $;$
990	ALIAS:	664	ALIAS:
991	aio_close = REQ_CLOSE
992	aio_fsync = REQ_FSYNC	665	aio_fsync = EIO_FSYNC
993	aio_fdatasync = REQ_FDATASYNC	666	aio_fdatasync = EIO_FDATASYNC
994	PPCODE:	667	PPCODE:
995	{	668	{
		669	int fd = extract_fd (fh, 0);
996	dREQ;	670	dREQ;
997		671
998	req->type = ix;	672	req->type = ix;
999	req->fh = newSVsv (fh);	673	req->sv1 = newSVsv (fh);
1000	req->fd = PerlIO_fileno (IoIFP (sv_2io (fh)));	674	req->int1 = fd;
1001		675
1002	REQ_SEND (req);	676	REQ_SEND (req);
1003	}	677	}
1004		678
1005	void	679	void
		680	aio_sync_file_range (SV *fh, SV *offset, SV *nbytes, IV flags, SV *callback=&PL_sv_undef)
		681	PROTOTYPE: $$$$;$
		682	PPCODE:
		683	{
		684	int fd = extract_fd (fh, 0);
		685	dREQ;
		686
		687	req->type = EIO_SYNC_FILE_RANGE;
		688	req->sv1 = newSVsv (fh);
		689	req->int1 = fd;
		690	req->offs = SvVAL64 (offset);
		691	req->size = SvVAL64 (nbytes);
		692	req->int2 = flags;
		693
		694	REQ_SEND (req);
		695	}
		696
		697	void
		698	aio_close (SV *fh, SV *callback=&PL_sv_undef)
		699	PROTOTYPE: $;$
		700	PPCODE:
		701	{
		702	static int close_pipe = -1; /* dummy fd to close fds via dup2 */
		703	int fd = extract_fd (fh, 0);
		704	dREQ;
		705
		706	if (close_pipe < 0)
		707	{
		708	int pipefd [2];
		709
		710	if (pipe (pipefd) < 0
		711	|| close (pipefd [1]) < 0
		712	|| fcntl (pipefd [0], F_SETFD, FD_CLOEXEC) < 0)
		713	abort (); /*D*/
		714
		715	close_pipe = pipefd [0];
		716	}
		717
		718	req->type = EIO_DUP2;
		719	req->int1 = close_pipe;
		720	req->sv2 = newSVsv (fh);
		721	req->int2 = fd;
		722
		723	REQ_SEND (req);
		724	}
		725
		726	void
1006	aio_read (fh,offset,length,data,dataoffset,callback=&PL_sv_undef)	727	aio_read (SV *fh, SV *offset, SV *length, SV8 *data, IV dataoffset, SV *callback=&PL_sv_undef)
1007	SV * fh
1008	UV offset
1009	UV length
1010	SV * data
1011	UV dataoffset
1012	SV * callback
1013	ALIAS:	728	ALIAS:
1014	aio_read = REQ_READ	729	aio_read = EIO_READ
1015	aio_write = REQ_WRITE	730	aio_write = EIO_WRITE
1016	PROTOTYPE: $$$$$;$	731	PROTOTYPE: $$$$$;$
1017	PPCODE:	732	PPCODE:
1018	{	733	{
1019	aio_req req;
1020	STRLEN svlen;	734	STRLEN svlen;
		735	int fd = extract_fd (fh, ix == EIO_WRITE);
1021	char *svptr = SvPVbyte (data, svlen);	736	char *svptr = SvPVbyte (data, svlen);
1022		737	UV len = SvUV (length);
1023	SvUPGRADE (data, SVt_PV);
1024	SvPOK_on (data);
1025		738
1026	if (dataoffset < 0)	739	if (dataoffset < 0)
1027	dataoffset += svlen;	740	dataoffset += svlen;
1028		741
1029	if (dataoffset < 0 || dataoffset > svlen)	742	if (dataoffset < 0 || dataoffset > svlen)
1030	croak ("data offset outside of string");	743	croak ("dataoffset outside of data scalar");
1031		744
1032	if (ix == REQ_WRITE)	745	if (ix == EIO_WRITE)
1033	{	746	{
1034	/* write: check length and adjust. */	747	/* write: check length and adjust. */
1035	if (length < 0 || length + dataoffset > svlen)	748	if (!SvOK (length) || len + dataoffset > svlen)
1036	length = svlen - dataoffset;	749	len = svlen - dataoffset;
1037	}	750	}
1038	else	751	else
1039	{	752	{
1040	/* read: grow scalar as necessary */	753	/* read: check type and grow scalar as necessary */
		754	SvUPGRADE (data, SVt_PV);
1041	svptr = SvGROW (data, length + dataoffset);	755	svptr = SvGROW (data, len + dataoffset + 1);
1042	}	756	}
1043
1044	if (length < 0)
1045	croak ("length must not be negative");
1046		757
1047	{	758	{
1048	dREQ;	759	dREQ;
1049		760
1050	req->type = ix;	761	req->type = ix;
1051	req->fh = newSVsv (fh);	762	req->sv1 = newSVsv (fh);
1052	req->fd = PerlIO_fileno (ix == REQ_READ ? IoIFP (sv_2io (fh))	763	req->int1 = fd;
1053	: IoOFP (sv_2io (fh)));	764	req->offs = SvOK (offset) ? SvVAL64 (offset) : -1;
1054	req->offset = offset;	765	req->size = len;
1055	req->length = length;
1056	req->data = SvREFCNT_inc (data);	766	req->sv2 = SvREFCNT_inc (data);
1057	req->dataptr = (char *)svptr + dataoffset;	767	req->ptr2 = (char *)svptr + dataoffset;
		768	req->stroffset = dataoffset;
1058		769
1059	if (!SvREADONLY (data))	770	if (!SvREADONLY (data))
1060	{	771	{
1061	SvREADONLY_on (data);	772	SvREADONLY_on (data);
1062	req->data2ptr = (void *)data;	773	req->flags |= FLAG_SV2_RO_OFF;
1063	}	774	}
1064		775
1065	REQ_SEND;	776	REQ_SEND;
1066	}	777	}
1067	}	778	}
1068		779
1069	void	780	void
		781	aio_readlink (SV8 *path, SV *callback=&PL_sv_undef)
		782	PROTOTYPE: $$;$
		783	PPCODE:
		784	{
		785	SV *data;
		786	dREQ;
		787
		788	req->type = EIO_READLINK;
		789	req->sv1 = newSVsv (path);
		790	req->ptr1 = SvPVbyte_nolen (req->sv1);
		791
		792	REQ_SEND;
		793	}
		794
		795	void
1070	aio_sendfile (out_fh,in_fh,in_offset,length,callback=&PL_sv_undef)	796	aio_sendfile (SV *out_fh, SV *in_fh, SV *in_offset, UV length, SV *callback=&PL_sv_undef)
1071	SV * out_fh
1072	SV * in_fh
1073	UV in_offset
1074	UV length
1075	SV * callback
1076	PROTOTYPE: $$$$;$	797	PROTOTYPE: $$$$;$
1077	PPCODE:	798	PPCODE:
1078	{	799	{
		800	int ifd = extract_fd (in_fh , 0);
		801	int ofd = extract_fd (out_fh, 0);
1079	dREQ;	802	dREQ;
1080		803
1081	req->type = REQ_SENDFILE;	804	req->type = EIO_SENDFILE;
1082	req->fh = newSVsv (out_fh);	805	req->sv1 = newSVsv (out_fh);
1083	req->fd = PerlIO_fileno (IoIFP (sv_2io (out_fh)));	806	req->int1 = ofd;
1084	req->fh2 = newSVsv (in_fh);	807	req->sv2 = newSVsv (in_fh);
1085	req->fd2 = PerlIO_fileno (IoIFP (sv_2io (in_fh)));	808	req->int2 = ifd;
1086	req->offset = in_offset;	809	req->offs = SvVAL64 (in_offset);
1087	req->length = length;	810	req->size = length;
1088		811
1089	REQ_SEND;	812	REQ_SEND;
1090	}	813	}
1091		814
1092	void	815	void
1093	aio_readahead (fh,offset,length,callback=&PL_sv_undef)	816	aio_readahead (SV *fh, SV *offset, IV length, SV *callback=&PL_sv_undef)
1094	SV * fh
1095	UV offset
1096	IV length
1097	SV * callback
1098	PROTOTYPE: $$$;$	817	PROTOTYPE: $$$;$
1099	PPCODE:	818	PPCODE:
1100	{	819	{
		820	int fd = extract_fd (fh, 0);
1101	dREQ;	821	dREQ;
1102		822
1103	req->type = REQ_READAHEAD;	823	req->type = EIO_READAHEAD;
1104	req->fh = newSVsv (fh);	824	req->sv1 = newSVsv (fh);
1105	req->fd = PerlIO_fileno (IoIFP (sv_2io (fh)));	825	req->int1 = fd;
1106	req->offset = offset;	826	req->offs = SvVAL64 (offset);
1107	req->length = length;	827	req->size = length;
1108		828
1109	REQ_SEND;	829	REQ_SEND;
1110	}	830	}
1111		831
1112	void	832	void
1113	aio_stat (fh_or_path,callback=&PL_sv_undef)	833	aio_stat (SV8 *fh_or_path, SV *callback=&PL_sv_undef)
1114	SV * fh_or_path
1115	SV * callback
1116	ALIAS:	834	ALIAS:
1117	aio_stat = REQ_STAT	835	aio_stat = EIO_STAT
1118	aio_lstat = REQ_LSTAT	836	aio_lstat = EIO_LSTAT
1119	PPCODE:	837	PPCODE:
1120	{	838	{
1121	dREQ;	839	dREQ;
1122		840
1123	New (0, req->statdata, 1, Stat_t);	841	req->sv1 = newSVsv (fh_or_path);
1124	if (!req->statdata)
1125	{
1126	req_free (req);
1127	croak ("out of memory during aio_req->statdata allocation");
1128	}
1129		842
1130	if (SvPOK (fh_or_path))	843	if (SvPOK (req->sv1))
1131	{	844	{
1132	req->type = ix;	845	req->type = ix;
1133	req->data = newSVsv (fh_or_path);
1134	req->dataptr = SvPVbyte_nolen (req->data);	846	req->ptr1 = SvPVbyte_nolen (req->sv1);
1135	}	847	}
1136	else	848	else
1137	{	849	{
1138	req->type = REQ_FSTAT;	850	req->type = EIO_FSTAT;
1139	req->fh = newSVsv (fh_or_path);
1140	req->fd = PerlIO_fileno (IoIFP (sv_2io (fh_or_path)));	851	req->int1 = PerlIO_fileno (IoIFP (sv_2io (fh_or_path)));
1141	}	852	}
1142		853
1143	REQ_SEND;	854	REQ_SEND;
1144	}	855	}
1145		856
1146	void	857	void
		858	aio_utime (SV8 *fh_or_path, SV *atime, SV *mtime, SV *callback=&PL_sv_undef)
		859	PPCODE:
		860	{
		861	dREQ;
		862
		863	req->nv1 = SvOK (atime) ? SvNV (atime) : -1.;
		864	req->nv2 = SvOK (mtime) ? SvNV (mtime) : -1.;
		865	req->sv1 = newSVsv (fh_or_path);
		866
		867	if (SvPOK (req->sv1))
		868	{
		869	req->type = EIO_UTIME;
		870	req->ptr1 = SvPVbyte_nolen (req->sv1);
		871	}
		872	else
		873	{
		874	req->type = EIO_FUTIME;
		875	req->int1 = PerlIO_fileno (IoIFP (sv_2io (fh_or_path)));
		876	}
		877
		878	REQ_SEND;
		879	}
		880
		881	void
		882	aio_truncate (SV8 *fh_or_path, SV *offset, SV *callback=&PL_sv_undef)
		883	PPCODE:
		884	{
		885	dREQ;
		886
		887	req->sv1 = newSVsv (fh_or_path);
		888	req->offs = SvOK (offset) ? SvVAL64 (offset) : -1;
		889
		890	if (SvPOK (req->sv1))
		891	{
		892	req->type = EIO_TRUNCATE;
		893	req->ptr1 = SvPVbyte_nolen (req->sv1);
		894	}
		895	else
		896	{
		897	req->type = EIO_FTRUNCATE;
		898	req->int1 = PerlIO_fileno (IoIFP (sv_2io (fh_or_path)));
		899	}
		900
		901	REQ_SEND;
		902	}
		903
		904	void
		905	aio_chmod (SV8 *fh_or_path, int mode, SV *callback=&PL_sv_undef)
		906	ALIAS:
		907	aio_chmod = EIO_CHMOD
		908	aio_mkdir = EIO_MKDIR
		909	PPCODE:
		910	{
		911	dREQ;
		912
		913	req->int2 = mode;
		914	req->sv1 = newSVsv (fh_or_path);
		915
		916	if (SvPOK (req->sv1))
		917	{
		918	req->type = ix;
		919	req->ptr1 = SvPVbyte_nolen (req->sv1);
		920	}
		921	else
		922	{
		923	req->type = EIO_FCHMOD;
		924	req->int1 = PerlIO_fileno (IoIFP (sv_2io (fh_or_path)));
		925	}
		926
		927	REQ_SEND;
		928	}
		929
		930	void
		931	aio_chown (SV8 *fh_or_path, SV *uid, SV *gid, SV *callback=&PL_sv_undef)
		932	PPCODE:
		933	{
		934	dREQ;
		935
		936	req->int2 = SvOK (uid) ? SvIV (uid) : -1;
		937	req->int3 = SvOK (gid) ? SvIV (gid) : -1;
		938	req->sv1 = newSVsv (fh_or_path);
		939
		940	if (SvPOK (req->sv1))
		941	{
		942	req->type = EIO_CHOWN;
		943	req->ptr1 = SvPVbyte_nolen (req->sv1);
		944	}
		945	else
		946	{
		947	req->type = EIO_FCHOWN;
		948	req->int1 = PerlIO_fileno (IoIFP (sv_2io (fh_or_path)));
		949	}
		950
		951	REQ_SEND;
		952	}
		953
		954	void
		955	aio_readdirx (SV8 *pathname, IV flags, SV *callback=&PL_sv_undef)
		956	PPCODE:
		957	{
		958	dREQ;
		959
		960	req->type = EIO_READDIR;
		961	req->sv1 = newSVsv (pathname);
		962	req->ptr1 = SvPVbyte_nolen (req->sv1);
		963	req->int1 = flags | EIO_READDIR_DENTS | EIO_READDIR_CUSTOM1;
		964
		965	if (flags & EIO_READDIR_DENTS)
		966	req->int1 |= EIO_READDIR_CUSTOM2;
		967
		968	REQ_SEND;
		969	}
		970
		971	void
1147	aio_unlink (pathname,callback=&PL_sv_undef)	972	aio_unlink (SV8 *pathname, SV *callback=&PL_sv_undef)
1148	SV * pathname
1149	SV * callback
1150	ALIAS:	973	ALIAS:
1151	aio_unlink = REQ_UNLINK	974	aio_unlink = EIO_UNLINK
1152	aio_rmdir = REQ_RMDIR	975	aio_rmdir = EIO_RMDIR
1153	aio_readdir = REQ_READDIR	976	aio_readdir = EIO_READDIR
1154	PPCODE:	977	PPCODE:
1155	{	978	{
1156	dREQ;	979	dREQ;
1157		980
1158	req->type = ix;	981	req->type = ix;
1159	req->data = newSVsv (pathname);	982	req->sv1 = newSVsv (pathname);
1160	req->dataptr = SvPVbyte_nolen (req->data);	983	req->ptr1 = SvPVbyte_nolen (req->sv1);
		984
		985	REQ_SEND;
		986	}
		987
		988	void
		989	aio_link (SV8 *oldpath, SV8 *newpath, SV *callback=&PL_sv_undef)
		990	ALIAS:
		991	aio_link = EIO_LINK
		992	aio_symlink = EIO_SYMLINK
		993	aio_rename = EIO_RENAME
		994	PPCODE:
		995	{
		996	dREQ;
		997
		998	req->type = ix;
		999	req->sv1 = newSVsv (oldpath);
		1000	req->ptr1 = SvPVbyte_nolen (req->sv1);
		1001	req->sv2 = newSVsv (newpath);
		1002	req->ptr2 = SvPVbyte_nolen (req->sv2);
1161		1003
1162	REQ_SEND;	1004	REQ_SEND;
1163	}	1005	}
1164		1006
1165	void	1007	void
1166	aio_link (oldpath,newpath,callback=&PL_sv_undef)	1008	aio_mknod (SV8 *pathname, int mode, UV dev, SV *callback=&PL_sv_undef)
1167	SV * oldpath
1168	SV * newpath
1169	SV * callback
1170	ALIAS:
1171	aio_link = REQ_LINK
1172	aio_symlink = REQ_SYMLINK
1173	aio_rename = REQ_RENAME
1174	PPCODE:	1009	PPCODE:
1175	{	1010	{
1176	dREQ;	1011	dREQ;
1177		1012
1178	req->type = ix;	1013	req->type = EIO_MKNOD;
1179	req->fh = newSVsv (oldpath);	1014	req->sv1 = newSVsv (pathname);
1180	req->data2ptr = SvPVbyte_nolen (req->fh);	1015	req->ptr1 = SvPVbyte_nolen (req->sv1);
1181	req->data = newSVsv (newpath);	1016	req->int2 = (mode_t)mode;
1182	req->dataptr = SvPVbyte_nolen (req->data);	1017	req->offs = dev;
1183		1018
1184	REQ_SEND;	1019	REQ_SEND;
1185	}	1020	}
1186		1021
1187	void	1022	void
1188	aio_sleep (delay,callback=&PL_sv_undef)	1023	aio_busy (double delay, SV *callback=&PL_sv_undef)
1189	double delay
1190	SV * callback
1191	PPCODE:	1024	PPCODE:
1192	{	1025	{
1193	dREQ;	1026	dREQ;
1194		1027
1195	req->type = REQ_SLEEP;	1028	req->type = EIO_BUSY;
1196	req->fd = delay < 0. ? 0 : delay;	1029	req->nv1 = delay < 0. ? 0. : delay;
1197	req->fd2 = delay < 0. ? 0 : 1000. * (delay - req->fd);
1198		1030
1199	REQ_SEND;	1031	REQ_SEND;
1200	}	1032	}
1201		1033
1202	void	1034	void
1203	aio_group (callback=&PL_sv_undef)	1035	aio_group (SV *callback=&PL_sv_undef)
1204	SV * callback
1205	PROTOTYPE: ;$	1036	PROTOTYPE: ;$
1206	PPCODE:	1037	PPCODE:
1207	{	1038	{
1208	dREQ;	1039	dREQ;
		1040
1209	req->type = REQ_GROUP;	1041	req->type = EIO_GROUP;
		1042
1210	req_send (req);	1043	req_submit (req);
1211	XPUSHs (req_sv (req, AIO_GRP_KLASS));	1044	XPUSHs (req_sv (req, AIO_GRP_KLASS));
1212	}	1045	}
		1046
		1047	void
		1048	aio_nop (SV *callback=&PL_sv_undef)
		1049	ALIAS:
		1050	aio_nop = EIO_NOP
		1051	aio_sync = EIO_SYNC
		1052	PPCODE:
		1053	{
		1054	dREQ;
		1055
		1056	req->type = ix;
		1057
		1058	REQ_SEND;
		1059	}
		1060
		1061	int
		1062	aioreq_pri (int pri = 0)
		1063	PROTOTYPE: ;$
		1064	CODE:
		1065	RETVAL = next_pri;
		1066	if (items > 0)
		1067	{
		1068	if (pri < EIO_PRI_MIN) pri = EIO_PRI_MIN;
		1069	if (pri > EIO_PRI_MAX) pri = EIO_PRI_MAX;
		1070	next_pri = pri;
		1071	}
		1072	OUTPUT:
		1073	RETVAL
		1074
		1075	void
		1076	aioreq_nice (int nice = 0)
		1077	CODE:
		1078	nice = next_pri - nice;
		1079	if (nice < EIO_PRI_MIN) nice = EIO_PRI_MIN;
		1080	if (nice > EIO_PRI_MAX) nice = EIO_PRI_MAX;
		1081	next_pri = nice;
1213		1082
1214	void	1083	void
1215	flush ()	1084	flush ()
1216	PROTOTYPE:	1085	PROTOTYPE:
1217	CODE:	1086	CODE:
1218	while (nreqs)	1087	while (eio_nreqs ())
1219	{	1088	{
1220	poll_wait ();	1089	poll_wait ();
1221	poll_cb ();	1090	poll_cb ();
1222	}	1091	}
1223		1092
1224	void	1093	int
1225	poll()	1094	poll()
1226	PROTOTYPE:	1095	PROTOTYPE:
1227	CODE:	1096	CODE:
1228	if (nreqs)
1229	{
1230	poll_wait ();	1097	poll_wait ();
1231	poll_cb ();	1098	RETVAL = poll_cb ();
1232	}	1099	OUTPUT:
		1100	RETVAL
1233		1101
1234	int	1102	int
1235	poll_fileno()	1103	poll_fileno()
1236	PROTOTYPE:	1104	PROTOTYPE:
1237	CODE:	1105	CODE:
…		…
1249		1117
1250	void	1118	void
1251	poll_wait()	1119	poll_wait()
1252	PROTOTYPE:	1120	PROTOTYPE:
1253	CODE:	1121	CODE:
1254	if (nreqs)
1255	poll_wait ();	1122	poll_wait ();
1256		1123
1257	int	1124	int
1258	nreqs()	1125	nreqs()
1259	PROTOTYPE:	1126	PROTOTYPE:
1260	CODE:	1127	CODE:
1261	RETVAL = nreqs;	1128	RETVAL = eio_nreqs ();
1262	OUTPUT:	1129	OUTPUT:
1263	RETVAL	1130	RETVAL
1264		1131
		1132	int
		1133	nready()
		1134	PROTOTYPE:
		1135	CODE:
		1136	RETVAL = eio_nready ();
		1137	OUTPUT:
		1138	RETVAL
		1139
		1140	int
		1141	npending()
		1142	PROTOTYPE:
		1143	CODE:
		1144	RETVAL = eio_npending ();
		1145	OUTPUT:
		1146	RETVAL
		1147
		1148	int
		1149	nthreads()
		1150	PROTOTYPE:
		1151	CODE:
		1152	RETVAL = eio_nthreads ();
		1153	OUTPUT:
		1154	RETVAL
		1155
		1156	void _on_next_submit (SV *cb)
		1157	CODE:
		1158	SvREFCNT_dec (on_next_submit);
		1159	on_next_submit = SvOK (cb) ? newSVsv (cb) : 0;
		1160
1265	PROTOTYPES: DISABLE	1161	PROTOTYPES: DISABLE
1266		1162
1267	MODULE = IO::AIO PACKAGE = IO::AIO::REQ	1163	MODULE = IO::AIO PACKAGE = IO::AIO::REQ
1268		1164
1269	void	1165	void
1270	cancel (aio_req_ornot req)	1166	cancel (aio_req_ornot req)
1271	PROTOTYPE:
1272	CODE:	1167	CODE:
1273	req_cancel (req);	1168	eio_cancel (req);
		1169
		1170	void
		1171	cb (aio_req_ornot req, SV *callback=&PL_sv_undef)
		1172	PPCODE:
		1173	{
		1174	if (GIMME_V != G_VOID)
		1175	XPUSHs (req->callback ? sv_2mortal (newRV_inc (req->callback)) : &PL_sv_undef);
		1176
		1177	if (items > 1)
		1178	{
		1179	SV *cb_cv = get_cb (callback);
		1180
		1181	SvREFCNT_dec (req->callback);
		1182	req->callback = SvREFCNT_inc (cb_cv);
		1183	}
		1184	}
1274		1185
1275	MODULE = IO::AIO PACKAGE = IO::AIO::GRP	1186	MODULE = IO::AIO PACKAGE = IO::AIO::GRP
1276		1187
1277	void	1188	void
1278	add (aio_req grp, ...)	1189	add (aio_req grp, ...)
1279	PPCODE:	1190	PPCODE:
1280	{	1191	{
1281	int i;	1192	int i;
1282		1193
1283	if (grp->fd == 2)	1194	if (grp->int1 == 2)
1284	croak ("cannot add requests to IO::AIO::GRP after the group finished");	1195	croak ("cannot add requests to IO::AIO::GRP after the group finished");
1285		1196
1286	for (i = 1; i < items; ++i )	1197	for (i = 1; i < items; ++i )
1287	{	1198	{
		1199	aio_req req;
		1200
1288	if (GIMME_V != G_VOID)	1201	if (GIMME_V != G_VOID)
1289	XPUSHs (sv_2mortal (newSVsv (ST (i))));	1202	XPUSHs (sv_2mortal (newSVsv (ST (i))));
1290		1203
1291	aio_req req = SvAIO_REQ (ST (i));	1204	req = SvAIO_REQ (ST (i));
1292		1205
1293	if (req)	1206	if (req)
1294	{	1207	eio_grp_add (grp, req);
1295	++grp->length;
1296	req->grp = grp;
1297
1298	req->grp_prev = 0;
1299	req->grp_next = grp->grp_first;
1300
1301	if (grp->grp_first)
1302	grp->grp_first->grp_prev = req;
1303
1304	grp->grp_first = req;
1305	}	1208	}
1306	}
1307	}	1209	}
		1210
		1211	void
		1212	cancel_subs (aio_req_ornot req)
		1213	CODE:
		1214	req_cancel_subs (req);
1308		1215
1309	void	1216	void
1310	result (aio_req grp, ...)	1217	result (aio_req grp, ...)
1311	CODE:	1218	CODE:
1312	{	1219	{
1313	int i;	1220	int i;
		1221	AV *av;
		1222
		1223	grp->errorno = errno;
		1224
1314	AV *av = newAV ();	1225	av = newAV ();
		1226	av_extend (av, items - 1);
1315		1227
1316	for (i = 1; i < items; ++i )	1228	for (i = 1; i < items; ++i )
1317	av_push (av, newSVsv (ST (i)));	1229	av_push (av, newSVsv (ST (i)));
1318		1230
1319	SvREFCNT_dec (grp->data);	1231	SvREFCNT_dec (grp->sv1);
1320	grp->data = (SV *)av;	1232	grp->sv1 = (SV *)av;
1321	}	1233	}
1322		1234
1323	void	1235	void
1324	lock (aio_req grp)	1236	errno (aio_req grp, int errorno = errno)
1325	CODE:	1237	CODE:
1326	++grp->length;	1238	grp->errorno = errorno;
1327		1239
1328	void	1240	void
1329	unlock (aio_req grp)
1330	CODE:
1331	aio_grp_dec (grp);
1332
1333	void
1334	feeder_limit (aio_req grp, int limit)	1241	limit (aio_req grp, int limit)
1335	CODE:	1242	CODE:
1336	grp->fd2 = limit;	1243	eio_grp_limit (grp, limit);
1337	aio_grp_feed (grp);
1338		1244
1339	void	1245	void
1340	set_feeder (aio_req grp, SV *callback=&PL_sv_undef)	1246	feed (aio_req grp, SV *callback=&PL_sv_undef)
1341	CODE:	1247	CODE:
1342	{	1248	{
1343	SvREFCNT_dec (grp->fh2);	1249	SvREFCNT_dec (grp->sv2);
1344	grp->fh2 = newSVsv (callback);	1250	grp->sv2 = newSVsv (callback);
		1251	grp->feed = aio_grp_feed;
1345		1252
1346	if (grp->fd2 <= 0)	1253	if (grp->int2 <= 0)
1347	grp->fd2 = 2;	1254	grp->int2 = 2;
1348		1255
1349	aio_grp_feed (grp);	1256	eio_grp_limit (grp, grp->int2);
1350	}	1257	}
1351		1258

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines