From 5fb27aeb05f679fe45f3b9949bbd6e3853c25fcf Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 16 Sep 2011 04:56:20 +0200 Subject: [PATCH] Changes: Updates for 3.33 release Signed-off-by: Michael Kerrisk --- Changes | 345 +++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 339 insertions(+), 6 deletions(-) diff --git a/Changes b/Changes index 9c4c9af7d..a5cd2f8f0 100644 --- a/Changes +++ b/Changes @@ -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 +Alexander Schuch +Andries Brouwer +Brian M. Carlson +Dan Jacobson +Folkert van Heusden +Graham Gower +Hendrik Jan Thomassen +Jan Engelhardt +Joey Adams +Johannes Laire +Jon Grant +Josh Triplett +Konstantin Ritt +Luis Javier Merino +Michael Kerrisk +Mike Frysinger +Mikel Ward +Nick Black +Paul Evans +Petr Pisar +Przemyslaw Pawelczyk +Regid Ichira +Reuben Thomas +Richard B. Kreckel +Ryan Mullen +Sebastian Geiger +Sebastian Unger +Seonghun Lim +Serge E. Hallyn +Simon Cross +Simon Paillard +Stan Sieler +Timmy Lee +Tolga Dalman +Tomislav Jonjic +Yuri Kozlov +Wei Luosheng 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