mirror of https://github.com/mkerrisk/man-pages
Changes: Read for 5.01
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk
parent
db2280ee7e
commit
f1aa88c2df
226
Changes
226
Changes
|
|
@ -10,26 +10,238 @@ The following people contributed patches/fixes or (noted in brackets
|
|||
in the changelog below) reports, notes, and ideas that have been
|
||||
incorporated in changes in this release:
|
||||
|
||||
Abhinav Upadhyay <er.abhinav.upadhyay@gmail.com>
|
||||
Andreas Korb <andreas.d.korb@gmail.com>
|
||||
Anisse Astier <anisse@astier.eu>
|
||||
Brice Goglin <Brice.Goglin@inria.fr>
|
||||
Carlos O'Donell <carlos@redhat.com>
|
||||
Dr. Jürgen Sauermann <mail@xn--jrgen-sauermann-zvb.de>
|
||||
Egmont Koblinger <egmont@gmail.com>
|
||||
Elias Benali <stackptr@users.sourceforge.net>
|
||||
Elliot Hughes <enh@google.com>
|
||||
Florian Weimer <fweimer@redhat.com>
|
||||
Hugues Evrard <hevrard@google.com>
|
||||
Jakub Nowak <jakub.jakub.nowak@gmail.com>
|
||||
Jakub Wilk <jwilk@jwilk.net>
|
||||
Keegan Saunders <keeganwsaunders@gmail.com>
|
||||
Lucas Werkmeister <mail@lucaswerkmeister.de>
|
||||
Marcus Huewe <suse-tux@gmx.de>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Michael Witten <mfwitten@gmail.com>
|
||||
Seth Troisi <sethtroisi@google.com>
|
||||
Slavomir Kaslev <kaslevs@vmware.com>
|
||||
Vincent Lefevre <vincent@vinc17.net>
|
||||
Wladimir Mutel <muwlgr@gmail.com>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
||||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
tsearch.3
|
||||
Florian Weimer [Michael Kerrisk]
|
||||
Document the twalk_r() function added in glibc 2.30
|
||||
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
twalk_r.3
|
||||
Michael Kerrisk
|
||||
New link to twalk(3) page
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
accept.2
|
||||
Michael Kerrisk
|
||||
Note that 'addrlen' is left unchanged in the event of an error
|
||||
See http://austingroupbugs.net/view.php?id=836.
|
||||
|
||||
bpf.2
|
||||
Michael Kerrisk
|
||||
Update kernel version info for JIT compiler
|
||||
|
||||
clone.2
|
||||
Michael Kerrisk [Jakub Nowak]
|
||||
CLONE_CHILD_SETTID has effect before clone() returns *in the child*
|
||||
CLONE_CHILD_SETTID may not have had effect by the time clone()
|
||||
returns in the parent, which could be relevant if the
|
||||
CLONE_VM flag is employed. The relevant kernel code is in
|
||||
schedule_tail(), which is called in ret_from_fork()
|
||||
in the child.
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=203105
|
||||
|
||||
execve.2
|
||||
exec.3
|
||||
Michael Kerrisk [Dr. Jürgen Sauermann]
|
||||
Consistently use the term 'pathname' (not 'path')
|
||||
|
||||
execve.2
|
||||
Michael Kerrisk
|
||||
Note that stack+environ size is also limited to 3/4 of _STK_LIM
|
||||
In fs/exec.c::prepare_arg_pages(), we have:
|
||||
|
||||
limit = _STK_LIM / 4 * 3;
|
||||
limit = min(limit, bprm->rlim_stack.rlim_cur / 4);
|
||||
Michael Kerrisk [Dr. Jürgen Sauermann]
|
||||
SEE ALSO: refer to exec(3) (rather than execl(3))
|
||||
|
||||
pipe.2
|
||||
Michael Kerrisk
|
||||
Note that 'pipefd' is left unchanged in the event of an error
|
||||
See http://austingroupbugs.net/view.php?id=467.
|
||||
|
||||
sched_setaffinity.2
|
||||
Michael Kerrisk [Brice Goglin]
|
||||
Correct details of return value of sched_getaffinity() syscall
|
||||
Things changed a little with:
|
||||
|
||||
commit cd3d8031eb4311e516329aee03c79a08333141f1
|
||||
Author: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
|
||||
Date: Fri Mar 12 16:15:36 2010 +0900
|
||||
|
||||
setfsgid.2
|
||||
Michael Kerrisk
|
||||
Rewrite for improved clarity and defer to setfsuid() for details
|
||||
Rewrite for improved clarity and defer to setfsuid(2) for the
|
||||
rationale of the fsGID rather than repeating the same details
|
||||
in this page.
|
||||
|
||||
setfsuid.2
|
||||
Michael Kerrisk
|
||||
Rewrite for improved clarity and to hint history more explicitly
|
||||
The current text reads somewhat clumsily. Rewrite it to introduce
|
||||
the eUID and fsUID in parallel, and more clearly hint at the the
|
||||
historical rationale for the fsUID, which is detailed lower in
|
||||
the page.
|
||||
|
||||
socketpair.2
|
||||
Michael Kerrisk
|
||||
Clarify that 'sv' is left unchanged in the event of an error
|
||||
See also http://austingroupbugs.net/view.php?id=483.
|
||||
|
||||
splice.2
|
||||
Slavomir Kaslev
|
||||
EAGAIN can occur when called on nonblocking file descriptors
|
||||
|
||||
syscalls.2
|
||||
Michael Kerrisk [Andreas Korb]
|
||||
Remove crufty text about i386 syscall dispatch table
|
||||
The removed text long ago ceased to be accurate. Nowadays, the
|
||||
dispatch table is autogenerated when building the kernel (via
|
||||
the kernel makefile, arch/x86/entry/syscalls/Makefile).
|
||||
|
||||
tee.2
|
||||
Slavomir Kaslev
|
||||
EAGAIN can occur when called on nonblocking file descriptors
|
||||
|
||||
fopen.3
|
||||
Elliot Hughes
|
||||
Explain BSD vs glibc "a+" difference
|
||||
Where is the initial read position for an "a+" stream?
|
||||
|
||||
POSIX leaves this unspecified. Most BSD man pages are silent, and
|
||||
MacOS has the ambiguous "The stream is positioned at the end of
|
||||
the file", not differentiating between reads and writes other than
|
||||
to say that fseek(3) does not affect writes. glibc's documentation
|
||||
explicitly specifies that the initial read position is the
|
||||
beginning of the file.
|
||||
|
||||
My new wording is based on the BSD implementations, so you may
|
||||
prefer to replace the non-glibc section with "unspecified", or
|
||||
indeed remove all claims about the initial read position.
|
||||
|
||||
mallinfo.3
|
||||
Elliott Hughes
|
||||
Further discourage use of mallinfo()
|
||||
The BUGS section already explains why you need to be cautious
|
||||
about using mallinfo, but given the number of bug reports we see
|
||||
on Android, it seems not many people are reading that far. Call it
|
||||
out up front.
|
||||
|
||||
malloc_trim.3
|
||||
Carlos O'Donell
|
||||
Update trimming information
|
||||
Since glibc 2.8, commit 68631c8eb92, the malloc_trim function has
|
||||
iterated over all arenas and free'd back to the OS all page runs
|
||||
that were free. This allows an application to call malloc_trim to
|
||||
consolidate fragmented chunks and free back any pages it can to
|
||||
potentially reduce RSS usage.
|
||||
|
||||
posix_memalign.3
|
||||
Elliot Hughes
|
||||
Some functions set errno
|
||||
True of bionic, glibc, and musl. (I didn't check elsewhere.)
|
||||
|
||||
resolver.3
|
||||
Michael Kerrisk [Wladimir Mutel]
|
||||
Mention that some functions set 'h_errno'
|
||||
|
||||
stdarg.3
|
||||
Michael Kerrisk [Vincent Lefevre]
|
||||
Remove the NOTES section describing the ancient varargs macros
|
||||
stdarg.h is now 30 years old, and gcc long ago (2004) ceased to
|
||||
implement <varargs.h>. There seems little value in keeping this
|
||||
text.
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=202907
|
||||
Michael Kerrisk [Egmont Koblinger]
|
||||
Add a note that "..." in function signature means a variadic function
|
||||
Egmont suggested adding this, because the string "..." appears
|
||||
at several other points in the page, but just to indicate that
|
||||
some text is omitted from example code.
|
||||
|
||||
strerror.3
|
||||
Jakub Wilk
|
||||
Don't discuss buffer size for strerror_l()
|
||||
Unlike strerror_r(), strerror_l() doesn't take buffer length as an
|
||||
argument.
|
||||
|
||||
strtol.3
|
||||
strtoul.3
|
||||
Jakub Wilk
|
||||
SEE ALSO: add strtoimax(3), strtoumax(3)
|
||||
|
||||
sysconf.3
|
||||
Michael Kerrisk [Hugues Evrard]
|
||||
Clearly note that _SC_PAGESIZE and _SC_PAGE_SIZE are synonyms
|
||||
|
||||
tsearch.3
|
||||
Florian Weimer
|
||||
Do not use const arguments in twalk() callback
|
||||
The const specifier is not part of the prototype (it only applies
|
||||
to the implementation), so showing it here confuses the reader.
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: add missing definition of 'VISIT' type
|
||||
Michael Kerrisk
|
||||
Reformat twalk() and twalk_r() prototypes for easier readability
|
||||
|
||||
console_codes.4
|
||||
Jakub Wilk
|
||||
Document that \e[1;n] and \e[2;n] support 16 colors
|
||||
Source: setterm_command() in drivers/tty/vt/vt.c
|
||||
|
||||
elf.5
|
||||
Michael Kerrisk [Keegan Saunders]
|
||||
A data segment does not have PF_X
|
||||
|
||||
proc.5
|
||||
Michael Witten [Anisse Astier]
|
||||
Add missing Inode field to /proc/net/unix
|
||||
|
||||
hostname.7
|
||||
Florian Weimer
|
||||
HOSTALIASES/search path processing is DNS-specific
|
||||
Other NSS modules do not necessarily honor these settings.
|
||||
|
||||
inode.7
|
||||
Michael Kerrisk
|
||||
Note that timestamp fields measure time starting at the Epoch
|
||||
Michael Kerrisk
|
||||
Timestamp fields are structures that include a nanosecond component
|
||||
Michael Kerrisk
|
||||
Add references to execve(2) to describe set-UID/set-GID behaviors
|
||||
|
|
|
|||
Loading…
Reference in New Issue