From 5290e8655622cb4e79f4438f2ed698dc0b518257 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 10 May 2016 07:27:15 +0200 Subject: [PATCH] Start of man-pages-4.07: updating Changes and Changes.old --- Changes | 239 ++--------------------------------------------- Changes.old | 262 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 269 insertions(+), 232 deletions(-) diff --git a/Changes b/Changes index 72957017a..fd2e82833 100644 --- a/Changes +++ b/Changes @@ -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 -Alon Bar-Lev -Benjamin Poirier -Christoph Hellwig -Colin Ian King -Dr. Tobias Quathamer -Ed Avis -Georg Sauthoff -Heinrich Schuchardt -Jakub Wilk -Jordan Birks -Marko Myllynen -Michael Kerrisk -Mike Frysinger -Nikola Forró -Rasmus Villemoes -Serge E. Hallyn -Serge Hallyn -Valery Reznic -Zubair Lutfullah Kakakhel 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 in SYNOPSIS - Defining these functions via 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 , - update the docs to have people include that instead. - Michael Kerrisk - NOTES: mention that 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 - -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. diff --git a/Changes.old b/Changes.old index 2dd53e7cb..ae8531132 100644 --- a/Changes.old +++ b/Changes.old @@ -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 +Alon Bar-Lev +Benjamin Poirier +Christoph Hellwig +Colin Ian King +Dr. Tobias Quathamer +Ed Avis +Georg Sauthoff +Heinrich Schuchardt +Jakub Wilk +Jordan Birks +Marko Myllynen +Michael Kerrisk +Mike Frysinger +Nikola Forró +Rasmus Villemoes +Serge E. Hallyn +Serge Hallyn +Valery Reznic +Zubair Lutfullah Kakakhel + +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 in SYNOPSIS + Defining these functions via 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 , + update the docs to have people include that instead. + Michael Kerrisk + NOTES: mention that 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 + +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.