From 9be6751b46992076ac85647e025f375a310708e6 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 27 Apr 2012 10:56:42 +1200 Subject: [PATCH] Changes: Update for 3.40 Signed-off-by: Michael Kerrisk --- Changes | 250 +++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 247 insertions(+), 3 deletions(-) diff --git a/Changes b/Changes index fe028b19c..ee6ed47ff 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ ==================== Changes in man-pages-3.40 ==================== -Released: ????-??-??, Munich +Released: 2012-04-27, Christchurch Contributors @@ -10,6 +10,26 @@ 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: +Alexey Toptygin +Bernhard Walle +Brian F. G. Bidulock +Brian M. Carlson +Christopher Yeoh +Daniel J Blueman +Eric Blake +Eugen Dedu +James Hunt +John Sullivan +Jon Grant +lepton +Marcel Holtmann +Michael Kerrisk +Mike Frysinger +Petr Baudis +Simon Paillard +Stefan Puiu +Ulrich Drepper +Vadim Mikhailov Apologies if I missed anyone! @@ -17,19 +37,243 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- +process_vm_readv.2 + Mike Frysinger, Christopher Yeoh, Michael Kerrisk + New page for process_vm_readv(2) and process_vm_writev(2) + +mcheck.3 + Michael Kerrisk + New man page for mcheck(3) and related functions + Also describes mcheck_check_all(3), mcheck_pedantic(3), + and mprobe(3) + Newly documented interfaces in existing pages --------------------------------------------- +rcmd.3 + Michael Kerrisk + Document "_af" variants of these functions + Document rcmd_af(), rresvport_af(), iruserok_af(), ruserok_af(). + Also some restructuring and other clarifications. + +rexec.3 + Michael Kerrisk + Document rexec_af() + New and changed links --------------------- +iruserok_af.3 +rcmd_af.3 +rresvport_af.3 +ruserok_af.3 + Michael Kerrisk + New links to rcmd.3 -Global changes --------------- +rexec_af.3 + Michael Kerrisk + New link to rexec.3 Changes to individual pages --------------------------- +clock_getres.2 + Michael Kerrisk + Clarify difference between CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW + Note interactions of these two clocks with discontinuous + adjustments to the system time and NTP/adjtime(2). + +fallocate.2 + Michael Kerrisk [John Sullivan] + Fix description of ENOSYS and EOPNOTSUP errors + As reported in https://bugzilla.redhat.com/show_bug.cgi?id=680214 + +fchmodat.2 + Michael Kerrisk [Mike Frysinger] + Improve discussion of difference between wrapper and underlying syscall + +gettimeofday.2 + Michael Kerrisk + gettimeofday() is affected by discontinuous jumps in the system time + Advise reader to use clock_gettime(2), if they need a + monotonically increasing time source. + Michael Kerrisk + SEE ALSO: Add clock_gettime(2) + +prctl.2 + Michael Kerrisk + Add PR_TASK_PERF_EVENTS_DISABLE and PR_TASK_PERF_EVENTS_ENABLE + Add some basic documentation of these operations, with a pointer to + tools/perf/design.txt for more information. + Michael Kerrisk [Marcel Holtmann] + Amend details of PR_SET_PDEATHSIG + +ptrace.2 + Michael Kerrisk [Mike Frysinger] + Note SPARC deviation with respect to get/set regs + SPARC reverses the use of 'addr' and 'data' for + PTRACE_GETREGS, PTRACE_GETFPREGS, PTRACE_SETREGS, + and PTRACE_SETFPREGS. + +send.2 + Stefan Puiu + Document EACCES error case for UDP + +sigaction.2 + Michael Kerrisk + Remove mention of raise(3) for SI_USER + For a long time now, glibc's raise(3) didn't yield SI_USER + for the signal receiver, so remove mention of raise(3) + here. The user can deduce the details, if needed, by looking + at the recently updated raise(3) page. + +aio_cancel.3 + Michael Kerrisk [Jon Grant] + Rewrite RETURN VALUE section to be clearer + +aio_init.3 + Michael Kerrisk [Jon Grant] + Remove extraneous "POSIX" from NAME section + +btree.3 +dbopen.3 +hash.3 +mpool.3 +recno.3 + Michael Kerrisk [Brian M. Carlson] + Note that glibc no longer provides these interfaces + glibc stopped providing these interfaces with v2.2. + Nowadays, the user that finds these pages probably wants + the libdb API, so note this in the page. + + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=337581 + +fopen.3 + Michael Kerrisk + BUGS: Note limitation on number of flag characters parsed in 'mode' + Michael Kerrisk + Note that 'c' and 'e' flags are ignored for fdopen() + Determined from reading libio/iofdopen.c. + Michael Kerrisk + Document ",ccs=string" feature of 'mode' for fopen()/freopen() + +getgrnam.3 + Michael Kerrisk [Ulrich Drepper] + Fix discussion of _SC_GETGR_R_SIZE_MAX + The value is not meant to be a maximum (as was specified in + SUSv3) but an initial guess at the required size + (as specified in SUSv4). + +getpwnam.3 + Michael Kerrisk [Ulrich Drepper] + Fix discussion of _SC_GETPW_R_SIZE_MAX + The value is not meant to be a maximum (as was specified in + SUSv3) but an initial guess at the required size + (as specified in SUSv4). + +malloc.3 +mallopt.3 +mtrace.3 + Michael Kerrisk + SEE ALSO: add mcheck(3) + +memchr.3 + Michael Kerrisk + Clarify description, omitting mention of "strings" and "characters" + The existing text slipped into talking about characters and + strings, which could mislead readers into thing that, for + example, searches for the byte '\0' are treated specially. + Therefore, rewrite in terms of "bytes" and "memory areas". + + At the same time, make a few source file clean-ups. + +mkstemp.3 + Michael Kerrisk + Add "mkstemps" and "mkostemps" to NAME line + +posix_openpt.3 + Michael Kerrisk [Vadim Mikhailov] + Add some details on use of the slave pathname + An explicit pointer to ptsname(3) is useful, as is a note + of the fact that the slave device pathname exists only as + long as the master device is held open. + +raise.3 + Michael Kerrisk + Add some notes on underlying system call that is used + +rcmd.3 + Michael Kerrisk + Add some details of the rresvport() 'port' argument + +resolver.3 + Petr Baudis + Note that many options are documented in resolv.conf(5) + +scandir.3 + Michael Kerrisk [Daniel J Blueman] + Improve EXAMPLE source code: s/0/NULL/ in scandir() call + +strchr.3 + James Hunt + Explain behavior when searching for '\0' + +strerror.3 + Eric Blake [Stefan Puiu] + Improve strerror_r() description + POSIX requires that perror() not modify the static storage + returned by strerror(). POSIX 2008 and C99 both require that + strerror() never return NULL (a strerror() that always + returns "" for all inputs is valid for C99, but not for POSIX). + + http://sourceware.org/bugzilla/show_bug.cgi?id=12204 + documents glibc's change to come into compliance with POSIX + regarding strerror_r() return value. The GNU strerror_r() use + of 'buf' was confusing - I ended up writing a test program that + proves that 'buf' is unused for valid 'errnum', but contains + truncated "unknown message" for out-of-range 'errnum'. + + See also http://austingroupbugs.net/view.php?id=382 + Bernhard Walle + Correct description of error return for XSI strerror_r() + Michael Kerrisk [Eric Blake] + Note how to use 'errno' to detect errors when calling strerror() + Michael Kerrisk [Jon Grant] + Add an example of the kind of string returned by strerror() + +resolv.conf.5 + Petr Baudis + Document "single-request" option + +inotify.7 + Michael Kerrisk + Note buffer size that guarantees being able to read at least one event + James Hunt + Correct description of size of inotify_event structure + +iso_8859-1.7 + Eugen Dedu + Add "-" for SOFT HYPHEN + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=156154 + +netdevice.7 + Brian F. G. Bidulock + Document some SIOC configuration ioctls + This patch adds common but missing SIOC configuration ioctls to + the netdevice.7 manual pages that are not documented anywhere + else. SIOCSIFPFLAGS and SIOCGIFPFLAGS are linux-specific. Flag + values come from Linux 2.6.25 kernel headers for sockios. The + others are standard BSD ioctls that have always been implemented + by Linux and were verified from inspecting netdevice.c kernel + code. + +socket.7 + Michael Kerrisk [Alexey Toptygin] + Correct description of SO_BROADCAST + +tcp.7 + lepton + Correct description for TCP_MAXSEG on modern kernel