A mirror of Man pages
Go to file
Denys Vlasenko ca302d0ee3 ptrace.2: Explain WNOHANG behavior and EINTR bug
I didn't like ithe "SIGKILL operates similarly, with exceptions"
phrase (if it's different, then it's not "similar", right?),
and now I got around to changing it. Now it says simply:
"SIGKILL does not generate signal-delivery-stop and therefore
the tracer can't suppress it."

Replaced "why WNOHANG is not reliable" example with a more
realistic one (the one which actually inspired to add this
information to man page in the first place): we got
ESRCH - process is gone! - but waitpid(WNOHANG) can still
confusingly return 0 "no processes to wait for".

Replaced "This means that unneeded trailing arguments may
be omitted" part with a much better recommendation
to never do that and to supply zero arguments instead.
(The part about "undocumentedness" of gcc behavior was bogus,
btw - deleted).

Expanded BUGS section with the explanation and an example
of visible strace behavior on the buggy syscalls which
exit with EINTR on ptrace attach. I hope this will lead
to people submitting better bug reports to lkml about
such syscalls.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
man1 ldd.1: Add security note on untrusted executables 2012-07-19 12:51:28 +02:00
man2 ptrace.2: Explain WNOHANG behavior and EINTR bug 2012-08-03 10:33:49 +02:00
man3 sigwait.3: Reword "is delivered" to "becomes pending" 2012-07-21 05:52:30 +02:00
man4 path_resolution.2, epoll.4, fifo.4, futex.4, complex.5, environ.5: Remove outdated links 2012-07-19 12:51:28 +02:00
man5 core.5: Note effect of madvise(2) MADV_DONTDUMP flag 2012-07-19 12:51:28 +02:00
man6 Wrapped long source lines 2008-07-06 15:10:32 +00:00
man7 netlink.7: Change description of "*_pid" fields to "Port ID" 2012-08-03 10:33:40 +02:00
man8 futimesat.2, mount.2, confstr.3, iconv.3, makedev.3, malloc.3, strcasecmp.3, strcat.3, strcmp.3, strcpy.3, strdup.3, strftime.3, strnlen.3, strpbrk.3, strspn.3, strtok.3, strxfrm.3, sk98lin.4, icmp.7, ipv6.7, packet.7, raw.7, rtnetlink.7, unix.7, x25.7, ldconfig.8, nscd.8: tstamp 2012-05-11 08:09:28 +12:00
scripts find_repeated_words.sh: Fix bug 2010-08-29 14:41:52 +02:00
Changes Start of man-pages-3.42: updating Changes and Changes.old 2012-05-11 08:21:44 +12:00
Changes.old Changes.old: tfix 2012-07-19 12:51:28 +02:00
Makefile Makefile: use "mkdir -p" instead of "-make" 2012-04-17 23:09:08 +12:00
README README: Point directly at contributing.html 2010-08-29 07:40:29 +02:00
man-pages-3.42.Announce Start of man-pages-3.42: updating .Announce and .lsm files 2012-05-11 08:21:44 +12:00
man-pages-3.42.lsm Start of man-pages-3.42: updating .Announce and .lsm files 2012-05-11 08:21:44 +12:00

README

This package contains Linux man pages for sections
2, 3, 4, 5, and 7. Some more information is given in the
`Announce' file.

Install by copying to your favourite location.
"make install" will just copy them to /usr/share/man/man[1-8].
"make" will move the pages from this package that are older than
the already installed ones to a subdirectory `not_installed',
then remove old versions (compressed or not),
compress the pages, and copy them to /usr/share/man/man[1-8].


Note that you may have to remove preformatted pages.

Note that sometimes these pages are duplicates of pages
also distributed in other packages. This has been reported
about dlclose.3, dlerror.3, dlopen.3, dlsym.3 (found in ld.so),
about resolver.3, resolv.conf.5 (found in bind-utils),
and about passwd.5, and mailaddr.7. Be careful not to
overwrite more up-to-date versions.
Reports on further duplicates are welcome.
Formerly present and now removed duplicates:
 exports.5 (found in nfs-server-2.2*),
 fstab.5, nfs.5 (found in util-linux-2.12*),
 lilo.8, lilo.conf.5 (found in lilo-21.6*).

Copyrights: These man pages come under various copyrights.
All pages are freely distributable when the nroff source is included.

If you have corrections and additions to suggest, see
http://www.kernel.org/doc/man-pages/contributing.html