mirror of https://github.com/mkerrisk/man-pages
Changes: Update for 3.40
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk
parent
04b2e45352
commit
9be6751b46
250
Changes
250
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 <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>
|
||||
Mike Frysinger <vapier@gentoo.org>
|
||||
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!
|
||||
|
||||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Reference in New Issue