-==================== Changes in man-pages-3.78 ====================
+==================== Changes in man-pages-5.02 ====================
-Released: ????-??-??, Munich
+Released: 2019-08-02, Munich
Contributors
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Akihiro Motoki <amotoki@gmail.com>
-Alexey Ishchuk <aishchuk@linux.vnet.ibm.com>
-Carlos O'Donell <carlos@redhat.com>
-Christian Seiler <christian@iwakd.de>
-Daniel J Blueman <daniel@quora.org>
-David Drysdale <drysdale@google.com>
-David Herrmann <dh.herrmann@gmail.com>
-Elie De Brauwer <eliedebrauwer@gmail.com>
-Elliot Hughes <enh@google.com>
-Jessica McKellar <jessica.mckellar@gmail.com>
-Kees Cook <keescook@chromium.org>
-Michael Hayes <mike@aiinc.ca>
+Alan Stern <stern@rowland.harvard.edu>
+Alexey Izbyshev <izbyshev@ispras.ru>
+Amir Goldstein <amir73il@gmail.com>
+Cyrill Gorcunov <gorcunov@gmail.com>
+Eric Sanchis <eric.sanchis@iut-rodez.fr>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Finn O'Leary <finnoleary@inventati.org>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Guillaume Laporte <guillaume.laporte.adm@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Kumar Chaudhary, Naveen <naveen.kumar.chaudhary@intel.com>
+Mark Wielaard <mark@klomp.org>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Matthew Kenigsberg <matthewkenigsberg@gmail.com>
+Matthias Hertel <Matthias.Hertel@rohde-schwarz.com>
Michael Kerrisk <mtk.manpages@gmail.com>
-Rich Felker <dalias@aerifal.cx>
-Vince Weaver <vincent.weaver@maine.edu>
+Michal Sekletar <msekleta@redhat.com>
+Oleg Nesterov <oleg@redhat.com>
+Palmer Dabbelt <palmer@sifive.com>
+Petr Vaněk <arkamar@atlas.cz>
+Sami Kerola <kerolasa@iki.fi>
+Shawn Landden <shawn@git.icu>
+Thorsten Glaser <tg@mirbsd.de>
+Tobias Klauser <tklauser@distanz.ch>
+Tomas Skäre <tomas.skare@gmail.com>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
Apologies if I missed anyone!
-New and rewritten pages
------------------------
-
-execveat.2
- David Drysdale, Michael Kerrisk [Rich Felker]
- New page for execveat(2)
+Newly documented interfaces in existing pages
+---------------------------------------------
-memfd_create.2
- Michael Kerrisk, David Herrmann
- New page for memfd_create() system call
- Including notes about file sealing
+fanotify.7
+fanotify_init.2
+fanotify_mark.2
+ Matthew Bobrowski [Amir Goldstein, Jan Kara]
+ Document FAN_REPORT_FID and directory modification events
-s390_pci_mmio_write.2
- Alexey Ishchuk
- New page for s390 s390_pci_mmio_write() and s390_pci_mmio_read()
- New manual page for the new PCI MMIO memory access system
- calls, s390_pci_mmio_write() and s390_pci_mmio_read(),
- added for the s390 platform.
+vdso.7
+ Tobias Klauser [Palmer Dabbelt]
+ Document vDSO for RISCV
+Renamed pages
+-------------
-Newly documented interfaces in existing 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.
-fcntl.2
- David Herrmann [Michael Kerrisk]
- Document F_ADD_SEALS and F_GET_SEALS commands
+New and changed links
+---------------------
-proc.5
- Elie De Brauwer
- Document /proc/sys/vm/compact_memory
+svipc.7
Michael Kerrisk
- Document /proc/sys/fs/nr_open
+ Add old name of sysvipc(7) page as a link
-New and changed links
----------------------
+Global changes
+--------------
-s390_pci_mmio_read.2
+Various pages
Michael Kerrisk
- New link to new s390_pci_mmio_write(2) page
+ Change reference to svipc(7) to sysvipc(7)
Changes to individual pages
---------------------------
-dup.2
+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
- Add reference to RLIMIT_NOFILE for EMFILE error
+ Correct kernel version for JIT support on s390
+
+chdir.2
Michael Kerrisk
- Add reference to RLIMIT_NOFILE for EBADF error on 'newfd'.
+ Add ENOTDIR error for fchdir()
execve.2
-fexecve.3
+ 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
- SEE ALSO: add execveat(2)
+ Linux is not alone in ignoring the set-UID and set-GID bits for scripts
-fallocate.2
-mmap.2
-open.2
-truncate.2
-write.2
+mount.2
Michael Kerrisk
- ERRORS: add EPERM for operation denied by file seal
+ 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.
-fcntl.2
+pivot_root.2
Michael Kerrisk
- ERRORS: add EBUSY case for F_SETPIPE_SZ
+ ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation
Michael Kerrisk
- Add reference to RLIMIT_NOFILE for F_DUPFD EINVAL error on 'arg'.
+ '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
- ERRORS: add open file description lock error cases
-
-getrlimit.2
+ 'put_old' can't be a mount point with MS_SHARED propagation
Michael Kerrisk
- Update text on RLIMIT_NOFILE ceiling to refer to /proc/sys/fs/file-max
+ 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
-mbind.2
- Michael Kerrisk [Daniel J Blueman]
- Clarify EFAULT text
+setxattr.2
+ Finn O'Leary [Michael Kerrisk]
+ Add ERANGE to 'ERRORS' section
-mmap.2
-shmget.2
-shm_open.3
+tkill.2
Michael Kerrisk
- SEE ALSO: add memfd_create(2)
+ glibc 2.30 provides a wrapper for tgkill()
-open.2
+dlopen.3
Michael Kerrisk
- Refer to RLIMIT_NOFILE for explanation of EMFILE error
+ 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
- Add execveat(2) in system call list under "Rationale for openat()"
-
-perf_event_open.2
- Vince Weaver
- Clarify description of overflow events
- Update the perf_event_open manpage to be more consistent when
- discussing overflow events. It merges the discussion of
- poll-type notifications with those generated by SIGIO
- signal handlers.
- This addresses the remaining FIXMEs is the document.
- Vince Weaver
- Remove inaccurate paragraph describing attr.config
- Remove an inaccurate paragraph about values in the attr.config
- field. This information was never true in any released kernel;
- it somehow snuck into the manpage because it is still described
- this way in tools/perf/design.txt in the kernel source tree.
+ 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
- Correct the kernel version number for PERF_COUNT_HW_CACHE_NODE
+ An object opened with RTLD_LOCAL can be promoted to RTLD_GLOBAL
Michael Kerrisk
- Add some kernel version numbers to various fields and constants
-
-ptrace.2
-sigaction.2
-seccomp.2
- Kees Cook
- Ptrace and siginfo details
- While writing some additional seccomp tests, I realized
- PTRACE_EVENT_SECCOMP wasn't documented yet. Fixed this, and added
- additional notes related to ptrace events SIGTRAP details.
+ 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
-readv.2
+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
- Update details on glibc readv()/writev() wrapper behavior
- And add a historical detail about Linux 2.0.
+ SEE ALSO: add cpuid(1)
-select.2
+elf.5
Michael Kerrisk
- Mention RLIMIT_NOFILE as a possible cause of EINVAL error
+ SEE ALSO: add ld.so(8)
-syscall.2
- Kees Cook
- Add arm64 and mips
- Add mips an d arm64 to tables, along with some further
- details on these architectures,
+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
-syscalls.2
+capabilities.7
Michael Kerrisk
- Add s390_pci_mmio_read(2) and s390_pci_mmio_write(2)
+ Add a note about using strace on binaries that have capabilities
Michael Kerrisk
- Note kernel() version that introduced get_kernel_syms()
- Note kernel version that introduced ppc_rtas()
- Note kernel version that introduced create_module()
- Note kernel version that added setup()
+ Add pivot_root(2) to CAP_SYS_ADMIN list
Michael Kerrisk
- Remove some details for sync_file_range2()
- Make the table a bit simpler. The details can anyway be
- found in the system call man page.
-
-utimensat.2
- Michael Kerrisk [Elliot Hughes]
- If both tv_sec fields are UTIME_OMIT, the file need not exist
- As noted by Elliot, if both tv_sec fields are UTIME_OMIT,
- utimensat() will return success even if the file does not exist.
+ CAP_FOWNER also allows modifying user xattrs on sticky directories
-errno.3
+cgroup_namespaces.7
Michael Kerrisk
- The RLIMIT_NOFILE resource limit is a common cause of EMFILE
-
-exec.3
+ Some wording fixes to improve clarity
Michael Kerrisk
- SEE ALSO: add execveat(2)
-
-fclose.3
- Carlos O'Donell
- Consistency fix: use "stream" as name for "FILE *" argument
- Harmonize all the manual pages to use "stream" for FILE*
- instead of randomly using "fp" or "stream." Choosing something
- and being consistent helps users scan the man pages quickly
- and understand what they are looking at.
+ In the example shell session, give second shell a different prompt
-fexecve.3
+credentials.7
Michael Kerrisk
- Rewrite the script+close-on-exec problem as a BUG
- Also, add one or two details about this scenario.
+ Note that /proc/PID/status shows a process's credentials
Michael Kerrisk
- The natural idiom when using fexecve() is to use the close-on-exec flag
+ SEE ALSO: add tcgetsid(3)
-fmemopen.3
+fanotify.7
+ Matthew Bobrowski
+ Reword FAN_REPORT_FID data structure inclusion semantics
Michael Kerrisk
- Consistency fix: use "stream" as name for "FILE *" argument
-
-fopencookie.3
+ Clarify logic in ESTALE check
Michael Kerrisk
- Consistency fix: use "stream" as name for "FILE *" argument
-
-getgrent_r.3
- Carlos O'Donell
- Consistency fix: use "stream" as name for "FILE *" argument
-
-getline.3
+ Reorder text in EXAMPLE
Michael Kerrisk
- Consistency fix: use "stream" as name for "FILE *" argument
+ Reformat program output to fit in 80 columns
-getmntent.3
- Carlos O'Donell
- Consistency fix: use "stream" as name for "FILE *" argument
-
-getpw.3
- Michael Kerrisk [Carlos O'Donell]
- Describe return value when 'uid' is not found
-
-getpwent_r.3
- Carlos O'Donell
- Consistency fix: use "stream" as name for "FILE *" argument
+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)
-getspnam.3
- Carlos O'Donell
- Consistency fix: use "stream" as name for "FILE *" argument
+namespaces.7
+ Michael Kerrisk
+ Note initial values of hostname and domainname in a new UTS namespace
-malloc_info.3
- Carlos O'Donell
- Consistency fix: use "stream" as name for "FILE *" argument
+sched.7
+ Michael Kerrisk
+ SEE ALSO: add pthread_getschedparam(3)
-posix_fallocate.3
+signal.7
+ Michal Sekletar [Oleg Nesterov, Michael Kerrisk]
+ Clarify that siginfo_t isn't changed on coalescing
Michael Kerrisk
- Note that posix_fallocate() is implemented using fallocate(2)
+ Various fields in /proc/PID/status show signal-related information
+ Michael Kerrisk
+ Add subsection on queuing and delivery semantics for standard signals
-putgrent.3
- Carlos O'Donell
- Consistency fix: use "stream" as name for "FILE *" argument
- Harmonize all the manual pages to use "stream" for FILE*
- instead of randomly using "fp" or "stream." Choosing something
- and being consistent helps users scan the man pages quickly
- and understand what they are looking at.
+socket.7
+ Michael Kerrisk
+ select()/poll()/epoll honor SO_RCVLOWAT since Linux 2.6.28
-locale.5
- Akihiro Motoki
- Correct variable name
+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.
-proc.5
+user_namespaces.7
+ Michael Kerrisk
+ Describe the effect of file-related capabilities inside use namespaces
Michael Kerrisk
- Remove bogus statement about NR_OPEN being a ceiling for file-max
+ 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).