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
projects / thirdparty / man-pages.git / commitdiff
