original/Changes

   1 ==================== Changes in man-pages-3.40 ====================
   2
   3 Released: 2012-04-27, Christchurch
   4
   5
   6 Contributors
   7 ------------
   8
   9 The following people contributed patches/fixes or (noted in brackets
  10 in the changelog below) reports, notes, and ideas that have been
  11 incorporated in changes in this release:
  12
  13 Alexey Toptygin <alexeyt@freeshell.org>
  14 Bernhard Walle <bernhard@bwalle.de>
  15 Brian F. G. Bidulock <bidulock@openss7.org>
  16 Brian M. Carlson <sandals@crustytoothpaste.net>
  17 Christopher Yeoh <cyeoh@au1.ibm.com>
  18 Daniel J Blueman <daniel@quora.org>
  19 Eric Blake <eblake@redhat.com>
  20 Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
  21 James Hunt <james.hunt@ubuntu.com>
  22 John Sullivan <jsrhbz@kanargh.force9.co.uk>
  23 Jon Grant <jg@jguk.org>
  24 lepton <ytht.net@gmail.com>
  25 Marcel Holtmann <marcel@holtmann.org>
  26 Michael Kerrisk <mtk.manpages@gmail.com>
  27 Mike Frysinger <vapier@gentoo.org>
  28 Petr Baudis <pasky@ucw.cz>
  29 Simon Paillard <spaillard@debian.org>
  30 Stefan Puiu <stefan.puiu@gmail.com>
  31 Ulrich Drepper <drepper@gmail.com>
  32 Vadim Mikhailov <vadim.mikhailov@gmail.com>
  33
  34 Apologies if I missed anyone!
  35
  36
  37 New and rewritten pages
  38 -----------------------
  39
  40 process_vm_readv.2
  41     Mike Frysinger, Christopher Yeoh, Michael Kerrisk
  42         New page for process_vm_readv(2) and process_vm_writev(2)
  43
  44 mcheck.3
  45     Michael Kerrisk
  46         New man page for mcheck(3) and related functions
  47             Also describes mcheck_check_all(3), mcheck_pedantic(3),
  48             and mprobe(3)
  49
  50
  51 Newly documented interfaces in existing pages
  52 ---------------------------------------------
  53
  54 rcmd.3
  55     Michael Kerrisk
  56         Document "_af" variants of these functions
  57             Document rcmd_af(), rresvport_af(), iruserok_af(), ruserok_af().
  58             Also some restructuring and other clarifications.
  59
  60 rexec.3
  61     Michael Kerrisk
  62         Document rexec_af()
  63
  64
  65 New and changed links
  66 ---------------------
  67
  68 iruserok_af.3
  69 rcmd_af.3
  70 rresvport_af.3
  71 ruserok_af.3
  72     Michael Kerrisk
  73         New links to rcmd.3
  74
  75 rexec_af.3
  76     Michael Kerrisk
  77         New link to rexec.3
  78
  79
  80 Changes to individual pages
  81 ---------------------------
  82
  83 clock_getres.2
  84     Michael Kerrisk
  85         Clarify difference between CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW
  86             Note interactions of these two clocks with discontinuous
  87             adjustments to the system time and NTP/adjtime(2).
  88
  89 fallocate.2
  90     Michael Kerrisk  [John Sullivan]
  91         Fix description of ENOSYS and EOPNOTSUP errors
  92             As reported in https://bugzilla.redhat.com/show_bug.cgi?id=680214
  93
  94 fchmodat.2
  95     Michael Kerrisk  [Mike Frysinger]
  96         Improve discussion of difference between wrapper and underlying syscall
  97
  98 gettimeofday.2
  99     Michael Kerrisk
 100         gettimeofday() is affected by discontinuous jumps in the system time
 101             Advise reader to use clock_gettime(2), if they need a
 102             monotonically increasing time source.
 103     Michael Kerrisk
 104         SEE ALSO: Add clock_gettime(2)
 105
 106 prctl.2
 107     Michael Kerrisk
 108         Add PR_TASK_PERF_EVENTS_DISABLE and PR_TASK_PERF_EVENTS_ENABLE
 109             Add some basic documentation of these operations, with a pointer to
 110             tools/perf/design.txt for more information.
 111     Michael Kerrisk  [Marcel Holtmann]
 112         Amend details of PR_SET_PDEATHSIG
 113
 114 ptrace.2
 115     Michael Kerrisk  [Mike Frysinger]
 116         Note SPARC deviation with respect to get/set regs
 117             SPARC reverses the use of 'addr' and 'data' for
 118             PTRACE_GETREGS, PTRACE_GETFPREGS, PTRACE_SETREGS,
 119             and PTRACE_SETFPREGS.
 120
 121 send.2
 122     Stefan Puiu
 123         Document EACCES error case for UDP
 124
 125 sigaction.2
 126     Michael Kerrisk
 127         Remove mention of raise(3) for SI_USER
 128             For a long time now, glibc's raise(3) didn't yield SI_USER
 129             for the signal receiver, so remove mention of raise(3)
 130             here. The user can deduce the details, if needed, by looking
 131             at the recently updated raise(3) page.
 132
 133 aio_cancel.3
 134     Michael Kerrisk  [Jon Grant]
 135         Rewrite RETURN VALUE section to be clearer
 136
 137 aio_init.3
 138     Michael Kerrisk  [Jon Grant]
 139         Remove extraneous "POSIX" from NAME section
 140
 141 btree.3
 142 dbopen.3
 143 hash.3
 144 mpool.3
 145 recno.3
 146     Michael Kerrisk  [Brian M. Carlson]
 147         Note that glibc no longer provides these interfaces
 148             glibc stopped providing these interfaces with v2.2.
 149             Nowadays, the user that finds these pages probably wants
 150             the libdb API, so note this in the page.
 151
 152             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=337581
 153
 154 fopen.3
 155     Michael Kerrisk
 156         BUGS: Note limitation on number of flag characters parsed in 'mode'
 157     Michael Kerrisk
 158         Note that 'c' and 'e' flags are ignored for fdopen()
 159             Determined from reading libio/iofdopen.c.
 160     Michael Kerrisk
 161         Document ",ccs=string" feature of 'mode' for fopen()/freopen()
 162
 163 getgrnam.3
 164     Michael Kerrisk  [Ulrich Drepper]
 165         Fix discussion of _SC_GETGR_R_SIZE_MAX
 166             The value is not meant to be a maximum (as was specified in
 167             SUSv3) but an initial guess at the required size
 168             (as specified in SUSv4).
 169
 170 getpwnam.3
 171     Michael Kerrisk  [Ulrich Drepper]
 172         Fix discussion of _SC_GETPW_R_SIZE_MAX
 173             The value is not meant to be a maximum (as was specified in
 174             SUSv3) but an initial guess at the required size
 175             (as specified in SUSv4).
 176
 177 malloc.3
 178 mallopt.3
 179 mtrace.3
 180     Michael Kerrisk
 181         SEE ALSO: add mcheck(3)
 182
 183 memchr.3
 184     Michael Kerrisk
 185         Clarify description, omitting mention of "strings" and "characters"
 186             The existing text slipped into talking about characters and
 187             strings, which could mislead readers into thing that, for
 188             example, searches for the byte '\0' are treated specially.
 189             Therefore, rewrite in terms of "bytes" and "memory areas".
 190
 191             At the same time, make a few source file clean-ups.
 192
 193 mkstemp.3
 194     Michael Kerrisk
 195         Add "mkstemps" and "mkostemps" to NAME line
 196
 197 posix_openpt.3
 198     Michael Kerrisk  [Vadim Mikhailov]
 199         Add some details on use of the slave pathname
 200             An explicit pointer to ptsname(3) is useful, as is a note
 201             of the fact that the slave device pathname exists only as
 202             long as the master device is held open.
 203
 204 raise.3
 205     Michael Kerrisk
 206         Add some notes on underlying system call that is used
 207
 208 rcmd.3
 209     Michael Kerrisk
 210         Add some details of the rresvport() 'port' argument
 211
 212 resolver.3
 213     Petr Baudis
 214         Note that many options are documented in resolv.conf(5)
 215
 216 scandir.3
 217     Michael Kerrisk  [Daniel J Blueman]
 218         Improve EXAMPLE source code: s/0/NULL/ in scandir() call
 219
 220 strchr.3
 221     James Hunt
 222         Explain behavior when searching for '\0'
 223
 224 strerror.3
 225     Eric Blake  [Stefan Puiu]
 226         Improve strerror_r() description
 227             POSIX requires that perror() not modify the static storage
 228             returned by strerror().  POSIX 2008 and C99 both require that
 229             strerror() never return NULL (a strerror() that always
 230             returns "" for all inputs is valid for C99, but not for POSIX).
 231
 232             http://sourceware.org/bugzilla/show_bug.cgi?id=12204
 233             documents glibc's change to come into compliance with POSIX
 234             regarding strerror_r() return value.  The GNU strerror_r() use
 235             of 'buf' was confusing - I ended up writing a test program that
 236             proves that 'buf' is unused for valid 'errnum', but contains
 237             truncated "unknown message" for out-of-range 'errnum'.
 238
 239             See also http://austingroupbugs.net/view.php?id=382
 240     Bernhard Walle
 241         Correct description of error return for XSI strerror_r()
 242     Michael Kerrisk [Eric Blake]
 243         Note how to use 'errno' to detect errors when calling strerror()
 244     Michael Kerrisk  [Jon Grant]
 245         Add an example of the kind of string returned by strerror()
 246
 247 resolv.conf.5
 248     Petr Baudis
 249         Document "single-request" option
 250
 251 inotify.7
 252     Michael Kerrisk
 253         Note buffer size that guarantees being able to read at least one event
 254     James Hunt
 255         Correct description of size of inotify_event structure
 256
 257 iso_8859-1.7
 258     Eugen Dedu
 259         Add "-" for SOFT HYPHEN
 260             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=156154
 261
 262 netdevice.7
 263     Brian F. G. Bidulock
 264         Document some SIOC configuration ioctls
 265             This patch adds common but missing SIOC configuration ioctls to
 266             the netdevice.7 manual pages that are not documented anywhere
 267             else. SIOCSIFPFLAGS and SIOCGIFPFLAGS are linux-specific. Flag
 268             values come from Linux 2.6.25 kernel headers for sockios. The
 269             others are standard BSD ioctls that have always been implemented
 270             by Linux and were verified from inspecting netdevice.c kernel
 271             code.
 272
 273 socket.7
 274     Michael Kerrisk  [Alexey Toptygin]
 275         Correct description of SO_BROADCAST
 276
 277 tcp.7
 278     lepton
 279         Correct description for TCP_MAXSEG on modern kernel