Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753978AbbGWSug (ORCPT ); Thu, 23 Jul 2015 14:50:36 -0400 Received: from mail-wi0-f170.google.com ([209.85.212.170]:37851 "EHLO mail-wi0-f170.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753346AbbGWSud (ORCPT ); Thu, 23 Jul 2015 14:50:33 -0400 Message-ID: <55B13774.60501@gmail.com> Date: Thu, 23 Jul 2015 20:50:28 +0200 From: "Michael Kerrisk (man-pages)" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0 MIME-Version: 1.0 To: linux-kernel@vger.kernel.org CC: mtk.manpages@gmail.com Subject: man-pages-4.01 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: 5070 Lines: 159 Gidday, The Linux man-pages maintainer proudly announces: man-pages-4.01 - man pages for Linux This release includes two new man pages and makes changes in over 100 other pages, based on input and contributions from nearly 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.01 A short summary of the release is blogged at: http://linux-man-pages.blogspot.com/2015/07/man-pages-401-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.01 ==================== New and rewritten pages ----------------------- bpf.2 Alexei Starovoitov, Michael Kerrisk [Daniel Borkmann] New page documenting bpf(2) __ppc_get_timebase.3 Tulio Magno Quites Machado Filho New page documenting __ppc_get_timebase() and __ppc_get_timebase_freq() Glibc 2.16 was released with a new function for the Power architecture that can read its Time Base Register. Glibc 2.17 adds a function to read the frequency at which the Time Base Register of Power processors is updated. queue.3 Michael Kerrisk [David Leppik, Doug Klima] Reimport from latest FreeBSD page Long ago, Doug Klima noted that many macros were not documented in the queue(3) page. Fix by reimporting from latest [1] FreeBSD man page. Newly documented interfaces in existing pages --------------------------------------------- rename.2 Michael Kerrisk [Miklos Szeredi] Document RENAME_WHITEOUT Heavily based on text by Miklos Szeredi. Changes to individual pages --------------------------- chroot.2 Jann Horn chroot() is not intended for security; document attack It is unfortunate that this discourages this use of chroot(2) without pointing out alternative solutions - for example, OpenSSH and vsftpd both still rely on chroot(2) for security. Bind mounts should theoretically be usable as a replacement, but currently, they have a similar problem (CVE-2015-2925) that hasn't been fixed in ~6 months, so I'd rather not add it to the manpage as a solution before a fix lands. fallocate.2 Namjae Jeon [Michael Kerrisk] Document FALLOC_FL_INSERT_RANGE mmap.2 Michal Hocko [Eric B Munson] Clarify MAP_POPULATE David Rientjes has noticed that MAP_POPULATE wording might promise much more than the kernel actually provides and intends to provide. The primary usage of the flag is to pre-fault the range. There is no guarantee that no major faults will happen later on. The pages might have been reclaimed by the time the process tries to access them. Michal Hocko [Eric B Munson] Clarify MAP_LOCKED semantics mprotect.2 Michael Kerrisk Note ENOMEM error that can occur when we reach limit on maximum VMAs perf_event_open.2 Vince Weaver [Joerg Roedel] Exclude_host/exclude_guest clarification Vince Weaver Document PERF_SAMPLE_REGS_INTR pread.2 read.2 readv.2 sendfile.2 write.2 Michael Kerrisk Clarify that Linux limits transfers to a maximum of 0x7ffff000 bytes See https://bugs.debian.org/629994 and https://bugs.debian.org/630029. recv.2 send.2 Michael Kerrisk Explain some subtleties of MSG_DONTWAIT versus O_NONBLOCK sched_setaffinity.2 Michael Kerrisk Add an example program Michael Kerrisk [Florian Weimer] Explain how to deal with 1024-CPU limitation of glibc's cpu_set_t type proc.5 Michael Kerrisk [Kees Cook] Document /proc/sys/kernel/sysctl_writes_strict Based on text in Documentation/sysctl/kernel.txt. capabilities.7 Michael Kerrisk CAP_SYS_ADMIN allows calling bpf(2) packet.7 文剑 [Cortland Setlow] Fix description of binding a packet socket to an interface pty.7 NeilBrown [Peter Hurley] Clarify asynchronous nature of PTY I/O A PTY is not like a pipe - there may be delayed between data being written at one end and it being available at the other. vdso.7 Nathan Lynch [Mike Frysinger] Update for ARM The 32-bit ARM architecture in Linux has gained a vDSO as of the 4.1 release. -- 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/