path: root/Changes

==================== Changes in man-pages-3.83 ====================

Released: ????-??-??, 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:

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)