LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

Changes: Updates for 3.25 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2010-06-20 05:43:23 +02:00
parent d8da429e17
commit 3883778021
1 changed files with 415 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

416
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.25 ====================
Released: ????-??-??, Munich
Released: 2010-06-20, Munich
Contributors
@ -9,6 +9,44 @@ Contributors
The following people contributed notes, ideas, or patches that have
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!
@ -16,19 +54,395 @@ Apologies if I missed anyone!
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
---------------------------------------------
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
---------------------
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
--------------
open.2
sync_file_range.2
umount.2
Michael Kerrisk
Global fix: s/filesystem/file system/
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.