man-pages-4.05 released

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Gidday,

The Linux man-pages maintainer proudly announces:

    man-pages-4.05 - man pages for Linux

This release includes input and contributions from
nearly 70 people. Over 400 pages saw changes, ranging
from typo fixes through to page rewrites and newly
created pages.

Tarball download:
    http://www.kernel.org/doc/man-pages/download.html
Git repository:
    https://git.kernel.org/cgit/docs/man-pages/man-pages.git/
Online changelog:
    http://man7.org/linux/man-pages/changelog.html#release_4.05

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2016/03/man-pages-405-is-released.html

The current version of the pages is browsable at:
http://man7.org/linux/man-pages/

You are receiving this message either because:

a) You contributed to the content of this release.

b) You are subscribed to linux-man@xxxxxxxxxxxxxxx or
libc-alpha@xxxxxxxxxxxxxx.

c) I have information (possibly inaccurate) that you are the maintainer
of a translation of the manual pages, or are the maintainer of the
manual pages set in a particular distribution, or have expressed
interest in helping with man-pages maintenance, or have otherwise
expressed interest in being notified about man-pages releases.
If you don't want to receive such messages from me, or you know of
some other translator or maintainer who may want to receive such
notifications, send me a message.

Cheers,

Michael


==================== Changes in man-pages-4.05 ====================

Released: 2016-03-15, Christchurch


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:

