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

1 files changed, 455 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index 00412a8c3..357b1c563 100644
--- a/Changes.old
+++ b/Changes.old
@@ -34168,3 +34168,458 @@ unix.7
             * Note the "buggy" behavior for pathname sockets when
               the supplied pathname is 108 bytes (after a report by
               Tetsuo Handa).
+
+
+==================== Changes in man-pages-3.76 ====================
+
+Released: 2014-12-31, 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:
+
+Adam Jiang <jiang.adam@gmail.com>
+Andrea Balboni <andrea.balboni@unimore.it>
+Andreas Schwab <schwab@suse.de>
+Bernhard Walle <bernhard@bwalle.de>
+Carlos O'Donell <carlos@redhat.com>
+David Wragg <david@wragg.org>
+Florian Westphal <fw@strlen.de>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Huxiaoxiang <huxiaoxiang@huawei.com>
+Jan Chaloupka <jchaloup@redhat.com>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Josh Triplett <josh@joshtriplett.org>
+Kamezawa Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
+Laurent Georget <laurent.georget@supelec.fr>
+Manuel López-Ibáñez <lopezibanez@gmail.com>
+Marko Myllynen <myllynen@redhat.com>
+Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
+Mel Gorman <mgorman@suse.de>
+Michael Gehring <mg@ebfe.org>
+Michael Haardt <michael@moria.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Richard Weinberger <richard@nod.at>
+Rich Felker <dalias@libc.org>
+Scott Harvey <scott.harvey@stonybrook.edu>
+Siddhesh Poyarekar <siddhesh.poyarekar@gmail.com>
+Simon Newton <nomis52@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Sven Hoexter <sven@stormbind.net>
+Tobias Werth <werth@cs.fau.de>
+Weijie Yang <weijie.yang.kh@gmail.com>
+Will Newton <will.newton@linaro.org>
+Yuri Kozlov <yuray@komyakino.ru>
+刘湃 <liupai_work@163.com>
+尹杰 <writalnaie@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+adjtimex.2
+    Laurent Georget
+        Add fields in struct timex description
+            This patch updates the man page with the new fields added in
+            struct timex since last edition of the man page.
+    Laurent Georget [Michael Kerrisk]
+        Document ADJ_TAI
+    Michael Kerrisk
+        Improve description of ADJ_OFFSET_SINGLESHOT
+    Michael Kerrisk
+        Add brief documentation of ADJ_MICRO and ADJ_NANO
+    Michael Kerrisk
+        Reformat return value list
+            And remove numeric values, since they're not needed
+    Michael Kerrisk
+        Other 'modes' bits are ignored on ADJ_OFFSET_*
+            Other bits in 'modes' are ignored if modes contains
+            ADJ_OFFSET_SINGLESHOT or ADJ_OFFSET_SS_READ.
+    Michael Kerrisk
+        Add nanosecond details
+            Fixes https://bugzilla.kernel.org/show_bug.cgi?id=61171.
+    Michael Kerrisk
+        Document ADJ_OFFSET_SS_READ
+    Michael Kerrisk
+        Reformat 'times' flags as list
+            And remove numeric values, since they're not needed.
+    Michael Kerrisk
+        Note effect of ADJ_NANO for ADJ_SETOFFSET
+    Michael Kerrisk
+        Add comment noting that timex structure contains padding bytes
+    Michael Kerrisk
+        Add more details to description of 'tai' field
+    Michael Kerrisk
+        Note meaning of "PLL" abbreviation
+    Michael Kerrisk
+        Clarify which 'timex' field is used by each 'modes' bit
+    Michael Kerrisk
+        Document timex 'status' bits
+    Michael Kerrisk
+        Clarify treatment of other 'modes' bits for ADJ_OFFSET_*
+    Michael Kerrisk
+        Update RFC number: RFC 5905 obsoletes RFC 1305
+    Michael Kerrisk
+        Briefly document ADJ_SETOFFSET
+    Michael Kerrisk
+        Note PPS (pulse per second) fields in timex structure
+
+sigreturn.2
+    Michael Kerrisk
+        Add (a lot) more detail on the signal trampoline
+            And rewrite much of the page.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+proc.5
+    Bernhard Walle
+        Document /proc/thread-self
+            /proc/thread-self has been introduced in Linux 3.17 with
+            commit 0097875bd41528922fb3bb5f348c53f17e00e2fd.
+    Sven Hoexter [Michael Kerrisk, Kamezawa Hiroyuki]
+        Document "VmSwap" field of /proc/[pid]/status
+    Florian Westphal
+        Document /proc/net/netfilter/nfnetlink_queue
+
+
+Changes to individual pages
+---------------------------
+
+localedef.1
+    Marko Myllynen
+        Mention default path for compiled files
+
+clock_nanosleep.2
+    Michael Kerrisk
+        Note that 'clock_id' can also be a CPU clock ID
+
+epoll_ctl.2
+    Michael Kerrisk
+        Regular files and directories can't be monitored with epoll_ctl()
+
+ioctl.2
+    Heinrich Schuchardt
+        Rename 'd' argument to 'fd' in text
+            In most other manpages file descriptors are called 'fd'.
+            This patches renames attribute 'd' to 'fd'.
+
+madvise.2
+    Michael Kerrisk
+        VERSIONS: Support for madvise() is now configurable
+            Support for this system call now depends on the
+            CONFIG_ADVISE_SYSCALLS configuration option.
+
+open.2
+    Michael Kerrisk
+        Enhance rationale discussion for openat() and friends
+
+posix_fadvise.2
+    Mel Gorman
+        Document the behavior of partial page discard requests
+            It is not obvious from the interface that "partial page discard"
+            requests are ignored. It should be spelled out.
+    Michael Kerrisk  [Weijie Yang]
+        ERRORS: Since 2.6.16, the kernel correctly deals with the ESPIPE case
+    Michael Kerrisk
+        Support for fadvise64() is now configurable
+            Support for this system call now depends on the
+            CONFIG_ADVISE_SYSCALLS configuration option.
+
+prctl.2
+    Andreas Schwab
+        Correct description of null-termination in PR_GET_NAME and PR_SET_NAME
+            The size of the process name has always been at most 16 byte
+            _including_ the null terminator.  This also means that the
+            name returned by PR_GET_NAME is always null-terminated.
+    Michael Kerrisk
+        PR_SET_NAME silently truncates strings that exceed 16 bytes
+
+restart_syscall.2
+    Michael Kerrisk
+        Add some text explaining why restart_syscall() exists
+
+sched_setaffinity.2
+    Michael Kerrisk
+        NOTES: Add paragraph on how to discover set of CPUs available on system
+    Michael Kerrisk
+        SEE ALSO: add nproc(1) and lscpu(1)
+
+select.2
+    Michael Kerrisk
+        SEE ALSO: add restart_syscall(2)
+
+semop.2
+    Michael Kerrisk
+        Add note that interrupted semtimedop() returns 'timeout' unchanged
+    Michael Kerrisk
+        Remove information about semtimedop() EAGAIN that is repeated elsewhere
+    Michael Kerrisk
+        Add subsection head for semtimedop()
+
+setsid.2
+    Michael Kerrisk
+        Rewrite some pieces and add some details
+            Among other changes, add an explanation of why setsid() can't
+            be called from a process group leader
+
+sgetmask.2
+    Michael Kerrisk
+        Since 3.16, support for these system call is configurable
+            Support for these calls is now dependent on the setting of the
+            CONFIG_SGETMASK_SYSCALL option.
+
+sigaction.2
+    Michael Kerrisk
+        Document SA_RESTORER
+    Michael Kerrisk
+        Add some detail on the sa_restorer field
+    Michael Kerrisk
+        SEE ALSO: add sigreturn(2)
+
+splice.2
+    Michael Kerrisk
+        Reformat description of 'fd_in' and 'off_in' to improve readability
+
+syscall.2
+    Michael Kerrisk
+        SEE ALSO: add errno(3)
+
+syscalls.2
+    Michael Kerrisk
+        SEE ALSO: add errno(3)
+    Michael Kerrisk
+        3.19 adds execveat()
+    Michael Kerrisk
+        Add bpf(2) to list
+
+tee.2
+    Michael Kerrisk
+        Add shell session demonstrating use of the example program
+
+tkill.2
+    Michael Kerrisk  [Rich Felker]
+        Remove bogus text saying tgid==-1 makes tgkill() equivalent to tkill()
+
+abort.3
+    Michael Kerrisk
+        Note that SIGABRT is raised as though raise(3) is called
+            Also note that abort is POSIX.1-2008 compliant.
+
+cmsg.3
+    David Wragg
+        Ensure buf is suitably aligned in sending example
+            Inspection of the definition of CMSG_FIRSTHDR (both in glibc and
+            the suggested definition in RFC3542) shows that it yields the
+            msg_control field.  So when sending, the pointer placed in
+            msg_control should be suitably aligned as a struct cmsghdr.
+            In the sending example, buf was declared as a bare char array,
+            and so is not necessarily suitably aligned.
+
+            The solution here involves placing buf inside a union, and is
+            based on the sockets/scm_rights_send.c sample from The Linux
+            Programming Interface "dist" source code collection.
+
+exp10.3
+    Michael Kerrisk
+        Before glibc 2.19, exp() did not give ERANGE error on underflow
+            http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787
+
+ftw.3
+    Michael Kerrisk
+        FTW_CHDIR has no effect on the 'fpath' argument passed to fn()
+
+getopt.3
+    Michael Kerrisk  [Jonny Grant]
+        Ensure that 'nsecs' is used
+
+ilogb.3
+    Michael Kerrisk  [Will Newton]
+        Since glibc 2.16, ilogb() does correctly diagnose domain errors
+
+memcmp.3
+    Michael Haardt
+        Document return value for n==0 case
+    Michael Haardt
+        Warn against use of memcmp() for comparing security-critical data
+
+mq_open.3
+    Michael Kerrisk
+        Document the O_CLOEXEC flag
+    Michael Kerrisk
+        Place 'flags' constants in alphabetical order
+
+pow.3
+    Manuel López-Ibáñez
+        Add note on performance characteristics of pow()
+
+pthread_setschedparam.3
+    Simon Newton
+        Fix logic error in example program
+            The example program will crash if -A is used, since 'attr'
+            is uninitialized.
+
+                $ ./a.out  -A
+                *** Error in `./a.out': free(): invalid pointer: 0xb779c3c4 ***
+                Aborted (core dumped)
+    刘湃
+        Small fixes to example program
+
+sigvec.3
+    Michael Kerrisk
+        Starting with version 2.21, glibc no longer exports sigvec()
+
+sysconf.3
+    Josh Triplett
+        Document _SC_NGROUPS_MAX
+            Already documented in getgroups(2), but not in sysconf(3).
+
+termios.3
+    Michael Kerrisk
+        SEE ALSO: add tset(1)
+
+tgamma.3
+    Michael Kerrisk
+        Since glibc 2.18, errno is correctly set to EDOM when (x == -infinity))
+
+wordexp.3
+    Carlos O'Donell
+        Make it clear that WRDE_NOCMD prevents command substitution
+            The use of WRDE_NOCMD prevents command substitution. If the flag
+            WRDE_NOCMD is set then no command substitution shall occur and
+            the error WRDE_CMDSUB will be returned if such substitution is
+            requested when processing the words.
+
+            The manual page as-is makes it seem like the command substitution
+            occurs, and an error is returned *after* the substitution.
+            This patch clarifies that.
+
+locale.5
+    Marko Myllynen
+        Describe the formats of values
+            locale(5) describes what a locale should define but doesn't
+            spell out how (in what format). The patch attempts to address
+            this, it also has few trivial additional enhancements.
+
+            * Reference to locale(7) for category descriptions.
+            * Clarify first_workday in NOTES a bit.
+            * Add upstream BZ reference for two missing LC_ADDRESS fields.
+    Marko Myllynen
+        Fix miscoded character
+
+resolv.conf.5
+    Jan Chaloupka
+        Add missing no-tld-query option
+            Based on commit [1], the no-tld-query option exists for
+            resolv.conf configuration file.  Description of this option
+            is provided in [2]. This patch just copies this option
+            into resolv.conf.5 man page. Plus changes 'a' member
+            into 'an' before 'unqualified name as if it ...'
+            on the third line of [2]. Based on [3], this option
+            was added in glibc 2.14 as solving [4] bug.
+
+            [1] https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
+            [2] http://www.daemon-systems.org/man/resolv.conf.5.html man page.
+            [3] https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;h=952f32af17e7fb49c4c1a305de673a13075bfaf5;hb=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
+            [4] https://sourceware.org/bugzilla/show_bug.cgi?id=12734
+
+credentials.7
+    Josh Triplett
+        Cross-reference getgroups(2)
+            Since credentials.7 discusses supplementary GIDs, it should
+            reference getgroups(2).
+
+fanotify.7
+    Heinrich Schuchardt
+        Allow relative paths in example
+            The current example code requires passing an absolute
+            path to the mount to be watched.
+
+            By passing AT_FDCWD to fanotify_mark it can use both
+            absolute and relative paths.
+    Heinrich Schuchardt
+        fallocate(2) creates no events
+            fallocate(2) should create FAN_MODIFY events but does not.
+    Heinrich Schuchardt [Michael Kerrisk]
+        fanotify notifies only events generated on the same mount
+            Unfortunately, fanotify does not inform listeners for all paths
+            under which a touched filesystem object is visible, but only the
+            listener using the same path as the process touching the
+            filesystem object.
+    Heinrich Schuchardt
+        Update BUGS to note bugs still not fixed in 3.17
+            I bumped the Linux version number in the BUGS section to 3.17.
+
+inotify.7
+    Heinrich Schuchardt
+        fallocate(2) does not trigger inotify events
+            Calling fallocate(2) does not result in inotify events.
+
+locale.7
+    Marko Myllynen
+        Improve LOCPATH description
+            LOCPATH is ignored by privileged programs.
+
+            Add locale archive references.
+
+            Add FILES section.
+
+man-pages.7
+    Michael Kerrisk  [Laurent Georget]
+        Clarify that SEE ALSO entries may refer to pages from other projects
+
+signal.7
+    Michael Kerrisk
+        Mention other "slow devices"
+            Reads from eventfd(2), signalfd(2), timerfd(2), inotify(7),
+            and fanotify(7) file descriptors are also slow operations
+            that are restartable.
+    Michael Kerrisk
+        Fix SO_RECVTIMEO/ SO_SENDTIMEO confusion in text
+    Michael Kerrisk
+        Since Linux 3.8, reads on inotify(7) file descriptors are restartable
+    Michael Kerrisk
+        inotify(7) reads no longer show the odd EINTR error after SIGCONT
+            Since kernel 3.7, reads from inotify(7) file descriptors no longer
+            show the (Linux oddity) behavior of failing with EINTR when the
+            process resumes after a stop signal + SIGCONT.
+    Michael Kerrisk
+        SEE ALSO: add sigreturn(2)
+
+unix.7
+    Michael Kerrisk  [Scott Harvey]
+        Fix buglet in code snippet in BUGS section
+
+ld.so.8
+    Carlos O'Donell
+        Add --inhibit-cache option
+            The dynamic loader has 6 options, only 5 are documented.
+            This patch documents the sixth option i.e. `--inhibit-cache`.
+    Jonathan Wakely  [Siddhesh Poyarekar]
+        Correct documentation of $ORIGIN
+            As noted by Siddhesh:
+
+                The ld.so man page says:
+
+                    $ORIGIN (or equivalently ${ORIGIN})
+                        This expands to the directory containing the
+                        application executable.  Thus, an application located
+                        in somedir/app could be compiled with
+
+                This is incorrect since it expands to the directory containing
+                the DSO and not the application executable.  This seems like
+                deliberate behaviour in dl-object.c, so it needs to be fixed in
+                the man page.
+
+            See http://stackoverflow.com/questions/26280738/what-is-the-equivalent-of-loader-path-for-rpath-specification-on-linux/26281226#26281226
+