mirror of https://github.com/mkerrisk/man-pages
Changes: Updates for 3.25
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
d8da429e17
commit
3883778021
416
Changes
416
Changes
|
@ -1,6 +1,6 @@
|
||||||
==================== Changes in man-pages-3.25 ====================
|
==================== Changes in man-pages-3.25 ====================
|
||||||
|
|
||||||
Released: ????-??-??, Munich
|
Released: 2010-06-20, Munich
|
||||||
|
|
||||||
|
|
||||||
Contributors
|
Contributors
|
||||||
|
@ -9,6 +9,44 @@ Contributors
|
||||||
The following people contributed notes, ideas, or patches that have
|
The following people contributed notes, ideas, or patches that have
|
||||||
been incorporated in changes in this release:
|
been incorporated in changes in this release:
|
||||||
|
|
||||||
|
Alexander E. Patrakov <patrakov@gmail.com>
|
||||||
|
Andi Kleen <andi@firstfloor.org>
|
||||||
|
Andrew Klossner <andrew@cesa.opbu.xerox.com>
|
||||||
|
André Goddard Rosa <andre.goddard@gmail.com>
|
||||||
|
Bo Borgerson <gigabo@gmail.com>
|
||||||
|
Christian Franke <nobody@nowhere.ws>
|
||||||
|
Daisuke HATAYAMA <d.hatayama@jp.fujitsu.com>
|
||||||
|
David Sommerseth <davids@redhat.com>
|
||||||
|
Denis Barbier <bouzim@gmail.com>
|
||||||
|
Eric Blake <ebb9@byu.net>
|
||||||
|
Fang Wenqi <anton.fang@gmail.com>
|
||||||
|
Francesco Cosoleto <cosoleto@gmail.com>
|
||||||
|
Gernot Tenchio <gernot@tenchio.de>
|
||||||
|
Hugh Dickins <hughd@google.com>
|
||||||
|
Ivana Hutarova Varekova <varekova@redhat.com>
|
||||||
|
Jan Blunck <jblunck@novell.com>
|
||||||
|
Jan Engelhardt <jengelh@medozas.de>
|
||||||
|
Jan Kara <jack@suse.cz>
|
||||||
|
Jeff Barry <JeffBatHome@myletters.us>
|
||||||
|
Manfred Schwarb <manfred99@gmx.ch>
|
||||||
|
Mark Hills <mark@pogo.org.uk>
|
||||||
|
Martin (Joey) Schulze <joey@infodrom.org>
|
||||||
|
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||||
|
Mihai Paraschivescu <paraschivescu_mihail@yahoo.com>
|
||||||
|
Mike Frysinger <vapier@gentoo.org>
|
||||||
|
Miklos Szeredi <miklos@szeredi.hu>
|
||||||
|
Petr Baudis <pasky@suse.cz>
|
||||||
|
Petr Gajdos <pgajdos@suse.cz>
|
||||||
|
Petr Uzel <petr.uzel@suse.cz>
|
||||||
|
Pierre Habouzit <madcoder@madism.org>
|
||||||
|
Reuben Thomas <rrt@sc3d.org>
|
||||||
|
Rob Landley <rob@landley.net>
|
||||||
|
Robert Wohlrab <robert.wohlrab@gmx.de>
|
||||||
|
Serge E. Hallyn <serge@hallyn.com>
|
||||||
|
Tolga Dalman <tdalman@project-psi.org>
|
||||||
|
Tom Swigg <swiggtc@lsbu.ac.uk>
|
||||||
|
Walter Harms <wharms@bfs.de>
|
||||||
|
Yuri Kozlov <yuray@komyakino.ru>
|
||||||
|
|
||||||
Apologies if I missed anyone!
|
Apologies if I missed anyone!
|
||||||
|
|
||||||
|
@ -16,19 +54,395 @@ Apologies if I missed anyone!
|
||||||
New and rewritten pages
|
New and rewritten pages
|
||||||
-----------------------
|
-----------------------
|
||||||
|
|
||||||
|
migrate_pages.2
|
||||||
|
Andi Kleen
|
||||||
|
New page documenting migrate_pages(2).
|
||||||
|
Andi's text based on the move_pages.2 page;
|
||||||
|
additional edits by mtk.
|
||||||
|
migrate_pages(2) was new in Linux 2.6.16.
|
||||||
|
|
||||||
|
quotactl.2
|
||||||
|
Jan Kara
|
||||||
|
Major updates
|
||||||
|
Update the page to consolidate information from the
|
||||||
|
outdated man-pages quotactl.2 page and the quotactl.2
|
||||||
|
page in the "quota-tools" pachage. The page in "quota-tools"
|
||||||
|
has now been dropped by Jan Kara, so that there is just one
|
||||||
|
canonical quotactl.2 page (in pan-pages).
|
||||||
|
Michael Kerrisk
|
||||||
|
Various other pieces added to the page by mtk.
|
||||||
|
|
||||||
|
|
||||||
Newly documented interfaces in existing pages
|
Newly documented interfaces in existing pages
|
||||||
---------------------------------------------
|
---------------------------------------------
|
||||||
|
|
||||||
|
fcntl.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Document F_SETPIPE_SZ and F_GETPIPE_SZ
|
||||||
|
These commands, new in kernel 2.6.35, set and get the capacity
|
||||||
|
of pipes.
|
||||||
|
|
||||||
|
madvise.2
|
||||||
|
Andi Kleen
|
||||||
|
Document MADV_HWPOISON
|
||||||
|
Michael Kerrisk
|
||||||
|
Added documentation of MADV_MERGEABLE and MADV_UNMERGEABLE
|
||||||
|
These flags (used for Kernel Samepage Mergeing, KSM)
|
||||||
|
are new in 2.6.32.
|
||||||
|
Andi Kleen
|
||||||
|
Document MADV_SOFT_OFFLINE
|
||||||
|
This operation was added in Linux 2.6.33.
|
||||||
|
|
||||||
|
mmap.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Document MAP_UNINITIALIZED flag
|
||||||
|
New in Linux 2.6.33.
|
||||||
|
|
||||||
|
prctl.2
|
||||||
|
Andi Kleen
|
||||||
|
Document the hwpoison prctls in 2.6.32
|
||||||
|
|
||||||
|
sched_setscheduler.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Document SCHED_RESET_ON_FORK
|
||||||
|
New in Linux 2.6.32
|
||||||
|
|
||||||
|
umount.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Document UMOUNT_NOFOLLOW
|
||||||
|
New in Linux 2.6.34.
|
||||||
|
|
||||||
|
mkstemp.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Document mkstemps() and mkostemps()
|
||||||
|
These functions are new in glibc 2.11. They allow the template
|
||||||
|
string to include a suffix after the "XXXXXX" string.
|
||||||
|
|
||||||
|
proc.5
|
||||||
|
Michael Kerrisk
|
||||||
|
Document /proc/sys/vm/memory_failure_early_kill
|
||||||
|
New in 2.6.32. Description based on the text in
|
||||||
|
Documentation/sysctl/vm.txt.
|
||||||
|
Michael Kerrisk
|
||||||
|
Document /proc/sys/vm/memory_failure_recovery
|
||||||
|
New in Linux 2.6.32. Description based on the text in
|
||||||
|
Documentation/sysctl/vm.txt.
|
||||||
|
Michael Kerrisk
|
||||||
|
Document /proc/sys/fs/pipe-max-size
|
||||||
|
|
||||||
|
socket.7
|
||||||
|
Jan Engelhardt
|
||||||
|
Document SO_DOMAIN and SO_PROTOCOL
|
||||||
|
These read-only socket options were new in Linux 2.6.32.
|
||||||
|
|
||||||
|
|
||||||
New and changed links
|
New and changed links
|
||||||
---------------------
|
---------------------
|
||||||
|
|
||||||
|
fstatvfs.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Adjust link to point to Section 3
|
||||||
|
|
||||||
|
fstatvfs.3
|
||||||
|
statvfs.2
|
||||||
|
Michael Kerrisk
|
||||||
|
New link to page relocated to Section 3
|
||||||
|
|
||||||
|
mkstemps.3
|
||||||
|
mkostemps.3
|
||||||
|
Michael Kerrisk
|
||||||
|
New links to mkstemp.3
|
||||||
|
mkstemp.3 now describes mkstemps(3) and mkostemps(3).
|
||||||
|
|
||||||
|
timer_create.2
|
||||||
|
timer_delete.2
|
||||||
|
timer_getoverrun.2
|
||||||
|
timer_settime.2
|
||||||
|
getline.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Add 'L' to constants in feature test macro specifications
|
||||||
|
Be consistent with POSIX, which uses constants such as 200809L.
|
||||||
|
|
||||||
|
|
||||||
Global changes
|
Global changes
|
||||||
--------------
|
--------------
|
||||||
|
|
||||||
|
open.2
|
||||||
|
sync_file_range.2
|
||||||
|
umount.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Global fix: s/filesystem/file system/
|
||||||
|
|
||||||
|
|
||||||
Changes to individual pages
|
Changes to individual pages
|
||||||
---------------------------
|
---------------------------
|
||||||
|
|
||||||
|
fcntl.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Note that glibc 2.11 papers over the kernel F_GETOWN bug
|
||||||
|
Since version 2.11, glibc works around the kernel limitation for
|
||||||
|
process groups IDs < 4096 by implementing F_GETOWN via F_GETOWN_EX.
|
||||||
|
|
||||||
|
futex.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Various fixes in SEE ALSO
|
||||||
|
|
||||||
|
getpriority.2
|
||||||
|
nice.2
|
||||||
|
Francesco Cosoleto
|
||||||
|
Move renice from section 8 to section 1
|
||||||
|
|
||||||
|
getrusage.2
|
||||||
|
Mark Hills
|
||||||
|
Add ru_maxrss
|
||||||
|
See kernel commit 1f10206.
|
||||||
|
Mark Hills
|
||||||
|
Description of maintained fields
|
||||||
|
These descriptions are taken from NetBSD 5.0's getrusage(2).
|
||||||
|
Michael Kerrisk
|
||||||
|
Enhanced description of various fields
|
||||||
|
|
||||||
|
mlock.2
|
||||||
|
Michael Kerrisk
|
||||||
|
/proc/PID/status VmLck shows how much memory a process has locked
|
||||||
|
After a note from Tom Swigg, it seems sensible mention VmLck here.
|
||||||
|
|
||||||
|
mount.2
|
||||||
|
Petr Uzel
|
||||||
|
Fix incorrect path
|
||||||
|
|
||||||
|
move_pages.2
|
||||||
|
Andi Kleen
|
||||||
|
Clarify includes/libraries
|
||||||
|
|
||||||
|
mremap.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Clarify existence of fifth argument.
|
||||||
|
|
||||||
|
msgctl.2
|
||||||
|
semctl.2
|
||||||
|
shmctl.2
|
||||||
|
Francesco Cosoleto
|
||||||
|
Move ipcs from section 8 to section 1
|
||||||
|
|
||||||
|
open.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove ambiguity in text on NFS and O_EXCL.
|
||||||
|
|
||||||
|
poll.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Fix discussion of ppoll() timeout argument
|
||||||
|
1. Rename ppoll)(_ argument to "timeout_ts" to distinguish it
|
||||||
|
from the poll() argument in the text.
|
||||||
|
2. More accurately describe the poll() call that is equivalent
|
||||||
|
to ppoll().
|
||||||
|
|
||||||
|
posix_fadvise.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Add sync_file_range(2) under SEE ALSO
|
||||||
|
|
||||||
|
prctl.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Correct PR_SET_KEEPCAPS description
|
||||||
|
The "keep capabilities" flag only affects the treatment of
|
||||||
|
permitted capabilities, not effective capabilities.
|
||||||
|
Also: other improvements to make the PR_SET_KEEPCAPS text clearer.
|
||||||
|
|
||||||
|
select_tut.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Fix bug in example program
|
||||||
|
|
||||||
|
sigaction.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Add TRAP_BRANCH and TRAP_HWBKPT to si_code values for SIGTRAP
|
||||||
|
Michael Kerrisk
|
||||||
|
Rearrange text describing fields set by sigqueue(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
Add details for signals sent by POSIX message queue notifications
|
||||||
|
Michael Kerrisk
|
||||||
|
Improve description of various siginfo_t fields
|
||||||
|
Michael Kerrisk
|
||||||
|
Add some details for SIGTRAP and si_trapno
|
||||||
|
Andi Kleen
|
||||||
|
Document hwpoison signal extensions
|
||||||
|
|
||||||
|
statfs.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Bring statfs struct type declarations closer to glibc reality
|
||||||
|
Fang Wenqi
|
||||||
|
Add definition EXT4_SUPER_MAGIC = 0xEF53
|
||||||
|
Michael Kerrisk
|
||||||
|
Document f_frsize field.
|
||||||
|
|
||||||
|
statvfs.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Move this page to section 3 (since it's a library call)
|
||||||
|
|
||||||
|
swapon.2
|
||||||
|
Ivana Hutarova Varekova
|
||||||
|
Note effect of iCONFIG_MEMORY_FAILURE on MAX_SWAPFILES
|
||||||
|
From 2.6.32, MAX_SWAPFILES is decreased by 1 if the kernel is
|
||||||
|
built with CONFIG_MEMORY_FAILURE.
|
||||||
|
|
||||||
|
syscalls.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Bring system call list up to date with Linux 2.6.33
|
||||||
|
Michael Kerrisk
|
||||||
|
Fix kernel version number for utimes()
|
||||||
|
|
||||||
|
cproj.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Note fix for C99 conformance in glibc 2.12.
|
||||||
|
|
||||||
|
crypt.3
|
||||||
|
Petr Baudis
|
||||||
|
Correct note on key portion significance
|
||||||
|
As Marcel Moreaux notes:
|
||||||
|
|
||||||
|
The Linux manpage for crypt()[1] contains the following
|
||||||
|
statement as the last sentence of the NOTES section:
|
||||||
|
|
||||||
|
In the SHA implementation the entire key is significant
|
||||||
|
(instead of only the first 8 bytes in MD5).
|
||||||
|
|
||||||
|
It should probably say "DES" where it says "MD5" (and maybe
|
||||||
|
"MD5/SHA" where it says "SHA"), because in MD5 password hashing,
|
||||||
|
the entire key is significant, not just the first 8 bytes.
|
||||||
|
|
||||||
|
This patch fixes the wording.
|
||||||
|
|
||||||
|
fmemopen.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Bug fix in example program
|
||||||
|
|
||||||
|
ftw.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Note that if 'fn' changes CWD, the results are undefined
|
||||||
|
Michael Kerrisk
|
||||||
|
Clarify description of fpath argument
|
||||||
|
As reported by Pierre Habouzit, 'fpath' is not relative
|
||||||
|
to 'dirpath'. It is either relative to the calling process's
|
||||||
|
current working directory (if 'dirpath' was relative), or it
|
||||||
|
is absolute (if 'dirpath' was absolute).
|
||||||
|
|
||||||
|
getaddrinfo.3
|
||||||
|
Christian Franke
|
||||||
|
Fix a field name mixup: s/ai_family/ai_flags/
|
||||||
|
|
||||||
|
getline.3
|
||||||
|
Robert Wohlrab
|
||||||
|
Remove unneeded check before free()
|
||||||
|
The manpage of getline shows an example with an extra NULL pointer
|
||||||
|
check before it calls free. This is unneeded according to free(3):
|
||||||
|
|
||||||
|
If ptr is NULL, no operation is performed.
|
||||||
|
|
||||||
|
This patch removes the "if" check.
|
||||||
|
|
||||||
|
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572508
|
||||||
|
|
||||||
|
log.3
|
||||||
|
log10.3
|
||||||
|
log2.3
|
||||||
|
Jan Engelhardt
|
||||||
|
Add cross-references to other-base logarithmic functions
|
||||||
|
|
||||||
|
opendir.3
|
||||||
|
Petr Baudis
|
||||||
|
Specify feature test macro requirements for fdopendir(3)
|
||||||
|
Currently, there is no note on the fact that fdopendir() is
|
||||||
|
POSIX.2008-only.
|
||||||
|
|
||||||
|
openpty.3
|
||||||
|
Eric Blake
|
||||||
|
Use const as appropriate
|
||||||
|
Michael Kerrisk
|
||||||
|
Note glibc version that added "const" to function arguments
|
||||||
|
Michael Kerrisk
|
||||||
|
Explicitly note that these functions are not in POSIX
|
||||||
|
|
||||||
|
resolver.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Fix declaration of dn_comp() in SYNOPSIS
|
||||||
|
Remove the second 'exp_dn' from the calling signature.
|
||||||
|
|
||||||
|
termios.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Change NOFLSH text to speak of characters, not signals
|
||||||
|
|
||||||
|
core.5
|
||||||
|
Michael Kerrisk
|
||||||
|
Update description of coredump_filter
|
||||||
|
Kernel 2.6.24 added MMF_DUMP_ELF_HEADERS.
|
||||||
|
Kernel 2.6.28 added MMF_DUMP_HUGETLB_PRIVATE and
|
||||||
|
MMF_DUMP_HUGETLB_SHARED.
|
||||||
|
|
||||||
|
elf.5
|
||||||
|
Daisuke HATAYAMA
|
||||||
|
Document PN_XNUM extension
|
||||||
|
In linux-2.6.34-rc1, an ELF core extension was added; user-land
|
||||||
|
tools manipulating ELF core dump such as gdb and binutils has
|
||||||
|
already been modified before; so elf.5 needs to be modified
|
||||||
|
accordingly.
|
||||||
|
|
||||||
|
You can follow information on the ELF extension via the LKML post:
|
||||||
|
http://lkml.org/lkml/2010/1/3/103
|
||||||
|
Date Mon, 04 Jan 2010 10:06:07 +0900 (JST)
|
||||||
|
Subject ... elf coredump: Add extended numbering support
|
||||||
|
|
||||||
|
This Linux-specific extension was added in kernel 2.6.34.
|
||||||
|
|
||||||
|
Reviewed-by: Petr Baudis <pasky@suse.cz>
|
||||||
|
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove EI_BRAND
|
||||||
|
As reported by Yuri Kozlov and confirmed by Mike Frysinger,
|
||||||
|
EI_BRAND is not in GABI
|
||||||
|
(http://www.sco.com/developers/gabi/latest/ch4.eheader.html)
|
||||||
|
It looks to be a BSDism
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove words under '.note': "described below"
|
||||||
|
The existing text is broken, because there is
|
||||||
|
no '"Note Section" format' describe below. Simplest
|
||||||
|
solution is to remove the words "described below".
|
||||||
|
|
||||||
|
filesystems.5
|
||||||
|
Jeff Barry
|
||||||
|
Add discussion of ntfs and ext4
|
||||||
|
|
||||||
|
proc.5
|
||||||
|
Michael Kerrisk
|
||||||
|
Simplify description of /proc/sys and /proc/sys/fs
|
||||||
|
In the description of these directories, there's no need
|
||||||
|
to list all the files and subdirectories that they contain;
|
||||||
|
that information is provided by the entries that follow.
|
||||||
|
|
||||||
|
services.5
|
||||||
|
Yuri Kozlov
|
||||||
|
Remove crufty reference to nonexistent BUGS section
|
||||||
|
|
||||||
|
capabilities.7
|
||||||
|
Michael Kerrisk
|
||||||
|
Document CAP_SYS_RESOURCE and F_SETPIPE_SZ
|
||||||
|
With CAP_SYS_RESOURCE, a process can increase pipe capacity above
|
||||||
|
/proc/sys/ps/pipe-max-size.
|
||||||
|
Michael Kerrisk
|
||||||
|
Add get_robust_list() info under CAP_SYS_PTRACE
|
||||||
|
Michael Kerrisk
|
||||||
|
Add MADV_HWPOISON under CAP_SYS_ADMIN
|
||||||
|
|
||||||
|
signal.7
|
||||||
|
Michael Kerrisk
|
||||||
|
Make a clearer statement about nonportable aspect of signal(2)
|
||||||
|
Make a clearer statement that signal(2) is less portable for
|
||||||
|
establishing a signal handler.
|
||||||
|
|
||||||
|
socket.7
|
||||||
|
Michael Kerrisk
|
||||||
|
Use consistent language to describe read-only socket options
|
||||||
|
|
||||||
|
udp.7
|
||||||
|
Michael Kerrisk
|
||||||
|
Add FIONREAD warning.
|
||||||
|
Warn that FIONREAD can't can't distinguish case of a zero-length
|
||||||
|
datagram from the case where no datagrams are available.
|
||||||
|
|
Loading…
Reference in New Issue