path: root/Changes

==================== Changes in man-pages-3.57 ====================

Released: 2014-01-24, 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:

Andi Kleen <andi@firstfloor.org>
Andre Majorel <aym-xunil@teaser.fr>
Andrey Vagin <avagin@openvz.org>
Andy Lutomirski <luto@amacapital.net>
Axel Beckert <abe@debian.org>
Bernhard Walle <bernhard@bwalle.de>
Brandon Edens <bedens@fitbit.com>
Eliezer Tamir <eliezer.tamir@linux.intel.com>
Gioele Barabucci <gioele@svario.it>
Ian Abbott <abbotti@mev.co.uk>
Jerry Chu <hkchu@google.com>
Jonas Jonsson <jonas@websystem.se>
Marc Lehmann <debian-reportbug@plan9.de>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger: <vapier@gentoo.org>
Peng Haitao <penght@cn.fujitsu.com>
Reuben Thomas <rrt@sc3d.org>
Simone Piccardi <piccardi@truelite.it>
Simon Paillard <spaillard@debian.org>
Thomas Posch <man-pages@online.posch.name>
Tilman Schmidt <tilman@imap.cc>
Vince Weaver <vincent.weaver@maine.edu>
Yuri Kozlov <yuray@komyakino.ru>
Марк Коренберг <socketpair@gmail.com>

Apologies if I missed anyone!


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

open.2
    Michael Kerrisk, Andy Lutomirski
        Document O_TMPFILE
            O_TMPFILE is new in Linux 3.11

ptrace.2
    Andrey Vagin
        Add description for PTRACE_PEEKSIGINFO
            Retrieve signals without removing them from a queue.
    Andrey Vagin
        Add description for PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
            These two commands allow to examine and change mask of blocked
            signals.


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

Various pages
    Michael Kerrisk
        Reword to avoid use of "etc."

Various pages
    Peng Haitao  [Andre Majorel]
        Make wording around thread-safety and setlocale() more precise

getdate.3
strptime.3
locale.5
    Michael Kerrisk
        Replace "weekday" with less ambiguous language
            Notwithstanding POSIX's use of the term "weekday", in everyday
            English, "weekday" is commonly understood to mean a day in the
            set [Monday..Friday] (vs one of the "weekend" days).


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

epoll_wait.2
    Michael Kerrisk  [Jonas Jonsson]
        Clarify wording of EINTR error
            See https://bugzilla.kernel.org/show_bug.cgi?id=66571

faccessat.2
    Michael Kerrisk
        Note that the system call takes only three arguments

fallocate.2
    Michael Kerrisk
        Note filesystems that support  FALLOC_FL_PUNCH_HOLE operation

fcntl.2
    Michael Kerrisk
        BUGS: The O_SYNC and O_DSYNC flags are not modifiable using F_SETFL
    Michael Kerrisk
        Add susbsections under BUGS
            There's several bugs listed. It's helpful to mark
            them separately.
    Michael Kerrisk
        POSIX.1 specifies F_SETOWN and F_GETOWN for sockets/SIGURG

getrlimit.2
    Michael Kerrisk  [Марк Коренберг]
        Note that rlim_cur can be set lower than current resource consumption

getsockopt.2
    Michael Kerrisk
        SEE ALSO: add ip(7) and udp(7)

keyctl.2
    Michael Kerrisk
        SEE ALSO: mention Documentation/security/keys.txt

linkat.2
    Michael Kerrisk
        Add ENOENT for O_TMPFILE created with O_EXCL
    Michael Kerrisk
        ERRORS: Add EINVAL

lseek.2
    Michael Kerrisk
        Note which filesystems support SEEK_HOLE/SEEK_DATA

msgop.2
    Michael Kerrisk
        Document MSG_COPY
    Michael Kerrisk
        Note that MSG_EXCEPT is Linux-specific

open.2
    Michael Kerrisk
        Update CONFORMING TO
            Add POSIX.1-2008.  Add mention of O_TMPFILE.
            Update text on various flags that were added in POSIX.1-2008, and
            whose definitions can, since glibc 2.12, be obtained by suitably
            defining _POSIX_C_SOURCE or _XOPEN_SOURCE
    Michael Kerrisk
        Add pointer in description to BUGS, for O_ASYNC limitation
    Michael Kerrisk
        Remove crufty duplicate text on modifying file status flags

ptrace.2
    Michael Kerrisk
        Add details to descriptions of PTRACE_GETSIGMASK and PTRACE_SETSIGMASK

select.2
    Michael Kerrisk  [Marc Lehmann]
        RETURN VALUE: Fix discussion of treatment of file descriptor sets
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=574370

syscalls.2
    Michael Kerrisk
        Remove madvise1() from main list
            madvise1() is one of the system calls that was never
            implemented, and listed toward the bottom of the page.

timer_create.2
    Michael Kerrisk
        Add pointer to proc(5) for info on /proc/[pid]/timers

unlinkat.2
    Michael Kerrisk  [Mike Frysinger:]
        ERRORS: Add EISDIR
            See https://bugzilla.kernel.org/show_bug.cgi?id=29702

perf_event_open.2
    Vince Weaver  [Andi Kleen]
