ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/IO-AIO/AIO.xs
(Generate patch)

Comparing IO-AIO/AIO.xs (file contents):
Revision 1.15 by root, Sat Jul 23 18:19:56 2005 UTC vs.
Revision 1.138 by root, Tue Apr 21 20:06:05 2009 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines