original/Changes

   1 ==================== Changes in man-pages-3.41 ====================
   2
   3 Released: 2011-05-11, 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 Akihiro MOTOKI <amotoki@gmail.com>
  14 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
  15 Angelo Borsotti <angelo.borsotti@gmail.com >
  16 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
  17 Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
  18 Casper.Dik@oracle.com
  19 David Prévot <taffit@debian.org>
  20 D. Barbier <bouzim@gmail.com>
  21 Eric Blake <eblake@redhat.com>
  22 Hugh Dickins <hughd@google.com>
  23 Ivana Varekova <varekova@redhat.com>
  24 Jakub Jelinek <jakub@redhat.com>
  25 Jan Kara <jack@suse.cz>
  26 Jason Baron <jbaron@redhat.com>
  27 Jean-Michel Vourgère <jmv_deb@nirgal.com>
  28 Jeff Moyer <jmoyer@redhat.com>
  29 Josh Triplett <josh@joshtriplett.org>
  30 Kasper Dupont <kasperd@gmail.com>
  31 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
  32 Lauri Kasanen <curaga@operamail.com>
  33 Mel Gorman <mgorman@suse.de>
  34 Michael Kerrisk <mtk.manpages@gmail.com>
  35 Mike Frysinger <vapier@gentoo.org>
  36 Nick Piggin <npiggin@gmail.com>
  37 Paul Pluzhnikov <ppluzhnikov@google.com>
  38 Petr Baudis <pasky@ucw.cz>
  39 Ralph Corderoy <ralph@inputplus.co.uk >
  40 Rich Felker <bugdal@aerifal.cx>
  41 Simone Piccardi <piccardi@truelite.it>
  42 Simon Paillard <spaillard@debian.org>
  43 Stefan Puiu <stefan.puiu@gmail.com>
  44 Stephen Hemminger <shemminger@vyatta.com>
  45 Vincent Lefevre <vincent@vinc17.net>
  46 Yuri Kozlov <yuray@komyakino.ru>
  47
  48 Apologies if I missed anyone!
  49
  50
  51 New and rewritten pages
  52 -----------------------
  53
  54 get_robust_list.2
  55     Ivana Varekova  [Michael Kerrisk]
  56         New page documenting get_robust_list(2) and set_robust_list(2)
  57
  58 mallinfo.3
  59     Michael Kerrisk [KOSAKI Motohiro, Paul Pluzhnikov]
  60         New page for mallinfo(3)
  61
  62 malloc_info.3
  63     Michael Kerrisk  [Jakub Jelinek]
  64         New page for malloc_info(3)
  65
  66 malloc_stats.3
  67     Michael Kerrisk  [KOSAKI Motohiro]
  68         New man page for malloc_stats(3)
  69
  70
  71 Newly documented interfaces in existing pages
  72 ---------------------------------------------
  73
  74 madvise.2
  75     Jason Baron
  76         Document MADV_DONTDUMP and MADV_DODUMP
  77
  78
  79 New and changed links
  80 ---------------------
  81
  82 set_robust_list.2
  83     Michael Kerrisk
  84         New link to new get_robust_list.2 page
  85
  86 LIST_ENTRY.3
  87 LIST_HEAD.3
  88 LIST_INIT.3
  89 LIST_INSERT_AFTER.3
  90 LIST_INSERT_HEAD.3
  91 LIST_REMOVE.3
  92 TAILQ_ENTRY.3
  93 TAILQ_HEAD.3
  94 TAILQ_INIT.3
  95 TAILQ_INSERT_AFTER.3
  96 TAILQ_INSERT_HEAD.3
  97 TAILQ_INSERT_TAIL.3
  98 TAILQ_REMOVE.3
  99 CIRCLEQ_ENTRY.3
 100 CIRCLEQ_HEAD.3
 101 CIRCLEQ_INIT.3
 102 CIRCLEQ_INSERT_AFTER.3
 103 CIRCLEQ_INSERT_BEFORE.3
 104 CIRCLEQ_INSERT_HEAD.3
 105 CIRCLEQ_INSERT_TAIL.3
 106 CIRCLEQ_REMOVE.3
 107     Michael Kerrisk
 108         New link to queue.3
 109             The queue(3) page documents these macros, so it makes sense to
 110             have links for the names.
 111
 112 DES_FAILED.3
 113     Michael Kerrisk
 114         New link to des_crypt.3
 115             The des_crypt(3) page documents this macro, so it makes sense
 116             to have a link for the name.
 117
 118 qsort_r.3
 119     Michael Kerrisk
 120         New link to qsort.3
 121             Overlooked to add this link in 3.38, when documentation of
 122             qsort_r() was added to the qsort.3 page.
 123
 124
 125 Global changes
 126 --------------
 127
 128 faccessat.2
 129 fchmodat.2
 130 fchownat.2
 131 fstatat.2
 132 futimesat.2
 133 inotify_init.2
 134 linkat.2
 135 mkdirat.2
 136 mknodat.2
 137 openat.2
 138 readlinkat.2
 139 renameat.2
 140 setns.2
 141 splice.2
 142 symlinkat.2
 143 sync.2
 144 tee.2
 145 unlinkat.2
 146 vmsplice.2
 147     Michael Kerrisk  [Lauri Kasanen]
 148         Global fix: note glibc version that added library support
 149
 150 confstr.3
 151 strcasecmp.3
 152 strcat.3
 153 strcmp.3
 154 strcpy.3
 155 strdup.3
 156 strftime.3
 157 strlen.3
 158 strnlen.3
 159 strpbrk.3
 160 strspn.3
 161 strtok.3
 162 strxfrm.3
 163     Michael Kerrisk  [Andries E. Brouwer]
 164         Clarify that these functions operate on bytes, not (wide) characters
 165             Change 'character(s)' to 'byte(s)' to make clear that these
 166             functions operate on bytes, not wide / UTF8 characters.
 167             (POSIX uses 'byte(s)' similarly, to make this point.)
 168
 169 icmp.7
 170 ipv6.7
 171 packet.7
 172 raw.7
 173 rtnetlink.7
 174 unix.7
 175 x25.7
 176     Michael Kerrisk
 177         Remove names of constants from NAME line
 178             Some of the sockets/network protocol pages included names of
 179             the corresponding address family constants in the NAME line,
 180             but this wasn't done consistently across all pages, and probably
 181             it adds little value in those pages that did do this. So, remove
 182             these constants from those pages that have them in the NAME
 183             section.
 184
 185
 186 Changes to individual pages
 187 ---------------------------
 188
 189 clock_getres.2
 190     Michael Kerrisk  [Josh Triplett]
 191         Expand description of CLOCK_REALTIME
 192             Make it clear that this clock may be discontinuous, and is
 193             affected my incremental NTP and clock-adjtime(2) adjustments.
 194
 195             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=540872
 196
 197 epoll_wait.2
 198     Michael Kerrisk
 199         Clarify that 'timeout' is a *minimum* interval
 200             Make it clear that 'timeout' is a minimum interval; the actual
 201             interval will be rounded up to the system clock granularity,
 202             and may overrun because of kernel scheduling delays.
 203
 204 execve.2
 205     Michael Kerrisk
 206         Rewording to deemphasize libc5 details
 207
 208 fork.2
 209     Mike Frysinger
 210         ERRORS: add ENOSYS
 211             Can occur on, for example, non-MMU hardware.
 212
 213 getcpu.2
 214     Mike Frysinger
 215         Add RETURN VALUE and ERRORS sections
 216     Michael Kerrisk
 217         Refer reader to NOTES for more info about 'tcache'
 218     Michael Kerrisk
 219         DESCRIPTION: reword a sentence to be clearer
 220
 221 io_cancel.2
 222 io_destroy.2
 223 io_getevents.2
 224 io_setup.2
 225 io_submit.2
 226     Michael Kerrisk
 227         Rewrite to focus on system call API
 228             Rewrite to focus on the system call interface, adding
 229             some notes on the libaio wrapper differences.
 230             See the following mail:
 231             2012-05-07 "aio manuals", linux-man@vger.kernel.org
 232             http://thread.gmane.org/gmane.linux.man/1935/focus=2910
 233
 234             Other minor rewrites.
 235
 236 mount.2
 237     Michael Kerrisk
 238         Comment out an old Linux libc detail
 239
 240 open.2
 241     Nick Piggin  [KOSAKI Motohiro, Jan Kara, Hugh Dickins]
 242         Describe race of direct I/O and fork()
 243             Rework 04cd7f64, which didn't capture the details correctly.
 244             See the April/May 2012 linux-man@ mail thread "[PATCH]
 245             Describe race of direct read and fork for unaligned buffers"
 246             http://thread.gmane.org/gmane.linux.kernel.mm/77571
 247
 248 poll.2
 249     Michael Kerrisk
 250         Clarify that 'timeout' is a *minimum* interval
 251             Make it clear that 'timeout' is a minimum interval; the actual
 252             interval will be rounded up to the system clock granularity,
 253             and may overrun because of kernel scheduling delays.
 254     Michael Kerrisk
 255         Clarify discussion of wrapper function emulation
 256             Clarify that glibc (as well as old libc) provides emulation
 257             using select(2) on older kernels that don't have a poll()
 258             system call.
 259     Michael Kerrisk
 260         Make the meaning of a zero timeout explicit
 261             Clarify that timeout==0 causes an immediate return, even if
 262             no file descriptors are ready.
 263
 264 pread.2
 265     Michael Kerrisk  [Kasper Dupont]
 266         BUGS: Note O_APPEND + pwrite() does the wrong thing
 267             See https://bugzilla.kernel.org/show_bug.cgi?id=43178
 268
 269 recvmmsg.2
 270     Michael Kerrisk
 271         Clarify that 'timeout' is a *minimum* interval
 272             Make it clear that 'timeout' interval will be rounded up to the
 273             system clock granularity, and may overrun because of kernel
 274             scheduling delays.
 275
 276 select.2
 277     Michael Kerrisk
 278         Clarify that 'timeout' is a *minimum* interval
 279             Make it clear that 'timeout' is a minimum interval; the actual
 280             interval will be rounded up to the system clock granularity,
 281             and may overrun because of kernel scheduling delays.
 282     Michael Kerrisk
 283         Expand description of the self-pipe trick
 284     Michael Kerrisk
 285         Add further details on pselect6() system call that underlies pselect()
 286
 287 semop.2
 288     Michael Kerrisk
 289         Clarify that 'timeout' of semtimedop() is a *minimum* interval
 290             Make it clear that 'timeout' interval will be rounded up to the
 291             system clock granularity, and may overrun because of kernel
 292             scheduling delays.
 293
 294 signal.2
 295     Michael Kerrisk
 296         Note that 'sig_t' requires _BSD_SOURCE
 297             Also remove some old Linux libc details
 298
 299 sigwaitinfo.2
 300     Michael Kerrisk
 301         Clarify that 'timeout' of sigtimedwait() is a *minimum* interval
 302             Make it clear that 'timeout' is a minimum interval; the actual
 303             interval will be rounded up to the system clock granularity,
 304             and may overrun because of kernel scheduling delays.
 305
 306 stat.2
 307     Bjarni Ingi Gislason
 308         Formatting fixes
 309             From "groff -ww" (or "man --warnings=w ..."):
 310
 311                 warning: around line 442: table wider than line width
 312
 313             GNU man uses line length of 78.
 314
 315             Use text blocks.  Two spaces between sentences or better: start
 316             each sentence in a new line.
 317
 318 syscalls.2
 319     Bjarni Ingi Gislason
 320         Formatting fixes
 321             From "groff -ww ..." (or "man --warnings=w ..."):
 322
 323                 warning: around line 157: table wider than line width
 324
 325             Have to use text blocks.  Move some text to its correct column.
 326             Split text to two columns to avoid hyphenation.
 327
 328 sysinfo.2
 329     Michael Kerrisk
 330         Remove reference to obsolete libc5
 331
 332 syslog.2
 333     Michael Kerrisk
 334         Remove some details about obsolete Linux libc
 335
 336 aio_cancel.3
 337 aio_error.3
 338 aio_fsync.3
 339 aio_read.3
 340 aio_return.3
 341 aio_suspend.3
 342 aio_write.3
 343     Michael Kerrisk
 344         ERRORS: Add/update ENOSYS error
 345
 346 aio_cancel.3
 347     Michael Kerrisk
 348         Clarify what happens when a request isn't successfully canceled
 349     Michael Kerrisk
 350         Add pointers to aio(7) and sigevent(7)
 351
 352 dbopen.3
 353     Michael Kerrisk
 354         SYNOPSIS: Add header file <fcntl.h>
 355             Upstreamed from Debian, and consistent with FreeBSD
 356             dbopen(3) man page.
 357
 358 fmemopen.3
 359     Michael Kerrisk
 360         Note details of POSIX.1-2008 specification of 'b' in 'mode'
 361     Michael Kerrisk  [Rich Felker]
 362         BUGS: fmemopen() doesn't correctly set file position in some cases
 363             If 'mode' is append, but 'size' does not cover a null byte
 364             in 'buf', then fmemopen() incorrectly sets the initial file
 365             position to -1, rather than the next byte after the end of
 366             the buffer.
 367
 368             See http://sourceware.org/bugzilla/show_bug.cgi?id=13151
 369     Michael Kerrisk
 370         BUGS: fmemopen() incorrectly handles size==0 case
 371             If size is zero, fmemopen() fails, This is surprising behavior,
 372             and not specified in POSIX.1-2008.
 373
 374             See http://sourceware.org/bugzilla/show_bug.cgi?id=11216
 375
 376             Reported-by; Alex Shinn <alexshinn@gmail.com>
 377     Michael Kerrisk
 378         BUGS: Note silent ABI change for fmemopen() in glibc 2.9
 379     Michael Kerrisk  [Rich Felker]
 380         BUGS: Append mode does not force writes to append
 381             Append mode correctly sets the initial offset but does
 382             not force subsequent writes to append at end of stream.
 383
 384             See http://sourceware.org/bugzilla/show_bug.cgi?id=13152
 385     Michael Kerrisk  [Eric Blake]
 386         BUGS: Note inconsistent treatment of 'b' in 'mode'
 387             fopen() permits, for example, both "w+b" and "wb+",
 388             but only the latter is meaningful to fmemopen().
 389
 390             See http://sourceware.org/bugzilla/show_bug.cgi?id=12836
 391
 392 fopencookie.3
 393     Michael Kerrisk  [Petr Baudis]
 394         Correct description of return for user-supplied 'write' function
 395             See http://sourceware.org/bugzilla/show_bug.cgi?id=2074
 396
 397 getaddrinfo.3
 398     Jean-Michel Vourgère
 399         Note that AI_ADDRCONFIG is not affected by loopback addresses
 400             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=660479
 401
 402 iconv.3
 403     Michael Kerrisk
 404         Upstream useful NOTE from Debian
 405             Warn the reader that the pointer arguments can't be
 406             interpreted as C style strings. Also, note possible
 407             alignment requirements for the referenced bytes sequences,
 408     Michael Kerrisk
 409         Write a better paragraph introducing iconv() and its arguments
 410
 411 isgreater.3
 412     Michael Kerrisk  [Vincent Lefevre]
 413         Clarify that the arguments to these macros must be real-floating
 414             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=609033
 415
 416 lio_listio.3
 417     Michael Kerrisk
 418         Clarify that async notification occurs when *all* I/Os complete
 419
 420 makedev.3
 421     Michael Kerrisk
 422         SYNOPSIS: Correct return types of major() and minor()
 423             See https://bugzilla.redhat.com/show_bug.cgi?id=754188
 424
 425             Reported-by; Zdenek Kabelac <zkabelac@redhat.com>
 426
 427 malloc.3
 428     Michael Kerrisk
 429         SEE ALSO: Add malloc_info(3)
 430
 431 malloc_get_state.3
 432     Michael Kerrisk
 433         Fix wordos in function names in NAME line
 434
 435 mallopt.3
 436     Michael Kerrisk
 437         Fix example program
 438             The example code was a version that was not consistent with
 439             the shell output shown on the page.
 440
 441             Reported-bY: Simon Paillard <spaillard@debian.org>
 442     Michael Kerrisk
 443         Restore accidentally omitted line in shell session
 444     Michael Kerrisk
 445         SEE ALSO: Add malloc_stats(3)
 446
 447 mmap64.3
 448     Michael Kerrisk
 449         Change target of link to mmap.2 (was mmap2.2)
 450             Upstreamed from Red Hat / Fedora
 451
 452 realpath.3
 453     Michael Kerrisk  [Casper.Dik@oracle.com]
 454         Remove note about Solaris possibly returning a relative path
 455
 456 syslog.3
 457     Michael Kerrisk  [Ralph Corderoy]
 458         Document behavior when 'ident' argument to openlog() is NULL
 459             See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/382096
 460     Michael Kerrisk
 461         Update CONFORMING TO for POSIX.1-2008
 462             POSIX.1-2008 doesn't change any details, but make
 463             that more explicit.
 464
 465 undocumented.3
 466     Michael Kerrisk
 467         Remove some functions that have been documented
 468
 469 sd.4
 470     Michael Kerrisk
 471         Remove reference to nonexistent scsi(4) page
 472             Upstreamed from RedHat / Fedora
 473
 474 sk98lin.4
 475     Michael Kerrisk  [Stephen Hemminger]
 476         Note that this driver was removed in 2.6.28
 477             See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/528020
 478
 479 passwd.5
 480     Michael Kerrisk
 481         Upstream pieces from Red Hat/Fedora
 482             Note mention of empty password field.
 483             Add description of "*NP*" in password field.
 484     Michael Kerrisk
 485         Various minor fixes and improvements
 486
 487 proc.5
 488     Michael Kerrisk
 489         Note that CAP_SYS_ADMIN processes can override file-max
 490             Upstreamed from red Hat / Fedora
 491     Michael Kerrisk
 492         Document  /proc/[pid]/cgroup
 493             Upstreamed from Red Hat / Fedora
 494
 495 resolv.conf.5
 496     Michael Kerrisk
 497         Take a Debian improvement into upstream
 498
 499 tzfile.5
 500     Michael Kerrisk
 501         Mention timezone directories in DESCRIPTION
 502             Note that timezone files are usually in /usr/lib/zoneinfo
 503             or /usr/share/zoneinfo.
 504     Michael Kerrisk
 505         Drop SYNOPSIS
 506             The SYNOPSIS doesn't correspond to a user-visible file.
 507     Michael Kerrisk
 508         SEE ALSO: Add pointer to glibc source file timezone/tzfile.h
 509     Michael Kerrisk
 510         SEE ALSO: add tzset(3) and tzselect(8)
 511
 512 ascii.7
 513     Bjarni Ingi Gislason
 514         Indent for "troff" makes table too wide
 515             Fix following from "groff -t -ww ...":
 516
 517                 warning: around line 53: table wider than line width
 518
 519             Extra indent for "troff" makes the table look misplaced
 520             (default "ps" output).
 521
 522 cp1251.7
 523     Bjarni Ingi Gislason
 524         table too wide
 525             From "nroff -ww -t ...":
 526
 527                 warning: around line 44: table wider than line width
 528
 529             Columns are made narrower (column gutter decreased).
 530
 531 ipv6.7
 532     Stefan Puiu
 533         Add ENODEV error for bind() to link-local IPv6 address
 534
 535 signal.7
 536     Michael Kerrisk  [Simone Piccardi]
 537         Clarify that SIGLOST is unused
 538     Michael Kerrisk
 539         Comment out crufty BUGS text on SIGLOST
 540             It must be a very long time since the statement there
 541             about SIGLOST was true. (The text seems to date back to
 542             1996.)
 543     Michael Kerrisk
 544         Update architectures for tables of signal numbers
 545
 546 utf-8.7
 547     Brian M. Carlson
 548         Two clarifications
 549             This patch clarifies that 0xc0 and 0xc1 are not valid in any UTF-8
 550             encoding[0], and it also references RFC 3629 instead of RFC 2279.
 551
 552             [0] In order to have 0xc0, you'd have to have a two-byte encoding
 553             with all the data bits zero in the first byte (and thus only six
 554             bits of data), which would be an ASCII character encoded in the
 555             non-shortest form.  Similarly with 0xc1.
 556
 557             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=538641
 558
 559 ldconfig.8
 560 nscd.8
 561     Michael Kerrisk
 562         Remove path prefix from NAME line
 563             Command names shown in NAME are normally just the basename,
 564             not the full pathname of the command.