2 + D Programming Language "bindings" to libev
3 + <http://software.schmorp.de/pkg/libev.html>
5 + Written by Leandro Lucarella (2008).
7 + Placed under BOLA license <http://auriga.wearlab.de/~alb/bola/> which is
8 + basically public domain.
19 EV_UNDEF = 0xFFFFFFFFL, // guaranteed to be invalid
20 EV_NONE = 0x00L, // no events
21 EV_READ = 0x01L, // ev_io detected read will not block
22 EV_WRITE = 0x02L, // ev_io detected write will not block
23 EV_IOFDSET = 0x80L, // internal use only
24 EV_TIMEOUT = 0x00000100L, // timer timed out
25 EV_PERIODIC = 0x00000200L, // periodic timer timed out
26 EV_SIGNAL = 0x00000400L, // signal was received
27 EV_CHILD = 0x00000800L, // child/pid had status change
28 EV_STAT = 0x00001000L, // stat data changed
29 EV_IDLE = 0x00002000L, // event loop is idling
30 EV_PREPARE = 0x00004000L, // event loop about to poll
31 EV_CHECK = 0x00008000L, // event loop finished poll
32 EV_EMBED = 0x00010000L, // embedded event loop needs sweep
33 EV_FORK = 0x00020000L, // event loop resumed in child
34 EV_ERROR = 0x80000000L, // sent when an error occurs
39 // bits for ev_default_loop and ev_loop_new
41 EVFLAG_AUTO = 0x00000000UL, // not quite a mask
43 EVFLAG_NOENV = 0x01000000UL, // do NOT consult environment
44 EVFLAG_FORKCHECK = 0x02000000UL, // check for a fork in each iteration
45 // method bits to be ored together
46 EVBACKEND_SELECT = 0x00000001UL, // about anywhere
47 EVBACKEND_POLL = 0x00000002UL, // !win
48 EVBACKEND_EPOLL = 0x00000004UL, // linux
49 EVBACKEND_KQUEUE = 0x00000008UL, // bsd
50 EVBACKEND_DEVPOLL = 0x00000010UL, // solaris 8 / NYI
51 EVBACKEND_PORT = 0x00000020UL, // solaris 10
56 EVLOOP_NONBLOCK = 1, // do not block/wait
57 EVLOOP_ONESHOT = 2, // block *once* only
62 EVUNLOOP_CANCEL = 0, // undo unloop
63 EVUNLOOP_ONE = 1, // unloop once
64 EVUNLOOP_ALL = 2, // unloop all loops
67 version (EV_ENABLE_SELECT)
72 version = EV_PERIODIC_ENABLE;
73 version = EV_STAT_ENABLE;
74 version = EV_IDLE_ENABLE;
75 version = EV_FORK_ENABLE;
76 version = EV_EMBED_ENABLE;
79 alias double ev_tstamp;
88 template EV_CB_DECLARE(TYPE)
90 void function (ev_loop_t*, TYPE*, int) cb;
93 template EV_WATCHER(TYPE)
95 int active; // private
96 int pending; // private
97 int priority; // private
98 mixin EV_COMMON; // rw
99 mixin EV_CB_DECLARE!(TYPE); // private
102 template EV_WATCHER_LIST(TYPE)
104 mixin EV_WATCHER!(TYPE);
105 ev_watcher_list* next; // private
108 template EV_WATCHER_TIME(TYPE)
110 mixin EV_WATCHER!(TYPE);
111 ev_tstamp at; // private
116 mixin EV_WATCHER!(ev_watcher);
119 struct ev_watcher_list
121 mixin EV_WATCHER_LIST!(ev_watcher_list);
124 struct ev_watcher_time
126 mixin EV_WATCHER_TIME!(ev_watcher_time);
131 mixin EV_WATCHER_LIST!(ev_io);
138 mixin EV_WATCHER_TIME!(ev_timer);
139 ev_tstamp repeat; // rw
142 version (EV_PERIODIC_ENABLE)
146 mixin EV_WATCHER_TIME!(ev_periodic);
147 ev_tstamp offset; // rw
148 ev_tstamp interval; // rw
149 ev_tstamp function(ev_periodic *w,
150 ev_tstamp now) reschedule_cb; // rw
156 mixin EV_WATCHER_LIST!(ev_signal);
162 mixin EV_WATCHER_LIST!(ev_child);
163 int flags; // private
165 int rpid; // rw, holds the received pid
166 int rstatus; // rw, holds the exit status, use the
167 // macros from sys/wait.h
170 version (EV_STAT_ENABLE)
173 version (Windows) // alias _stati64 ev_statdata;
175 pragma (msg, "ev_stat not supported in windows "
176 "because I don't know the "
177 "layout of _stati64");
179 // Maybe this should work?
180 //static import stat = std.c.windows.stat;
181 //alias stat.struct_stat ev_statdata;
183 else // It should be POSIX
185 static import stat = std.c.unix.unix;
186 alias stat.struct_stat ev_statdata;
191 mixin EV_WATCHER_LIST!(ev_stat);
193 ev_timer timer; // private
194 ev_tstamp interval; // ro
195 const char *path; // ro
196 ev_statdata prev; // ro
197 ev_statdata attr; // ro
198 int wd; // wd for inotify, fd for kqueue
202 version (EV_IDLE_ENABLE)
206 mixin EV_WATCHER!(ev_idle);
212 mixin EV_WATCHER!(ev_prepare);
217 mixin EV_WATCHER!(ev_check);
220 version (EV_FORK_ENABLE)
224 mixin EV_WATCHER!(ev_fork);
228 version (EV_EMBED_ENABLE)
232 mixin EV_WATCHER!(ev_embed);
233 ev_loop_t* other; // ro
235 ev_prepare prepare; // private
236 ev_check check; // unused
237 ev_timer timer; // unused
238 ev_periodic periodic; // unused
239 ev_idle idle; // unused
240 ev_fork fork; // unused
244 int ev_version_major();
245 int ev_version_minor();
247 uint ev_supported_backends();
248 uint ev_recommended_backends();
249 uint ev_embeddable_backends();
252 void ev_sleep(ev_tstamp delay); // sleep for a while
254 // Sets the allocation function to use, works like realloc.
255 // It is used to allocate and free memory.
256 // If it returns zero when memory needs to be allocated, the library
258 // or take some potentially destructive action.
259 // The default is your system realloc function.
260 void ev_set_allocator(void* function(void* ptr, int size));
262 // set the callback function to call on a
263 // retryable syscall error
264 // (such as failed select, poll, epoll_wait)
265 void ev_set_syserr_cb(void function(char* msg));
267 extern ev_loop_t* ev_default_loop_ptr;
269 ev_loop_t* ev_default_loop_init(uint flags);
271 // create and destroy alternative loops that don't handle signals
272 ev_loop_t* ev_loop_new(uint flags);
273 void ev_loop_destroy(ev_loop_t*);
274 void ev_loop_fork(ev_loop_t*);
276 ev_tstamp ev_now(ev_loop_t*);
277 void ev_default_destroy();
278 void ev_default_fork();
279 uint ev_backend(ev_loop_t*);
280 uint ev_loop_count(ev_loop_t*);
281 void ev_loop(ev_loop_t*, int flags);
282 void ev_unloop(ev_loop_t*, int);
283 void ev_set_io_collect_interval(ev_loop_t*, ev_tstamp interval);
284 void ev_set_timeout_collect_interval(ev_loop_t*, ev_tstamp interval);
285 void ev_ref(ev_loop_t*);
286 void ev_unref(ev_loop_t*);
287 void ev_once(ev_loop_t*, int fd, int events, ev_tstamp timeout,
288 void function(int revents, void* arg), void* arg);
290 void ev_feed_event(ev_loop_t*, void *w, int revents);
291 void ev_feed_fd_event(ev_loop_t*, int fd, int revents);
292 void ev_feed_signal_event (ev_loop_t*, int signum);
293 void ev_invoke(ev_loop_t*, void *w, int revents);
294 int ev_clear_pending(ev_loop_t*, void *w);
296 void ev_io_start(ev_loop_t*, ev_io *w);
297 void ev_io_stop(ev_loop_t*, ev_io *w);
299 void ev_timer_start(ev_loop_t*, ev_timer *w);
300 void ev_timer_stop(ev_loop_t*, ev_timer *w);
301 void ev_timer_again(ev_loop_t*, ev_timer *w);
303 version (EV_PERIODIC_ENABLE)
305 void ev_periodic_start(ev_loop_t*, ev_periodic *w);
306 void ev_periodic_stop(ev_loop_t*, ev_periodic *w);
307 void ev_periodic_again(ev_loop_t*, ev_periodic *w);
310 void ev_signal_start(ev_loop_t*, ev_signal *w);
311 void ev_signal_stop(ev_loop_t*, ev_signal *w);
313 /* only supported in the default loop */
314 void ev_child_start(ev_loop_t*, ev_child *w);
315 void ev_child_stop(ev_loop_t*, ev_child *w);
317 version (EV_STAT_ENABLE)
319 void ev_stat_start(ev_loop_t*, ev_stat *w);
320 void ev_stat_stop(ev_loop_t*, ev_stat *w);
321 void ev_stat_stat(ev_loop_t*, ev_stat *w);
324 version (EV_IDLE_ENABLE)
326 void ev_idle_start(ev_loop_t*, ev_idle *w);
327 void ev_idle_stop(ev_loop_t*, ev_idle *w);
330 void ev_prepare_start(ev_loop_t*, ev_prepare *w);
331 void ev_prepare_stop(ev_loop_t*, ev_prepare *w);
333 void ev_check_start(ev_loop_t*, ev_check *w);
334 void ev_check_stop(ev_loop_t*, ev_check *w);
336 version (EV_FORK_ENABLE)
338 void ev_fork_start(ev_loop_t*, ev_fork *w);
339 void ev_fork_stop(ev_loop_t*, ev_fork *w);
342 version (EV_EMBED_ENABLE)
344 // only supported when loop to be embedded is in fact embeddable
345 void ev_embed_start(ev_loop_t*, ev_embed *w);
346 void ev_embed_stop(ev_loop_t*, ev_embed *w);
347 void ev_embed_sweep(ev_loop_t*, ev_embed *w);
350 bool ev_is_pending(TYPE)(TYPE* w)
352 return cast (bool) w.pending;
355 bool ev_is_active(TYPE)(TYPE* w)
357 return cast (bool) w.active;
360 int ev_priority(TYPE)(TYPE* w)
362 return cast (bool) w.priority;
365 void function(ev_loop_t*, TYPE*, int) ev_cb(TYPE)(TYPE* w)
370 void ev_set_priority(TYPE)(TYPE* w, int pri)
375 void ev_set_cb(TYPE)(TYPE* w,
376 void function(ev_loop_t*, TYPE*, int) cb)
381 void ev_init(TYPE)(TYPE* w,
382 void function(ev_loop_t*, TYPE*, int) cb)
390 void ev_io_set(ev_io* w, int fd, int events)
393 w.events = events | EV_IOFDSET;
396 void ev_timer_set(ev_timer* w, ev_tstamp after, ev_tstamp repeat)
402 void ev_periodic_set(ev_periodic* w, ev_tstamp ofs, ev_tstamp ival,
403 ev_tstamp function(ev_periodic *w, ev_tstamp now) res)
407 w.reschedule_cb = res;
410 void ev_signal_set(ev_signal* w, int signum)
415 void ev_child_set(ev_child* w, int pid, int trace)
421 void ev_stat_set(ev_stat* w, char* path, ev_tstamp interval)
424 w.interval = interval;
428 void ev_idle_set(ev_idle* w)
432 void ev_prepare_set(ev_prepare* w)
436 void ev_check_set(ev_check* w)
440 void ev_embed_set(ev_embed* w, ev_loop_t* other)
445 void ev_fork_set(ev_fork* w)
449 void ev_io_init(ev_io* w, void function(ev_loop_t*, ev_io*, int) cb, int fd,
453 ev_io_set(w, fd, events);
456 void ev_timer_init(ev_timer* w, void function(ev_loop_t*, ev_timer*, int) cb,
457 ev_tstamp after, ev_tstamp repeat)
460 ev_timer_set(w, after, repeat);
463 void ev_periodic_init(ev_periodic* w,
464 void function(ev_loop_t*, ev_periodic*, int) cb,
465 ev_tstamp ofs, ev_tstamp ival,
466 ev_tstamp function(ev_periodic *w, ev_tstamp now) res)
469 ev_periodic_set(w, ofs, ival, res);
472 void ev_signal_init(ev_signal* w, void function(ev_loop_t*, ev_signal*, int) cb,
476 ev_signal_set(w, signum);
479 void ev_child_init(ev_child* w, void function(ev_loop_t*, ev_child*, int) cb,
483 ev_child_set(w, pid, trace);
486 void ev_stat_init(ev_stat* w, void function(ev_loop_t*, ev_stat*, int) cb,
487 char* path, ev_tstamp interval)
490 ev_stat_set(w, path, interval);
493 void ev_idle_init(ev_idle* w, void function(ev_loop_t*, ev_idle*, int) cb)
499 void ev_prepare_init(ev_prepare* w,
500 void function(ev_loop_t*, ev_prepare*, int) cb)
506 void ev_check_init(ev_check* w, void function(ev_loop_t*, ev_check*, int) cb)
512 void ev_embed_init(ev_embed* w, void function(ev_loop_t*, ev_embed*, int) cb,
516 ev_embed_set(w, other);
519 void ev_fork_init(ev_fork* w, void function(ev_loop_t*, ev_fork*, int) cb)
525 ev_loop_t* ev_default_loop(uint flags = EVFLAG_AUTO)
527 if (!ev_default_loop_ptr)
528 ev_default_loop_init(flags);
529 return ev_default_loop_ptr;
534 import stdio = std.stdio;
535 import stdlib = std.c.stdlib;
536 import str = std.string;
537 import unix = std.c.unix.unix;
538 import proc = std.c.process;
540 const STAT_FILE = "/tmp/libev-stat-test-file";
541 const TEST_TEXT = "hello";
542 bool prepare_done = false;
543 bool check_done = false;
544 bool idle_done = false;
545 bool timer_done = false;
546 bool io_done = false;
547 bool stat_done = false;
548 bool child_done = false;
549 bool signal_done = false;
550 bool eio_done = false;
554 stdio.writefln("Unittesting...");
555 extern (C) static void cbprepare(ev_loop_t* loop, ev_prepare* w, int revents)
557 stdio.writefln("ev_prepare");
558 assert (!prepare_done);
559 assert (!check_done);
561 assert (!timer_done);
564 assert (!child_done);
565 assert (!signal_done);
568 ev_prepare_stop(loop, w);
570 extern (C) static void cbcheck(ev_loop_t* loop, ev_check* w, int revents)
572 stdio.writefln("ev_check");
573 assert (prepare_done);
574 assert (!check_done);
576 assert (!timer_done);
579 assert (!child_done);
580 assert (!signal_done);
583 ev_check_stop(loop, w);
585 extern (C) static void cbidle(ev_loop_t* loop, ev_idle* w, int revents)
587 stdio.writefln("ev_idle");
588 assert (prepare_done);
591 assert (!timer_done);
594 assert (!child_done);
595 assert (!signal_done);
598 ev_idle_stop(loop, w);
600 extern (C) static void cbtimer(ev_loop_t* loop, ev_timer* w,
603 stdio.writefln("ev_timer");
604 assert (prepare_done);
607 assert (!timer_done);
610 assert (!child_done);
611 assert (!signal_done);
614 ev_timer_stop(loop, w);
615 stdio.writefln("\tfiring ev_io");
616 stdio.writefln("\t\topening pipe for writing...");
617 int pipe_fd = *cast (int*) w.data;
618 stdio.writefln("\t\twriting '%s' to pipe...", TEST_TEXT);
619 int n = unix.write(pipe_fd, cast (void*) TEST_TEXT,
621 assert (n == TEST_TEXT.length);
623 extern (C) static void cbio(ev_loop_t* loop, ev_io* w, int revents)
625 stdio.writefln("ev_io");
626 assert (prepare_done);
632 assert (!child_done);
633 assert (!signal_done);
637 char[TEST_TEXT.length] buffer;
638 stdio.writefln("\treading %d bytes from pipe...",
640 int n = unix.read(w.fd, cast (void*) buffer, buffer.length);
641 assert (n == TEST_TEXT.length);
642 assert (buffer.dup == TEST_TEXT.dup);
643 stdio.writefln("\tread '%s'", buffer);
644 stdio.writefln("\tfiring ev_stat");
645 stdio.writefln("\t\topening file '%s'", STAT_FILE);
646 int fd = unix.open(str.toStringz(STAT_FILE),
647 unix.O_WRONLY | unix.O_TRUNC | unix.O_CREAT);
649 stdio.writefln("\t\tfd: %d", fd);
650 n = unix.write(fd, cast (void*) TEST_TEXT,
652 assert (n == TEST_TEXT.length);
655 extern (C) static void cbstat(ev_loop_t* loop, ev_stat* w, int revents)
657 stdio.writefln("ev_stat");
658 assert (prepare_done);
664 assert (!child_done);
665 assert (!signal_done);
668 ev_stat_stop(loop, w);
669 static void print_stat(ev_statdata* s)
671 stdio.writefln("\t\t\tinode: ", s.st_ino);
672 stdio.writefln("\t\t\tmode: ", s.st_mode);
673 stdio.writefln("\t\t\tlinks: ", s.st_nlink);
674 stdio.writefln("\t\t\tuid: ", s.st_uid);
675 stdio.writefln("\t\t\tgid: ", s.st_gid);
676 stdio.writefln("\t\t\tsize: ", s.st_size);
677 stdio.writefln("\t\t\tatime: ", s.st_atime);
678 stdio.writefln("\t\t\tmtime: ", s.st_mtime);
679 stdio.writefln("\t\t\tctime: ", s.st_ctime);
683 stdio.writefln("\tfile '%s' changed", str.toString(w.path));
684 stdio.writefln("\t\tprevios state:");
686 stdio.writefln("\t\tcurrent state:");
691 stdio.writefln("\tfile '%s' does not exist!",
692 str.toString(w.path));
693 stdio.writefln("\t\tprevios state:");
696 stdio.writefln("\tfiring ev_fork...");
697 stdio.writefln("\t\tforking...");
698 auto pid = unix.fork();
703 stdio.writefln("\t\tev_stat: in parent, child pid: ", pid);
707 stdio.writefln("\t\tev_stat: in child, calling "
708 "ev_default_fork...");
712 extern (C) static void cbchild(ev_loop_t* loop, ev_child* w, int revents)
714 stdio.writefln("ev_child");
715 assert (prepare_done);
721 assert (!child_done);
722 assert (!signal_done);
725 ev_child_stop(loop, w);
726 static ubyte WEXITSTATUS(int s)
728 return cast(ubyte)((s & 0xff00) >> 8);
730 static ubyte WTERMSIG(int s)
732 return cast(ubyte)(s & 0x7f);
734 static bool WIFEXITED(int s)
736 return WTERMSIG(s) == 0;
738 static bool WIFSIGNALED(int s)
740 return cast(byte)(((s & 0x7f) + 1) >> 1) > 0;
742 static bool WCOREDUMP(int s)
744 return cast(bool)(s & 0x80);
746 stdio.writefln("\tthe child with pid %d exited with status "
747 "%d", w.rpid, w.rstatus);
748 assert (child_pid == w.rpid);
749 if (WIFEXITED(w.rstatus))
750 stdio.writefln("\tchild exited normally with code ",
751 WEXITSTATUS(w.rstatus));
752 if (WIFSIGNALED(w.rstatus))
754 stdio.writefln("\tchild exited with signal ",
755 WTERMSIG(w.rstatus));
756 if (WCOREDUMP(w.rstatus))
757 stdio.writefln("\tchild produced a core dump");
759 assert (WIFEXITED(w.rstatus) && WEXITSTATUS(w.rstatus) == 5);
760 stdio.writefln("\tfiring ev_signal");
761 stdio.writefln("\t\tsending signal 2 (SIGINT)");
762 unix.kill(proc.getpid(), SIGINT);
764 extern (C) static void cbfork(ev_loop_t* loop, ev_fork* w, int revents)
766 stdio.writefln("ev_fork");
767 assert (prepare_done);
773 assert (!child_done);
774 assert (!signal_done);
776 ev_fork_stop(loop, w);
777 stdio.writefln("\texiting the child program with return "
781 extern (C) static void cbsignal(ev_loop_t* loop, ev_signal* w,
784 stdio.writefln("ev_signal");
785 assert (prepare_done);
792 assert (!signal_done);
795 ev_signal_stop(loop, w);
796 stdio.writefln("\tfiring embeded ev_io...");
797 stdio.writefln("\t\topening pipe for writing...");
798 int pipe_fd = *cast(int*)w.data;
799 stdio.writefln("\t\twriting '%s' to pipe...", TEST_TEXT);
800 int n = unix.write(pipe_fd, cast(void*)TEST_TEXT,
802 assert (n == TEST_TEXT.length);
804 extern (C) static void ecbio(ev_loop_t* loop, ev_io* w, int revents)
806 stdio.writefln("embeded ev_io");
807 assert (prepare_done);
814 assert (signal_done);
817 //ev_io_stop(loop, w);
818 char[TEST_TEXT.length] buffer;
819 stdio.writefln("\treading %d bytes from pipe...",
821 int n = unix.read(w.fd, cast (void*) buffer, buffer.length);
822 assert (n == TEST_TEXT.length);
823 assert (buffer.dup == TEST_TEXT.dup);
824 stdio.writefln("\tread '%s'", buffer);
825 stdio.writefln("\tstoping the loop");
826 ev_unloop(loop, EVUNLOOP_ONE);
828 extern (C) static void cbembed(ev_loop_t* loop, ev_embed* w, int revents)
830 stdio.writefln("ev_embed");
831 stdio.writefln("\tsweeping embeded loop...");
832 ev_embed_sweep(w.other, w);
833 //ev_embed_stop(loop, w);
836 auto loop = ev_default_loop(0);
850 ev_loop_t* eloop = ev_embeddable_backends() & ev_recommended_backends()
851 ? ev_loop_new(ev_embeddable_backends () &
852 ev_recommended_backends ())
857 stdio.writefln("Initializing embeded loop");
858 ev_embed_init(&wembed, &cbembed, eloop);
859 ev_embed_start(loop, &wembed);
863 stdio.writefln("No embeded loop, using the default");
869 int ret = unix.pipe(epipe);
872 ev_io_init(&ewio, &ecbio, epipe[0], EV_READ);
873 ev_io_start(eloop, &ewio);
877 int ret = unix.pipe(pipe);
881 ev_io_init(&wio, &cbio, pipe[0], EV_READ);
882 ev_io_start(loop, &wio);
884 ev_timer_init(&wtimer, &cbtimer, 1.5, 0.);
885 wtimer.data = &pipe[1]; // write fd
886 ev_timer_start(loop, &wtimer);
888 ev_signal_init(&wsignal, &cbsignal, SIGINT);
889 wsignal.data = &epipe[1]; // write fd
890 ev_signal_start(loop, &wsignal);
892 ev_child_init(&wchild, &cbchild, 0 /* trace any PID */, 0 /* death */);
893 ev_child_start(loop, &wchild);
895 ev_stat_init(&wstat, &cbstat, str.toStringz(STAT_FILE), 0 /* auto */);
896 ev_stat_start(loop, &wstat);
898 ev_idle_init(&widle, &cbidle);
899 ev_idle_start(loop, &widle);
901 ev_prepare_init(&wprepare, &cbprepare);
902 ev_prepare_start(loop, &wprepare);
904 ev_check_init(&wcheck, &cbcheck);
905 ev_check_start(loop, &wcheck);
907 ev_fork_init(&wfork, &cbfork);
908 ev_fork_start(loop, &wfork);
912 assert (prepare_done);
919 assert (signal_done);
922 stdio.writefln("Unittesting done!");