From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Michael Kerrisk (man-pages)" Subject: man-pages-5.02 released Date: Fri, 2 Aug 2019 12:17:21 +0200 Message-ID: <3f678e10-d94a-98f9-7b85-3c392de68824@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org To: "libc-alpha@sourceware.org" , linux-man Cc: mtk.manpages@gmail.com List-Id: linux-man@vger.kernel.org Gidday, The Linux man-pages maintainer proudly announces: man-pages-5.02 - man pages for Linux This release resulted from patches, bug reports, reviews, and comments from 28 people, with around 120 commits making changes to over 50 pages. Tarball download: http://www.kernel.org/doc/man-pages/download.html Git repository: https://git.kernel.org/cgit/docs/man-pages/man-pages.git/ Online changelog: http://man7.org/linux/man-pages/changelog.html#release_5.02 A short summary of the release is blogged at: https://linux-man-pages.blogspot.com/2019/08/man-pages-502-is-released.html The current version of the pages is browsable at: http://man7.org/linux/man-pages/ You are receiving this message either because: a) You contributed to the content of this release. b) You are subscribed to linux-man@vger.kernel.org or libc-alpha@sourceware.org. c) I have information (possibly inaccurate) that you are the maintainer of a translation of the manual pages, or are the maintainer of the manual pages set in a particular distribution, or have expressed interest in helping with man-pages maintenance, or have otherwise expressed interest in being notified about man-pages releases. If you don't want to receive such messages from me, or you know of some other translator or maintainer who may want to receive such notifications, send me a message. Cheers, Michael ==================== 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 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 user 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). -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/