Skip to contentSkip to conversation

man-pages-4.00 is released

DISCUSSION Michael Kerrisk (man-pages) 1 participant 1 message May 7, 2015

lore
Share & tools
lore
#0 lore raw

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

Signature · 3 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/