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

Comparing libev/ev.pod (file contents):
Revision 1.323 by root, Sun Oct 24 18:01:26 2010 UTC vs.
Revision 1.326 by root, Sun Oct 24 19:44:27 2010 UTC

1112=item C<EV_FORK> 1112=item C<EV_FORK>
1113 1113
1114The event loop has been resumed in the child process after fork (see 1114The event loop has been resumed in the child process after fork (see
1115C<ev_fork>). 1115C<ev_fork>).
1116 1116
1117=item C<EV_CLEANUP>
1118
1119The event loop is abotu to be destroyed (see C<ev_cleanup>).
1120
1117=item C<EV_ASYNC> 1121=item C<EV_ASYNC>
1118 1122
1119The given async watcher has been asynchronously notified (see C<ev_async>). 1123The given async watcher has been asynchronously notified (see C<ev_async>).
1120 1124
1121=item C<EV_CUSTOM> 1125=item C<EV_CUSTOM>
3090 3094
3091=head3 Watcher-Specific Functions and Data Members 3095=head3 Watcher-Specific Functions and Data Members
3092 3096
3093=over 4 3097=over 4
3094 3098
3095=item ev_fork_init (ev_signal *, callback) 3099=item ev_fork_init (ev_fork *, callback)
3096 3100
3097Initialises and configures the fork watcher - it has no parameters of any 3101Initialises and configures the fork watcher - it has no parameters of any
3098kind. There is a C<ev_fork_set> macro, but using it is utterly pointless, 3102kind. There is a C<ev_fork_set> macro, but using it is utterly pointless,
3099believe me. 3103believe me.
3100 3104
3101=back 3105=back
3106
3107
3108=head2 C<ev_cleanup> - even the best things end
3109
3110Cleanup watchers are called just before the event loop they are registered
3111with is being destroyed.
3112
3113While there is no guarantee that the event loop gets destroyed, cleanup
3114watchers provide a convenient method to install cleanup hooks for your
3115program, worker threads and so on - you just to make sure to destroy the
3116loop when you want them to be invoked.
3117
3118=head3 Watcher-Specific Functions and Data Members
3119
3120=over 4
3121
3122=item ev_cleanup_init (ev_cleanup *, callback)
3123
3124Initialises and configures the cleanup watcher - it has no parameters of
3125any kind. There is a C<ev_cleanup_set> macro, but using it is utterly
3126pointless, believe me.
3127
3128=back
3129
3130Example: Register an atexit handler to destroy the default loop, so any
3131cleanup functions are called.
3132
3133 static void
3134 program_exits (void)
3135 {
3136 ev_loop_destroy (EV_DEFAULT_UC);
3137 }
3138
3139 ...
3140 atexit (program_exits);
3102 3141
3103 3142
3104=head2 C<ev_async> - how to wake up an event loop 3143=head2 C<ev_async> - how to wake up an event loop
3105 3144
3106In general, you cannot use an C<ev_run> from multiple threads or other 3145In general, you cannot use an C<ev_run> from multiple threads or other
4840 4879
4841=item C<ev_default_destroy> and C<ev_default_fork> have been removed 4880=item C<ev_default_destroy> and C<ev_default_fork> have been removed
4842 4881
4843These calls can be replaced easily by their C<ev_loop_xxx> counterparts: 4882These calls can be replaced easily by their C<ev_loop_xxx> counterparts:
4844 4883
4845 ev_loop_destroy (EV_DEFAULT); 4884 ev_loop_destroy (EV_DEFAULT_UC);
4846 ev_loop_fork (EV_DEFAULT); 4885 ev_loop_fork (EV_DEFAULT);
4847 4886
4848=item function/symbol renames 4887=item function/symbol renames
4849 4888
4850A number of functions and symbols have been renamed: 4889A number of functions and symbols have been renamed:

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines