Start of man-pages-4.07: updating Changes and Changes.old

This commit is contained in:
Michael Kerrisk 2016-05-10 07:27:15 +02:00
parent 6361ead67e
commit 5290e86556
2 changed files with 269 additions and 232 deletions

239
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-4.06 ====================
==================== Changes in man-pages-4.07 ====================
Released: 2016-05-09, Oslo
Released: ????-??-??, Munich
Contributors
@ -10,26 +10,6 @@ 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:
Alexander Miller <alex.miller@gmx.de>
Alon Bar-Lev <alon.barlev@gmail.com>
Benjamin Poirier <bpoirier@suse.com>
Christoph Hellwig <hch@lst.de>
Colin Ian King <colin.king@canonical.com>
Dr. Tobias Quathamer <toddy@debian.org>
Ed Avis <eda@waniasset.com>
Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
Heinrich Schuchardt <xypron.glpk@gmx.de>
Jakub Wilk <jwilk@jwilk.net>
Jordan Birks <birkses@hotmail.com>
Marko Myllynen <myllynen@redhat.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Nikola Forró <nforro@redhat.com>
Rasmus Villemoes <linux@rasmusvillemoes.dk>
Serge E. Hallyn <serge@hallyn.com>
Serge Hallyn <serge.hallyn@ubuntu.com>
Valery Reznic <valery_reznic@yahoo.com>
Zubair Lutfullah Kakakhel <Zubair.Kakakhel@imgtec.com>
Apologies if I missed anyone!
@ -37,224 +17,19 @@ Apologies if I missed anyone!
New and rewritten pages
-----------------------
cgroups.7
Serge Hally, Michael Kerrisk
New page documenting cgroups
cgroup_namespaces.7
Michael Kerrisk [Serge Hallyn]
New page describing cgroup namespaces
Newly documented interfaces in existing pages
---------------------------------------------
clone.2
Michael Kerrisk
Document CLONE_NEWCGROUP
setns.2
Michael Kerrisk
Document CLONE_NEWCGROUP
New and changed links
---------------------
unshare.2
Michael Kerrisk
Document CLONE_NEWCGROUP
Global changes
--------------
Changes to individual pages
---------------------------
clock_getres.2
Michael Kerrisk [Rasmus Villemoes]
Note that coarse clocks need architecture and VDSO support
clone.2
fork.2
Nikola Forró
Document ERESTARTNOINTR error code
clone.2
Michael Kerrisk [Colin Ian King]
ERRORS: add EINVAL for improperly aligned 'child_stack' value
execve.2
Michael Kerrisk [Valery Reznic]
Since Linux 2.6.28, recursive script interpretation is supported
fcntl.2
Michael Kerrisk
Note that mandatory locking is now governed by a configuration option
fsync.2
Michael Kerrisk [Georg Sauthoff]
Give some examples of files where sync can fail with EINVAL
getrlimit.2
Michael Kerrisk
SEE ALSO: add cgroups(7)
ioctl_fat.2
Heinrich Schuchardt
Use %04x to print volume ID
Leading zeroes should be used when display a FAT volume ID.
ioprio_set.2
Michael Kerrisk
SEE ALSO: add cgroups(7)
lseek.2
Michael Kerrisk
Note that 'off_t' is an integer data type defined by POSIX
memfd_create.2
Michael Kerrisk
Note that memfd_create() does not have a glibc wrapper
mount.2
Michael Kerrisk
MS_MANDLOCK requires CAP_SYS_ADMIN (since Linux 4.5)
quotactl.2
Michael Kerrisk
Document Q_GETNEXTQUOTA and Q_XGETNEXTQUOTA
Michael Kerrisk
Rework/reorder ERRORS list
Make into a single alphabetically ordered list
Michael Kerrisk
Note kernel version that removed Q_GETSTATS
Michael Kerrisk
Add kernel version for G_GETINFO, Q_SETINFO, and Q_GETFMT
readv.2
Christoph Hellwig
Document preadv2() and pwritev2()
Michael Kerrisk
Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
semctl.2
Michael Kerrisk
From kernel 4.6, Linux now updates 'sempid' on SETALL operations
sigaction.2
Michael Kerrisk
Document SEGV_BNDERR
Michael Kerrisk
Document SEGV_PKUERR
syscalls.2
Michael Kerrisk
Add preadv2() and pwritev2()
write.2
Michael Kerrisk
Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
makedev.3
Mike Frysinger
Use <sys/sysmacros.h> in SYNOPSIS
Defining these functions via <sys/types.h> causes problems for
some folk. As noted by Zack Wein:
libstdc++ force-enables _GNU_SOURCE, which means people
writing in C++ _can't_ avoid these nonstandard macros by
using a strict conformance mode.
Since glibc has basically always used <sys/sysmacros.h>,
update the docs to have people include that instead.
Michael Kerrisk
NOTES: mention that <sys/types.h> may also define these macros
popen.3
Nikola Forró
RETURN VALUE: describe successful case
Reference:
http://pubs.opengroup.org/onlinepubs/9699919799/functions/popen.html
http://pubs.opengroup.org/onlinepubs/9699919799/functions/pclose.html
strtod.3
Michael Kerrisk [Ed Avis]
Improve a detail in RETURN VALUE
core.5
Michael Kerrisk
Document /proc/sys/kernel/core_pipe_limit
locale.5
Marko Myllynen
Adjust LC_IDENTIFICATION / abbreviation
Tiny tweak to locale.5 based on the on ISO/IEC TR 14652:
http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf
Marko Myllynen
Update LC_ADDRESS after glibc change
This patch updates locale.5 to match the recent glibc change
in commit a837257199ffab76237385b830cc7b6179fc2f18
Marko Myllynen
Complete LC_COLLATE
Here's the first attempt to (almost) complete the locale.5 manual
page by documenting all (but perhaps one) of the missing
LC_COLLATE keywords.
Mike Frysinger
country_car: Add a better description
nsswitch.conf.5
Marko Myllynen
Document group merging
Document the recently merged glibc group merge support.
Glibc commit ced8f8933673f4efda1d666d26a1a949602035ed
https://sourceware.org/glibc/wiki/Proposals/GroupMerging
proc.5
Michael Kerrisk
Move /proc/PID/cgroup discussion to cgroups(7) page
Michael Kerrisk
Add some background on why /proc/PID/mountinfo was added
Michael Kerrisk
Improve description of /proc/PID/mountinfo 'root' field
Michael Kerrisk
Add pointer to cgroups(7) for documentation of /proc/cgroups
Michael Kerrisk
Add reference to core(5) for info on /proc/sys/kernel/core_pipe_limit
cpuset.7
Michael Kerrisk
SEE ALSO: add cgroups(7)
ip.7
Benjamin Poirier
Fix incorrect sockopt name
"IP_LEAVE_GROUP" does not exist. It was perhaps a confusion with
MCAST_LEAVE_GROUP. Change the text to IP_DROP_MEMBERSHIP which has
the same function as MCAST_LEAVE_GROUP and is documented in the
ip.7 man page.
Reference:
Linux kernel net/ipv4/ip_sockglue.c do_ip_setsockopt()
Cc: Radek Pazdera <rpazdera@redhat.com>
namespaces.7
Michael Kerrisk
Add /proc/PID/mountinfo discussion under cgroup namespaces
The discussion here is contingent on the acceptance of
Serge Hallyn's patch, "mountinfo: implement show_path
for kernfs and cgroup".
Michael Kerrisk
SEE ALSO: add cgroups(7), cgroup_namespaces(7)
vdso.7
Zubair Lutfullah Kakakhel [Mike Frysinger]
Update for MIPS
Document the symbols exported by the MIPS VDSO.
VDSO support was added from kernel 4.4 onwards.
See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/log/arch/mips/vdso
Michael Kerrisk [Rasmus Villemoes]
The __kernel_clock_* interfaces don't support *_COARSE clocks on PowerPC
ld.so.8
Michael Kerrisk [Alon Bar-Lev]
Document use of $ORIGIN, $LIB, and $PLATFORM in environment variables
These strings are meaningful in LD_LIBRARY_PATH and LD_PRELOAD.

View File

@ -41489,3 +41489,265 @@ unix.7
Introduce term "sequenced-packet" for SOCK_SEQPACKET
Michael Kerrisk
Some wording improvements
==================== Changes in man-pages-4.06 ====================
Released: 2016-05-09, Oslo
Contributors
------------
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:
Alexander Miller <alex.miller@gmx.de>
Alon Bar-Lev <alon.barlev@gmail.com>
Benjamin Poirier <bpoirier@suse.com>
Christoph Hellwig <hch@lst.de>
Colin Ian King <colin.king@canonical.com>
Dr. Tobias Quathamer <toddy@debian.org>
Ed Avis <eda@waniasset.com>
Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
Heinrich Schuchardt <xypron.glpk@gmx.de>
Jakub Wilk <jwilk@jwilk.net>
Jordan Birks <birkses@hotmail.com>
Marko Myllynen <myllynen@redhat.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Nikola Forró <nforro@redhat.com>
Rasmus Villemoes <linux@rasmusvillemoes.dk>
Serge E. Hallyn <serge@hallyn.com>
Serge Hallyn <serge.hallyn@ubuntu.com>
Valery Reznic <valery_reznic@yahoo.com>
Zubair Lutfullah Kakakhel <Zubair.Kakakhel@imgtec.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
cgroups.7
Serge Hally, Michael Kerrisk
New page documenting cgroups
cgroup_namespaces.7
Michael Kerrisk [Serge Hallyn]
New page describing cgroup namespaces
Newly documented interfaces in existing pages
---------------------------------------------
clone.2
Michael Kerrisk
Document CLONE_NEWCGROUP
setns.2
Michael Kerrisk
Document CLONE_NEWCGROUP
unshare.2
Michael Kerrisk
Document CLONE_NEWCGROUP
Changes to individual pages
---------------------------
clock_getres.2
Michael Kerrisk [Rasmus Villemoes]
Note that coarse clocks need architecture and VDSO support
clone.2
fork.2
Nikola Forró
Document ERESTARTNOINTR error code
clone.2
Michael Kerrisk [Colin Ian King]
ERRORS: add EINVAL for improperly aligned 'child_stack' value
execve.2
Michael Kerrisk [Valery Reznic]
Since Linux 2.6.28, recursive script interpretation is supported
fcntl.2
Michael Kerrisk
Note that mandatory locking is now governed by a configuration option
fsync.2
Michael Kerrisk [Georg Sauthoff]
Give some examples of files where sync can fail with EINVAL
getrlimit.2
Michael Kerrisk
SEE ALSO: add cgroups(7)
ioctl_fat.2
Heinrich Schuchardt
Use %04x to print volume ID
Leading zeroes should be used when display a FAT volume ID.
ioprio_set.2
Michael Kerrisk
SEE ALSO: add cgroups(7)
lseek.2
Michael Kerrisk
Note that 'off_t' is an integer data type defined by POSIX
memfd_create.2
Michael Kerrisk
Note that memfd_create() does not have a glibc wrapper
mount.2
Michael Kerrisk
MS_MANDLOCK requires CAP_SYS_ADMIN (since Linux 4.5)
quotactl.2
Michael Kerrisk
Document Q_GETNEXTQUOTA and Q_XGETNEXTQUOTA
Michael Kerrisk
Rework/reorder ERRORS list
Make into a single alphabetically ordered list
Michael Kerrisk
Note kernel version that removed Q_GETSTATS
Michael Kerrisk
Add kernel version for G_GETINFO, Q_SETINFO, and Q_GETFMT
readv.2
Christoph Hellwig
Document preadv2() and pwritev2()
Michael Kerrisk
Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
semctl.2
Michael Kerrisk
From kernel 4.6, Linux now updates 'sempid' on SETALL operations
sigaction.2
Michael Kerrisk
Document SEGV_BNDERR
Michael Kerrisk
Document SEGV_PKUERR
syscalls.2
Michael Kerrisk
Add preadv2() and pwritev2()
write.2
Michael Kerrisk
Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
makedev.3
Mike Frysinger
Use <sys/sysmacros.h> in SYNOPSIS
Defining these functions via <sys/types.h> causes problems for
some folk. As noted by Zack Wein:
libstdc++ force-enables _GNU_SOURCE, which means people
writing in C++ _can't_ avoid these nonstandard macros by
using a strict conformance mode.
Since glibc has basically always used <sys/sysmacros.h>,
update the docs to have people include that instead.
Michael Kerrisk
NOTES: mention that <sys/types.h> may also define these macros
popen.3
Nikola Forró
RETURN VALUE: describe successful case
Reference:
http://pubs.opengroup.org/onlinepubs/9699919799/functions/popen.html
http://pubs.opengroup.org/onlinepubs/9699919799/functions/pclose.html
strtod.3
Michael Kerrisk [Ed Avis]
Improve a detail in RETURN VALUE
core.5
Michael Kerrisk
Document /proc/sys/kernel/core_pipe_limit
locale.5
Marko Myllynen
Adjust LC_IDENTIFICATION / abbreviation
Tiny tweak to locale.5 based on the on ISO/IEC TR 14652:
http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf
Marko Myllynen
Update LC_ADDRESS after glibc change
This patch updates locale.5 to match the recent glibc change
in commit a837257199ffab76237385b830cc7b6179fc2f18
Marko Myllynen
Complete LC_COLLATE
Here's the first attempt to (almost) complete the locale.5 manual
page by documenting all (but perhaps one) of the missing
LC_COLLATE keywords.
Mike Frysinger
country_car: Add a better description
nsswitch.conf.5
Marko Myllynen
Document group merging
Document the recently merged glibc group merge support.
Glibc commit ced8f8933673f4efda1d666d26a1a949602035ed
https://sourceware.org/glibc/wiki/Proposals/GroupMerging
proc.5
Michael Kerrisk
Move /proc/PID/cgroup discussion to cgroups(7) page
Michael Kerrisk
Add some background on why /proc/PID/mountinfo was added
Michael Kerrisk
Improve description of /proc/PID/mountinfo 'root' field
Michael Kerrisk
Add pointer to cgroups(7) for documentation of /proc/cgroups
Michael Kerrisk
Add reference to core(5) for info on /proc/sys/kernel/core_pipe_limit
cpuset.7
Michael Kerrisk
SEE ALSO: add cgroups(7)
ip.7
Benjamin Poirier
Fix incorrect sockopt name
"IP_LEAVE_GROUP" does not exist. It was perhaps a confusion with
MCAST_LEAVE_GROUP. Change the text to IP_DROP_MEMBERSHIP which has
the same function as MCAST_LEAVE_GROUP and is documented in the
ip.7 man page.
Reference:
Linux kernel net/ipv4/ip_sockglue.c do_ip_setsockopt()
Cc: Radek Pazdera <rpazdera@redhat.com>
namespaces.7
Michael Kerrisk
Add /proc/PID/mountinfo discussion under cgroup namespaces
The discussion here is contingent on the acceptance of
Serge Hallyn's patch, "mountinfo: implement show_path
for kernfs and cgroup".
Michael Kerrisk
SEE ALSO: add cgroups(7), cgroup_namespaces(7)
vdso.7
Zubair Lutfullah Kakakhel [Mike Frysinger]
Update for MIPS
Document the symbols exported by the MIPS VDSO.
VDSO support was added from kernel 4.4 onwards.
See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/log/arch/mips/vdso
Michael Kerrisk [Rasmus Villemoes]
The __kernel_clock_* interfaces don't support *_COARSE clocks on PowerPC
ld.so.8
Michael Kerrisk [Alon Bar-Lev]
Document use of $ORIGIN, $LIB, and $PLATFORM in environment variables
These strings are meaningful in LD_LIBRARY_PATH and LD_PRELOAD.