ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/EV/EV.xs
Revision: 1.134
Committed: Fri Sep 18 21:28:33 2009 UTC (14 years, 7 months ago) by root
Branch: MAIN
Changes since 1.133: +4 -1 lines
Log Message:
*** empty log message ***

File Contents

# Content
1 #include "EXTERN.h"
2 #include "perl.h"
3 #include "XSUB.h"
4
5 /* fix perl api breakage */
6 #undef signal
7 #undef sigaction
8
9 #include "schmorp.h"
10
11 /* old API compatibility */
12 static int
13 sv_fileno (SV *fh)
14 {
15 return s_fileno (fh, 0);
16 }
17
18 #define EV_PROTOTYPES 1
19 #define EV_USE_NANOSLEEP EV_USE_MONOTONIC
20 #define EV_H <ev.h>
21 #include "EV/EVAPI.h"
22
23 #define EV_SELECT_IS_WINSOCKET 0
24 #ifdef _WIN32
25 # define EV_SELECT_USE_FD_SET 0
26 # define NFDBITS PERL_NFDBITS
27 # define fd_mask Perl_fd_mask
28 #endif
29 /* due to bugs in OS X we have to use libev/ explicitly here */
30 #include "libev/ev.c"
31
32 #ifndef _WIN32
33 # include <pthread.h>
34 #endif
35
36 #define e_loop(w) INT2PTR (struct ev_loop *, SvIVX ((w)->loop))
37
38 #define WFLAG_KEEPALIVE 1
39 #define WFLAG_UNREFED 2 /* has been unref'ed */
40
41 #define UNREF(w) \
42 if (!((w)->e_flags & (WFLAG_KEEPALIVE | WFLAG_UNREFED)) \
43 && ev_is_active (w)) \
44 { \
45 ev_unref (e_loop (w)); \
46 (w)->e_flags |= WFLAG_UNREFED; \
47 }
48
49 #define REF(w) \
50 if ((w)->e_flags & WFLAG_UNREFED) \
51 { \
52 (w)->e_flags &= ~WFLAG_UNREFED; \
53 ev_ref (e_loop (w)); \
54 }
55
56 #define START(type,w) \
57 do { \
58 ev_ ## type ## _start (e_loop (w), w); \
59 UNREF (w); \
60 } while (0)
61
62 #define STOP(type,w) \
63 do { \
64 REF (w); \
65 ev_ ## type ## _stop (e_loop (w), w); \
66 } while (0)
67
68 #define RESET(type,w,seta) \
69 do { \
70 int active = ev_is_active (w); \
71 if (active) STOP (type, w); \
72 ev_ ## type ## _set seta; \
73 if (active) START (type, w); \
74 } while (0)
75
76 typedef int Signal;
77
78 /* horrible... */
79 #define CHECK_SIGNAL_CAN_START(w) \
80 do { \
81 /* dive into the internals of libev to avoid aborting in libev */ \
82 if (signals [(w)->signum - 1].loop \
83 && signals [(w)->signum - 1].loop != e_loop (w)) \
84 croak ("unable to start signal watcher, signal %d already registered in another loop", w->signum); \
85 } while (0)
86
87 #define START_SIGNAL(w) \
88 do { \
89 CHECK_SIGNAL_CAN_START (w); \
90 START (signal, w); \
91 } while (0) \
92
93 #define RESET_SIGNAL(w,seta) \
94 do { \
95 int active = ev_is_active (w); \
96 if (active) STOP (signal, w); \
97 ev_ ## signal ## _set seta; \
98 if (active) START_SIGNAL (w); \
99 } while (0)
100
101 static SV *default_loop_sv;
102
103 static struct EVAPI evapi;
104
105 static HV
106 *stash_loop,
107 *stash_watcher,
108 *stash_io,
109 *stash_timer,
110 *stash_periodic,
111 *stash_signal,
112 *stash_child,
113 *stash_stat,
114 *stash_idle,
115 *stash_prepare,
116 *stash_check,
117 *stash_embed,
118 *stash_fork,
119 *stash_async;
120
121 /////////////////////////////////////////////////////////////////////////////
122 // Event
123
124 static void e_cb (EV_P_ ev_watcher *w, int revents);
125
126 static void *
127 e_new (int size, SV *cb_sv, SV *loop)
128 {
129 SV *cv = cb_sv ? s_get_cv_croak (cb_sv) : 0;
130 ev_watcher *w;
131 SV *self = NEWSV (0, size);
132 SvPOK_only (self);
133 SvCUR_set (self, size);
134
135 w = (ev_watcher *)SvPVX (self);
136
137 ev_init (w, cv ? e_cb : 0);
138
139 w->loop = SvREFCNT_inc (SvRV (loop));
140 w->e_flags = WFLAG_KEEPALIVE;
141 w->data = 0;
142 w->fh = 0;
143 w->cb_sv = SvREFCNT_inc (cv);
144 w->self = self;
145
146 return (void *)w;
147 }
148
149 static void
150 e_destroy (void *w_)
151 {
152 ev_watcher *w = (ev_watcher *)w_;
153
154 SvREFCNT_dec (w->loop ); w->loop = 0;
155 SvREFCNT_dec (w->fh ); w->fh = 0;
156 SvREFCNT_dec (w->cb_sv); w->cb_sv = 0;
157 SvREFCNT_dec (w->data ); w->data = 0;
158 }
159
160 static SV *
161 e_bless (ev_watcher *w, HV *stash)
162 {
163 SV *rv;
164
165 if (SvOBJECT (w->self))
166 rv = newRV_inc (w->self);
167 else
168 {
169 rv = newRV_noinc (w->self);
170 sv_bless (rv, stash);
171 SvREADONLY_on (w->self);
172 }
173
174 return rv;
175 }
176
177 static SV *sv_self_cache, *sv_events_cache;
178
179 static void
180 e_cb (EV_P_ ev_watcher *w, int revents)
181 {
182 dSP;
183 I32 mark = SP - PL_stack_base;
184 SV *sv_self, *sv_events;
185
186 /* libev might have stopped the watcher */
187 if (expect_false (w->e_flags & WFLAG_UNREFED)
188 && !ev_is_active (w))
189 REF (w);
190
191 if (expect_true (sv_self_cache))
192 {
193 sv_self = sv_self_cache; sv_self_cache = 0;
194 SvRV_set (sv_self, SvREFCNT_inc_NN (w->self));
195 }
196 else
197 {
198 sv_self = newRV_inc (w->self); /* w->self MUST be blessed by now */
199 SvREADONLY_on (sv_self);
200 }
201
202 if (expect_true (sv_events_cache))
203 {
204 sv_events = sv_events_cache; sv_events_cache = 0;
205 SvIV_set (sv_events, revents);
206 }
207 else
208 {
209 sv_events = newSViv (revents);
210 SvREADONLY_on (sv_events);
211 }
212
213 PUSHMARK (SP);
214 EXTEND (SP, 2);
215 PUSHs (sv_self);
216 PUSHs (sv_events);
217
218 PUTBACK;
219 call_sv (w->cb_sv, G_DISCARD | G_VOID | G_EVAL);
220
221 if (expect_false (SvREFCNT (sv_self) != 1 || sv_self_cache))
222 SvREFCNT_dec (sv_self);
223 else
224 {
225 SvREFCNT_dec (SvRV (sv_self));
226 SvRV_set (sv_self, &PL_sv_undef);
227 sv_self_cache = sv_self;
228 }
229
230 if (expect_false (SvREFCNT (sv_events) != 1 || sv_events_cache))
231 SvREFCNT_dec (sv_events);
232 else
233 sv_events_cache = sv_events;
234
235 if (expect_false (SvTRUE (ERRSV)))
236 {
237 SPAGAIN;
238 PUSHMARK (SP);
239 PUTBACK;
240 call_sv (get_sv ("EV::DIED", 1), G_DISCARD | G_VOID | G_EVAL | G_KEEPERR);
241 }
242
243 SP = PL_stack_base + mark;
244 PUTBACK;
245 }
246
247 static void
248 e_once_cb (int revents, void *arg)
249 {
250 dSP;
251 I32 mark = SP - PL_stack_base;
252 SV *sv_events;
253
254 if (sv_events_cache)
255 {
256 sv_events = sv_events_cache; sv_events_cache = 0;
257 SvIV_set (sv_events, revents);
258 }
259 else
260 sv_events = newSViv (revents);
261
262 PUSHMARK (SP);
263 XPUSHs (sv_events);
264
265 PUTBACK;
266 call_sv ((SV *)arg, G_DISCARD | G_VOID | G_EVAL);
267
268 SvREFCNT_dec ((SV *)arg);
269
270 if (sv_events_cache)
271 SvREFCNT_dec (sv_events);
272 else
273 sv_events_cache = sv_events;
274
275 if (SvTRUE (ERRSV))
276 {
277 SPAGAIN;
278 PUSHMARK (SP);
279 PUTBACK;
280 call_sv (get_sv ("EV::DIED", 1), G_DISCARD | G_VOID | G_EVAL | G_KEEPERR);
281 }
282
283 SP = PL_stack_base + mark;
284 PUTBACK;
285 }
286
287 static ev_tstamp
288 e_periodic_cb (ev_periodic *w, ev_tstamp now)
289 {
290 ev_tstamp retval;
291 int count;
292 dSP;
293
294 ENTER;
295 SAVETMPS;
296
297 PUSHMARK (SP);
298 EXTEND (SP, 2);
299 PUSHs (newRV_inc (w->self)); /* w->self MUST be blessed by now */
300 PUSHs (newSVnv (now));
301
302 PUTBACK;
303 count = call_sv (w->fh, G_SCALAR | G_EVAL);
304 SPAGAIN;
305
306 if (SvTRUE (ERRSV))
307 {
308 PUSHMARK (SP);
309 PUTBACK;
310 call_sv (get_sv ("EV::DIED", 1), G_DISCARD | G_VOID | G_EVAL | G_KEEPERR);
311 SPAGAIN;
312 }
313
314 if (count > 0)
315 {
316 retval = SvNV (TOPs);
317
318 if (retval < now)
319 retval = now;
320 }
321 else
322 retval = now;
323
324 FREETMPS;
325 LEAVE;
326
327 return retval;
328 }
329
330 #define CHECK_REPEAT(repeat) if (repeat < 0.) \
331 croak (# repeat " value must be >= 0");
332
333 #define CHECK_FD(fh,fd) if ((fd) < 0) \
334 croak ("illegal file descriptor or filehandle (either no attached file descriptor or illegal value): %s", SvPV_nolen (fh));
335
336 #define CHECK_SIG(sv,num) if ((num) < 0) \
337 croak ("illegal signal number or name: %s", SvPV_nolen (sv));
338
339 /////////////////////////////////////////////////////////////////////////////
340 // XS interface functions
341
342 MODULE = EV PACKAGE = EV PREFIX = ev_
343
344 PROTOTYPES: ENABLE
345
346 BOOT:
347 {
348 HV *stash = gv_stashpv ("EV", 1);
349
350 static const struct {
351 const char *name;
352 IV iv;
353 } *civ, const_iv[] = {
354 # define const_iv(pfx, name) { # name, (IV) pfx ## name },
355 const_iv (EV_, MINPRI)
356 const_iv (EV_, MAXPRI)
357
358 const_iv (EV_, UNDEF)
359 const_iv (EV_, NONE)
360 const_iv (EV_, READ)
361 const_iv (EV_, WRITE)
362 const_iv (EV_, IO)
363 const_iv (EV_, TIMEOUT)
364 const_iv (EV_, TIMER)
365 const_iv (EV_, PERIODIC)
366 const_iv (EV_, SIGNAL)
367 const_iv (EV_, CHILD)
368 const_iv (EV_, STAT)
369 const_iv (EV_, IDLE)
370 const_iv (EV_, PREPARE)
371 const_iv (EV_, CHECK)
372 const_iv (EV_, EMBED)
373 const_iv (EV_, FORK)
374 const_iv (EV_, ASYNC)
375 const_iv (EV_, CUSTOM)
376 const_iv (EV_, ERROR)
377
378 const_iv (EV, LOOP_NONBLOCK)
379 const_iv (EV, LOOP_ONESHOT)
380
381 const_iv (EV, UNLOOP_CANCEL)
382 const_iv (EV, UNLOOP_ONE)
383 const_iv (EV, UNLOOP_ALL)
384
385 const_iv (EV, BACKEND_SELECT)
386 const_iv (EV, BACKEND_POLL)
387 const_iv (EV, BACKEND_EPOLL)
388 const_iv (EV, BACKEND_KQUEUE)
389 const_iv (EV, BACKEND_DEVPOLL)
390 const_iv (EV, BACKEND_PORT)
391 const_iv (EV, BACKEND_ALL)
392 const_iv (EV, FLAG_AUTO)
393 const_iv (EV, FLAG_FORKCHECK)
394 const_iv (EV, FLAG_NOENV)
395 const_iv (EV, FLAG_NOSIGFD)
396 const_iv (EV, FLAG_NOINOTIFY)
397
398 const_iv (EV_, VERSION_MAJOR)
399 const_iv (EV_, VERSION_MINOR)
400 };
401
402 for (civ = const_iv + sizeof (const_iv) / sizeof (const_iv [0]); civ-- > const_iv; )
403 newCONSTSUB (stash, (char *)civ->name, newSViv (civ->iv));
404
405 stash_loop = gv_stashpv ("EV::Loop" , 1);
406 stash_watcher = gv_stashpv ("EV::Watcher" , 1);
407 stash_io = gv_stashpv ("EV::IO" , 1);
408 stash_timer = gv_stashpv ("EV::Timer" , 1);
409 stash_periodic = gv_stashpv ("EV::Periodic", 1);
410 stash_signal = gv_stashpv ("EV::Signal" , 1);
411 stash_idle = gv_stashpv ("EV::Idle" , 1);
412 stash_prepare = gv_stashpv ("EV::Prepare" , 1);
413 stash_check = gv_stashpv ("EV::Check" , 1);
414 stash_child = gv_stashpv ("EV::Child" , 1);
415 stash_embed = gv_stashpv ("EV::Embed" , 1);
416 stash_stat = gv_stashpv ("EV::Stat" , 1);
417 stash_fork = gv_stashpv ("EV::Fork" , 1);
418 stash_async = gv_stashpv ("EV::Async" , 1);
419
420 {
421 SV *sv = perl_get_sv ("EV::API", TRUE);
422 perl_get_sv ("EV::API", TRUE); /* silence 5.10 warning */
423
424 /* the poor man's shared library emulator */
425 evapi.ver = EV_API_VERSION;
426 evapi.rev = EV_API_REVISION;
427 evapi.sv_fileno = sv_fileno;
428 evapi.sv_signum = s_signum;
429 evapi.supported_backends = ev_supported_backends ();
430 evapi.recommended_backends = ev_recommended_backends ();
431 evapi.embeddable_backends = ev_embeddable_backends ();
432 evapi.time_ = ev_time;
433 evapi.sleep_ = ev_sleep;
434 evapi.loop_new = ev_loop_new;
435 evapi.loop_destroy = ev_loop_destroy;
436 evapi.loop_fork = ev_loop_fork;
437 evapi.loop_count = ev_loop_count;
438 evapi.loop_depth = ev_loop_depth;
439 evapi.set_userdata = ev_set_userdata;
440 evapi.userdata = ev_userdata;
441 evapi.now = ev_now;
442 evapi.now_update = ev_now_update;
443 evapi.suspend = ev_suspend;
444 evapi.resume = ev_resume;
445 evapi.backend = ev_backend;
446 evapi.unloop = ev_unloop;
447 evapi.invoke_pending = ev_invoke_pending;
448 evapi.pending_count = ev_pending_count;
449 evapi.set_loop_release_cb = ev_set_loop_release_cb;
450 evapi.set_invoke_pending_cb= ev_set_invoke_pending_cb;
451 evapi.ref = ev_ref;
452 evapi.unref = ev_unref;
453 evapi.loop = ev_loop;
454 evapi.once = ev_once;
455 evapi.io_start = ev_io_start;
456 evapi.io_stop = ev_io_stop;
457 evapi.timer_start = ev_timer_start;
458 evapi.timer_stop = ev_timer_stop;
459 evapi.timer_again = ev_timer_again;
460 evapi.timer_remaining = ev_timer_remaining;
461 evapi.periodic_start = ev_periodic_start;
462 evapi.periodic_stop = ev_periodic_stop;
463 evapi.signal_start = ev_signal_start;
464 evapi.signal_stop = ev_signal_stop;
465 evapi.idle_start = ev_idle_start;
466 evapi.idle_stop = ev_idle_stop;
467 evapi.prepare_start = ev_prepare_start;
468 evapi.prepare_stop = ev_prepare_stop;
469 evapi.check_start = ev_check_start;
470 evapi.check_stop = ev_check_stop;
471 evapi.child_start = ev_child_start;
472 evapi.child_stop = ev_child_stop;
473 evapi.stat_start = ev_stat_start;
474 evapi.stat_stop = ev_stat_stop;
475 evapi.stat_stat = ev_stat_stat;
476 evapi.embed_start = ev_embed_start;
477 evapi.embed_stop = ev_embed_stop;
478 evapi.embed_sweep = ev_embed_sweep;
479 evapi.fork_start = ev_fork_start;
480 evapi.fork_stop = ev_fork_stop;
481 evapi.async_start = ev_async_start;
482 evapi.async_stop = ev_async_stop;
483 evapi.async_send = ev_async_send;
484 evapi.clear_pending = ev_clear_pending;
485 evapi.invoke = ev_invoke;
486
487 sv_setiv (sv, (IV)&evapi);
488 SvREADONLY_on (sv);
489 }
490 #ifndef _WIN32
491 pthread_atfork (0, 0, ev_default_fork);
492 #endif
493 }
494
495 SV *ev_default_loop (unsigned int flags = 0)
496 CODE:
497 {
498 if (!default_loop_sv)
499 {
500 evapi.default_loop = ev_default_loop (flags);
501
502 if (!evapi.default_loop)
503 XSRETURN_UNDEF;
504
505 default_loop_sv = sv_bless (newRV_noinc (newSViv (PTR2IV (evapi.default_loop))), stash_loop);
506 }
507
508 RETVAL = newSVsv (default_loop_sv);
509 }
510 OUTPUT:
511 RETVAL
512
513 void ev_default_destroy ()
514 CODE:
515 ev_default_destroy ();
516 SvREFCNT_dec (default_loop_sv);
517 default_loop_sv = 0;
518
519 unsigned int ev_supported_backends ()
520
521 unsigned int ev_recommended_backends ()
522
523 unsigned int ev_embeddable_backends ()
524
525 void ev_sleep (NV interval)
526
527 NV ev_time ()
528
529 NV ev_now ()
530 C_ARGS: evapi.default_loop
531
532 void ev_now_update ()
533 C_ARGS: evapi.default_loop
534
535 void ev_suspend ()
536 C_ARGS: evapi.default_loop
537
538 void ev_resume ()
539 C_ARGS: evapi.default_loop
540
541 unsigned int ev_backend ()
542 C_ARGS: evapi.default_loop
543
544 void ev_loop_verify ()
545 C_ARGS: evapi.default_loop
546
547 unsigned int ev_loop_count ()
548 C_ARGS: evapi.default_loop
549
550 unsigned int ev_loop_depth ()
551 C_ARGS: evapi.default_loop
552
553 void ev_set_io_collect_interval (NV interval)
554 C_ARGS: evapi.default_loop, interval
555
556 void ev_set_timeout_collect_interval (NV interval)
557 C_ARGS: evapi.default_loop, interval
558
559 void ev_loop (int flags = 0)
560 C_ARGS: evapi.default_loop, flags
561
562 void ev_unloop (int how = EVUNLOOP_ONE)
563 C_ARGS: evapi.default_loop, how
564
565 void ev_feed_fd_event (int fd, int revents = EV_NONE)
566 C_ARGS: evapi.default_loop, fd, revents
567
568 void ev_feed_signal_event (SV *signal)
569 CODE:
570 {
571 Signal signum = s_signum (signal);
572 CHECK_SIG (signal, signum);
573
574 ev_feed_signal_event (evapi.default_loop, signum);
575 }
576
577 unsigned int ev_pending_count ()
578 C_ARGS: evapi.default_loop
579
580 void ev_invoke_pending ()
581 C_ARGS: evapi.default_loop
582
583 ev_io *io (SV *fh, int events, SV *cb)
584 ALIAS:
585 io_ns = 1
586 _ae_io = 2
587 CODE:
588 {
589 int fd = s_fileno (fh, events & EV_WRITE);
590 CHECK_FD (fh, fd);
591
592 if (ix == 2)
593 {
594 ix = 0;
595 events = events ? EV_WRITE : EV_READ;
596 }
597
598 RETVAL = e_new (sizeof (ev_io), cb, default_loop_sv);
599 RETVAL->fh = newSVsv (fh);
600 ev_io_set (RETVAL, fd, events);
601 if (!ix) START (io, RETVAL);
602 }
603 OUTPUT:
604 RETVAL
605
606 ev_timer *timer (NV after, NV repeat, SV *cb)
607 ALIAS:
608 timer_ns = 1
609 INIT:
610 CHECK_REPEAT (repeat);
611 CODE:
612 RETVAL = e_new (sizeof (ev_timer), cb, default_loop_sv);
613 ev_timer_set (RETVAL, after, repeat);
614 if (!ix) START (timer, RETVAL);
615 OUTPUT:
616 RETVAL
617
618 SV *periodic (NV at, NV interval, SV *reschedule_cb, SV *cb)
619 ALIAS:
620 periodic_ns = 1
621 INIT:
622 CHECK_REPEAT (interval);
623 CODE:
624 {
625 ev_periodic *w;
626 w = e_new (sizeof (ev_periodic), cb, default_loop_sv);
627 w->fh = SvTRUE (reschedule_cb) ? newSVsv (reschedule_cb) : 0;
628 ev_periodic_set (w, at, interval, w->fh ? e_periodic_cb : 0);
629 RETVAL = e_bless ((ev_watcher *)w, stash_periodic);
630 if (!ix) START (periodic, w);
631 }
632 OUTPUT:
633 RETVAL
634
635 ev_signal *signal (SV *signal, SV *cb)
636 ALIAS:
637 signal_ns = 1
638 CODE:
639 {
640 Signal signum = s_signum (signal);
641 CHECK_SIG (signal, signum);
642
643 RETVAL = e_new (sizeof (ev_signal), cb, default_loop_sv);
644 ev_signal_set (RETVAL, signum);
645 if (!ix) START_SIGNAL (RETVAL);
646 }
647 OUTPUT:
648 RETVAL
649
650 ev_idle *idle (SV *cb)
651 ALIAS:
652 idle_ns = 1
653 CODE:
654 RETVAL = e_new (sizeof (ev_idle), cb, default_loop_sv);
655 ev_idle_set (RETVAL);
656 if (!ix) START (idle, RETVAL);
657 OUTPUT:
658 RETVAL
659
660 ev_prepare *prepare (SV *cb)
661 ALIAS:
662 prepare_ns = 1
663 CODE:
664 RETVAL = e_new (sizeof (ev_prepare), cb, default_loop_sv);
665 ev_prepare_set (RETVAL);
666 if (!ix) START (prepare, RETVAL);
667 OUTPUT:
668 RETVAL
669
670 ev_check *check (SV *cb)
671 ALIAS:
672 check_ns = 1
673 CODE:
674 RETVAL = e_new (sizeof (ev_check), cb, default_loop_sv);
675 ev_check_set (RETVAL);
676 if (!ix) START (check, RETVAL);
677 OUTPUT:
678 RETVAL
679
680 ev_fork *fork (SV *cb)
681 ALIAS:
682 fork_ns = 1
683 CODE:
684 RETVAL = e_new (sizeof (ev_fork), cb, default_loop_sv);
685 ev_fork_set (RETVAL);
686 if (!ix) START (fork, RETVAL);
687 OUTPUT:
688 RETVAL
689
690 ev_child *child (int pid, int trace, SV *cb)
691 ALIAS:
692 child_ns = 1
693 CODE:
694 RETVAL = e_new (sizeof (ev_child), cb, default_loop_sv);
695 ev_child_set (RETVAL, pid, trace);
696 if (!ix) START (child, RETVAL);
697 OUTPUT:
698 RETVAL
699
700 ev_stat *stat (SV *path, NV interval, SV *cb)
701 ALIAS:
702 stat_ns = 1
703 CODE:
704 RETVAL = e_new (sizeof (ev_stat), cb, default_loop_sv);
705 RETVAL->fh = newSVsv (path);
706 ev_stat_set (RETVAL, SvPVbyte_nolen (RETVAL->fh), interval);
707 if (!ix) START (stat, RETVAL);
708 OUTPUT:
709 RETVAL
710
711 ev_embed *embed (struct ev_loop *loop, SV *cb = 0)
712 ALIAS:
713 embed_ns = 1
714 CODE:
715 {
716 if (!(ev_backend (loop) & ev_embeddable_backends ()))
717 croak ("passed loop is not embeddable via EV::embed,");
718
719 RETVAL = e_new (sizeof (ev_embed), cb, default_loop_sv);
720 RETVAL->fh = newSVsv (ST (0));
721 ev_embed_set (RETVAL, loop);
722 if (!ix) START (embed, RETVAL);
723 }
724 OUTPUT:
725 RETVAL
726
727 ev_async *async (SV *cb)
728 ALIAS:
729 async_ns = 1
730 CODE:
731 RETVAL = e_new (sizeof (ev_async), cb, default_loop_sv);
732 ev_async_set (RETVAL);
733 if (!ix) START (async, RETVAL);
734 OUTPUT:
735 RETVAL
736
737 void once (SV *fh, int events, SV *timeout, SV *cb)
738 CODE:
739 ev_once (
740 evapi.default_loop,
741 s_fileno (fh, events & EV_WRITE), events,
742 SvOK (timeout) ? SvNV (timeout) : -1.,
743 e_once_cb,
744 newSVsv (cb)
745 );
746
747 PROTOTYPES: DISABLE
748
749 MODULE = EV PACKAGE = EV::Watcher PREFIX = ev_
750
751 int ev_is_active (ev_watcher *w)
752
753 int ev_is_pending (ev_watcher *w)
754
755 void ev_invoke (ev_watcher *w, int revents = EV_NONE)
756 C_ARGS: e_loop (w), w, revents
757
758 int ev_clear_pending (ev_watcher *w)
759 C_ARGS: e_loop (w), w
760
761 void ev_feed_event (ev_watcher *w, int revents = EV_NONE)
762 C_ARGS: e_loop (w), w, revents
763
764 int keepalive (ev_watcher *w, int new_value = 0)
765 CODE:
766 {
767 RETVAL = w->e_flags & WFLAG_KEEPALIVE;
768 new_value = new_value ? WFLAG_KEEPALIVE : 0;
769
770 if (items > 1 && ((new_value ^ w->e_flags) & WFLAG_KEEPALIVE))
771 {
772 w->e_flags = (w->e_flags & ~WFLAG_KEEPALIVE) | new_value;
773 REF (w);
774 UNREF (w);
775 }
776 }
777 OUTPUT:
778 RETVAL
779
780 SV *cb (ev_watcher *w, SV *new_cb = 0)
781 CODE:
782 {
783 if (items > 1)
784 {
785 new_cb = s_get_cv_croak (new_cb);
786 RETVAL = newRV_noinc (w->cb_sv);
787 w->cb_sv = SvREFCNT_inc (new_cb);
788 }
789 else
790 RETVAL = newRV_inc (w->cb_sv);
791 }
792 OUTPUT:
793 RETVAL
794
795 SV *data (ev_watcher *w, SV *new_data = 0)
796 CODE:
797 {
798 RETVAL = w->data ? newSVsv (w->data) : &PL_sv_undef;
799
800 if (items > 1)
801 {
802 SvREFCNT_dec (w->data);
803 w->data = newSVsv (new_data);
804 }
805 }
806 OUTPUT:
807 RETVAL
808
809 SV *loop (ev_watcher *w)
810 CODE:
811 RETVAL = newRV_inc (w->loop);
812 OUTPUT:
813 RETVAL
814
815 int priority (ev_watcher *w, int new_priority = 0)
816 CODE:
817 {
818 RETVAL = w->priority;
819
820 if (items > 1)
821 {
822 int active = ev_is_active (w);
823
824 if (active)
825 {
826 /* grrr. */
827 PUSHMARK (SP);
828 XPUSHs (ST (0));
829 PUTBACK;
830 call_method ("stop", G_DISCARD | G_VOID);
831 }
832
833 ev_set_priority (w, new_priority);
834
835 if (active)
836 {
837 PUSHMARK (SP);
838 XPUSHs (ST (0));
839 PUTBACK;
840 call_method ("start", G_DISCARD | G_VOID);
841 }
842 }
843 }
844 OUTPUT:
845 RETVAL
846
847 MODULE = EV PACKAGE = EV::IO PREFIX = ev_io_
848
849 void ev_io_start (ev_io *w)
850 CODE:
851 START (io, w);
852
853 void ev_io_stop (ev_io *w)
854 CODE:
855 STOP (io, w);
856
857 void DESTROY (ev_io *w)
858 CODE:
859 STOP (io, w);
860 e_destroy (w);
861
862 void set (ev_io *w, SV *fh, int events)
863 CODE:
864 {
865 int fd = s_fileno (fh, events & EV_WRITE);
866 CHECK_FD (fh, fd);
867
868 sv_setsv (w->fh, fh);
869 RESET (io, w, (w, fd, events));
870 }
871
872 SV *fh (ev_io *w, SV *new_fh = 0)
873 CODE:
874 {
875 if (items > 1)
876 {
877 int fd = s_fileno (new_fh, w->events & EV_WRITE);
878 CHECK_FD (new_fh, fd);
879
880 RETVAL = w->fh;
881 w->fh = newSVsv (new_fh);
882
883 RESET (io, w, (w, fd, w->events));
884 }
885 else
886 RETVAL = newSVsv (w->fh);
887 }
888 OUTPUT:
889 RETVAL
890
891 int events (ev_io *w, int new_events = EV_UNDEF)
892 CODE:
893 {
894 RETVAL = w->events;
895
896 if (items > 1)
897 RESET (io, w, (w, w->fd, new_events));
898 }
899 OUTPUT:
900 RETVAL
901
902 MODULE = EV PACKAGE = EV::Signal PREFIX = ev_signal_
903
904 void ev_signal_start (ev_signal *w)
905 CODE:
906 START_SIGNAL (w);
907
908 void ev_signal_stop (ev_signal *w)
909 CODE:
910 STOP (signal, w);
911
912 void DESTROY (ev_signal *w)
913 CODE:
914 STOP (signal, w);
915 e_destroy (w);
916
917 void set (ev_signal *w, SV *signal)
918 CODE:
919 {
920 Signal signum = s_signum (signal);
921 CHECK_SIG (signal, signum);
922
923 RESET_SIGNAL (w, (w, signum));
924 }
925
926 int signal (ev_signal *w, SV *new_signal = 0)
927 CODE:
928 {
929 RETVAL = w->signum;
930
931 if (items > 1)
932 {
933 Signal signum = s_signum (new_signal);
934 CHECK_SIG (new_signal, signum);
935
936 RESET_SIGNAL (w, (w, signum));
937 }
938 }
939 OUTPUT:
940 RETVAL
941
942 MODULE = EV PACKAGE = EV::Timer PREFIX = ev_timer_
943
944 void ev_timer_start (ev_timer *w)
945 INIT:
946 CHECK_REPEAT (w->repeat);
947 CODE:
948 START (timer, w);
949
950 void ev_timer_stop (ev_timer *w)
951 CODE:
952 STOP (timer, w);
953
954 void ev_timer_again (ev_timer *w)
955 INIT:
956 CHECK_REPEAT (w->repeat);
957 CODE:
958 ev_timer_again (e_loop (w), w);
959 UNREF (w);
960
961 NV ev_timer_remaining (ev_timer *w)
962 C_ARGS: e_loop (w), w
963
964 void DESTROY (ev_timer *w)
965 CODE:
966 STOP (timer, w);
967 e_destroy (w);
968
969 void set (ev_timer *w, NV after, NV repeat = 0.)
970 INIT:
971 CHECK_REPEAT (repeat);
972 CODE:
973 RESET (timer, w, (w, after, repeat));
974
975 MODULE = EV PACKAGE = EV::Periodic PREFIX = ev_periodic_
976
977 void ev_periodic_start (ev_periodic *w)
978 INIT:
979 CHECK_REPEAT (w->interval);
980 CODE:
981 START (periodic, w);
982
983 void ev_periodic_stop (ev_periodic *w)
984 CODE:
985 STOP (periodic, w);
986
987 void ev_periodic_again (ev_periodic *w)
988 CODE:
989 ev_periodic_again (e_loop (w), w);
990 UNREF (w);
991
992 void DESTROY (ev_periodic *w)
993 CODE:
994 STOP (periodic, w);
995 e_destroy (w);
996
997 void set (ev_periodic *w, NV at, NV interval = 0., SV *reschedule_cb = &PL_sv_undef)
998 INIT:
999 CHECK_REPEAT (interval);
1000 CODE:
1001 {
1002 SvREFCNT_dec (w->fh);
1003 w->fh = SvTRUE (reschedule_cb) ? newSVsv (reschedule_cb) : 0;
1004
1005 RESET (periodic, w, (w, at, interval, w->fh ? e_periodic_cb : 0));
1006 }
1007
1008 NV at (ev_periodic *w)
1009 CODE:
1010 RETVAL = ev_periodic_at (w);
1011 OUTPUT:
1012 RETVAL
1013
1014 MODULE = EV PACKAGE = EV::Idle PREFIX = ev_idle_
1015
1016 void ev_idle_start (ev_idle *w)
1017 CODE:
1018 START (idle, w);
1019
1020 void ev_idle_stop (ev_idle *w)
1021 CODE:
1022 STOP (idle, w);
1023
1024 void DESTROY (ev_idle *w)
1025 CODE:
1026 STOP (idle, w);
1027 e_destroy (w);
1028
1029 MODULE = EV PACKAGE = EV::Prepare PREFIX = ev_prepare_
1030
1031 void ev_prepare_start (ev_prepare *w)
1032 CODE:
1033 START (prepare, w);
1034
1035 void ev_prepare_stop (ev_prepare *w)
1036 CODE:
1037 STOP (prepare, w);
1038
1039 void DESTROY (ev_prepare *w)
1040 CODE:
1041 STOP (prepare, w);
1042 e_destroy (w);
1043
1044 MODULE = EV PACKAGE = EV::Check PREFIX = ev_check_
1045
1046 void ev_check_start (ev_check *w)
1047 CODE:
1048 START (check, w);
1049
1050 void ev_check_stop (ev_check *w)
1051 CODE:
1052 STOP (check, w);
1053
1054 void DESTROY (ev_check *w)
1055 CODE:
1056 STOP (check, w);
1057 e_destroy (w);
1058
1059 MODULE = EV PACKAGE = EV::Fork PREFIX = ev_fork_
1060
1061 void ev_fork_start (ev_fork *w)
1062 CODE:
1063 START (fork, w);
1064
1065 void ev_fork_stop (ev_fork *w)
1066 CODE:
1067 STOP (fork, w);
1068
1069 void DESTROY (ev_fork *w)
1070 CODE:
1071 STOP (fork, w);
1072 e_destroy (w);
1073
1074 MODULE = EV PACKAGE = EV::Child PREFIX = ev_child_
1075
1076 void ev_child_start (ev_child *w)
1077 CODE:
1078 START (child, w);
1079
1080 void ev_child_stop (ev_child *w)
1081 CODE:
1082 STOP (child, w);
1083
1084 void DESTROY (ev_child *w)
1085 CODE:
1086 STOP (child, w);
1087 e_destroy (w);
1088
1089 void set (ev_child *w, int pid, int trace)
1090 CODE:
1091 RESET (child, w, (w, pid, trace));
1092
1093 int pid (ev_child *w)
1094 ALIAS:
1095 rpid = 1
1096 rstatus = 2
1097 CODE:
1098 RETVAL = ix == 0 ? w->pid
1099 : ix == 1 ? w->rpid
1100 : w->rstatus;
1101 OUTPUT:
1102 RETVAL
1103
1104 MODULE = EV PACKAGE = EV::Stat PREFIX = ev_stat_
1105
1106 void ev_stat_start (ev_stat *w)
1107 CODE:
1108 START (stat, w);
1109
1110 void ev_stat_stop (ev_stat *w)
1111 CODE:
1112 STOP (stat, w);
1113
1114 void DESTROY (ev_stat *w)
1115 CODE:
1116 STOP (stat, w);
1117 e_destroy (w);
1118
1119 void set (ev_stat *w, SV *path, NV interval)
1120 CODE:
1121 {
1122 sv_setsv (w->fh, path);
1123 RESET (stat, w, (w, SvPVbyte_nolen (w->fh), interval));
1124 }
1125
1126 SV *path (ev_stat *w, SV *new_path = 0)
1127 CODE:
1128 {
1129 RETVAL = SvREFCNT_inc (w->fh);
1130
1131 if (items > 1)
1132 {
1133 SvREFCNT_dec (w->fh);
1134 w->fh = newSVsv (new_path);
1135 RESET (stat, w, (w, SvPVbyte_nolen (w->fh), w->interval));
1136 }
1137 }
1138 OUTPUT:
1139 RETVAL
1140
1141 NV interval (ev_stat *w, NV new_interval = 0.)
1142 CODE:
1143 {
1144 RETVAL = w->interval;
1145
1146 if (items > 1)
1147 RESET (stat, w, (w, SvPVbyte_nolen (w->fh), new_interval));
1148 }
1149 OUTPUT:
1150 RETVAL
1151
1152 void prev (ev_stat *w)
1153 ALIAS:
1154 stat = 1
1155 attr = 2
1156 PPCODE:
1157 {
1158 ev_statdata *s = ix ? &w->attr : &w->prev;
1159
1160 if (ix == 1)
1161 ev_stat_stat (e_loop (w), w);
1162 else if (!s->st_nlink)
1163 errno = ENOENT;
1164
1165 PL_statcache.st_dev = s->st_nlink;
1166 PL_statcache.st_ino = s->st_ino;
1167 PL_statcache.st_mode = s->st_mode;
1168 PL_statcache.st_nlink = s->st_nlink;
1169 PL_statcache.st_uid = s->st_uid;
1170 PL_statcache.st_gid = s->st_gid;
1171 PL_statcache.st_rdev = s->st_rdev;
1172 PL_statcache.st_size = s->st_size;
1173 PL_statcache.st_atime = s->st_atime;
1174 PL_statcache.st_mtime = s->st_mtime;
1175 PL_statcache.st_ctime = s->st_ctime;
1176
1177 if (GIMME_V == G_SCALAR)
1178 XPUSHs (boolSV (s->st_nlink));
1179 else if (GIMME_V == G_ARRAY && s->st_nlink)
1180 {
1181 EXTEND (SP, 13);
1182 PUSHs (sv_2mortal (newSViv (s->st_dev)));
1183 PUSHs (sv_2mortal (newSViv (s->st_ino)));
1184 PUSHs (sv_2mortal (newSVuv (s->st_mode)));
1185 PUSHs (sv_2mortal (newSVuv (s->st_nlink)));
1186 PUSHs (sv_2mortal (newSViv (s->st_uid)));
1187 PUSHs (sv_2mortal (newSViv (s->st_gid)));
1188 PUSHs (sv_2mortal (newSViv (s->st_rdev)));
1189 PUSHs (sv_2mortal (newSVnv ((NV)s->st_size)));
1190 PUSHs (sv_2mortal (newSVnv (s->st_atime)));
1191 PUSHs (sv_2mortal (newSVnv (s->st_mtime)));
1192 PUSHs (sv_2mortal (newSVnv (s->st_ctime)));
1193 PUSHs (sv_2mortal (newSVuv (4096)));
1194 PUSHs (sv_2mortal (newSVnv ((NV)((s->st_size + 4095) / 4096))));
1195 }
1196 }
1197
1198 MODULE = EV PACKAGE = EV::Embed PREFIX = ev_embed_
1199
1200 void ev_embed_start (ev_embed *w)
1201 CODE:
1202 START (embed, w);
1203
1204 void ev_embed_stop (ev_embed *w)
1205 CODE:
1206 STOP (embed, w);
1207
1208 void DESTROY (ev_embed *w)
1209 CODE:
1210 STOP (embed, w);
1211 e_destroy (w);
1212
1213 void set (ev_embed *w, struct ev_loop *loop)
1214 CODE:
1215 {
1216 sv_setsv (w->fh, ST (1));
1217 RESET (embed, w, (w, loop));
1218 }
1219
1220 SV *other (ev_embed *w)
1221 CODE:
1222 RETVAL = newSVsv (w->fh);
1223 OUTPUT:
1224 RETVAL
1225
1226 void ev_embed_sweep (ev_embed *w)
1227 C_ARGS: e_loop (w), w
1228
1229 MODULE = EV PACKAGE = EV::Async PREFIX = ev_async_
1230
1231 void ev_async_start (ev_async *w)
1232 CODE:
1233 START (async, w);
1234
1235 void ev_async_stop (ev_async *w)
1236 CODE:
1237 STOP (async, w);
1238
1239 void DESTROY (ev_async *w)
1240 CODE:
1241 STOP (async, w);
1242 e_destroy (w);
1243
1244 void ev_async_send (ev_async *w)
1245 C_ARGS: e_loop (w), w
1246
1247 SV *ev_async_async_pending (ev_async *w)
1248 CODE:
1249 RETVAL = boolSV (ev_async_pending (w));
1250 OUTPUT:
1251 RETVAL
1252
1253 MODULE = EV PACKAGE = EV::Loop PREFIX = ev_
1254
1255 SV *new (SV *klass, unsigned int flags = 0)
1256 CODE:
1257 {
1258 struct ev_loop *loop = ev_loop_new (flags);
1259
1260 if (!loop)
1261 XSRETURN_UNDEF;
1262
1263 RETVAL = sv_bless (newRV_noinc (newSViv (PTR2IV (loop))), stash_loop);
1264 }
1265 OUTPUT:
1266 RETVAL
1267
1268 void DESTROY (struct ev_loop *loop)
1269 CODE:
1270 if (loop != evapi.default_loop) /* global destruction sucks */
1271 ev_loop_destroy (loop);
1272
1273 void ev_loop_fork (struct ev_loop *loop)
1274
1275 void ev_loop_verify (struct ev_loop *loop)
1276
1277 NV ev_now (struct ev_loop *loop)
1278
1279 void ev_now_update (struct ev_loop *loop)
1280
1281 void ev_suspend (struct ev_loop *loop)
1282
1283 void ev_resume (struct ev_loop *loop)
1284
1285 void ev_set_io_collect_interval (struct ev_loop *loop, NV interval)
1286
1287 void ev_set_timeout_collect_interval (struct ev_loop *loop, NV interval)
1288
1289 unsigned int ev_backend (struct ev_loop *loop)
1290
1291 unsigned int ev_loop_count (struct ev_loop *loop)
1292
1293 unsigned int ev_loop_depth (struct ev_loop *loop)
1294
1295 void ev_loop (struct ev_loop *loop, int flags = 0)
1296
1297 void ev_unloop (struct ev_loop *loop, int how = 1)
1298
1299 void ev_feed_fd_event (struct ev_loop *loop, int fd, int revents = EV_NONE)
1300
1301 unsigned int ev_pending_count (struct ev_loop *loop)
1302
1303 void ev_invoke_pending (struct ev_loop *loop)
1304
1305 #if 0
1306
1307 void ev_feed_signal_event (struct ev_loop *loop, SV *signal)
1308 CODE:
1309 {
1310 Signal signum = s_signum (signal);
1311 CHECK_SIG (signal, signum);
1312
1313 ev_feed_signal_event (loop, signum);
1314 }
1315
1316 #endif
1317
1318 ev_io *io (struct ev_loop *loop, SV *fh, int events, SV *cb)
1319 ALIAS:
1320 io_ns = 1
1321 CODE:
1322 {
1323 int fd = s_fileno (fh, events & EV_WRITE);
1324 CHECK_FD (fh, fd);
1325
1326 RETVAL = e_new (sizeof (ev_io), cb, ST (0));
1327 RETVAL->fh = newSVsv (fh);
1328 ev_io_set (RETVAL, fd, events);
1329 if (!ix) START (io, RETVAL);
1330 }
1331 OUTPUT:
1332 RETVAL
1333
1334 ev_timer *timer (struct ev_loop *loop, NV after, NV repeat, SV *cb)
1335 ALIAS:
1336 timer_ns = 1
1337 INIT:
1338 CHECK_REPEAT (repeat);
1339 CODE:
1340 RETVAL = e_new (sizeof (ev_timer), cb, ST (0));
1341 ev_timer_set (RETVAL, after, repeat);
1342 if (!ix) START (timer, RETVAL);
1343 OUTPUT:
1344 RETVAL
1345
1346 SV *periodic (struct ev_loop *loop, NV at, NV interval, SV *reschedule_cb, SV *cb)
1347 ALIAS:
1348 periodic_ns = 1
1349 INIT:
1350 CHECK_REPEAT (interval);
1351 CODE:
1352 {
1353 ev_periodic *w;
1354 w = e_new (sizeof (ev_periodic), cb, ST (0));
1355 w->fh = SvTRUE (reschedule_cb) ? newSVsv (reschedule_cb) : 0;
1356 ev_periodic_set (w, at, interval, w->fh ? e_periodic_cb : 0);
1357 RETVAL = e_bless ((ev_watcher *)w, stash_periodic);
1358 if (!ix) START (periodic, w);
1359 }
1360 OUTPUT:
1361 RETVAL
1362
1363 ev_signal *signal (struct ev_loop *loop, SV *signal, SV *cb)
1364 ALIAS:
1365 signal_ns = 1
1366 CODE:
1367 {
1368 Signal signum = s_signum (signal);
1369 CHECK_SIG (signal, signum);
1370
1371 RETVAL = e_new (sizeof (ev_signal), cb, ST (0));
1372 ev_signal_set (RETVAL, signum);
1373 if (!ix) START_SIGNAL (RETVAL);
1374 }
1375 OUTPUT:
1376 RETVAL
1377
1378 ev_idle *idle (struct ev_loop *loop, SV *cb)
1379 ALIAS:
1380 idle_ns = 1
1381 CODE:
1382 RETVAL = e_new (sizeof (ev_idle), cb, ST (0));
1383 ev_idle_set (RETVAL);
1384 if (!ix) START (idle, RETVAL);
1385 OUTPUT:
1386 RETVAL
1387
1388 ev_prepare *prepare (struct ev_loop *loop, SV *cb)
1389 ALIAS:
1390 prepare_ns = 1
1391 CODE:
1392 RETVAL = e_new (sizeof (ev_prepare), cb, ST (0));
1393 ev_prepare_set (RETVAL);
1394 if (!ix) START (prepare, RETVAL);
1395 OUTPUT:
1396 RETVAL
1397
1398 ev_check *check (struct ev_loop *loop, SV *cb)
1399 ALIAS:
1400 check_ns = 1
1401 CODE:
1402 RETVAL = e_new (sizeof (ev_check), cb, ST (0));
1403 ev_check_set (RETVAL);
1404 if (!ix) START (check, RETVAL);
1405 OUTPUT:
1406 RETVAL
1407
1408 ev_fork *fork (struct ev_loop *loop, SV *cb)
1409 ALIAS:
1410 fork_ns = 1
1411 CODE:
1412 RETVAL = e_new (sizeof (ev_fork), cb, ST (0));
1413 ev_fork_set (RETVAL);
1414 if (!ix) START (fork, RETVAL);
1415 OUTPUT:
1416 RETVAL
1417
1418 ev_child *child (struct ev_loop *loop, int pid, int trace, SV *cb)
1419 ALIAS:
1420 child_ns = 1
1421 CODE:
1422 RETVAL = e_new (sizeof (ev_child), cb, ST (0));
1423 ev_child_set (RETVAL, pid, trace);
1424 if (!ix) START (child, RETVAL);
1425 OUTPUT:
1426 RETVAL
1427
1428 ev_stat *stat (struct ev_loop *loop, SV *path, NV interval, SV *cb)
1429 ALIAS:
1430 stat_ns = 1
1431 CODE:
1432 RETVAL = e_new (sizeof (ev_stat), cb, ST (0));
1433 RETVAL->fh = newSVsv (path);
1434 ev_stat_set (RETVAL, SvPVbyte_nolen (RETVAL->fh), interval);
1435 if (!ix) START (stat, RETVAL);
1436 OUTPUT:
1437 RETVAL
1438
1439 ev_embed *embed (struct ev_loop *loop, struct ev_loop *other, SV *cb = 0)
1440 ALIAS:
1441 embed_ns = 1
1442 CODE:
1443 {
1444 if (!(ev_backend (other) & ev_embeddable_backends ()))
1445 croak ("passed loop is not embeddable via EV::embed,");
1446
1447 RETVAL = e_new (sizeof (ev_embed), cb, ST (0));
1448 RETVAL->fh = newSVsv (ST (1));
1449 ev_embed_set (RETVAL, other);
1450 if (!ix) START (embed, RETVAL);
1451 }
1452 OUTPUT:
1453 RETVAL
1454
1455 ev_async *async (struct ev_loop *loop, SV *cb)
1456 ALIAS:
1457 async_ns = 1
1458 CODE:
1459 RETVAL = e_new (sizeof (ev_async), cb, ST (0));
1460 ev_async_set (RETVAL);
1461 if (!ix) START (async, RETVAL);
1462 OUTPUT:
1463 RETVAL
1464
1465 void once (struct ev_loop *loop, SV *fh, int events, SV *timeout, SV *cb)
1466 CODE:
1467 ev_once (
1468 loop,
1469 s_fileno (fh, events & EV_WRITE), events,
1470 SvOK (timeout) ? SvNV (timeout) : -1.,
1471 e_once_cb,
1472 newSVsv (cb)
1473 );
1474