Changes: Updates for 3.33 release

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2011-09-16 04:56:20 +02:00
parent f81c6cc693
commit 5fb27aeb05
1 changed files with 339 additions and 6 deletions

345
Changes
View File

@ -6,29 +6,362 @@ Released: ????-??-??, Munich
Contributors
------------
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
The following people contributed patches/fixes or (noted in brackets
in the changelog below) reports, notes and ideas that have been
incorporated in changes in this release:
Akira Fujita <a-fujita@rs.jp.nec.com>
Alexander Schuch <Alex.Schuch@gmx.de>
Andries Brouwer <Andries.Brouwer@cwi.nl>
Brian M. Carlson <sandals@crustytoothpaste.net>
Dan Jacobson <jidanni@jidanni.org>
Folkert van Heusden <folkert.mobiel@gmail.com>
Graham Gower <graham.gower@gmail.com>
Hendrik Jan Thomassen <hjt@atcomputing.nl>
Jan Engelhardt <jengelh@medozas.de>
Joey Adams <joeyadams3.14159@gmail.com>
Johannes Laire <johannes@laire.fi>
Jon Grant <jg@jguk.org>
Josh Triplett <josh@joshtriplett.org>
Konstantin Ritt <ritt.ks@gmail.com>
Luis Javier Merino <ninjalj@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Mikel Ward <mikel@mikelward.com>
Nick Black <dankamongmen@gmail.com>
Paul Evans <leonerd@leonerd.org.uk>
Petr Pisar <ppisar@redhat.com>
Przemyslaw Pawelczyk <przemyslaw@pawelczyk.it>
Regid Ichira <regid23@yahoo.com>
Reuben Thomas <rrt@sc3d.org>
Richard B. Kreckel <kreckel@ginac.de>
Ryan Mullen <rmmullen@gmail.com>
Sebastian Geiger <sbastig@gmx.net>
Sebastian Unger <sebunger@gmx.net>
Seonghun Lim <wariua@gmail.com>
Serge E. Hallyn <serge.hallyn@canonical.com>
Simon Cross <hodgestar@gmail.com>
Simon Paillard <spaillard@debian.org>
Stan Sieler <sieler@me.com>
Timmy Lee <scuttimmy@gmail.com>
Tolga Dalman <tolga.dalman@googlemail.com>
Tomislav Jonjic <jonjic@cs.unibo.it>
Yuri Kozlov <yuray@komyakino.ru>
Wei Luosheng <weiluosheng001@gmail.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
Newly documented interfaces in existing pages
---------------------------------------------
sync.2
Michael Kerrisk
Added new syncfs() system call
syncfs() was added in Linux 2.6.39.
New and changed links
---------------------
syncfs.2
Michael Kerrisk
New link for sync(2).
Global changes
--------------
Various pages
Simon Paillard
Global fix: properly escape minus sign
Changes to individual pages
---------------------------
clone.2
Michael Kerrisk
Note that CLONE_STOPPED was removed in 2.6.38
execve.2
Michael Kerrisk [Sebastian Geiger]
Note that the first argv[] value should contain name of executable
fcntl.2
Michael Kerrisk [Reuben Thomas]
Note that F_GETFL also retrieves file access mode
getrlimit.2
Michael Kerrisk [Ryan Mullen]
Remove mention of kernel versions in discussion RLIMIT_CPU
Michael Kerrisk [Seonghun Lim]
Fix example program and add _FILE_OFFSET_BITS requirement
mlock.2
Michael Kerrisk [Brian M. Carlson]
Clarify EINVAL error
See http://bugs.debian.org/cgi-bin/bugreport.cgi?625747
Michael Kerrisk [Seonghun Lim]
Simplify and correct text for EPERM error
mprotect.2
Seonghun Lim
fix off-by-one error in a memory range
Seonghun Lim
Fix small bug in example program
The description of the example program says that it makes the
third page "read-only". Thus use PROT_READ instead of PROT_NONE.
open.2
Folkert van Heusden
Remove text describing O_CLOEXEC as Linux-specific
O_CLOEXEC is specified in POSIX.1-2008, as noted
elsewhere in the page.
readlink.2
Michael Kerrisk [Dan Jacobson]
SEE ALSO: Add readlink(1)
sendfile.2
Akira Fujita
Since 2.6.33, 'out_fd' can refer to any file type
Linux kernel commit cc56f7de7f00d188c7c4da1e9861581853b9e92f
meant sendfile(2) can work with any output file.
Michael Kerrisk
Shift text on falling back to read()/write() to NOTES
Michael Kerrisk [Tolga Dalman]
Remove mention of kernel version for 'in_fd' argument
Tolga Dalman
Add an explicit reference to splice(2)
Unlike sendfile(), splice() can transfer data
between a pair of sockets.
sigaction.2
Michael Kerrisk [Tolga Dalman]
Add a little info about ucontext_t
stat.2
Michael Kerrisk [Jon Grant]
Small rewording of ENAMETOOLONG error
sync.2
Michael Kerrisk
Some rewrites to description of sync()
syscalls.2
Michael Kerrisk
Added fanotify_init() and fanotify_mark() to syscall list
Michael Kerrisk
Added new 2.6.39 system calls
Michael Kerrisk
Updated for Linux 3.0 system calls
Michael Kerrisk
Update kernel version at head of syscall list
Michael Kerrisk
Update to mention 3.x kernel series
syslog.2
Michael Kerrisk [Serge E. Hallyn]
Update for kernel 2.6.37 changes
Document /proc/sys/kernel/dmesg_restrict.
Document CAP_SYSLOG.
time.2
Michael Kerrisk [Alexander Schuch]
NOTES: Fix description of "Seconds since the Epoch"
timerfd_create.2
Michael Kerrisk [Josh Triplett]
Note behavior when timerdfd_settime() old_value is NULL
See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513
Tomislav Jonjic
Fix small error in description of timerfd_settime()
truncate.2
Seonghun Lim
Remove redundant EINTR description
unlink.2
Hendrik Jan Thomassen
Improve EBUSY description
cacos.3
cacosh.3
catan.3
catanh.3
Michael Kerrisk [Richard B. Kreckel, Andries Brouwer]
Fix formula describing function
The man pages for cacos(), cacosh(), catan(), catanh()
contain incorrect formulae describing the functions.
cacos.3
Michael Kerrisk
Add example program
cacosh.3
Michael Kerrisk
Add example program
cacosh.3
casinh.3
catan.3
catanh.3
Michael Kerrisk
SEE ALSO: Add reference to inverse function
catan.3
Michael Kerrisk
Add example program
catanh.3
Michael Kerrisk
Add example program
ccos.3
ccosh.3
csin.3
csinh.3
ctan.3
ctanh.3
Michael Kerrisk
SEE ALSO Add reference to "arc" inverse function
cexp.3
Michael Kerrisk
SEE ALSO: add cexp(3)
clog.3
Michael Kerrisk
SEE ALSO: Add reference to clog(2)
crypt.3
Michael Kerrisk [Jan Engelhardt]
Fix header file and feature test macro requirements for crypt_r()
err.3
Seonghun Lim
Clean up description of error message source
In the second paragraph of DESCRIPTION section, one of the
sources of error messages is incorrect: the four functions obtain
error message only from errno, and "a code" is just relevant
with errc() and warnc(), which are not present on Linux.
see http://www.unix.com/man-page/freebsd/3/ERR/ .
Then, the third paragraph becomes a duplicate.
fflush.3
Regid Ichira
Fix wording error
See http://bugs.debian.org/cgi-bin/bugreport.cgi?614021
hsearch.3
Seonghun Lim
Update ERRORS section
EINVAL can occur for hdestroy_r().
EINVAL can't occur for hcreate().
Other minor fixes.
lockf.3
Michael Kerrisk [Mikel Ward]
ERRORS: EBADF can also occur for nonwritable file descriptor
As noted in the DESCRIPTION, the file descriptor must be writable
in order to place a lock.
malloc.3
Seonghun Lim
Reorder prototypes in SYNOPSIS
calloc() comes before realloc() in the other sections,
so should do in SYNOPSIS, too.
mbstowcs.3
Michael Kerrisk
SEE ALSO: add reference to wcstombs(3)
memcmp.3
Michael Kerrisk [Sebastian Unger]
Clarify that comparison interprets bytes as "unsigned char"
realpath.3
Michael Kerrisk [Seonghun Lim]
Fix EINVAL error
Since glibc 2.3, resolved_path can be non-NULL (with the
semantics already documented in the page).
scandir(3)
Mike Frysinger
Add ENOENT/ENOTDIR errors
siginterrupt.3
Michael Kerrisk [Luis Javier Merino]
Remove misleading sentence about signal(2) and system call interruption
strlen.3
Michael Kerrisk [Jon Grant]
SEE ALSO: Add strnlen(3)
strnlen.3
Michael Kerrisk [Jon Grant]
CONFORMING TO: Note that strnlen() is in POSIX.1-2008
strtoul.3
Michael Kerrisk [Tolga Dalman]
Fix NOTES section constants
termios.3
Michael Kerrisk
Use "terminal special characters" consistently throughout page
Michael Kerrisk [Paul Evans]
Add documentation of _POSIX_VDISABLE
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=627841
Michael Kerrisk
Add a description of STATUS character
Michael Kerrisk
Added description of SWTCH character
Michael Kerrisk
Add names of terminal special characters
Michael Kerrisk
List terminal special characters in alphabetical order
wcstombs.3
Michael Kerrisk
SEE ALSO: add mbstowcs(3)
console_codes.4
Petr Pisar
Add ESC [ 3 J
Linux 3.0 (commit f8df13e0a901fe55631fed66562369b4dba40f8b)
implements \E[3J to allow scrambling content of console
including scroll-back buffer
(http://thread.gmane.org/gmane.linux.kernel/1125792).
proc.5
Michael Kerrisk [Stan Sieler]
Add description of 'PPid' field of /proc/PID/status
Michael Kerrisk [Stan Sieler]
Add description of 'SigQ' field of /proc/PID/status
capabilities.7
Michael Kerrisk [Serge E. Hallyn]
Document CAP_SYSLOG and related changes in Linux 2.6.37
Michael Kerrisk
File capabilities are no longer optional
Starting with Linux 2.6.33, the CONFIG_SECURITY_FILE_CAPABILITIES
has been removed, and file capabilities are always part of the
kernel.
complex.7
Michael Kerrisk
Updated SEE ALSO list to include all complex math functions
ipv6.7
Michael Kerrisk [Simon Cross]
Fix description of address notation: "8 4-digit hexadecimal numbers"
signal.7
Seonghun Lim
Remove crufty repeated info about LinuxThreads
unix.7
Michael Kerrisk
Add pointer to cmsg(3) for an example of use of SCM_RIGHTS