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

1 files changed, 450 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index a07b6f69e..20cfcfc4a 100644
--- a/Changes.old
+++ b/Changes.old
@@ -19443,3 +19443,453 @@ signal.7
         Fix discussion of SIGUNUSED
             Clarify that this signal really is synonymous with SIGSYS.
             See http://bugzilla.kernel.org/show_bug.cgi?id=14449
+
+
+==================== Changes in man-pages-3.25 ====================
+
+Released: 2010-06-20, Munich
+
+
+Contributors
+------------
+
+The following people contributed notes, ideas, or patches that have
+been incorporated in changes in this release:
+
+Alexander E. Patrakov <patrakov@gmail.com>
+Andi Kleen <andi@firstfloor.org>
+Andrew Klossner <andrew@cesa.opbu.xerox.com>
+André Goddard Rosa <andre.goddard@gmail.com>
+Bo Borgerson <gigabo@gmail.com>
+Christian Franke <nobody@nowhere.ws>
+Daisuke HATAYAMA <d.hatayama@jp.fujitsu.com>
+David Sommerseth <davids@redhat.com>
+Denis Barbier <bouzim@gmail.com>
+Eric Blake <ebb9@byu.net>
+Fang Wenqi <anton.fang@gmail.com>
+Francesco Cosoleto <cosoleto@gmail.com>
+Gernot Tenchio <gernot@tenchio.de>
+Hugh Dickins <hughd@google.com>
+Ivana Hutarova Varekova <varekova@redhat.com>
+Jan Blunck <jblunck@novell.com>
+Jan Engelhardt <jengelh@medozas.de>
+Jan Kara <jack@suse.cz>
+Jeff Barry <JeffBatHome@myletters.us>
+Manfred Schwarb <manfred99@gmx.ch>
+Mark Hills <mark@pogo.org.uk>
+Martin (Joey) Schulze <joey@infodrom.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mihai Paraschivescu <paraschivescu_mihail@yahoo.com>
+Mike Frysinger <vapier@gentoo.org>
+Miklos Szeredi <miklos@szeredi.hu>
+Petr Baudis <pasky@suse.cz>
+Petr Gajdos <pgajdos@suse.cz>
+Petr Uzel <petr.uzel@suse.cz>
+Pierre Habouzit <madcoder@madism.org>
+Reuben Thomas <rrt@sc3d.org>
+Rob Landley <rob@landley.net>
+Robert Wohlrab <robert.wohlrab@gmx.de>
+Serge E. Hallyn <serge@hallyn.com>
+Tolga Dalman <tdalman@project-psi.org>
+Tom Swigg <swiggtc@lsbu.ac.uk>
+Walter Harms <wharms@bfs.de>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+migrate_pages.2
+    Andi Kleen
+        New page documenting migrate_pages(2).
+            Andi's text based on the move_pages.2 page;
+            additional edits by mtk.
+            migrate_pages(2) was new in Linux 2.6.16.
+
+quotactl.2
+    Jan Kara
+        Major updates
+            Update the page to consolidate information from the
+            outdated man-pages quotactl.2 page and the quotactl.2
+            page in the "quota-tools" pachage. The page in "quota-tools"
+            has now been dropped by Jan Kara, so that there is just one
+            canonical quotactl.2 page (in pan-pages).
+    Michael Kerrisk
+            Various other pieces added to the page by mtk.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fcntl.2
+    Michael Kerrisk
+        Document F_SETPIPE_SZ and F_GETPIPE_SZ
+            These commands, new in kernel 2.6.35, set and get the capacity
+            of pipes.
+
+madvise.2
+    Andi Kleen
+        Document MADV_HWPOISON
+    Michael Kerrisk
+        Added documentation of MADV_MERGEABLE and MADV_UNMERGEABLE
+            These flags (used for Kernel Samepage Mergeing, KSM)
+            are new in 2.6.32.
+    Andi Kleen
+        Document MADV_SOFT_OFFLINE
+            This operation was added in Linux 2.6.33.
+
+mmap.2
+    Michael Kerrisk
+        Document MAP_UNINITIALIZED flag
+            New in Linux 2.6.33.
+
+prctl.2
+    Andi Kleen
+        Document the hwpoison prctls in 2.6.32
+
+sched_setscheduler.2
+    Michael Kerrisk
+        Document SCHED_RESET_ON_FORK
+            New in Linux 2.6.32
+
+umount.2
+    Michael Kerrisk
+        Document UMOUNT_NOFOLLOW
+            New in Linux 2.6.34.
+
+mkstemp.3
+    Michael Kerrisk
+        Document mkstemps() and mkostemps()
+            These functions are new in glibc 2.11. They allow the template
+            string to include a suffix after the "XXXXXX" string.
+
+proc.5
+    Michael Kerrisk
+        Document /proc/sys/vm/memory_failure_early_kill
+            New in 2.6.32. Description based on the text in
+            Documentation/sysctl/vm.txt.
+    Michael Kerrisk
+        Document /proc/sys/vm/memory_failure_recovery
+            New in Linux 2.6.32.  Description based on the text in
+            Documentation/sysctl/vm.txt.
+    Michael Kerrisk
+        Document /proc/sys/fs/pipe-max-size
+
+socket.7
+    Jan Engelhardt
+        Document SO_DOMAIN and SO_PROTOCOL
+            These read-only socket options were new in Linux 2.6.32.
+
+
+New and changed links
+---------------------
+
+fstatvfs.2
+    Michael Kerrisk
+        Adjust link to point to Section 3
+
+fstatvfs.3
+statvfs.2
+    Michael Kerrisk
+        New link to page relocated to Section 3
+
+mkstemps.3
+mkostemps.3
+    Michael Kerrisk
+        New links to mkstemp.3
+            mkstemp.3 now describes mkstemps(3) and mkostemps(3).
+
+timer_create.2
+timer_delete.2
+timer_getoverrun.2
+timer_settime.2
+getline.3
+    Michael Kerrisk
+        Add 'L' to constants in feature test macro specifications
+            Be consistent with POSIX, which uses constants such as 200809L.
+
+
+Global changes
+--------------
+
+open.2
+sync_file_range.2
+umount.2
+    Michael Kerrisk
+        Global fix: s/filesystem/file system/
+
+
+Changes to individual pages
+---------------------------
+
+fcntl.2
+    Michael Kerrisk
+        Note that glibc 2.11 papers over the kernel F_GETOWN bug
+            Since version 2.11, glibc works around the kernel limitation for
+            process groups IDs < 4096 by implementing F_GETOWN via F_GETOWN_EX.
+
+futex.2
+    Michael Kerrisk
+        Various fixes in SEE ALSO
+
+getpriority.2
+nice.2
+    Francesco Cosoleto
+        Move renice from section 8 to section 1
+
+getrusage.2
+    Mark Hills
+        Add ru_maxrss
+            See kernel commit 1f10206.
+    Mark Hills
+        Description of maintained fields
+            These descriptions are taken from NetBSD 5.0's getrusage(2).
+    Michael Kerrisk
+        Enhanced description of various fields
+
+mlock.2
+    Michael Kerrisk
+        /proc/PID/status VmLck shows how much memory a process has locked
+            After a note from Tom Swigg, it seems sensible mention VmLck here.
+
+mount.2
+    Petr Uzel
+        Fix incorrect path
+
+move_pages.2
+    Andi Kleen
+        Clarify includes/libraries
+
+mremap.2
+    Michael Kerrisk
+        Clarify existence of fifth argument.
+
+msgctl.2
+semctl.2
+shmctl.2
+    Francesco Cosoleto
+        Move ipcs from section 8 to section 1
+
+open.2
+    Michael Kerrisk
+        Remove ambiguity in text on NFS and O_EXCL.
+
+poll.2
+    Michael Kerrisk
+        Fix discussion of ppoll() timeout argument
+            1. Rename ppoll)(_ argument to "timeout_ts" to distinguish it
+               from the poll() argument in the text.
+            2. More accurately describe the poll() call that is equivalent
+               to ppoll().
+
+posix_fadvise.2
+    Michael Kerrisk
+        Add sync_file_range(2) under SEE ALSO
+
+prctl.2
+    Michael Kerrisk
+        Correct PR_SET_KEEPCAPS description
+            The "keep capabilities" flag only affects the treatment of
+            permitted capabilities, not effective capabilities.
+            Also: other improvements to make the PR_SET_KEEPCAPS text clearer.
+
+select_tut.2
+    Michael Kerrisk
+        Fix bug in example program
+
+sigaction.2
+    Michael Kerrisk
+        Add TRAP_BRANCH and TRAP_HWBKPT to si_code values for SIGTRAP
+    Michael Kerrisk
+        Rearrange text describing fields set by sigqueue(2)
+    Michael Kerrisk
+        Add details for signals sent by POSIX message queue notifications
+    Michael Kerrisk
+        Improve description of various siginfo_t fields
+    Michael Kerrisk
+        Add some details for SIGTRAP and si_trapno
+    Andi Kleen
+        Document hwpoison signal extensions
+
+statfs.2
+    Michael Kerrisk
+        Bring statfs struct type declarations closer to glibc reality
+    Fang Wenqi
+        Add definition EXT4_SUPER_MAGIC = 0xEF53
+    Michael Kerrisk
+        Document f_frsize field.
+
+statvfs.2
+    Michael Kerrisk
+        Move this page to section 3 (since it's a library call)
+
+swapon.2
+    Ivana Hutarova Varekova
+        Note effect of iCONFIG_MEMORY_FAILURE on MAX_SWAPFILES
+            From 2.6.32, MAX_SWAPFILES is decreased by 1 if the kernel is
+            built with CONFIG_MEMORY_FAILURE.
+
+syscalls.2
+    Michael Kerrisk
+        Bring system call list up to date with Linux 2.6.33
+    Michael Kerrisk
+        Fix kernel version number for utimes()
+
+cproj.3
+    Michael Kerrisk
+        Note fix for C99 conformance in glibc 2.12.
+
+crypt.3
+    Petr Baudis
+        Correct note on key portion significance
+            As Marcel Moreaux notes:
+
+                The Linux manpage for crypt()[1] contains the following
+                statement as the last sentence of the NOTES section:
+
+                    In the SHA implementation the entire key is significant
+                    (instead of only the first 8 bytes in MD5).
+
+                It should probably say "DES" where it says "MD5" (and maybe
+                "MD5/SHA" where it says "SHA"), because in MD5 password hashing,
+                the entire key is significant, not just the first 8 bytes.
+
+            This patch fixes the wording.
+
+fmemopen.3
+    Michael Kerrisk
+        Bug fix in example program
+
+ftw.3
+    Michael Kerrisk
+        Note that if 'fn' changes CWD, the results are undefined
+    Michael Kerrisk
+        Clarify description of fpath argument
+            As reported by Pierre Habouzit, 'fpath' is not relative
+            to 'dirpath'. It is either relative to the calling process's
+            current working directory (if 'dirpath' was relative), or it
+            is absolute (if 'dirpath' was absolute).
+
+getaddrinfo.3
+    Christian Franke
+        Fix a field name mixup: s/ai_family/ai_flags/
+
+getline.3
+    Robert Wohlrab
+        Remove unneeded check before free()
+            The manpage of getline shows an example with an extra NULL pointer
+            check before it calls free. This is unneeded according to free(3):
+
+                 If ptr is NULL, no operation is performed.
+
+            This patch removes the "if" check.
+
+            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572508
+
+log.3
+log10.3
+log2.3
+    Jan Engelhardt
+        Add cross-references to other-base logarithmic functions
+
+opendir.3
+    Petr Baudis
+        Specify feature test macro requirements for fdopendir(3)
+            Currently, there is no note on the fact that fdopendir() is
+            POSIX.2008-only.
+
+openpty.3
+    Eric Blake
+        Use const as appropriate
+    Michael Kerrisk
+        Note glibc version that added "const" to function arguments
+    Michael Kerrisk
+        Explicitly note that these functions are not in POSIX
+
+resolver.3
+    Michael Kerrisk
+        Fix declaration of dn_comp() in SYNOPSIS
+            Remove the second 'exp_dn' from the calling signature.
+
+termios.3
+    Michael Kerrisk
+        Change NOFLSH text to speak of characters, not signals
+
+core.5
+    Michael Kerrisk
+        Update description of coredump_filter
+            Kernel 2.6.24 added MMF_DUMP_ELF_HEADERS.
+            Kernel 2.6.28 added MMF_DUMP_HUGETLB_PRIVATE and
+            MMF_DUMP_HUGETLB_SHARED.
+
+elf.5
+    Daisuke HATAYAMA
+        Document PN_XNUM extension
+            In linux-2.6.34-rc1, an ELF core extension was added; user-land
+            tools manipulating ELF core dump such as gdb and binutils has
+            already been modified before; so elf.5 needs to be modified
+            accordingly.
+
+            You can follow information on the ELF extension via the LKML post:
+            http://lkml.org/lkml/2010/1/3/103
+            Date        Mon, 04 Jan 2010 10:06:07 +0900 (JST)
+            Subject     ... elf coredump: Add extended numbering support
+
+            This Linux-specific extension was added in kernel 2.6.34.
+
+            Reviewed-by: Petr Baudis <pasky@suse.cz>
+
+    Michael Kerrisk
+        Remove EI_BRAND
+            As reported by Yuri Kozlov  and confirmed by Mike Frysinger,
+            EI_BRAND is not in GABI
+            (http://www.sco.com/developers/gabi/latest/ch4.eheader.html)
+            It looks to be a BSDism
+    Michael Kerrisk
+        Remove words under '.note': "described below"
+            The existing text is broken, because there is
+            no '"Note Section" format' describe below. Simplest
+            solution is to remove the words "described below".
+
+filesystems.5
+    Jeff Barry
+        Add discussion of ntfs and ext4
+
+proc.5
+    Michael Kerrisk
+        Simplify description of /proc/sys and /proc/sys/fs
+            In the description of these directories, there's no need
+            to list all the files and subdirectories that they contain;
+            that information is provided by the entries that follow.
+
+services.5
+    Yuri Kozlov
+        Remove crufty reference to nonexistent BUGS section
+
+capabilities.7
+    Michael Kerrisk
+        Document CAP_SYS_RESOURCE and F_SETPIPE_SZ
+            With CAP_SYS_RESOURCE, a process can increase pipe capacity above
+            /proc/sys/ps/pipe-max-size.
+    Michael Kerrisk
+        Add get_robust_list() info under CAP_SYS_PTRACE
+    Michael Kerrisk
+        Add MADV_HWPOISON under CAP_SYS_ADMIN
+
+signal.7
+    Michael Kerrisk
+        Make a clearer statement about nonportable aspect of signal(2)
+            Make a clearer statement that signal(2) is less portable for
+            establishing a signal handler.
+
+socket.7
+    Michael Kerrisk
+        Use consistent language to describe read-only socket options
+
+udp.7
+    Michael Kerrisk
+        Add FIONREAD warning.
+            Warn that FIONREAD can't can't distinguish case of a zero-length
+            datagram from the case where no datagrams are available.