-==================== Changes in man-pages-3.83 ====================
+==================== Changes in man-pages-5.01 ====================
Released: ????-??-??, Munich
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Andreas Baak <andreas.baak@gmail.com>
-Andreas Dilger <adilger@dilger.ca>
-cdlscpmv <cdlscpmv@gmail.com>
-Cyrill Gorcunov <gorcunov@openvz.org>
-Darrick J. Wong <darrick.wong@oracle.com>
-David Rientjes <rientjes@google.com>
-Dima Tisnek <dimaqq@gmail.com>
-Eric Sandeen <sandeen@redhat.com>
-Fabien Pichot <fpichot@bouledef.eu>
-Felix Sedlmeier <sedlmeier@gmx.de>
-Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
-Heinrich Schuchardt <xypron.glpk@gmx.de>
-Jann Horn <jann@thejh.net>
-Jon Grant <jg@jguk.org>
-Jonny Grant <jg@jguk.org>
-Kees Cook <keescook@chromium.org>
-Masanari Iida <standby24x7@gmail.com>
-Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
-Michael Kerrisk <mtk.manpages@gmail.com>
-Nikos Mavrogiannopoulos <nmav@gnutls.org>
-Omar Sandoval <osandov@osandov.com>
-Pierre Chifflier <pollux@debian.org>
-Robin H. Johnson <robbat2@gentoo.org>
-Rob Landley <rob@landley.net>
-Theodore Ts'o <tytso@mit.edu>
-Vlastimil Babka <vbabka@suse.cz>
-Walter Harms <wharms@bfs.de>
-William Woodruff <william@tuffbizz.com>
-YOSHIFUJI Hideaki <hideaki.yoshifuji@miraclelinux.com>
-Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
-posix_madvise.3
- Michael Kerrisk
- New page documenting posix_madvise(3)
-
-ftw.3
- Michael Kerrisk
- Reorganize the page to give primacy to nftw()
- nftw() is the better API, and POSIX.1-2008 marks ftw() obsolete.
Newly documented interfaces in existing pages
---------------------------------------------
-getdents.2
- Michael Kerrisk
- Document getdents64()
-
-mount.2
- Michael Kerrisk, Theodore Ts'o [Eric Sandeen, Andreas Dilger,
- Omar Sandoval, Darrick J. Wong]
- Document MS_LAZYTIME
- Based on Ted T'so's commit message 0ae45f63d4e
-
-proc.5
- Michael Kerrisk
- Document /proc/sys/kernel/randomize_va_space
- Michael Kerrisk
- Document /proc/PID/fdinfo epoll format
- Michael Kerrisk
- Describe /proc/PID/fdinfo eventfd format
- Michael Kerrisk
- Document /proc/PID/fdinfo signalfd format
-
New and changed links
---------------------
-newfstatat.2
- Michael Kerrisk
- New link to fstatat64.2
-
-prlimit64.2
- Michael Kerrisk
- New link to getrlimit.2
-
Global changes
--------------
-Various secion 3 math pages
- Michael Kerrisk
- Note that these functions are also in POSIX.1-2001 and POSIX.1-2008
-
Changes to individual pages
---------------------------
-getent.1
- Robin H. Johnson
- Document options
- The options to getent are now documented, after being around for
- nearly a decade without changes.
- Michael Kerrisk
- Document help and version options
-
-fallocate.2
- Michael Kerrisk
- Fix kernel version number for FALLOC_FL_ZERO_RANGE
- FALLOC_FL_ZERO_RANGE as added in 3.15, not 3.14.
- Michael Kerrisk
- Note that SMB3 added FALLOC_FL_ZERO_RANGE support in Linux 3.17
-
-getdents.2
- Michael Kerrisk [Dima Tisnek]
- Update timestamp
- Really just a marker to record the reporters of bugs
- that stemmed from the fact that the page did not
- document getdents64(). I'll fix things up in the changelog.
-
- See https://bugzilla.kernel.org/show_bug.cgi?id=14795
-
-getrlimit.2
- Michael Kerrisk
- Note that the underlying system call for prlimit() is prlimit64()
- Michael Kerrisk
- Remove "_FILE_OFFSET_BITS == 64" from prlimit() FTM requirements
- "_FILE_OFFSET_BITS == 64" is not needed to get the prlimit()
- declaration.
-
-ioctl_list.2
- Nikos Mavrogiannopoulos
- SIOCADDRT accepts in6_rtmsg in INET6 protocol
- Heinrich Schuchardt
- TFD_IOC_SET_TICKS
- timerfd_create.2 mentions TFD_IOC_SET_TICKS. We should add it to
- ioctl_list.2, too.
-
-llseek.2
- Michael Kerrisk
- Advise reader to use lseek(2) instead
- Michael Kerrisk
- llseek() exists on 32-bit platforms to support seeking to large offsets
-
-madvise.2
- David Rientjes
- Specify MADV_REMOVE returns EINVAL for hugetlbfs
- madvise(2) actually returns with error EINVAL for MADV_REMOVE
- when used for hugetlb VMAs, not EOPNOTSUPP, and this has been
- the case since MADV_REMOVE was introduced in commit f6b3ec238d12
- ("madvise(MADV_REMOVE): remove pages from tmpfs shm backing
- store"). Specify the exact behavior.
- Michael Kerrisk
- SEE ALSO: add posix_madvise(2)
-
-poll.2
- Michael Kerrisk [Andreas Baak]
- SEE ALSO: add epoll(7)
-
-posix_fadvise.2
- Michael Kerrisk
- Add "C library/kernel ABI differences" subsection
-
-pread.2
- Michael Kerrisk
- Add "C library/kernel ABI differences" subsection
-
-seccomp.2
- Michael Kerrisk [Pierre Chifflier, Kees Cook]
- Note that seccomp_data is read-only
-
-stat.2
- Michael Kerrisk
- Add some details on various "stat" versions
- Three versions of "stat" appeared on 32-bit systems,
- dealing with structures of different (increasing) sizes.
- Explain some of the details, and also note that the
- situation is simpler on modern 64-bit architectures.
- Michael Kerrisk
- Add a little more detail on history of three versions of *stat()
- Michael Kerrisk
- Add mention of newfstatat()
- The underlying system call for fstatat() is newfstatat()
- on some architectures.
-
-symlink.2
- Michael Kerrisk [Jonny Grant]
- ERRORS: add linkpath=="" case for ENOENT
-
-syscalls.2
- Michael Kerrisk
- Remove prlimit()
- There really is only the prlimit64() system call.
- See also commit 7b08c45b7df.
- Michael Kerrisk
- Add some details about the "multiple versions of system calls"
- The multiple-system-call-version phenomenon is particular a
- feature of older 32-bit platforms. Hint at that fact in the text.
-
-timerfd_create.2
- Cyrill Gorcunov [Michael Kerrisk]
- Document TFD_IOC_SET_TICKS ioctl() operation
- Michael Kerrisk
- Add some details to C library/kernel ABI differences
-
-unshare.2
- Michael Kerrisk [Fabien Pichot]
- Remove mention of "System V" from discussion of CLONE_NEWIPC
- These days, CLONE_NEWIPC also affects POSIX message queues.
-
-asprintf.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-carg.3
- Michael Kerrisk
- Add introductory sentence explaining what these functions calculate
-
-ccos.3
- Ma Shimiao
- ATTRIBUTES: Note functions that are thread-safe
- Michael Kerrisk
- Add introductory sentence explaining what these functions calculate
-
-ccosh.3
- Michael Kerrisk
- Add introductory sentence explaining what these functions calculate
-
-cexp.3
- Ma Shimiao
- ATTRIBUTES: Note functions that are thread-safe
-
-clock.3
- Ma Shimiao
- ATTRIBUTES: Note functions that is thread-safe
-
-clog.3
- Michael Kerrisk
- Add introductory sentence explaining what these functions calculate
-
-csin.3
- Ma Shimiao
- ATTRIBUTES: Note functions that are thread-safe
- Michael Kerrisk
- Add introductory sentence explaining what these functions calculate
-
-csinh.3
- Ma Shimiao
- ATTRIBUTES: Note functions that are thread-safe
- Michael Kerrisk
- Add introductory sentence explaining what these functions calculate
-
-csqrt.3
- Ma Shimiao
- ATTRIBUTES: Note functions that are thread-safe
- Michael Kerrisk
- Simplify description of what these functions calculate
-
-ctan.3
- Ma Shimiao
- ATTRIBUTES: Note functions that are thread-safe
- Michael Kerrisk
- Add introductory sentence explaining what these functions calculate
-
-ctanh.3
- Ma Shimiao
- ATTRIBUTES: Note functions that are thread-safe
- Michael Kerrisk
- Add introductory sentence explaining what these functions calculate
-
-ctime.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-exec.3
- Michael Kerrisk
- SYNOPSIS: Clarify calling signature for execl() and execlp()
- Michael Kerrisk [Andreas Baak]
- Correct prototype for execle()
- Make the prototype shown into correct C.
-
-ftw.3
- Michael Kerrisk [Felix Sedlmeier]
- ftw() and nftw() differ for the non-stat-able symlink case
- The POSIX specification of ftw() says that an un-stat-able
- symlink may yield either FTW_NS or FTW_SL. The specification
- of nftw() does not carry this statement.
- Michael Kerrisk
- CONFORMING TO: add POSIX.1-2008
- Michael Kerrisk
- Update POSIX version references in NOTES
-
-getcwd.3
- Jann Horn [Michael Kerrisk]
- Note behavior for unreachable current working directory
- Michael Kerrisk
- Add ENOMEM error
-
-gethostbyname.3
- Michael Kerrisk [Jonny Grant]
- Clarify that NO_ADDRESS and NO_DATA are synonyms
- Michael Kerrisk
- Add some detail for NO_DATA
- Text consistent with POSIX and FreeBSD's gethostbyname() man page.
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-getnetent.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-get_nprocs_conf.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-getutent.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-glob.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-insque.3
- Ma Shimiao
- ATTRIBUTES: Note functions that are thread-safe
-
-login.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-lseek64.3
- Michael Kerrisk
- Clarify details with respect to 32-bit and 64-bit systems
-
-malloc.3
- Michael Kerrisk
- Add ENOMEM error
-
-mbsnrtowcs.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-mbsrtowcs.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-mq_notify.3
- Michael Kerrisk
- Add "C library/kernel ABI differences" subsection
-
-mq_open.3
- Michael Kerrisk [Fabien Pichot]
- NOTES: explain differences from the underlying system call
- The check for the slash at the start of a pathname is done in glibc
-
-openpty.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-perror.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-posix_memalign.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-printf.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
- Walter Harms [Michael Kerrisk]
- Simplify the example code
-
-qsort.3
- Michael Kerrisk [Rob Landley]
- alphasort() and versionsort() are not suitable for 'compar'
- In glibc 2.10, the prototypes of alphasort() and versionsort()
- were changed so that the arguments switched from 'const void *' to
- 'const struct dirent **', to match the POSIX.1-2008 specification
- of alphasort(). As such, compiler warnings will result if
- these functions are used as the arguments of qsort().
-
- warning: passing argument 4 of 'qsort' from incompatible
- pointer type
- expected '__compar_fn_t' but argument is of type
- 'int (*)(const struct dirent **, const struct dirent **)'
-
- Therefore, remove the ancient NOTES text suggesting that
- alphasort() and versionsort() can be used as suitable
- 'compar' arguments for qsort().
-
-realpath.3
- Michael Kerrisk [Jon Grant]
- Add ENOMEM error
-
-scandir.3
- Michael Kerrisk
- glibc 2.10 changed the argument types for alphasort() and versionsort()
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-scanf.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-setnetgrent.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-significand.3
- Ma Shimiao
- ATTRIBUTES: Note functions that are thread-safe
-
-strcasecmp.3
- Michael Kerrisk [Jonny Grant]
- Clarify that strcasecmp() does a byte-wise comparison
- Michael Kerrisk
- CONFORMING TO: add POSIX.1-2008
-
-unlocked_stdio.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-updwtmp.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-wcrtomb.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-wcsnrtombs.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-wcsrtombs.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-wordexp.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-wprintf.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-proc.5
- Michael Kerrisk
- Describe "mnt_id" field of /proc/PID/fdinfo
- Michael Kerrisk
- Note that abstract sockets are included in /proc/net/unix
- Michael Kerrisk
- Update description /proc/sys/unix 'Type' field
- The existing text was very crufty. UNIX domain sockets
- support more than SOCK_STREAM for a _very_ long time now.
- Michael Kerrisk
- Add some detail to /proc/PID/timers
- Michael Kerrisk [Vlastimil Babka]
- Enhance discussion of /proc/PID/status 'VmSwap' field
- Based on https://lwn.net/Articles/634978/
-
-epoll.7
- Michael Kerrisk
- SEE ALSO: add poll(2) and select(2)
-
-icmp.7
- YOSHIFUJI Hideaki/吉藤英明
- Document net.ipv4.ping_group_range knob
-
-nptl.7
- Michael Kerrisk
- Add reference to timer_create(2)