From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756491AbdECUi7 (ORCPT ); Wed, 3 May 2017 16:38:59 -0400 Received: from mail-wm0-f66.google.com ([74.125.82.66]:34201 "EHLO mail-wm0-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754030AbdECUif (ORCPT ); Wed, 3 May 2017 16:38:35 -0400 Cc: mtk.manpages@gmail.com To: lkml From: "Michael Kerrisk (man-pages)" Subject: man-pages-4.11 is released Message-ID: <5ee1c362-c413-1354-4058-15efbf8b7bee@gmail.com> Date: Wed, 3 May 2017 22:38:32 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.4.0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The Linux man-pages maintainer proudly announces: man-pages-4.11 - man pages for Linux This release resulted from patches, bug reports, reviews, and comments from over 30 contributors. The release sees a large number of changes: over 300 commits changing more than 100 pages. The changes include the addition of 5 pages, significant rewriting of 1 page, and enhancements to many other pages. 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.11 A short summary of the release is blogged at: http://linux-man-pages.blogspot.com/2017/05/man-pages-411-is-released.html The current version of the pages is browsable at: http://man7.org/linux/man-pages/ A selection of changes in this release that may be of interest to readers on LKML is shown below. Cheers, Michael ==================== Changes in man-pages-4.11 ==================== Released: 2017-05-03, Baden, Switzerland New and rewritten pages ----------------------- ioctl_userfaultfd.2 Michael Kerrisk, Mike Rapoport New page describing ioctl(2) operations for userfaultfd statx.2 David Howells, Michael Kerrisk [Andreas Dilger] New page describing statx(2) system call added in Linux 4.11 userfaultfd.2 Mike Rapoport, Michael Kerrisk [Andrea Arcangeli] New page describing userfaultfd(2) system call. pthread_atfork.3 Michael Kerrisk New page describing pthread_atfork(3) slabinfo.5 Michael Kerrisk Rewrite to try to bring the content close to current reality There's still gaps to fill in, but the existing page was in any case hugely out of date. inode.7 Michael Kerrisk New page with information about inodes David Howells provided a statx(2) page that duplicated much of the information from stat(2). Avoid such duplication by moving the common information in stat(2) and statx(2) to a new page. Newly documented interfaces in existing pages --------------------------------------------- ioctl_ns.2 Michael Kerrisk Document the NS_GET_NSTYPE operation added in Linux 4.11 Michael Kerrisk Document the NS_GET_OWNER_UID operation added in Linux 4.11 proc.5 Michael Kerrisk Document /proc/sys/kernel/sched_child_runs_first namespaces.7 Michael Kerrisk Document the /proc/sys/user/* files added in Linux 4.9 socket.7 Francois Saint-Jacques, Michael Kerrisk Document SO_INCOMING_CPU Changes to individual pages --------------------------- clone.2 unshare.2 Michael Kerrisk Exceeding one of the limits in /proc/sys/user/* can cause ENOSPC Michael Kerrisk CLONE_NEWPID yields ENOSPC if nesting limit of PID namespaces is reached Michael Kerrisk Exceeding the maximum nested user namespace limit now gives ENOSPC Formerly, if the limit of 32 nested user namespaces was exceeded, the error EUSERS resulted. Starting with Linux 4.9, the error is ENOSPC. epoll_ctl.2 Michael Kerrisk Defer to poll(2) for an explanation of EPOLLIN Michael Kerrisk [Nicolas Biscos] EPOLLERR is also set on write end of a pipe when the read end is closed Michael Kerrisk [Nicolas Biscos] Give the reader a clue that the 'events' field can be zero 'events' specified as zero still allows EPOLLHUP and EPOLLERR to be reported. _exit.2 Michael Kerrisk On exit, child processes may be inherited by a "subreaper" It is no longer necessarily true that orphaned processes are inherited by PID 1. Michael Kerrisk Only the least significant byte of exit status is passed to the parent fcntl.2 Michael Kerrisk Mention memfd_create() in the discussion of file seals Give the reader a clue about what kinds of objects can be employed with file seals. Michael Kerrisk File seals are not generally applicable to tmpfs(5) files As far as I can see, file seals can be applied only to memfd_create(2) file descriptors. This was checked by experiment and by reading mm/shmem.c::shmem_get_inode((), where one finds the following line that applies to all new shmem files: info->seals = F_SEAL_SEAL; Only in the code of the memfd_create() system call is this setting reversed (in mm/shmem.c::memfd_create): if (flags & MFD_ALLOW_SEALING) info->seals &= ~F_SEAL_SEAL; poll.2 Michael Kerrisk Expand discussion of POLLPRI Michael Kerrisk [Nicolas Biscos] POLLERR is also set on write end of a pipe when the read end is closed prctl.2 Mike Frysinger PR_SET_MM: Document new PR_SET_MM_MAP{,_SIZE} helpers Michael Kerrisk Explain rationale for use of subreaper processes Michael Kerrisk Note semantics of child_subreaper setting on fork() and exec() Michael Kerrisk Improve description of PR_SET_CHILD_SUBREAPER select.2 Michael Kerrisk [Matthew Wilcox, Carlos O'Donell] Linux select() is buggy wrt POSIX in its check for EBADF errors Michael Kerrisk Show correspondence between select() and poll() readiness notifications Michael Kerrisk Give a hint that sets must be reinitialized if using select() in a loop signalfd.2 Michael Kerrisk SIGKILL and SIGSTOP are silently ignored in 'mask' sigwaitinfo.2 Michael Kerrisk sigwaitinfo() can't be used to accept synchronous signals wait.2 Michael Kerrisk Orphaned children may be adopted by a "subreaper", rather by than PD 1 grantpt.3 Michael Kerrisk Tell a more nuanced story about what grantpt() does or does not do shm_open.3 Michael Kerrisk Clarify that POSIX shared memory uses tmpfs(5) pid_namespaces.7 Michael Kerrisk The maximum nesting depth for PID namespaces is 32 ld.so.8 Michael Kerrisk Expand description of /etc/ld.so.preload -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/