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

Comparing libev/ev.pod (file contents):
Revision 1.82 by root, Wed Dec 12 17:55:06 2007 UTC vs.
Revision 1.85 by root, Mon Dec 17 07:24:12 2007 UTC

1220 1220
1221The current reschedule callback, or C<0>, if this functionality is 1221The current reschedule callback, or C<0>, if this functionality is
1222switched off. Can be changed any time, but changes only take effect when 1222switched off. Can be changed any time, but changes only take effect when
1223the periodic timer fires or C<ev_periodic_again> is being called. 1223the periodic timer fires or C<ev_periodic_again> is being called.
1224 1224
1225=item ev_tstamp at [read-only]
1226
1227When active, contains the absolute time that the watcher is supposed to
1228trigger next.
1229
1225=back 1230=back
1226 1231
1227Example: Call a callback every hour, or, more precisely, whenever the 1232Example: Call a callback every hour, or, more precisely, whenever the
1228system clock is divisible by 3600. The callback invocation times have 1233system clock is divisible by 3600. The callback invocation times have
1229potentially a lot of jittering, but good long-term stability. 1234potentially a lot of jittering, but good long-term stability.
1792event loop blocks next and before C<ev_check> watchers are being called, 1797event loop blocks next and before C<ev_check> watchers are being called,
1793and only in the child after the fork. If whoever good citizen calling 1798and only in the child after the fork. If whoever good citizen calling
1794C<ev_default_fork> cheats and calls it in the wrong process, the fork 1799C<ev_default_fork> cheats and calls it in the wrong process, the fork
1795handlers will be invoked, too, of course. 1800handlers will be invoked, too, of course.
1796 1801
1802=head3 Watcher-Specific Functions and Data Members
1803
1797=over 4 1804=over 4
1798 1805
1799=item ev_fork_init (ev_signal *, callback) 1806=item ev_fork_init (ev_signal *, callback)
1800 1807
1801Initialises and configures the fork watcher - it has no parameters of any 1808Initialises and configures the fork watcher - it has no parameters of any
2017 2024
2018=item w->stop () 2025=item w->stop ()
2019 2026
2020Stops the watcher if it is active. Again, no C<loop> argument. 2027Stops the watcher if it is active. Again, no C<loop> argument.
2021 2028
2022=item w->again () C<ev::timer>, C<ev::periodic> only 2029=item w->again () (C<ev::timer>, C<ev::periodic> only)
2023 2030
2024For C<ev::timer> and C<ev::periodic>, this invokes the corresponding 2031For C<ev::timer> and C<ev::periodic>, this invokes the corresponding
2025C<ev_TYPE_again> function. 2032C<ev_TYPE_again> function.
2026 2033
2027=item w->sweep () C<ev::embed> only 2034=item w->sweep () (C<ev::embed> only)
2028 2035
2029Invokes C<ev_embed_sweep>. 2036Invokes C<ev_embed_sweep>.
2030 2037
2031=item w->update () C<ev::stat> only 2038=item w->update () (C<ev::stat> only)
2032 2039
2033Invokes C<ev_stat_stat>. 2040Invokes C<ev_stat_stat>.
2034 2041
2035=back 2042=back
2036 2043
2056 } 2063 }
2057 2064
2058 2065
2059=head1 MACRO MAGIC 2066=head1 MACRO MAGIC
2060 2067
2061Libev can be compiled with a variety of options, the most fundemantal is 2068Libev can be compiled with a variety of options, the most fundamantal
2062C<EV_MULTIPLICITY>. This option determines whether (most) functions and 2069of which is C<EV_MULTIPLICITY>. This option determines whether (most)
2063callbacks have an initial C<struct ev_loop *> argument. 2070functions and callbacks have an initial C<struct ev_loop *> argument.
2064 2071
2065To make it easier to write programs that cope with either variant, the 2072To make it easier to write programs that cope with either variant, the
2066following macros are defined: 2073following macros are defined:
2067 2074
2068=over 4 2075=over 4

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines