Commit Graph

18007 Commits

Author SHA1 Message Date
Michael Kerrisk b58cfac74d Ready for 4.12 2017-07-13 14:28:29 +02:00
Michael Kerrisk 230ed8339d Removed trailing white space at end of lines 2017-07-13 14:22:45 +02:00
Michael Kerrisk f55a6d598d Changes, ldd.1, chown.2, epoll_wait.2, get_mempolicy.2, ioctl_getfsmap.2, madvise.2, membarrier.2, mount.2, pipe.2, readv.2, seccomp.2, sigaltstack.2, splice.2, tee.2, timer_create.2, vmsplice.2, acosh.3, asinh.3, atanh.3, bsd_signal.3, dl_iterate_phdr.3, dlsym.3, flockfile.3, fpathconf.3, ftw.3, getaddrinfo.3, getcontext.3, getgrent.3, if_nametoindex.3, malloc.3, nl_langinfo.3, posix_madvise.3, ptsname.3, rand.3, resolver.3, sigpause.3, sigwait.3, strtol.3, sysconf.3, ttyslot.3, unlocked_stdio.3, unlockpt.3, capabilities.7, cgroup_namespaces.7, inode.7, man.7, pipe.7, sigevent.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 14:22:45 +02:00
Michael Kerrisk ed4e8a74f0 Changes: Tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 14:22:45 +02:00
Michael Kerrisk e0ccee7f67 getpid.2: srcfix: add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 07:45:13 +02:00
Michael Kerrisk abcf3b1db9 clone.2: Update BUGS to reflect fact that PID caching was removed in glibc 2.25
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 07:45:05 +02:00
Michael Kerrisk 9338d37b76 getpid.2: More tidy-ups in discussion of removal of getpid() PID caching
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 07:05:28 +02:00
Michael Kerrisk cd065c7aec getpid.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-12 21:23:01 +02:00
Michael Kerrisk 995865aa06 getpid.2: Minor tweaks to Carlos's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-12 21:22:24 +02:00
Carlos O'Donell 7693d1e5c0 getpid.2: Note that PID caching is removed as of glibc 2.25
Since glibc 2.25 the PID cache is removed.

Rationale given in the release notes:
https://sourceware.org/glibc/wiki/Release/2.25#pid_cache_removal
~~~
3.2.3. Calls to getpid are no longer cached

The PID cache used by glibc has been removed. In certain scenarios
the cache was not 100% reliable and because of that it was deemed
safer to remove the cache than to potentially return a wrong
answer.

Applications performing getpid() calls in a loop will see the
worst case performance degradation as the library call will
perform a system call at each invocation. Such application uses
were known to exist at least in OpenSSL (fork()-based PRNG
invalidation), but supporting the performance of that specific
invalidation mechanism was not judged to have sufficient value
against immediate and long-term benefits of removing the cache.

Functional reasons exist for the PID cache removal including
problems with PID namespaces, interoperability with raw system
calls (BZ#17214, Chrome: Issue 800183004), and improvements to
spawn (BZ#19957). Performance is actually increased in
pthread_create() with the removal of the cache since the
implementation no longer needs to perform an invalidation step.

Applications performing getpid() in a loop that need to do some
level of fork()-based invalidation can instead use
pthread_atfork() to register handlers to handle the invalidation.
There is work-in-progress to make pthread_atfork() available to
applications that do not link against libpthread.so (Provide
pthread_atfork() without libpthread.so).

Other kinds of invalidation are not supported and the glibc
community will actively look at a kernel assisted mechanism for
state management across fork(), vfork(), clone() and other
interfaces which can benefit from such semantics. It is the same
type of solution required for crypto PRNG reset across such API
calls.
~~~

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-12 21:18:06 +02:00
Long Wang f0e956cafb getline.3: wfix
Signed-off-by: Long Wang <w@laoqinren.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-12 19:36:34 +02:00
Alex Henrie 7cada58cad acosh.3, asinh.3, atanh.3: Remove C89 designation.
See https://bugzilla.kernel.org/show_bug.cgi?id=196319

[mtk: confirmed from review of draft of C90 standard]

Signed-off-by: Alex Henrie <alexhenrie24@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-11 09:59:50 +02:00
Michael Kerrisk 7f82d0b062 capabilities.7: Fix reversed descriptions of CAP_MAC_OVERRIDE and CAP_MAC_ADMIN
Reported-by: David Lewis <davlewi3@cisco.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:53:17 +02:00
sulit c83ad1ade0 bpf.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:50:08 +02:00
Michael Kerrisk baaf65e88a seccomp.2: Minor tweaks to Mike's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:46:44 +02:00
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