Commit Graph

18142 Commits

Author SHA1 Message Date
Mike Frysinger 089761d56d seccomp(2): Expand SECCOMP_RET_KILL documentation
First clarify that the process cannot catch this SIGSYS signal.
While the text currently says that, it's easy (IMO) to read
ambiguously and that it's referring to default behavior (no
handler -> process exits).

Then add details regarding coredump behavior.  Before Linux 4.11,
there was no way to get coredumps from such crashes.  Now we can
at least get crashes from single threaded processes.

Signed-off-by: Mike Frysinger <vapier@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:41:53 +02:00
Eric Biggers b2210694c0 execve.2: tfix
Signed-off-by: Eric Biggers <ebiggers@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:40:29 +02:00
Joe Brown 5df38b3325 getaddrinfo.3: wsfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:39:08 +02:00
Michael Kerrisk 25d4adc278 ld.so.8: Minor tweaks to Carlos's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:35:36 +02:00
Carlos O'Donell bbba55c221 ld.so.8: Expand DT_RUNPATH details.
ld.so.8: Expand DT_RUNPATH details.

Every 3 years we get asked why DT_RUNPATH doesn't work like DT_RPATH.
The most recent question was here:
https://www.sourceware.org/ml/libc-help/2017-06/msg00013.html

We need to expand the description of DT_RUNPATH to cover this situation
and explain that the DT_RUNPATH entries apply only to the immediate
DT_NEEDED, not that of another, say dlopen'd child object.

Applies to master.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:32:02 +02:00
Carlos O'Donell 0d4f6d6f88 getcontext.3: Exemplar structure should use 'ucontext_t'.
In glibc we just finished a round of purging 'struct ucontext'
which is not in the POSIX reserved namespace of *_t tags. This has
some consequences to applications using the non-standard struct
ucontext:
https://sourceware.org/glibc/wiki/Release/2.26#Removal_of_.27struct_ucontext.27
but it also fixes a namespace conformance issue which is always a
longterm pain for large portable programs.