Adhemerval Zanella <adhemerval.zanella@xxxxxxxxxx>
Akihiro Suda <suda.kyoto@xxxxxxxxx>
Alan Aversa <alan.aversa@xxxxxxx>
Alan Cox <etchedpixels@xxxxxxxxx>
Alec Leamas <leamas.alec@xxxxxxxxx>
Alex Henrie <alexhenrie24@xxxxxxxxx>
Alexander Miller <alex.miller@xxxxxx>
Andreas Gruenbacher <agruenba@xxxxxxxxxx>
Andreas Schwab <schwab@xxxxxxx>
Anna Schumaker <Anna.Schumaker@xxxxxxxxxx>
Askar Safin <safinaskar@xxxxxxx>
Bill O. Gallmeister <bgallmeister@xxxxxxxxx>
Carlos O'Donell <carlos@xxxxxxxxxx>
Chris Pick <kernel@xxxxxxxxxxxxx>
Christoph Hellwig <hch@xxxxxxxxxxxxx>
Craig Gallek <kraig@xxxxxxxxxx>
Darrick J. Wong <darrick.wong@xxxxxxxxxx>
Davidlohr Bueso <dave@xxxxxxxxxxxx>
Dmitry V. Levin <ldv@xxxxxxxxxxxx>
Dr. Tobias Quathamer <toddy@xxxxxxxxxx>
Eric Blake <eblake@xxxxxxxxxx>
Eric Dumazet <edumazet@xxxxxxxxxx>
Florian Weimer <fweimer@xxxxxxxxxx>
Gabriel Corona <gabriel.corona@xxxxxxxxxxxxxxxx>
Heinrich Schuchardt <xypron.glpk@xxxxxx>
Ivan Shapovalov <intelfx@xxxxxxxxxxxx>
Jakub Wilk <jwilk@xxxxxxxxx>
Jason Baron <jbaron@xxxxxxxxxx>
Jason Vas Dias <jason.vas.dias@xxxxxxxxx>
Jérémie Galarneau <jeremie.galarneau@xxxxxxxxxxxx>
Jeremy Harris <jeharris@xxxxxxxxxx>
Joachim Wuttke <j.wuttke@xxxxxxxxxxxxx>
Joe Stein <joeaarons@xxxxxxxxx>
John Stultz <john.stultz@xxxxxxxxxx>
Josh Triplett <josh@xxxxxxxxxxxxxxxx>
Kondo, Naoya <kondo-naoya@xxxxxxxxxxxxxx>
Krzysztof Adamski <k@xxxxxxxx>
Manfred Spraul <manfred@xxxxxxxxxxxxxxxx>
Marianne CHEVROT <blackmoor@xxxxxxxxxxxxxxx>
Marko Myllynen <myllynen@xxxxxxxxxx>
Mark Post <mpost@xxxxxxxx>
Martin Gebert <Murphy.Gebert@xxxxxx>
Mats Wichmann <mats@xxxxxxxxxxxxxxxxxxx>
Matt Zimmerman <mdz@xxxxxxxxxx>
Michael Kerrisk <mtk.manpages@xxxxxxxxx>`
Mike Frysinger <vapier@xxxxxxxxxx>
Minchan Kim <minchan@xxxxxxxxxx>
Naoya Kondo <kondo-naoya@xxxxxxxxxxxxxx>
Naresh Kamboju <naresh.kernel@xxxxxxxxx>
Nikola Forró <nforro@xxxxxxxxxx>
Nikos Mavrogiannopoulos <nmav@xxxxxxxxxx>
Orion Poplawski <orion@xxxxxxxxxxxxx>
Pakin Yury <zxwarior@xxxxxxxxx>
Patrick Donnelly <batrick@xxxxxxxxxxxx>
Paul Eggert <eggert@xxxxxxxxxxx>
Paul Pluzhnikov <ppluzhnikov@xxxxxxxxxx>
Peter Hurley <peter@xxxxxxxxxxxxxxxxxx>
Peter Wu <peter@xxxxxxxxxxxxx>
Petr Gajdos <pgajdos@xxxxxxx>
Philip Semanchuk <linux_kernel.20.ick@xxxxxxxxxxxxxxx>
Rasmus Villemoes <Rasmus.Villemoes@xxxxxxxxx>
Rich Felker <dalias@xxxxxxxxxx>
Simon Que <sque@xxxxxxxxxxxx>
Stephan Bergmann <sbergman@xxxxxxxxxx>
Stéphane Aulery <lkppo@xxxxxxx>
Stephen Hurd <shurd@xxxxxxxxxxx>
Vincent Bernat <bernat@xxxxxxxx>
William Preston <wpreston@xxxxxxx>
Yuri Kozlov <yuray@xxxxxxxxxxxx>
Zefram <zefram@xxxxxxxx>

Apologies if I missed anyone!


New and rewritten pages
-----------------------

copy_file_range.2
    Anna Schumaker  [Darrick J. Wong, Christoph Hellwig, Michael Kerrisk]
        New page documenting copy_file_range()
            copy_file_range() is a new system call for copying ranges of data
            completely in the kernel.  This gives filesystems an opportunity to
            implement some kind of "copy acceleration", such as reflinks or
            server-side-copy (in the case of NFS).

personality.2
    Michael Kerrisk
        This page has been greatly expanded, to add descriptions of
        personality domains.

fmemopen.3
    Michael Kerrisk  [Adhemerval Zanella]
        Significant reworking of this page:
        * Rework discussion of the (obsolete) binary mode
        * Split open_memstream(3) description into a separate page.
        * Note various fmemopen() bugs that were fixed in glibc 2.22
        * Greatly expand description of 'mode' argument
        * Rework description of 'buf' and 'len' arguments
        * Expand discussion of "current position" for fmemopen() stream

ntp_gettime.3
    Michael Kerrisk
        New page describing ntp_gettime(3) and ntp_gettimex(3)

open_memstream.3
    Michael Kerrisk
        New page created by split of fmemopen(3).
        At the same time, add and rework a few details in the text.

posix_spawn.3
    Bill O. Gallmeister, Michael Kerrisk
        New man page documenting posix_spawn(3) and posix_spawnp(3)

readdir.3
    Michael Kerrisk  [Florian Weimer]
        Split readdir_r() content into separate page
            As suggested by Florian Weimer:
                It may make sense to move this documentation to a separate
                manual page, specific to readdir_r.  This will keep the
                readdir() documentation nice and crisp.  Most programmers
                will never have to consult all these details.
    Michael Kerrisk
        Near complete restructuring of the page and add some further details
    Michael Kerrisk  [Florian Weimer, Rich Felker, Paul Eggert]
        Add a lot more detail on portable use of the 'd_name' field

readdir_r.3
    Michael Kerrisk  [Florian Weimer]
        New page created after split of readdir(3).
    Michael Kerrisk  [Florian Weimer]
        Explain why readdir_r() is deprecated and readdir() is preferred
    Michael Kerrisk  [Florian Weimer]
        Remove misleading code example using pathconf()

lirc.4
    Alec Leamas
        New page documenting lirc device driver


Newly documented interfaces in existing pages
---------------------------------------------

adjtimex.2
    Michael Kerrisk
        Document ntp_adjtime(3)

epoll_ctl.2
    Michael Kerrisk  [Jason Baron]
        Document EPOLLEXCLUSIVE

madvise.2
    Minchan Kim  [Michael Kerrisk]
        Document MADV_FREE
            Document the MADV_FREE flag added to madvise() in Linux 4.5.

proc.5
    Michael Kerrisk
        Document CmaTotal and CmaFree fields of /proc/meminfo
    Michael Kerrisk
        Document additional /proc/meminfo fields
            Document DirectMap4k, DirectMap4M, DirectMap2M, DirectMap1G
    Michael Kerrisk
        Document MemAvailable /proc/meminfo field
    Michael Kerrisk
        Document inotify /proc/PID/fdinfo entries
    Michael Kerrisk
        Document fanotify /proc/PID/fdinfo entries
    Michael Kerrisk
        Add some kernel version numbers for /proc/PID/fdinfo entries
    Michael Kerrisk  [Patrick Donnelly]
        /proc/PID/fdinfo displays the setting of the close-on-exec flag
            Note also the pre-3.1 bug in the display of this info.

socket.7
    Craig Gallek  [Michael Kerrisk, Vincent Bernat]
        Document some BPF-related socket options
            Document the behavior and the first kernel version for each of the
            following socket options:

                SO_ATTACH_FILTER
                SO_ATTACH_BPF
                SO_ATTACH_REUSEPORT_CBPF
                SO_ATTACH_REUSEPORT_EBPF
                SO_DETACH_FILTER
                SO_DETACH_BPF
                SO_LOCK_FILTER


New and changed links
---------------------

isalpha_l.3
    Michael Kerrisk
        New link to isalpha.3

longjmp.3
    Michael Kerrisk
        Replace page with link to setjmp(3), which now incorporates longjmp()

ntp_adjtime.3
    Michael Kerrisk
        New link to adjtimex(2)

ntp_gettimex.3
    Michael Kerrisk
        New link to ntp_gettime.3

open_wmemstream.3
    Michael Kerrisk
        Update link to point to new open_memstream(2) page

posix_spawnp.3
    Michael Kerrisk
        New link to new posix_spawn.3 page

siglongjmp.3
    Michael Kerrisk
        Rewire link to point to setjmp(3)

strerror_l.3
    Michael Kerrisk
        New link to strerror.3
            Fix missing link


Global changes
--------------

Various pages
    Michael Kerrisk
        Update FTM requirements (_DEFAULT_SOURCE)
    Michael Kerrisk
        Update feature test macro requirements
            Update to use _DEFAULT_SOURCE, and also changes brought by
            glibc commit 266865c0e7b79d4196e2cc393693463f03c90bd8.

Various pages
    Michael Kerrisk
        Simplify FTM requirements
            Looking at <features.h> (or feature_test_macros(7)), one can
            see that when _XOPEN_SOURCE is defined with the value 700
            (or greater), then _POSIX_C_SOURCE is defined with the value
            200809L (or greater). Therefore, terms in the man pages such as

                _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L

            can be simplified to:

                _POSIX_C_SOURCE\ >=\ 200809L

Various pages
    Michael Kerrisk
        Simplify FTM requirements
            Looking at <features.h> (or feature_test_macros(7)), one can
            see that when _XOPEN_SOURCE is defined with the value 600
            (or greater), then _POSIX_C_SOURCE is defined with the value
            200112L (or greater). Therefore, terms in the man pages such as

                _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L

            can be simplified to:

                _POSIX_C_SOURCE\ >=\ 200112L

Various pages
    Michael Kerrisk
        Simplify FTM requirements
            _XOPEN_SOURCE implies _POSIX_C_SOURCE >=2, so simplify FTM
            requirements in various pages.

Various pages
    Michael Kerrisk
        Remove "or 'cc -std=c99'" from SYNOPSIS
            Under the FTM requirements all of these pages document the
            requirement for _ISOC99_SOURCE. And feature_test_macros(7) now
            documents that "cc -std=c99" produces the same effect as defining
            _ISOC99_SOURCE. So, all of these pages don't additionally need
            to specify "or 'cc -std=c99'" under the FTM requirements
            in the SYNOPSIS. Removing that redundant text also simplifies
            the SYNOPSIS a little.

Various pages
    Michael Kerrisk
        Simplify FTM requirements
            Looking at <features.h> (or feature_test_macros(7)), one can
            see that when _XOPEN_SOURCE is defined with the value 600
            (or greater), then _POSIX_C_SOURCE is defined with the value
            200112L (or greater). Therefore, terms in the man pages such as

                _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L

            can be simplified to:

                _POSIX_C_SOURCE\ >=\ 200112L

Various pages
    Michael Kerrisk
        Remove references to _XOPEN_SOURCE_EXTENDED in SYNOPSIS
            _XOPEN_SOURCE_EXTENDED is obsolete (it existed in SUSv1, but not
            subsequent standards). _XOPEN_SOURCE >= 500 produces the same
            effects as (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED). Modifying
            the SYNOPSIS of various ages that contain:

                _XOPEN_SOURCE\ >=\ 500 ||
                    _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED

            to just:

                _XOPEN_SOURCE\ >=\ 500

            This has the following benefits:

            a) Simplifying the SYNOPSIS by removing ancient
               historical information.

            b) Preventing users from being misled into using
               _XOPEN_SOURCE_EXTENDED in new source code.

Various pages
    Michael Kerrisk
        Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS
            _POSIX_SOURCE was a POSIX.1-1990 creation that was soon made
            obsolete bu _POSIX_C_SOURCE. Retaining mention of it
            in the feature test macro requirements section of the
            SYNOPSIS doesn't contain important information, and may
            mislead readers into actually trying to use this macro.
            A few mentions of it are maintained in a some pages where
            defining _POSIX_SOURCE inhibits some behavior.

Various sockets-related pages
    Michael Kerrisk  [Carlos O'Donell]
        Use consistent argument/variable names for socket addresses and lengths
            As noted by Carlos, there's quite a bit of inconsistency across
            pages. Use 'addr' and 'addrlen' consistently in variables and
            function arguments.

Various pages
    Michael Kerrisk
        Wording fix: "current file offset" ==> "file offset"
            "File offset" is the preferred POSIX terminology.

Various pages
    Michael Kerrisk
        Word "descriptor" more precisely
            Use either "file descriptor" or message queue descriptor".

Various pages
    Michael Kerrisk
        ERRORS: add reference to signal(7) in description of EINTR


Changes to individual pages
---------------------------

locale.1
    Marko Myllynen
        Add "locale -c charmap" as an example
            Addresses https://bugzilla.kernel.org/show_bug.cgi?id=104511.

localedef.1
    Marko Myllynen
        Add hint on purpose of --no-archive
            Indicate why using --no-archive might be a good idea. The issue
            is that if you create a custom locale with localedef(1) and put
            it to the locale archive then during the next glibc upgrade the
            locale archive is updated as well and your custom locale is gone.)

accept.2
    Michael Kerrisk
        ERRORS: improve description for EBADF

adjtimex.2
    Michael Kerrisk  [John Stultz]
        Various improvements after feedback from John Stultz
    Michael Kerrisk
        Remove FTM requirements
            It seems that adjtimex() never needed _BSD_SOURCE (and my
            earlier commit 5918743bc8b02b was simply a blunder).
    Michael Kerrisk
        Split EINVAL error cases
    Michael Kerrisk
        Note treatment of out-of-range buf.offset
    Michael Kerrisk
        Don't refer reader to adjtime(3)
            Probably, it's not wise to suggest adjtime(3) as the more
            portable API. Rather, ntp_adjtime(3) should be used.
    Michael Kerrisk  [Naresh Kamboju]
        Update details of buf.offset EINVAL error
    Michael Kerrisk
        SEE ALSO: add ntp_gettime(3)
    Michael Kerrisk
        Improve description of some PPS timex fields
    Michael Kerrisk
        Add ATTRIBUTES section
    William Preston  [Petr Gajdos]
        Update a detail in adjtimex return value description
    Michael Kerrisk
        Note range constraints and clamping for ADJ_FREQUENCY

bdflush.2
    Michael Kerrisk
        Note that glibc support for this system call went away in version 2.23

bind.2
    Michael Kerrisk
        Improve description of ENOENT error

bpf.2
    Michael Kerrisk
        Document close-on-exec semantics
            The close-on-exec file descriptor flag is automatically enabled
            for FDs returned by bpf().

chmod.2
    Michael Kerrisk
        Clarify terminology (file mode versus file permission bits)

chown.2
    Michael Kerrisk
        ERRORS: improve EBADF description

clone.2
unshare.2
    Michael Kerrisk
        Remove mention of _BSD_SOURCE and _SVID_SOURCE
            The right way to expose declarations for these Linux-specific
            system calls was always _GNU_SOURCE. Mentioning the historical
            use of _BSD_SOURCE and _SVID_SOURCE just clouds the issue.

connect.2
    Michael Kerrisk
        ERRORS: improve EBADF description

create_module.2
    Michael Kerrisk
        Glibc 2.23 removed last vestiges of support for this system call

delete_module.2
    Michael Kerrisk
        Glibc 2.23 removed last vestiges of support for this system call

epoll_ctl.2
    Michael Kerrisk
        Document ELOOP error for circular monitoring loops

eventfd.2
    Michael Kerrisk
        Note that eventfd info is available in /proc/PID/fdinfo

execve.2
    Michael Kerrisk  [Krzysztof Adamski]
        Add EPERM error for capabilities check of capability-dumb binaries
    Michael Kerrisk
        Add reference to ld-linux.so(8)
    Michael Kerrisk
        SEE ALSO: add system(3)

fanotify_init.2
    Michael Kerrisk
        Note kernel version that allowed O_CLOEXEC for event_f_flags

fcntl.2
flock.2
    Michael Kerrisk
        SEE ALSO: add lslocks(8)

fcntl.2
    Michael Kerrisk  [Jason Vas Dias]
        Rework description of F_SETOWN
            As suggested by Jason, make it clearer that I/O signalling
            requires the use of both F_SETOWN and O_ASYNC. While we're at,
            make a few other cleanups to the text.
    Michael Kerrisk
        Remove mention of _BSD_SOURCE to get definition of F_SETOWN/F_GETOWN
            This usage went away in glibc 2.20, and the simplest remedy
            is just to omit mention of it.

futex.2
    Michael Kerrisk
        FUTEX_CLOCK_REALTIME can now be used with FUTEX_WAIT

get_kernel_syms.2
    Michael Kerrisk
        Note that glibc des not support this system call

init_module.2
    Michael Kerrisk
        Glibc 2.23 removed last vestiges of support for this system call

ioctl_list.2
    Heinrich Schuchardt
        Include uapi/linux/wireless.h
            Add the list of wireless IOCTLs.
    Heinrich Schuchardt
        Path to sockios.h
            sockios.h is now in include/uapi
    Heinrich Schuchardt
        Add reference to netdevice.7
            netdevice.7 describes most of the IOCTLs of sockios.h
    Heinrich Schuchardt
        Transfer structure (wireless.h IOCTLs)
            The sole parameter to be passed to the wireless.h IOCTLs is
            of type struct iwreq *.

ioperm.2
    Michael Kerrisk  [Alex Henrie]
        ioperm.2: Permissions are inherited across fork(2)
            See https://bugzilla.kernel.org/show_bug.cgi?id=99911

iopl.2
    Michael Kerrisk  [Alex Henrie]
        Permissions are not inherited across fork(2) or preserved on execve(2)
            See https://bugzilla.kernel.org/show_bug.cgi?id=99901

lseek.2
    Michael Kerrisk
        FUSE now supports SEEK_HOLE and SEEK_DATA
    Michael Kerrisk
        NFS supports SEEK_HOLE and SEEK_DATA

    Michael Kerrisk
        SEE ALSO: add open(2)

madvise.2
    Michael Kerrisk
        Clarify MADV_HWPOISON wording to say that it applies to a page range

mknod.2
    Michael Kerrisk
        SEE ALSO: add mknod(1)

mount.2
    Michael Kerrisk
        SEE ALSO: add findmnt(8)

open.2
    Michael Kerrisk
        NOTES: mention existence of proc/PID/fd and /proc/PID/fdinfo
    Mark Post  [Petr Gajdos]
        O_TMPFILE support is now provided bt Btrfs

pipe.2
    Michael Kerrisk  [Eric Blake]
        Note treatment of 'pipefd' on error

poll.2
    Michael Kerrisk  [Josh Triplett]
        Document spurious EAGAIN error that can occur on other systems
            Light reworking of text proposed by Josh Triplett.

readlink.2
    Michael Kerrisk
        Clarify EINVAL error description

recv.2
    Heinrich Schuchardt
        Equivalence to read()
            Describe the recv(2)-read(2) and the recvfrom(2)-recv(2)
            equivalences for zero-valued arguments.
    Michael Kerrisk
        MSG_WAITALL has no effect for datagram sockets

recv.2
cmsg.3
    Nikola Forró
        Fix type of cmsg_len member of cmsghdr structure
            The type shown for cmsg_len member of cmsghdr structure is socklen_t,
            but the actual type used by glibc and the kernel is size_t.
            The information was obtained from glibc source code:
            http://bit.ly/21m1RMp
    Michael Kerrisk
        Note that cmsg_len is typed as socklen_t in POSIX.1


sched_setaffinity.2
    Michael Kerrisk  [Florian Weimer, Florian Weimer]
        Warn that CPU_ALLOC() may allocate a slightly CPU set than requested
    Michael Kerrisk  [Florian Weimer]
        Add reference to CPU_ALLOC(3)

sched_setattr.2
    Michael Kerrisk  [Akihiro Suda]
        EPERM depends on affinity mask of target thread, not calling thread

select.2
    Michael Kerrisk  [Josh Triplett]
        Document spurious EAGAIN error that can occur on other systems
            Light reworking of text proposed by Josh Triplett.
    Nikos Mavrogiannopoulos
        Mention the 'fd_set' size limitation early and refer to poll(2)
            Change this because of the serious limitation of select()
            imposing a limit on the range of file descriptors that can
            be monitored. This is currently mentioned too late in the
            documentation (in the NOTES section). The man page should
            warn early and refer to poll(2) as soon as possible.
    Michael Kerrisk
        Add details on the glibc fixed-size fd_set limitation
            No modern application should use select() on Linux.

select_tut.2
    Michael Kerrisk
        Some readability fixes to example program
    Michael Kerrisk
        Better variable names in example program
    Michael Kerrisk
        Simplify 'if' logic in in example program
    Michael Kerrisk
        Use correct type (socklen_t) for addrlen

semctl.2
    Michael Kerrisk  [Davidlohr Bueso, Manfred Spraul, Philip Semanchuk]
        NOTES: note when 'sempid' is set on various implementations
            See https://bugzilla.kernel.org/show_bug.cgi?id=112271 and
            http://thread.gmane.org/gmane.linux.kernel/2162754/
                Subject: [PATCH] Don't set sempid in semctl syscall.
                Date: 2016-02-26 12:21:38 GMT

semop.2
    Michael Kerrisk
        Tweak comment describing 'sempid'

sendfile.2
    Askar Safin
        Fix incorrect description in text referring to splice(2)
    Michael Kerrisk
        SEE ALSO: add copy_file_range(2)

setpgid.2
    Michael Kerrisk
        Correct/simplify FTM requirements for BSD setpgrp() and getpgrp()

signalfd.2
    Michael Kerrisk
        Note that signalfd info is available in /proc/PID/fdinfo

sigprocmask.2
    Michael Kerrisk  [Mike Frysinger]
        Explicitly refer the reader to sigsetops(3)
            This man page did not make it obvious which functions
            should be used for manipulating signals sets, nor where
            those functions were documented.

socketpair.2
    Michael Kerrisk  [Eric Blake]
        Note treatment of 'sv' on error

splice.2
    Askar Safin
        Improve description of 0 return value.
            See https://bugzilla.kernel.org/show_bug.cgi?id=90911

statfs.2
    Michael Kerrisk  [Jakub Wilk]
        Use consistent case for hex constants

sync.2
    Christoph Hellwig
        Clarify description and document the Linux data integrity guarantees

syscall.2
    Mike Frysinger
        Add more architectures and improve error documentation
            Move the error register documentation into the main table rather
            than listing them in sentences after the fact.

            Add sparc error return details.

            Add details for alpha/arc/m68k/microblaze/nios2/powerpc/superh/
            tile/xtensa.

syscalls.2
    Michael Kerrisk
        Add copy_file_range(2)

times.2
    Kondo, Naoya
        Fix an incorrect description in NOTES
            The text has an incorrect description in NOTES, it says
            that (2^32/HZ) - 300 is about 429 million. It is correct
            only if HZ=10 which does not look common today. So just
            removing "(i.e., about 429 million)" is good enough.

truncate.2
    Michael Kerrisk
        SEE ALSO: add truncate(1)

uselib.2
    Michael Kerrisk
        Mention CONFIG_USELIB
    Michael Kerrisk
        Note that glibc does not support this (obsolete) system call

wait.2
wait4.2
    Michael Kerrisk
        Rename the "status" argument to "wstatus"
            The fact that exit(3)/_exit(2) has an argument called
            "status" and the same name is used in the arguments to the
            wait*() calls can a little too easily lead the user into
            thinking that the two arguments hold the same information,
            when of course they don't. So, use a different name
            for the argument of the wait*() functions, to reduce
            the chances of such confusion.

backtrace.3
    Michael Kerrisk  [Martin Gebert]
        Small fixes to example program

clearenv.3
    Michael Kerrisk  [Matt Zimmerman]
        Clarify the use and effect of clearenv()
            See http://bugs.debian.org/679323
    Michael Kerrisk
        Variables can be added to the environment after calling clearenv()

clog10.3
    Michael Kerrisk
        Show an alternative equivalence for clog10()
    Michael Kerrisk
        Update CONFORMING TO
            Fix grammar error and add C11.

dl_iterate_phdr.3
    Michael Kerrisk  [Paul Pluzhnikov]
        Describe 'struct dl_phdr_info' fields added in glibc 2.4
            See https://bugzilla.kernel.org/show_bug.cgi?id=103011
    Michael Kerrisk  [Simon Que]
        Note that first object visited by 'callback' is the main program
            See https://bugzilla.kernel.org/show_bug.cgi?id=94141

errno.3
    Michael Kerrisk
        Add some explanation of ENOENT error

exec.3
    Michael Kerrisk
        SEE ALSO: add system(3)

exp.3
    Michael Kerrisk  [Joachim Wuttke]
        SEE ALSO: add expm1(3)

fopen.3
    Michael Kerrisk
        SEE ALSO: add open_memstream(3)

fts.3
    Michael Kerrisk
        BUGS: glibc-2.23 now has LFS support for the fts functions

gamma.3
    Michael Kerrisk  [Alan Cox]
        gamma() was documented in SVID 2

getaddrinfo.3
    Michael Kerrisk  [Andreas Schwab, Orion Poplawski]
        Update FTM requirements for glibc 2.22
            Since glibc 2.22 getaddrinfo() etc. are only declared for
            POSIX.1-2001 or later.

getcwd.3
    Michael Kerrisk
        SEE ALSO: add pwd(1)

opendir.3
    Michael Kerrisk
        Help the reader by explicitly mentioning the use of readdir(3)

perror.3
    Michael Kerrisk
        Suggest use of strerror(3) in place of deprecated 'sys_errlist'

posix_fallocate.3
    Jérémie Galarneau
        ERRORS: add EINTR
            The glibc implementation of posix_fallocate(), which calls
            fallocate(), may be interrupted. The fallocate() emulation
            also makes use of pread()/pwrite(), which may also be
            interrupted.

posix_memalign.3
    Michael Kerrisk  [Eric Blake]
        Note posix_memalign()'s treatment of 'memptr' on error

pthread_setaffinity_np.3
    Michael Kerrisk
        SEE ALSO: add CPU_SET(3)

queue.3
    Dr. Tobias Quathamer
        Remove double CONFORMING TO section

rcmd.3
    Nikola Forró
        Add missing condition concerning .rhosts file
            The list of conditions determining if iruserok() and ruserok()
            functions automatically fail is incomplete. According to glibc
            source code, the functions also fail if the .rhosts file
            is hard linked anywhere.

setbuf.3
    Michael Kerrisk
        SEE ALSO: add stdbuf(1)

setjmp.3
    Michael Kerrisk
        Rewrite and merge longjmp()/siglongjmp() discussion into this page
            The discussion of nonlocal gotos is much easier to read if
            setjmp() and longjmp() are discussed in the same page. While
            we're at it, rework almost the entire text and add several
            more details.
    Michael Kerrisk
        Note the interactions of longjmp() and non-async-signal-safe functions
            POSIX.1-2008 TC2 adds explicit text on this point.
            See http://austingroupbugs.net/view.php?id=516#c1195
    Michael Kerrisk
        Explain why nonlocal gotos make code harder to maintain
    Michael Kerrisk
        Reword warning on longjmp() to function that has already returned
    Michael Kerrisk
        Remove reference to obsolete _XOPEN_SOURCE_EXTENDED

sleep.3
    Michael Kerrisk
        SEE ALSO: add sleep(1)

strftime.3
    Michael Kerrisk  [Jeremy Harris]
        Note which 'tm' fields are used to calculate each output string
            See https://bugzilla.redhat.com/show_bug.cgi?id=1162218

strlen.3
    Michael Kerrisk  [Alan Aversa]
        CONFORMING TO: add C11

system.3
    Michael Kerrisk
        SEE ALSO: add execve(2)

termios.3
    Dr. Tobias Quathamer
        Document line length in canonical mode
            See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/drivers/tty/n_tty.c#n1673
            See https://bugs.debian.org/797479
    Michael Kerrisk
        SEE ALSO: add tty(1)
    Michael Kerrisk  [Peter Hurley]
        Further improvements to recent tweaks of canonical mode 4096 char limit

timegm.3
    Michael Kerrisk  [Stephen Hurd, Mats Wichmann]
        Remove sample implementation of timegm()
            Stephen and Mats both question the wisdom of showing a portable
            *non-thread-safe* implementation of timegm(), and I find it
            hard to disagree. So, remove this code.

            See https://bugzilla.kernel.org/show_bug.cgi?id=103701
    Michael Kerrisk
        Expand DESCRIPTION a little

st4.4
    Dr. Tobias Quathamer
        Remove spurious copyright section

tty_ioctl.4
    Michael Kerrisk
        SEE ALSO: add ldattach(1)

elf.5
    Michael Kerrisk  [Gabriel Corona, Mike Frysinger]
        Fix description of STV_PROTECTED
    Michael Kerrisk
        Improve description of STV_DEFAULT
    Michael Kerrisk
        Improve description of STV_HIDDEN
    Chris Pick
        Remove erroneous, duplicate SHN_* section
    Michael Kerrisk  [Chris Pick]
        Reword discussion of range values a little

gai.conf.5
    Michael Kerrisk
        Add VERSIONS section

group.5
    Michael Kerrisk
        SEE ALSO: add groups(2)
        SEE ALSO: add gpasswd(1)
        SEE ALSO: add sg(1)
        SE ALSO: add gshadow(5)
        SEE ALSO: add chgrp(1)

locale.5
    Marko Myllynen  [Mike Frysinger]
        tel + fax are deprecated

nsswitch.conf.5
    Nikola Forró
        Update NSS compatibility mode description

utmp.5
    Michael Kerrisk
        SEE ALSO: add lslogins(1)

aio.7
    Andreas Gruenbacher
        Improve example
            When aio_sigevent.sigev_notify is set to SIGEV_SIGNAL, signal
            handlers called for asynchronous I/O operations will have
            si->si_code set to SI_ASYNCIO.  Check to make sure that
            si->si_value.sival_ptr is defined.

capabilities.7
    Michael Kerrisk
        Explain safety check for capability-dumb binaries
    Michael Kerrisk
        SEE ALSO: add sg(1), su(1)
        SEE ALSO: add id(1), group(5), passwd(5)

credentials.7
    Michael Kerrisk
        SEE ALSO: add groups(2)

environ.7
    Michael Kerrisk
        Describe the Bourne "NAME=value command" syntax
    Michael Kerrisk
        Add some details describing hos shell's environment is initialized
    Michael Kerrisk
        Note that child of fork(2) inherits copy of parent's environment
    Michael Kerrisk
        SEE ALSO: add pam_env(3)

epoll.7
    Michael Kerrisk
        Mention that epoll info is available via /proc/PID/fdinfo

fanotify.7
    Michael Kerrisk
        Refer reader to proc(5) for info on /proc/PID/fdinfo fanotify entries

feature_test_macros.7
    Michael Kerrisk
        Add a summary of some FTM key points
    Michael Kerrisk
        Give an early hint about some macros being defined by default
    Michael Kerrisk
        Clarify relation between _XOPEN_SOURCE >=500 and _XOPEN_SOURCE_EXTENDED
            Emphasize that defining _XOPEN_SOURCE >=500 produces same
            effects as defining  _XOPEN_SOURCE_EXTENDED.
    Michael Kerrisk
        Note that man pages don't mention _XOPEN_SOURCE_EXTENDED
            As per previous commit, mention of _XOPEN_SOURCE_EXTENDED
            has generally been removed from the man pages.
    Michael Kerrisk
        Note effects of "cc -std=c99" and "cc -std=c11"
    Michael Kerrisk
        Clarify some _ISOC99_SOURCE / _DEFAULT_SOURCE details
    Michael Kerrisk
        Clarify that _XOPEN_SOURCE_EXTENDED is obsolete
            Since SUSv2, _XOPEN_SOURCE_EXTENDED is no longer specified
            in the standard.

inotify.7
    Michael Kerrisk
        Refer reader to proc(5) for info on /proc/PID/fdinfo inotify entries

ip.7
    Eric Dumazet
        Document IP_BIND_ADDRESS_NO_PORT socket option

mq_overview.7
    Michael Kerrisk
        Note that the close-on-exec flag is automatically set on MQ descriptors

namespaces.7
    Michael Kerrisk
        SEE ALSO: add lsns(1)
            lsns(1) was recently added in util-linux, probably to appear
            in next release (2.28?).

pipe.7
    Michael Kerrisk  [Jason Vas Dias]
        Clarify that I/O signalling requires use of both F_SETOWN and O_ASYNC
    Michael Kerrisk
        SEE ALSO: add mkfifo(1)

signal.7
    Michael Kerrisk
        Note the interactions of longjmp() and non-async-signal-safe functions
            See http://austingroupbugs.net/view.php?id=516#c1195.

socket.7
    Michael Kerrisk
        SEE ALSO: add pcap(3)
        SEE ALSO: add wireshark(1) and tcpdump(8)

standards.7
    Michael Kerrisk
        Add POSIX.1-2008 TC2 (POSIX.1-2016)

svipc.7
    Michael Kerrisk
        Tweak description of 'sempid'
    Michael Kerrisk
        SEE ALSO: add lsipc(1)

symlink.7
    Michael Kerrisk  [Zefram]
        Some "magic" symlinks have permissions other than 0777
            See https://bugs.debian.org/743525

time.7
    Michael Kerrisk
        SEE ALSO: add timeout(1)
        SEE ALSO: add ntp_adjtime(3) and ntp_gettime(3)

unicode.7
    Dr. Tobias Quathamer
        Document private use areas
            See https://bugs.debian.org/285444

unix.7
    Heinrich Schuchardt
        Add example
            A complete example demonstrating the usage of sockets for local
            interprocess communication is added.
    Michael Kerrisk
        Introduce term "sequenced-packet" for SOCK_SEQPACKET
    Michael Kerrisk
        Some wording improvements

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux