man-pages-4.00 is released

[Michael Kerrisk (man-pages)]

Gidday,

The Linux man-pages maintainer proudly announces:

    man-pages-4.00 - man pages for Linux

My 3.xx minor release numbers were getting rather high, and it seems an 
apposite moment to also bump to a 4.xx release.

This is a somewhat larger than usual release, in part because I've been
dredging bugzilla reports and old mails that fell off the table. Three
new man pages have been added and around 90 pages have seen updates, 
based on input and contributions from somewhat more than 50 people.

Tarball download:
    http://www.kernel.org/doc/man-pages/download.html
Git repository:
    https://git.kernel.org/cgit/docs/man-pages/man-pages.git/
Online changelog:
    http://man7.org/linux/man-pages/changelog.html#release_4.00

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2015/05/man-pages-400-is-released.html

A selection of changes in this release that may be interesting
for readers of this list is shown below.

Cheers,

Michael

==================== Changes in man-pages-4.00 ====================

New and rewritten pages
-----------------------

get_phys_pages.3
    William Woodruff
        Document get_phys_pages() and get_avphys_pages()

loop.4
    Urs Thuermann, Michael Kerrisk
        New page documenting the loop device

xattr.7
    Andreas Gruenbacher
        Import attr(5) man page from the 'attr' project
            After discussions with Andreas Gruenbacher, it makes sense to
            move this page into man-pages, since it mostly relates to
            kernel details. Since this is an overview page,
            we'll move it to Section 7.
    Michael Kerrisk
         Rename page
            "xattr" is a more meaningful name than "attr" (it resonates
            with the names of the system calls), so as long as we are
            moving the page to a new section, we'll change the name as well,
            and retain an acl(5) link so that old references remain valid.
    Michael Kerrisk
         Updates and fixes to many details in the page

Newly documented interfaces in existing pages
---------------------------------------------

mmap.2
    Michael Kerrisk  [Andi Kleen]
        Document MAP_HUGE_2MB, MAP_HUGE_1GB, and MAP_HUGE_SHIFT

shmget.2
    Michael Kerrisk  [Andi Kleen]
        Document SHM_HUGE_2MB, SHM_HUGE_1GB, and SHM_HUGE_SHIFT

tty_ioctl.4
    FrÃdÃric Maria  [Stephane Fillod, Andreas Heiduk]
        Document TIOCMIWAIT and TIOCGICOUNT
    Michael Kerrisk
        Document TIOCGEXCL
        Document TIOGCPKT
        Document TIOCSPTLCK
        Document TIOCGPTLCK


Changes to individual pages
---------------------------

mmap.2
    Michael Kerrisk
        Remove text that implies that munmap() syncs MAP_SHARED mapping to file
            The existing text in this page:

                   MAP_SHARED Share  this  mapping.   Updates to the mapping
                              are visible to other processes that  map  this
                              file,  and are carried through to the underlyâ
                              ing  file.   The  file  may  not  actually  be
                              updated until msync(2) or munmap() is called.

            implies that munmap() will sync the mapping to the underlying
            file. POSIX doesn't require this, and some light reading of the
            code and some light testing (fsync() after munmap() of a large
            file) also indicates that Linux doesn't do this.

open.2
    Michael Kerrisk  [Andreas Gruenbacher]
        open() honors the S_ISVTX, S_ISUID, and S_ISGID bits in 'mode'

stat.2
    Jann Horn
        Add note about stat() being racy

umask.2
open.2
mknod.2
mkdir.2
    Andreas Gruenbacher
        Explain what default ACLs do
            Explain the effect that default ACLs have (instead of the umask)
            in umask.2.  Mention that default ACLs can have an affect in
            open.2, mknod.2, and mkdir.2.

proc.5
    Michael Kerrisk  [Cameron Norman, Vasiliy Kulikov]
        Document /proc mount options
            Document the 'hidepid' and 'gid' mount options that were added in
            Linux 3.3.  See https://bugzilla.kernel.org/show_bug.cgi?id=90641
            Based on text by Vasiliy Kulikov in
            Documentation/filesystems/proc.txt.

bootparam.7
    Michael Kerrisk
        Summary of multiple changes: remove cruft from this page.
            Much of the detail on hardware specifics in this page dates
            from the 20th century. (The last major update to this page was in
            man-pages-1.14!) It's hugely out of date now (many of these
            devices disappeared from the kernel years ago.) So, I've taken
            a large scythe to the page to remove anything that looks
            seriously dated. In the process, the page has shrunk to less
            than 50% of its previous size.

fanotify.7
    Michael Kerrisk  [Heinrich Schuchardt]
        Since Linux 3.19, fallocate(2) generates FAN_MODIFY events

inotify.7
    Michael Kerrisk  [Heinrich Schuchardt]
        Since Linux 3.19, fallocate(2) generates IN_MODIFY events

ip.7
    Michael Kerrisk  [Jiri Pirko, Magnus REFTEL]
        Clarify details of the IP_MULTICAST_IF socket option
    Michael Kerrisk  [Advait Dixi]
        Remove dubious text that says that SO_PRIORITY set IP TOS
            See https://bugzilla.kernel.org/show_bug.cgi?id=35852

packet.7
    Graham Shaw
        Add sll_protocol to list of required fields for outbound packets

signal.7
    Michael Kerrisk  [Steinar H. Gunderson]
        Clarify that I/O operations on disks are not interrupted by signals
            See https://bugzilla.kernel.org/show_bug.cgi?id=97721

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/