ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/libev/ev.3
(Generate patch)

Comparing libev/ev.3 (file contents):
Revision 1.47 by root, Sun Dec 9 19:46:56 2007 UTC vs.
Revision 1.52 by root, Wed Dec 19 00:56:39 2007 UTC

… …
126. ds Ae AE 126. ds Ae AE
127.\} 127.\}
128.rm #[ #] #H #V #F C 128.rm #[ #] #H #V #F C
129.\" ======================================================================== 129.\" ========================================================================
130.\" 130.\"
131.IX Title ""<STANDARD INPUT>" 1" 131.IX Title "EV 1"
132.TH "<STANDARD INPUT>" 1 "2007-12-09" "perl v5.8.8" "User Contributed Perl Documentation" 132.TH EV 1 "2007-12-18" "perl v5.8.8" "User Contributed Perl Documentation"
133.SH "NAME" 133.SH "NAME"
134libev \- a high performance full\-featured event loop written in C 134libev \- a high performance full\-featured event loop written in C
135.SH "SYNOPSIS" 135.SH "SYNOPSIS"
136.IX Header "SYNOPSIS" 136.IX Header "SYNOPSIS"
137.Vb 1 137.Vb 1
… …
243Libev represents time as a single floating point number, representing the 243Libev represents time as a single floating point number, representing the
244(fractional) number of seconds since the (\s-1POSIX\s0) epoch (somewhere near 244(fractional) number of seconds since the (\s-1POSIX\s0) epoch (somewhere near
245the beginning of 1970, details are complicated, don't ask). This type is 245the beginning of 1970, details are complicated, don't ask). This type is
246called \f(CW\*(C`ev_tstamp\*(C'\fR, which is what you should use too. It usually aliases 246called \f(CW\*(C`ev_tstamp\*(C'\fR, which is what you should use too. It usually aliases
247to the \f(CW\*(C`double\*(C'\fR type in C, and when you need to do any calculations on 247to the \f(CW\*(C`double\*(C'\fR type in C, and when you need to do any calculations on
248it, you should treat it as such. 248it, you should treat it as some floatingpoint value. Unlike the name
249component \f(CW\*(C`stamp\*(C'\fR might indicate, it is also used for time differences
250throughout libev.
249.SH "GLOBAL FUNCTIONS" 251.SH "GLOBAL FUNCTIONS"
250.IX Header "GLOBAL FUNCTIONS" 252.IX Header "GLOBAL FUNCTIONS"
251These functions can be called anytime, even before initialising the 253These functions can be called anytime, even before initialising the
252library in any way. 254library in any way.
253.IP "ev_tstamp ev_time ()" 4 255.IP "ev_tstamp ev_time ()" 4
… …
259.IX Item "int ev_version_major ()" 261.IX Item "int ev_version_major ()"
260.PD 0 262.PD 0
261.IP "int ev_version_minor ()" 4 263.IP "int ev_version_minor ()" 4
262.IX Item "int ev_version_minor ()" 264.IX Item "int ev_version_minor ()"
263.PD 265.PD
264You can find out the major and minor \s-1API/ABI\s0 version numbers of the library 266You can find out the major and minor \s-1ABI\s0 version numbers of the library
265you linked against by calling the functions \f(CW\*(C`ev_version_major\*(C'\fR and 267you linked against by calling the functions \f(CW\*(C`ev_version_major\*(C'\fR and
266\&\f(CW\*(C`ev_version_minor\*(C'\fR. If you want, you can compare against the global 268\&\f(CW\*(C`ev_version_minor\*(C'\fR. If you want, you can compare against the global
267symbols \f(CW\*(C`EV_VERSION_MAJOR\*(C'\fR and \f(CW\*(C`EV_VERSION_MINOR\*(C'\fR, which specify the 269symbols \f(CW\*(C`EV_VERSION_MAJOR\*(C'\fR and \f(CW\*(C`EV_VERSION_MINOR\*(C'\fR, which specify the
268version of the library your program was compiled against. 270version of the library your program was compiled against.
269.Sp 271.Sp
270These version numbers refer to the \s-1API\s0 and \s-1ABI\s0 version of the library, not 272These version numbers refer to the \s-1ABI\s0 version of the library, not the
271the release version. 273release version.
272.Sp 274.Sp
273Usually, it's a good idea to terminate if the major versions mismatch, 275Usually, it's a good idea to terminate if the major versions mismatch,
274as this indicates an incompatible change. Minor versions are usually 276as this indicates an incompatible change. Minor versions are usually
275compatible to older versions, so a larger minor version alone is usually 277compatible to older versions, so a larger minor version alone is usually
276not a problem. 278not a problem.
… …
555Destroys the default loop again (frees all memory and kernel state 557Destroys the default loop again (frees all memory and kernel state
556etc.). None of the active event watchers will be stopped in the normal 558etc.). None of the active event watchers will be stopped in the normal
557sense, so e.g. \f(CW\*(C`ev_is_active\*(C'\fR might still return true. It is your 559sense, so e.g. \f(CW\*(C`ev_is_active\*(C'\fR might still return true. It is your
558responsibility to either stop all watchers cleanly yoursef \fIbefore\fR 560responsibility to either stop all watchers cleanly yoursef \fIbefore\fR
559calling this function, or cope with the fact afterwards (which is usually 561calling this function, or cope with the fact afterwards (which is usually
560the easiest thing, youc na just ignore the watchers and/or \f(CW\*(C`free ()\*(C'\fR them 562the easiest thing, you can just ignore the watchers and/or \f(CW\*(C`free ()\*(C'\fR them
561for example). 563for example).
564.Sp
565Not that certain global state, such as signal state, will not be freed by
566this function, and related watchers (such as signal and child watchers)
567would need to be stopped manually.
568.Sp
569In general it is not advisable to call this function except in the
570rare occasion where you really need to free e.g. the signal handling
571pipe fds. If you need dynamically allocated loops it is better to use
572\&\f(CW\*(C`ev_loop_new\*(C'\fR and \f(CW\*(C`ev_loop_destroy\*(C'\fR).
562.IP "ev_loop_destroy (loop)" 4 573.IP "ev_loop_destroy (loop)" 4
563.IX Item "ev_loop_destroy (loop)" 574.IX Item "ev_loop_destroy (loop)"
564Like \f(CW\*(C`ev_default_destroy\*(C'\fR, but destroys an event loop created by an 575Like \f(CW\*(C`ev_default_destroy\*(C'\fR, but destroys an event loop created by an
565earlier call to \f(CW\*(C`ev_loop_new\*(C'\fR. 576earlier call to \f(CW\*(C`ev_loop_new\*(C'\fR.
566.IP "ev_default_fork ()" 4 577.IP "ev_default_fork ()" 4
… …
1065If you cannot run the fd in non-blocking mode (for example you should not 1076If you cannot run the fd in non-blocking mode (for example you should not
1066play around with an Xlib connection), then you have to seperately re-test 1077play around with an Xlib connection), then you have to seperately re-test
1067whether a file descriptor is really ready with a known-to-be good interface 1078whether a file descriptor is really ready with a known-to-be good interface
1068such as poll (fortunately in our Xlib example, Xlib already does this on 1079such as poll (fortunately in our Xlib example, Xlib already does this on
1069its own, so its quite safe to use). 1080its own, so its quite safe to use).
1081.PP
1082\fIThe special problem of disappearing file descriptors\fR
1083.IX Subsection "The special problem of disappearing file descriptors"
1084.PP
1085Some backends (e.g kqueue, epoll) need to be told about closing a file
1086descriptor (either by calling \f(CW\*(C`close\*(C'\fR explicitly or by any other means,
1087such as \f(CW\*(C`dup\*(C'\fR). The reason is that you register interest in some file
1088descriptor, but when it goes away, the operating system will silently drop
1089this interest. If another file descriptor with the same number then is
1090registered with libev, there is no efficient way to see that this is, in
1091fact, a different file descriptor.
1092.PP
1093To avoid having to explicitly tell libev about such cases, libev follows
1094the following policy: Each time \f(CW\*(C`ev_io_set\*(C'\fR is being called, libev
1095will assume that this is potentially a new file descriptor, otherwise
1096it is assumed that the file descriptor stays the same. That means that
1097you \fIhave\fR to call \f(CW\*(C`ev_io_set\*(C'\fR (or \f(CW\*(C`ev_io_init\*(C'\fR) when you change the
1098descriptor even if the file descriptor number itself did not change.
1099.PP
1100This is how one would do it normally anyway, the important point is that
1101the libev application should not optimise around libev but should leave
1102optimisations to libev.
1103.PP
1104\fIWatcher-Specific Functions\fR
1105.IX Subsection "Watcher-Specific Functions"
1070.IP "ev_io_init (ev_io *, callback, int fd, int events)" 4 1106.IP "ev_io_init (ev_io *, callback, int fd, int events)" 4
1071.IX Item "ev_io_init (ev_io *, callback, int fd, int events)" 1107.IX Item "ev_io_init (ev_io *, callback, int fd, int events)"
1072.PD 0 1108.PD 0
1073.IP "ev_io_set (ev_io *, int fd, int events)" 4 1109.IP "ev_io_set (ev_io *, int fd, int events)" 4
1074.IX Item "ev_io_set (ev_io *, int fd, int events)" 1110.IX Item "ev_io_set (ev_io *, int fd, int events)"
… …
1127.Ve 1163.Ve
1128.PP 1164.PP
1129The callback is guarenteed to be invoked only when its timeout has passed, 1165The callback is guarenteed to be invoked only when its timeout has passed,
1130but if multiple timers become ready during the same loop iteration then 1166but if multiple timers become ready during the same loop iteration then
1131order of execution is undefined. 1167order of execution is undefined.
1168.PP
1169\fIWatcher-Specific Functions and Data Members\fR
1170.IX Subsection "Watcher-Specific Functions and Data Members"
1132.IP "ev_timer_init (ev_timer *, callback, ev_tstamp after, ev_tstamp repeat)" 4 1171.IP "ev_timer_init (ev_timer *, callback, ev_tstamp after, ev_tstamp repeat)" 4
1133.IX Item "ev_timer_init (ev_timer *, callback, ev_tstamp after, ev_tstamp repeat)" 1172.IX Item "ev_timer_init (ev_timer *, callback, ev_tstamp after, ev_tstamp repeat)"
1134.PD 0 1173.PD 0
1135.IP "ev_timer_set (ev_timer *, ev_tstamp after, ev_tstamp repeat)" 4 1174.IP "ev_timer_set (ev_timer *, ev_tstamp after, ev_tstamp repeat)" 4
1136.IX Item "ev_timer_set (ev_timer *, ev_tstamp after, ev_tstamp repeat)" 1175.IX Item "ev_timer_set (ev_timer *, ev_tstamp after, ev_tstamp repeat)"
… …
1247rules. 1286rules.
1248.PP 1287.PP
1249As with timers, the callback is guarenteed to be invoked only when the 1288As with timers, the callback is guarenteed to be invoked only when the
1250time (\f(CW\*(C`at\*(C'\fR) has been passed, but if multiple periodic timers become ready 1289time (\f(CW\*(C`at\*(C'\fR) has been passed, but if multiple periodic timers become ready
1251during the same loop iteration then order of execution is undefined. 1290during the same loop iteration then order of execution is undefined.
1291.PP
1292\fIWatcher-Specific Functions and Data Members\fR
1293.IX Subsection "Watcher-Specific Functions and Data Members"
1252.IP "ev_periodic_init (ev_periodic *, callback, ev_tstamp at, ev_tstamp interval, reschedule_cb)" 4 1294.IP "ev_periodic_init (ev_periodic *, callback, ev_tstamp at, ev_tstamp interval, reschedule_cb)" 4
1253.IX Item "ev_periodic_init (ev_periodic *, callback, ev_tstamp at, ev_tstamp interval, reschedule_cb)" 1295.IX Item "ev_periodic_init (ev_periodic *, callback, ev_tstamp at, ev_tstamp interval, reschedule_cb)"
1254.PD 0 1296.PD 0
1255.IP "ev_periodic_set (ev_periodic *, ev_tstamp after, ev_tstamp repeat, reschedule_cb)" 4 1297.IP "ev_periodic_set (ev_periodic *, ev_tstamp after, ev_tstamp repeat, reschedule_cb)" 4
1256.IX Item "ev_periodic_set (ev_periodic *, ev_tstamp after, ev_tstamp repeat, reschedule_cb)" 1298.IX Item "ev_periodic_set (ev_periodic *, ev_tstamp after, ev_tstamp repeat, reschedule_cb)"
… …
1348.IP "ev_tstamp (*reschedule_cb)(struct ev_periodic *w, ev_tstamp now) [read\-write]" 4 1390.IP "ev_tstamp (*reschedule_cb)(struct ev_periodic *w, ev_tstamp now) [read\-write]" 4
1349.IX Item "ev_tstamp (*reschedule_cb)(struct ev_periodic *w, ev_tstamp now) [read-write]" 1391.IX Item "ev_tstamp (*reschedule_cb)(struct ev_periodic *w, ev_tstamp now) [read-write]"
1350The current reschedule callback, or \f(CW0\fR, if this functionality is 1392The current reschedule callback, or \f(CW0\fR, if this functionality is
1351switched off. Can be changed any time, but changes only take effect when 1393switched off. Can be changed any time, but changes only take effect when
1352the periodic timer fires or \f(CW\*(C`ev_periodic_again\*(C'\fR is being called. 1394the periodic timer fires or \f(CW\*(C`ev_periodic_again\*(C'\fR is being called.
1395.IP "ev_tstamp at [read\-only]" 4
1396.IX Item "ev_tstamp at [read-only]"
1397When active, contains the absolute time that the watcher is supposed to
1398trigger next.
1353.PP 1399.PP
1354Example: Call a callback every hour, or, more precisely, whenever the 1400Example: Call a callback every hour, or, more precisely, whenever the
1355system clock is divisible by 3600. The callback invocation times have 1401system clock is divisible by 3600. The callback invocation times have
1356potentially a lot of jittering, but good long-term stability. 1402potentially a lot of jittering, but good long-term stability.
1357.PP 1403.PP
… …
1407first watcher gets started will libev actually register a signal watcher 1453first watcher gets started will libev actually register a signal watcher
1408with the kernel (thus it coexists with your own signal handlers as long 1454with the kernel (thus it coexists with your own signal handlers as long
1409as you don't register any with libev). Similarly, when the last signal 1455as you don't register any with libev). Similarly, when the last signal
1410watcher for a signal is stopped libev will reset the signal handler to 1456watcher for a signal is stopped libev will reset the signal handler to
1411\&\s-1SIG_DFL\s0 (regardless of what it was set to before). 1457\&\s-1SIG_DFL\s0 (regardless of what it was set to before).
1458.PP
1459\fIWatcher-Specific Functions and Data Members\fR
1460.IX Subsection "Watcher-Specific Functions and Data Members"
1412.IP "ev_signal_init (ev_signal *, callback, int signum)" 4 1461.IP "ev_signal_init (ev_signal *, callback, int signum)" 4
1413.IX Item "ev_signal_init (ev_signal *, callback, int signum)" 1462.IX Item "ev_signal_init (ev_signal *, callback, int signum)"
1414.PD 0 1463.PD 0
1415.IP "ev_signal_set (ev_signal *, int signum)" 4 1464.IP "ev_signal_set (ev_signal *, int signum)" 4
1416.IX Item "ev_signal_set (ev_signal *, int signum)" 1465.IX Item "ev_signal_set (ev_signal *, int signum)"
… …
1423.ie n .Sh """ev_child"" \- watch out for process status changes" 1472.ie n .Sh """ev_child"" \- watch out for process status changes"
1424.el .Sh "\f(CWev_child\fP \- watch out for process status changes" 1473.el .Sh "\f(CWev_child\fP \- watch out for process status changes"
1425.IX Subsection "ev_child - watch out for process status changes" 1474.IX Subsection "ev_child - watch out for process status changes"
1426Child watchers trigger when your process receives a \s-1SIGCHLD\s0 in response to 1475Child watchers trigger when your process receives a \s-1SIGCHLD\s0 in response to
1427some child status changes (most typically when a child of yours dies). 1476some child status changes (most typically when a child of yours dies).
1477.PP
1478\fIWatcher-Specific Functions and Data Members\fR
1479.IX Subsection "Watcher-Specific Functions and Data Members"
1428.IP "ev_child_init (ev_child *, callback, int pid)" 4 1480.IP "ev_child_init (ev_child *, callback, int pid)" 4
1429.IX Item "ev_child_init (ev_child *, callback, int pid)" 1481.IX Item "ev_child_init (ev_child *, callback, int pid)"
1430.PD 0 1482.PD 0
1431.IP "ev_child_set (ev_child *, int pid)" 4 1483.IP "ev_child_set (ev_child *, int pid)" 4
1432.IX Item "ev_child_set (ev_child *, int pid)" 1484.IX Item "ev_child_set (ev_child *, int pid)"
… …
1497reader). Inotify will be used to give hints only and should not change the 1549reader). Inotify will be used to give hints only and should not change the
1498semantics of \f(CW\*(C`ev_stat\*(C'\fR watchers, which means that libev sometimes needs 1550semantics of \f(CW\*(C`ev_stat\*(C'\fR watchers, which means that libev sometimes needs
1499to fall back to regular polling again even with inotify, but changes are 1551to fall back to regular polling again even with inotify, but changes are
1500usually detected immediately, and if the file exists there will be no 1552usually detected immediately, and if the file exists there will be no
1501polling. 1553polling.
1554.PP
1555\fIWatcher-Specific Functions and Data Members\fR
1556.IX Subsection "Watcher-Specific Functions and Data Members"
1502.IP "ev_stat_init (ev_stat *, callback, const char *path, ev_tstamp interval)" 4 1557.IP "ev_stat_init (ev_stat *, callback, const char *path, ev_tstamp interval)" 4
1503.IX Item "ev_stat_init (ev_stat *, callback, const char *path, ev_tstamp interval)" 1558.IX Item "ev_stat_init (ev_stat *, callback, const char *path, ev_tstamp interval)"
1504.PD 0 1559.PD 0
1505.IP "ev_stat_set (ev_stat *, const char *path, ev_tstamp interval)" 4 1560.IP "ev_stat_set (ev_stat *, const char *path, ev_tstamp interval)" 4
1506.IX Item "ev_stat_set (ev_stat *, const char *path, ev_tstamp interval)" 1561.IX Item "ev_stat_set (ev_stat *, const char *path, ev_tstamp interval)"
… …
1585.PP 1640.PP
1586Apart from keeping your process non-blocking (which is a useful 1641Apart from keeping your process non-blocking (which is a useful
1587effect on its own sometimes), idle watchers are a good place to do 1642effect on its own sometimes), idle watchers are a good place to do
1588\&\*(L"pseudo\-background processing\*(R", or delay processing stuff to after the 1643\&\*(L"pseudo\-background processing\*(R", or delay processing stuff to after the
1589event loop has handled all outstanding events. 1644event loop has handled all outstanding events.
1645.PP
1646\fIWatcher-Specific Functions and Data Members\fR
1647.IX Subsection "Watcher-Specific Functions and Data Members"
1590.IP "ev_idle_init (ev_signal *, callback)" 4 1648.IP "ev_idle_init (ev_signal *, callback)" 4
1591.IX Item "ev_idle_init (ev_signal *, callback)" 1649.IX Item "ev_idle_init (ev_signal *, callback)"
1592Initialises and configures the idle watcher \- it has no parameters of any 1650Initialises and configures the idle watcher \- it has no parameters of any
1593kind. There is a \f(CW\*(C`ev_idle_set\*(C'\fR macro, but using it is utterly pointless, 1651kind. There is a \f(CW\*(C`ev_idle_set\*(C'\fR macro, but using it is utterly pointless,
1594believe me. 1652believe me.
… …
1659supports this, they will be called before other \f(CW\*(C`ev_check\*(C'\fR watchers did 1717supports this, they will be called before other \f(CW\*(C`ev_check\*(C'\fR watchers did
1660their job. As \f(CW\*(C`ev_check\*(C'\fR watchers are often used to embed other event 1718their job. As \f(CW\*(C`ev_check\*(C'\fR watchers are often used to embed other event
1661loops those other event loops might be in an unusable state until their 1719loops those other event loops might be in an unusable state until their
1662\&\f(CW\*(C`ev_check\*(C'\fR watcher ran (always remind yourself to coexist peacefully with 1720\&\f(CW\*(C`ev_check\*(C'\fR watcher ran (always remind yourself to coexist peacefully with
1663others). 1721others).
1722.PP
1723\fIWatcher-Specific Functions and Data Members\fR
1724.IX Subsection "Watcher-Specific Functions and Data Members"
1664.IP "ev_prepare_init (ev_prepare *, callback)" 4 1725.IP "ev_prepare_init (ev_prepare *, callback)" 4
1665.IX Item "ev_prepare_init (ev_prepare *, callback)" 1726.IX Item "ev_prepare_init (ev_prepare *, callback)"
1666.PD 0 1727.PD 0
1667.IP "ev_check_init (ev_check *, callback)" 4 1728.IP "ev_check_init (ev_check *, callback)" 4
1668.IX Item "ev_check_init (ev_check *, callback)" 1729.IX Item "ev_check_init (ev_check *, callback)"
… …
1915\& ev_embed_start (loop_hi, &embed); 1976\& ev_embed_start (loop_hi, &embed);
1916\& } 1977\& }
1917\& else 1978\& else
1918\& loop_lo = loop_hi; 1979\& loop_lo = loop_hi;
1919.Ve 1980.Ve
1981.PP
1982\fIWatcher-Specific Functions and Data Members\fR
1983.IX Subsection "Watcher-Specific Functions and Data Members"
1920.IP "ev_embed_init (ev_embed *, callback, struct ev_loop *embedded_loop)" 4 1984.IP "ev_embed_init (ev_embed *, callback, struct ev_loop *embedded_loop)" 4
1921.IX Item "ev_embed_init (ev_embed *, callback, struct ev_loop *embedded_loop)" 1985.IX Item "ev_embed_init (ev_embed *, callback, struct ev_loop *embedded_loop)"
1922.PD 0 1986.PD 0
1923.IP "ev_embed_set (ev_embed *, callback, struct ev_loop *embedded_loop)" 4 1987.IP "ev_embed_set (ev_embed *, callback, struct ev_loop *embedded_loop)" 4
1924.IX Item "ev_embed_set (ev_embed *, callback, struct ev_loop *embedded_loop)" 1988.IX Item "ev_embed_set (ev_embed *, callback, struct ev_loop *embedded_loop)"
… …
1944\&\f(CW\*(C`ev_default_fork\*(C'\fR or \f(CW\*(C`ev_loop_fork\*(C'\fR). The invocation is done before the 2008\&\f(CW\*(C`ev_default_fork\*(C'\fR or \f(CW\*(C`ev_loop_fork\*(C'\fR). The invocation is done before the
1945event loop blocks next and before \f(CW\*(C`ev_check\*(C'\fR watchers are being called, 2009event loop blocks next and before \f(CW\*(C`ev_check\*(C'\fR watchers are being called,
1946and only in the child after the fork. If whoever good citizen calling 2010and only in the child after the fork. If whoever good citizen calling
1947\&\f(CW\*(C`ev_default_fork\*(C'\fR cheats and calls it in the wrong process, the fork 2011\&\f(CW\*(C`ev_default_fork\*(C'\fR cheats and calls it in the wrong process, the fork
1948handlers will be invoked, too, of course. 2012handlers will be invoked, too, of course.
2013.PP
2014\fIWatcher-Specific Functions and Data Members\fR
2015.IX Subsection "Watcher-Specific Functions and Data Members"
1949.IP "ev_fork_init (ev_signal *, callback)" 4 2016.IP "ev_fork_init (ev_signal *, callback)" 4
1950.IX Item "ev_fork_init (ev_signal *, callback)" 2017.IX Item "ev_fork_init (ev_signal *, callback)"
1951Initialises and configures the fork watcher \- it has no parameters of any 2018Initialises and configures the fork watcher \- it has no parameters of any
1952kind. There is a \f(CW\*(C`ev_fork_set\*(C'\fR macro, but using it is utterly pointless, 2019kind. There is a \f(CW\*(C`ev_fork_set\*(C'\fR macro, but using it is utterly pointless,
1953believe me. 2020believe me.
… …
2147Starts the watcher. Note that there is no \f(CW\*(C`loop\*(C'\fR argument, as the 2214Starts the watcher. Note that there is no \f(CW\*(C`loop\*(C'\fR argument, as the
2148constructor already stores the event loop. 2215constructor already stores the event loop.
2149.IP "w\->stop ()" 4 2216.IP "w\->stop ()" 4
2150.IX Item "w->stop ()" 2217.IX Item "w->stop ()"
2151Stops the watcher if it is active. Again, no \f(CW\*(C`loop\*(C'\fR argument. 2218Stops the watcher if it is active. Again, no \f(CW\*(C`loop\*(C'\fR argument.
2152.ie n .IP "w\->again () ""ev::timer""\fR, \f(CW""ev::periodic"" only" 4 2219.ie n .IP "w\->again () (""ev::timer""\fR, \f(CW""ev::periodic"" only)" 4
2153.el .IP "w\->again () \f(CWev::timer\fR, \f(CWev::periodic\fR only" 4 2220.el .IP "w\->again () (\f(CWev::timer\fR, \f(CWev::periodic\fR only)" 4
2154.IX Item "w->again () ev::timer, ev::periodic only" 2221.IX Item "w->again () (ev::timer, ev::periodic only)"
2155For \f(CW\*(C`ev::timer\*(C'\fR and \f(CW\*(C`ev::periodic\*(C'\fR, this invokes the corresponding 2222For \f(CW\*(C`ev::timer\*(C'\fR and \f(CW\*(C`ev::periodic\*(C'\fR, this invokes the corresponding
2156\&\f(CW\*(C`ev_TYPE_again\*(C'\fR function. 2223\&\f(CW\*(C`ev_TYPE_again\*(C'\fR function.
2157.ie n .IP "w\->sweep () ""ev::embed"" only" 4 2224.ie n .IP "w\->sweep () (""ev::embed"" only)" 4
2158.el .IP "w\->sweep () \f(CWev::embed\fR only" 4 2225.el .IP "w\->sweep () (\f(CWev::embed\fR only)" 4
2159.IX Item "w->sweep () ev::embed only" 2226.IX Item "w->sweep () (ev::embed only)"
2160Invokes \f(CW\*(C`ev_embed_sweep\*(C'\fR. 2227Invokes \f(CW\*(C`ev_embed_sweep\*(C'\fR.
2161.ie n .IP "w\->update () ""ev::stat"" only" 4 2228.ie n .IP "w\->update () (""ev::stat"" only)" 4
2162.el .IP "w\->update () \f(CWev::stat\fR only" 4 2229.el .IP "w\->update () (\f(CWev::stat\fR only)" 4
2163.IX Item "w->update () ev::stat only" 2230.IX Item "w->update () (ev::stat only)"
2164Invokes \f(CW\*(C`ev_stat_stat\*(C'\fR. 2231Invokes \f(CW\*(C`ev_stat_stat\*(C'\fR.
2165.RE 2232.RE
2166.RS 4 2233.RS 4
2167.RE 2234.RE
2168.PP 2235.PP
… …
2192\& io.start (fd, ev::READ); 2259\& io.start (fd, ev::READ);
2193\& } 2260\& }
2194.Ve 2261.Ve
2195.SH "MACRO MAGIC" 2262.SH "MACRO MAGIC"
2196.IX Header "MACRO MAGIC" 2263.IX Header "MACRO MAGIC"
2197Libev can be compiled with a variety of options, the most fundemantal is 2264Libev can be compiled with a variety of options, the most fundamantal
2198\&\f(CW\*(C`EV_MULTIPLICITY\*(C'\fR. This option determines whether (most) functions and 2265of which is \f(CW\*(C`EV_MULTIPLICITY\*(C'\fR. This option determines whether (most)
2199callbacks have an initial \f(CW\*(C`struct ev_loop *\*(C'\fR argument. 2266functions and callbacks have an initial \f(CW\*(C`struct ev_loop *\*(C'\fR argument.
2200.PP 2267.PP
2201To make it easier to write programs that cope with either variant, the 2268To make it easier to write programs that cope with either variant, the
2202following macros are defined: 2269following macros are defined:
2203.ie n .IP """EV_A""\fR, \f(CW""EV_A_""" 4 2270.ie n .IP """EV_A""\fR, \f(CW""EV_A_""" 4
2204.el .IP "\f(CWEV_A\fR, \f(CWEV_A_\fR" 4 2271.el .IP "\f(CWEV_A\fR, \f(CWEV_A_\fR" 4

Diff Legend

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