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

1 files changed, 281 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index 7bf97cb56..d5a98f598 100644
--- a/Changes.old
+++ b/Changes.old
@@ -23188,3 +23188,284 @@ ld.so.8
             Wording by Aurelien Jarno from Debian glibc's r4701 (2011-06-04).
 
             Addresses http://bugs.debian.org/622385
+
+
+==================== Changes in man-pages-3.40 ====================
+
+Released: 2012-04-27, 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:
+
+Alexey Toptygin <alexeyt@freeshell.org>
+Bernhard Walle <bernhard@bwalle.de>
+Brian F. G. Bidulock <bidulock@openss7.org>
+Brian M. Carlson <sandals@crustytoothpaste.net>
+Christopher Yeoh <cyeoh@au1.ibm.com>
+Daniel J Blueman <daniel@quora.org>
+Eric Blake <eblake@redhat.com>
+Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
+James Hunt <james.hunt@ubuntu.com>
+John Sullivan <jsrhbz@kanargh.force9.co.uk>
+Jon Grant <jg@jguk.org>
+lepton <ytht.net@gmail.com>
+Marcel Holtmann <marcel@holtmann.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Petr Baudis <pasky@ucw.cz>
+Simon Paillard <spaillard@debian.org>
+Stefan Puiu <stefan.puiu@gmail.com>
+Ulrich Drepper <drepper@gmail.com>
+Vadim Mikhailov <vadim.mikhailov@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+process_vm_readv.2
+    Mike Frysinger, Christopher Yeoh, Michael Kerrisk
+        New page for process_vm_readv(2) and process_vm_writev(2)
+
+mcheck.3
+    Michael Kerrisk
+        New man page for mcheck(3) and related functions
+            Also describes mcheck_check_all(3), mcheck_pedantic(3),
+            and mprobe(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+rcmd.3
+    Michael Kerrisk
+        Document "_af" variants of these functions
+            Document rcmd_af(), rresvport_af(), iruserok_af(), ruserok_af().
+            Also some restructuring and other clarifications.
+
+rexec.3
+    Michael Kerrisk
+        Document rexec_af()
+
+
+New and changed links
+---------------------
+
+iruserok_af.3
+rcmd_af.3
+rresvport_af.3
+ruserok_af.3
+    Michael Kerrisk
+        New links to rcmd.3
+
+rexec_af.3
+    Michael Kerrisk
+        New link to rexec.3
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+    Michael Kerrisk
+        Clarify difference between CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW
+            Note interactions of these two clocks with discontinuous
+            adjustments to the system time and NTP/adjtime(2).
+
+fallocate.2
+    Michael Kerrisk  [John Sullivan]
+        Fix description of ENOSYS and EOPNOTSUP errors
+            As reported in https://bugzilla.redhat.com/show_bug.cgi?id=680214
+
+fchmodat.2
+    Michael Kerrisk  [Mike Frysinger]
+        Improve discussion of difference between wrapper and underlying syscall
+
+gettimeofday.2
+    Michael Kerrisk
+        gettimeofday() is affected by discontinuous jumps in the system time
+            Advise reader to use clock_gettime(2), if they need a
+            monotonically increasing time source.
+    Michael Kerrisk
+        SEE ALSO: Add clock_gettime(2)
+
+prctl.2
+    Michael Kerrisk
+        Add PR_TASK_PERF_EVENTS_DISABLE and PR_TASK_PERF_EVENTS_ENABLE
+            Add some basic documentation of these operations, with a pointer to
+            tools/perf/design.txt for more information.
+    Michael Kerrisk  [Marcel Holtmann]
+        Amend details of PR_SET_PDEATHSIG
+
+ptrace.2
+    Michael Kerrisk  [Mike Frysinger]
+        Note SPARC deviation with respect to get/set regs
+            SPARC reverses the use of 'addr' and 'data' for
+            PTRACE_GETREGS, PTRACE_GETFPREGS, PTRACE_SETREGS,
+            and PTRACE_SETFPREGS.
+
+send.2
+    Stefan Puiu
+        Document EACCES error case for UDP
+
+sigaction.2
+    Michael Kerrisk
+        Remove mention of raise(3) for SI_USER
+            For a long time now, glibc's raise(3) didn't yield SI_USER
+            for the signal receiver, so remove mention of raise(3)
+            here. The user can deduce the details, if needed, by looking
+            at the recently updated raise(3) page.
+
+aio_cancel.3
+    Michael Kerrisk  [Jon Grant]
+        Rewrite RETURN VALUE section to be clearer
+
+aio_init.3
+    Michael Kerrisk  [Jon Grant]
+        Remove extraneous "POSIX" from NAME section
+
+btree.3
+dbopen.3
+hash.3
+mpool.3
+recno.3
+    Michael Kerrisk  [Brian M. Carlson]
+        Note that glibc no longer provides these interfaces
+            glibc stopped providing these interfaces with v2.2.
+            Nowadays, the user that finds these pages probably wants
+            the libdb API, so note this in the page.
+
+            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=337581
+
+fopen.3
+    Michael Kerrisk
+        BUGS: Note limitation on number of flag characters parsed in 'mode'
+    Michael Kerrisk
+        Note that 'c' and 'e' flags are ignored for fdopen()
+            Determined from reading libio/iofdopen.c.
+    Michael Kerrisk
+        Document ",ccs=string" feature of 'mode' for fopen()/freopen()
+
+getgrnam.3
+    Michael Kerrisk  [Ulrich Drepper]
+        Fix discussion of _SC_GETGR_R_SIZE_MAX
+            The value is not meant to be a maximum (as was specified in
+            SUSv3) but an initial guess at the required size
+            (as specified in SUSv4).
+
+getpwnam.3
+    Michael Kerrisk  [Ulrich Drepper]
+        Fix discussion of _SC_GETPW_R_SIZE_MAX
+            The value is not meant to be a maximum (as was specified in
+            SUSv3) but an initial guess at the required size
+            (as specified in SUSv4).
+
+malloc.3
+mallopt.3
+mtrace.3
+    Michael Kerrisk
+        SEE ALSO: add mcheck(3)
+
+memchr.3
+    Michael Kerrisk
+        Clarify description, omitting mention of "strings" and "characters"
+            The existing text slipped into talking about characters and
+            strings, which could mislead readers into thing that, for
+            example, searches for the byte '\0' are treated specially.
+            Therefore, rewrite in terms of "bytes" and "memory areas".
+
+            At the same time, make a few source file clean-ups.
+
+mkstemp.3
+    Michael Kerrisk
+        Add "mkstemps" and "mkostemps" to NAME line
+
+posix_openpt.3
+    Michael Kerrisk  [Vadim Mikhailov]
+        Add some details on use of the slave pathname
+            An explicit pointer to ptsname(3) is useful, as is a note
+            of the fact that the slave device pathname exists only as
+            long as the master device is held open.
+
+raise.3
+    Michael Kerrisk
+        Add some notes on underlying system call that is used
+
+rcmd.3
+    Michael Kerrisk
+        Add some details of the rresvport() 'port' argument
+
+resolver.3
+    Petr Baudis
+        Note that many options are documented in resolv.conf(5)
+
+scandir.3
+    Michael Kerrisk  [Daniel J Blueman]
+        Improve EXAMPLE source code: s/0/NULL/ in scandir() call
+
+strchr.3
+    James Hunt
+        Explain behavior when searching for '\0'
+
+strerror.3
+    Eric Blake  [Stefan Puiu]
+        Improve strerror_r() description
+            POSIX requires that perror() not modify the static storage
+            returned by strerror().  POSIX 2008 and C99 both require that
+            strerror() never return NULL (a strerror() that always
+            returns "" for all inputs is valid for C99, but not for POSIX).
+
+            http://sourceware.org/bugzilla/show_bug.cgi?id=12204
+            documents glibc's change to come into compliance with POSIX
+            regarding strerror_r() return value.  The GNU strerror_r() use
+            of 'buf' was confusing - I ended up writing a test program that
+            proves that 'buf' is unused for valid 'errnum', but contains
+            truncated "unknown message" for out-of-range 'errnum'.
+
+            See also http://austingroupbugs.net/view.php?id=382
+    Bernhard Walle
+        Correct description of error return for XSI strerror_r()
+    Michael Kerrisk [Eric Blake]
+        Note how to use 'errno' to detect errors when calling strerror()
+    Michael Kerrisk  [Jon Grant]
+        Add an example of the kind of string returned by strerror()
+
+resolv.conf.5
+    Petr Baudis
+        Document "single-request" option
+
+inotify.7
+    Michael Kerrisk
+        Note buffer size that guarantees being able to read at least one event
+    James Hunt
+        Correct description of size of inotify_event structure
+
+iso_8859-1.7
+    Eugen Dedu
+        Add "-" for SOFT HYPHEN
+            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=156154
+
+netdevice.7
+    Brian F. G. Bidulock
+        Document some SIOC configuration ioctls
+            This patch adds common but missing SIOC configuration ioctls to
+            the netdevice.7 manual pages that are not documented anywhere
+            else. SIOCSIFPFLAGS and SIOCGIFPFLAGS are linux-specific. Flag
+            values come from Linux 2.6.25 kernel headers for sockios. The
+            others are standard BSD ioctls that have always been implemented
+            by Linux and were verified from inspecting netdevice.c kernel
+            code.
+
+socket.7
+    Michael Kerrisk  [Alexey Toptygin]
+        Correct description of SO_BROADCAST
+
+tcp.7
+    lepton
+        Correct description for TCP_MAXSEG on modern kernel