Commit Graph

18223 Commits

Author SHA1 Message Date
Marko Myllynen a581f7593b locale.5: Refer to existing locales for encoding details
Mike Fabian and Rafał Luzynski were recently named as glibc
localedata maintainers [1] and after that there's been active
development on this front, including discussion whether it would
be ok to use ASCII or some other encoding as values for actual
locate data.

Since I don't think it would make sense to try to have different
explanation for each glibc version on the locale(5) man page, I'm
proposing that we apply the below patch so that we refer to
existing locale definition files in general and not spell out the
exact format or any certain locale as a definitive guideline.

If the situation changes in the future or new a new convention
meant to last forever is created then perhaps Mike and Rafał can
provide an update then as needed.

1) https://sourceware.org/ml/libc-alpha/2017-07/msg00477.html
2) https://sourceware.org/ml/libc-alpha/2017-07/msg00807.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 21:53:47 +02:00
Elliott Hughes 0f86e5b1be set_tid_address.2: Note that there's no glibc wrapper for set_tid_address()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 21:53:47 +02:00
Michael Kerrisk edc2a02212 cgroups.7: SEE ALSO: systemd-cgls(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-07 12:53:21 +02:00
Michael Kerrisk a568844159 select_tut.2: Clarify an ambiguity with respect to select() and EAGAIN
See https://bugzilla.kernel.org/show_bug.cgi?id=196345

Reported-by: Sergey Z. <zhurxx@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-22 09:44:17 +02:00
Alex Henrie 377ec1fda7 exp2.3: Remove C89 designation
[mtk: Confirmed by consulting C90 draft standard]

Signed-off-by: Alex Henrie <alexhenrie24@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-22 09:23:16 +02:00
Douglas Caetano dos Santos 8f66cfd74a bpf.2: ffix
'\' must be escaped.

Signed-off-by: Douglas Caetano dos Santos <douglascs@taghos.com.br>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-22 09:19:54 +02:00
Jakub Wilk 49145a385b Changes.old: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-22 09:18:57 +02:00
Michael Kerrisk 2540f8ffe9 Changes.old: Tweaks to 4.12 Changelog
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-22 09:18:25 +02:00
Michael Kerrisk a7e0d99174 signal.7: Since glibc 2.26, SIGUNUSED is no longer defined
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-21 06:07:11 +02:00
Michael Kerrisk c199053b7a capabilities.7: Note that a set-UID-root program may have an empty file capabilite set
Reported-by: Dennis Knorr <dennis.knorr@muenchen.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-18 22:46:20 +02:00
Michael Kerrisk 0603dda3f2 capabilities.7: Note semantics for a program that is set-UID-root and has capabilities
Note semantics for a program that is both set-user-ID-root and has
file capabilities.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-18 22:41:37 +02:00
Michael Kerrisk f612b48869 Changes.old: minor fix in 4.12 changelog
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-14 00:18:27 +02:00
Michael Kerrisk 1b46c44bdf Changes.old: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-14 00:14:08 +02:00
Michael Kerrisk 59ed2368c4 Start of man-pages-4.13: updating Changes and Changes.old 2017-07-14 00:12:22 +02:00
Michael Kerrisk 9ab8bfdc61 Start of man-pages-4.13: updating .Announce and .lsm files 2017-07-14 00:12:22 +02:00
Michael Kerrisk a25efa09e5 Start of man-pages-4.13: renaming .Announce and .lsm files 2017-07-14 00:12:22 +02:00
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