-==================== Changes in man-pages-3.39 ====================
+==================== Changes in man-pages-3.40 ====================
-Released: 2012-04-17, Christchurch
+Released: 2012-04-27, Christchurch
Contributors
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Abhijith Das <adas@redhat.com>
-Alexander Kruppa <akruppa@gmail.com>
-Andreas Jaeger <aj@suse.com>
-Armin Rigo <arigo@tunes.org>
-Cyrill Gorcunov <gorcunov@openvz.org>
-Denys Vlasenko <vda.linux@googlemail.com>
-Eric Blake <ebb9@byu.net>
-Felix <fkater@googlemail.com>
-Jak <jak@gmx.ca>
-Jeff Mahoney <jeffm@suse.com>
-Jesus Otero <jesus.otero@rysg.es>
-Jonathan Nieder <jrnieder@gmail.com>
-Kevin O'Gorman <kevinogorman4@gmail.com>
-Mark R Bannister <mark@proseconsulting.co.uk>
+Alexey Toptygin <alexeyt@freeshell.org>
+Bernhard Walle <bernhard@bwalle.de>
+Brian F. G. Bidulock <bidulock@openss7.org>
+Brian M. Carlson <sandals@crustytoothpaste.net>
+Christopher Yeoh <cyeoh@au1.ibm.com>
+Daniel J Blueman <daniel@quora.org>
+Eric Blake <eblake@redhat.com>
+Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
+James Hunt <james.hunt@ubuntu.com>
+John Sullivan <jsrhbz@kanargh.force9.co.uk>
+Jon Grant <jg@jguk.org>
+lepton <ytht.net@gmail.com>
+Marcel Holtmann <marcel@holtmann.org>
Michael Kerrisk <mtk.manpages@gmail.com>
-Michael Welsh Duggan <mwd@cert.org>
Mike Frysinger <vapier@gentoo.org>
-Petr Gajdos <pgajdos@suse.cz>
-Regid Ichira <regid23@yahoo.com>
-Reuben Thomas <rrt@sc3d.org>
-Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
-Simone Piccardi <piccardi@truelite.it>
-Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
-<who@connect.carleton.ca>
+Petr Baudis <pasky@ucw.cz>
+Simon Paillard <spaillard@debian.org>
+Stefan Puiu <stefan.puiu@gmail.com>
+Ulrich Drepper <drepper@gmail.com>
+Vadim Mikhailov <vadim.mikhailov@gmail.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
-malloc_trim.3
- Michael Kerrisk
- New man page for malloc_trim(3)
+process_vm_readv.2
+ Mike Frysinger, Christopher Yeoh, Michael Kerrisk
+ New page for process_vm_readv(2) and process_vm_writev(2)
-malloc_usable_size.3
+mcheck.3
Michael Kerrisk
- New man page for malloc_usable_size(3)
+ 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
---------------------------------------------
-prctl.2
- Cyrill Gorcunov
- Document PR_SET_MM (new in Linux 3.3)
+rcmd.3
Michael Kerrisk
- Various edits and improvements to Cyrill's patch
+ 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()
-Changes to individual pages
----------------------------
-epoll_create.2
+New and changed links
+---------------------
+
+iruserok_af.3
+rcmd_af.3
+rresvport_af.3
+ruserok_af.3
Michael Kerrisk
- Rework discussion of 'size' argument
+ New links to rcmd.3
+
+rexec_af.3
Michael Kerrisk
- Add .SS for description of epoll_create1()
+ New link to rexec.3
+
+
+Changes to individual pages
+---------------------------
-epoll_wait.2
- Michael Kerrisk [Armin Rigo]
- Another thread can add to epoll instance while epoll_wait is blocked
- See https://bugzilla.kernel.org/show_bug.cgi?id=43072
+clock_getres.2
Michael Kerrisk
- Clarify that epoll_pwait() blocks calling *thread*
- A few wording improvements
+ 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]
- Note difference between glibc wrapper and underlying system call
- The wrapper function has a 'flags' argument (which currently
- serves no purpose), while the underlying system call does not.
-
-fcntl.2
- Abhijith Das
- Explain behaviour of F_GETLEASE during lease break
- Michael Kerrisk [Eric Blake]
- Change type of arg from "long" to "int"
- Various fcntl(2) commands require an integral 'arg'.
- The man page said it must be "long" in all such cases.
- However, for the cases covered by POSIX, there is an
- explicit requirement that these arguments be "int".
- Update the man page to reflect. Probably, all of the
- other "long" cases (not specified in POSIX) should
- be "int", and this patch makes them so. Based on a
- note fromEric Blake, relating to F_DUPFD_CLOEXEC.
+ Improve discussion of difference between wrapper and underlying syscall
gettimeofday.2
Michael Kerrisk
- Reorganize content
- The main change is to move the historical information about
- the 'tz_dsttime' to NOTES.
- Michael Kerrisk [Felix]
- Note that compiler issues warnings if 'tv' is NULL
-
-mmap.2
- Michael Kerrisk [Kevin O'Gorman]
- Clarify that this system call should not be invoked directly
- See https://bugzilla.kernel.org/show_bug.cgi?id=42892
+ 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
- Clarify NOTES discussion of mmap() versus mmap2()
+ SEE ALSO: Add clock_gettime(2)
-poll.2
- Michael Kerrisk [Michael Welsh Duggan]
- Document negative value in 'fd' field
+prctl.2
Michael Kerrisk
- Document semantics of passing zero in 'events' field
+ 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
- Denys Vlasenko
- Various fixes
- For some reason, the PTRACE_TRACEME paragraph talks about some
- general aspects of ptraced process behavior. It repeats the
- "tracee stops on every signal" information even though that was
- already explained just a few paragraphs before. Then it describes
- legacy SIGTRAP on execve().
-
- This patch deletes the first part, and moves the second part up,
- into the general ptrace description. It also adds
- "If PTRACE_O_TRACEEXEC option is not in effect" to the description
- of the legacy SIGTRAP on execve().
-
- The patch also amends the part which says "For requests other
- than PTRACE_KILL, the tracee must be stopped." - PTRACE_ATTACH
- also doesn't require that.
-
-sigaction.2
- Michael Kerrisk [Andreas Jaeger, ]
- Clarify that the use of SI_SIGIO is for Linux 2.2 only
- See also http://sourceware.org/bugzilla/show_bug.cgi?id=6745
-
-sigprocmask.2
- Mike Frysinger
- ERRORS: add EFAULT
-
-times.2
- Michael Kerrisk [Simone Piccardi]
- ERRORS: Add EFAULT
-
-div.3
- Michael Kerrisk [Reuben Thomas]
- CONFORMING TO: Add C99
-
-fread.3
- Regid Ichira
- Clarify further that return value is number of items, not bytes
- See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=665780
+ 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.
-getaddrinfo.3
- Michael Kerrisk [Jak]
- Correct type of ai_addrlen field
+send.2
+ Stefan Puiu
+ Document EACCES error case for UDP
-malloc.3
+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
- SEE ALSO: add malloc_usable_size(3)
- SEE ALSO: Add malloc_trim(3)
+ 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
- Fix text describing M_PERTURB and free()
- SEE ALSO: Add malloc_trim(3)
+ SEE ALSO: add mcheck(3)
memchr.3
- Michael Kerrisk [Reuben Thomas]
- Remove mention of terminating null in description of rawmemchr()
-
-perror.3
- Michael Kerrisk [Jesus Otero]
- Note that use of 'sys_errlist' is deprecated
-
-rcmd.3
Michael Kerrisk
- glibc eventually added a declaration of iruserok() in version 2.12
-
-sysconf.3
- Michael Kerrisk [Ricardo Catalinas Jiménez]
- Add mention of _SC_SYMLOOP_MAX
-
-nologin.5
- Michael Kerrisk [Tetsuo Handa]
- nologin must not only exist, but *be readable* to be effective
+ 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".
-nsswitch.conf.5
- Mark R Bannister
- Significant rewrites and improvements
- This patch applies to nsswitch.conf.5 in man-pages-3.36.
+ At the same time, make a few source file clean-ups.
- My changes almost completely rewrite large sections of the
- man page. They are needed to add clarity, correct grammar,
- reduce confusion, and bring up-to-date with the latest glibc.
- I have checked the man page against the nss source code in
- glibc 2.14.90.
+mkstemp.3
+ Michael Kerrisk
+ Add "mkstemps" and "mkostemps" to NAME line
- Historical notes are demoted to the footer.
+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.
- The rewrite makes the man page much clearer to
- understand, more authoratitive, and easier to read.
+raise.3
Michael Kerrisk
- Light edits to Mark Bannister's changes
+ Add some notes on underlying system call that is used
-capabilities.7
+rcmd.3
Michael Kerrisk
- Add prctl(PR_SET_MM) to CAP_SYS_RESOURCE
-
-epoll.7
+ 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
- Some minor clarifications at start of DESCRIPTION
-
-netlink.7
- Jeff Mahoney [Petr Gajdos]
- Note cases where nonprivileged users can use netlink multicast groups
- See also https://bugzilla.novell.com/show_bug.cgi?id=754611
-
-unix.7
- Michael Kerrisk [Tetsuo Handa]
- Add a detail on autobind feature
-
-ld.so.8
- Jonathan Nieder [Reuben Thomas]
- Document effect of hwcaps on search path
- Wording by Aurelien Jarno from Debian glibc's r4701 (2011-06-04).
-
- Addresses http://bugs.debian.org/622385
+ 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