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

Comparing libev/ev.pod (file contents):
Revision 1.136 by root, Thu Mar 13 13:06:16 2008 UTC vs.
Revision 1.138 by root, Mon Mar 31 01:14:12 2008 UTC

1085To support fork in your programs, you either have to call 1085To support fork in your programs, you either have to call
1086C<ev_default_fork ()> or C<ev_loop_fork ()> after a fork in the child, 1086C<ev_default_fork ()> or C<ev_loop_fork ()> after a fork in the child,
1087enable C<EVFLAG_FORKCHECK>, or resort to C<EVBACKEND_SELECT> or 1087enable C<EVFLAG_FORKCHECK>, or resort to C<EVBACKEND_SELECT> or
1088C<EVBACKEND_POLL>. 1088C<EVBACKEND_POLL>.
1089 1089
1090=head3 The special problem of SIGPIPE
1091
1092While not really specific to libev, it is easy to forget about SIGPIPE:
1093when reading from a pipe whose other end has been closed, your program
1094gets send a SIGPIPE, which, by default, aborts your program. For most
1095programs this is sensible behaviour, for daemons, this is usually
1096undesirable.
1097
1098So when you encounter spurious, unexplained daemon exits, make sure you
1099ignore SIGPIPE (and maybe make sure you log the exit status of your daemon
1100somewhere, as that would have given you a big clue).
1101
1090 1102
1091=head3 Watcher-Specific Functions 1103=head3 Watcher-Specific Functions
1092 1104
1093=over 4 1105=over 4
1094 1106
1599reader). Inotify will be used to give hints only and should not change the 1611reader). Inotify will be used to give hints only and should not change the
1600semantics of C<ev_stat> watchers, which means that libev sometimes needs 1612semantics of C<ev_stat> watchers, which means that libev sometimes needs
1601to fall back to regular polling again even with inotify, but changes are 1613to fall back to regular polling again even with inotify, but changes are
1602usually detected immediately, and if the file exists there will be no 1614usually detected immediately, and if the file exists there will be no
1603polling. 1615polling.
1616
1617=head3 ABI Issues (Largefile Support)
1618
1619Libev by default (unless the user overrides this) uses the default
1620compilation environment, which means that on systems with optionally
1621disabled large file support, you get the 32 bit version of the stat
1622structure. When using the library from programs that change the ABI to
1623use 64 bit file offsets the programs will fail. In that case you have to
1624compile libev with the same flags to get binary compatibility. This is
1625obviously the case with any flags that change the ABI, but the problem is
1626most noticably with ev_stat and largefile support.
1604 1627
1605=head3 Inotify 1628=head3 Inotify
1606 1629
1607When C<inotify (7)> support has been compiled into libev (generally only 1630When C<inotify (7)> support has been compiled into libev (generally only
1608available on Linux) and present at runtime, it will be used to speed up 1631available on Linux) and present at runtime, it will be used to speed up

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines