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

1 files changed, 467 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index b34feb556..c1d0fac70 100644
--- a/Changes.old
+++ b/Changes.old
@@ -31454,3 +31454,470 @@ packet.7
         Status in PACKET_RX_RING is actually a bit mask
     Michael Kerrisk  [Carsten Andrich]
         SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c
+
+
+==================== Changes in man-pages-3.67 ====================
+
+Released: 2014-05-21, 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:
+
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+sched_setattr.2
+    Michael Kerrisk, Peter Zijlstra [Juri Lelli]
+        New page describing sched_setattr(2) and sched_getattr(2)
+
+system.3
+    Michael Kerrisk
+        Rewrote large parts of the page and added a number of details
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+sched.7
+    Peter Zijlstra, Michael Kerrisk  [Juri Lelli]
+        Document SCHED_DEADLINE
+            Raw text from Peter Zijlstra
+
+New and changed links
+---------------------
+
+renameat2.2
+    Michael Kerrisk
+        New link to rename.2
+
+sched_getattr.2
+    Michael Kerrisk
+        New link to new sched_setattr.
+
+
+Changes to individual pages
+---------------------------
+
+bind.2
+    Michael Kerrisk
+        ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
+
+chown.2
+    Michael Kerrisk
+        NOTES: Add some subheadings
+
+connect.2
+    Michael Kerrisk  [William Morriss]
+        ERRORS: Add EADDRNOTAVAIL for ephemeral port range exhaustion
+            Verified from testing and the kernel source.
+            See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=745775
+    Michael Kerrisk
+        Remove mention of ip_local_port_range under EAGAIN error
+            Man-pages commit ac7477eb7a8 added EADDRNOTAVAIL as the correct
+            error for ephemeral port range exhaustion.  However, that error
+            was also incorrectly described under the EAGAIN entry. So,
+            remove that text under EAGAIN.
+
+create_module.2
+delete_module.2
+init_module.2
+query_module.2
+    Michael Kerrisk  [Lucas De Marchi]
+        Clarify glibc header file declaration/ABI wrapper details
+            create_module(), delete_module(), init_module(), and
+            query_module() are not declared in header files, but
+            through an accident of history glibc provides an ABI
+            for them that it continues to maintain, for
+            compatibility reasons.
+
+execve.2
+    Michael Kerrisk  [Steven Stewart-Gallus]
+        Note SIGKILL case when execve() fails beyond the point of no return
+    Michael Kerrisk
+        NOTES: Add a subheading and reorder paragraphs
+
+fanotify_init.2
+    Heinrich Schuchardt [Michael Kerrisk]
+        Document range of permitted flags for event_f_flags
+            With a new patch included in the mm tree, event_f_flags is
+            checked for allowable values.
+
+fcntl.2
+    Michael Kerrisk
+        Add "file locking" subheading under NOTES
+
+fork.2
+    Michael Kerrisk
+        ERRORS: SCHED_DEADLINE tasks can fail with EAGAIN
+            SCHED_DEADLINE tasks can fail with EAGAIN unless the
+            reset-on-fork flag is set.
+
+futex.2
+    Michael Kerrisk
+        Note that there is no glibc wrapper
+
+getpriority.2
+    Rasmus Villemoes
+        Fix prototypes for getpriority() and setpriority()
+            The who argument has type id_t (which happens to be u32 on linux).
+
+get_robust_list.2
+    Rasmus Villemoes
+        Add <sys/types.h> to synopsis of get_robust_list()
+            If one were to implement wrappers for [gs]et_robust_list() using the
+            given prototypes, one would also have to include sys/types.h to get
+            a definition of size_t.
+
+getrusage.2
+    Michael Kerrisk  [Bill Allombert]
+        _GNU_SOURCE must be defined to obtain RUSAGE_THREAD definition
+            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=746569
+
+link.2
+open.2
+    Andy Lutomirski [Michael Kerrisk]
+        Update AT_EMPTY_PATH and O_PATH documentation
+
+listen.2
+    Michael Kerrisk
+        ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
+
+mbind.2
+    Rasmus Villemoes
+        Fix prototype for mbind(2)
+            The nmask argument is const. The return type in numaif.h is long.
+            (Well, at least <numaif.h> says nmask is const. The current kernel
+            does not define it as a const argument, but sys_mbind() only
+            passes it to get_nodes(), which does treat it as const.)
+
+msgop.2
+    Davidlohr Bueso [Michael Kerrisk]
+        Enhance description of "full queue" criteria
+
+poll.2
+    Rasmus Villemoes
+        Add <signal.h> to synopsis for ppoll()
+            One needs to #include <signal.h> to get the definition of the
+            type (sigset_t) of the mask argument to ppoll().
+
+readlink.2
+    Rasmus Villemoes
+        Fix return type of readlinkat()
+
+recv.2
+    Michael Kerrisk
+        Clarify details of msg_name and msg_namelen fields
+
+recvmmsg.2
+    Michael Kerrisk
+        Describe timeout bug
+            See FIXME https://bugzilla.kernel.org/show_bug.cgi?id=75371
+            and http://thread.gmane.org/gmane.linux.man/5677
+
+remap_file_pages.2
+    Andy Lutomirski [Christoph Hellwig, Andy Lutomirski]
+        remap_file_pages() has no benefit for real files
+            Linux commit 3ee6dafc677a68e461a7ddafc94a580ebab80735 caused
+            remap_file_pages to be emulated when used on real file.
+
+sched_get_priority_max.2
+    Michael Kerrisk
+        'policy' can also be SCHED_DEADLINE
+
+sched_setaffinity.2
+    Rasmus Villemoes
+        Fix prototype for sched_setaffinity()
+            The mask argument is const.
+
+sched_setparam.2
+    Michael Kerrisk
+        ERRORS: mark errors that apply just for sched_setparam()
+    Michael Kerrisk
+        ERRORS: Add EINVAL for invalid arguments
+    Michael Kerrisk
+        SEE ALSO: add sched_setattr(2)
+
+sched_setscheduler.2
+    Michael Kerrisk
+        ERRORS: mark errors that apply just to sched_setscheduler()
+    Michael Kerrisk
+        ERRORS: add EINVAL case for pid < 0
+    Michael Kerrisk
+        ERRORS: separate out EINVAL cases
+
+semget.2
+    Michael Kerrisk
+        NOTES: Add subheadings and reorder paragraphs
+
+semop.2
+    Rasmus Villemoes
+        Fix prototypes for semop() and semtimedop()
+            The nsops arguments have type size_t, not unsigned, and the
+            timeout argument of semtimedop() is const.
+    Michael Kerrisk
+        NOTES: Add a subheading
+
+send.2
+    Michael Kerrisk
+        Add details on various 'msghdr' fields
+    Michael Kerrisk
+        ERRORS: Add EAGAIN for ephemeral port range exhaustion
+    Michael Kerrisk
+        Add some subheadings under DESCRIPTION
+
+shmget.2
+    Michael Kerrisk
+        NOTES: Add a subheading
+
+stat.2
+    Michael Kerrisk  [Aurelien Jarno]
+        Describe feature test macro requirements for file type test macros
+            See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=728240
+    Michael Kerrisk
+        Update FTM requirements for lstat()
+    Michael Kerrisk
+        Split discussion of 'st_mode' fields into type and permissions
+    Michael Kerrisk
+        Move text on S_I*() macros to follow text on S_I* macros
+            That ordering is more logical
+
+stime.2
+    Rasmus Villemoes
+        Fix prototype for stime()
+            The argument is const, both according to the actual header files and
+            according to <http://www.sco.com/developers/devspecs/vol1a.pdf>.
+
+syscall.2
+    Rasmus Villemoes
+        Fix prototype for syscall()
+            The first argument and the return value of syscall() has type long,
+            not int.
+
+getopt.3
+    Michael Kerrisk
+        EXAMPLE: Add subheadings to distinguish the two example programs
+
+malloc.3
+    Michael Kerrisk
+        Reword text referring to mallopt(3)
+            Linux libc is no longer "recent"; drop mention of it.
+
+pthread_attr_setinheritsched.3
+pthread_attr_setschedparam.3
+pthread_attr_setschedpolicy.3
+pthread_setaffinity_np.3
+pthread_setschedparam.3
+pthread_setschedprio.3
+pthread_yield.3
+pthreads.7
+    Michael Kerrisk
+        Change references to "sched_setscheduler(2)" to "sched(7)"
+            Change consistent with the fact that the scheduling overview
+            page is now sched(7) not sched_setscheduler(2).
+
+pthread_attr_setstackaddr.3
+    Peng Haitao
+        ATTRIBUTES: Note functions that are thread-safe
+            The functions pthread_attr_setstackaddr() and
+            pthread_attr_getstackaddr() are thread safe.
+
+pthread_attr_setstacksize.3
+    Peng Haitao
+        ATTRIBUTES: Note functions that are thread-safe
+            The functions pthread_attr_setstacksize() and
+            pthread_attr_getstacksize() are thread safe.
+
+pthread_kill.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_kill() is thread safe.
+
+pthread_kill_other_threads_np.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_kill_other_threads_np() is thread safe.
+
+pthread_self.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_self() is thread safe.
+
+pthread_setcancelstate.3
+    Michael Kerrisk
+        Add paragraph breaks to "Asynchronous cancelability" subsection
+
+pthread_setcancelstate.3
+    Peng Haitao
+        ATTRIBUTES: Note functions that are thread-safe
+            The functions pthread_setcancelstate() and
+            pthread_setcanceltype() are thread safe.
+    Michael Kerrisk
+        NOTES: Add some subheadings
+
+pthread_setschedparam.3
+    Peng Haitao
+        ATTRIBUTES: Note functions that are thread-safe
+            The functions pthread_setschedparam() and pthread_getschedparam()
+            are thread safe.
+
+pthread_setschedprio.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_setschedprio() is thread safe.
+
+pthread_sigmask.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_sigmask() is thread safe.
+
+pthread_sigqueue.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_sigqueue() is thread safe.
+
+pthread_testcancel.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_testcancel() is thread safe.
+
+pthread_yield.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function pthread_yield() is thread safe.
+
+remquo.3
+    Peng Haitao
+        ATTRIBUTES: Note functions that are thread-safe
+            The functions remquo(), remquof() and remquol() are thread safe.
+
+rtime.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function rtime() is thread safe.
+
+sched_getcpu.3
+    Peng Haitao
+        ATTRIBUTES: Note function that is thread-safe
+            The function sched_getcpu() is thread safe.
+
+stpcpy.3
+    Ingo Schwarze
+        Note some history of stpcpy()
+            Quoting Ingo:
+            I just noticed that the stpcpy(3) manual contains a speculation
+            that appears to be untrue on closer investigation:  That function
+            did not originate in MS DOS, but in Lattice C on AmigaDOS.
+
+            Here is a patch against the git master HEAD to fix that, and add
+            some more historical information.  To provide some background and
+            allow you to more easily verify the correctness of the patch, i'm
+            appending my mail to <misc@openbsd.org>, where i'm giving some
+            more details about the history and pointing to some primary
+            sources.  That mail also contains the (similar, but shorter)
+            patch i just committed to the OpenBSD manual page.
+
+strcasecmp.3
+    Michael Kerrisk  [Aurelien Jarno, Török Edwin]
+        Explain why strcasecmp()+strncasecmp() are also declared in <string.h>
+            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729436
+
+strcpy.3
+    Michael Kerrisk
+        NOTES: Add a subheading
+
+fd.4
+    Michael Kerrisk  [Sam Varshavchik]
+        Fix floppy disk device names
+            The naming convention shown in the page was ancient.
+            Now, the page is consistent with Documentation/devices.txt
+            (where it is noted that "The use of the capital letters
+            D, H and E for the 3.5" models have been deprecated, since
+            the drive type is insignificant for these devices"
+
+proc.5
+    Michael Kerrisk
+        Document /proc/timer_stats
+    Michael Kerrisk
+        (Briefly) document /proc/timer_list
+            Text taken from kernel commit
+            289f480af87e45f7a6de6ba9b4c061c2e259fe98.
+    Michael Kerrisk
+        Add /proc/sys/kernel/{sched_rt_period_us,sched_rt_runtime_us}
+            Reference sched(7) for an explanation of these two files
+
+capabilities.7
+    Michael Kerrisk
+        Mention sched_setattr(2) under CAP_SYS_NICE
+
+cpuset.7
+    Michael Kerrisk
+        SEE ALSO: add sched(7)
+
+credentials.7
+    Michael Kerrisk
+        Mention sched_getattr() as a place where credentials are checked
+
+fanotify.7
+    Heinrich Schuchardt  [Jan Kara]
+        BUGS: error events can be lost when reading from fanotify FD
+    Michael Kerrisk  [Heinrich Schuchardt]
+        Fix description of FAN_EVENT_NEXT()
+            FAN_EVENT_NEXT() does not update 'meta'; rather, it returns a
+            pointer to the next metadata structure. In addition, generally
+            rework the description to be a bit clearer and more detailed.
+    Heinrich Schuchardt
+        Document FAN_EVENT_METADATA_LEN
+
+ip.7
+    Michael Kerrisk
+        Note cases where an ephemeral port is used
+    Michael Kerrisk
+        Remove BUGS text on glibc failing to declare in_pktinfo
+    Michael Kerrisk
+        Clarify 'ip_local_port_range' and mention the term "ephemeral ports"
+    Michael Kerrisk
+        Note some more details about assignment of ephemeral ports
+    Michael Kerrisk
+        BUGS: ephemeral port range exhaustion is diagnosed inconsistently
+            Different system calls use different 'errno' values to diagnose
+            exhaustion of the ephemeral port range.
+
+sched.7
+    Michael Kerrisk
+        Document sched_rt_period_us and sched_rt_runtime_us /proc files
+            And rework and relocate the text on dealing with runaway
+            real-time processes.
+    Michael Kerrisk
+        Mention sched_setattr(2) in list of APIs that can change policies
+    Michael Kerrisk
+        sched_setattr(2) can also be used to set 'nice' value
+    Michael Kerrisk
+        Remove mention of sched_setscheduler() when talking about sched_priority
+            There are nowadays multiple ways to set sched_priority (and
+            in fact there always were, since we also had sched_setparam(2)).
+    Michael Kerrisk
+        SEE ALSO: Add Documentation/scheduler/sched-design-CFS.txt
+    Michael Kerrisk
+        Don't mention sched_setscheduler(2) in discussions of setting policies
+            In a couple of places, sched_setscheduler(2) is mentioned as the
+            way of setting policies. But now there is sched_setattr(2) as
+            well, rewrite the text in a more generic way.
+    Michael Kerrisk
+        Rework summary text describing sched_setattr(2) and sched_getattr(2)
+            Note that these APIs are a superset of sched_setscheduler(2)
+            and sched_getscheduler(2).
+    Michael Kerrisk
+        Remove crufty text relating to sched_setscheduler()
+            All of the removed text is in sched_setscheduler(2) and
+            should have been trimmed from this page.
+    Michael Kerrisk
+        SEE ALSO: Mention more files in Documentation/scheduler/ directory