1e043959034888ce1b1a25346316d06f7d64f0fe perf_event_open.2 : PERF_SAMPLE_TRANSACTION support in Linux 3.13 (fwd)
            The following patch adds descriptions of the new perf_event_open.2
            PERF_SAMPLE_TRANSACTION sample type as added in Linux 3.13.

            The descriptions are based on information provided by Andi Kleen,
            both in the e-mail

                [PATCH 1/6] perf, core: Add generic transaction flags v5

            sent to the linux-kernel list as well as an e-mail

                [PATCH] Document transaction flags in perf_event_open manpage

            sent to the linux-man list.

            The implementation is based heavily on the Intel Haswell
            processor.  Documentation can be found at this page:
            http://software.intel.com/en-us/blogs/2013/05/03/intelr-transactional-synchronization-extensions-intelr-tsx-profiling-with-linux-0
            as well as in section 18.11.5.1 of volume 3 of the
            Intel 64 and IA-32 Architecture Software Developer's Manual.

            Also, someone with better manpage formatting skills than I have
            should probably investigate why I can't get the last line of
            the change to properly tab-align with the .I transaction
            heading.

ferror.3
    Michael Kerrisk
        clearerr(), feof(), and ferror() are also POSIX-conformant
    Michael Kerrisk  [Reuben Thomas]
        CONFORMING TO: add fileno()

gets.3
    Ian Abbott
        SEE ALSO: add fgets(3)

mq_receive.3
mq_send.3
    Michael Kerrisk  [Simone Piccardi]
        SYNOPSIS: s/unsigned/unsigned int/

printf.3
    Michael Kerrisk
        Small reorganization of text in EXAMPLE

rand.3
    Michael Kerrisk
        s/unsigned/unsigned int/ in example

stpcpy.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function stpcpy() is thread safe.

stpncpy.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function stpncpy() is thread safe.

strcat.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions strcat() and strncat() are thread safe.

strchr.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions strchr(), strrchr() and strchrnul() are thread safe.

strcmp.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions strcmp() and strncmp() are thread safe.

strftime.3
    Brandon Edens
        Change "week day" to "day of week"
            See https://bugzilla.kernel.org/show_bug.cgi?id=68861

strstr.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread safe with exceptions
            The function strstr() is thread safe.
            The function strcasestr() is thread safe with exceptions.

strtod.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread safe with exceptions
            The functions strtod(), strtof() and strtold() are thread safe
            with exceptions.

strtoimax.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread safe with exceptions
            The functions strtoimax() and strtoumax() are thread safe with
            exceptions.

strtol.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread safe with exceptions
            The functions strtol(), strtoll() and strtoq() are thread safe
            with exceptions.

tcgetpgrp.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions tcgetpgrp() and tcsetpgrp() are thread safe.

tcgetsid.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function tcgetsid() is thread safe.

core.5
    Bernhard Walle
        Mention that %E exists since Linux 3.0
            '%E' in the 'core_pattern' has been introduced in kernel commit
            57cc083ad9e1bfeeb4a0ee831e7bb008c8865bf0 which was included in
            version 3.0. Add that information to the manual page.

filesystems.5
    Michael Kerrisk  [Axel Beckert]
        Add reference to proc(5) for more details on /proc/filesystems
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=735590

locale.5
    Michael Kerrisk
        SEE ALSO: add locale(7)

proc.5
    Michael Kerrisk
        Document /proc/[pid]/timers
    Michael Kerrisk
        Update discussion of wchan
            Remove crufty reference to /etc/psdatabase in /proc/PID/stat.
            Add /proc/PID/wchan.

            See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/737452

environ.7
    Michael Kerrisk  [Gioele Barabucci]
        Correct reference to locale(7) (not locale(5))
            locale(7) is the right place for details of the LC_*
            environment variables.

            See http://bugs.debian.org/638186
    Michael Kerrisk
        Improve references for discussion of locale environment variables
    Michael Kerrisk
        SEE ALSO: add catopen(3)
    Michael Kerrisk
        SEE ALSO: add locale(5)

man-pages.7
    Michael Kerrisk
        Prefer "usable" over "useable"

netdevice.7
    Tilman Schmidt
        Document SIOCGIFCONF case ifc_req==NULL
            Add the missing description of the possibility to call SIOCGIFCONF
            with ifc_req==NULL to determine the needed buffer size, as
            described in
            http://lkml.indiana.edu/hypermail/linux/kernel/0110.1/0506.html
            and verified against source files net/core/dev_ioctl.c and
            net/ipv4/devinet.c in the current kernel git tree.
            This functionality has been present since the beginning of the 2.6
            series. It's about time it gets documented.

            While I'm at it, also generally clarify the section on
            SIOCGIFCONF.

socket.7
    Eliezer Tamir
        Add description for SO_BUSY_POLL
            Add description for the SO_BUSY_POLL socket option.

standards.7
    Michael Kerrisk
        Enhance description of V7
    Michael Kerrisk
        Add C11

tcp.7
    Michael Kerrisk  [Jerry Chu]
        Document TCP_USER_TIMEOUT
            Text slightly adapted from Jerry Chu's (excellent) commit
            message (commit dca43c75e7e545694a9dd6288553f55c53e2a3a3).
    Michael Kerrisk
        Describe format of tcp_*_congestion_control /proc files
            Describe format of tcp_allowed_congestion_control and
            tcp_available_congestion_control.
    Michael Kerrisk
        Document TCP_CONGESTION