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

Comparing libev/ev.pod (file contents):
Revision 1.21 by root, Mon Nov 12 09:07:10 2007 UTC vs.
Revision 1.22 by root, Mon Nov 12 18:36:42 2007 UTC

… …
425required if you know what you are doing). 425required if you know what you are doing).
426 426
427You have to be careful with dup'ed file descriptors, though. Some backends 427You have to be careful with dup'ed file descriptors, though. Some backends
428(the linux epoll backend is a notable example) cannot handle dup'ed file 428(the linux epoll backend is a notable example) cannot handle dup'ed file
429descriptors correctly if you register interest in two or more fds pointing 429descriptors correctly if you register interest in two or more fds pointing
430to the same file/socket etc. description. 430to the same file/socket etc. description (that is, they share the same
431underlying "file open").
431 432
432If you must do this, then force the use of a known-to-be-good backend 433If you must do this, then force the use of a known-to-be-good backend
433(at the time of this writing, this includes only EVMETHOD_SELECT and 434(at the time of this writing, this includes only EVMETHOD_SELECT and
434EVMETHOD_POLL). 435EVMETHOD_POLL).
435 436
… …
449 450
450Timer watchers are simple relative timers that generate an event after a 451Timer watchers are simple relative timers that generate an event after a
451given time, and optionally repeating in regular intervals after that. 452given time, and optionally repeating in regular intervals after that.
452 453
453The timers are based on real time, that is, if you register an event that 454The timers are based on real time, that is, if you register an event that
454times out after an hour and youreset your system clock to last years 455times out after an hour and you reset your system clock to last years
455time, it will still time out after (roughly) and hour. "Roughly" because 456time, it will still time out after (roughly) and hour. "Roughly" because
456detecting time jumps is hard, and soem inaccuracies are unavoidable (the 457detecting time jumps is hard, and soem inaccuracies are unavoidable (the
457monotonic clock option helps a lot here). 458monotonic clock option helps a lot here).
458 459
459The relative timeouts are calculated relative to the C<ev_now ()> 460The relative timeouts are calculated relative to the C<ev_now ()>
460time. This is usually the right thing as this timestamp refers to the time 461time. This is usually the right thing as this timestamp refers to the time
461of the event triggering whatever timeout you are modifying/starting. If 462of the event triggering whatever timeout you are modifying/starting. If
462you suspect event processing to be delayed and you *need* to base the timeout 463you suspect event processing to be delayed and you *need* to base the timeout
463ion the current time, use something like this to adjust for this: 464on the current time, use something like this to adjust for this:
464 465
465 ev_timer_set (&timer, after + ev_now () - ev_time (), 0.); 466 ev_timer_set (&timer, after + ev_now () - ev_time (), 0.);
466 467
467=over 4 468=over 4
468 469
… …
476later, again, and again, until stopped manually. 477later, again, and again, until stopped manually.
477 478
478The timer itself will do a best-effort at avoiding drift, that is, if you 479The timer itself will do a best-effort at avoiding drift, that is, if you
479configure a timer to trigger every 10 seconds, then it will trigger at 480configure a timer to trigger every 10 seconds, then it will trigger at
480exactly 10 second intervals. If, however, your program cannot keep up with 481exactly 10 second intervals. If, however, your program cannot keep up with
481the timer (ecause it takes longer than those 10 seconds to do stuff) the 482the timer (because it takes longer than those 10 seconds to do stuff) the
482timer will not fire more than once per event loop iteration. 483timer will not fire more than once per event loop iteration.
483 484
484=item ev_timer_again (loop) 485=item ev_timer_again (loop)
485 486
486This will act as if the timer timed out and restart it again if it is 487This will act as if the timer timed out and restart it again if it is
… …
725=item ev_once (loop, int fd, int events, ev_tstamp timeout, callback) 726=item ev_once (loop, int fd, int events, ev_tstamp timeout, callback)
726 727
727This function combines a simple timer and an I/O watcher, calls your 728This function combines a simple timer and an I/O watcher, calls your
728callback on whichever event happens first and automatically stop both 729callback on whichever event happens first and automatically stop both
729watchers. This is useful if you want to wait for a single event on an fd 730watchers. This is useful if you want to wait for a single event on an fd
730or timeout without havign to allocate/configure/start/stop/free one or 731or timeout without having to allocate/configure/start/stop/free one or
731more watchers yourself. 732more watchers yourself.
732 733
733If C<fd> is less than 0, then no I/O watcher will be started and events 734If C<fd> is less than 0, then no I/O watcher will be started and events
734is being ignored. Otherwise, an C<ev_io> watcher for the given C<fd> and 735is being ignored. Otherwise, an C<ev_io> watcher for the given C<fd> and
735C<events> set will be craeted and started. 736C<events> set will be craeted and started.

Diff Legend

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