-==================== Changes in man-pages-4.00 ====================
+==================== 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:
-Advait Dixi <advaitdixit@hotmail.com>
-Alain Kalker <a.c.kalker@gmail.com>
-Andi Kleen <andi@firstfloor.org>
-Andreas Gruenbacher <agruenba@redhat.com>
-Andreas Heiduk <asheiduk@googlemail.com>
-Askar Safin <safinaskar@mail.ru>
-Brice Goglin <Brice.Goglin@inria.fr>
-Cameron Norman <camerontnorman@gmail.com>
-Carlos O'Donell <carlos@redhat.com>
-Chris Metcalf <cmetcalf@tilera.com>
-Christophe Lohr <Christophe.Lohr@telecom-bretagne.eu>
-Christopher Head <chead@chead.ca>
-Christoph Hellwig <hch@infradead.org>
-David Wilcox <davidvsthegiant@gmail.com>
-Denis Du <denisdu@ruggedcom.com>
-Egmont Koblinger <egmont@gmail.com>
-Filipe Brandenburger <filbranden@gmail.com>
-Filipus Klutiero <chealer@gmail.com>
+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>
-Frédéric Maria <frederic.maria@free.fr>
-Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
-Graham Shaw <gdshaw@riscpkg.org>
-Gregor Jasny <igjasny@googlemail.com>
-Guillem Jover <guillem@hadrons.org>
-Guy Harris <guy@alum.mit.edu>
-Heinrich Schuchardt <xypron.glpk@gmx.de>
-Ian Pilcher <arequipeno@gmail.com>
-Jann Horn <jann@thejh.net>
-Jason Newton <nevion@gmail.com>
-J. Bruce Fields <bfields@fieldses.org>
-Jiri Pirko <jpirko@redhat.com>
-Joachim Wuttke <j.wuttke@fz-juelich.de>
-Joern Heissler <contact@joern.heissler.de>
-Jonathan Nieder <jrnieder@gmail.com>
-Joonas Salo <salo.joonas@gmail.com>
-Jussi Lehtola <jussilehtola@fedoraproject.org>
-Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
-KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
-Laurence Gonsalves <laurence@xenomachina.com>
-Magnus REFTEL <magnus.xm.reftel@stericsson.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>
-NeilBrown <neilb@suse.de>
-Regid Ichira <regid23@nt1.in>
-Sam Varshavchik <mrsam@courier-mta.com>
-Steinar H. Gunderson <sgunderson@bigfoot.com>
-Stéphane Aulery <saulery@free.fr>
-Stephane Fillod <fillods@users.sf.net>
-Tetsuo Handa <from-linux-kernel@i-love.sakura.ne.jp>
-Thomas Hood <jdthood@gmail.com>
-Urs Thuermann <urs@isnogud.escape.de>
-Vasiliy Kulikov <segooon@gmail.com>
-Vegard Nossum <vegard.nossum@gmail.com>
-Weijie Yang <weijie.yang@samsung.com>
-William Woodruff <william@tuffbizz.com>
-Zeng Linggang <zenglg.jy@cn.fujitsu.com>
+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
------------------------
-
-get_phys_pages.3
- William Woodruff
- Document get_phys_pages() and get_avphys_pages()
-
-loop.4
- Urs Thuermann, Michael Kerrisk
- New page documenting the loop device
-
-xattr.7
- Andreas Gruenbacher
- Import attr(5) man page from the 'attr' project
- After discussions with Andreas Gruenbacher, it makes sense to
- move this page into man-pages, since it mostly relates to
- kernel details. Since this is an overview page,
- we'll move it to Section 7.
- Michael Kerrisk
- Rename page
- "xattr" is a more meaningful name than "attr" (it resonates
- with the names of the system calls), so as long as we are
- moving the page to a new section, we'll change the name as well,
- and retain an acl(5) link so that old references remain valid.
-
-
Newly documented interfaces in existing pages
---------------------------------------------
-mmap.2
- Michael Kerrisk [Andi Kleen]
- Document MAP_HUGE_2MB, MAP_HUGE_1GB, and MAP_HUGE_SHIFT
-
-shmget.2
- Michael Kerrisk [Andi Kleen]
- Document SHM_HUGE_2MB, SHM_HUGE_1GB, and SHM_HUGE_SHIFT
+fanotify.7
+fanotify_init.2
+fanotify_mark.2
+ Matthew Bobrowski [Amir Goldstein, Jan Kara]
+ Document FAN_REPORT_FID and directory modification events
-resolver.3
- Michael Kerrisk [Jonathan Nieder]
- Add descriptions of some other resolver functions
- Add res_ninit(), res_nquery(), res_nsearch(),
- and res_nquerydomain(), res_nmkquery(), res_nsend().
+vdso.7
+ Tobias Klauser [Palmer Dabbelt]
+ Document vDSO for RISCV
-tty_ioctl.4
- Frédéric Maria [Stephane Fillod, Andreas Heiduk]
- Document TIOCMIWAIT and TIOCGICOUNT
- Michael Kerrisk
- Document TIOCGEXCL
- Michael Kerrisk
- Document TIOGCPKT
- Michael Kerrisk
- Document TIOCSPTLCK
- Michael Kerrisk
- Document TIOCGPTLCK
+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
---------------------
-CMSG_DATA.3
+svipc.7
Michael Kerrisk
- New link to cmsg(3)
-
-CMSG_LEN.3
- Michael Kerrisk
- New link to cmsg(3)
-
-dprintf.3
- Michael Kerrisk
- Convert to a link to printf.3
-
-get_avphys_pages.3
- William Woodruff
- New link to new get_phys_pages.3 page
-
-res_ninit.3
-res_nmkquery.3
-res_nquery.3
-res_nquerydomain.3
-res_nsearch.3
-res_nsend.3
- Michael Kerrisk
- New links to resolver(3) man page
-
-loop-control.4
- Michael Kerrisk
- New link to loop.4
-
-attr.5
- Michael Kerrisk
- New link to xattr(7)
+ Add old name of sysvipc(7) page as a link
Global changes
--------------
-chown.2
-execve.2
-prctl.2
-truncate.2
-proc.5
-capabilities.7
-ld.so.8
+Various pages
Michael Kerrisk
- Tighter wording: 'mode bit' rather than 'permission bit'
- For sticky, set-UID, and set-GID mode bits (as used in POSIX).
+ Change reference to svipc(7) to sysvipc(7)
Changes to individual pages
---------------------------
-add_key.2
-keyctl.2
-request_key.2
- Michael Kerrisk
- SEE ALSO: add keyrings(7)
+pldd.1
+ G. Branden Robinson [Michael Kerrisk]
+ Document glibc's unbreakage of tool
+ After a longstanding breakage, pldd now works again (glibc 2.30).
-add_key.2
-request_key.2
+bpf.2
Michael Kerrisk
- SEE ALSO: add keyctl(3)
+ Correct kernel version for JIT support on s390
-epoll_ctl.2
+chdir.2
Michael Kerrisk
- After EPOLLHUP, EOF will be seen only after all data has been consumed
+ Add ENOTDIR error for fchdir()
-epoll_wait.2
+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
- Clarify that signal mask treatment in epoll_pwait() is per-thread
- s/sigprocmask()/pthread_sigmask()/
-
-fcntl.2
- Michael Kerrisk [Vegard Nossum]
- Note an F_SETSIG corner case
+ Linux is not alone in ignoring the set-UID and set-GID bits for scripts
-get_mempolicy.2, set_mempolicy
- Brice Goglin
- Policy is per thread, not per process
-
-getxattr.2
-listxattr.2
-removexattr.2
-setxattr.2
-capabilities.7
+mount.2
Michael Kerrisk
- Adjust "attr(5)" references to "xattr(7)"
-
-ioctl.2
+ ERRORS: Add a couple of EINVAL errors for MS_MOVE
Michael Kerrisk
- SEE ALSO: add console_ioctl(2) and tty_ioctl(2)
+ SEE ALSO: add chroot(2) and pivot_root(2)
-listxattr.2
-xattr.7
- Michael Kerrisk
- Describe listxattr(2) E2BIG error and document it as a BUG
+mprotect.2
+ Mark Wielaard
+ pkey_mprotect() acts like mprotect() if pkey is set to -1, not 0
-mkdir.2
- Michael Kerrisk
- Wording fixes + point reader at stat(2) for explanation of file mode
- Michael Kerrisk [Andreas Grünbacher]
- Further tweaks to text on S_ISVTX and 'mode' argument
+mprotect.2
+pkey_alloc.2
+ Mark Wielaard [Florian Weimer]
+ _GNU_SOURCE is required for the pkey functions.
-mknod.2
+pivot_root.2
Michael Kerrisk
- Rewordings + point reader at stat(2) for details of mode bits
-
-mmap.2
+ ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation
Michael Kerrisk
- Remove text that implies that munmap() syncs MAP_SHARED mapping to file
- The existing text in this page:
-
- MAP_SHARED Share this mapping. Updates to the mapping
- are visible to other processes that map this
- file, and are carried through to the underly‐
- ing file. The file may not actually be
- updated until msync(2) or munmap() is called.
-
- implies that munmap() will sync the mapping to the underlying
- file. POSIX doesn't require this, and some light reading of the
- code and some light testing (fsync() after munmap() of a large
- file) also indicates that Linux doesn't do this.
-
-msync.2
+ '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
- Rework text of DESCRIPTION
- Rewrite the text somewhat, for easier comprehension.
- No (intentional) changes to factual content
-
-nfsservctl.2
- Michael Kerrisk [J. Bruce Fields]
- Note that nfsservctl() was replaced by files in nfsd filesystem
-
-open.2
- Michael Kerrisk [Andreas Gruenbacher]
- open() honors the S_ISVTX, S_ISUID, and S_ISGID bits in 'mode'
+ 'put_old' can't be a mount point with MS_SHARED propagation
Michael Kerrisk
- Tighten wording: use 'mode bit' rather than 'permission bit'
- Michael Kerrisk [NeilBrown]
- BUGS: O_CREAT | O_DIRECTORY succeeds if pathname does not exist
+ SEE ALSO: add mount(2)
poll.2
- Michael Kerrisk [Ian Pilcher]
- Clarify that signal mask treatment in ppoll() is per-thread
- s/sigprocmask()/pthread_sigmask()/
- Michael Kerrisk [Sam Varshavchik]
- After POLLHUP, EOF will be seen only after all data has been consumed
- Michael Kerrisk
- Make it clearer which bits are ignored in 'events'
+ Michael Kerrisk [Alan Stern]
+ Note that poll() equivalent code for ppoll() is not quite equivalent
prctl.2
- Michael Kerrisk [David Wilcox, Filipe Brandenburger]
- Note that "parent" for purposes of PR_SET_DEATHSIG is a *thread*
- See https://bugzilla.kernel.org/show_bug.cgi?id=43300
-
-sendfile.2
- Michael Kerrisk [Jason Newton]
- Note that sendfile does not support O_APPEND for 'out_fd'
- See https://bugzilla.kernel.org/show_bug.cgi?id=82841
- Michael Kerrisk [Gregor Jasny]
- RETURN VALUE: note the possibility of "short sends"
- See https://bugzilla.kernel.org/show_bug.cgi?id=97491
- Michael Kerrisk [Askar Safin]
- Clarify text on 'out_fd' and regular files in Linux 2.4
- See https://bugzilla.kernel.org/show_bug.cgi?id=86001
-
-shutdown.2
- Michael Kerrisk [Stéphane Aulery]
- BUGS: UNIX domain sockets now detect invalid 'how' values
- Bug fixed in Linux 3.7.
- See https://bugzilla.kernel.org/show_bug.cgi?id=47111
-
-sigaction.2
- Michael Kerrisk
- Refer the reader to fcntl(2) F_SETSIG for further details on si_fd
-
-stat.2
- Jann Horn
- Add note about stat() being racy
- Andreas Gruenbacher
- Improve description of some mode constants
- Michael Kerrisk [Andreas Grünbacher]
- Remove excessive leading zeros on some constants
- Michael Kerrisk
- Add text on POSIX terms "file mode bits" and "file permission bits"
- Recent changes to various pages employ this distinction.
- Michael Kerrisk
- Tighten wording: use 'mode bit' rather than 'permission bit'
- According to POSIX, the the 9 UGO*RWX bits are permissions, and
- 'mode' is used to refer to collectively to those bits plus sticky,
- set-UID, and set_GID bits.
-
-syslog.2
- Michael Kerrisk
- SEE ALSO: add dmesg(1)
-
-umask.2
-open.2
-mknod.2
-mkdir.2
- Andreas Gruenbacher
- Explain what default ACLs do
- Explain the effect that default ACLs have (instead of the umask)
- in umask.2. Mention that default ACLs can have an affect in
- open.2, mknod.2, and mkdir.2.
-
-unshare.2
- Michael Kerrisk [Florian Weimer]
- Give the reader a hint that unshare() works on processes or threads
- See https://bugzilla.kernel.org/show_bug.cgi?id=59281
-
-atexit.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-bsearch.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-cmsg.3
- Michael Kerrisk [Christopher Head]
- Fix error in SCM_RIGHTS code sample
- Remove erroneous second initialization of msg.msg_controllen
- in the example code for SCM_RIGHTS.
- See https://bugzilla.kernel.org/show_bug.cgi?id=15952
-
-CPU_SET.3
- Chris Metcalf
- Clarify language about "available" cpus
- The CPU_SET.3 man page uses the adjective "available" when
- explaining what the argument to CPU_SET() means. This is
- confusing, since "available" isn't well-defined. The kernel
- has a set of adjectives (possible, present, online, and active)
- that qualify cpus, but normally none of these are what the
- cpu_set_t bit index means: it's just "which cpu", using the
- kernel's internal numbering system, even if that cpu isn't
- possible or present.
-
- This change removes the word "available" and adds a sentence
- warning that cpu sets may not be contiguous due to dynamic
- cpu hotplug, etc.
-
-err.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-ftw.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-gethostbyname.3
- Carlos O'Donell
- NSS plugins searched first
- Carlos O'Donell
- "order" is obsolete
-
-gethostid.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are/aren't thread-safe
-
-getmntent.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are/aren't thread-safe
-
-get_nprocs_conf.3
- Michael Kerrisk
- Use exit() rather than return in main()
-
-getopt.3
- Michael Kerrisk [Guy Harris]
- Remove crufty BUGS section
- See https://bugzilla.kernel.org/show_bug.cgi?id=90261
-
-iconv_close.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-inet_ntop.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-longjmp.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-lsearch.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-mcheck.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-on_exit.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-printf.3
- Michael Kerrisk [Egmont Koblinger]
- Merge dprintf() and vdprintf() discussion into this page
- Michael Kerrisk
- SEE ALSO: add puts(3)
- Michael Kerrisk
- Move return value discussion to proper RETURN VALUE section
+ Yang Xu [Cyrill Gorcunov]
+ Correct some details for PR_SET_TIMERSLACK
-putpwent.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-qsort.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-regex.3
- Michael Kerrisk [Laurence Gonsalves]
- Fix error in description of 'cflags'
- 'cflags' is a bit mask of *zero* (not one) or more flags.
-
-resolver.3
- Stéphane Aulery
- Add info about RES_INSECURE1 and RES_INSECURE2 option in debug mode
-
-scanf.3
- Joern Heissler
- Improve description of %n specifier
-
-setjmp.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-setlocale.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-setlogmask.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-sleep.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-strsignal.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-sysconf.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-undocumented.3
- William Woodruff
- Remove documented functions
-
-tty_ioctl.4
- Michael Kerrisk [Denis Du]
- Fix error in code example
-
-proc.5
- Michael Kerrisk [Cameron Norman, Vasiliy Kulikov]
- Document /proc mount options
- Document the 'hidepid' and 'gid' mount options that were added in
- Linux 3.3. See https://bugzilla.kernel.org/show_bug.cgi?id=90641
- Based on text by Vasiliy Kulikov in
- Documentation/filesystems/proc.txt.
- Michael Kerrisk [Kirill A. Shutemov]
- Improve description of /proc/PID/status
- Guillem Jover
- Document /proc/PID/exe behaviour on unlinked pathnames
- Michael Kerrisk [Weijie Yang]
- Document /proc/PID/status VmPMD
-
-resolv.conf.5
- Stéphane Aulery [Thomas Hood]
- Document use-vc option added to glibc 2.14
- Fix Ubuntu bug #1110781:
- https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781
- Stéphane Aulery [Thomas Hood]
- Document RES_SNGLKUPREOP
- Fix Ubuntu bug #1110781:
- https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781
-
-tzfile.5
- Sam Varshavchik
- Add various details on version 2 format
+setxattr.2
+ Finn O'Leary [Michael Kerrisk]
+ Add ERANGE to 'ERRORS' section
-aio.7
+tkill.2
Michael Kerrisk
- Add details and update URL for OLS 2003 paper on AIO
+ glibc 2.30 provides a wrapper for tgkill()
-xattr.7
- Michael Kerrisk
- Document EA limits for Btrfs
- Document VFS-imposed limits on EAs
- VFS imposes a 255-byte limit on EA names, and a 64kB limit on
- EA values.
- Michael Kerrisk
- The ext[234] block limitation applies to sum of all EAs
- It is not a per-EA limit.
+dlopen.3
Michael Kerrisk
- Clarify permissions required to work with 'user' EAs
+ 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
- ext2 and ext3 no longer need mounting with 'user_xattr' for user EAs
+ 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
- Add various relevant pages to SEE ALSO
+ An object opened with RTLD_LOCAL can be promoted to RTLD_GLOBAL
Michael Kerrisk
- Add CONFORMING TO section
+ Note that symbol use might keep a dlclose'd object in memory
+ My earlier commit was in error:
Michael Kerrisk
- Modify headings to man-pages norms
+ On dlclose(), destructors are called when reference count falls to 0
Michael Kerrisk
- Btrfs also supports extended attributes
+ Make it clear that RTLD_NODELETE also affects global variables
Michael Kerrisk
- File capabilities are implemented using *security* attributes
- Not *system* attributes
- Michael Kerrisk
- Describe limit on EA values for JFS, XFS, and Reiserfs
+ Clarify that constructors are called only when library is first loaded
-bootparam.7
- Michael Kerrisk [Alain Kalker]
- Update discussion of 'debug' option
- See https://bugzilla.kernel.org/show_bug.cgi?id=97161
- Michael Kerrisk
- Summary of multiple changes: remove cruft from this page.
- Much of the detail on hardware specifics in this page dates
- from the 20th century. (The last major update to this page was in
- man-pages-1.14!) It's hugely out of date now (many of these
- devices disappeared from the kernel years ago.) So, I've taken
- a large scythe to the page to remove anything that looks
- seriously dated. In the process, the page has shrunk to less
- than 50% of its previous size.
+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
- Remove "buff=" details
- This seems to have gone away in Linux 2.2.
+ SEE ALSO: add cpuid(1)
+
+elf.5
Michael Kerrisk
- Remove crufty "Mouse drivers" options
+ SEE ALSO: add ld.so(8)
+
+proc.5
Michael Kerrisk
- Remove crufty "General non-device-specific boot arguments" options
+ Correct description of /proc/PID/status 'ShdPnd' and 'SigPnd' fields
+ These fields are signal masks, not counters.
Michael Kerrisk
- Remove crufty "Hard disks" options
+ Clarify that various mask fields in /proc/PID/status are in hexadecimal
+
+capabilities.7
Michael Kerrisk
- Remove crufty "mem=" details
+ Add a note about using strace on binaries that have capabilities
Michael Kerrisk
- Remove crufty details on IBM MCA bus devices
+ Add pivot_root(2) to CAP_SYS_ADMIN list
Michael Kerrisk
- Remove 'swap=" details
- This seems to have gone away in Linux 2.2,
+ CAP_FOWNER also allows modifying user xattrs on sticky directories
+
+cgroup_namespaces.7
Michael Kerrisk
- Remove crufty floppy disk driver options
- In the specific case of floppy drives: the drivers still
- exist, but it's been a while since most of saw these devices
- in the wild. So, just refer the reader to the kernel source
- file for details. (The detail in this man page was after all
- originally drawn from that file.)
- Remove crufty "ISDN drivers" options
+ Some wording fixes to improve clarity
Michael Kerrisk
- Remove crufty "line printer driver" options
+ In the example shell session, give second shell a different prompt
+
+credentials.7
Michael Kerrisk
- Remove crufty "Serial port drivers" options
+ Note that /proc/PID/status shows a process's credentials
Michael Kerrisk
- Remove crufty reference to CONFIG_BUGi386
- That option disappeared in Linux 2.4.
+ SEE ALSO: add tcgetsid(3)
+
+fanotify.7
+ Matthew Bobrowski
+ Reword FAN_REPORT_FID data structure inclusion semantics
Michael Kerrisk
- Remove crufty text
- "bootsetups array" dates from Linux 2.0.
+ Clarify logic in ESTALE check
Michael Kerrisk
- Remove crufty "Video hardware" options
+ Reorder text in EXAMPLE
Michael Kerrisk
- Remove crufty SCSI device driver options
-
-fanotify.7
- Michael Kerrisk [Heinrich Schuchardt]
- Since Linux 3.19, fallocate(2) generates FAN_MODIFY events
+ Reformat program output to fit in 80 columns
-inotify.7
- Michael Kerrisk [Heinrich Schuchardt]
- Since Linux 3.19, fallocate(2) generates IN_MODIFY events
-
-ip.7
+mount_namespaces.7
Michael Kerrisk
- Explain how IP_ADD_MEMBERSHIP determines its argument type
- Michael Kerrisk [Jiri Pirko, Magnus REFTEL]
- Clarify details of the IP_MULTICAST_IF socket option
- Michael Kerrisk [Advait Dixi]
- Remove dubious text that says that SO_PRIORITY set IP TOS
- See https://bugzilla.kernel.org/show_bug.cgi?id=35852
+ 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
- Relocate misplaced text describing ENOPROTOOPT error
-
-packet.7
- Graham Shaw
- Add sll_protocol to list of required fields for outbound packets
+ SEE ALSO: add pivot_root(2), pivot_root(8)
-pthreads.7
- Michael Kerrisk [KOSAKI Motohiro]
- Using thread IDs whose lifetime has expired gives undefined behavior
- See https://bugzilla.kernel.org/show_bug.cgi?id=53061
+namespaces.7
+ Michael Kerrisk
+ Note initial values of hostname and domainname in a new UTS namespace
-raw.7
- Michael Kerrisk [Tetsuo Handa]
- For incoming datagrams, sin_port is set to zero
+sched.7
Michael Kerrisk
- Mention sendto(), recvfrom(), and so on when discussing address format
- This gives the reader a little context for the following
- discussion of 'sin_port'.
+ 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
- Remove crufty reference to <netinet/in.h>
+ Various fields in /proc/PID/status show signal-related information
Michael Kerrisk
- Replace reference to RFC 1700 with pointer to IANA protocol number list
+ Add subsection on queuing and delivery semantics for standard signals
-signal.7
- Michael Kerrisk [Steinar H. Gunderson]
- Clarify that I/O operations on disks are not interrupted by signals
- See https://bugzilla.kernel.org/show_bug.cgi?id=97721
+socket.7
+ Michael Kerrisk
+ select()/poll()/epoll honor SO_RCVLOWAT since Linux 2.6.28
unix.7
- Michael Kerrisk [Christophe Lohr]
- Remove mention of UNIX_PATH_MAX
- This kernel constant is not exposed to user space.
Michael Kerrisk
- Note the 108 bytes for sun_path is how things are done on Linux
- And refer the reader to NOTES for discussion of portability.
-
+ 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.
-xattr.7
+user_namespaces.7
Michael Kerrisk
- Explicitly mention some of the xattr system calls in DESCRIPTION
- Naming the system calls helps to orient the reader
-
-nscd.8
+ Describe the effect of file-related capabilities inside use namespaces
Michael Kerrisk
- Add mention of 'services' and 'netgroup' databases
- This makes the page consistent with nscd.conf(5).
+ 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).