It was noted by Peter Maydell
(https://sourceware.org/bugzilla/show_bug.cgi?id=21457) that the
linux man pages still had references to 'struct ucontext' but only
in the form of an exemplar structure.

The patch fixes the exemplar to match what is in glibc
and therefore it won't ever suggest users can use 'struct
ucontext'.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:29:59 +02:00
Michael Kerrisk a79107aefe madvise.2: Remove bogus text re POSIX_MADV_NOREUSE
There is a POSIX_FADV_NOREUSE for posix_fadvise(),
but no POSIX_MADV_NOREUSE for any API in POSIX.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:27:38 +02:00
Dr. Tobias Quathamer be3b29c722 posix_madvise.3: Remove paragraph about POSIX_FADV_NOREUSE
POSIX_FADV_NOREUSE is documented for posix_fadvise, and a
corresponding POSIX_MADV_NOREUSE flag is not specified by POSIX.

Thanks to Marc Lehmann <debian-reportbug@plan9.de>
See https://bugs.debian.org/865699

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:26:46 +02:00
Janne Snabb 3e3c1e2364 getrandom.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:20:04 +02:00
Jakub Wilk c52ba260ff ttyslot.3: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:19:25 +02:00
Jakub Wilk 690e8267ac tmpfs.5: ffix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:18:30 +02:00
Michael Kerrisk 941d289252 open.2: Note some further advantages of the *at() APIs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-27 08:54:09 +02:00
Michael Kerrisk 70376041ca process-keyring.7: Minor fix: SEE ALSO: remove self-reference
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-25 12:18:27 +02:00
Michael Kerrisk 2ad31d9de8 ttyname.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-25 12:15:59 +02:00
Michael Kerrisk 4084e9b949 request_key.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-25 12:12:49 +02:00
Michael Kerrisk f57d94ca99 malloc.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 16:29:50 +02:00
Michael Kerrisk bc045fdd60 malloc.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 16:29:50 +02:00
Michael Kerrisk 081eeee527 malloc.3: Document the reallocarray() added in glibc 2.26
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 16:29:50 +02:00
Michael Kerrisk 4b80e269ee malloc.3: Minor clarification to CONFORMING TO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 15:42:17 +02:00
Michael Kerrisk ceaad4d829 cfree.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 15:35:55 +02:00
Michael Kerrisk 32f5f04482 readv.2: glibc 2.26 adds library support for preadv2() and pwritev2()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 15:35:06 +02:00
Michael Kerrisk 9b601b66a9 readv.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 15:34:47 +02:00
Michael Kerrisk bc051678fe fpathconf.3: srcfix: Add self to copyright notice
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 21:15:57 +02:00
Michael Kerrisk 3509905bd8 fpathconf.3: Largely rewrite the description of _PC_CHOWN_RESTRICTED
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 21:14:56 +02:00
Michael Kerrisk 6cde427101 fpathconf.3: Rewrite description of _PC_PIPE_BUF
The existing description was not accurate, and lacked details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:58:17 +02:00
Michael Kerrisk 09c8f2e4ea fpathconf.3: Add an errors section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:50:53 +02:00
Michael Kerrisk a282334152 fpathconf.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:31:06 +02:00
Michael Kerrisk 5425e5c59c fpathconf.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:29:49 +02:00
Michael Kerrisk 081a3c719b fpathconf.3: Rework RETURN VALUE description to add more detail
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:29:49 +02:00
Michael Kerrisk 480ef6d924 sysconf.3: Rework RETURN VALUE description to add more detail
Make the discussion clearer, and add a few details.
Also, fix the problem report from Pavel Tikhomirov
who noted that the man page falsely said that errno
is not changed on a successful return.

Addresses https://bugzilla.kernel.org/show_bug.cgi?id=195955

Reported-by: Pavel Tikhomirov <ptikhomirov@virtuozzo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:29:49 +02:00
Michael Kerrisk 386732aa86 sysconf.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-17 10:40:40 +02:00
Michael Kerrisk 646896d32c sysconf.3: Add ERRORS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-17 09:53:56 +02:00
Michael Kerrisk cef01dbc3a ioctl.2: SEE ALSO: add ioctl_getfsmap(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:17 +02:00
Michael Kerrisk f17fab191b ioctl_getfsmap.2: ERRORS: order alphabetically
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:17 +02:00
Michael Kerrisk 47692d77fb ioctl_getfsmap.2: add VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:17 +02:00
Michael Kerrisk 427245197d ioctl_getfsmap.2: Fix ordering of sections
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:17 +02:00
Michael Kerrisk 194721a4cf ioctl_getfsmap.2: Minor fixes to Darrick Wong's page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:16 +02:00
Darrick J. Wong f0efd47a49 ioctl_getfsmap.2: Document the GETFSMAP ioctl
Document the new GETFSMAP ioctl that returns the physical layout of a
(disk-based) filesystem.

Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:16 +02:00
Michael Kerrisk 26bab9df0b getgrent.3, sigwait.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk bccf0b0760 getgrent.3: Note glibc 2.22 changes for feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk 6a43458b0a wait.2: Note glibc 2.26 changes to feature test macro requirements for waitid()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk 0b8f560ad9 sigevent.7: Mention signal.h header file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk 2079d4344e sigpause.3: Note glibc 2.26 changes to feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk cc7fb6123a sigpause.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk 4c931ba32b nl_langinfo.3: Note feature test macro requirements for nl_langinfo_l()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk 06adeea53d sigwait.3: Note glibc 2.26 feature test macro changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk 940758abfe bsd_signal.3: Note feature test macro requirements changes for glibc 2.26
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk a97ae929a6 flockfile.3: Note glibc 2.24 feature test macro requirement changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk f83b1bbc94 unlocked_stdio.3: Note glibc 2.24 feature test macro requirement changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk d4afcdb42d chmod.2: Note glibc 2.24 feature test macro requirements changes for fchmod()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00