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

Comparing libev/ev.pod (file contents):
Revision 1.118 by root, Thu Jan 10 06:00:55 2008 UTC vs.
Revision 1.119 by root, Tue Jan 15 04:07:37 2008 UTC

483Like C<ev_default_destroy>, but destroys an event loop created by an 483Like C<ev_default_destroy>, but destroys an event loop created by an
484earlier call to C<ev_loop_new>. 484earlier call to C<ev_loop_new>.
485 485
486=item ev_default_fork () 486=item ev_default_fork ()
487 487
488This function sets a flag that causes subsequent C<ev_loop> iterations
488This function reinitialises the kernel state for backends that have 489to reinitialise the kernel state for backends that have one. Despite the
489one. Despite the name, you can call it anytime, but it makes most sense 490name, you can call it anytime, but it makes most sense after forking, in
490after forking, in either the parent or child process (or both, but that 491the child process (or both child and parent, but that again makes little
491again makes little sense). 492sense). You I<must> call it in the child before using any of the libev
493functions, and it will only take effect at the next C<ev_loop> iteration.
492 494
493You I<must> call this function in the child process after forking if and 495On the other hand, you only need to call this function in the child
494only if you want to use the event library in both processes. If you just 496process if and only if you want to use the event library in the child. If
495fork+exec, you don't have to call it. 497you just fork+exec, you don't have to call it at all.
496 498
497The function itself is quite fast and it's usually not a problem to call 499The function itself is quite fast and it's usually not a problem to call
498it just in case after a fork. To make this easy, the function will fit in 500it just in case after a fork. To make this easy, the function will fit in
499quite nicely into a call to C<pthread_atfork>: 501quite nicely into a call to C<pthread_atfork>:
500 502
501 pthread_atfork (0, 0, ev_default_fork); 503 pthread_atfork (0, 0, ev_default_fork);
502
503At the moment, C<EVBACKEND_SELECT> and C<EVBACKEND_POLL> are safe to use
504without calling this function, so if you force one of those backends you
505do not need to care.
506 504
507=item ev_loop_fork (loop) 505=item ev_loop_fork (loop)
508 506
509Like C<ev_default_fork>, but acts on an event loop created by 507Like C<ev_default_fork>, but acts on an event loop created by
510C<ev_loop_new>. Yes, you have to call this on every allocated event loop 508C<ev_loop_new>. Yes, you have to call this on every allocated event loop

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines