Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753267AbbEGLNq (ORCPT ); Thu, 7 May 2015 07:13:46 -0400 Received: from mail-wi0-f177.google.com ([209.85.212.177]:37063 "EHLO mail-wi0-f177.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753042AbbEGLNo (ORCPT ); Thu, 7 May 2015 07:13:44 -0400 Message-ID: <554B48E0.4000806@gmail.com> Date: Thu, 07 May 2015 13:13:36 +0200 From: "Michael Kerrisk (man-pages)" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.5.0 MIME-Version: 1.0 To: lkml CC: mtk.manpages@gmail.com Subject: man-pages-4.00 is released Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 6081 Lines: 170 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@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/