-==================== Changes in man-pages-4.08 ====================
+==================== Changes in man-pages-5.02 ====================
Released: ????-??-??, Munich
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Arnaud Gaillard <arnaud.mgaillard@gmail.com>
-Bill Pemberton <wfp5p@worldbroken.com>
-Carlos O'Donell <carlos@redhat.com>
-Christoph Hellwig <hch@lst.de>
-David Turner <novalis@novalis.org>
-Dr. Tobias Quathamer <toddy@debian.org>
-Elliott Hughes <enh@google.com>
-Eugene Syromyatnikov <evgsyr@gmail.com>
-Heinrich Schuchardt <xypron.glpk@gmx.de>
-Hu Keping <hukeping@huawei.com>
-Igor Liferenko <igor.liferenko@gmail.com>
-Ivan Kharpalev <ivan.kharpalev@gmail.com>
-Jakub Wilk <jwilk@jwilk.net>
-Jann Horn <jann@thejh.net>
-Josh Triplett <josh@joshtriplett.org>
-Keno Fischer <keno@juliacomputing.com>
-Laurent Georget <laurent.georget@supelec.fr>
-Local Lembke <logan@blackhillsinfosec.com>
-Mats Wichmann <mats@wichmann.us>
-Michael Kerrisk <mtk.manpages@gmail.com>
-Mike Crowe <mac@mcrowe.com>
-Mike Frysinger <vapier@gentoo.org>
-Namhyung Kim <namhyung@gmail.com>
-Nikola Forró <nforro@redhat.com>
-Patrick McLean <patrickm@gaikai.com>
-Peter Wu <peter@lekensteyn.nl>
-Petr Cermak <petrcermak@chromium.org>
-Quentin Rameau <quinq@fifth.space>
-Ray Bellis <ray@isc.org>
-Rich Felker <dalias@libc.org>
-Ruben Kerkhof <ruben@rubenkerkhof.com>
-Sam Varshavchik <mrsam@courier-mta.com>
-Sebastian Andrzej Siewior <bigeasy@linutronix.de>
-Siward de Groot <siward@wanadoo.nl>
-Sloane Bernstein <sloane@cpanel.net>
-Stefan Tauner <tauner@technikum-wien.at>
-Tim Savannah <kata198@gmail.com>
-Ursache Vladimir <f35f22fan@gmail.com>
-Zefram <zefram@fysh.org>
-王守堰 <wangshouyan@gmail.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
-quotactl.2
- Eugene Syromyatnikov [Michael Kerrisk]
- Updated information regarding disk quota flags
- Added information regarding DQF_SYS_FILE flag; updated definition
- of V1_DQF_RSQUASH, which has been defined privately and defined
- publicly as DQF_ROOT_SQUASH.
- Eugene Syromyatnikov
- Updated information regarding XFS-specific quotactl subcommands
- Added information regarding structure definitions used for
- XFS-specific subcommands, updated flag constants, added
- information regarding ignored syscall arguments, added notes on
- usage of kernel UAPI header.
- Eugene Syromyatnikov
- Additions regarding project quotas
- Added information regarding presence of project quotas.
-
-bswap.3
- Michael Kerrisk
- New page documenting bswap_16(), bswap_32(), and bswap_64()
-
-cgroups.7
- Michael Kerrisk
- Substantial rewrites, additions, and corrections.
-
Newly documented interfaces in existing pages
---------------------------------------------
-readv.2
- Michael Kerrisk
- Document the pwritev2() RWF_SYNC and RWF_DSYNC flags
-
-proc.5
- Michael Kerrisk
- Document /proc/PID/seccomp
- Jann Horn
- Document /proc/[pid]/task/[tid]/children
- Document the /proc/[pid]/task/[tid]/children interface from
- CRIU, and more importantly, document why it's usually not
- a good interface.
-
New and changed links
---------------------
-bswap_16.3
-bswap_32.3
-bswap_64.3
- New link to new bswap.3
-
Global changes
--------------
-Various pages
- Michael Kerrisk
- Fix section ordering
- Various pages had sections in an order different from
- that prescribed in man-pages(7).
-
-Various pages
- Michael Kerrisk [Mike Frysinger]
- Consistently use /proc/[pid] (not /proc/PID)
-
-Various pages
- Michael Kerrisk
- Fix order of SEE ALSO entries
- Entries should be ordered first by section, and then alphabetically
- within the section.
-
-Various pages
- Michael Kerrisk
- Order ERRORS alphabetically
-
-Various pages
- Michael Kerrisk
- Remove section number from page self reference
- Fix places where pages refer to the function that they describe
- and include a section number in that reference. Such references
- cause some HTML-rendering tools to create self-references in the
- page.
-
-A few pages
- Michael Kerrisk
- Eliminate groff "cannot adjust line" warnings
-
Changes to individual pages
---------------------------
-pldd.1
- Michael Kerrisk [Carlos O'Donell]
- Note gdb(1) command that can be used as a replacement for pldd
- Taken from Carlos O'Donnell's suggestion in
- https://sourceware.org/bugzilla/show_bug.cgi?id=18035#c2
- Michael Kerrisk
- BUGS: pldd has not worked since glibc 2.19
-
-accept.2
- Michael Kerrisk
- Mention epoll(7) alongside poll()/select()
- Michael Kerrisk
- Demote discussion of DECNet to NOTES
- DECNet ceased to be important long ago...
-
-adjtimex.2
- Nikola Forró
- Fix kernel version references
-
-chroot.2
- Michael Kerrisk
- Note user namespace requirements for CAP_SYS_CHROOT
-
-clone.2
- Keno Fischer [Josh Triplett]
- Adjust syscall prototype and expand CLONE_SETTLS description
- Michael Kerrisk [Josh Triplett, Josh Triplett]
- Document raw syscall interfaces on various other architectures
- Michael Kerrisk
- Change types for 'ptid' and 'ctid' in syscall prototypes
- These types changed from 'void *' to 'int *' back in Linux 3.8.
- Michael Kerrisk
- EINVAL is generated by glibc wrapper for NULL 'fn' or 'child_stack'
- Clarify that this error is produced by the wrapper function, not
- the underlying system call. In particular, the point is that the
- raw system call can accommodate a NULL pointer for 'child_stack'.
- Michael Kerrisk [Elliott Hughes]
- Make the implications of CLONE_FILES more explicit
- If CLONE_FILES is not set, the duplicated FDs nevertheless share
- file offset and status flags via the open file description.
- Michael Kerrisk
- Mention kcmp() under notes
-
-close.2
- Michael Kerrisk
- Add mention of the close-on-exec flag
- Michael Kerrisk
- Clarify discussion noting that close() does not flush buffer cache
-
-epoll_wait.2
- Mike Crowe
- Clarify that the timeout is measured against CLOCK_MONOTONIC
-
-execve.2
- Michael Kerrisk
- Mention use of 'environ' to access environment list
- Michael Kerrisk
- Note that real UID, real GID, and supplementary GIDs are unchanged
-
-fanotify_init.2
- Heinrich Schuchardt
- Update BUGS information
-
-fcntl.2
- Michael Kerrisk
- Note an important detail of F_SETOWN permission rules for signals
- F_SETOWN records the caller's credentials at the time of
- the fcntl() call, and it is these saved credentials that
- are used for subsequent permission checks.
- Michael Kerrisk
- Make the description of the effect of close-on-exec a little clearer
- Michael Kerrisk
- Clarify that F_GETFD and F_GETFL return flags via the function result
-
-fork.2
- Michael Kerrisk
- PID of new process also does not match any existing session ID
-
-fsync.2
- Michael Kerrisk
- SEE ALSO: add pwritev(2)
- Since Linux 4.7, pwritev() has flags related to I/O
- integrity completion.
-
-getdomainname.2
- Michael Kerrisk
- Note user namespace requirements for CAP_SYS_ADMIN
-
-getgroups.2
- Michael Kerrisk
- Note user namespace requirements for CAP_SETGID
-
-gethostname.2
- Michael Kerrisk
- Note user namespace requirements for CAP_SYS_ADMIN
-
-getrlimit.2
- Michael Kerrisk
- Note user namespace semantics for CAP_SYS_RESOURCE
-
-getsid.2
- Michael Kerrisk
- Rework description to be somewhat clearer
- Michael Kerrisk
- Correct the definition of "session ID"
-
-getunwind.2
- Michael Kerrisk
- Simplify text referring to vdso(7)
- The detail given here is redundant, since this info is also
- in vdso(7).
-
-kcmp.2
- Michael Kerrisk
- Add an example program
-
-kill.2
- Michael Kerrisk
- Note the user namespace requirement for CAP_KILL
-
-killpg.2
- Michael Kerrisk
- Refer reader to kill(2) for signal permission rules
-
-mlock.2
- Sebastian Andrzej Siewior
- Document that fork() after mlock() may be a bad idea in a RT process
-
-mmap.2
- Jann Horn
- Describe treatment of 'offset' for MAP_ANONYMOUS
- Michael Kerrisk [Siward de Groot]
- Small improvement to description of MAP_SHARED
- See https://sourceware.org/bugzilla/show_bug.cgi?id=6887
-
-msgctl.2
-msgget.2
-msgop.2
-semctl.2
-semget.2
-semop.2
-shmctl.2
-shmget.2
-shmop.2
- Michael Kerrisk
- Note the user namespace requirements for CAP_IPC_OWNER
-
-open.2
- Michael Kerrisk
- Clarify user namespace capability requirements for O_NOATIME
- Michael Kerrisk
- NOTES: kcmp() can be used to test if two FDs refer to the same OFD
- Michael Kerrisk
- F2FS support for O_TMPFILE was added in Linux 3.16
- Michael Kerrisk
- Clarify the rules about how the group ID of a new file is determined
-
-prctl.2
- Michael Kerrisk
- Refer to proc(5) for effects of dumpability on ownership of /proc/PID/*
- Michael Kerrisk
- ERRORS: Add EACCES error for PR_SET_SECCOMP-SECCOMP_MODE_FILTER
- Michael Kerrisk
- Simplify list of cases where "dumpable" attribute is reset
- Michael Kerrisk
- Note user namespace requirements for PR_CAPBSET_DROP CAP_SETPCAP
-
-readlink.2
- Michael Kerrisk [Ursache Vladimir]
- Make example program handle links that report a size of zero
- Some "magic" symlinks created by the kernel (e.g., those under
- /proc and /sys) report 'st_size' as zero. Modify the example
- program to handle that possibility.
- Michael Kerrisk
- Emphasize that truncation of returned buffer generates no error
-
-readv.2
- Michael Kerrisk [Christoph Hellwig]
- Clarify that RWF_DSYNC and RWF_SYNC apply only to data being written
- Michael Kerrisk
- Add preadv2() and pwritev2() to NAME line
-
-reboot.2
- Michael Kerrisk
- Note user namespace requirements around CAP_SYS_BOOT
-
-rename.2
- Michael Kerrisk [Tim Savannah]
- Clarify that ERRORS may cause rename to fail (not to be nonatomic)
-
-sched_setaffinity.2
- Michael Kerrisk
- Note user namespace requirements for CAP_SYS_NICE
-
-seccomp.2
- Michael Kerrisk
- CAP_SYS_ADMIN is required only in caller's user namespace
-
-select_tut.2
- Peter Wu
- Fix various issues in example program
-
-seteuid.2
- Michael Kerrisk
- Note user namespace requirements for CAP_SETUID and CAP_SETGID
-
-setgid.2
- Michael Kerrisk
- Note user namespace requirements for CAP_SETGID
-
-setpgid.2
- Michael Kerrisk
- Add a reference to credentials(7)
-
-setpgid.2
-setsid.2
- Michael Kerrisk
- Relocate some text on sessions and sessions leaders
- Some text that was in setpgid(2) is better placed in setsid(2).
-
-setresuid.2
- Michael Kerrisk
- Note user namespace requirements for CAP_SETUID
-
-setreuid.2
- Michael Kerrisk
- Note user namespace requirements for CAP_SETUID and CAP_SETGID
-
-setsid.2
- Michael Kerrisk
- Refer to credentials(7) for details for details on controlling terminal
- Refer to credentials(7) for details of how a session obtains
- a controlling terminal.
-
-set_thread_area.2
- Michael Kerrisk
- Add get_thread_area() to NAME
-
-setuid.2
- Michael Kerrisk
- Note user namespace requirements for CAP_SETUID
-
-sigprocmask.2
- Keno Fischer
- Expand/clarify libc/kernel sigset_t difference
-
-stat.2
- Michael Kerrisk [Ursache Vladimir, Mats Wichmann]
- Improve discussion of 'st_size' for /proc and /sys files
- Michael Kerrisk
- _BSD_SOURCE and _SVID_SOURCE no longer expose nanosecond timestamps
-
-umask.2
- Michael Kerrisk
- Provide a rationale for the existence of /proc/PID/status 'Umask' field
-
-wait.2
- Michael Kerrisk
- Remove erroneous statement that waitpid() is implemented via wait4()
- There is a fallback to wait4(), but only if the kernel does
- not provide a waitpid() system call.
-
-bindresvport.3
-rcmd.3
-ip.7
- Michael Kerrisk
- Note user namespace requirements for CAP_NET_BIND_SERVICE
-
-byteorder.3
- Michael Kerrisk
- SEE ALSO: add bswap(3)
-
-dlopen.3
- Michael Kerrisk
- dlmopen() is still broken in glibc 2.24
-
-endian.3
- Michael Kerrisk
- SEE ALSO: add bswap(3)
-
-ffs.3
- Michael Kerrisk [Stefan Tauner]
- Correct feature test macro requirements
-
-fmemopen.3
- Michael Kerrisk [Rich Felker]
- Remove bogus suggestion to use setbuffer()
-
-getlogin.3
- Michael Kerrisk
- Update feature test macro requirements for cuserid()
-
-getumask.3
- Michael Kerrisk
- Note that getumask() is still unavailable in glibc 2.24
- Michael Kerrisk
- Point to umask(2) for a thread-safe way to discover process's umask
-
-mkstemp.3
- Quentin Rameau
- Fix _POSIX_C_SOURCE value for mkstemp()
- The correct _POSIX_C_SOURCE value has always been 200809L,
- not 200112L.
-
-pthread_join.3
- Michael Kerrisk [Mats Wichmann]
- Note that the caller might do clean up after joining with a thread
- Michael Kerrisk [王守堰]
- Clarify use of 'retval' pointer
-
-resolver.3
- Ray Bellis
- Correct arguments to res_ninit(res_state statep)
-
-strverscmp.3
- Michael Kerrisk
- Add an example program
-
-wcstombs.3
- Michael Kerrisk [Igor Liferenko]
- wcsrtombs() does not provide thread-safe interface to same functionality
- See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360
-
-core.5
- Mike Frysinger [Michael Kerrisk]
- Add more details for output paths and the crash handler
- People sometimes assume that the crash handler runs in the same
- context as the crashing process. They would be incorrect :).
-
-proc.5
- Mike Frysinger
- Clarify the root symlink and mount namespaces
- If the target process is in a different mount namespace, the root
- symlink actually shows that view of the filesystem.
- Michael Kerrisk [Mike Frysinger]
- Expand discussion of /proc/[pid]/root
- Add a shell example showing that /proc/[pid]/root is more
- than a symlink. Based on an example provided by Mike Frysinger
- in an earlier commit message.
- Michael Kerrisk
- Explain rules determining ownership of /proc/PID/* files
- Describe the effect of the "dumpable" attribute on ownership
- of /proc/PID files.
- Michael Kerrisk
- Note effect of 'suid_dumpable' on ownership of /proc/PID files
- Michael Kerrisk
- Refer to ptrace(2) for info on effect of suid_dumpable on ptraceability
- Michael Kerrisk
- Add reference to core(5) in discussion of 'suid_dumpable'
- Michael Kerrisk
- Note that 'suid_dumpable' mode 1 is insecure
- Michael Kerrisk
- Document /proc/meminfo '+ShmemHugePages' and 'ShmemPmdMapped' fields
- Michael Kerrisk
- Document /proc/PID/status 'RssAnon', 'RssFile', and 'RssShmem' fields
- Michael Kerrisk
- Document /proc/PID/status 'HugetlbPages' field
- Michael Kerrisk [Zefram]
- Clarify that /proc/PID/statm 'shared' field counts *resident* pages
- See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360
- Michael Kerrisk
- Add reference to umask(2) in discussion of /proc/PID/status 'Umask'
- Michael Kerrisk
- Clarify user namespace requirements for /proc/sys/fs/protected_hardlinks
- Michael Kerrisk
- Note changes to config option governing /proc/[pid]/task/[tid]/children
- Michael Kerrisk
- Clarify description of /proc/PID/statm 'lib' and 'dt' fields
- These fields are always zero since Linux 2.6.
- Namhyung Kim [Petr Cermak]
- Add description of CLEAR_REFS_MM_HIWATER_RSS
- Michael Kerrisk
- Update example VM values in /proc/PID/status
-
-capabilities.7
- Michael Kerrisk
- Add note about nosuid to file capabilities section
- Michael Kerrisk
- SEE ALSO: add proc(5)
- Michael Kerrisk
- SEE ALSO: add setsid(2) and setpgid(2)
-
-glob.7
- Michael Kerrisk [Arnaud Gaillard]
- Clarify that syntactically incorrect patterns are left unchanged
-
-packet.7
- Michael Kerrisk
- Clarify user namespace requirements for CAP_NET_RAW
-
-pipe.7
- Michael Kerrisk [Patrick McLean]
- Document FIONREAD
-
-raw.7
- Michael Kerrisk
- Clarify user namespace requirements for CAP_NET_RAW
- Also remove mention of UID 0 as a method or creating
- a raw socket. As far as I can tell from reading the
- kernel source (net/ipv4/af_inet.c), this is not true.
-
-socket.7
- Michael Kerrisk
- SIOCSPGRP: refer to fcntl(2) F_SETOWN for correct permission rules
- The permission rules described for SIOCCPGRP are wrong. Rather
- than repeat the rules here, just refer the reader to fcntl(2),
- where the rules are described for F_SETOWN.
-
-unix.7
- Michael Kerrisk [Laurent Georget, Ivan Kharpalev]
- Remove mention of recvmsg() from discussion of EPIPE error
- See https://bugzilla.kernel.org/show_bug.cgi?id=137351
-
-ld.so.8
- Michael Kerrisk
- Expand description of LD_DEBUG
- Provide a list of the categories, and note that multiple
- categories can be specified.
- Michael Kerrisk
- Add glibc version for LD_USE_LOAD_BIAS
- Michael Kerrisk
- Clarify text describing whether secure-mode programs preload libraries
- Michael Kerrisk
- Remove discussion of environment variables understood by libc5
- libc5 disappeared long ago, so cease cluttering up this page
- with those ancient details. Thus, remove discussion of the
- following environment variables: LD_AOUT_LIBRARY_PATH,
- LD_AOUT_PRELOAD, LD_KEEPDIR, LD_NOWARN, and LDD_ARGV0.
- Michael Kerrisk
- Remove text with ancient libc4 and Linux libc details
- Michael Kerrisk
- Remove mention of "ELF only"
- Drawing a distinction between ELF-only features versus a,out
- ceased to be relevant long ago, so cluttering the page
- with "ELF-only" serves no purpose.
-