From 22cacdfc9474abef7b7ef9bdaf07e3cf9d3b42fd Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 2 Aug 2019 10:31:40 +0200 Subject: [PATCH] Start of man-pages-5.03: updating Changes and Changes.old --- Changes | 276 ++--------------------------------------------- Changes.old | 301 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 307 insertions(+), 270 deletions(-) diff --git a/Changes b/Changes index 0fda9f1d3..80c44eb4c 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-5.02 ==================== +==================== Changes in man-pages-5.03 ==================== -Released: 2019-08-02, Munich +Released: ????-??-??, Munich Contributors @@ -10,290 +10,26 @@ 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: -Alan Stern -Alexey Izbyshev -Amir Goldstein -Cyrill Gorcunov -Eric Sanchis -Eugene Syromyatnikov -Finn O'Leary -Florian Weimer -G. Branden Robinson -Guillaume Laporte -Jakub Wilk -Jan Kara -Kumar Chaudhary, Naveen -Mark Wielaard -Matthew Bobrowski -Matthew Kenigsberg -Matthias Hertel -Michael Kerrisk -Michal Sekletar -Oleg Nesterov -Palmer Dabbelt -Petr Vaněk -Sami Kerola -Shawn Landden -Thorsten Glaser -Tobias Klauser -Tomas Skäre -Yang Xu Apologies if I missed anyone! +New and rewritten pages +----------------------- + + Newly documented interfaces in existing pages --------------------------------------------- -fanotify.7 -fanotify_init.2 -fanotify_mark.2 - Matthew Bobrowski [Amir Goldstein, Jan Kara] - Document FAN_REPORT_FID and directory modification events - -vdso.7 - Tobias Klauser [Palmer Dabbelt] - Document vDSO for RISCV - -Renamed pages -------------- - -sysvipc.7 - svipc(7) is renamed to sysvipc(7). - The name sysvipc is a bit more natural, and is the name used in - /proc/sysvipc. New and changed links --------------------- -svipc.7 - Michael Kerrisk - Add old name of sysvipc(7) page as a link - Global changes -------------- -Various pages - Michael Kerrisk - Change reference to svipc(7) to sysvipc(7) - Changes to individual pages --------------------------- -pldd.1 - G. Branden Robinson [Michael Kerrisk] - Document glibc's unbreakage of tool - After a longstanding breakage, pldd now works again (glibc 2.30). - -bpf.2 - Michael Kerrisk - Correct kernel version for JIT support on s390 - -chdir.2 - Michael Kerrisk - Add ENOTDIR error for fchdir() - -execve.2 - Michael Kerrisk [Eugene Syromyatnikov] - Since Linux 5.1, the limit on the #! line is 255 chars (rather than 127) - Shawn Landden [Michael Kerrisk] - Add more detail about Shebangs - Michael Kerrisk - Linux is not alone in ignoring the set-UID and set-GID bits for scripts - -mount.2 - Michael Kerrisk - ERRORS: Add a couple of EINVAL errors for MS_MOVE - Michael Kerrisk - SEE ALSO: add chroot(2) and pivot_root(2) - -mprotect.2 - Mark Wielaard - pkey_mprotect() acts like mprotect() if pkey is set to -1, not 0 - -mprotect.2 -pkey_alloc.2 - Mark Wielaard [Florian Weimer] - _GNU_SOURCE is required for the pkey functions. - -pivot_root.2 - Michael Kerrisk - ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation - Michael Kerrisk - 'new_root' must be a mount point - It appears that 'new_root' may not have needed to be a mount - point on ancient kernels, but already in Linux 2.4.5 this changed. - Michael Kerrisk - 'put_old' can't be a mount point with MS_SHARED propagation - Michael Kerrisk - SEE ALSO: add mount(2) - -poll.2 - Michael Kerrisk [Alan Stern] - Note that poll() equivalent code for ppoll() is not quite equivalent - -prctl.2 - Yang Xu [Cyrill Gorcunov] - Correct some details for PR_SET_TIMERSLACK - -setxattr.2 - Finn O'Leary [Michael Kerrisk] - Add ERANGE to 'ERRORS' section - -tkill.2 - Michael Kerrisk - glibc 2.30 provides a wrapper for tgkill() - -dlopen.3 - Michael Kerrisk - Clarify the rules for symbol resolution in a dlopen'ed object - The existing text wrongly implied that symbol look up first - occurred in the object and then in main, and did not mention - whether dependencies of main where used for symbol resolution. - Michael Kerrisk - Clarify when an executable's symbols can be used for symbol resolution - The --export-dynamic linker option is not the only way that main's - global symbols may end up in the dynamic symbol table and thus be - used to satisfy symbol reference in a shared object. A symbol - may also be placed into the dynamic symbol table if ld(1) - notices a dependency in another object during the static link. - Michael Kerrisk - An object opened with RTLD_LOCAL can be promoted to RTLD_GLOBAL - Michael Kerrisk - Note that symbol use might keep a dlclose'd object in memory - My earlier commit was in error: - Michael Kerrisk - On dlclose(), destructors are called when reference count falls to 0 - Michael Kerrisk - Make it clear that RTLD_NODELETE also affects global variables - Michael Kerrisk - Clarify that constructors are called only when library is first loaded - -exec.3 - Matthew Kenigsberg - Explain function groupings - I've found the exec man page quite difficult to read when trying - to find the behavior for a specific function. Since the names of - the functions are inline and the order of the descriptions isn't - clear, it's hard to find which paragraphs apply to each function. - I thought it would be much easier to read if the grouping based on - letters is stated. - -getutent.3 - Michael Kerrisk [Thorsten Glaser] - Fix missing include file in EXAMPLE - See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=932382 - -on_exit.3 - Michael Kerrisk [Sami Kerola] - Stack variables may be out of scope when exit handler is invoked - -strcat.3 - Michael Kerrisk [Eric Sanchis] - Fix off-by-one error in example code - -cpuid.4 - Michael Kerrisk - SEE ALSO: add cpuid(1) - -elf.5 - Michael Kerrisk - SEE ALSO: add ld.so(8) - -proc.5 - Michael Kerrisk - Correct description of /proc/PID/status 'ShdPnd' and 'SigPnd' fields - These fields are signal masks, not counters. - Michael Kerrisk - Clarify that various mask fields in /proc/PID/status are in hexadecimal - -capabilities.7 - Michael Kerrisk - Add a note about using strace on binaries that have capabilities - Michael Kerrisk - Add pivot_root(2) to CAP_SYS_ADMIN list - Michael Kerrisk - CAP_FOWNER also allows modifying user xattrs on sticky directories - -cgroup_namespaces.7 - Michael Kerrisk - Some wording fixes to improve clarity - Michael Kerrisk - In the example shell session, give second shell a different prompt - -credentials.7 - Michael Kerrisk - Note that /proc/PID/status shows a process's credentials - Michael Kerrisk - SEE ALSO: add tcgetsid(3) - -fanotify.7 - Matthew Bobrowski - Reword FAN_REPORT_FID data structure inclusion semantics - Michael Kerrisk - Clarify logic in ESTALE check - Michael Kerrisk - Reorder text in EXAMPLE - Michael Kerrisk - Reformat program output to fit in 80 columns - -mount_namespaces.7 - Michael Kerrisk - Clarify implications for other NS if mount point is removed in one NS - If a mount point is deleted or renamed or removed in one mount - namespace, this will cause an object that is mounted at that - location in another mount namespace to be unmounted (as verified - by experiment). This was implied by the existing text, but it is - better to make this detail explicit. - Michael Kerrisk - SEE ALSO: add pivot_root(2), pivot_root(8) - -namespaces.7 - Michael Kerrisk - Note initial values of hostname and domainname in a new UTS namespace - -sched.7 - Michael Kerrisk - SEE ALSO: add pthread_getschedparam(3) - -signal.7 - Michal Sekletar [Oleg Nesterov, Michael Kerrisk] - Clarify that siginfo_t isn't changed on coalescing - Michael Kerrisk - Various fields in /proc/PID/status show signal-related information - Michael Kerrisk - Add subsection on queuing and delivery semantics for standard signals - -socket.7 - Michael Kerrisk - select()/poll()/epoll honor SO_RCVLOWAT since Linux 2.6.28 - -unix.7 - Michael Kerrisk - Note SCM_RIGHTS interaction with RLIMIT_NOFILE - If the file descriptors received in SCM_RIGHTS would cause - the process to its exceed RLIMIT_NOFILE limit, the excess - FDs are discarded. - -user_namespaces.7 - Michael Kerrisk - Describe the effect of file-related capabilities inside use namespaces - Michael Kerrisk - Describe how kernel treats UIDs/GIDs when a process accesses files - -vdso.7 - Tobias Klauser - Mention removal of Blackfin port in Linux 4.17 - -ld.so.8 - Michael Kerrisk [Matthias Hertel] - Note some further details of secure-execution mode - Note some further details of the treatment of environment - variables in secure execution mode. In particular (as noted by - Matthias Hertel), note that ignored environment variables are also - stripped from the environment. Furthermore, there are some other - variables, not used by the dynamic linker itself, that are also - treated in this way (see the glibc source file - sysdeps/generic/unsecvars.h). diff --git a/Changes.old b/Changes.old index 008d80c58..e02a4a5e8 100644 --- a/Changes.old +++ b/Changes.old @@ -49431,3 +49431,304 @@ inode.7 Timestamp fields are structures that include a nanosecond component Michael Kerrisk Add references to execve(2) to describe set-UID/set-GID behaviors + + +==================== Changes in man-pages-5.02 ==================== + +Released: 2019-08-02, Munich + + +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: + +Alan Stern +Alexey Izbyshev +Amir Goldstein +Cyrill Gorcunov +Eric Sanchis +Eugene Syromyatnikov +Finn O'Leary +Florian Weimer +G. Branden Robinson +Guillaume Laporte +Jakub Wilk +Jan Kara +Kumar Chaudhary, Naveen +Mark Wielaard +Matthew Bobrowski +Matthew Kenigsberg +Matthias Hertel +Michael Kerrisk +Michal Sekletar +Oleg Nesterov +Palmer Dabbelt +Petr Vaněk +Sami Kerola +Shawn Landden +Thorsten Glaser +Tobias Klauser +Tomas Skäre +Yang Xu + +Apologies if I missed anyone! + + +Newly documented interfaces in existing pages +--------------------------------------------- + +fanotify.7 +fanotify_init.2 +fanotify_mark.2 + Matthew Bobrowski [Amir Goldstein, Jan Kara] + Document FAN_REPORT_FID and directory modification events + +vdso.7 + Tobias Klauser [Palmer Dabbelt] + Document vDSO for RISCV + +Renamed pages +------------- + +sysvipc.7 + svipc(7) is renamed to sysvipc(7). + The name sysvipc is a bit more natural, and is the name used in + /proc/sysvipc. + +New and changed links +--------------------- + +svipc.7 + Michael Kerrisk + Add old name of sysvipc(7) page as a link + + +Global changes +-------------- + +Various pages + Michael Kerrisk + Change reference to svipc(7) to sysvipc(7) + + +Changes to individual pages +--------------------------- + +pldd.1 + G. Branden Robinson [Michael Kerrisk] + Document glibc's unbreakage of tool + After a longstanding breakage, pldd now works again (glibc 2.30). + +bpf.2 + Michael Kerrisk + Correct kernel version for JIT support on s390 + +chdir.2 + Michael Kerrisk + Add ENOTDIR error for fchdir() + +execve.2 + Michael Kerrisk [Eugene Syromyatnikov] + Since Linux 5.1, the limit on the #! line is 255 chars (rather than 127) + Shawn Landden [Michael Kerrisk] + Add more detail about Shebangs + Michael Kerrisk + Linux is not alone in ignoring the set-UID and set-GID bits for scripts + +mount.2 + Michael Kerrisk + ERRORS: Add a couple of EINVAL errors for MS_MOVE + Michael Kerrisk + SEE ALSO: add chroot(2) and pivot_root(2) + +mprotect.2 + Mark Wielaard + pkey_mprotect() acts like mprotect() if pkey is set to -1, not 0 + +mprotect.2 +pkey_alloc.2 + Mark Wielaard [Florian Weimer] + _GNU_SOURCE is required for the pkey functions. + +pivot_root.2 + Michael Kerrisk + ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation + Michael Kerrisk + 'new_root' must be a mount point + It appears that 'new_root' may not have needed to be a mount + point on ancient kernels, but already in Linux 2.4.5 this changed. + Michael Kerrisk + 'put_old' can't be a mount point with MS_SHARED propagation + Michael Kerrisk + SEE ALSO: add mount(2) + +poll.2 + Michael Kerrisk [Alan Stern] + Note that poll() equivalent code for ppoll() is not quite equivalent + +prctl.2 + Yang Xu [Cyrill Gorcunov] + Correct some details for PR_SET_TIMERSLACK + +setxattr.2 + Finn O'Leary [Michael Kerrisk] + Add ERANGE to 'ERRORS' section + +tkill.2 + Michael Kerrisk + glibc 2.30 provides a wrapper for tgkill() + +dlopen.3 + Michael Kerrisk + Clarify the rules for symbol resolution in a dlopen'ed object + The existing text wrongly implied that symbol look up first + occurred in the object and then in main, and did not mention + whether dependencies of main where used for symbol resolution. + Michael Kerrisk + Clarify when an executable's symbols can be used for symbol resolution + The --export-dynamic linker option is not the only way that main's + global symbols may end up in the dynamic symbol table and thus be + used to satisfy symbol reference in a shared object. A symbol + may also be placed into the dynamic symbol table if ld(1) + notices a dependency in another object during the static link. + Michael Kerrisk + An object opened with RTLD_LOCAL can be promoted to RTLD_GLOBAL + Michael Kerrisk + Note that symbol use might keep a dlclose'd object in memory + My earlier commit was in error: + Michael Kerrisk + On dlclose(), destructors are called when reference count falls to 0 + Michael Kerrisk + Make it clear that RTLD_NODELETE also affects global variables + Michael Kerrisk + Clarify that constructors are called only when library is first loaded + +exec.3 + Matthew Kenigsberg + Explain function groupings + I've found the exec man page quite difficult to read when trying + to find the behavior for a specific function. Since the names of + the functions are inline and the order of the descriptions isn't + clear, it's hard to find which paragraphs apply to each function. + I thought it would be much easier to read if the grouping based on + letters is stated. + +getutent.3 + Michael Kerrisk [Thorsten Glaser] + Fix missing include file in EXAMPLE + See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=932382 + +on_exit.3 + Michael Kerrisk [Sami Kerola] + Stack variables may be out of scope when exit handler is invoked + +strcat.3 + Michael Kerrisk [Eric Sanchis] + Fix off-by-one error in example code + +cpuid.4 + Michael Kerrisk + SEE ALSO: add cpuid(1) + +elf.5 + Michael Kerrisk + SEE ALSO: add ld.so(8) + +proc.5 + Michael Kerrisk + Correct description of /proc/PID/status 'ShdPnd' and 'SigPnd' fields + These fields are signal masks, not counters. + Michael Kerrisk + Clarify that various mask fields in /proc/PID/status are in hexadecimal + +capabilities.7 + Michael Kerrisk + Add a note about using strace on binaries that have capabilities + Michael Kerrisk + Add pivot_root(2) to CAP_SYS_ADMIN list + Michael Kerrisk + CAP_FOWNER also allows modifying user xattrs on sticky directories + +cgroup_namespaces.7 + Michael Kerrisk + Some wording fixes to improve clarity + Michael Kerrisk + In the example shell session, give second shell a different prompt + +credentials.7 + Michael Kerrisk + Note that /proc/PID/status shows a process's credentials + Michael Kerrisk + SEE ALSO: add tcgetsid(3) + +fanotify.7 + Matthew Bobrowski + Reword FAN_REPORT_FID data structure inclusion semantics + Michael Kerrisk + Clarify logic in ESTALE check + Michael Kerrisk + Reorder text in EXAMPLE + Michael Kerrisk + Reformat program output to fit in 80 columns + +mount_namespaces.7 + Michael Kerrisk + Clarify implications for other NS if mount point is removed in one NS + If a mount point is deleted or renamed or removed in one mount + namespace, this will cause an object that is mounted at that + location in another mount namespace to be unmounted (as verified + by experiment). This was implied by the existing text, but it is + better to make this detail explicit. + Michael Kerrisk + SEE ALSO: add pivot_root(2), pivot_root(8) + +namespaces.7 + Michael Kerrisk + Note initial values of hostname and domainname in a new UTS namespace + +sched.7 + Michael Kerrisk + SEE ALSO: add pthread_getschedparam(3) + +signal.7 + Michal Sekletar [Oleg Nesterov, Michael Kerrisk] + Clarify that siginfo_t isn't changed on coalescing + Michael Kerrisk + Various fields in /proc/PID/status show signal-related information + Michael Kerrisk + Add subsection on queuing and delivery semantics for standard signals + +socket.7 + Michael Kerrisk + select()/poll()/epoll honor SO_RCVLOWAT since Linux 2.6.28 + +unix.7 + Michael Kerrisk + Note SCM_RIGHTS interaction with RLIMIT_NOFILE + If the file descriptors received in SCM_RIGHTS would cause + the process to its exceed RLIMIT_NOFILE limit, the excess + FDs are discarded. + +user_namespaces.7 + Michael Kerrisk + Describe the effect of file-related capabilities inside use namespaces + Michael Kerrisk + Describe how kernel treats UIDs/GIDs when a process accesses files + +vdso.7 + Tobias Klauser + Mention removal of Blackfin port in Linux 4.17 + +ld.so.8 + Michael Kerrisk [Matthias Hertel] + Note some further details of secure-execution mode + Note some further details of the treatment of environment + variables in secure execution mode. In particular (as noted by + Matthias Hertel), note that ignored environment variables are also + stripped from the environment. Furthermore, there are some other + variables, not used by the dynamic linker itself, that are also + treated in this way (see the glibc source file + sysdeps/generic/unsecvars.h).