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

Comparing libev/ev.3 (file contents):
Revision 1.120 by root, Wed Jan 22 13:33:44 2020 UTC vs.
Revision 1.121 by root, Wed Mar 18 12:21:48 2020 UTC

… …
131.\} 131.\}
132.rm #[ #] #H #V #F C 132.rm #[ #] #H #V #F C
133.\" ======================================================================== 133.\" ========================================================================
134.\" 134.\"
135.IX Title "LIBEV 3" 135.IX Title "LIBEV 3"
136.TH LIBEV 3 "2020-01-22" "libev-4.31" "libev - high performance full featured event loop" 136.TH LIBEV 3 "2020-03-12" "libev-4.31" "libev - high performance full featured event loop"
137.\" For nroff, turn off justification. Always turn off hyphenation; it makes 137.\" For nroff, turn off justification. Always turn off hyphenation; it makes
138.\" way too many mistakes in technical documents. 138.\" way too many mistakes in technical documents.
139.if n .ad l 139.if n .ad l
140.nh 140.nh
141.SH "NAME" 141.SH "NAME"
… …
1772.PP 1772.PP
1773Most members are additionally marked with either \fI[read\-only]\fR, meaning 1773Most members are additionally marked with either \fI[read\-only]\fR, meaning
1774that, while the watcher is active, you can look at the member and expect 1774that, while the watcher is active, you can look at the member and expect
1775some sensible content, but you must not modify it (you can modify it while 1775some sensible content, but you must not modify it (you can modify it while
1776the watcher is stopped to your hearts content), or \fI[read\-write]\fR, which 1776the watcher is stopped to your hearts content), or \fI[read\-write]\fR, which
1777means you can expect it to have some sensible content while the watcher 1777means you can expect it to have some sensible content while the watcher is
1778is active, but you can also modify it. Modifying it may not do something 1778active, but you can also modify it (within the same thread as the event
1779loop, i.e. without creating data races). Modifying it may not do something
1779sensible or take immediate effect (or do anything at all), but libev will 1780sensible or take immediate effect (or do anything at all), but libev will
1780not crash or malfunction in any way. 1781not crash or malfunction in any way.
1781.PP 1782.PP
1782In any case, the documentation for each member will explain what the 1783In any case, the documentation for each member will explain what the
1783effects are, and if there are any additional access restrictions. 1784effects are, and if there are any additional access restrictions.
… …
1964supported, but not specially optimized \- if your program sometimes happens 1965supported, but not specially optimized \- if your program sometimes happens
1965to generate this combination this is fine, but if it is easy to avoid 1966to generate this combination this is fine, but if it is easy to avoid
1966starting an io watcher watching for no events you should do so. 1967starting an io watcher watching for no events you should do so.
1967.IP "ev_io_modify (ev_io *, int events)" 4 1968.IP "ev_io_modify (ev_io *, int events)" 4
1968.IX Item "ev_io_modify (ev_io *, int events)" 1969.IX Item "ev_io_modify (ev_io *, int events)"
1969Similar to \f(CW\*(C`ev_io_set\*(C'\fR, but only changes the event mask. Using this might 1970Similar to \f(CW\*(C`ev_io_set\*(C'\fR, but only changes the requested events. Using this
1970be faster with some backends, as libev can assume that the \f(CW\*(C`fd\*(C'\fR still 1971might be faster with some backends, as libev can assume that the \f(CW\*(C`fd\*(C'\fR
1971refers to the same underlying file description, something it cannot do 1972still refers to the same underlying file description, something it cannot
1972when using \f(CW\*(C`ev_io_set\*(C'\fR. 1973do when using \f(CW\*(C`ev_io_set\*(C'\fR.
1973.IP "int fd [no\-modify]" 4 1974.IP "int fd [no\-modify]" 4
1974.IX Item "int fd [no-modify]" 1975.IX Item "int fd [no-modify]"
1975The file descriptor being watched. While it can be read at any time, you 1976The file descriptor being watched. While it can be read at any time, you
1976must not modify this member even when the watcher is stopped \- always use 1977must not modify this member even when the watcher is stopped \- always use
1977\&\f(CW\*(C`ev_io_set\*(C'\fR for that. 1978\&\f(CW\*(C`ev_io_set\*(C'\fR for that.

Diff Legend

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