Start of man-pages-3.58: updating Changes and Changes.old

1 files changed, 367 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index adfc5223d..0b626e34c 100644
--- a/Changes.old
+++ b/Changes.old
@@ -28922,3 +28922,370 @@ ld.so.8
         Default output file for D_DEBUG is stderr not stdout
             See https://sourceware.org/bugzilla/show_bug.cgi?id=6874
 
+
+
+==================== 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