original/Changes.old

   1 ==================== Changes in man-pages-2.00 ====================
   2
   3 Released: 2004-12-16
   4
   5 Contributors
   6 ------------
   7
   8 The following people contributed notes, ideas, or patches that have
   9 been incorporated in changes in this release:
  10
  11 Alberto Bertogli <albertogli@telpin.com.ar>
  12 Anand Kumria <wildfire@progsoc.org>
  13 Andrey Kiselev <dron@ak4719.spb.edu>
  14 Andries Brouwer <Andries.Brouwer@cwi.nl>
  15 Chris Green <cmg@dok.org>
  16 Branden Robinson <branden@debian.org>
  17 Emmanuel Colbus <emmanuel.colbus@ensimag.imag.fr>
  18 Enrico Zini <enrico@debian.org>
  19 Eric Estievenart <eric.estievenart@free.fr>
  20 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
  21 Florian Weimer <fw@deneb.enyo.de>
  22 Jan Kuznik <kuznik@gepro.cz>
  23 Joey (Martin) Schulze <joey@infodrom.org>
  24 Johannes Berg <johannes@sipsolutions.de>
  25 John V. Belmonte <jbelmonte@debian.org>
  26 Karel Kulhavy <clock@twibright.com>
  27 Luis Javier Merino Morán <ljmerino@pandasoftware.es>
  28 Martin Pool <mbp@sourcefrog.net>
  29 Richard Kreckel <Richard.Kreckel@ginac.de>
  30 Vasya Pupkin <ptushnik@gmail.com>
  31
  32 Apologies if I missed anyone!
  33
  34 Global changes
  35 --------------
  36
  37 Various pages
  38     Fabian Kreutz
  39         Many math pages had their synopses compressed, as per suggestion
  40         from Fabian Kreutz.
  41
  42 Various pages
  43     Fabian Kreutz / aeb
  44         Many minor content and formatting bug fixes were made to the math
  45         pages, following suggestions from Fabian Kreutz (who recently
  46         translated many of the 1.70 math pages into German) and
  47         Andries Brouwer.
  48
  49 Various pages
  50     mtk
  51         For consistency, all instances of "super-user" were changed
  52         to the more common "superuser".
  53
  54 Various pages
  55     Vasya Pupkin / mtk
  56         After a note from Vasya Pupkin, I added <errno.h> to the SYNOPSIS
  57         of several Section 2 pages using the _syscallN() macros.
  58
  59         In addition:
  60             -- erroneous semicolons at the end of _syscallN() were removed
  61                on various pages.
  62
  63             -- types such as "uint" in syscallN() declarations were changed
  64                to "unsigned int", etc.
  65
  66             -- various other minor breakages in the synopses were fixed.
  67
  68         The affected pages are:
  69
  70                 getdents.2
  71                 gettid.2
  72                 llseek.2
  73                 mmap2.2
  74                 modify_ldt.2
  75                 pivot_root.2
  76                 quotactl.2
  77                 readdir.2
  78                 sysctl.2
  79                 syslog.2
  80                 tkill.2
  81
  82 Typographical or grammatical errors have been corrected in several
  83 other places.
  84
  85 Changes to individual pages
  86 ---------------------------
  87
  88 bind.2
  89     Florian Weimer
  90         Added 'const' to declaration of 'my_addr' in prototype.
  91         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239762.
  92
  93 fcntl.2
  94     Martin Pool
  95         Added O_NOATIME to list of flags that can be changed via F_SETFL.
  96     mtk/aeb
  97         Noted F_GETOWN bug after suggestion from aeb.
  98         See also:
  99         http://marc.theaimsgroup.com/?l=linux-kernel&m=108380640603164&w=2
 100
 101 getrlimit.2
 102     mtk
 103         Material on getrusage.2 has been separated out into its own page.
 104         Rewrote discussion on RLIMIT_MEMLOCK to incorporate kernel
 105         2.6.9 changes.
 106         Added note on RLIMIT_CPU error in older kernels.
 107         Added RLIMIT_SIGPENDING.
 108         Also made a few other minor changes.
 109
 110 getrusage.2
 111     mtk
 112         This page is new(ish) -- it was created by splitting
 113         getrlimit.2.
 114
 115         Repaired note on SIGCHLD behavior to note that the
 116         POSIX non-conformance has been fixed in 2.6.9.
 117
 118 kill.2
 119     Modified after suggestion from Emmanuel Colbus
 120         Changed wording of sentence under NOTES describing
 121         when signals can be sent to init(1).
 122
 123 mlock.2
 124 munlock.2
 125 mlockall.2
 126 munlockall.2
 127         These have been consolidated into a single mlock.2 page.
 128         In the process, much duplication was eliminated
 129         and new information was added about RLIMIT_MEMLOCK
 130         and the changes in memory locking in kernel 2.6.9,
 131
 132 mmap.2
 133     mtk
 134         Added cross-ref to setrlimit(2) concerning memory locking limits.
 135     Eric Estievenart
 136         Note that MAP_FIXED replaces existing mappings
 137
 138 msgctl.2
 139     mtk
 140         Substantial language and formatting clean-ups.
 141         Added msqid_ds and ipc_perm structure definitions.
 142
 143 msgget.2
 144     mtk
 145         Substantial language and formatting clean-ups.
 146         Added notes on /proc files.
 147
 148 msgop.2
 149     mtk
 150         Substantial language and formatting clean-ups.
 151         Added notes on /proc files.
 152
 153 open.2
 154     Martin Pool
 155         Added O_NOATIME (new in Linux 2.6.8)
 156     mtk
 157         Reordered list of 'flags' description alphabetically
 158
 159 personality.2
 160     2004-11-03 applied patch from Martin Schulze
 161
 162 semctl.2
 163     mtk
 164         Substantial language and formatting clean-ups.
 165         Rewrote semun text.
 166         Added semid_ds and ipc_perm structure definitions.
 167
 168 semget.2
 169     mtk
 170         Substantial language and formatting clean-ups.
 171         Added notes on /proc files.
 172         Rewrote BUGS note about semget()'s failure to initialize
 173         semaphore values.
 174
 175 semop.2
 176     mtk
 177         Substantial language and formatting clean-ups.
 178         Added notes on /proc files.
 179
 180 shmctl.2
 181     mtk
 182         Substantial language and formatting clean-ups.
 183         Updated shmid_ds structure definitions.
 184         Added information on SHM_DEST and SHM_LOCKED flags.
 185         Noted that CAP_IPC_LOCK is not required for SHM_UNLOCK
 186         since kernel 2.6.9.
 187         Added notes on 2.6.9 RLIMIT_MEMLOCK changes.
 188         Added RLIMIT_SIGPENDING (new in Linux 2.6.8)
 189
 190 shmget.2
 191     mtk
 192         Substantial language and formatting clean-ups.
 193         Added notes on /proc files.
 194
 195 shmop.2
 196     mtk
 197         Substantial language and formatting clean-ups.
 198         Changed wording and placement of sentence regarding attachment
 199         of segments marked for destruction.
 200
 201 sigaction.2
 202     mtk
 203         Added mention of SIGCONT under SA_NOCLDSTOP.
 204         Added SA_NOCLDWAIT.
 205         Updated discussion for POSIX.1-2001 and SIGCHLD and sa_flags.
 206         Noted that CLD_CONTINUED is supported since Linux 2.6.9.
 207         Added SI_TKILL (new in Linux 2.4.19).
 208         Other minor changes.
 209
 210 signal.2
 211     mtk
 212         Removed text on ignoring SIGCHLD; replaced with pointer
 213         to sigaction.2.
 214
 215 sigwaitinfo.2
 216     After bug report from Andrey Kiselev
 217         Fixed prototype: "timeout" --> "*timeout"
 218         as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=222145
 219
 220 stat.2
 221     Enrico Zini
 222         Added text to clarify that S_IS*() macros should be applied to
 223         st_mode field.
 224         as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=249698
 225
 226 swapon.2
 227     After Debian bug report from Anand Kumria
 228         Added "no swap space signature" to EINVAL error.
 229     mtk
 230         Added EINVAL error for swapoff() ("not currently a swap area").
 231         Added EBUSY error for swapon().
 232         A few formatting fixes.
 233
 234 times.2
 235     mtk
 236         In Linux 2.6, the return value of times changed; it is no
 237         longer time since boot, but rather:
 238
 239             boot_time + 2^32 / HZ - 300
 240
 241         Repaired note on SIGCHLD behavior to note that the
 242         POSIX non-conformance has been fixed in 2.6.9.
 243         Some formatting fixes.
 244
 245 undocumented.2
 246     After bug report from Johannes Berg
 247         Changed
 248             .TH UNIMPLEMENTED
 249         to:
 250             .TH UNDOCUMENTED
 251         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=220741
 252
 253 wait.2
 254     mtk
 255         Added waitid(2).
 256         Added WCONTINUED and WIFCONTINUED (new in 2.6.10).
 257         Added text on SA_NOCLDSTOP.
 258         Updated discussion of SA_NOCLDWAIT to reflect 2.6 behavior.
 259         Much other text rewritten.
 260
 261 wait4.2
 262     mtk
 263         Rewrote this page, removing much duplicated information,
 264         and replacing with pointers to wait.2.
 265     Luis Javier Merino Morán / mtk
 266         CONFORMING TO said "SVr4, POSIX".  Changed to "4.3BSD"
 267
 268 waitid.2
 269     mtk
 270         New link to wait.2
 271
 272 assert.3
 273     After bug report from Branden Robinson
 274         The assert() failure message goes to stderr not stdout.
 275         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=284814
 276
 277 ctime.3
 278     mtk
 279         Noted that 0 in tm_mday is interpreted to mean the last day
 280         of the preceding month.
 281
 282 getnameinfo.3
 283     http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=229618
 284         getnameinfo() does not set errno, it returns a non-zero
 285         value indicating the error.
 286     mtk
 287         added EAI_OVERFLOW error
 288
 289 killpg.3
 290     mtk
 291         Minor changes to SEE ALSO and CONFORMING TO.
 292
 293 lseek64.3
 294     aeb
 295         New page by Andries Brouwer
 296
 297 tzset.3
 298     Richard Kreckel
 299         Change "NULL" to "empty" when talking about the value of TZ.
 300         http://sources.redhat.com/bugzilla/show_bug.cgi?id=601
 301
 302 printf.3
 303     After bug report from Jan Kuznik
 304         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=205736
 305         Fixed bad realloc() use in snprintf() example
 306
 307 realpath.3
 308     mtk
 309         Added discussion of resolved_path == NULL.
 310
 311 random.4
 312     After bug report from John V. Belmonte
 313         Updated init and quit scripts to reflect kernel 2.4/2.6 reality
 314         (Scripts taken from drivers/char/random.c)
 315         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=247779
 316
 317 proc.5
 318     mtk
 319         Updated description of /proc/loadavg to include
 320         nr_running(), nr_threads, last_pid.
 321
 322         rtsig-max and rtsig-nr went away in 2.6.8
 323
 324         updated statm, and fixed error in order of list
 325
 326 boot.7
 327     applied patch from Martin Schulze
 328
 329 capabilities.7
 330     mtk
 331         Added O_NOATIME for CAP_FOWNER
 332
 333 netdevice.7
 334     Karel Kulhavy and AEB
 335         Formatting fix after note from Karel Kulhavy and AEB, plus a
 336         few wording fixes.
 337
 338 signal.7
 339     mtk
 340         /proc/sys/kernel/rtsig-* were superseded by RLIMIT_SIGPENDING
 341         in kernel 2.6.8.
 342
 343 tcp.7
 344     mtk/aeb
 345         Updated details of interaction of TCP_CORK and TCP_NODELAY.
 346
 347 ==================== Changes in man-pages-2.01 ====================
 348
 349 Released: 2004-12-20
 350
 351 Contributors
 352 ------------
 353
 354 The following people contributed notes, ideas, or patches that have
 355 been incorporated in changes in this release:
 356
 357 Carsten Hey <c.hey@web.de>
 358 Johannes Berg <johannes@sipsolutions.de>
 359 Joshua Kwan <joshk@triplehelix.org>
 360 Marek Habersack <grendel@debian.org>
 361 Martin Schulze <joey@infodrom.org>
 362 Matthew Dempsky <jivera@flame.org>
 363 Matthew Gregan <kinetik@orcon.net.nz>
 364 Pedro Zorzenon Neto <pzn@terra.com.br>
 365 Tony Crawford <tony@klosterdorf.de>
 366
 367 Apologies if I missed anyone!
 368
 369 Global changes
 370 --------------
 371
 372 accept.2
 373 close.2
 374 send.2
 375 setsid.2
 376 socket.2
 377 closedir.3
 378 initgroups.3
 379 mkstemp.3
 380 opendir.3
 381 readdir.3
 382 telldir.3
 383     Matthew Dempsky, mtk
 384         triggered by http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=283179
 385         The wording describing how errno is set was fixed up in these pages.
 386
 387 Typographical or grammatical errors have been corrected in several
 388 other places.
 389
 390 Changes to individual pages
 391 ---------------------------
 392
 393 sendfile.2
 394     mtk
 395         Adjusted descriptions of argument file types to be closer to
 396         2.6 reality.
 397         Wording and formatting changes.
 398
 399 ctan.3
 400 ctanh.3
 401     Tony Crawford
 402         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=270817
 403         Formulae on the pages should be T = S / C not T = C / S.
 404
 405 errno.3
 406     Martin Schulze, mtk
 407         Removed errno declaration from prototype, added notes
 408         on historical need for this declaration.
 409         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=174175
 410
 411 aio_return.3
 412     as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=224953
 413         Changed erroneous "aio_return(2)" to "aio_return(3)".
 414
 415 posix_openpt.3
 416     mtk
 417         New by mtk
 418
 419 ptsname.3
 420     mtk
 421         Added description of ptsname_r().
 422         Added ERRORS.
 423
 424 ptsname_r.3
 425     mtk
 426         New link to ptsname.3.
 427
 428 shm_open.3
 429     Matthew Gregan
 430         add <fcntl.h> to synopsis
 431         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=271243
 432
 433 strcasecmp.3
 434     Marek Habersack
 435             .SH "CONFORMING TO"
 436             -BSD 4.4
 437             +BSD 4.4, SUSv3
 438         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=234443
 439
 440 strfry.3
 441     Joshua Kwan
 442         Added _GNU_SOURCE to prototype
 443         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=213538
 444
 445 strftime.3
 446     Cartsen Hey
 447         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248
 448
 449         Changed range for "%S" from 0..61 to 0..60.
 450
 451         SUSv3 says 0..60.  I think the manual page probably says
 452         0..61, because that's what SUSv2 said.
 453         (Some other implementations' man pages also say 0..61 --
 454         e.g., Solaris 8 & 9, Tru64 5.1B; FreeBSD 5.1 says 0..60.)
 455
 456         The glibc manual currently says 0..60.
 457
 458         Given that SUSv3 says 0..60, I've changed the
 459         manual page to also say this:
 460
 461             -The second as a decimal number (range 00 to 61).
 462             +The second as a decimal number (range 00 to 60).
 463             +(The range is up to 60 to allow for occasional leap seconds.)
 464
 465 sysconf.3
 466     Johannes Berg
 467         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=226974
 468         -.BR POSIX2_FORT_RUN " - " _SC_2_FORT_DEV
 469         +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV
 470
 471 system.3
 472     Pedro Zorzenon
 473         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638
 474         Noted use of _XOPEN_SOURCE to get macros from <stdlib.h>
 475         for wait(2).
 476
 477     mtk
 478         Changed name of argument from 'string' to 'command' (like POSIX).
 479
 480         Noted that glibc does nowadays explicitly check for the existence
 481         of the shell if 'command' is NULL, rather than the older behavior
 482         of assuming the shell exists and always returning 1 if
 483         'command' is NULL.
 484
 485         Other wording and formatting clean-ups.
 486
 487 undocumented.3
 488     Remove some functions names that *are* documented.
 489
 490
 491 ==================== Changes in man-pages-2.02 ====================
 492
 493 Released: 2005-04-14
 494
 495 Contributors
 496 ------------
 497
 498 The following people contributed notes, ideas, or patches that have
 499 been incorporated in changes in this release:
 500
 501 Andries Brouwer <Andries.Brouwer@cwi.nl>
 502 Branden Robinson <branden@debian.org>
 503 Colin Watson <cjwatson@debian.org>
 504 David Lloyd <dmlloyd@tds.net>
 505 Gordon Jin <gordon.jin@intel.com>
 506 Heikki Orsila <shd@modeemi.cs.tut.fi>
 507 Jamie Lokier <jamie@shareable.org>
 508 Johan Walles
 509 Kai Makisara <Kai.Makisara@kolumbus.fi>
 510 Marko Kohtala <marko.kohtala@gmail.com>
 511 Martin Pool <mbp@sourcefrog.net>
 512 Martin (Joey) Schulze <joey@infodrom.org>
 513 Matthias Lang <matthias@corelatus.se>
 514 Michael Haardt <michael@moria.de>
 515 Michael Mühlebach <michael@anduin.ch>
 516 Mike Frysinger <vapier@gentoo.org>
 517 Sasa Stevanovic <mg94c18@alas.matf.bg.ac.yu>
 518 Serguei Leontiev <leo@sai.msu.ru>
 519
 520 Apologies if I missed anyone!
 521
 522 Global changes
 523 --------------
 524
 525 ctime.3
 526 tzselect.8
 527 zdump.8
 528 zic.8
 529     Martin (Joey) Schulze
 530         Removed SEE ALSO reference to nonexistent newctime(3).
 531         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=236884
 532
 533 Typographical or grammatical errors have been corrected in several
 534 other places.
 535
 536 Changes to individual pages
 537 ---------------------------
 538
 539 clone.2
 540     mtk
 541         Noted the PID caching behavior of NPTL's getpid()
 542         wrapper under BUGS.
 543
 544         Added futex(2), set_thread_area(2), set_tid_address(2),
 545         tkill(2) under SEE ALSO.
 546
 547 epoll_ctl.2
 548 epoll_create.2
 549     Marko Kohtala  / mtk
 550         Improved various error descriptions.
 551
 552 epoll_wait.2
 553     David Lloyd / Mike Frysinger, Marko Kohtala
 554         Added EINTR to errors.
 555
 556 fcntl.2
 557     Jamie Lokier / mtk
 558         Improved discussion of F_SETOWN and F_SETSIG with respect to
 559         multi-threaded programs.
 560         Generally cleaned up the discussion of F_SETOWN.
 561
 562         Updated CONFORMING TO to note that F_GETOWN and F_SETOWN are
 563         now in POSIX.
 564
 565 link.2
 566     mtk
 567         Noted discrepancy between Linux and POSIX.1 when oldpath
 568         is a symbolic link.
 569         See: http://bugs.linuxbase.org/show_bug.cgi?id=367
 570         and: http://www.opengroup.org/austin/mailarchives/ag/msg08152.html
 571
 572     Michael Haardt / mtk
 573         Clarified EXDEV error description: it isn't possible to link
 574         across mount points, even if the mount points refer to the same
 575         file system.
 576
 577 mincore.2
 578     mtk, after note from Gordon Jin
 579         Updated ERRORS.
 580
 581 pipe.2
 582     As per message from Serguei Leontiev
 583         Removed SVr2, AT&T, and BSD from CONFORMING TO, since
 584         a pipe on those systems is actually bidirectional.
 585         (Pipes are implemented as STREAMS on the former, and
 586         sockets on the latter.)
 587
 588 posix_fadvise.2
 589     mtk
 590         Noted kernel version where posix_fadvise() appeared and
 591         noted bug in handling of 'len' in kernels < 2.6.6.
 592
 593 rename.2
 594     Michael Haardt
 595         Clarified EXDEV error description: it isn't possible to rename
 596         a file across mount points, even if the mount points refer to
 597         the same file system.
 598
 599 semop.2
 600     mtk
 601         Noted kernel version numbers for semtimedop().
 602
 603 setitimer.2
 604     Matthias Lang, mtk
 605         Noted MAX_SEC_IN_JIFFIES ceiling.
 606         Added note about treatment of out-of-range tv_usec values.
 607
 608 sigqueue.2
 609     Johan Walles, Martin (Joey) Schulze
 610         Added sigqueue.2 to SEE ALSO.
 611
 612 times.2
 613     mtk
 614         Added notes on non-standard behavior: Linux allows 'buf' to
 615         be NULL, but POSIX.1 doesn't specify this and it's non-portable.
 616
 617 uselib.2
 618     Andries Brouwer
 619         Improved DESCRIPTION; clarified distinction between
 620         EACCES and ENOEXEC.
 621
 622 bcopy.3
 623     Heikki Orsila
 624         bcopy() handles overlapping case, but memcpy() does not,
 625         so for consistency memmove() should be also mentioned.
 626
 627 getmntent_r.3
 628     Martin (Joey) Schulze
 629         New link to man3/getmntent.3.
 630
 631 memcpy.3
 632     Small wording change after suggestion from Sasa Stevanovic.
 633
 634 strcasestr.3
 635     mtk
 636         Created as link to strstr.3.
 637
 638 strftime.3
 639     mtk
 640         Noted that SUSv2 allowed a range of 00 to 61 for %S specifier.
 641
 642 strstr.3
 643     mtk
 644         Added description of strcasestr().
 645
 646 random.4
 647     aeb
 648         Improved description of read from /dev/urandom.
 649
 650 st.4
 651     Kai Makisara
 652         Substantial updates.
 653
 654 man.7
 655     Martin Schulze
 656     Branden Robinson
 657     Colin Watson
 658         Mention the .URL macro more verbosely.
 659
 660
 661 ==================== Changes in man-pages-2.03 ====================
 662
 663 Released: 2005-06-02
 664
 665 Contributors
 666 ------------
 667
 668 The following people contributed notes, ideas, or patches that have
 669 been incorporated in changes in this release:
 670
 671 Andries Brouwer <Andries.Brouwer@cwi.nl>
 672 Joey (Martin) Schulze <joey@infodrom.org>
 673 Johannes Nicolai <johannes.nicolai@hpi.uni-potsdam.de>
 674 Justin Pryzby <justinpryzby@users.sourceforge.net>
 675 Klaus Ethgen <Klaus@Ethgen.de>
 676 Pavel Heimlich <tropikhajma@seznam.cz>
 677 Ross Boylan <RossBoylan@stanfordalumni.org>
 678 Vincent Fourmond <vincent.fourmond@9online.fr>
 679
 680 Apologies if I missed anyone!
 681
 682 Global changes
 683 --------------
 684
 685 console.4
 686 console_ioctl.4
 687 mouse.4
 688 tty.4
 689 vcs.4
 690     Pavel Heimlich
 691         Change `ttys(4)' to `ttyS(4)'.
 692
 693 Typographical or grammatical errors have been corrected in several
 694 places.
 695
 696 Changes to individual pages
 697 ---------------------------
 698
 699 clone.2
 700     mtk
 701         Substantially enhanced discussion of CLONE_THREAD.
 702
 703         Added CLONE_SYSVSEM, CLONE_UNTRACED, CLONE_STOPPED.
 704
 705         Other minor fixes.
 706
 707 execve.2
 708     aeb
 709         Noted effect of ptracing when execing a set-UID program.
 710
 711 fcntl.2
 712     Johannes Nicolai / mtk
 713         Noted F_SETOWN bug for socket file descriptor in Linux 2.4
 714         and earlier.
 715
 716         Added text on permissions required to send signal to owner.
 717
 718 flock.2
 719     mtk
 720         Noted that lock conversions are not atomic.
 721
 722 getrusage.2
 723     mtk
 724         ru_nswap has never contained useful information.
 725         Kernel 2.6.6 clarified that with a patch
 726         ("[PATCH] eliminate nswap and cnswap").  See also:
 727         http://www.ussg.iu.edu/hypermail/linux/kernel/0404.1/0720.html
 728
 729 kill.2
 730     mtk
 731         Clarified wording of the 'pid == -1' case.
 732
 733 mount.2
 734     mtk
 735         Added MNT_EXPIRE, plus a few other tidy-ups.
 736
 737 sched_setaffinity.2
 738     mtk
 739         Added text to note that sched_setaffinity() will migrate the
 740         affected process to one of the specified CPUs if necessary.
 741
 742         Added a NOTE to point out that the affinity mask is actually a
 743         per-thread attribute that can be adjusted independently for
 744         each thread in a thread group.
 745
 746 shmctl.2
 747     mtk
 748         Noted aberrant Linux behavior with respect to new attaches to a
 749         segment that has already been marked for deletion.
 750
 751         Noted changes in permissions required for SHM_LOCK/SHM_UNLOCK.
 752
 753 wait.2
 754     mtk
 755         Noted that the __W* flags can't be used with waitid().
 756
 757 confstr.3
 758     mtk
 759         Added _CS_GNU_LIBC_VERSION and _CS_GNU_LIBPTHREAD_VERSION.
 760
 761 hosts.5
 762     Ross Boylan / Martin Schulze
 763         various changes as per
 764         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=304242
 765
 766 proc.5
 767     mtk
 768         Minor changes to discussion of /proc/PID/stat signal fields.
 769         Added 'rt_priority' and 'policy' to /proc/PID/stat.
 770
 771 capabilities.7
 772     mtk
 773         1,$s/inherited/inheritable/g
 774
 775 regex.7
 776     Vincent Fourmond / Joey (Martin) Schulze
 777         Removed discussion of `[[:<:]]' and `[[:>:]]' since they do
 778         not seem to be in the glibc implementation.
 779         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295666
 780
 781 tzselect.8
 782     Joey (Martin) Schulze / Klaus Ethgen
 783         The default zoneinfo directory is now /usr/share/zoneinfo.
 784         (was: /usr/local/etc/zoneinfo)
 785         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=267471
 786
 787
 788 ==================== Changes in man-pages-2.04 ====================
 789
 790 Released: 2005-06-21
 791
 792 Contributors
 793 ------------
 794
 795 The following people contributed notes, ideas, or patches that have
 796 been incorporated in changes in this release:
 797
 798 Andries Brouwer <Andries.Brouwer@cwi.nl>
 799 Baurjan Ismagulov <ibr@ata.cs.hun.edu.tr>
 800 Dave Love <d.love@dl.ac.uk>
 801 Dieter Brueggemann <dieter.brueggemann@entitec.de>
 802 Geoff Clare <gclare@gclare.org.uk>
 803 Guido Trotter <ultrotter@debian.org>
 804 kabloom <kabloom@ucdavis.edu>
 805 Kevin Ryde <user42@zip.com.au>
 806 Justin Pryzby <justinpryzby@users.sourceforge.net>
 807 Mike Furr <mfurr@debian.org>
 808 Olivier Croquette <ocroquette@free.fr>
 809 Olivier Guilyardi <ylf@xung.org>
 810 Peter Cordes <peter@llama.nslug.ns.ca>
 811 Philipp Spitzer <philipp@toastfreeware.priv.at>
 812 Tanaka Akira <akr@m17n.org>
 813 Thierry Excoffier <exco@bat710.univ-lyon1.fr>
 814 Thomas Hood <jdthood@yahoo.co.uk>
 815 Vincent Lefevre <vincent@vinc17.org>
 816 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
 817
 818 Apologies if I missed anyone!
 819
 820 Global changes
 821 --------------
 822
 823 Various pages
 824     mtk
 825         For consistency across pages:
 826
 827             1,$s/nonzero/non-zero/g
 828
 829 Typographical or grammatical errors have been corrected in several
 830 places.
 831
 832
 833 New pages
 834 ---------
 835
 836 pthreads.7
 837     mtk
 838         An overview of the Linux implementations of POSIX threads.
 839
 840
 841 Changes to individual pages
 842 ---------------------------
 843
 844 _exit.2
 845     mtk
 846         Various minor changes.
 847
 848 epoll_ctl.2
 849     Mike Furr
 850         BUGS: In kernels < 2.6.9, EPOLL_CTL_DEL required a non-NULL
 851         'event', even though this argument is ignored.
 852         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306517
 853
 854 flock.2
 855     mtk / Kevin Ryde
 856         Clarified semantics of relationship between flock() locks
 857         and open file entries and file descriptors.
 858         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=291121
 859
 860 getitimer.2
 861     Olivier Croquette, Thierry Excoffier
 862         Noted the existence of the short sleep bug (up to 1 jiffy).
 863
 864 getrlimit.2
 865     mtk
 866         RLIMIT_RSS only has affect "in 2.4.x", not "in 2.4 and later".
 867
 868 getrusage.2
 869     Geoff Clare
 870         Since Linux 2.6, the ru_nvcsw and ru_nivcsw fields are used.
 871
 872 nice.2
 873     mtk / Guido Trotter
 874         Rewrote description of return value.
 875         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=296183
 876
 877 open.2
 878     Walter Harms
 879         O_DIRECT needs _GNU_SOURCE.
 880     mtk
 881         O_ASYNC works for pipes and FIFOs in Linux 2.6.
 882         Various minor fixes.
 883
 884 atexit.3
 885     mtk
 886         Various minor changes.
 887
 888 exit.3
 889     mtk
 890         Various minor changes.
 891
 892 getopt.3
 893     mtk / Philipp Spitzer
 894         Fix description of return value.
 895         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308359
 896
 897 hsearch.3
 898     mtk
 899         Changed (char *) to (void *) in example.
 900         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313607
 901
 902 log1p.3
 903     Justin Pryzby
 904         Make log(3) SEE ALSO log1p(3),
 905         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=309578
 906
 907 makecontext.3
 908     Tanaka Akira
 909         Fix description of RETURN VALUE for makecontext(),
 910         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311800
 911
 912 on_exit.3
 913     mtk
 914         Various minor changes.
 915
 916 rand.3
 917     kabloom
 918         Small fix to a code example,
 919         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=194842
 920
 921 realpath.3
 922     mtk / Thomas Hood
 923         When specifying resolved_path as NULL, realpath()
 924         will (still) only allocate up to PATH_MAX bytes.
 925         Plus other minor changes.
 926         See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239424
 927
 928 rcmd.3
 929     Dave Love
 930         The required header file for these functions on Linux is <netdb.h>,
 931         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311680
 932
 933 scanf.3
 934     Olivier Guilyardi
 935         Arg for %p is a pointer to _a pointer to_ void,
 936         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263109
 937
 938 stdin.3
 939     Vincent Lefevre
 940         freopen() can change the descriptors associated with
 941         stdin/stdout/stderr, as per
 942         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295859
 943
 944 strerror.3
 945     Baurjan Ismagulov
 946         strerror_r(3) requires #define _XOPEN_SOURCE 600,
 947         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=290880
 948
 949 sysconf.3
 950     Peter Cordes / mtk
 951         Fix typo: "_SC_2_DEV" should be "_SC_2_C_DEV".
 952
 953 proc.5
 954     mtk
 955         Added pointers under /proc/sys/net to tcp.7 and ip.7.
 956
 957 ip.7
 958     mtk
 959         Various wording and formatting fixes.
 960         Reordered /proc/sys/net/ipv4/ip_* file descriptions alphabetically.
 961
 962 tcp.7
 963     Dieter Brueggemann / mtk
 964         Fixes to the discussion of SIOCATMARK and tcp_stdurg.
 965     mtk
 966         Various wording and formatting fixes.
 967         Incorporated some new /proc/sys/net/ipv4/tcp_* file descriptions
 968         from the 2.6.12 source file Documentation/networking/ip-sysctl.txt.
 969
 970
 971 ==================== Changes in man-pages-2.05 ====================
 972
 973 Released: 2005-06-27
 974
 975 Contributors
 976 ------------
 977
 978 The following people contributed notes, ideas, or patches that have
 979 been incorporated in changes in this release:
 980
 981 A Costa <agcosta@gis.net>
 982 Andries Brouwer <Andries.Brouwer@cwi.nl>
 983 Bas Zoetekouw <bas@debian.org>
 984 Dan Jacobson <jidanni@jidanni.org>
 985 Delian Krustev <krustev@krustev.net>
 986 Dora Anna Volgyesi <volgyesi@elte.hu>
 987 Martin (Joey) Schulze <joey@infodrom.org>
 988 Ove Kaaven <ovek@arcticnet.no>
 989
 990 Apologies if I missed anyone!
 991
 992 Global changes
 993 --------------
 994
 995 Typographical or grammatical errors have been corrected in several
 996 places.  (Special thanks to A Costa.)
 997
 998
 999 Changes to individual pages
1000 ---------------------------
1001
1002 _exit.2
1003     mtk / aeb
1004         Reversed 2.04 introduction of the term "process termination
1005         function".
1006
1007 close.2
1008     mtk
1009         Clarified what type of lock close() affects.
1010         Minor formatting changes.
1011
1012 dup.2
1013     mtk
1014         Consistent use of terms "open file description",
1015         "file status flags", and "file descriptor flags".
1016         Removed mention of lock sharing -- it was not accurate.
1017         Minor formatting fixes.
1018
1019 fcntl.2
1020     mtk
1021         Consistent use of terms "open file description",
1022         "file status flags", and "file descriptor flags".
1023         Some rewriting of discussion of file descriptor flags
1024         Under F_DUPFD, replaced some text duplicated in dup.2
1025         with a cross ref to dup.2
1026         Minor wording and formatting fixes.
1027
1028 fpclassify.3
1029     mtk / Martin (Joey) Schulze / Bas Zoetekouw
1030         The return value of isinf() changed in glibc 2.02
1031         to differentiate positive and negative infinity.
1032         See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765
1033
1034 getgid.2
1035 getuid.2
1036     Delian Krustev
1037         Remove confusing text describing real and effective IDs.
1038         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285852
1039
1040 getitimer.2
1041     mtk
1042         The short sleep bug (up to 1 jiffy) that was newly noted in
1043         man-pages-2.04 has just been fixed in 2.6.12.
1044
1045 getpriority.2
1046     mtk
1047         Changed range documented in main text from -20..20 to -20..19.
1048         Noted that the range is -20..20 on some systems.
1049
1050 open.2
1051     mtk / aeb
1052         Clarification of term "open file description" along with
1053         explanation of what information it maintains.
1054         Other wording improvements.
1055         Various minor wording changes.
1056
1057 atexit.3
1058     mtk / aeb
1059         Reversed 2.04 introduction of the term "process termination
1060         function".
1061     mtk
1062         Noted use of atexit() for establishing function to be invoked on
1063         shared library unload.
1064         Noted that atexit()-registered functions are not invoked on
1065         abnormal termination.
1066         Formatting fixes.
1067
1068 exit.3
1069     mtk / aeb
1070         Reversed 2.04 introduction of the term "process termination
1071         function".
1072     mtk
1073         Minor rewording and formatting changes.
1074
1075 getloadavg.3
1076     mtk
1077         Added #define _BSD_SOURCE to prototype.
1078
1079 log2.3
1080     Martin (Joey) Schulze
1081         Add ERANGE error.
1082
1083 readdir.3
1084     mtk
1085         Added definition of Linux dirent structure.
1086         Some formatting cleanups.
1087
1088 strtod.3
1089     Dora Anna Volgyesi / mtk
1090         strtold() and strtof() need _ISOC99_SOURCE or _XOPEN_SOURCE=600
1091         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=246668
1092
1093 tdestroy.3
1094     mtk
1095         New link to tsearch.3.
1096
1097 tsearch.3
1098     mtk
1099         Added tdestroy to .TH line.
1100
1101 mem.4
1102     mtk
1103         Change "chown root:mem /dev/mem" to "chown root:kmem /dev/mem".
1104
1105 null.4
1106     mtk
1107         Change "chown root:mem /dev/null /dev/zero" to
1108         "chown root:root /dev/null /dev/zero".
1109
1110 vcs.4
1111     Dan Jacobson / Martin (Joey) Schulze
1112         Replaced "selection(1)" by "gpm(8)" under SEE ALSO
1113         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=253515
1114
1115 signal.7
1116     Ove Kaaven
1117         SA_SIGACTION should be SA_SIGINFO
1118         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=305369
1119
1120 urn.7
1121     mtk
1122         New link to uri.7
1123
1124
1125 ==================== Changes in man-pages-2.06 ====================
1126
1127 Released: 2005-07-15
1128
1129 Contributors
1130 ------------
1131
1132 The following people contributed notes, ideas, or patches that have
1133 been incorporated in changes in this release:
1134
1135 Alain Portal <aportal@univ-montp2.fr>
1136 Andries Brouwer <Andries.Brouwer@cwi.nl>
1137 Bhavesh P Davda <bhavesh@avaya.com>
1138 Clau Weber <claus@jambit.com>
1139 Dov Murik <dov@dv-networks.com>
1140 David Lloyd <dlloyd@microbits.com.au>
1141 Frederik Deweerdt <frederik.deweerdt@gmail.com>
1142 Justin Pryzby <justinpryzby@users.sourceforge.net>
1143 Lars Wirzenius <liw@iki.fi>
1144 Martin Pool <mbp@sourcefrog.net>
1145 Mike Frysinger <vapier@gentoo.org>
1146 Petter Reinholdtsen <pere@hungry.com>
1147 Steven Murdoch <Steven.Murdoch@cl.cam.ac.uk>
1148 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1149
1150 Apologies if I missed anyone!
1151
1152 Global changes
1153 --------------
1154
1155 Typographical or grammatical errors have been corrected in several
1156 places.
1157
1158 Many uses of hyphens and dashes were corrected.
1159
1160
1161 New pages
1162 ---------
1163
1164 canonicalize_file_name.3
1165     Walter Harms / mtk
1166
1167 Removed Pages
1168 -------------
1169
1170 sstk.2
1171     mtk
1172         AFAIK, this system call has never actually done anything (other
1173         than be a stub) on any Unix.
1174
1175 Changes to individual pages
1176 ---------------------------
1177
1178 accept.2
1179     mtk
1180         Various wording and formatting fixes.
1181
1182 bind.2
1183     mtk
1184         Minor formatting changes
1185
1186 clone.2
1187     mtk
1188         Various minor wording improvements; some formatting fixes
1189
1190 connect.2
1191     mtk
1192         Various wording and formatting fixes.
1193
1194 epoll_create.2
1195     Bhavesh P Davda
1196         s/positive/non-negative/      [for file descriptor]
1197
1198 getrlimit.2
1199     mtk
1200         Documented RLIMIT_MSGQUEUE limit.
1201         RLIMIT_RSS ceased to have any effect in 2.4 in kernel 2.4.30.
1202         (It already didn't have any effect in 2.2.x and 2.6.x.)
1203         s/MADVISE_WILLNEED/MADV_WILLNEED/
1204
1205 listen.2
1206     mtk
1207         Removed historic comment on BSD backlog ceiling.
1208         Minor wording and formatting changes.
1209
1210 semop.2
1211     mtk
1212         Added BUG: in some circumstances, a process that is
1213         waiting for a semaphore to become zero is not not woken
1214         up when the value does actually reach zero.
1215         http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2
1216         http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2
1217
1218 socket.2
1219     mtk
1220         Various minor wording improvements
1221
1222 umask.2
1223     mtk
1224         Added mkdir(2) to discussion, made term "file mode creation
1225         mask" clearer.
1226         Various, mostly small, wording changes
1227
1228 errno.3
1229     Martin Pool
1230         Change description for ESTALE
1231         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=237344
1232
1233 fgetgrent.3
1234 getgrent.3
1235 getgrent_r.3
1236     David Lloyd
1237         Added SEE ALSO putgrent(3)
1238         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=211336
1239
1240 getgrent.3
1241 getgrnam.3
1242 getpwent.3
1243 getpwnam.3
1244     Lars Wirzenius / mtk
1245         Replace mention of /etc/{passwd,group} by references to
1246         "passwd/group database", and LDAP and NIS.
1247         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
1248     mtk
1249         Miscellaneous wording improvements
1250         Consistent DESCRIPTION and ERRORS wording across these pages.
1251
1252 getnameinfo.3
1253     mtk
1254         Relocate misplaced text describing gai_strerror().
1255
1256 getnetent.3
1257     Petter Reinholdtsen
1258         s/endservent/endnetent/
1259         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316517
1260
1261 getspnam.3
1262     Lars Wirzenius / mtk
1263         Replace mention of /etc/shadow by references to
1264         "shadow password database", and LDAP and NIS.
1265         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
1266     mtk, Claus Weber
1267         Miscellaneous wording improvements
1268         Consistent DESCRIPTION wording vis-a-vis getpwnam.3 etc.
1269
1270 hsearch.3
1271     Frederik Deweerdt
1272         Fix hsearch_r() prototype
1273
1274 scanf.3
1275     Justin Pryzby / mtk
1276         Fix description of RETURN VALUE
1277         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=317037
1278     mtk
1279         various parts substantially rewritten; added description of
1280         %n$ form; various text incorporated from the GNU C library
1281         documentation ((C) The Free Software Foundation).
1282
1283 shm_open.3
1284     mtk
1285         Modified details of how user and group ownership of a new
1286         object are set.
1287         Various minor wording and formatting cleanups.
1288
1289 elf.5
1290     Mike Frysinger
1291         tweaked the short description to include definition of 'ELF'
1292         add ELFOSABI_NONE to the ELFOSABI_ list
1293         tweak/add more machines to EM_ list for ehdr->e_machine
1294         fix indenting to be consistent
1295         tweak the display of the ELF_ST_* macros
1296         document the Elf_Dyn structure
1297
1298 proc.5
1299     mtk
1300         Updated discussion of /proc/stat.
1301         Added text on the /proc/sys/fs/mqueue/* files.
1302
1303 ip.7
1304     Steven Murdoch
1305         Change protocol in UDP prototype.
1306         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182635
1307
1308 tcp.7
1309     Dov Murik
1310         The first sentence under NOTES about SO_KEEPALIVE and SIGPIPE
1311         makes no grammatical sense (and possibly also no technical sense).
1312         It has been removed.
1313
1314
1315 ==================== Changes in man-pages-2.07 ====================
1316
1317 Released: 2005-07-19
1318
1319 Contributors
1320 ------------
1321
1322 The following people contributed notes, ideas, or patches that have
1323 been incorporated in changes in this release:
1324
1325 Andries Brouwer <Andries.Brouwer@cwi.nl>
1326 Mike Frysinger <vapier@gentoo.org>
1327
1328 Apologies if I missed anyone!
1329
1330 Global changes
1331 --------------
1332
1333 Various pages
1334     mtk
1335         The terms "set-user-ID" and "set-group-ID" are now used
1336         consistently (no abbreviations) across all manual pages.
1337
1338 Various pages
1339     mtk
1340         Consistent use of "saved set-user-ID" and "saved set-group-ID"
1341         (no more "saved user ID", "saved effective UID",
1342         saved group ID", etc.)
1343
1344 Various pages
1345     mtk
1346         Global fixes in textual descriptions:
1347
1348             uid --> UID
1349             gid --> GID
1350             pid --> PID
1351             id --> ID
1352
1353 Various pages
1354     mtk
1355         Consistent use of st_atime, st_ctime, st_mtime, with
1356         explanatory text, instead of atime/ctime/mtime.
1357
1358 Various pages
1359     mtk
1360         Classical BSD versions are now always named x.yBSD (formerly
1361         there was a mix of x.yBSD and BSD x.y).
1362
1363 Typographical or grammatical errors have been corrected in several
1364 places.
1365
1366
1367 Changes to individual pages
1368 ---------------------------
1369
1370 setresuid.2
1371     mtk
1372         Some rewording.
1373
1374 stat.2
1375     Mike Frysinger
1376         Improve description of st_dev and st_rdev.
1377     mtk
1378         Various wording and formatting improvements.
1379
1380 truncate.2
1381     mtk
1382         Some formatting fixes
1383
1384
1385 ==================== Changes in man-pages-2.08 ====================
1386
1387 Released: 2005-09-21
1388
1389 Contributors
1390 ------------
1391
1392 The following people contributed notes, ideas, or patches that have
1393 been incorporated in changes in this release:
1394
1395 Adrian Bunk <bunk@stusta.de>
1396 Alain PORTAL <aportal@univ-montp2.fr>
1397 Andrew Pimlott <andrew@pimlott.net>
1398 Andries Brouwer <Andries.Brouwer@cwi.nl>
1399 Baurzhan Ismagulov <ibr@radix50.net>
1400 Bernhard R. Link <brlink@debian.org>
1401 Bodo Stroesser <bstroesser@fujitsu-siemens.com>
1402 David N. Welton <davidw@eidetix.com>
1403 Dov Murik <dov@dv-networks.com>
1404 Heikki Orsila <shd@modeemi.cs.tut.fi>
1405 Hasso Tepper <hasso@estpak.ee>
1406 Hrvoje Niksic <hniksic@xemacs.org>
1407 Justin Pryzby <justinpryzby@users.sourceforge.net>
1408 Ludovic Courtes <ludovic.courtes@laas.fr>
1409 Mike Frysinger <vapier@gentoo.org>
1410 Nicolas François <nicolas.francois@centraliens.net>
1411 Norbert Buchmuller <norbi.spam@nix.hu>
1412 Paul Brook <paul@nowt.org>
1413 Ramiro Aceves <ea1abz@gmail.com>
1414 Tommy Pettersson <ptp@lysator.liu.se>
1415 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1416
1417 Apologies if I missed anyone!
1418
1419 Global changes
1420 --------------
1421
1422 Various pages
1423     mtk
1424         RFC references are now always written as "RFC\ nnn"
1425         (not "RFC nnn" or "RFCnnn").
1426
1427 Typographical or grammatical errors have been corrected in several
1428 places.
1429
1430
1431 Changes to individual pages
1432 ---------------------------
1433
1434 du.1
1435     Mike Frysinger
1436         To get an effect like "-h", BLOCKSIZE must start with "human",
1437         not "HUMAN".
1438
1439 time.1
1440     Mike Frysinger
1441         s/standard output/standard error/
1442
1443 clone.2
1444     Paul Brook / mtk
1445         Fix small error in description of CLONE_PARENT_SETTID
1446
1447 connect.2
1448     Heikki Orsila
1449         Add EINTR error
1450         See http://lkml.org/lkml/2005/7/12/254
1451
1452 getpriority.2
1453     mtk
1454         Expanded discussion of relationship between user and kernel
1455         representations of the nice value.
1456
1457         Added discussion of RLIMIT_NICE and a cross reference to
1458         getrlimit.2 under the description of the EACCES error.
1459
1460         Noted 2.6.12 change in credentials checking for setpriority().
1461
1462 getrlimit.2
1463     mtk
1464         Added description of RLIMIT_RTPRIO
1465
1466         Added description of RLIMIT_NICE
1467
1468 mmap.2
1469     mtk
1470         Noted bug in MAP_POPULATE for kernels before 2.6.7.
1471
1472 mremap.2
1473     mtk
1474         Added _GNU_SOURCE to prototype.
1475         Rewrote description of MREMAP_MAYMOVE.
1476         Rewrote description of EAGAIN error.
1477         Added discussion of resizing of memory locks.
1478         Added entries to SEE ALSO.
1479         Some formatting fixes.
1480
1481 msgctl.2
1482     mtk
1483         Added IPC_INFO, MSG_INFO, MSG_STAT descriptions.
1484
1485 nanosleep.2
1486     Baurzhan Ismagulov
1487         Add to prototype: define _POSIX_C_SOURCE 199309
1488         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=314435
1489
1490 nice.2
1491     mtk
1492         Added sentence noting that range of the nice value is described
1493         in getpriority.2.
1494         Added cross-reference to setrlimit(2) for discussion on
1495         RLIMIT_NICE.
1496
1497 outb.2
1498     David N. Welton / Justin Pryzby / mtk
1499         Clarified the order of value and port arguments;
1500         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263756
1501
1502 pause.2
1503     mtk
1504         Added SEE ALSO for sigsuspend.2
1505         Some formatting fixes.
1506
1507 poll.2
1508     Tommy Pettersson
1509         nfds should be prototyped as nfds_t
1510         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=322934
1511
1512     mtk
1513         Some wording and formatting improvements.
1514
1515 prctl.2
1516     mtk
1517         Since kernel 2.6.13 PR_SET_DUMPABLE can also have the value 2.
1518
1519 rand.3
1520     Hrvoje Niksic / mtk
1521         Remove misleading text describing FreeBSD's sranddev() function.
1522         As per debian bug 328629
1523
1524 readv.2
1525     mtk / Walter harms
1526         Added LINUX NOTES on trickery performed by glibc when
1527         vector size exceeds IOV_MAX.
1528
1529         Formatting clean-ups.
1530
1531 remap_file_pages.2
1532     mtk
1533         Added text to note that start and size are both rounded downward.
1534
1535 sched_setparam.2
1536     mtk
1537         Modified discussion of privileges; added pointer to
1538         sched_setscheduler.2 for a discussion of privileges and
1539         resource limits.
1540
1541 sched_setscheduler.2
1542     mtk
1543         Modified discussion of privileges; added discussion of RLIMIT_RTPRIO.
1544
1545 semctl.2
1546     mtk
1547         Added IPC_INFO, SEM_INFO, SEM_STAT descriptions.
1548
1549 shmctl.2
1550     mtk
1551         Added IPC_INFO, SHM_INFO, SHM_STAT descriptions.
1552
1553 sigaction.2
1554     mtk
1555         Split sigpending(), sigprocmask(), and sigsuspend() out
1556         into separate new pages.
1557
1558         Other minor changes
1559
1560     mtk
1561         NOTES: described SA_NODEFER / sa_mask bug which was present in
1562                 all kernels up to and including 2.6.13.
1563         See http://marc.theaimsgroup.com/?l=linux-kernel&m=112360948603171&w=2
1564         and http://marc.theaimsgroup.com/?l=linux-kernel&m=112362164911432&w=2
1565         List:       linux-kernel
1566         Subject:    Signal handling possibly wrong
1567         From:       Bodo Stroesser
1568         Date:       2005-08-09 17:44:06
1569
1570 signal.2
1571     mtk
1572         Updated SEE ALSO to reflect splitting of sigaction.2 into
1573         sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2
1574
1575 sigpending.2
1576     mtk
1577         New page created by splitting out from sigaction.2
1578         Changed CONFORMING TO.
1579
1580 sigprocmask.2
1581     mtk
1582         New page created by splitting out from sigaction.2
1583         Added text on effect of NULL for 'set' argument.
1584         Added text noting effect of ignoring SIGBUS, SIGFPE, SIGILL,
1585                 and SIGSEGV.
1586         Noted that sigprocmask() can't be used in multithreaded process.
1587         Fixed EINVAL error diagnostic.
1588         Changed CONFORMING TO.
1589
1590 sigsuspend.2
1591     mtk
1592         New page created by splitting out from sigaction.2
1593         Added NOTES on usage.
1594         Added new text to DESCRIPTION.
1595         Changed CONFORMING TO.
1596
1597 stat.2
1598     Mike Frysinger
1599         Improve st_blocks description.
1600
1601 carg.3
1602     Ramiro Aceves / aeb
1603         Change:
1604                 One has carg(z) = atan(creal(z) / cimag(z))
1605         to:
1606                 One has tan(carg(z)) = cimag(z) / creal(z)
1607
1608         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=326720
1609
1610 cmsg.3
1611     mtk
1612         s/SOL_TCP/IPPROTO_TCP/          (POSIX standard name)
1613
1614 dlopen.3
1615     Alain Portal
1616         s/-nostartupfiles/-nostartfiles/
1617
1618 getaddrinfo.3
1619     mtk
1620         Nowadays (since 2.3.4) glibc only sets the first ai_canonname
1621         field if AI_CANONNAME was specified (the current behavior
1622         is all that SUSv3 requires).
1623
1624         1,$s/PF_/AF_/g
1625
1626         Added descriptions of AI_ALL, AI_ADDRCONFIG, AI_V4MAPPED,
1627         and AI_NUMERICSERV.
1628
1629         Some wording and formatting fixes.
1630
1631 getpwnam.3
1632     Bernhard R. Link / mtk
1633         Add NOTES text describing relationship of pw_dir and HOME and
1634         pointing out that applications should preferentially inspect HOME.
1635
1636 inet.3
1637     Mike Frysinger
1638         Mention "little endian" and "big endian".
1639         Added note about octal and hex interpretation of
1640              numbers-and-dots notation.
1641
1642 rpc.3
1643     mtk / Ludovic Courtes
1644         Commented out references to rpc_secure(3) -- we don't currently
1645         have such a page in the man-pages set.
1646         In response to http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=325115
1647
1648 setenv.3
1649     mtk
1650         glibc 2.3.4 fixed the "name contains '='" bug.
1651
1652 strnlen.3
1653     Mike Frysinger
1654         Added "#define _GNU_SOURCE" to prototype.
1655
1656 initrd.4
1657     Norbert Buchmuller / mtk
1658         Added text noting that the use or real-root-dev for changing
1659         the root device is obsolete, in favor of pivot root.
1660         (However, the page still needs to be rewritten to actually
1661         describe the pivot_root method...)
1662         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=323621
1663
1664 proc.5
1665     mtk
1666         Improve text describing /proc/sys/fs/mqueue/* files.
1667
1668         Describe /proc/sys/fs/suid_dumpable (new in 2.6.13).
1669
1670         Added placeholder mention of /proc/zoneinfo (new in 2.6.13).
1671         More needs to be said about this file.
1672
1673         Repaired earlier cut and paste mistake which resulted
1674         in part of the text of this page being duplicated.
1675
1676 utmp.5
1677     Mike Frysinger
1678         Added text on biarch details for ut_session and ut_tv.
1679
1680 capabilities.7
1681     mtk
1682         Added CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE.
1683
1684 ip.7
1685     mtk / Andrew Pimlott
1686         Add a couple of words to make it clear that port is a 16-bit number.
1687         Reformat long source lines (no text changed).
1688
1689         s/SOL_IP/IPPROTO_IP/            (POSIX standard name)
1690
1691     Hasso Tepper
1692         Fix discussion of IPC_RECVTTL / IP_TTL.
1693
1694 signal.7
1695     mtk
1696         Updated SEE ALSO to reflect splitting of sigaction.2 into
1697         sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2.
1698
1699 socket.7
1700     mtk
1701         Clarified details of use of SO_PEERCRED.
1702
1703 tcp.7
1704     mtk
1705         s/SOL_TCP/IPPROTO_TCP/          (POSIX standard name)
1706         s/SOL_IP/IPPROTO_IP/            (POSIX standard name)
1707
1708 udp.7
1709     mtk
1710         Added description of UDP_CORK socket option.
1711
1712         s/SOL_UDP/IPPROTO_UDP/          (POSIX standard name)
1713         s/SOL_IP/IPPROTO_IP/            (POSIX standard name)
1714
1715
1716 ==================== Changes in man-pages-2.09 ====================
1717
1718 Released: 2005-10-13
1719
1720 Contributors
1721 ------------
1722
1723 The following people contributed notes, ideas, or patches that have
1724 been incorporated in changes in this release:
1725
1726 Justin Pryzby <pryzbyj@justinpryzby.com>
1727 Peter Chubb <peterc@gelato.unsw.edu.au>
1728 Samuel Thibault <samuel.thibault@ens-lyon.org>
1729 Tomas Pospisek <tpo_deb@sourcepole.ch>
1730 Trond Myklebust <trond.myklebust@fys.uio.no>
1731
1732 Apologies if I missed anyone!
1733
1734 Global changes
1735 --------------
1736
1737 ptsname.3
1738 getpt.3
1739 unlockpt.3
1740 openpty.3
1741 posix_openpt.3
1742 grantpt.3
1743 pts.4
1744 tty_ioctl.4
1745     mtk
1746         Added SEE ALSO for new pty.7 page.
1747
1748 Typographical or grammatical errors have been corrected in several
1749 places.
1750
1751
1752 New pages
1753 ---------
1754
1755 pty.7
1756     mtk
1757         Overview of Unix 98 and BSD pseudo-terminals.
1758
1759
1760 Changes to individual pages
1761 ---------------------------
1762
1763 ldd.1
1764     mtk
1765         Remove "-V" option (fix from Fedora man-pages-2.07-7).
1766
1767 fcntl.2
1768     Peter Chubb / Trond Myklebust / mtk
1769         Since kernel 2.6.10, a read lease can only be placed on a
1770         file descriptor that is opened read-only.
1771         See the following LKML thread of Aug 2005
1772         ("fcntl(F GETLEASE) semantics??"):
1773         http://marc.theaimsgroup.com/?l=linux-kernel&m=112371777712197&w=2
1774         http://marc.theaimsgroup.com/?l=linux-kernel&m=112374818213000&w=2
1775         http://marc.theaimsgroup.com/?l=linux-kernel&m=112376335305284&w=2
1776         http://marc.theaimsgroup.com/?l=linux-kernel&m=112377294030092&w=2
1777
1778 mprotect.2
1779     mtk
1780         Add new text to ENOMEM error.
1781
1782 mremap.2
1783     mtk
1784         Added description of MREMAP_FIXED and 'new_address' argument
1785         under NOTES.
1786         Revised text of EINVAL error.
1787
1788 read.2
1789     Samuel Thibault / mtk
1790         read() can fail with EINVAL when using O_DIRECT
1791     mtk
1792         Added open(2) to SEE ALSO.
1793
1794 shmget.2
1795     mtk
1796         s/int/size_t/ for type of 'size' argument (fix from
1797         Fedora man-pages-2.07-7).
1798
1799 write.2
1800     Samuel Thibault / mtk
1801         write() can fail with EINVAL when using O_DIRECT
1802
1803 atanh.3
1804     mtk
1805         Fix: s/acosh/atanh/ (fix from Fedora man-pages-2.07-7).
1806
1807 fopen.3
1808     mtk
1809         Improved "a+" description (fix from Fedora man-pages-2.07-7).
1810
1811 getrpcent.3
1812     mtk
1813         s/getrpcent/setrpcent/ (fix from Fedora man-pages-2.07-7).
1814
1815 stdio.3
1816     mtk / Justin Pryzby
1817         Removed references to fropen() and fwopen(), which are
1818         BSDisms that don't appear in glibc.
1819         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=331174
1820
1821 strftime.3
1822     mtk
1823         Typo fix: %Ry ==> %Ey [SUSv3 mentions...] (fix from
1824         Fedora man-pages-2.07-7).
1825
1826 nsswitch.conf.5
1827     mtk
1828         s/network/networks/ (fix from Fedora man-pages-2.07-7).
1829
1830 proc.5
1831     mtk
1832         Added description of /proc/sys/vm/legacy_va_layout.
1833
1834 socket.7
1835     mtk
1836         Update description of SO_RCVLOWAT and SO_SNDLOWAT.
1837         (fix derived from Fedora man-pages-2.07-7).
1838
1839
1840 ==================== Changes in man-pages-2.10 ====================
1841
1842 Released: 2005-10-19
1843
1844 Global changes
1845 --------------
1846
1847 The changes in this release consist *solely* of formatting fixes, with
1848 the aim bringing greater consistency to the manual pages according to
1849 the following rules:
1850
1851 -- Function name references should *always* be followed by
1852    parentheses, "()" (possibly containing a manual page section
1853    number).
1854
1855 -- The parentheses following a function name should *not* be
1856    formatted.  Thus, for example, instead of:
1857
1858        .B name()
1859
1860    one should write:
1861
1862        .BR name ()
1863
1864 Much of the change was automated using two scripts:
1865 add_parens_for_own_funcs.sh and unformat_parens.sh.
1866 For the (possible) benefit of downstream manual page maintainers and
1867 translators, I have placed these scripts in a new subdirectory 'scripts'.
1868
1869 NOTE THE FOLLOWING POINTS WELL:
1870
1871 -- These scripts provide a computer-assisted solution to the above
1872    two goals.  However, they are not perfect, and their output should
1873    be scanned by a human.  (To see what changes the two scripts
1874    *would* make, without making them, use the "-n" command line option.)
1875
1876 -- The scripts do not fix all instances that violate the above rules:
1877    some manual fixes are required.  Two further scripts are provided
1878    to help find remaining instances of function names without
1879    following "()": find_dots_no_parens.sh and find_slashes_no_parens.sh.
1880
1881 The following changes were made:
1882
1883 -- add_parens_for_own_funcs.sh was applied to the pages in Sections
1884    2 and 3.
1885
1886 -- unformat_parens.sh was applied to pages in Sections 2, 3, 4, and 7
1887    (the only sections where such changes were required).
1888
1889 -- further changes (not so very many) were performed by hand.
1890    (found places to fix with the assistance of find_dots_no_parens.sh
1891    and find_slashes_no_parens.sh).
1892
1893
1894 ==================== Changes in man-pages-2.11 ====================
1895
1896 Released: 2005-10-24
1897
1898 Contributors
1899 ------------
1900
1901 The following people contributed notes, ideas, or patches that have
1902 been incorporated in changes in this release:
1903
1904 Alain PORTAL <aportal@univ-montp2.fr>
1905
1906 Apologies if I missed anyone!
1907
1908 Global changes
1909 --------------
1910
1911 Various pages
1912     mtk
1913         Most instances of the constant "NULL" are not formatted (bolded) in
1914         man pages, but a few are.  For consistency, formatting on "NULL" has
1915         been removed where it occurred.
1916
1917         Many minor formatting fixes were made.
1918
1919 Typographical or grammatical errors have been corrected in several
1920 places.
1921
1922
1923 Changes to individual pages
1924 ---------------------------
1925
1926 getrlimit.2
1927     mtk
1928         Added EINVAL error for rlim_cur > rlim_max when calling setrlimit().
1929
1930 path_resolution.2
1931     mtk
1932         Repaired discussion of capabilities and file system UID, which
1933         mistakenly had involved exec() in the discussion.
1934
1935 prctl.2
1936     mtk
1937         Removed text saying there is no library interface.  There
1938         is nowadays.
1939
1940 mkfifo.3
1941     mtk
1942         Minor change to RETURN VALUE text.
1943
1944 sk98lin.4
1945     Alain Portal
1946         Formatting fixes.
1947
1948 capabilities.7
1949     mtk
1950         Minor changes.
1951
1952
1953 ==================== Changes in man-pages-2.12 ====================
1954
1955 Released: 2005-10-31
1956
1957 Contributors
1958 ------------
1959
1960 The following people contributed notes, ideas, or patches that have
1961 been incorporated in changes in this release:
1962
1963 Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
1964 Andries Brouwer <Andries.Brouwer@cwi.nl>
1965 Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
1966 herbert <herbert@gondor.apana.org.au>
1967 Martin Landers <martin.landers@treibgut.net>
1968 Michael Benedict <benedict@starbak.net>
1969
1970 Apologies if I missed anyone!
1971
1972 Global changes
1973 --------------
1974
1975 Typographical or grammatical errors have been corrected in several
1976 places.
1977
1978
1979 Changes to individual pages
1980 ---------------------------
1981
1982 mlock.2
1983     mtk
1984         Reworded text around PAGESIZE, noting also that
1985         sysconf(_SC_PAGESIZE) can be used.
1986
1987 path_resolution.2
1988     mtk / aeb
1989         Removed words "as well" (added in 2.11) from the phrase
1990         "and it gets these last five capabilities if its fsuid is 0 as well"
1991         since there are (unusual) situations in which fsuid can be 0 while
1992         the effective UID is not.
1993
1994         Reworked (cut down) discussion of capabilities, moving part of
1995         it into capabilities.7
1996
1997 setresuid.2
1998     mtk
1999         Add text to note that setresuid() always modifies the file
2000         system UID, and setresgid() likewise always modifies the file
2001         system GID.
2002
2003 shmget.2
2004     mtk
2005         Added (brief) description of SHM_HUGETLB.
2006
2007 sigaltstack.2
2008     mtk / Martin Landers
2009         Noted that ss_sp is automatically aligned by the kernel.
2010
2011 byteorder.3
2012     Brian M. Carlson  / herbert
2013         Change <netinet/in.h> to <arpa/inet.h> in prototype; add text
2014         explaining that some systems need the former header.
2015         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=265244
2016
2017 capabilities.7
2018     mtk
2019         Reworked part of the discussion of exec() and capabilities.
2020         Added sub-section "Effect of User ID Changes on Capabilities".
2021         Reworked discussion of CAP_SYS_ADMIN and file-max.
2022
2023
2024 ==================== Changes in man-pages-2.13 ====================
2025
2026 Released: 2005-11-03
2027
2028 This release consists entirely of formatting and typographical fixes.
2029
2030 Global changes
2031 --------------
2032
2033 Typographical or grammatical errors have been corrected in several
2034 places.
2035
2036 Various pages
2037     mtk
2038         Function and page cross references that were italicized were
2039         made bold (which is how the majority of function and page
2040         cross references were already done).
2041
2042 Various pages
2043     mtk
2044         Instances of things like "NULL-terminated string" were changed to
2045         "null-terminated string".
2046
2047 Various pages
2048     mtk
2049         Pathnames, structures, arguments, and <header-files> that were
2050         bold were changed to italics.
2051
2052 Various pages
2053     mtk
2054         Instances of the constant "NULL" that were bold-faced were made
2055         unformatted (which is how most instances of "NULL" were already
2056         formatted.)
2057
2058
2059 ==================== Changes in man-pages-2.14 ====================
2060
2061 Released: 2005-11-17
2062
2063 Contributors
2064 ------------
2065
2066 The following people contributed notes, ideas, or patches that have
2067 been incorporated in changes in this release:
2068
2069 Angelo <ang3l0@katamail.com>
2070 Avery Pennarun <apenwarr@nit.ca>
2071 Justin Pryzby <justinpryzby@users.sourceforge.net>
2072 Martin (Joey) Schulze <joey@infodrom.org>
2073 Stefan Brüns <stefan.bruens@rwth-aachen.de>
2074 Volker Reichelt <reichelt@igpm.rwth-aachen.de>
2075
2076 Apologies if I missed anyone!
2077
2078 Global changes
2079 --------------
2080
2081 Typographical or grammatical errors have been corrected in several
2082 places.
2083
2084 New pages
2085 ---------
2086
2087 rexec.3
2088     mtk / Justin Pryzby
2089         This page is taken as is from the FreeBSD 5.4 distribution.
2090         (Not checked against Linux reality, but likely things are
2091         the same.)
2092         See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=336875
2093
2094 Changes to individual pages
2095 ---------------------------
2096
2097 arch_prctl.2
2098     mtk
2099         Updated discussion about lack of prototype in glibc.
2100
2101 execve.2
2102     mtk
2103         Improved description of E2BIG error: it relates to the sum
2104         of the bytes in both environment and argument list.
2105
2106 fcntl.2
2107     mtk
2108         Clarified parts of the discussion of file leases,
2109         noting effect of open(O_NONBLOCK), interruption
2110         by signal handler, or termination by signal in
2111         lease breaker.  In response to
2112         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=339037
2113
2114 stat.2
2115     mtk / Stefan Brüns
2116         Added LINUX NOTES describing nanosecond timestamps.
2117
2118 frexp.3
2119     Volker Reichelt / mtk
2120         Fixed to point out that that frexp() returns a number whose
2121         *absolute* value is >= 0.5 and < 1.  Amended the example
2122         program to demonstrate this.
2123
2124 open.2
2125     mtk / Avery Pennarun
2126         Add EWOULDBLOCK error for file leases.
2127         In response to
2128         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=339037
2129
2130 putenv.3
2131     mtk
2132         Although the glibc implementation returns -1 on error (and some
2133         other man pages (e.g., the BSDs) also document that value for
2134         error returns), SUSv3 merely says "non-zero" (and this is
2135         what manual pages on many implementations also say).
2136
2137 posix_memalign.3
2138     mtk
2139         Formerly, the page said that all systems declare memalign() in
2140         <malloc.h>.  In fact, many declare it in <stdlib.h>.
2141
2142 strtok.3
2143     mtk
2144         Almost a complete rewrite after Angelo pointed out
2145         that the existing page was deficient.
2146
2147 sd.4
2148     Martin Schulze
2149         Remove SEE ALSO for nonexistent scsi.4.
2150
2151 proc.5
2152     mtk
2153         Updated discussion of /proc/sys/kernel/pid_max.
2154
2155 signal.7
2156     mtk
2157         Added pthreads.7 to SEE ALSO.
2158
2159 ld.so.8
2160     mtk
2161         Fix typo: s/LD_DEBUG_OUTPUT/LD_PROFILE_OUTPUT/
2162
2163
2164 ==================== Changes in man-pages-2.15 ====================
2165
2166 Released: 2005-11-30
2167
2168 Contributors
2169 ------------
2170
2171 The following people contributed notes, ideas, or patches that have
2172 been incorporated in changes in this release:
2173
2174 Andries Brouwer <Andries.Brouwer@cwi.nl>
2175 James Vega <jamessan@debian.org>
2176 Malcolm Scott <mas90@io.malc.org.uk>
2177 Senthil Kumar <senthilkumar_sen@hotpop.com>
2178
2179 Apologies if I missed anyone!
2180
2181 Global changes
2182 --------------
2183
2184 Typographical or grammatical errors have been corrected in several
2185 places.
2186
2187 New pages
2188 ---------
2189
2190 sigvec.3 -- for details, see below.
2191
2192 sigset.3 -- for details, see below.
2193
2194 Changes to individual pages
2195 ---------------------------
2196
2197 kill.2
2198     mtk
2199         Added text describing the 2.6.[0-7] EPERM bug that occurred
2200         when sending signals to a process group.
2201
2202 sigaction.2
2203     mtk
2204         Noted that si_signo is unused on Linux.
2205
2206 sigpending.2
2207     mtk
2208         Added BUGS noting wrapper function problem that existed
2209         in glibc versions <= 2.2.1.
2210
2211 sigpause.2
2212     mtk
2213         Moved to section 3; see also sigpause.3 below.
2214
2215 sigsetops.3
2216     mtk
2217         Added a GLIBC NOTES section describing sigisemptyset(),
2218         sigandset(), and sigorset().
2219
2220 sigvec.2
2221 sigblock.2
2222     mtk
2223         These pages have been deleted, and replaced by a new sigvec.3
2224         man page that more fully describes the BSD signal API.
2225
2226 siggetmask.2
2227 sigmask.2
2228 sigsetmask.2
2229     mtk
2230         These links to the now-deleted sigblock.2 have been also been
2231         deleted.  They are replaced by corresponding links in Section 3:
2232         sigmask.3, sigsetmask.3, siggetmask.3.
2233
2234 sigvec.3
2235     mtk
2236         This new page is provides a fuller description of the
2237         BSD signal API than was provided in the now-deleted sigvec.2
2238         and sigblock.2.
2239
2240 sigblock.3
2241 siggetmask.3
2242 sigmask.3
2243 sigsetmask.3
2244     mtk
2245         Created as links to sigvec.3.
2246
2247 sigpause.3
2248     mtk
2249         Moved here from Section 2.
2250
2251         Some minor wording fixes; clarified System V origins of
2252         X/Open flavor of this function.
2253
2254 sigset.3
2255     mtk
2256         New page describing the System V signal API: sigset(), sighold(),
2257         sigrelse(), sigignore().
2258
2259 strftime.3
2260     James Vega
2261         Add further text clarifying that %+ specifier is not supported in
2262         glibc2.
2263     mtk
2264         Added GLIBC NOTES section describing optional 'flag' and 'width'
2265         components of conversion specifiers.
2266         Some wording changes to bring terminology closer to SUSv3.
2267         Added an example program.
2268
2269 vm86old.2
2270     mtk / aeb
2271         Add as new link to vm86.2.
2272
2273 intro.7
2274     mtk
2275         Added a few words to reflect the fact that several of the section
2276         7 pages provide overviews of various topics.
2277
2278 signal.7
2279     mtk
2280         Added some SEE ALSO entries.
2281
2282 socket.7
2283     Senthil Kumar / mtk
2284         Added text noting that select()/poll() do not respect SO_RCVLOWAT.
2285
2286 udp.7
2287     Malcolm Scott
2288         s/tcp_socket/udp_socket/ in example
2289         Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=340927
2290
2291
2292 ==================== Changes in man-pages-2.16 ====================
2293
2294 Released: 2005-12-02
2295
2296 Contributors
2297 ------------
2298
2299 The following people contributed notes, ideas, or patches that have
2300 been incorporated in changes in this release:
2301
2302 Alan Stern <stern@rowland.harvard.edu>
2303 Andries Brouwer <Andries.Brouwer@cwi.nl>
2304 Urs Thuermann <urs@isnogud.escape.de>
2305
2306 Apologies if I missed anyone!
2307
2308 Global changes
2309 --------------
2310
2311 Typographical or grammatical errors have been corrected in several
2312 places.
2313
2314
2315 Changes to individual pages
2316 ---------------------------
2317
2318 HOWTOHELP
2319     Urs Thuermann
2320         Added instructions for finding maintainer in Debian package.
2321
2322 poll.2
2323     mtk
2324         Added NOTES about INFTIM constant provided on some other
2325         implementations.
2326
2327 shmop.2
2328     Alan Stern
2329         The -1 error return of shmat() should be cast "(void *)".
2330
2331 strftime.3
2332     aeb
2333         Remove junk text (actually intended as source code comment
2334         in page).
2335
2336 ip.7
2337     Urs Thuermann
2338         Fix a typo: s/SOCK_RAW/SOCK_PACKET/
2339
2340 packet.7
2341     Urs Thuermann
2342         Clarification: s%SOCK_PACKET%PF_INET/SOCK_PACKET%
2343
2344
2345 ==================== Changes in man-pages-2.17 ====================
2346
2347 Released: 2005-12-13
2348
2349 Contributors
2350 ------------
2351
2352 The following people contributed notes, ideas, or patches that have
2353 been incorporated in changes in this release:
2354
2355 Justin Pryzby <justinpryzby@users.sourceforge.net>
2356 Michael Haardt <michael@moria.de>
2357 Urs Thuermann <urs@isnogud.escape.de>
2358 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2359
2360 Apologies if I missed anyone!
2361
2362
2363 Global changes
2364 --------------
2365
2366 Typographical or grammatical errors have been corrected in several
2367 places.
2368
2369
2370 New pages
2371 ---------
2372
2373 fmemopen.3
2374     Walter Harms / mtk
2375         New documentation for the glibc-specific fmemopen() and
2376         open_memstream().  Based on glibc info page.
2377
2378 pipe.7
2379     mtk (with prompting and suggestions for improvements by
2380     Michael Haardt)
2381         New page providing overview of pipes and FIFOs.
2382
2383
2384 Changes to individual pages
2385 ---------------------------
2386
2387 HOWTOHELP
2388     mtk
2389         Added notes on how to write example programs for manual pages.
2390
2391 fork.2
2392     mtk
2393         Added pointers to examples of fork() in wait.2 and pipe.2.
2394
2395 pipe.2
2396     mtk
2397         Added an example program.
2398         Added SEE ALSO for new pipe.7 page.
2399
2400 wait.2
2401     mtk
2402         Added example program demonstrating use of fork() and waitpid().
2403
2404 carg.3
2405     Justin Pryzby
2406         Delete line that should have been deleted when applying
2407         2.08 fix for this page.
2408
2409 getaddrinfo.3
2410     mtk
2411         Rearranged EAI_* list alphabetically.
2412
2413 inet.3
2414     mtk
2415         Added GLIBC NOTES describing feature test macros required
2416         to expose declaration of inet_aton().
2417
2418 open_memstream.3
2419     mtk
2420         New link to new fmemopen.3.
2421
2422 fifo.4
2423     mtk
2424         Added SEE ALSO for new pipe.7 page.
2425
2426 environ.5
2427     mtk
2428         Removed BROWSER, since it seems not in fact to be common.
2429
2430 socket.7
2431     Urs Thuermann
2432         Added documentation of SO_TIMESTAMP.
2433
2434 tcp.7
2435     mtk
2436         Noted 200 millisecond ceiling imposed on TCP_CORK.
2437
2438 udp.7
2439     mtk
2440         Rearranged options into something approximating alphabetical order.
2441
2442
2443 ==================== Changes in man-pages-2.18 ====================
2444
2445 Released: 2005-12-15
2446
2447 Contributors
2448 ------------
2449
2450 The following people contributed notes, ideas, or patches that have
2451 been incorporated in changes in this release:
2452
2453 Justin Pryzby <justinpryzby@users.sf.net>
2454 Karsten Sperling <karsten.sperling@stud.uni-karlsruhe.de>
2455 Martin (Joey) Schulze <joey@infodrom.org>
2456 Mike Frysinger <vapier@gentoo.org>
2457 Stefan Puiu <stefanpuiuro@yahoo.com>
2458
2459 Apologies if I missed anyone!
2460
2461
2462 Global changes
2463 --------------
2464
2465 Typographical or grammatical errors have been corrected in several
2466 places.
2467
2468
2469 Changes to individual pages
2470 ---------------------------
2471
2472 bind.2
2473     mtk
2474         Added mention of AF_INET6 address family.
2475         Added discussion of sockaddr structure and an example in the
2476         Unix domain.
2477
2478 recv.2
2479     mtk
2480         Put 'flags' list in alphabetical order.
2481
2482 send.2
2483     mtk
2484         Added cross-reference from discussion of MSG_MORE to UDP_CORK
2485         in udp(7).
2486
2487         Put 'flags' list in alphabetical order.
2488
2489 err.3
2490     mtk
2491         Added CONFORMING TO section noting that these are
2492         non-standard BSDisms.
2493
2494 errno.3
2495     Justin Pryzby
2496         Added SEE ALSO for err.3.
2497         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
2498
2499 gethostbyname.3
2500     Martin (Joey) Schulze / mtk
2501         Added references to nsswitch.conf(5); remove cross references
2502         to resolv+(8).
2503         See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308397
2504
2505 perror.3
2506     Justin Pryzby
2507         Added SEE ALSO for err.3 .
2508         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
2509
2510 resolver.3
2511     mtk / Martin (Joey) Schulze
2512         Remove cross references to resolv+(8); add cross references to
2513         resolv.conf(5).
2514         See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=214892
2515
2516         Added SEE ALSO entry for resolver(5);
2517         see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=251122
2518
2519 strerror.3
2520     mtk / Stefan Puiu
2521         Rewrote and extended the discussion of the two flavors of
2522         strerror_r(), and added some additional information on
2523         strerror().
2524     Justin Pryzby
2525         Added SEE ALSO for err.3, as per
2526         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
2527
2528
2529 elf.5
2530     Mike Frysinger
2531         Fix three typos in identifier names.
2532
2533 operator.7
2534     Karsten Sperling
2535         The + operator should be in the list of unary operators.
2536
2537 raw.7
2538     mtk
2539         Small wording changes around discussion of SO_BSDCOMPAT.
2540         Fixed a couple of wording errors elsewhere.
2541         Reformatted some long lines.
2542
2543 socket.7
2544     mtk, after a note by Stefan Puiu
2545         Updated discussion of SO_BSDCOMPAT.
2546
2547         Reformatted some long lines.
2548
2549         Noted the Linux-specific feature whereby setsockopt() doubles
2550         the value given for SO_SNDBUF and SO_RCVBUF.
2551
2552         Noted kernel-imposed minimum values for SO_SNDBUF and SO_RCVBUF.
2553
2554 udp.7
2555     mtk, after a note by Stefan Puiu
2556         Updated discussion of SO_BSDCOMPAT.
2557
2558 unix.7
2559     mtk
2560         Added new (UN)SUPPORTED FEATURES section in which it is noted
2561         that Unix domain sockets do not support MSG_OOB or MSG_MORE.
2562
2563         Noted details of SO_SNBUF and SO_RCVBUF support for
2564         Unix domain sockets.
2565
2566
2567 ==================== Changes in man-pages-2.19 ====================
2568
2569 Released: 2005-12-23
2570
2571 Contributors
2572 ------------
2573
2574 The following people contributed notes, ideas, or patches that have
2575 been incorporated in changes in this release:
2576
2577 Andries Brouwer <Andries.Brouwer@cwi.nl>
2578 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2579 Stefan Puiu <stefanpuiuro@yahoo.com>
2580
2581 Apologies if I missed anyone!
2582
2583
2584 Global changes
2585 --------------
2586
2587 Typographical or grammatical errors have been corrected in several
2588 places.
2589
2590
2591 Changes to individual pages
2592 ---------------------------
2593
2594 HOWTOHELP
2595     mtk
2596         Minor changes.
2597
2598 bind.2
2599     Stefan Puiu / mtk
2600         Remove text under EINVAL error: "This may change in the future:
2601         see linux/unix/sock.c for details."  This behavior has been
2602         unchanged for a long time, and seems unlikely to change.
2603
2604         Add EADDRINUSE to errors.
2605
2606 send.2
2607     aeb
2608         Add cmsg(3) to SEE ALSO.
2609
2610 fopen.3
2611     Walter Harms / mtk
2612         Added description of 'x' mode character (exclusive open).
2613
2614 pipe.7
2615     mtk / aeb
2616         Some wording changes to description of pipes.
2617
2618
2619 ==================== Changes in man-pages-2.20 ====================
2620
2621 Released: 2006-01-03
2622
2623 Global changes
2624 --------------
2625
2626 Typographical or grammatical errors have been corrected in several
2627 places.
2628
2629
2630 Changes to individual pages
2631 ---------------------------
2632
2633 sigaltstack.2
2634     mtk
2635         Added some text to explain the usual scenario in which
2636         sigaltstack() is employed.
2637
2638 getloadavg.3
2639     mtk
2640         Noted that this function is available since glibc 2.2.
2641
2642 strcpy.3
2643     mtk
2644         s/nulls/null bytes/
2645
2646 capabilities.7
2647     mtk
2648         Noted that capability bounding set appeared with kernel 2.2.11.
2649
2650 arp.7
2651 icmp.7
2652 ip.7
2653 ipv6.7
2654 netdevice.7
2655 packet.7
2656 raw.7
2657 rtnetlink.7
2658 socket.7
2659 tcp.7
2660 unix.7
2661 udp.7
2662     mtk
2663         The only changes to these pages have been for formatting:
2664             -- Structure definitions were changed to K&R style
2665             -- Some long source lines were broken to fit into ~70
2666                character lines.
2667         No changes were made to the content of these pages (yet...).
2668
2669
2670 ==================== Changes in man-pages-2.21 ====================
2671
2672 Released: 2006-01-16
2673
2674 Contributors
2675 ------------
2676
2677 The following people contributed notes, ideas, or patches that have
2678 been incorporated in changes in this release:
2679
2680 Andries Brouwer <Andries.Brouwer@cwi.nl>
2681 Falk Hueffner <falk@debian.org>
2682 Mike Frysinger <vapier@gentoo.org>
2683 Senthil Kumar <senthilkumar_sen@hotpop.com>
2684 Stefan Puiu <stefanpuiuro@yahoo.com>
2685
2686 Apologies if I missed anyone!
2687
2688
2689 Global changes
2690 --------------
2691
2692 dd.1 cp.1
2693 truncate.2 gethostname.2 lseek.2 listxattr.2 readlink.2
2694 sysfs.2 stat.2 ustat.2 uname.2 getdomainname.2
2695 argz_add.3 asprintf.3 confstr.3 bstring.3 bzero.3 dlopen.3 fwide.3
2696 gethostbyname.3 getline.3 getlogin.3 getnameinfo.3 getpass.3 hsearch.3
2697 perror.3 printf.3 readdir.3 scanf.3 stpcpy.3 strdup.3 strfmon.3
2698 strftime.3 string.3 strptime.3 sysconf.3 termios.3 ttyname.3
2699 dsp56k.4 tty_ioctl.4
2700 elf.5 proc.5 termcap.5
2701 charsets.7 unix.7
2702     mtk
2703         Various pages use inconsistent terms for 'null byte' (which
2704         is the C99/SUSv3 term for the '\0' character).
2705
2706         To rectify this the following changes were made in the above
2707         pages:
2708
2709             Replace 'zero byte' with 'null byte'.
2710             Replace 'null character' with 'null byte'.
2711             Replace 'nulls' with 'null bytes'.
2712             Replace 'NUL-terminated' by 'null-terminated'.
2713             Replace 'NUL' by 'null byte'.
2714             Replace 'terminating NUL' by 'terminating null byte'.
2715             Replace 'final NUL' by 'terminating null byte'.
2716             Replace 'NUL character' by 'null byte'.
2717
2718 Various pages
2719     mtk
2720         Replace "SysV"/"SYSV" by "System V".
2721
2722 Typographical or grammatical errors have been corrected in several
2723 places.
2724
2725
2726 Changes to individual pages
2727 ---------------------------
2728
2729 capget.2
2730     mtk
2731         Noted bug that could wrongly cause EPERM in unprivileged
2732         capset() with 'pid' field == getpid().
2733
2734 epoll_ctl.2
2735     mtk
2736         Noted that EPOLLONESHOT was added in 2.6.2.
2737
2738 gethostname.2
2739     mtk
2740         Added GLIBC NOTES describing operation of glibc's
2741         gethostname() wrapper function.
2742
2743 mmap.2
2744     mtk / Mike Frysinger
2745         Clarify relationship between mmap2(2) and mmap64(3).
2746     mtk
2747         A few other small rewordings.
2748
2749 mmap64.3
2750     Mike Frysinger
2751         New link to mmap.2.
2752
2753 open.2
2754     mtk
2755         Added BUG noting that O_ASYNC can't be enabled via
2756         open(): fcntl() must be used for this purpose.
2757
2758 recv.2
2759     Stefan Puiu
2760         Relocate misplaced discussion of MSG_DONTWAIT.
2761
2762 dlopen.3
2763     mtk
2764         Rewrote discussion of dlopen() 'flag' argument;
2765         added descriptions of RTLD_NOLOAD, RTLD_DELETE,
2766         and RTLD_DEEPBIND.
2767
2768         Noted use of atexit() to register a function that is
2769         automatically called when a library is unloaded.
2770
2771 fmemopen.3
2772     mtk
2773         Rewrote substantial parts of the page, and relicensed under GPL.
2774
2775 fseeko.3
2776     Mike Frysinger
2777         Add RETURN VALUE section.
2778
2779 getopt.3
2780     mtk
2781         Noted historical use of <stdio.h> to declare getopt().
2782
2783 qsort.3
2784     mtk / Falk Hueffner
2785         Clarify how strcmp() should be used as the 'compar'
2786         function by providing an example.
2787         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=348072
2788
2789 proc.5
2790     mtk
2791         Noted that /proc/mounts is pollable since kernel 2.6.15.
2792
2793         Documented /proc/PID/task.
2794
2795         Noted that the contents of /proc/PID/{cwd,exe,fd,root,task}
2796         are not available if the main thread has terminated.
2797
2798     Senthil Kumar
2799         Add pointer to random(4) for description of files under
2800         /proc/sys/kernel/random.
2801
2802 udp.7
2803     Stefan Puiu / mtk
2804         Small rewording of discussion of SO_BSDCOMPAT
2805         (add cross-ref to socket(7)).
2806
2807
2808 ==================== Changes in man-pages-2.22 ====================
2809
2810 Released: 2006-02-02
2811
2812 Contributors
2813 ------------
2814
2815 The following people contributed notes, ideas, or patches that have
2816 been incorporated in changes in this release:
2817
2818 Alain Portal <aportal@univ-montp2.fr>
2819 Andre Noll <maan@systemlinux.org>
2820 Andries Brouwer <Andries.Brouwer@cwi.nl>
2821 Colin Tuckley <colin@tuckley.org>
2822 Stefan Puiu <stefanpuiuro@yahoo.com>
2823 Thomas Hood <jdthood@yahoo.co.uk>
2824 Thorsten Kukuk <kukuk@suse.de>
2825 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2826
2827
2828 Global changes
2829 --------------
2830
2831 Typographical or grammatical errors have been corrected in several
2832 places.
2833
2834 Changes to individual pages
2835 ---------------------------
2836
2837 mmap.2
2838     aeb / mtk
2839         Noted that portable applications should specify fd as -1
2840         when using MAP_ANONYMOUS.
2841         Some rewriting of description of MAP_ANONYMOUS.
2842
2843 rt_sigreturn.2
2844     Thorsten Kukuk
2845         New link to sigreturn.2.
2846
2847 rt_sigsuspend.2
2848     mtk
2849         New link to sigsuspend.2.
2850
2851 waitid.2
2852     mtk
2853         Noted that waitid() does not set infop->si_uid field on
2854         most other implementations.
2855
2856 getopt.3
2857     Walter harms / mtk
2858         Make clear that when calling getopt_long() and there are no
2859         short options, then 'optstring' should be "", not NULL.
2860
2861 openpty.3
2862     Thomas Hood / mtk
2863         In glibc 2.0.92, openpty() was modified to preferably open
2864         Unix 98 ptys instead of BSD ptys.
2865
2866 qsort.3
2867     mtk
2868         Small rewording under EXAMPLES.
2869
2870 strtol.3
2871 strtoul.3
2872     Stefan Puiu
2873         s/string must begin/string may begin/
2874
2875 proc.5
2876     mtk
2877         Documented inotify files under /proc/sys/fs/inotify:
2878         max_queued_events, max_user_instances, and max_user_watches.
2879
2880
2881 ==================== Changes in man-pages-2.23 ====================
2882
2883 Released: 2006-02-10
2884
2885 Contributors
2886 ------------
2887
2888 The following people contributed notes, ideas, or patches that have
2889 been incorporated in changes in this release:
2890
2891 Andi Kleen <ak@muc.de>
2892 Britton Leo Kerin <bkerin_rb@letterboxes.org>
2893 Dan Jacobson <jidanni@jidanni.org>
2894 Justin Pryzby <justinpryzby@users.sourceforge.net>
2895 Luc Van Oostenryck <lkml@looxix.net>
2896 Kurt Wall <kwall@kurtwerks.com>
2897 Martin (Joey) Schulze <joey@infodrom.org>
2898 Matthias Andree <matthias.andree@gmx.de>
2899 Robert Love <rlove@rlove.org>
2900 Samuel Thibault <samuel.thibault@ens-lyon.org>
2901 Urs Thuermann <urs@isnogud.escape.de>
2902
2903 Apologies if I missed anyone!
2904
2905 Global changes
2906 --------------
2907
2908 Typographical or grammatical errors have been corrected in several
2909 places.
2910
2911
2912 New pages
2913 ---------
2914
2915 inotify_init.2
2916 inotify_add_watch.2
2917 inotify_rm_watch.2
2918     Robert Love, with some additions by mtk.
2919         New pages describing the inotify API.
2920
2921 mbind.2
2922 get_mempolicy.2
2923 set_mempolicy.2
2924     Andi Kleen, with additional work by mtk
2925         New pages describing the NUMA memory allocation policy API.
2926         Drawn from the set at ftp://ftp.suse.com/pub/people/ak/numa.
2927
2928 rtc.4
2929     Urs Thuermann, with additional work by mtk
2930         New page describing the real-time clock driver.
2931
2932 inotify.7
2933     mtk
2934         Overview of the inotify API.
2935
2936 Changes to individual pages
2937 ---------------------------
2938
2939 clone.2
2940     Andi Kleen
2941         On x86, clone() should not be called through vsyscall,
2942         but directly through "int $0x80".
2943
2944 fcntl.2
2945     mtk
2946         Small wording changes.
2947
2948         Added cross-ref to inotify.7 under the description of dnotify.
2949
2950 kill.2
2951     mtk / Britton Leo Kerin
2952         Small wording change under NOTES to clarify
2953         what happens when a process sends a signal to itself.
2954         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=350236
2955
2956 mlock.2
2957     mtk / Matthias Andree
2958         Added BUGS txt on interaction between MCL_FUTURE and
2959         RLIMIT_MEMLOCK.
2960         See the following LKML thread:
2961         http://marc.theaimsgroup.com/?l=linux-kernel&m=113801392825023&w=2
2962         "Rationale for RLIMIT_MEMLOCK"
2963
2964 msgop.2
2965     mtk / Samuel Thibault
2966         Rewrote declaration of 'msgp' to be "void *" in response
2967         to http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=350884
2968         Various other wording fixes.
2969
2970 open.2
2971     mtk
2972         Clarify distinction between "file creation flags" and
2973         "file status flags".
2974
2975 read.2
2976     Justin Pryzby
2977         Add SEE ALSO for pread(2).
2978         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351873
2979
2980 sched_setaffinity.2
2981     mtk
2982         Major rewrite.
2983
2984 select.2
2985     mtk
2986         Added return types to prototypes for FD_SET(), FD_CLR(),
2987         FD_ZERO, and FD_ISSET().
2988         Other minor wording changes.
2989
2990 read.2
2991     mtk
2992         Add SEE ALSO for pwrite(2).
2993         (Analogous with read.2 change above.)
2994
2995 errno.3
2996     Kurt Wall / mtk
2997         Add Linux specific errors to this page.
2998
2999 localeconv.3
3000     mtk
3001         Added cross-ref to locale.7 for 'struct lconv' defn.
3002         Other minor wording changes.
3003     Martin (Joey) Schulze
3004         Added SEE ALSO refs for nl_langinfo.3
3005         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351831
3006
3007 scanf.3
3008     mtk / Justin Pryzby
3009         Minor formatting & wording fixes.
3010
3011 setlocale.3
3012     Martin (Joey) Schulze
3013         Added SEE ALSO refs for nl_langinfo.3
3014         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351831
3015
3016 proc.5
3017     mtk
3018         Migrated description of inotify files to the new inotify.7 page.
3019
3020 ascii.7
3021     Dan Jacobson / mtk
3022         Add text describing characters 001 to 037.
3023         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=342173
3024
3025 locale.7
3026     mtk
3027         Minor wording and formatting changes.
3028
3029
3030 ==================== Changes in man-pages-2.24 ====================
3031
3032 Released: 2006-02-17
3033
3034 Contributors
3035 ------------
3036
3037 The following people contributed notes, ideas, or patches that have
3038 been incorporated in changes in this release:
3039
3040 Joerg Habenicht <habenich@planetserver.com>
3041 Luc Van Oostenryck <lkml@looxix.net>
3042 Mike Frysinger <vapier@gentoo.org>
3043 Samuel Thibault <samuel.thibault@ens-lyon.org>
3044
3045 Apologies if I missed anyone!
3046
3047
3048 New pages
3049 ---------
3050
3051 get_kernel_syms.2
3052 create_module.2
3053 delete_module.2
3054 init_module.2
3055 query_module.2
3056     FSF / mtk (with assistance of Luc Van Oostenryck)
3057         man-pages finally gets pages for these system calls, several
3058         of which are obsolete in Linux 2.6.
3059         Took the old GPLed pages dated 1996 and made a number of
3060         clean-ups and minor additions.
3061
3062
3063 Global changes
3064 --------------
3065
3066 various pages
3067     mtk
3068         Change "file name" to "filename"
3069         Change "path name" to "pathname"
3070
3071 stpncpy.3
3072 strstr.3
3073 strcmp.3
3074 toupper.3
3075 strlen.3
3076 stpcpy.3
3077 puts.3
3078 strdup.3
3079 strtok.3
3080 isalpha.3
3081 strspn.3
3082 gets.3
3083 strpbrk.3
3084     mtk after a suggestion from Samuel Thibault
3085         Added SEE ALSO pointers to wide character equivalent functions
3086         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351996
3087
3088 Typographical or grammatical errors have been corrected in several
3089 places.
3090
3091
3092 Changes to individual pages
3093 ---------------------------
3094
3095 clone.2
3096     mtk
3097         Remove duplicate CLONE_STOPPED text.
3098         Commented out crufty text describing EINVAL error
3099         for the now obsolete CLONE_DETACHED flag.
3100         Under CLONE_SIGHAND, noted that 'flags' must also include
3101         CLONE_VM if CLONE_SIGHAND is specified.
3102
3103 fcntl.2
3104     mtk
3105         Under ERRORS: Separate out EAGAIN error for locking mmaped files.
3106
3107 inotify_add_watch.2
3108     mtk
3109         Minor wording fix.
3110
3111 msgop.2
3112     mtk
3113         Documented the EAGAIN error for msgrcv().
3114
3115 fnmatch.3
3116     Mike Frysinger / mtk
3117         Expand explanation of FNM_PATHNAME.
3118
3119 lockf.3
3120     Joerg Habenicht / mtk
3121         Fix up discussion of EAGAIN/EACCESS errors.
3122
3123
3124 ==================== Changes in man-pages-2.25 ====================
3125
3126 Released: 2006-03-02
3127
3128 Contributors
3129 ------------
3130
3131 The following people contributed notes, ideas, or patches that have
3132 been incorporated in changes in this release:
3133
3134 James Peach <jpeach@samba.org>
3135 Krzysztof Benedyczak <golbi@mat.uni.torun.pl>
3136 Marten von Gagern <Martin.vGagern@gmx.net>
3137 Michael Haardt <michael@moria.de>
3138 Michael Wronksi <michal.wronski@gmail.com>
3139
3140 Apologies if I missed anyone!
3141
3142
3143 New pages
3144 ---------
3145
3146 mq_close.3
3147 mq_getattr.3
3148 mq_notify.3
3149 mq_open.3
3150 mq_receive.3
3151 mq_send.3
3152 mq_unlink.3
3153     mtk
3154         New pages describing POSIX message queue API.
3155
3156 posix_fallocate.3
3157     mtk, after a suggestion by James Peach
3158         New page describing posix_fallocate().
3159
3160 mq_overview.7
3161     mtk
3162         New page giving overview of the POSIX message queue API.
3163
3164
3165 Changes to individual pages
3166 ---------------------------
3167
3168 lseek.2
3169     Michael Haardt
3170         Add a case to the EINVAL error text.
3171     mtk
3172         Various minor wording fixes
3173         Added SEE ALSO referring to new posix_fallocate.3.
3174
3175 posix_fadvise.2
3176     mtk
3177         Added "#define _XOPEN_SOURCE 600" to prototype.
3178         Added SEE ALSO referring to new posix_fallocate.3.
3179
3180 proc.5
3181     mtk
3182         Migrated information on POSIX message queues to new mqueue.7 page.
3183
3184 inotify.7
3185     Marten von Gagern
3186         Fix thinko: s/assuming a non-blocking/assuming a blocking/
3187
3188
3189 ==================== Changes in man-pages-2.26 ====================
3190
3191 Released: 2006-03-21
3192
3193 Contributors
3194 ------------
3195
3196 The following people contributed notes, ideas, or patches that have
3197 been incorporated in changes in this release:
3198
3199 Alain Portal <aportal@univ-montp2.fr>
3200 Andi Kleen <ak@muc.de>
3201 Andries Brouwer <Andries.Brouwer@cwi.nl>
3202 Christoph Lameter <clameter@engr.sgi.com>
3203 Hasso Tepper <hasso@estpak.ee>
3204 Justin Pryzby <justinpryzby@users.sourceforge.net>
3205 Martin (Joey) Schulze <joey@infodrom.org>
3206 Nicolas François <nicolas.francois@centraliens.net>
3207 Paul Brook <paul@nowt.org>
3208 Siward de Groot <siward@wanadoo.nl>
3209 Steve Beattie <sbeattie@suse.de>
3210 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
3211
3212 Apologies if I missed anyone!
3213
3214 Global changes
3215 --------------
3216
3217 clone.2
3218 getdents.2
3219 gettid.2
3220 llseek.2
3221 mmap2.2
3222 modify_ldt.2
3223 pivot_root.2
3224 quotactl.2
3225 readdir.2
3226 sysctl.2
3227 syslog.2
3228 tkill.2
3229     mtk, aeb, Steve Beattie
3230         Added comment in SYNOPSIS to note that syscall(2) may be
3231         preferable over _syscallN (see intro(2)).
3232
3233 Various minor formatting changes were done on a range of
3234 pages in Section 7.  (No content was changed.)
3235
3236 New pages
3237 ---------
3238
3239 openat.2
3240     mtk
3241         New page describing openat(2), added in kernel 2.6.16,
3242         and some notes on rationale for the at*(2) system calls.
3243
3244 mbind.2
3245     Andi Kleen, Christoph Lameter, mtk
3246         Added MPOL_MF_MOVE and MPOL_MF_MOVE_ALL descriptions,
3247         from numactl-0.9.2 man page.
3248         Plus a few other smaller fixes.
3249
3250 fexecve.3
3251     mtk
3252         New page describing fexecve(3).
3253
3254 futimes.3
3255     mtk
3256         New page describing futimes(3).
3257
3258 Changes to individual pages
3259 ---------------------------
3260
3261 execve.2
3262     mtk
3263         Added SEE ALSO pointing to new fexecve.3.
3264
3265 intro.2
3266     mtk, aeb, Steve Beattie
3267         Added some notes on syscall(2) versus _syscall.
3268
3269 msgctl.2
3270 msgget.2
3271 msgop.2
3272     mtk
3273         Added SEE ALSO pointing to mq_overview.7.
3274
3275 open.2
3276     mtk
3277         Added SEE ALSO pointing to new openat.2.
3278
3279         Split out part of the RETURN VALUE text into separate
3280         NOTES section.
3281
3282         Modified wording referring to raw(8) to
3283         indicate that this interface is deprecated.
3284
3285 poll.2
3286     mtk
3287         Added discussion of ppoll(2), which is new in 2.6.16.
3288
3289 ppoll.2
3290     mtk
3291         New link to poll.2.
3292
3293 recvmsg.2
3294 sendmsg.2
3295     mtk / Paul Brook
3296         Added text to note that although POSIX says msg_controllen
3297         should be socklen_t, glibc actually uses size_t.
3298         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=356502
3299         and the associated glibc bug report.
3300         http://sourceware.org/bugzilla/show_bug.cgi?id=2448
3301     mtk
3302         Various formatting fixes.
3303
3304 select.2
3305     mtk
3306         Updated to reflect the fact that pselect() has been implemented
3307         in the kernel in 2.6.16; various other minor wording changes.
3308
3309         pselect() prototype needs "#define _XOPEN_SOURCE 600".
3310
3311 tempnam.3
3312     Justin Pryzby
3313         Clean up description of EEXIST error.
3314         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=357893
3315
3316 unlink.2
3317     mtk
3318         Added a little extra text to clarify EISDIR vs EPERM.
3319
3320 utime.2
3321     mtk
3322         Added new SEE ALSO entry pointing to new futimes.3 page.
3323
3324 exec.3
3325     mtk
3326         Added SEE ALSO pointing to new fexecve.3.
3327
3328 shm_unlink.3
3329     mtk
3330         New link to shm_open.3 (should have been made when page
3331         was originally written).
3332
3333 swab.3
3334     Walter Harms
3335         Add needed "#define _XOPEN_SOURCE".
3336
3337 undocumented.3
3338     mtk
3339         Updated to remove a few function names that are now documented.
3340
3341 capabilities.7
3342     mtk
3343         Various changes to bring this page closer to
3344         current kernel versions.
3345
3346 inotify.7
3347     mtk
3348         Noted that glibc 2.4 is required to get glibc support
3349         for inotify.
3350
3351 mq_overview.7
3352     mtk
3353         Some rewording and added a few words about System V
3354         message queues.
3355
3356 netlink.7
3357     Hasso Tepper
3358         Substantial updates to various parts of this page.
3359     mtk, Alain Portal
3360         Minor fixes
3361
3362 pthreads.7
3363     mtk
3364         Updated to reflect that the NPTL limitation that only the main
3365         thread could call setsid() and setpgid() was removed in 2.6.16.
3366
3367 raw.7
3368     Hasso Tepper
3369         Removed text implying that only in kernel 2.2 does IP_HDRINCL
3370         prevent datagrams from being fragmented.
3371
3372 socket.7
3373     mtk
3374         Documented SO_SNDBUFFORCE and SO_RCVBUFFORCE socket options,
3375         new in 2.6.14.
3376
3377         Placed socket options in alphabetical order.
3378
3379
3380 ==================== Changes in man-pages-2.27 ====================
3381
3382 Released: 2006-03-24
3383
3384 Contributors
3385 ------------
3386
3387 The following people contributed notes, ideas, or patches that have
3388 been incorporated in changes in this release:
3389
3390 Andries Brouwer <Andries.Brouwer@cwi.nl>
3391 Charles P. Wright <cwright@cs.sunysb.edu>
3392 Christoph Lameter <clameter@sgi.com>
3393 Chuck Ebbert <76306.1226@compuserve.com>
3394 Daniel Jacobowitz <dan@debian.org>
3395 Ingo Molnar <mingo@elet.hu>
3396 Heiko Carstens <heiko.carstens@de.ibm.com>
3397 Janak Desai <janak@us.ibm.com>
3398 Paolo (Blaisorblade) Giarrusso <blaisorblade@yahoo.it>
3399 Stefan Puiu <stefanpuiuro@yahoo.com>
3400
3401 Apologies if I missed anyone!
3402
3403
3404 Global changes
3405 --------------
3406
3407 man7/*
3408     mtk
3409         Various minor formatting changes were done on a range of
3410         pages in Section 7.  (No content was changed.)
3411
3412
3413 New pages
3414 ---------
3415
3416 unshare.2
3417     mtk, with reference to documentation by Janak Desai
3418         New page describing unshare(2), added in kernel 2.6.16.
3419
3420
3421 Changes to individual pages
3422 ---------------------------
3423
3424 clone.2
3425 fork.2
3426 vfork.2
3427     mtk
3428         Added SEE ALSO pointing to new unshare.2.
3429
3430 mbind.2
3431     Christoph Lameter
3432         MPOL_MF_MOVE_ALL requires CAP_SYS_NICE not CAP_SYS_RESOURCE.
3433
3434 mremap.2
3435     mtk
3436         Clarified the description of MREMAP_FIXED and restructured
3437         the text to reflect the fact that this flag is exposed
3438         by glibc since version 2.4.
3439
3440 ptrace.2
3441     Chuck Ebbert, with assistance from Daniel Jacobowitz,
3442     Paolo (Blaisorblade) Giarrusso, and Charles P. Wright;
3443     after a suggestion from Heiko Carstens.
3444         Document the following ptrace requests:
3445             PTRACE_SETOPTIONS (2.4.6)
3446                 plus associated flags:
3447                     PTRACE_O_TRACESYSGOOD (2.4.6)
3448                     PTRACE_O_TRACEFORK (2.5.46)
3449                     PTRACE_O_TRACEVFORK (2.5.46)
3450                     PTRACE_O_TRACECLONE (2.5.46)
3451                     PTRACE_O_TRACEEXEC (2.5.46)
3452                     PTRACE_O_TRACEVFORKDONE (2.5.60)
3453                     PTRACE_O_TRACEEXIT (2.5.60)
3454             PTRACE_SETSIGINFO (2.3.99-pre6)
3455             PTRACE_GETSIGINFO (2.3.99-pre6)
3456             PTRACE_GETEVENTMSG (2.5.46)
3457             PTRACE_SYSEMU (since Linux 2.6.14)
3458             PTRACE_SYSEMU_SINGLESTEP (since Linux 2.6.14)
3459
3460 sched_get_priority_max.2
3461 sched_setscheduler.2
3462 sched_setparam.2
3463     mtk, Ingo Molnar
3464         Modified to document SCHED_BATCH policy, new in kernel 2.6.16.
3465
3466         Text describing SCHED_BATCH was added to sched_setscheduler.2,
3467         and was drawn in part from Ingo Molnar's description in the
3468         mail message containing the patch that implemented this policy.
3469
3470         Various other minor rewordings and formatting fixes.
3471
3472 proc.5
3473     mtk, using text from Documentation/filesystems/proc.txt
3474         Document /proc/sys/vm/drop_caches, new in kernel 2.6.16.
3475     mtk, using information from ChangeLog-2.6.14.
3476         Document /proc/PID/smaps, new in kernel 2.6.14.
3477
3478 capabilities.7
3479     mtk
3480         Noted affect of CAP_SYS_NICE for mbind(MPOL_MF_MOVE_ALL).
3481
3482 pthreads.7
3483     mtk
3484         Kernel 2.6.16 eliminated buggy behavior with respect to
3485         the alternate signal stack.
3486
3487
3488 ==================== Changes in man-pages-2.28 ====================
3489
3490 Released: 2006-03-31
3491
3492 Contributors
3493 ------------
3494
3495 The following people contributed notes, ideas, or patches that have
3496 been incorporated in changes in this release:
3497
3498 Aleksandr Blokhin <sass@altlinux.ru>
3499 Greg Johnson <gjohnson@lanl.gov>
3500
3501 Apologies if I missed anyone!
3502
3503
3504 New pages
3505 ---------
3506
3507 sem_post.3
3508 sem_getvalue.3
3509 sem_close.3
3510 sem_open.3
3511 sem_destroy.3
3512 sem_wait.3
3513 sem_unlink.3
3514 sem_init.3
3515 sem_overview.7
3516     mtk
3517         New pages describing the POSIX semaphores API.
3518
3519         These pages supersede and provide a superset of the information
3520         in the glibc (3thr) "semaphores(3)" manual page.
3521
3522
3523 Changes to individual pages
3524 ---------------------------
3525
3526 ppoll.2
3527     Aleksandr Blokhin
3528         Fix broken link.
3529
3530 ptrace.2
3531     mtk
3532         Wrapped long lines (no content changes).
3533
3534 semctl.2
3535 semget.2
3536 semop.2
3537     mtk
3538         Add SEE ALSO pointing to the new sem_overview.7 page.
3539
3540 elf.5
3541     Greg Johnson
3542         Removed SEE ALSO reference to nonexistent core(5).
3543
3544
3545 ==================== Changes in man-pages-2.29 ====================
3546
3547 Released: 2006-04-06
3548
3549 Contributors
3550 ------------
3551
3552 The following people contributed notes, ideas, or patches that have
3553 been incorporated in changes in this release:
3554
3555 Michael Haardt <michael@moria.de>
3556 Roberto Jimenoca <robertojimenoca@terra.es>
3557 Stefan Puiu <stefanpuiuro@yahoo.com>
3558
3559 Apologies if I missed anyone!
3560
3561
3562 Global changes
3563 --------------
3564
3565 getrlimit.2
3566 prctl.2
3567 sigaction.2
3568 elf.5
3569 signal.7
3570     mtk
3571         Added SEE ALSO entry referring to new core.5 page.
3572
3573
3574 New pages
3575 ---------
3576
3577 mkdirat.2
3578     mtk
3579         New page describing mkdirat(2), new in 2.6.16.
3580
3581 mknodat.2
3582     mtk
3583         New page describing mknodat(2), new in 2.6.16.
3584
3585 core.5
3586     mtk
3587         New page describing core dump files.
3588
3589 mkfifoat.3
3590     mtk
3591         New page describing mkfifoat(3).
3592
3593
3594 Changes to individual pages
3595 ---------------------------
3596
3597 accept.2
3598 getpeername.2
3599 getsockname.2
3600     Michael Haardt / mtk
3601         Document EINVAL error for 'len' argument < 0.
3602
3603 fcntl.2
3604     mtk
3605         Expanded discussion of mandatory locking.
3606
3607 getrlimit.2
3608     mtk
3609         Added BUGS text on 2.6.x handling of RLIMIT_CPU limit
3610         of zero seconds.  See
3611         http://marc.theaimsgroup.com/?l=linux-kernel&m=112256338703880&w=2
3612
3613 mkdir.2
3614     mtk
3615         Added SEE ALSO entry referring to new mkdirat.2.
3616
3617 mknod.2
3618     mtk
3619         Added SEE ALSO entry referring to new mknodat.2.
3620
3621 open.2
3622     mtk / Roberto Jimenoca
3623         Clarified discussion of file types affected by O_NONBLOCK.
3624         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=360243
3625
3626 openat.2
3627     mtk
3628         Rewrote NOTES describing rationale for openat().
3629         Various other minor changes.
3630
3631 recv.2
3632     Stefan Puiu
3633         Removed a misleading cross-ref to socket.2.
3634
3635 shmop.2
3636     mtk
3637         Since 2.6.17-rc1, shmdt() gives the error EINVAL in a further
3638         circumstance: if shmaddr is not aligned on a page boundary.
3639
3640 unshare.2
3641     mtk
3642         Remove text saying that specifying invalid flags "is likely
3643         to cause compatibility problems" since the kernel now
3644         (2.6.17-rc1) contains an explicit check for invalid bits
3645         with a consequent EINVAL error.
3646
3647 mkfifo.3
3648     mtk
3649         Added SEE ALSO entry referring to new mkfifoat.3.
3650
3651 proc.5
3652     mtk
3653         Information on core_pattern and core_uses_pid has
3654         been migrated to the new core.5 page.
3655
3656 ip.7
3657     Stefan Puiu
3658         Removed paragraph referring to obsolete ipchains / ipfw(4).
3659
3660 sem_overview.7
3661     mtk
3662         Add SEE ALSO entry referring to pthreads.7.
3663
3664
3665 ==================== Changes in man-pages-2.30 ====================
3666
3667 Released: 2006-04-17
3668
3669 Contributors
3670 ------------
3671
3672 The following people contributed notes, ideas, or patches that have
3673 been incorporated in changes in this release:
3674
3675 Andre Lehovich <andrel@yahoo.com>
3676 Andries Brouwer <Andries.Brouwer@cwi.nl>
3677 Karel Kulhavy <clock@twibright.com>
3678 Stefan Puiu <stefanpuiuro@yahoo.com>
3679
3680 Apologies if I missed anyone!
3681
3682
3683 New pages
3684 ---------
3685
3686 linkat.2
3687     mtk
3688         New page describing linkat(), new in kernel 2.6.16
3689
3690 renameat.2
3691     mtk
3692         New page describing renameat(), new in kernel 2.6.16
3693
3694 symlinkat.2
3695     mtk
3696         New page describing symlinkat(), new in kernel 2.6.16
3697
3698 unlinkat.2
3699     mtk
3700         New page describing unlinkat(), new in kernel 2.6.16
3701
3702
3703 Changes to individual pages
3704 ---------------------------
3705
3706 link.2
3707     mtk
3708         Added SEE ALSO entry pointing to new linkat.2 page.
3709
3710 openat.2
3711     mtk
3712         Added SEE ALSO entries pointing to new *at.2 pages.
3713
3714 rename.2
3715     mtk
3716         Added SEE ALSO entry pointing to new renameat.2 page.
3717
3718 rmdir.2
3719     mtk
3720         Added SEE ALSO entry pointing to new unlinkat.2 page.
3721
3722 symlink.2
3723     mtk
3724         Added SEE ALSO entry pointing to new symlinkat.2 page.
3725
3726 unlink.2
3727     mtk
3728         Added SEE ALSO entry pointing to new unlinkat.2 page.
3729
3730 termios.3
3731     mtk / Karel Kulhavy
3732         Document the feature test macros required to expose various flags.
3733     Karel Kulhavy
3734         Clarify 'speed' argument for cfsetispeed() text.
3735     Karel Kulhavy / mtk
3736         Note that LOBLK is not implemented on Linux.
3737     mtk
3738         Clarify arguments for cfsetspeed().
3739         Various formatting changes.
3740
3741 full.4
3742     Andre Lehovich
3743         Add a sentence describing the purpose of full(4).
3744
3745 core.5
3746     aeb / mtk
3747         Rework text describing circumstances in which
3748         core dump files are not produced.
3749     mtk / Stefan Puiu
3750         A core dump of a multithreaded process always includes the
3751         PID in the core filename.
3752     mtk / Stefan Puiu
3753         Eliminate some accidentally duplicated text.
3754
3755
3756 ==================== Changes in man-pages-2.31 ====================
3757
3758 Released: 2006-05-02
3759
3760 Contributors
3761 ------------
3762
3763 The following people contributed notes, ideas, or patches that have
3764 been incorporated in changes in this release:
3765
3766 Joshua Kwan <joshk@triplehelix.org>
3767 Justin Pryzby <justinpryzby@users.sourceforge.net>
3768 Karel Kulhavy <clock@twibright.com>
3769 Mark Glines <mark@glines.org>
3770 Martin (Joey) Schulze <joey@infodrom.org>
3771 Nishanth Aravamudan <nacc@us.ibm.com>
3772 Reuben Thomas <rrt@sc3d.org>
3773 Ryan S. Arnold <rsa@us.ibm.com>
3774 Ulrich Drepper <drepper@redhat.com>
3775
3776 Apologies if I missed anyone!
3777
3778
3779 Page renamings
3780 --------------
3781
3782 The following pages have been relocated into section 7, since
3783 that is their more natural home.  SEE ALSO references in various
3784 other pages have been adjusted.
3785
3786 epoll.4
3787 fifo.4
3788 futex.4
3789 complex.5
3790 environ.5
3791         (many pages outside man-pages actually *expect*
3792         'environ' to be in Section 7.)
3793
3794 ipc.5
3795         renamed to svipc.7
3796
3797 ".so" link files have been created to link the old file locations to the
3798 new file locations.  These links are added just to ensure that cross
3799 references from any other (non-man-pages) pages will remain valid;
3800 eventually these links will be removed.
3801
3802
3803 New pages
3804 ---------
3805
3806 fstatat.2
3807     mtk
3808         New page for fstatat(2), new in 2.6.16.
3809
3810 adjtime.3
3811     mtk
3812         New page for adjtime(3).
3813
3814 error.3
3815     Justin Pryzby / mtk
3816         New page describing error() and error_at_line()
3817         Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=186307
3818
3819 program_invocation_name.3
3820     mtk
3821         New page describing program_invocation_name and
3822         program_invocation_short_name variables.
3823
3824 sockatmark.3
3825     mtk
3826         New page for sockatmark(3).
3827
3828 ftm.7
3829     mtk
3830         New page describing feature test macros.
3831
3832 time.7
3833     mtk
3834         New page giving an overview of "time" on Linux systems.
3835
3836
3837 Global changes
3838 --------------
3839
3840 getgroups.2
3841 wait4.2
3842 chown.2
3843 chdir.2
3844 gettimeofday.2
3845 initgroups.3
3846 dirfd.3
3847     mtk
3848         Simplified wording around requirement for _BSD_SOURCE
3849         feature test macro.
3850
3851 times.2
3852 time.2
3853 gettimeofday.2
3854 getitimer.2
3855 nanosleep.2
3856 ctime.3
3857 rtc.4
3858     mtk
3859         Added SEE ALSO referring to new time.7.
3860
3861 err.3
3862 errno.3
3863 perror.3
3864 strerror.3
3865     Justin Pryzby / mtk
3866         Add SEE ALSO referring to new error.3.
3867
3868 getdate.3
3869 printf.3
3870 scanf.3
3871     mtk
3872         Added SEE ALSO entry referring to setlocale.3.
3873
3874
3875 Changes to individual pages
3876 ---------------------------
3877
3878 accept.2
3879     Mark Glines
3880         Remove mention of SOCK_RDM from this page, since this socket
3881         type does not support accept()ing connections.
3882
3883 adjtimex.2
3884     mtk
3885         Modified text referring to adjtime(); added SEE ALSO for new
3886         adjtime.3 page.
3887
3888 fsync.2
3889     mtk, after a note by Karel Kulhavy
3890         Rewrote most of the DESCRIPTION, as well as some other parts
3891         the page, to clarify use and operation of, and rationale for,
3892         fsync(2) and fdatasync(2).
3893
3894 getitimer.2
3895     mtk
3896         Updated discussion of maximum timer value to reflect the fact
3897         that the default jiffy is now 4 milliseconds.
3898
3899         Added text to note that current incorrect behavior of
3900         normalizing tv_usec >= 1000000 will be repaired in a future
3901         kernel; applications should be fixed now.
3902
3903 gettimeofday.2
3904     Karel Kulhavy
3905         Point out more explicitly that 'tz' argument should
3906         normally be NULL.
3907     mtk
3908         Various other minor edits and formatting fixes.
3909
3910 mount.2
3911     mtk
3912         Since kernel 2.6.16, MS_NOATIME and MS_NODIRATIME are settable
3913         on a per-mount basis.
3914         Detail exactly which mount flags can be changed on MS_REMOUNT.
3915
3916 nanosleep.2
3917     mtk / Karel Kulhavy
3918         Clarify RETURN VALUE discussion.
3919
3920 openat.2
3921     mtk
3922         Add SEE ALSO reference pointing to new fstatat.2.
3923
3924 program_invocation_short_name.3
3925     mtk
3926         New link to new program_invocation_name.3.
3927
3928 recv.2
3929     mtk
3930         Added SEE ALSO for new sockatmark.3.
3931
3932 rmdir.2
3933     Joshua Kwan / Martin (Joey) Schulze / mtk
3934         Correct wording of EBUSY case.
3935     mtk
3936         Add ".." case to ENOTEMPTY error
3937
3938 select.2
3939     Karel Kulhavy
3940         Note more clearly that fd_set arguments can be NULL.
3941     mtk / Karel Kulhavy
3942         Improve opening paragraph describing purpose of select().
3943     mtk
3944         Various other minor edits and formatting fixes.
3945
3946 semget.2
3947     mtk / Nishanth Aravamudan
3948         Add text to noting that the initial values of semaphores
3949         in a new set are indeterminate.
3950
3951 shmget.2
3952     mtk
3953         Add text noting that contents of newly created segment are zero
3954         values.
3955
3956 sigwaitinfo.2
3957     mtk
3958         Noted that all threads should block signal being waited for.
3959
3960 stat.2
3961     Nishanth Aravamudan / mtk
3962         Added NOTE that st_size is always returned as zero for most
3963         /proc files.
3964     mtk
3965         Add SEE ALSO reference pointing to new fstatat.2.
3966
3967 syscall.2
3968     Justin Pryzby / mtk
3969         Remove bogus BUGS text.
3970
3971 utime.2
3972     mtk
3973         Various minor changes.
3974
3975 confstr.3
3976     mtk
3977         Rewrote RETURN VALUE discussion.
3978         Updated CONFORMING TO.
3979         Removed BUGS.
3980
3981 ctanh.3
3982     Martin (Joey) Schulze / mtk
3983         Fix errors in DESCRIPTION.
3984
3985 ctime.3
3986     mtk
3987         The range of tm_sec is 0..60 (not 0..61).
3988
3989 error_at_line.3
3990 error_message_count.3
3991 error_on_per_line.3
3992 error_print_progname.3
3993     mtk
3994         New links to new error.3.
3995
3996 fmemopen.3
3997     mtk / Ryan S. Arnold
3998         Add text noting that explicitly controlling output buffering
3999         may be useful to catch errors on output operations on an
4000         fmemopen() stream.
4001
4002 getline.3
4003     Justin Pryzby
4004         Add SEE ALSO pointing to getline.3.
4005         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=364772
4006
4007 strtod.3
4008 strtoul.3
4009     mtk
4010         Describe correct handling of errno in order to
4011         distinguish error from success after the call.
4012
4013         Added EXAMPLE section which points to strtol.3 which provides
4014         an example of the use of the analogous strtol(3).
4015
4016 strtol.3
4017     mtk / Justin Pryzby
4018         Add an example program.
4019     mtk
4020         Describe correct handling or errno in order to
4021         distinguish error from success after the call.
4022
4023 tmpfile.3
4024     Reuben Thomas
4025         DESCRIPTION does not need to say "temporary file name"
4026         just "temporary file", since the name is in any case
4027         unavailable to the user.
4028         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=363518
4029     mtk
4030         In DESCRIPTION:
4031         Change /automatically deleted when the program terminates normally/
4032         to     /automatically deleted when the program terminates/
4033         since deletion occurs on both normal and abnormal termination.
4034
4035 ip.7
4036     Karel Kulhavy / mtk
4037         Various wording improvements and clarifications.
4038
4039 signal.7
4040     mtk / Ulrich Drepper
4041         Add text noting that a signal's disposition is process-wide,
4042         shared by all threads.
4043     mtk
4044         Add text on changing signal dispositions.
4045         Add text on "signal mask and pending signals".
4046         Other minor edits.
4047
4048 time.7
4049     mtk
4050         Added SEE ALSO for new adjtime.3.
4051
4052 ld.so.8
4053     Justin Pryzby
4054         Remove bogus duplicate line.
4055
4056
4057 ==================== Changes in man-pages-2.32 ====================
4058
4059 Released: 2006-05-13
4060
4061 Contributors
4062 ------------
4063
4064 The following people contributed notes, ideas, or patches that have
4065 been incorporated in changes in this release:
4066
4067 Andries Brouwer <Andries.Brouwer@cwi.nl>
4068 Johannes Weiner <root@hnaz.ath.cx>
4069 Justin Pryzby <justinpryzby@users.sourceforge.net>
4070 Karel Kulhavy <clock@twibright.com>
4071 Paul Brook <paul@nowt.org>
4072 Pavel Heimlich <tropikhajma@seznam.cz>
4073
4074 Apologies if I missed anyone!
4075
4076
4077 New pages
4078 ---------
4079
4080 faccessat.2
4081     mtk
4082         New page for faccessat(2), new in 2.6.16.
4083
4084 fchmodat.2
4085     mtk
4086         New page for fchmodat(2), new in 2.6.16.
4087
4088 fchownat.2
4089     mtk
4090         New page for fchownat(2), new in 2.6.16.
4091
4092 futimesat.2
4093     mtk
4094         New page for futimesat(2), new in 2.6.16.
4095
4096
4097 Changes to individual pages
4098 ---------------------------
4099
4100 access.2
4101     mtk
4102         Add SEE ALSO reference pointing to new faccessat.2 page.
4103
4104 capget.2
4105     mtk
4106         Reworded to reflect that capabilities are per-thread.
4107
4108 chmod.2
4109     mtk
4110         Add SEE ALSO reference pointing to new fchmodat.2 page.
4111
4112 chown.2
4113     mtk
4114         Add SEE ALSO reference pointing to new fchownat.2 page.
4115
4116 mmap.2
4117     mtk
4118         Updated discussion of MAP_NORESERVE since it is no longer
4119         restricted to MAP_PRIVATE mappings.
4120         Add reference to discussion of /proc/sys/vm/overcommit_memory
4121         in proc.5.
4122
4123 openat.2
4124     mtk
4125         Add SEE ALSO reference pointing to new faccessat.2, fchmodat.2,
4126         fchownat.2, futimesat.2 pages.
4127
4128 shmget.2
4129     mtk
4130         Document SHM_NORESERVE flag, new in 2.6.15.
4131
4132 truncate.2
4133     Paul Brook / mtk
4134         Expand text noting that ftruncate()/truncate() may fail if
4135         asked to extend a file beyond its current length.
4136         Add EPERM error.
4137
4138 utime.2
4139     mtk
4140         Add SEE ALSO reference pointing to new futimesat.2 page.
4141
4142 fopen.3
4143     Justin Pryzby / mtk
4144         Document 'm' (mmap) flag.
4145         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=365754
4146     mtk
4147         Document 'c' (notcancel) flag.
4148
4149 futimes.3
4150     mtk
4151         Add SEE ALSO reference pointing to new futimesat.2 page.
4152
4153 qsort.3
4154     Johannes Weiner
4155         Add missing "const" qualifies to cast in EXAMPLE.
4156     mtk
4157         Slight rewording of comments in EXAMPLE.
4158
4159 termios.3
4160     Karel Kulhavy
4161         Clarify meaning of IXANY.
4162         Clarify relationship of MIN with VMIN and TIME with VTIME.
4163     mtk
4164         Noted that CIBAUD, OFDEL, and DELECHO are not implemented
4165         on Linux.
4166         Added explanatory paragraph for phrases "not in POSIX" and
4167         "XSI".
4168
4169 capabilities.7
4170     mtk
4171         Reworded to reflect that capabilities are per-thread.
4172         Add ioprio_set() to list of operations permitted by
4173         CAP_SYS_NICE.
4174         Add ioprio_set() IOPRIO_CLASS_RT and IOPRIO_CLASS_IDLE
4175         scheduling classes to list of operations permitted by
4176         CAP_SYS_ADMIN.
4177         Note effects of CAP_SYS_NICE for migrate_pages().
4178
4179
4180 ==================== Changes in man-pages-2.33 ====================
4181
4182 Released: 2006-05-23
4183
4184 Contributors
4185 ------------
4186
4187 The following people contributed notes, ideas, or patches that have
4188 been incorporated in changes in this release:
4189
4190 Andries Brouwer <Andries.Brouwer@cwi.nl>
4191 Justin Pryzby <justinpryzby@users.sourceforge.net>
4192 Martin Osvald" <martin.osvald@gmail.com>
4193 Stefan Puiu <stefanpuiuro@yahoo.com>
4194
4195 Apologies if I missed anyone!
4196
4197
4198 Page renamings
4199 --------------
4200
4201 ftm.7
4202     mtk / Stefan Puiu
4203         renamed to the more suggestive feature_test_macros.7
4204
4205
4206 New pages
4207 ---------
4208
4209 mq_getsetattr.2
4210     mtk
4211         New page briefly describing mq_getsetattr(2), the system
4212         call that underlies mq_setattr(3) and mq_getattr(3).
4213
4214 rpmatch.3
4215     Justin Pryzby / mtk
4216         New page for rpmatch(3).
4217
4218
4219 Changes to individual pages
4220 ---------------------------
4221
4222 chmod.2
4223     mtk
4224         Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
4225         POSIX does now document ELOOP.
4226
4227 open.2
4228     mtk
4229         Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
4230
4231 mmap.2
4232     Justin Pryzby
4233         Add mincore(2) to SEE ALSO.
4234         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367401
4235
4236 msync.2
4237     Justin Pryzby
4238         Note that EINVAL can also be caused by
4239         flags == MS_SYNC | MS_ASYNC.
4240
4241 sched_setaffinity.2
4242     mtk
4243         Add CPU_ISSET, CPU_CLR, CPU_SET, CPU_ZERO to NAME section.
4244
4245 select.2
4246     mtk
4247         Various minor changes.
4248
4249 select_tut.2
4250     mtk
4251         Removed much material that is redundant with select.2.
4252         Various other changes.
4253
4254 umask.2
4255     mtk
4256         Substantial rewrite of description of 'mask'.
4257
4258 CPU_ISSET.3
4259 CPU_CLR.3
4260 CPU_SET.3
4261 CPU_ZERO.3
4262     mtk
4263         New links to sched_setaffinity.2
4264
4265 FD_CLR.3
4266 FD_ISSET.3
4267 FD_SET.3
4268 FD_ZERO.3
4269     mtk
4270         New links to select.2.
4271
4272 fts.3
4273     Justin Pryzby
4274         Add SEE also referring to ftw.3.
4275
4276 ftw.3
4277     Justin Pryzby
4278         Add SEE also referring to fts.3.
4279
4280 getline.3
4281     Justin Pryzby
4282         Various minor clarifications.
4283
4284 mkstemp.3
4285     mtk
4286         Clarify that O_EXCL is an open(2) flag.
4287
4288 mq_open.3
4289     Martin Osvald
4290         Fix prototype declaration for 'attr'.
4291
4292 mq_notify.3
4293     Martin Osvald
4294         s/sigev_signal/sigev_signo/
4295
4296 mq_setattr.3
4297     mtk
4298         New link to mq_getattr.3.
4299
4300 mq_timedreceive.3
4301     mtk
4302         New link to mq_receive.3.
4303
4304 mq_timedsend.3
4305     mtk
4306         New link to mq_send.3.
4307
4308 setlocale.3
4309     Justin Pryzby
4310         Added SEE ALSO referring to rpmatch.3.
4311
4312 sigandset.3
4313 sigisemptyset.3
4314 sigorset.3
4315     mtk
4316         New links to sigsetops.3.
4317
4318 stdio.3
4319     Justin Pryzby
4320         Added SEE ALSO referring to unlocked_stdio.3
4321         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367667
4322
4323 strchr.3
4324     Justin Pryzby
4325         Add description of strchrnul().
4326
4327 strchrnul.3
4328     mtk
4329         New link to strchr.3.
4330
4331 undocumented.3
4332     Justin Pryzby / mtk
4333         Updated to remove some functions that don't exist, and
4334         therefore don't need to be documented.
4335         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367671
4336
4337 unlocked_stdio.3
4338     Justin Pryzby
4339         Added SEE ALSO referring to stdio.3
4340         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367667
4341
4342 mq_overview.7
4343     mtk
4344         Added section describing relationship between library
4345         interfaces and system calls.
4346         Added SEE ALSO referring to new mq_getsetattr.2.
4347
4348 feature_test_macros.7
4349     Stefan Puiu
4350         Fix typo: s/_POSIX_C_SOURCE/_POSIX_SOURCE/
4351
4352
4353 ==================== Changes in man-pages-2.34 ====================
4354
4355 Released: 2006-06-20
4356
4357 Contributors
4358 ------------
4359
4360 The following people contributed notes, ideas, or patches that have
4361 been incorporated in changes in this release:
4362
4363 Aristeu Sergio Rozanski Filho <aris@cathedrallabs.org>
4364 bert hubert <bert.hubert@netherlabs.nl>
4365 Chris Curtis <chris.curtis@riptidesoftware.com>
4366 Eduardo Madeira Fleury <efleury@br.ibm.com>
4367 Joerg Scheurich <rusmufti@helpdesk.bera.rus.uni-stuttgart.de>
4368 Justin Pryzby <justinpryzby@users.sf.net>
4369 Kenichi Okuyama <okuyama.kenichi@oss.ntt.co.jp>
4370 Marc Lehmann <debian-reportbug@plan9.de>
4371 Martin (Joey) Schulze <joey@infodrom.org>
4372 Mats Wichmann <mats.d.wichmann@intel.com>
4373 Mike Frysinger <vapier@gentoo.org>
4374 Peter Eiserloh <eiserlohpp@yahoo.com>
4375 Stefan Puiu <stefanpuiuro@yahoo.com>
4376 Thomas Dickey <dickey@radix.net>
4377 Walter Harms <wharms@bfs.de>
4378
4379 Apologies if I missed anyone!
4380
4381
4382 Global changes
4383 --------------
4384
4385 tzselect.8
4386 zdump.8
4387 zic.8
4388     mtk, Joey
4389         Added header comment noting that these pages are in the public
4390         domain.
4391
4392 bindresvport.3
4393 getrpcent.3
4394 getrpcport.3
4395 rpc.3
4396 xdr.3
4397 rpc.5
4398     mtk, aeb, Joey
4399         Added following to top of these pages to clarify origin and
4400         license:
4401         .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
4402
4403 New pages
4404 ---------
4405
4406 ioprio_set.2
4407     Eduardo Madeira Fleury, with edits by mtk, and review by Jens Axboe
4408         New page for ioprio_get(2) and ioprio_set(2), new in 2.6.13.
4409
4410 offsetof.3
4411     Justin Pryzby / mtk
4412         New page describing offsetof() macro.
4413
4414
4415 Changes to individual pages
4416 ---------------------------
4417
4418 _exit.2
4419     mtk
4420         Add SEE ALSO referring to exit_group.2.
4421
4422 acct.2
4423     mtk
4424         Add SEE ALSO referring to acct.5.
4425
4426 fcntl.2
4427     mtk
4428         Explicitly mention term "dnotify" in discussion of F_NOTIFY.
4429
4430 inotify_add_watch.2
4431     Aristeu Sergio Rozanski Filho / mtk
4432         s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4433         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
4434     mtk
4435         Renamed argument from 'path' to 'pathname'.
4436         Reword introductory paragraph to clarify that
4437         inotify_add_watch() may also modify an existing watch item.
4438     mtk
4439         The EINVAL error can also occur if 'fd' is not an inotify
4440         file descriptor.
4441     mtk
4442         Moved BUGS section from this page to inotify.7.
4443
4444 inotify_init.2
4445     Aristeu Sergio Rozanski Filho / mtk
4446         s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4447         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
4448
4449 inotify_rm_watch.2
4450     Aristeu Sergio Rozanski Filho / mtk
4451         s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4452         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
4453     mtk
4454         The EINVAL error can also occur if 'fd' is not an inotify
4455         file descriptor.
4456
4457 ioprio_get.2
4458     mtk
4459         New link to new ioprio_set.2.
4460
4461 mmap.2
4462     mtk
4463         Add SEE ALSO referring to remap_file_pages.2.
4464
4465 mount.2
4466     Kenichi Okuyama
4467         s/MNT_FORCE/MNT_EXPIRE/ under EINVAL error.
4468
4469 mremap.2
4470     Mike Frysinger
4471         s/unsigned long flags/int flags/ in SYNOPSIS.
4472
4473 pipe.2
4474     mtk
4475         Add SEE ALSO referring to popen.3.
4476
4477 posix_fadvise.2
4478     mtk
4479         Add SEE ALSO referring to readahead.2.
4480
4481 read.2
4482     mtk
4483         SEE ALSO for readv should refer to Section 2, not 3.
4484
4485 readahead.2
4486     mtk
4487         Add SEE ALSO referring to posix_fadvise.2.
4488
4489 send.2
4490     Peter Eiserloh
4491         Fix missing arguments in statement about equivalent send()
4492         and sendto() calls.
4493
4494 setsid.2
4495     mtk
4496         Add SEE ALSO referring to tcgetsid.3.
4497
4498 shmctl.2
4499     mtk
4500         Minor wording change at start of DESCRIPTION.
4501
4502 stat.2
4503     mtk
4504         Add SEE ALSO referring to access.2.
4505
4506 statfs.2
4507     mtk
4508         Relocated "Note" about f_fsid.
4509
4510 write.2
4511     mtk
4512         SEE ALSO for writev should refer to Section 2, not 3.
4513
4514 __setfpucw.3
4515     mtk, Joey
4516         Added license statement (GPL) after consultation with
4517         Joerg Scheurich.
4518
4519 assert_perror.3
4520     Justin Pryzby
4521         Add #define _GNU_SOURCE to prototype
4522
4523 difftime.3
4524     Joey
4525         Added note about time_t representation on other systems.
4526         Added CONFORMING TO.
4527
4528 ftw.3
4529     Justin Pryzby / mtk
4530         A fairly major revision...
4531         Document FTW_ACTIONRETVAL; include .SH "RETURN VALUE";
4532         Reorganized and rewrote much of the page
4533         Added an example program.
4534
4535 inet.3
4536     Marc Lehmann
4537         Fixed typo in NOTES.
4538         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=370277
4539
4540 isalpha.3
4541     Joey
4542         Updated CONFORMING TO.
4543
4544 mktemp.3
4545     mtk
4546         Updated CONFORMING TO.
4547
4548 printf.3
4549     Walter Harms
4550         Add documentation of %m.
4551
4552 readdir.3
4553     mtk
4554         Added SEE ALSO referring to ftw.3.
4555
4556 re_comp.3
4557     mtk
4558         Note that these functions are obsolete in favor of regcomp(3).
4559     Justin Pryzby
4560         Add SEE ALSO referring to regcomp.3
4561
4562 scandir.3
4563     Mats Wichmann
4564         Reworded CONFORMING TO statement on scandir() and alphasort().
4565
4566 strchr.3
4567     Stefan Puiu
4568         Fix prototype for strchrnul().
4569
4570 strtoul.3
4571     Stefan Puiu
4572         Add text clarifying treatment of strings starting with
4573         minus sign.
4574
4575 tmpnam.3
4576     mtk, after comments by Justin Pryzby
4577         Add text noting the need to use open(O_EXCL).
4578     mtk
4579         Clarify discussion of use of free(3).
4580         Various other minor changes to text and formatting.
4581
4582 tmpfile.3
4583     mtk
4584         Updated CONFORMING TO.
4585
4586 tmpnam.3
4587     mtk, after comments by Justin Pryzby
4588         Add text noting the need to use open(O_EXCL).
4589         Updated CONFORMING TO.
4590
4591 undocumented.3
4592     mtk
4593         Remove offsetof(), which is now documented.
4594
4595 null.4
4596     mtk
4597         Added SEE ALSO referring to full.4.
4598
4599 console_codes.4
4600     Thomas Dickey
4601         Various improvements and corrections.
4602
4603 epoll.7
4604     mtk
4605         Added CONFORMING TO section mentioning FreeBSD kqueue and
4606         Solaris /dev/poll.
4607
4608 feature_test_macros.7
4609     mtk
4610         Added pointer to location of LFS specification.
4611
4612 futex.7
4613     mtk, after suggestion by Joey.
4614         Added license statement to page, after discussion with
4615         original author, bert hubert.
4616     mtk
4617         Reformat long lines; no content changes.
4618
4619 inotify.7
4620     mtk
4621         'path' argument renamed to 'pathname'.
4622         A few minor rewordings.
4623         Added BUGS section describing a couple of bugs.
4624
4625 ip.7
4626     mtk
4627         Add SEE ALSO referring to byteorder.3.
4628
4629 man.7
4630     Justin Pryzby
4631         Add SEE ALSO referring to groff_man(7).
4632         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369253
4633
4634
4635 ==================== Changes in man-pages-2.35 ====================
4636
4637 Released: 2006-07-06
4638
4639 Contributors
4640 ------------
4641
4642 The following people contributed notes, ideas, or patches that have
4643 been incorporated in changes in this release:
4644
4645 Alain Portal <aportal@univ-montp2.fr>
4646 Andi Kleen <ak@suse.de>
4647 Andrew Morton <akpm@osdl.org>
4648 Bauke Jan Douma <bjdouma@xs4all.nl>
4649 Davide Libenzi <davidel@xmailserver.org>
4650 Denis Barbier <barbier@linuxfr.org>
4651 Horacio Rodriguez Montero <Horacio.Rodriguez.Montero@galinter.com.ar>
4652 Johan Lithander <johan.lithander@teligent.se>
4653 Justin Pryzby <justinpryzby@users.sourceforge.net>
4654 Mike Frysinger <vapier@gentoo.org>
4655 Stefan Puiu <stefanpuiuro@yahoo.com>
4656 Thorsten Kukuk <kukuk@suse.de>
4657
4658 Apologies if I missed anyone!
4659
4660
4661 Global changes
4662 --------------
4663
4664 Typographical or grammatical errors have been corrected in several
4665 places.
4666
4667 New pages
4668 ---------
4669
4670 sync_file_range.2
4671     Andrew Morton / mtk
4672         New page for sync_file_range(2), new in kernel 2.6.17.
4673
4674 Changes to individual pages
4675 ---------------------------
4676
4677 adjtime.3
4678     mtk
4679         Noted BUG that occurs if 'delta' is specified as NULL.
4680         See http://bugzilla.kernel.org/show_bug.cgi?id=6761
4681
4682 bind.2
4683     Stefan Puiu
4684         Add EADDRNOTAVAIL error.
4685     Stefan Puiu / mtk
4686         Make example code more complete.
4687
4688 epoll_ctl.2
4689     mtk / Davide Libenzi
4690         Added EPOLLRDHUP description.
4691     mtk
4692         Added SEE ALSO referring to poll.2.
4693
4694 poll.2
4695     mtk / Davide Libenzi
4696         Added POLLRDHUP description.
4697     mtk
4698         The correct header file is <poll.h>, not <sys/poll.h>.
4699         Rewrote and reformatted various other parts.
4700
4701 readlink.2
4702     mtk
4703         Nowadays, readlink() returns 'ssize_t', as required in
4704         POSIX.1-2001.
4705
4706 wavelan.4
4707     mtk
4708         Added license statement.
4709
4710 nscd.conf.5
4711     Thorsten Kukuk
4712         Add documentation for various new fields.
4713
4714 passwd.5
4715     Horacio Rodriguez Montero
4716         Add explanation of 'x' character in 'password' field.
4717     mtk
4718         The proper name of "*" is "asterisk" not "star".
4719
4720 tcp.7
4721     Johan Lithander
4722         Update RFC reference for ECN.
4723     Andi Kleen
4724         Add sentence on "low memory" limit for tcp_mem on 32-bit systems.
4725
4726
4727 ==================== Changes in man-pages-2.36 ====================
4728
4729 Released: 2006-07-11
4730
4731 Contributors
4732 ------------
4733
4734 The following people contributed notes, ideas, or patches that have
4735 been incorporated in changes in this release:
4736
4737 Alain Portal <aportal@univ-montp2.fr>
4738 Jens Axboe <jans@suse.de>
4739 Justin Pryzby <justinpryzby@users.sourceforge.net>
4740 Kyle McMartin <kyle@mcmartin.ca>
4741
4742 Apologies if I missed anyone!
4743
4744 Global changes
4745 --------------
4746
4747 Typographical or grammatical errors have been corrected in several
4748 places.
4749
4750 New pages
4751 ---------
4752
4753 MAINTAINING
4754     mtk
4755         How to maintain man-pages.
4756
4757 TODO
4758     mtk
4759         Things that it would be nice to get done for man-pages one day.
4760
4761 scripts/FIXME_list.sh
4762     mtk
4763         This script, intended for use by manual page maintainers,
4764         displays the FIXMEs in the manual page source files.
4765
4766 Changes to individual pages
4767 ---------------------------
4768
4769 fdatasync.2
4770 fsync.2
4771     mtk
4772         Added SEE ALSO referring to sync_file_range.2.
4773
4774 sendfile.2
4775     mtk / Jens Axboe
4776         Fix description of 'offset' argument to explain the case
4777         where 'offset' is NULL.
4778
4779 ferror.3
4780     Justin Pryzby
4781         Add SEE ALSO referring to fdopen.3.
4782
4783 intro.3
4784     mtk
4785         Removed information about Section 3 subsections -- it doesn't
4786         reflect current reality, and probably never has.
4787
4788         Added SEE ALSO referring to intro.2.
4789
4790 tcp.7
4791     Kyle McMartin
4792         Correction: tcp_window_scaling is ENabled by default.
4793
4794
4795 ==================== Changes in man-pages-2.37 ====================
4796
4797 Released: 2006-08-02
4798
4799 Contributors
4800 ------------
4801
4802 The following people contributed notes, ideas, or patches that have
4803 been incorporated in changes in this release:
4804
4805 Alain Portal <aportal@univ-montp2.fr>
4806 Dean Gaudet <dean@arctic.org>
4807 Frank van Viegen <F.C.vanViegen@UTwente.nl>
4808 Helmut Grohne <helmut@subdivi.de>
4809 Ivana Varekova <varekova@redhat.com>
4810 Thomas Huriaux <thomas.huriaux@gmail.com>
4811 Ville Skyttä <ville.skytta@iki.fi>
4812
4813 Apologies if I missed anyone!
4814
4815 Global changes
4816 --------------
4817
4818 Thomas Huriaux / mtk
4819
4820         Various formatting problems found as a result of reviewing the
4821         following command were fixed.
4822
4823         for a in  $(wc -l man?/*.?| awk '$1 > 2 {print $2}' | grep -v total); do
4824             echo $a; groff -Tascii -wmac -mman $a > /dev/null;
4825         done 2>&1 | less
4826
4827         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=378544
4828
4829 Typographical or grammatical errors have been corrected in several
4830 places.
4831
4832 New pages
4833 ---------
4834
4835 readlinkat.2
4836     mtk (after prompting from Ivana Varekova)
4837         New page for readlinkat(2), new in kernel 2.6.16.
4838
4839 Changes to individual pages
4840 ---------------------------
4841
4842 ldd.1
4843     Ville Skyttä
4844         Document "-u" option.
4845
4846 chdir.2
4847     mtk
4848         Noted effect of fork() and execve() on current working directory.
4849
4850 chroot.2
4851     mtk
4852         Noted effect of fork() and execve() on root directory.
4853
4854 epoll_ctl.2
4855     Frank van Viegen / mtk
4856         Fix description of EBADF error.
4857
4858 exevce.2
4859     mtk
4860         Add text noting that effective IDs are copied to
4861         saved set-IDs during execve().
4862         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=379297
4863
4864 getitimer.2
4865     mtk
4866         Noted effect of fork() and execve() on interval timers.
4867
4868 getrlimit.2
4869     mtk
4870         Noted effect of fork() and execve() on resource limits.
4871
4872 getpriority.2
4873     mtk
4874         Noted effect of fork() and execve().
4875
4876 inotify_add_watch.2
4877     mtk
4878         Some rewording; included text describing required file
4879         permissions.
4880
4881 intro.2
4882     mtk
4883         Revised description of standards under CONFORMING TO.
4884
4885 makecontext.3
4886     Helmut Grohne / mtk
4887         Point out that args following 'argc' are int.
4888     mtk
4889         Added an example program.
4890         Various minor wording fixes.
4891
4892 mmap.2
4893     mtk
4894         Expand description of MAP_POPULATE.
4895     mtk, after prompting by Dean Gaudet
4896         Expand description MAP_NONBLOCK.
4897     mtk
4898         Various minor formatting fixes.
4899
4900 openat.2
4901     mtk
4902         Added SEE ALSO linking to readlinkat.2.
4903
4904 nanosleep.2
4905     mtk
4906         Noted buggy behavior in Linux 2.4 and earlier when
4907         nanosleep() is restarted after receiving stop+SIGCONT signals.
4908
4909 nice.2
4910     mtk
4911         Very minor rewording.
4912
4913 readlink.2
4914     mtk
4915         Added SEE ALSO linking to readlinkat.2.
4916
4917 sched_setscheduler.2
4918     mtk
4919         Noted preservation of scheduling parameters across execve().
4920
4921 setpgid.2
4922     mtk
4923         Noted effect of fork() and execve() on process group ID.
4924
4925 setsid.2
4926     mtk
4927         Noted effect of fork() and execve() on session ID.
4928
4929 umask.2
4930     mtk
4931         Noted effect of fork() and execve() on umask.
4932
4933 atexit.3
4934     mtk
4935         Noted inheritance of registrations across fork().
4936
4937 capabilities.7
4938     mtk
4939         Added material on privileges required for move_pages().
4940         CLONE_NEWNS needs CAP_SYS_ADMIN.
4941         keyctl(KEYCTL_CHOWN) and keyctl(KEYCTL_SETPERM) require
4942         CAP_SYS_ADMIN.
4943
4944
4945 ==================== Changes in man-pages-2.38 ====================
4946
4947 Released: 2006-08-03
4948
4949 Contributors
4950 ------------
4951
4952 The following people contributed notes, ideas, or patches that have
4953 been incorporated in changes in this release:
4954
4955 Alain Portal <aportal@univ-montp2.fr>
4956
4957 Apologies if I missed anyone!
4958
4959 Global changes
4960 --------------
4961
4962 Most pages
4963     mtk
4964         There was a major reworking of the CONFORMING TO sections
4965         in most manual pages.
4966
4967         * generally try to rationalize the names used for standards.
4968           The preferred names are now documented as the head words
4969           of the list in standards(7).  For the future: there is
4970           probably no need to talk about anything more than
4971           C89, C99, POSIX.1-2001 (or later), xBSD, and SVr4.
4972           (In particular, I've eliminated most references to XPG
4973           and SVID, replacing them with references to SUS or SVr4.)
4974
4975         * eliminate discussion of errors that can occur on other
4976           systems.  This information exists only patchily in the
4977           manual pages, is probably of limited use, is hard to maintain,
4978           and was in some cases simply wrong (and probably always was).
4979
4980         * Tried to ensure that those interfaces specified in C99 or
4981           POSIX.1-2001 are marked as such in their manual pages.
4982
4983 intro.1
4984 intro.2
4985 intro.3
4986 intro.4
4987 intro.5
4988 intro.7
4989 feature_test_macros.7
4990     mtk
4991         Added SEE ALSO referring to new standards.7.
4992
4993 Various pages
4994     mtk
4995         Changed instances of "HP UX" to "HP-UX".
4996
4997 Various pages
4998     mtk
4999         Changed instances of "DG-UX to "DG/UX"
5000
5001 Typographical or grammatical errors have been corrected in several
5002 places.
5003
5004 New pages
5005 ---------
5006
5007 standards.7
5008     mtk
5009         Based on material taken from intro.2, but expanded to
5010         include discussion of many additional standards.
5011
5012 Changes to individual pages
5013 ---------------------------
5014
5015 bind.2
5016     mtk
5017         Minor wording change for ENOTSOCK error.
5018
5019 intro.2
5020     mtk
5021         Removed information on standards to new standards.7.
5022
5023
5024 ==================== Changes in man-pages-2.39 ====================
5025
5026 Released: 2006-08-05
5027
5028 Contributors
5029 ------------
5030
5031 The following people contributed notes, ideas, or patches that have
5032 been incorporated in changes in this release:
5033
5034 Alain Portal <aportal@univ-montp2.fr>
5035
5036 Apologies if I missed anyone!
5037
5038 Global changes
5039 --------------
5040
5041 Various pages
5042     mtk
5043         Updated CONFORMING TO and/or standards references
5044         in various pages that were missed for 2.38.
5045
5046 Typographical or grammatical errors have been corrected in several
5047 places.
5048
5049 Changes to individual pages
5050 ---------------------------
5051
5052
5053 chdir.2
5054     mtk
5055         _XOPEN_SOURCE=500 also gets fchdir() prototype.
5056
5057 standards.7
5058     mtk
5059         Added a few more standards, and expand some explanations.
5060
5061
5062 ==================== Changes in man-pages-2.40 ====================
5063
5064 Released: 2006-09-04
5065
5066 Contributors
5067 ------------
5068
5069 The following people contributed notes, ideas, or patches that have
5070 been incorporated in changes in this release:
5071
5072 Alain Portal <aportal@univ-montp2.fr>
5073 Andi Kleen <ak@suse.de>
5074 Andries Brouwer <Andries.Brouwer@cwi.nl>
5075 Christoph Hellwig <hch@lst.de>
5076 Chuck Ebbert <76306.1226@compuserve.com>
5077 Samuel Thibault <samuel.thibault@ens-lyon.org>
5078 Toralf Förster <toralf.foerster@gmx.de>
5079
5080 Apologies if I missed anyone!
5081
5082 Global changes
5083 --------------
5084
5085 faccessat.2
5086 fchmodat.2
5087 fchownat.2
5088 fstatat.2
5089 futimesat.2
5090 linkat.2
5091 mkdirat.2
5092 mknodat.2
5093 openat.2
5094 readlinkat.2
5095 renameat.2
5096 symlinkat.2
5097     mtk (after a note by Alain Portal)
5098         Make naming of 'pathname' argument consistent; various
5099         minor rewordings.
5100
5101 Typographical or grammatical errors have been corrected in several
5102 places.
5103
5104 Changes to individual pages
5105 ---------------------------
5106
5107 clone.2
5108     mtk
5109         Reinstate text on CLONE_DETACHED, and add a few words.
5110
5111 execve.2
5112     mtk
5113         Added list of process attributes that are not preserved on exec().
5114
5115 fork.2
5116     mtk, after a suggestion by Christoph Hellwig
5117         Greatly expanded, to describe all attributes that differ
5118         in parent and child.
5119
5120 linkat.2
5121     mtk
5122         Document AT_SYMLINK_FOLLOW (new in 2.6.18).
5123
5124 set_mempolicy.2
5125     mtk / Andi Kleen
5126         Memory policy is preserved across execve().
5127
5128 write.2
5129     mtk / Alain Portal
5130         SEE ALSO for writev should refer to Section 2, not 3.
5131         (i.e., really make the change that was logged in 2.34)
5132
5133 getcwd.3
5134     Samuel Thibault / mtk
5135         Fix SYNOPSIS and CONFORMING TO text for getwd() and
5136         get_current_dir().
5137         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=381692
5138
5139 proc.5
5140     Chuck Ebbert
5141         Document /proc/PID/auxv.
5142
5143 capabilities.7
5144     Alain Portal
5145         Restore text accidentally deleted in 2.39.
5146
5147 regex.7
5148     mtk / Alain Portal
5149         Change references to "1003.2" to "POSIX.2".
5150
5151
5152 ==================== Changes in man-pages-2.41 ====================
5153
5154 Released: 2006-10-12
5155
5156 Contributors
5157 ------------
5158
5159 The following people contributed notes, ideas, or patches that have
5160 been incorporated in changes in this release:
5161
5162 Andi Kleen <ak@suse.de>
5163 Andries Brouwer <Andries.Brouwer@cwi.nl>
5164 Andrew Morton <akpm@osdl.org>
5165 Britton Leo Kerin <bkerin_rb@letterboxes.org>
5166 Dan Jacobson <jidanni@jidanni.org>
5167 Guillem Jover <guillem@hadrons.org>
5168 Hrvoje Niksic <hniksic@xemacs.org>
5169 Jens Axboe <axboe@suse.de>
5170 Justin Pryzby <justinpryzby@users.sourceforge.net>
5171 Kevin Ryde <user42@zip.com.au>
5172 Marcel Holtmann <marcel@holtmann.org>
5173 Senthil Kumar <senthilkumar_sen@hotpop.com>
5174 Stefan Puiu <stefanpuiuro@yahoo.com>
5175 Stuart MacDonald <stuartm@connecttech.com>
5176 Trond Myklebust <trond.myklebust@fys.uio.no>
5177
5178 Apologies if I missed anyone!
5179
5180
5181 Global changes
5182 --------------
5183
5184 Typographical or grammatical errors have been corrected in several
5185 places.
5186
5187
5188 New pages
5189 ---------
5190
5191 splice.2
5192 tee.2
5193 vmsplice.2
5194     Jens Axboe / Michael Kerrisk
5195         See also:
5196             http://lwn.net/Articles/118760/
5197             http://lwn.net/Articles/178199/
5198             http://lwn.net/Articles/179492/
5199             http://kerneltrap.org/node/6505
5200             http://lwn.net/Articles/179434/
5201
5202 Changes to individual pages
5203 ---------------------------
5204
5205 ldd.1
5206     Stefan Puiu
5207         Note glibc version where "ldd -u" appeared.
5208
5209 execve.2
5210     mtk
5211         The PR_SET_NAME setting is not preserved across an execve().
5212
5213 fork.2
5214     mtk
5215         Mappings marked with madvise(MADV_DONTFORK) are not inherited
5216         by child.
5217
5218 getdtablesize.2
5219     mtk
5220         Noted that sysconf(_SC_OPEN_MAX) is preferred in portable
5221         applications.
5222
5223 getpagesize.2
5224     mtk
5225         Noted that sysconf(_SC_PAGE_SIZE) is preferred in portable
5226         applications.
5227         _SC_PAGE_SIZE is available on most systems.
5228
5229 madvise.2
5230     mtk
5231         Document MADV_REMOVE, new in 2.6.16.
5232         Document MADV_DONTFORK / MADV_DOFORK, new in 2.6.16.
5233
5234 mount.2
5235     mtk / Trond Myklebust
5236         MNT_FORCE can cause data loss.
5237
5238 mmap.2
5239     mtk
5240         Added note on Linux's old (pre-2.6.12) buggy treatment of
5241         length==0.
5242     Justin Pryzby / mtk
5243         Added some EINVAL errors.
5244
5245 mremap.2
5246     mtk
5247         Remove superfluous "#include <unistd.h>" from SYNOPSIS.
5248
5249 msync.2
5250     mtk
5251         Added EBUSY error for case where MS_INVALIDATE is applied to
5252         a locked region.
5253
5254 posix_fadvise.2
5255     Andrew Morton
5256         Since 2.6.18, POSIX_FADV_NOREUSE is a no-op.
5257
5258 prctl.2
5259     Marcel Holtmann / mtk
5260         Since kernel 2.6.18, setting 2 for PR_SET_DUMPABLE is no longer
5261         possible.
5262     Guillem Jover
5263         Updated Linux versions where the options where introduced.
5264         Added PR_SET_TIMING, PR_GET_TIMING, PR_SET_NAME, PR_GET_NAME,
5265         PR_SET_UNALIGN, PR_GET_UNALIGN, PR_SET_FPEMU, PR_GET_FPEMU,
5266         PR_SET_FPEXC, PR_GET_FPEXC.
5267     Michael Kerrisk
5268         Document PR_GET_ENDIAN and PR_SET_ENDIAN.
5269
5270 remap_file_pages.2
5271     mtk
5272         Add "#define _GNU_SOURCE" to SYNOPSIS.
5273
5274 sync_file_range.2
5275     mtk
5276         Noted that sync_file_range() appeared in kernel 2.6.17.
5277
5278 vfork.2
5279     mtk
5280         Noted interactions with fork handlers in multithreaded programs.
5281
5282 wait4.2
5283     mtk
5284         Added feature test macros to SYNOPSIS.
5285
5286 clog2.3
5287     mtk / aeb / Kevin Ryde
5288         Fix broken text in description.
5289         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386214
5290
5291 clog10.3
5292     Kevin Ryde
5293         Fix broken text in description.
5294         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386214
5295
5296 mq_receive.3
5297     Britton Leo Kerin
5298         Fix return type in SYNOPSIS; should be "ssize_t" not "mqd_t".
5299         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=387551
5300
5301 qsort.2
5302     Hrvoje Niksic
5303         Fix wording referring to the use of strcmp() in 'compar'
5304         function.
5305         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=391402
5306
5307 sendfile.2
5308     mtk
5309         Added SEE ALSO referring to new splice.2 page.
5310
5311 termios.3
5312     mtk
5313         Documented IUTF8 (which was new in kernel 2.6.4).
5314
5315 tzset.3
5316     mtk
5317         Added some TZ examples.
5318         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386087
5319
5320 proc.5
5321     mtk
5322         Added delayacct_blkio_ticks (new in 2.6.18) to /proc/PID/statm.
5323
5324 ip.7
5325     Stuart MacDonald / Andi Kleen
5326         Fix discussion for TCP error queue /IP_RECVERR on TCP.
5327
5328 pthreads.7
5329     mtk
5330         Noted effect of RLIMIT_STACK resource limit for NPTL.
5331
5332 socket.7
5333     Senthil Kumar
5334         Place socket options in alphabetical order.
5335
5336
5337 ==================== Changes in man-pages-2.42 ====================
5338
5339 Released: 2006-11-24
5340
5341 Contributors
5342 ------------
5343
5344 The following people contributed notes, ideas, or patches that have
5345 been incorporated in changes in this release:
5346
5347 Andrew Morton <akpm@osdl.org>
5348 Chuck Ebbert <76306.1226@compuserve.com>
5349 Doug Goldstein <cardoe@gentoo.org>
5350 Eduard Bloch <blade@debian.org>
5351 Evan Teran <eteran@alum.rit.edu>
5352 Pavel Heimlich <tropikhajma@seznam.cz>
5353 Petr Baudis <pasky@ucw.cz>
5354 Randy Dunlap <rdunlap@xenotime.net>
5355 Ulrich Drepper <drepper@redhat.com>
5356
5357 Apologies if I missed anyone!
5358
5359
5360 Global changes
5361 --------------
5362
5363 Typographical or grammatical errors have been corrected in several
5364 places.
5365
5366
5367 Changes to individual pages
5368 ---------------------------
5369
5370 brk.2
5371     Evan Teran / mtk
5372         Add text describing behavior of the Linux brk() system call
5373         and point out that the glibc brk() wrapper provides different
5374         behavior.
5375     mtk
5376         Note that sbrk() is implemented as a library function in glibc
5377         that calls the brk() system call.
5378
5379 futex.2
5380     mtk
5381         FUTEX_FD is scheduled for removal in June 2007.
5382
5383 getaddrinfo.3
5384 getnameinfo.3
5385     Ulrich Drepper, with edits by mtk
5386         Add text describing Internationalized Domain Name
5387         extensions.
5388
5389 open.2
5390     mtk / Eduard Bloch
5391         Fix description of O_LARGEFILE to mention required feature test
5392         macros.
5393
5394 ptrace.2
5395     Chuck Ebbert
5396         Since Linux 2.6.18, the PID of the new process is also available
5397         for PTRACE_EVENT_VFORKDONE.
5398
5399 syslog.3
5400     Doug Goldstein
5401         Fix header file required for vsyslog() in SYNOPSIS.
5402
5403 wcwidth.3
5404     Petr Baudis
5405         Fix CONFORMING TO.
5406
5407 core.5
5408     mtk
5409         Linux 2.4.21 added core_pattern (which was already in 2.6).
5410         Noted a few more reasons why a core dump file might not
5411         be produced.
5412
5413
5414 ==================== Changes in man-pages-2.43 ====================
5415
5416 Released: 2006-11-29
5417
5418 Contributors
5419 ------------
5420
5421 The following people contributed notes, ideas, or patches that have
5422 been incorporated in changes in this release:
5423
5424 Andi Kleen <ak@suse.de>
5425 David Brownell <david-b@pacbell.net>
5426 Eduard Bloch <blade@debian.org>
5427 Egmont Koblinger <egmont@uhulinux.hu>
5428 Reuben Thomas <rrt@sc3d.org>
5429
5430 Apologies if I missed anyone!
5431
5432
5433 Global changes
5434 --------------
5435
5436 Typographical or grammatical errors have been corrected in several
5437 places.
5438
5439
5440 Changes to individual pages
5441 ---------------------------
5442
5443 ioperm.2
5444     mtk
5445         Clarify discussion of privilege requirements.
5446         Added ENOMEM to ERRORS.
5447
5448 open.2
5449     mtk / Eduard Bloch
5450         Clarify description of O_LARGEFILE.
5451
5452 crypt.3
5453     Egmont Koblinger
5454         Make description of MD5 output string less ambiguous.
5455
5456 strerror.3
5457     Reuben Thomas
5458         Add C99 to CONFORMING TO; see
5459         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400634
5460
5461 rtc.4
5462     David Brownell
5463
5464         Update the RTC man page to reflect the new RTC class framework:
5465
5466         - Generalize ... it's not just for PC/AT style RTCs, and there
5467           may be more than one RTC per system.
5468
5469         - Not all RTCs expose the same feature set as PC/AT ones; most
5470           of these ioctls will be rejected by some RTCs.
5471
5472         - Be explicit about when {A,P}IE_{ON,OFF} calls are needed.
5473
5474         - Describe the parameter to the get/set epoch request; correct
5475           the description of the get/set frequency parameter.
5476
5477         - Document RTC_WKALM_{RD,SET}, which don't need AIE_{ON,OFF} and
5478           which support longer alarm periods.
5479
5480         - Hey, not all system clock implementations count timer irqs any
5481           more now that the new RT-derived clock support is merging.
5482
5483 proc.5
5484     mtk
5485         s/fseek(3)/lseek(2)/ under /proc/PID/mem entry.
5486
5487 feature_test_macros.7
5488     mtk / Eduard Bloch
5489         The LFS spec is now at http://opengroup.org/platform/lfs.html
5490
5491 raw.7
5492 udp.7
5493     Andi Kleen
5494         Describe the correct default for UDP/RAW path MTU discovery.
5495
5496
5497 ==================== Changes in man-pages-2.44 ====================
5498
5499 Released: 2007-04-04
5500
5501 Contributors
5502 ------------
5503
5504 The following people contributed notes, ideas, or patches that have
5505 been incorporated in changes in this release:
5506
5507 Andre Majorel <aym-naideb@teaser.fr>
5508 Benjamin Gilbert <bgilbert@cs.cmu.edu>
5509 Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
5510 Chuck Ebbert <76306.1226@compuserve.com>
5511 Ivana Varekova <varekova@redhat.com>
5512 Jakub Jelinek <jakub@redhat.com>
5513 John Ward <jward@idealcorp.com>
5514 Jorge Peixoto de Morais Neto <jorgepeixotomorais@gmail.com>
5515 Julien Blache <jblache@debian.org>
5516 Julien Cristau <jcristau@debian.org>
5517 Justin Pryzby <justinpryzby@users.sourceforge.net>
5518 Martín Ferrari <martin.ferrari@gmail.com>
5519 Mike Frysinger <vapier@gentoo.org>
5520 Nick Piggin <npiggin@suse.de>
5521 Nick Pollitt <npollitt@mvista.com>
5522 Nicolas François <nicolas.francois@centraliens.net>
5523 Pádraig Brady <P@draigBrady.com>
5524 Premysl Hruby <dfenze@gmail.com>
5525 Reuben Thomas <rrt@sc3d.org>
5526 Samuel Thibault <samuel.thibault@ens-lyon.org>
5527 Serge E. Hallyn <serge@hallyn.com>
5528 Thomas Huriaux <thomas.huriaux@gmail.com>
5529 Timo Sirainen <tss@iki.fi>
5530 Val Henson <val_henson@linux.intel.com>
5531
5532 Apologies if I missed anyone!
5533
5534
5535 New pages
5536 ---------
5537
5538 termio.7
5539     mtk, after a bit of prodding by Reuben Thomas
5540         A brief discussion of the old System V termio interface,
5541         with pointers to pages that will contain the information
5542         that the reader probably wants.
5543
5544 scripts/find_repeated_words.sh
5545     mtk
5546         Find consecutive duplicate words in a man page, some of
5547         which may be grammar errors.
5548
5549 Global changes
5550 --------------
5551
5552 Various pages
5553     Justin Pryzby / mtk
5554         Add "#define _ATFILE_SOURCE" to SYNOPSIS in following pages:
5555             faccessat.2
5556             fchmodat.2
5557             fchownat.2
5558             fstatat.2
5559             futimesat.2
5560             linkat.2
5561             mkdirat.2
5562             mknodat.2
5563             openat.2
5564             readlinkat.2
5565             renameat.2
5566             symlinkat.2
5567             unlinkat.2
5568             mkfifoat.3
5569
5570 Various pages
5571     mtk
5572         Various references to "getty" were changed to "mingetty", since
5573         that is the manual page more likely to be found on current systems.
5574
5575 Various pages
5576     mtk, after a suggestion by Reuben Thomas <rrt@sc3d.org>
5577         Updated various header pages to accurately reflect which functions
5578         are and are not part of C89.  Also fixed/improved a few other
5579         CONFORMING TO entries.
5580
5581 Various pages
5582     mtk
5583         s/Unices/Unix systems/ on the 5 pages where it appears.
5584
5585 Various pages
5586     mtk
5587         Wrapped long source lines in the following files
5588             getsockopt.2
5589             mknodat.2
5590             io_setup.2
5591             select_tut.2
5592             select.2
5593             readlinkat.2
5594             io_cancel.2
5595             syslog.2
5596             wcsncat.3
5597             getipnodebyname.3
5598             cmsg.3
5599             wcpncpy.3
5600             wcsrtombs.3
5601             wcstok.3
5602             fgetwc.3
5603             wmemcmp.3
5604             wcsspn.3
5605             div.3
5606             modf.3
5607             stdio_ext.3
5608             ctermid.3
5609             des_crypt.3
5610             wcsncmp.3
5611             wmemchr.3
5612             wcsstr.3
5613             wmemcpy.3
5614             wprintf.3
5615             wcsnrtombs.3
5616             termios.3
5617             erf.3
5618             ceil.3
5619             lround.3
5620             nextafter.3
5621             wcsncpy.3
5622             wmemset.3
5623             getw.3
5624             console_ioctl.4
5625             sk98lin.4
5626             environ.7
5627             unix.7
5628             time.7
5629
5630 Various pages
5631     mtk
5632         Added a SEE ALSO reference for feature_test_macros(7) to all
5633         pages where a feature test macro appears in the SYNOPSIS.
5634
5635 Various pages
5636     mtk
5637         Added SEE ALSO entry pointing to time.7
5638             alarm.2
5639             nanosleep.2
5640             ualarm.3
5641             usleep.3
5642
5643 Various pages
5644     Justin Pryzby / mtk
5645         Fixed consecutive duplicate word typos on a number of pages.
5646
5647 Typographical or grammatical errors have been corrected in several
5648 places.  (Special thanks to Nicolas François!)
5649
5650
5651 Changes to individual pages
5652 ---------------------------
5653
5654 access.2
5655     mtk
5656         Since 2.6.20, access() honors the MS_NOEXEC mount flag.
5657     Jorge Peixoto de Morais Neto / mtk
5658         Improve ENOENT description.
5659
5660 clone.2
5661     mtk
5662         Added some detail to the prototype.
5663         Added some notes on IA-64's clone2().
5664
5665 epoll_ctl.2
5666     mtk
5667         Add text to note that EPOLLRDHUP appeared in kernel 2.6.17.
5668
5669 faccessat.2
5670     Justin Pryzby
5671         Various fixes as per
5672         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411177
5673         * s/effective/real/ in description text.
5674         * added <fcntl.h> to synopsis.
5675         * various other changes.
5676
5677 getrlimit.2
5678     mtk / Fedora downstream patches; thanks to Ivana Varekova
5679         Added a few words to note that RLIMIT_NPROC is really a limit on
5680         threads.
5681
5682 io_cancel.2
5683 io_destroy.2
5684 io_getevents.2
5685 io_setup.2
5686 io_submit.2
5687     Fedora downstream patches; thanks to Ivana Varekova
5688         s%linux/aio.h%libaio.h% in SYNOPSIS.
5689         Changed return type from "long" to "int".
5690
5691 mbind.2
5692     Samuel Thibault / mtk
5693         Fix EINVAL description.
5694         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411777
5695
5696 mincore.2
5697     Nick Piggin
5698         Kernel 2.6.21 fixes several earlier bugs in mincore().
5699     Nick Pollitt
5700         Remove words "of a file" -- mincore() is describing
5701         memory residence information, not properties of a file.
5702     mtk
5703         Rewrote various parts to make the page clearer.
5704
5705 mmap.2
5706     mtk
5707         Rewrote and reorganized various parts to be clearer.
5708     Taken from Fedora downstream patches; thanks to Ivana Varekova
5709         Removed text stating that mmap() never returns 0; that's
5710         not true.
5711
5712 mount.2
5713     mtk / Val Henson
5714         Document MS_RELATIME, new in Linux 2.6.20.
5715
5716 open.2
5717     Andre Majorel / mtk
5718         On Linux, the error returned when opening a large file on a
5719         32-bit system is actually EFBIG, not EOVERFLOW.
5720
5721 posix_fadvise.2
5722     Pádraig Brady
5723         Fix RETURN VALUE description: returns error number of failure.
5724
5725 rename.2
5726     mtk / Timo Sirainen
5727         Various improvements to DESCRIPTION.
5728         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=416012
5729
5730 semop.2
5731     mtk
5732         If sops contains multiple operations, then these are performed
5733         in array order.  All Unix systems that I know of do this,
5734         and some Linux applications depend on this behavior.  SUSv3
5735         made no explicit statement here, but SUSv4 will explicitly
5736         require this behavior.
5737         Small rewording of explanation of "atomically".
5738
5739 signal.2
5740     Nicolas François
5741         Fix incorrect argument name in DESCRIPTION.
5742     mtk
5743         Small wording improvement.
5744
5745 socket.2
5746     Nicolas François
5747         Add reference to ipv6.7 page.
5748
5749 socketcall.2
5750     Nicolas François
5751         Fix .TH line.
5752
5753 splice.2
5754     Benjamin Gilbert
5755         Fix inconsistent argument names in SYNOPSIS and DESCRIPTION.
5756
5757 statvfs.2
5758     mtk
5759         Small wording clarification.
5760
5761 symlink.2
5762     mtk / Nicolas François
5763         Removed cryptic text under CONFORMING to referring to
5764         "open(2) and NFS".  There is no relevant text in open.2 as
5765         far as I (mtk) can see.
5766
5767 time.2
5768     mtk / Reuben Thomas
5769         Remove sentence "gettimeofday() obsoleting time() on 4.3BSD".
5770         This information is old, and probably no longer relevant.
5771         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=403888
5772
5773 write.2
5774     mtk, after an idea from a downstream Fedora patch.
5775         Clarified discussion of /count == 0/ case.
5776
5777 ptrace.2
5778     Chuck Ebbert
5779         When the parent receives an event with PTRACE_EVENT_* set,
5780         the child is not in the normal signal delivery path.  This
5781         means the parent cannot do ptrace(PTRACE_CONT) with a signal
5782         or ptrace(PTRACE_KILL).  kill() with a SIGKILL signal can be
5783         used instead to kill the child process after receiving one
5784         of these messages.
5785
5786 sched_setaffinity.2
5787     mtk
5788         Fix glibc version number in description of 'cpusetsize' argument.
5789
5790 vfork.2
5791     mtk
5792         Stripped some excess/outdated text from the BUGS section.
5793
5794 basename.3
5795     mtk / Jorge Peixoto de Morais Neto
5796         Add text to clarify that the pointer returned by these
5797         functions may be into some part of 'path'.
5798
5799 dlopen.3
5800     Taken from Fedora downstream patches; thanks to Ivana Varekova
5801     + Carlo Marcelo Arenas Belon
5802         Add "#include <stdlib.h>" to example program.
5803
5804 fclose.3
5805     mtk
5806         Complete rewrite.  The existing page was hard to read,
5807         and the RETURN VALUE description seems to be wrong.
5808
5809 getopt.3
5810     mtk
5811         Added getopt() example program.
5812     mtk
5813         Add a few words to clarify the operation of the GNU-specific
5814         double-colon feature, which allows options to have optional
5815         arguments.
5816         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=352139
5817
5818 glob.3
5819     Nicolas François
5820         Fix PROTOTYPE.
5821
5822 inet_network.3
5823     mtk, after an idea from a downstream Fedora patch.
5824         Clarified description of inet_network().
5825
5826 log.3
5827     Nicolas François
5828         Fix .TH line.
5829
5830 log10.3
5831     Nicolas François
5832         Fix .TH line.
5833
5834 malloc.3
5835     Nicolas François
5836         Small rewording to mention calloc().
5837
5838 posix_openpt.3
5839     Martín Ferrari
5840         Fix return type in SYNOPSIS; as per
5841         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400971
5842         Needs _XOPEN_SOURCE == 600; as per
5843         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400975
5844     Julien BLACHE
5845         s/ptsname/posix_openpt/ in RETURN VALUE
5846
5847 re_comp.3
5848     Taken from Fedora downstream patches; thanks to Ivana Varekova
5849         Add "#define _REGEX_RE_COMP" to SYNOPSIS.
5850
5851 regex.3
5852     Nicolas François
5853         Fix .TH line.
5854
5855 termios.3
5856     mtk
5857         Added .SS headers to give some structure to this page; and a small
5858         amount of reordering.
5859     mtk
5860         Added a section on canonical and non-canonical mode.
5861     mtk
5862         Enhanced the discussion of "raw" mode for cfmakeraw().
5863     mtk
5864         Document CMSPAR.
5865     mtk
5866         Make description of PARODD a little clearer.
5867     Reuben Thomas
5868         Add SEE ALSO link to tty_ioctl.4
5869     mtk
5870         Add SEE ALSO link to console_ioctl.4
5871
5872 ualarm.3
5873     mtk
5874         Removed BSD prototype from synopsis.
5875         Various rewordings.
5876
5877 usleep.3
5878     mtk
5879         Removed BSD prototype from synopsis.
5880         Various rewordings.
5881
5882 termcap.5
5883     Taken from Fedora downstream patches; thanks to Ivana Varekova
5884         s/curses/ncurses/ under SEE ALSO
5885
5886 bootparam.7
5887     Taken from Fedora downstream patches; thanks to Ivana Varekova
5888         Documented "mem=nopentium".
5889
5890 feature_test_macros.7
5891     mtk
5892         The default treatment of _POSIX_C_SOURCE changed in glibc 2.4.
5893     mtk, after a suggestion by Justin Pryzby
5894         Added some text warning that the "__" macros that
5895         <features.h> defines internally should never be
5896         directly defined by programs.
5897     mtk, based on notes by Jakub Jelinek
5898         Document _FORTIFY_SOURCE
5899         (See http://gcc.gnu.org/ml/gcc-patches/2004-09/msg02055.html )
5900     mtk
5901         Document _REENTRANT and _THREAD_SAFE.
5902
5903 mdoc.7
5904     mtk / Nicolas François
5905         Remove CONFIGURATION section, since this does not seem to be
5906         true for Linux.
5907
5908 svipc.7
5909     Nicolas François
5910         Fix data types in associated data structures;
5911         remove nonexistent semzcnt and semncnt fields.
5912
5913 time.7
5914     mtk
5915         Since kernel 2.6.20, the software clock can also be 300 HZ.
5916
5917
5918 ==================== Changes in man-pages-2.45 ====================
5919
5920 Released: 2007-04-05
5921
5922 Global changes
5923 --------------
5924
5925 This release consists mainly of formatting fixes (to a large
5926 number of pages) to achieve greater consistency across pages.
5927 With the exception of the few individual changes noted below,
5928 no changes were made to content.
5929
5930 Changes to individual pages
5931 ---------------------------
5932
5933 io_destroy.2
5934 io_getevents.2
5935 io_setup.2
5936 io_cancel.2
5937 io_submit.2
5938     mtk
5939         Clarified RETURN VALUE text
5940
5941 bindresvport.3
5942     mtk
5943         Rewrote prototype using modern C syntax.
5944
5945
5946 ==================== Changes in man-pages-2.46 ====================
5947
5948 Released: 2007-04-06
5949
5950 Global changes
5951 --------------
5952
5953 This release consists mainly of formatting fixes (to a large
5954 number of pages) to achieve greater consistency across pages:
5955
5956 * Most instances of two or more consecutive blank lines in man
5957   page output were shrunk to a single line.
5958 * A number of example programs were reformatted
5959   to more closely match K&R style.
5960 * In various places (mainly code examples), the use of tabs was
5961   replaced by spaces
5962
5963 With the exception of the few individual changes noted below,
5964 no changes were made to content.
5965
5966
5967 Changes to individual pages
5968 ---------------------------
5969
5970 bdflush.2
5971     mtk
5972         Add <sys/kdaemon.h> header file to SYNOPSIS.
5973
5974 sched_rr_get_interval.2
5975     mtk
5976         Moved timespec definition from SYNOPSIS into description.
5977
5978 select_tut.2
5979     mtk
5980         Make SYNOPSIS match select.2.
5981
5982
5983 ==================== Changes in man-pages-2.47 ====================
5984
5985 Released: 2007-05-04
5986
5987 Contributors
5988 ------------
5989
5990 The following people contributed notes, ideas, or patches that have
5991 been incorporated in changes in this release:
5992
5993 Andi Kleen <andi@firstfloor.org>
5994 John Heffner <jheffner@psc.edu>
5995
5996 Apologies if I missed anyone!
5997
5998
5999 Global changes
6000 --------------
6001
6002 This release consists mainly of changes to source file layout
6003 (wrapped long lines; stripped trailing white space; started new
6004 sentences on new lines).
6005
6006 There is very little change to output formatting or content (see the
6007 notes below).
6008
6009
6010 Changes to individual pages
6011 ---------------------------
6012
6013 sched_rr_get_interval.2
6014     mtk
6015         Remove crufty statement that this system call is not implemented.
6016         The nice interval can be used to control the size of
6017         the round-robin quantum.
6018         Corrected .TH line.
6019
6020 ip.7
6021     John Heffner / mtk
6022         Document IP_PMTUDISC_PROBE, which will be in 2.6.22.
6023
6024
6025 ==================== Changes in man-pages-2.48 ====================
6026
6027 Released: 2007-05-04
6028
6029 Contributors
6030 ------------
6031
6032 The following people contributed notes, ideas, or patches that have
6033 been incorporated in changes in this release:
6034
6035 Colin Watson <cjwatson@debian.org>
6036 Justin Pryzby <justinpryzby@users.sourceforge.net>
6037
6038 Apologies if I missed anyone!
6039
6040
6041 Global changes
6042 --------------
6043
6044 This release consists mainly of changes to source file layout
6045 (wrapped long lines; stripped trailing white space; started new
6046 sentences on new lines).
6047
6048 There is very little change to output formatting or content (see the
6049 notes below).
6050
6051 Various pages
6052     mtk
6053         In various places where it occurred,
6054         s/nonnegative/non-negative/
6055
6056 Various pages
6057     mtk
6058         s/wide character/wide-character/ when used attributively.
6059
6060
6061 Changes to individual pages
6062 ---------------------------
6063
6064 man.7
6065     Justin Pryzby / Colin Watson / mtk
6066         .SH doesn't require quotes.
6067         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411303
6068
6069
6070 ==================== Changes in man-pages-2.49 ====================
6071
6072 Released: 2007-05-20
6073
6074 Contributors
6075 ------------
6076
6077 The following people contributed notes, ideas, or patches that have
6078 been incorporated in changes in this release:
6079
6080 Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
6081 Bruno Haible <bruno@clisp.org>
6082 Justin Pryzby <justinpryzby@users.sourceforge.net>
6083
6084 Apologies if I missed anyone!
6085
6086
6087 New pages
6088 ---------
6089
6090 bsd_signal.3
6091     mtk
6092         Documentation of bsd_signal().
6093
6094 euidaccess.3
6095     mtk
6096         Manual page for euidaccess() and eaccess().
6097
6098 getsubopt.3
6099     mtk / Justin Pryzby
6100         Documentation of getsubopt().
6101
6102 sysv_signal.3
6103     mtk
6104         Documentation of sysv_signal().
6105
6106
6107 New links
6108 ---------
6109
6110 epoll_pwait.2
6111     mtk
6112         New link to epoll_wait.2.
6113
6114 eaccess.3
6115     mtk
6116         New link to new euidaccess.3,
6117
6118 sem_timedwait.3
6119     mtk
6120         New link to sem_wait.3.
6121
6122 sem_trywait.3
6123     mtk
6124         New link to sem_wait.3.
6125
6126
6127 Global changes
6128 --------------
6129
6130 Typographical or grammatical errors have been corrected in several
6131 places.
6132
6133
6134 Changes to individual pages
6135 ---------------------------
6136
6137 access.3
6138     mtk
6139         Added SEE ALSO ref to new euidaccess.3 page.
6140
6141 epoll_wait.2
6142     mtk
6143         Added description of epoll_pwait(), new in kernel 2.6.19.
6144
6145 execve.2
6146     mtk
6147         Add text noting that Linux allows 'argv' and 'envp' to be
6148         NULL, but warning that this is non-standard and non-portable,
6149         and should be avoided in portable programs.
6150         Bug filed (http://bugzilla.kernel.org/show_bug.cgi?id=8408)
6151         to get this changed, but maybe that won't be done because it
6152         is an ABI change.
6153     mtk
6154         Added an example program.
6155     mtk
6156         Expanded the discussion of interpreter scripts and the
6157         'optional-arg' argument of an interpreter script.
6158         For further info, see
6159         http://homepages.cwi.nl/~aeb/std/hashexclam-1.html
6160         http://www.in-ulm.de/~mascheck/various/shebang/
6161     mtk
6162         Added text noting that FD_CLOEXEC causes record locks to be
6163         released.
6164     mtk
6165         Mention effect of MS_NOSUID mount(2) flag for set-user-ID
6166         programs.
6167     mtk
6168         Expanded description of handling of file descriptors during
6169         execve(), adding text to note that descriptors 0, 1, and 2
6170         may be treated specially.
6171
6172 faccessat.3
6173     mtk
6174         Added SEE ALSO ref to new euidaccess.3 page.
6175
6176 mmap.2
6177     mtk
6178         Place MAP_* flags list in alphabetical order.
6179
6180 readv.2
6181     mtk
6182         A fairly substantial rewrite, which among other things
6183         fixes the problem reported by Kyle Sluder in
6184         http://bugzilla.kernel.org/show_bug.cgi?id=8399
6185         And added some example code.
6186
6187 sigaction.2
6188     mtk
6189         Added text referring to the discussion of async-signal-safe
6190         functions in signal(7).
6191         A few other minor formatting and wording changes.
6192
6193 signal.2
6194     mtk
6195         Moved the discussion of async-signal-safe functions to signal(7).
6196         Added text referring to the discussion of async-signal-safe
6197         functions in signal(7).
6198         Added SEE ALSO entries referring to new bsd_signal.3 and
6199         sysv_signal.3 pages.
6200
6201 copysign.3
6202     Bruno Haible
6203         Clarify discussion of negative zero.
6204
6205 getopt.3
6206     mtk
6207         Add SEE ALSO ref to new getsubopt.3.
6208
6209 iconv_open.3
6210     Bruno Haible
6211         Describe the glibc/libiconv //TRANSLIT and //IGNORE extensions
6212         for 'tocode'.
6213
6214 iswblank.3
6215     Bruno Haible
6216         Update CONFORMING TO; iswblank() is in POSIX.1-2001.
6217
6218 inotify.7
6219     mtk
6220         Definitions for IN_DONT_FOLLOW, IN_MASK_ADD, and IN_ONLYDIR
6221         were added to glibc in version 2.5.
6222
6223 signal.7
6224     mtk
6225         Incorporated (and slightly modified) the text on
6226         async-signal-safe functions that was formerly in signal(2).
6227         Added SEE ALSO entries referring to new bsd_signal.3 and
6228         sysv_signal.3 pages.
6229
6230
6231 ==================== Changes in man-pages-2.50 ====================
6232
6233 Released: 2007-05-21
6234
6235 Contributors
6236 ------------
6237
6238 The following people contributed notes, ideas, or patches that have
6239 been incorporated in changes in this release:
6240
6241 Andreas Halter <halter@google.com>
6242 Laird Shaw <netocrat@dodo.com.au>
6243 Mike Frysinger <vapier@gentoo.org>
6244
6245 Apologies if I missed anyone!
6246
6247 Removed pages (!)
6248 -----------------
6249
6250 Most Section 1 man pages are removed
6251     mtk (with help from Mike Frysinger, Laird Shaw, Andreas Halter)
6252         Once upon time Andries added a number of Section 1 manual pages
6253         to man-pages.  However, since that time, those pages have not
6254         seen much maintenance, and are not in fact distributed in most
6255         distributions.  Instead most distributions supply the
6256         coreutils versions of these pages, which are currently
6257         maintained.  In addition, man-pages provides the 1p pages,
6258         which document the portable subset of functionality of these
6259         commands.  Since the man1 pages are mostly unneeded, and
6260         out of date, I'm removing them.  The following pages disappear:
6261
6262             chgrp.1
6263             chmod.1
6264             chown.1
6265             cp.1
6266             dd.1
6267             df.1
6268             diff.1
6269             dir.1
6270             dircolors.1
6271             du.1
6272             install.1
6273             ln.1
6274             ls.1
6275             mkdir.1
6276             mkfifo.1
6277             mknod.1
6278             mv.1
6279             rm.1
6280             rmdir.1
6281             touch.1
6282             vdir.1
6283
6284         The following Section 1 pages will be kept:
6285
6286             intro.1
6287             ldd.1
6288             time.1
6289
6290
6291 ==================== Changes in man-pages-2.51 ====================
6292
6293 Released: 2007-05-28
6294
6295 Global changes
6296 --------------
6297
6298 Various pages
6299     mtk
6300         (Hopefully) all cross references outside a page now include a
6301         section number.  This should permit better resulting output
6302         from a man2html-type conversion.
6303
6304 Various pages
6305     mtk
6306         Convert function formatting of the form "\fBname\fP()" to
6307         ".BR name ()".
6308
6309
6310 Changes to individual pages
6311 ---------------------------
6312
6313 futimesat.2
6314     mtk
6315         s/futimes/futimesat/ in .SH NAME line.
6316
6317 msgop.2
6318     mtk
6319         Put "msgrcv" and "msgsnd" in .SH NAME line.
6320
6321 mount.2
6322     mtk
6323         Add "umount2" to .SH NAME line.
6324
6325 wait.2
6326     mtk
6327         Add "waitid" to .SH NAME line.
6328
6329 getopt.3
6330     mtk
6331         Add "getopt_long" and "getopt_long_only" in .SH NAME line.
6332
6333 sem_wait.3
6334     mtk
6335         Add "sem_timedwait" and  "sem_trywait" to .SH NAME line.
6336
6337 stdarg.3
6338     mtk
6339         Add "va_start", "va_arg", "va_end", "va_copy" to .SH NAME line.
6340
6341
6342 ==================== Changes in man-pages-2.52 ====================
6343
6344 Released: 2007-05-29
6345
6346     "A foolish consistency is the hobgoblin of little minds, adored by
6347      little statesmen and philosophers and divines"
6348
6349         Ralph Waldo Emerson (1803-1882)
6350
6351     "But damn it, these man pages are a mess!"
6352
6353
6354 Global changes
6355 --------------
6356
6357 Most of the changes below are about bringing greater consistency
6358 to manual pages, including reducing the wide range of .SH
6359 Section headings.
6360
6361 Typographical or grammatical errors have been corrected in several
6362 places.
6363
6364 Various pages
6365     mtk
6366         Make 'manual' component of .TH line into the string
6367         "Linux Programmer's Manual".
6368         Reason: consistency.
6369
6370 Various pages
6371     mtk
6372         Changed date in .TH line into form YYYY-DD-MM.
6373         Reason: consistency.
6374
6375 Various pages
6376     mtk
6377         Some .SH header lines were made into .SS lines.  (One of the aims
6378         here is to reduce the number of non-standard .SH lines.)
6379
6380 Various pages
6381     mtk
6382         Change title .SH sections named "NOTE" to "NOTES", in some cases
6383         also changing the location of the section within the page.
6384         Reason: consistency.
6385
6386 Various pages
6387     mtk
6388         Commented out .SH AUTHOR sections; the right place for
6389         documentation authorship sections is usually comments at the
6390         top of the page source.
6391
6392 Various pages
6393     mtk
6394         Changed .SH HISTORY to .SH VERSIONS.
6395         Reason: in many cases, HISTORY was being used to describe
6396         Linux/glibc version information, as was already done for
6397         VERSIONS sections in other pages.
6398
6399 Various pages
6400     mtk
6401         Removed HISTORY section, or moved it as a subsection or paragraphs
6402         under another section e.g., NOTES.
6403         Reason: there are too many arbitrary section (.SH) names, and
6404         a HISTORY section never was consistently used across Linux
6405         manual pages.
6406
6407 Various pages
6408     mtk
6409         Moved SEE ALSO section to be last section on the page
6410         Reason: consistency -- and this is where SEE ALSO should be!
6411
6412 Various pages
6413     mtk
6414         Relocated GLIBC NOTES as subsection under NOTES
6415         Reason: reduce number of arbitrary section (.SH) names.
6416
6417 Various pages
6418     mtk
6419         Relocated LINUX NOTES as subsection under NOTES
6420         Reason: reduce number of arbitrary section (.SH) names.
6421
6422 Various pages
6423     mtk
6424         Renamed some "AVAILABILITY" sections to "VERSIONS".
6425         Reason: consistency.
6426
6427 Various pages
6428     mtk
6429         Renamed some "DIAGNOSTICS" sections to "RETURN VALUE".
6430         Reason: consistency.
6431
6432 getopt.3
6433 tzselect.8
6434     mtk
6435         s/\.SH ENVIRONMENT VARIABLES/.SH ENVIRONMENT/
6436         Reason: consistency.
6437
6438 intro.2
6439 select.2
6440 sysctl.2
6441 bsearch.3
6442 dlopen.3
6443 envz_add.3
6444 fmtmsg.3
6445 getgrent_r.3
6446 getgrouplist.3
6447 getpwent_r.3
6448 getutent.3
6449 hsearch.3
6450 rtime.3
6451 strptime.3
6452 tsearch.3
6453 vcs.4
6454 wordexp.3
6455     mtk
6456         s/return 0/exit(EXIT_FAILURE)/ in main() of function example
6457         program.
6458         Reason: consistency.
6459
6460 mprotect.2
6461 select_tut.2
6462 dlopen.3
6463 getgrent_r.3
6464 getopt.3
6465 getpwent_r.3
6466 hsearch.3
6467 select_tut.2
6468 tsearch.3
6469     mtk
6470         Use symbolic constants (EXIT_SUCCESS, EXIT_FAILURE) in calls
6471         to exit().
6472         Reason: consistency.
6473
6474 access.2
6475 chown.2
6476 lseek.2
6477 open.2
6478 read.2
6479 utmp.5
6480     mtk
6481         Renamed RESTRICTIONS section to NOTES, or moved text in a
6482         RESTRICTIONS section under existing NOTES section.
6483         Reason: consistency, and reduce number of arbitrary section (.SH)
6484         names.
6485
6486
6487 Changes to individual pages
6488 ---------------------------
6489
6490 capget.2
6491     mtk
6492         s/\.SH FURTHER INFORMATION/.SH NOTES/
6493
6494 dup.2
6495     mtk
6496         s/\.SH WARNING/.SH NOTES/
6497
6498 kill.2
6499     mtk
6500         Renamed LINUX HISTORY section to LINUX NOTES, and relocated
6501         within page.
6502
6503 select_tut.2
6504     mtk
6505         Relocated example program and made its .SH title "EXAMPLE".
6506
6507 sigaltstack.2
6508     mtk
6509         Move code example into its own EXAMPLE section.
6510
6511 sigreturn.2
6512     mtk
6513         s/\.SH WARNING/.SH NOTES/
6514
6515 setuid.2
6516     mtk
6517         s/\.SH "LINUX-SPECIFIC REMARKS"/.SH LINUX NOTES/
6518
6519 shmget.2
6520     mtk
6521         Remove section about effect of fork()/exec()/exit(); shmop.2
6522         contains the same text, and it only needs to be said once.
6523
6524 shmop.2
6525     mtk
6526         Minor rewording under DESCRIPTION.
6527
6528 daemon.3
6529     mtk
6530         Minor wording and formatting changes.
6531
6532 encrypt.3
6533     mtk
6534         Removed statement that glibc unconditionally exposes declarations
6535         of encrypt() and setkey(), since portable applications must
6536         use <unistd.h> and define _XOPEN_SOURCE to obtain the declarations
6537         of setkey() and encrypt().  Adjusted example program accordingly.
6538
6539 mkstemp.3
6540     mtk
6541         Slight rewording.
6542
6543 LDP.7
6544     mtk
6545         Minor wording and formatting changes.
6546
6547 man.7
6548     mtk
6549         Substantial rewrite, revising and extending the discussion
6550         about desired conventions for writing pages.
6551         There will be further updates to this page in the next few
6552         man-pages releases.
6553
6554
6555 ==================== Changes in man-pages-2.53 ====================
6556
6557 Released: 2007-05-30
6558
6559     "A foolish consistency is the hobgoblin of little minds, adored by
6560      little statesmen and philosophers and divines"
6561
6562         Ralph Waldo Emerson (1803-1882)
6563
6564     "But damn it, these man pages are a mess!"
6565
6566
6567 Global changes
6568 --------------
6569
6570 Many many pages
6571     mtk
6572         Reordered sections to be more consistent, in some cases renaming
6573         sections or shifting paragraphs between sections.
6574
6575 man7/*
6576     mtk
6577         In various pages in this section, .SH headings were
6578         converted to .SS.
6579
6580
6581 ==================== Changes in man-pages-2.54 ====================
6582
6583 Released: 2007-06-07
6584
6585 Contributors
6586 ------------
6587
6588 The following people contributed notes, ideas, or patches that have
6589 been incorporated in changes in this release:
6590
6591 Emmanuel Mogenet <emogenet@google.com>
6592 Michael Berg <michaeljberg@gmail.com>
6593
6594 Apologies if I missed anyone!
6595
6596
6597 Global changes
6598 --------------
6599
6600 Various pages
6601     mtk
6602         Where there is an instruction in the SYNOPSIS about linking
6603         or compiling with a certain option, the option is now
6604         marked up in italics (e.g., "\fI-lm\fP").
6605
6606 Various pages
6607     mtk
6608         Added page numbers to page cross references.
6609
6610 A few pages
6611     mtk
6612         s/manpage/man page/, for consistency.
6613
6614 Typographical or grammatical errors have been corrected in several
6615 places.
6616
6617
6618 New pages
6619 ---------
6620
6621 man-pages.7
6622     mtk
6623         A description of the conventions that should be followed
6624         when writing pages for the man-pages package.
6625
6626 Removed pages
6627 -------------
6628
6629 man1/README
6630     mtk
6631         Already deleted most of the man1 pages previously, so
6632         this doesn't need to stay.
6633
6634 LDP.7
6635     mtk
6636         Removed this page since it is out of date, and the proper place
6637         to go for up-to-date information is http://www.tldp.org/
6638
6639 ksoftirq.9
6640     mtk
6641         Reason: this was the only Section 9 page, and it is old
6642         (Linux 2.4).  The man9 section never took off as an idea, and
6643         I see little point in keeping a Section 9 with just a single
6644         old page.
6645
6646
6647 Changes to individual pages
6648 ---------------------------
6649
6650 HOWTOHELP
6651     mtk
6652         Moved some material out of here into new man-pages.7.
6653
6654 alloc_hugepages.2
6655     mtk
6656         Minor rewrites, eliminating some duplication, and removing
6657         some outdated text.
6658
6659 epoll_pwait.2
6660     Michael Berg
6661         Fix broken link path;
6662         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=425570
6663
6664 fcntl.2
6665     mtk
6666         Remove misleading text about setting O_ASYNC when calling
6667         open(); one must use fcntl() F_SETFL for this task.
6668
6669 fdatasync.2
6670     mtk
6671         Converted outdated BUGS note about fdatasync() being
6672         equivalent to fsync() on Linux 2.2 into a NOTES note
6673         about this historical behavior.
6674
6675 futex.2
6676     mtk
6677         Small rewording to fix "fails with the error EWOULDBLOCK"
6678         rather than "returns EWOULDBLOCK".
6679         See Red Hat bug 172828.
6680
6681 mprotect.2
6682     mtk, after an observation by Emmanuel Mogenet
6683         A much improved example program.
6684     mtk
6685         Significant rewrites and additions to description.
6686
6687 mremap.2
6688     mtk
6689         Remove text about the nonexistent BSD mremap() -- too
6690         much information, in my opinion.
6691
6692 sched_yield.2
6693     mtk
6694         Added ERRORS section.
6695
6696 set_mempolicy.2
6697     mtk
6698         Moved text for "Versions and Library Support".
6699
6700 set_tid_address.2
6701     mtk
6702         Small rewording in RETURN VALUE section.
6703
6704 sigaction.2
6705     mtk
6706         Add EXAMPLE section with a pointer to example in mprotect.2.
6707
6708 sync_file_range.2
6709     mtk
6710         Fix return type in SYNOPSIS.  Add RETURN VALUE section.
6711
6712 atexit.3
6713     mtk
6714         Small rearrangement of text under NOTES.
6715
6716 bindresvport.3
6717     mtk
6718         Rewrite and substantial additional text.
6719
6720 exec.3
6721     mtk
6722         Minor clarifications for text on execlp() and execvp().  Removed
6723         FILES section, since it provides no useful additional info.
6724
6725 fenv.3
6726     mtk
6727         Moved link instructions from NOTES to SYNOPSIS.
6728         Added feenableexcept, fedisableexcept, fegetexcept
6729         to .SH NAME list.
6730
6731 fputwc.3
6732     mtk
6733         Added 'putwc' to .SH NAME list.
6734
6735 gethostbyname.3
6736     mtk
6737         s/int/socklen_t/ for type of gethostbyaddr() 'len' argument,
6738         and add a few more words in NOTES about the type used here.
6739
6740 login.3
6741     mtk
6742         Removed remark from NOTES about linking with -lutil; add
6743         text on that point to SYNOPSIS.
6744
6745 openpty.3
6746     mtk
6747         Removed redundant remark from NOTES about linking with -lutil
6748         since there is text on that point under SYNOPSIS.
6749
6750 sysconf.3
6751     mtk
6752         Added SEE ALSO referring to getconf(1).
6753
6754 unlocked_stdio.3
6755     mtk
6756         Revised .SH NAME section.
6757
6758 ascii.7
6759     mtk
6760         Minor rearrangement of order of text.
6761
6762 capabilities.7
6763     mtk
6764         s/exec()/execve(2)/ in various places.
6765
6766 complex.7
6767     mtk
6768         Changed "atan(1)" to "atan(1.0)" to prevent some versions of
6769         man2html(1) from mistaking that string as a page cross reference.
6770
6771 rtnetlink.7
6772     mtk
6773         Small restructuring to avoid 'cannot adjust line' from man(1).
6774
6775 ldconfig.8
6776     mtk
6777         Removed now very out-of-date sentence about need to link shared
6778         libraries with -lc.
6779
6780 man.7
6781     mtk
6782         Various text was moved out of this page into the new man-pages.7.
6783
6784 mdoc.7
6785     mtk
6786         Added SEE ALSO referring to new man-pages.7.
6787
6788 mdoc.samples.7
6789     mtk
6790         A few changes, hopefully done right, to eliminate some
6791         errors to stderr when rendering with man(1).
6792
6793 rtnetlink.7
6794     mtk
6795         Shorten a line in table so it fits in 80 columns.
6796         Minor rewording under BUGS.
6797
6798 tzselect.8
6799     mtk
6800         Moved EXIT STATUS section.
6801
6802
6803 ==================== Changes in man-pages-2.55 ====================
6804
6805 Released: 2007-06-10
6806
6807 Contributors
6808 ------------
6809
6810 The following people contributed notes, ideas, or patches that have
6811 been incorporated in changes in this release:
6812
6813 Alexander Taboriskiy <alextab@math-solution.com>
6814 Joey Hess <joeyh@debian.org>
6815 John Reiser <jreiser@bitwagon.com>
6816 Julien Cristau <jcristau@debian.org>
6817 Justin Pryzby <justinpryzby@users.sourceforge.net>
6818 Martin (Joey) Schulze <joey@infodrom.org>
6819 Mike Frysinger <vapier@gentoo.org>
6820 Serge van den Boom <svdb@stack.nl>
6821 Ulrich Drepper <drepper@redhat.com>
6822 Xose Vazquez Perez <xose.vazquez@gmail.com>
6823
6824 Apologies if I missed anyone!
6825
6826
6827 Global changes
6828 --------------
6829
6830 clone.2
6831 getdents.2
6832 gettid.2
6833 ioprio_set.2
6834 llseek.2
6835 mmap2.2
6836 modify_ldt.2
6837 mq_getsetattr.2
6838 pivot_root.2
6839 quotactl.2
6840 readdir.2
6841 sysctl.2
6842 syslog.2
6843 tkill.2
6844     mtk, after a note by Mike Frysinger
6845         Updated to reflect the fact that the _syscallN() macros
6846         have gone away,
6847
6848 Several pages
6849     mtk
6850         Change reference to path_resolution.2 to path_resolution.7.
6851
6852 Typographical or grammatical errors have been corrected in several
6853 places.
6854
6855
6856 Moved pages
6857 -----------
6858
6859 path_resolution.2 has been moved to section 7, thus path_resolution.7
6860     mtk
6861         Reason: this is an overview page, not one describing as
6862         a specific system call.
6863
6864
6865 Changes to individual pages
6866 ---------------------------
6867
6868 MAINTAINING
6869     mtk, after a note from Xose Vazquez Perez
6870         Added pointer to Red Hat man-pages bugzilla.
6871     mtk
6872         Added a release philosophy note on separating out big
6873         formatting changes into their own release that contains minimal
6874         content changes.
6875
6876 accept.2
6877     mtk
6878         Add new EXAMPLE section with pointer to example in bind.2.
6879
6880 arch_prctl.2
6881     mtk
6882         Added RETURN VALUE section.
6883
6884 bind.2
6885     mtk
6886         Expand example program, and move it to new EXAMPLE section.
6887         Added text pointing to example in getaddrinfo.3.
6888
6889 cacheflush.2
6890     mtk
6891         Convert NOTES section to CONFORMING TO and note that
6892         this call is Linux-specific.
6893         Other minor rewordings.
6894
6895 connect.2
6896     mtk
6897         Added new EXAMPLE section pointing to example in getaddrinfo.3.
6898
6899 create_module.2
6900     mtk
6901         Add ENOSYS error.
6902
6903 fcntl.2
6904 flock.2
6905     mtk
6906         Small rewrite of SEE ALSO text pointing to Documentation/* in
6907         kernel source.
6908
6909 get_kernel_syms.2
6910     mtk
6911         Added ERRORS heading
6912         Add ENOSYS error.
6913
6914 getdtablesize.2
6915     mtk
6916         Added an ERRORS section.
6917
6918 getsid.2
6919     mtk
6920         Added a RETURN VALUE section.
6921
6922 getpid.2
6923     mtk
6924         Added an ERRORS section (stating that the calls are
6925         always successful).
6926
6927 ioctl_list.2
6928     mtk
6929         Add SEE ALSO reference to ioctl.2.
6930
6931 listen.2
6932     mtk
6933         Add new EXAMPLE section with pointer to example in bind.2.
6934
6935 query_module.2
6936     Martin (Joey) Schulze
6937         Add ENOSYS error.
6938
6939 recv.2
6940     mtk
6941         Added new EXAMPLE section pointing to example in getaddrinfo.3.
6942
6943 sched_get_priority_max.2
6944 sched_rr_get_interval.2
6945 sched_setscheduler.2
6946 sched_yield.2
6947     mtk
6948         Modified .TH line
6949
6950 send.2
6951     mtk
6952         Added new EXAMPLE section pointing to example in getaddrinfo.3.
6953
6954 set_tid_address.2
6955     mtk
6956         Added an ERRORS section (stating that the call is
6957         always successful).
6958
6959 signal.2
6960     mtk, after a note from Alexander Taboriskiy
6961         Strengthen warning against the use of signal().
6962         Added siginterrupt(3) to SEE ALSO list.
6963     mtk
6964         Rewrote various parts; added an ERRORS section.
6965
6966 socket.2
6967     mtk
6968         Added new EXAMPLE section pointing to example in getaddrinfo.3.
6969
6970 stat.2
6971     mtk
6972         Added EXAMPLE program.
6973
6974 syscall.2
6975     mtk
6976         Converted to -man format; some rewrites; added an EXAMPLE.
6977
6978 sysctl.2
6979     mtk
6980         Improved the example program.
6981
6982 getnameinfo.3
6983     mtk
6984         Add text pointing to example in getaddrinfo.3.
6985
6986 getaddrinfo.3
6987     mtk
6988         Add example programs.
6989         Add getnameinfo() to SEE ALSO list.
6990
6991 memmove.3
6992     mtk / Serge van den Boom
6993         Clarify discussion of what happens if 'src' and 'dest' overlap.
6994
6995 regex.3
6996     Justin Pryzby
6997         Add grep(1) to SEE ALSO list.
6998
6999 sigpause.3
7000     mtk after a note from Ulrich Drepper
7001         Clarify discussion of feature test macros that are needed to
7002         expose System V and BSD versions of this function in glibc.
7003
7004 undocumented.3
7005     mtk
7006         Removed some functions that have been documented.
7007
7008 wprintf.2
7009     Martin (Joey) Schulze
7010         Remove wscanf.3 from SEE ALSO list, since that page does not exist.
7011
7012 utmp.5
7013     Joey Hess
7014         Removed outdated note on xdm.
7015         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=418009
7016     Martin (Joey) Schulze
7017         Removed outdated note about Debian and libc5.
7018
7019 bootparam.7
7020     Martin (Joey) Schulze
7021         Fix order of commands listed under 'init='.
7022
7023 hier.7
7024     Joey Hess
7025         Add /media, remove /dos.
7026         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=418234
7027
7028 inotify.7
7029     mtk
7030         Added text describing what happens when the buffer given to
7031         read(2) is too small to return information about the next event,
7032         and noting the behavior change in 2.6.21.
7033
7034 man-pages.7
7035     mtk
7036         Added text to note that ERRORS list should be in alphabetical order.
7037
7038 mdoc.7
7039 mdoc.samples.7
7040     mtk
7041         Added SEE ALSO reference to groff_mdoc(7).
7042
7043 unix.7
7044     mtk
7045         Added  EXAMPLE section with pointer to bind.2 EXAMPLE.
7046
7047 ld.so.8
7048     mtk
7049         Simplify text describing --inhibit-rpath.
7050     mtk, after a note by John Reiser
7051         Describe use of $ORIGIN in rpath.
7052
7053
7054 ==================== Changes in man-pages-2.56 ====================
7055
7056 Released: 2007-06-11
7057
7058 Global changes
7059 --------------
7060
7061 Many pages
7062     mtk
7063         Removed version numbers in .TH lines.
7064         Reason: these were only arbitrarily updated, and so impart no
7065         useful information.  Version information goes into a
7066         VERSIONS section nowadays, and the date in the .TH line should
7067         be updated to reflect the date of the last (significant)
7068         change to the page.
7069
7070 Typographical or grammatical errors have been corrected in several
7071 places.
7072
7073
7074 ==================== Changes in man-pages-2.57 ====================
7075
7076 Released: 2007-06-17
7077
7078 Contributors
7079 ------------
7080
7081 The following people contributed notes, ideas, or patches that have
7082 been incorporated in changes in this release:
7083
7084 Samuel Thibault <samuel.thibault@ens-lyon.org>
7085
7086 Apologies if I missed anyone!
7087
7088
7089 Global changes
7090 --------------
7091
7092 Many pages
7093     mtk
7094         Fix section numbers in page cross references.
7095
7096
7097 Changes to individual pages
7098 ---------------------------
7099
7100 access.2
7101     mtk
7102         Minor wording fixes.
7103         Small clarification of description of 'mode'.
7104
7105 bind.2
7106     mtk
7107         Small reworking of EXAMPLE program.
7108
7109 exit_group.2
7110     mtk
7111         Minor wording fixes.
7112
7113 exit.3
7114     mtk
7115         Added more detail on exit handlers.
7116         Minor wording fixes.
7117
7118 ioctl.2
7119     mtk
7120         Remove SEE ALSO reference to nonexistent mt.4.
7121
7122 modify_ldt.2
7123     Samuel Thibault / mtk
7124         In Linux 2.6, the 'modify_ldt_ldt_s' structure was renamed
7125         'user_desc'.
7126         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=378668
7127     mtk
7128         Include definition of 'user_desc' structure.
7129         Minor rewordings.
7130
7131 mprotect.2
7132     mtk
7133         Small reworking of EXAMPLE program.
7134
7135 sigaction.2
7136     mtk
7137         Removed reference to nonexistent sigsend(2).
7138
7139 a64l.3
7140     mtk
7141         Remove SEE ALSO reference to nonexistent itoa.3.
7142
7143 dysize.3
7144     mtk
7145         Removed SEE ALSO reference to nonexistent time.3.
7146
7147 encrypt.3
7148     mtk
7149         Removed SEE ALSO reference to nonexistent fcrypt.3.
7150
7151 fmemopen.3
7152     mtk
7153         Small reworking of EXAMPLE program.
7154
7155 fpurge.3
7156     mtk
7157         Remove SEE ALSO reference to nonexistent fclean.3.
7158
7159 getutent.3
7160     mtk
7161         s/ttyname(0)/ttyname(STDIN_FILENO)/ in program example.
7162
7163 vcs.4
7164     mtk
7165         s/exit(1)/exit(EXIT_FAILURE)/
7166
7167 environ.7
7168     mtk
7169         Correct some section numbers in page cross references.
7170
7171 man-pages.7
7172     mtk
7173         Modify requirements for example programs a little.
7174
7175 uri.7
7176     mtk
7177         Wrapped long source lines.
7178
7179
7180 ==================== Changes in man-pages-2.58 ====================
7181
7182 Released: 2007-06-24
7183
7184 Contributors
7185 ------------
7186
7187 The following people contributed notes, ideas, or patches that have
7188 been incorporated in changes in this release:
7189
7190 Marc Boyer <marc.boyer@enseeiht.fr>
7191 Mike Frysinger <vapier@gentoo.org>
7192
7193 Apologies if I missed anyone!
7194
7195
7196 Global changes
7197 --------------
7198
7199 Various pages, as detailed below
7200     mtk
7201         Added or updated VERSIONS sections.
7202
7203 killpg.2
7204 setuid.2
7205 faccessat.2
7206 fork.2
7207 setfsuid.2
7208 kill.2
7209 getsid.2
7210 wait.2
7211 execve.2
7212 getpid.2
7213 setgid.2
7214 seteuid.2
7215 setresuid.2
7216 setfsgid.2
7217 access.2
7218 initgroups.3
7219 euidaccess.3
7220 tcgetpgrp.3
7221 path_resolution.7
7222 capabilities.7
7223 unix.7
7224     mtk
7225         Add SEE ALSO link to new credentials.7.
7226
7227
7228 New pages
7229 ---------
7230
7231 credentials.7
7232     mtk
7233         An overview of Linux process identifiers (PIDs, PPIDs,
7234         PGIDS, SIDs, UIDs, GIDs).
7235
7236
7237 Changes to individual pages
7238 ---------------------------
7239
7240 bind.2
7241     mtk
7242         Added some comments to example program.
7243
7244 getxattr.2
7245     mtk
7246         VERSIONS: In kernel since 2.4; glibc support since 2.3.
7247
7248 listen.2
7249     mtk
7250         Updated discussion of somaxconn limit.
7251
7252 listxattr.2
7253     mtk
7254         VERSIONS: In kernel since 2.4; glibc support since 2.3.
7255
7256 posix_fadvise.2
7257     mtk
7258         VERSIONS: Glibc support has been provided since version 2.2.
7259
7260 readahead.2
7261     mtk
7262         Added VERSIONS section.
7263
7264 remap_file_pages.2
7265     mtk
7266         Updated VERSIONS section with text on glibc support.
7267
7268 removexattr.2
7269     mtk
7270         VERSIONS: In kernel since 2.4; glibc support since 2.3.
7271
7272 semop.2
7273     mtk
7274         Added VERSIONS section with info on semtimedop().
7275
7276 setxattr.2
7277     mtk
7278         VERSIONS: In kernel since 2.4; glibc support since 2.3.
7279
7280 dl_iterate_phdr.3
7281     mtk
7282         VERSIONS: Supported since glibc 2.2.4.
7283
7284 getloadavg.3
7285     mtk
7286         Added VERSIONS section.
7287
7288 posix_openpt.3
7289     mtk
7290         VERSIONS: Supported since glibc 2.2.1.
7291
7292 printf.3
7293     mtk after a suggestion by Mike Frysinger
7294         Add text to the introductory part of DESCRIPTION, about the
7295         'size' argument of snprintf() and vsnprintf().
7296
7297 shm_open.3
7298     mtk
7299         Added VERSIONS section; rewrote info about linking with -lrt.
7300
7301 strcat.3
7302     Marc Boyer
7303         Improve the discussion of strncat().
7304
7305 strcpy.3
7306     Marc Boyer
7307         Improve the discussion of strncpy().
7308
7309 proc.5
7310     mtk
7311         Added discussion of /proc/sys/net/core/somaxconn.
7312
7313
7314 ==================== Changes in man-pages-2.59 ====================
7315
7316 Released: 2007-06-25
7317
7318 Global changes
7319 --------------
7320
7321 Manual pages are now standardized on American spelling.  See
7322 http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences
7323 for more information on the differences.  Formerly, different pages (and
7324 sometimes even a single page!) employed American and British spelling
7325 conventions; best to standardize on one spelling, and American English
7326 is the standard in Computer Science.
7327
7328 Changes to individual pages
7329 ---------------------------
7330
7331 man-pages.7
7332     mtk
7333         Note that man-pages has now standardized on American spelling
7334         conventions.
7335
7336 execve.2
7337 getxattr.2
7338 listxattr.2
7339 removexattr.2
7340 setxattr.2
7341 signal.2
7342 syscall.2
7343 aio_cancel.3
7344 bindresvport.3
7345 stdarg.3
7346 charmap.5
7347 bootparam.7
7348 ipv6.7
7349 man.7
7350 path_resolution.7
7351 uri.7
7352 nscd.8
7353     mtk
7354         Corrected minor spelling/wording mistakes (i.e., changes
7355         independent of fixes for American spelling).
7356
7357
7358 ==================== Changes in man-pages-2.60 ====================
7359
7360 Released: 2007-06-25
7361
7362
7363 Global changes
7364 --------------
7365
7366 Various pages
7367     mtk
7368         Wrapped lines in some files.
7369
7370 Various pages
7371     mtk
7372         Change "e.g. " to "e.g., ", or in some cases, "for example, ".
7373
7374 Various pages
7375     mtk
7376         Change "i.e. " to i.e., ", or in some cases, "that is, ".
7377
7378 Various pages
7379     mtk
7380         Removed AUTHORS section.
7381
7382 Typographical or grammatical errors have been corrected in several
7383 places.
7384
7385
7386 Changes to individual pages
7387 ---------------------------
7388
7389 vfork.2
7390     mtk
7391         s/w.r.t/with respect to/
7392
7393 man-pages.7
7394     mtk
7395         Strengthened warning against use of AUTHORS section.
7396
7397
7398 ==================== Changes in man-pages-2.61 ====================
7399
7400 Released: 2007-07-01
7401
7402
7403 Contributors
7404 ------------
7405
7406 The following people contributed notes, ideas, or patches that have
7407 been incorporated in changes in this release:
7408
7409 Alain Portal <aportal@univ-montp2.fr>
7410 Benno Schulenberg <bensberg@justemail.net>
7411 Florian Ernst <florian_ernst@gmx.net>
7412 Ivana Varekova <varekova@redhat.com>
7413 Jeff Schroeder <jeffschroeder@computer.org>
7414 Joey (Martin) Schulze <joey@infodrom.org>
7415 Justin Pryzby <justinpryzby@users.sourceforge.net>
7416 Loïc Minier <lool@dooz.org>
7417 Michael Gehring <mg@ebfe.org>
7418 Serge van den Boom <svdb@stack.nl>
7419 Stefan Puiu <stefanpuiuro@yahoo.com>
7420 Stepan Kasal <kasal@ucw.cz>
7421
7422 Apologies if I missed anyone!
7423
7424
7425 Global changes
7426 --------------
7427
7428 Various pages
7429     mtk
7430         substitute `\\0' by '\\0'.
7431
7432 Various pages
7433     mtk
7434         s/`/'/ when the thing being quoted is a character.
7435
7436 accept.2
7437 bind.2
7438 connect.2
7439 getsockopt.2
7440 listen.2
7441 socket.2
7442 socketpair.2
7443     mtk after a note by Martin (Joey) Schulze
7444         Add NOTES paragraph noting that <sys/types.h> isn't required by
7445         POSIX.1-2001 or Linux, but was required on some implementations.
7446
7447 accept.2
7448 getsockname.2
7449 recv.2
7450 vm86.2
7451 send.2
7452 getgrouplist.3
7453 memmem.3
7454 nsswitch.conf.5
7455 putenv.3
7456 wprintf.3
7457     mtk
7458         Replace form `...' with \fI...\fP where the enclosed string
7459         is a pathname, type name, or argument name.
7460
7461 A few files
7462     mtk
7463         s/process' /process's/
7464
7465 gets.3
7466 qsort.3
7467 getaddrinfo.3
7468 rpc.3
7469 ungetwc.3
7470 wcsnrtombs.3
7471 capabilities.7
7472     mtk
7473         Add section number to page cross references.
7474
7475 time.1
7476 bind.2
7477 pivot_root.2
7478 sysctl.2
7479     mtk
7480         Reordered .SH sections.
7481
7482 full.4
7483 mouse.4
7484 random.4
7485 sd.4
7486     mtk
7487         Made CONFIG/CONFIGURING heading ==> CONFIGURATION
7488
7489 time.1
7490 console_codes.4
7491 random.4
7492 sk98lin.4
7493 charmap.5
7494 ftpusers.5
7495 bootparam.7
7496 charsets.7
7497 glob.7
7498 mq_overview.7
7499 unicode.7
7500 uri.7
7501 utf-8.7
7502     mtk
7503         Reformatted headings
7504
7505
7506 New pages
7507 ---------
7508
7509 backtrace.3
7510     mtk, with input from Justin Pryzby and Stefan Puiu
7511         Documents backtrace(), backtrace_symbols(), and
7512         backtrace_symbols_fd().
7513
7514
7515 New links
7516 ---------
7517
7518 backtrace_symbols.3
7519 backtrace_symbols_fd.3
7520     mtk
7521         Links to backtrace.3.
7522
7523 __clone.2
7524     Stepan Kasal
7525         Link to clone.2.
7526
7527
7528 Changes to individual pages
7529 ---------------------------
7530
7531 Makefile
7532     Serge van den Boom
7533         Fix setting of 'prefix' macro.
7534
7535 eval.1p
7536     Benno Schulenberg
7537         Fix bad text (concatenated line).
7538
7539 chdir.2
7540     mtk
7541         Fixed description of EACCES error.
7542         Added sentence defining "current working directory".
7543         Other minor wording changes.
7544
7545 cfree.3
7546     mtk
7547         Added SEE ALSO section.
7548
7549 clone.2
7550     mtk
7551         s/clone2/__clone2/.
7552
7553 fdatasync.2
7554     mtk
7555         Minor wording changes.
7556
7557 fork.2
7558     Alain Portal
7559         Fix small wording error.
7560
7561 gethostid.2
7562     Stefan Puiu / mtk
7563         Add NOTES on what happens if gethostid() can't open /etc/hostid.
7564
7565 idle.2
7566     mtk
7567         Made NOTES text into a VERSIONS section, since that's what it
7568         really describes.
7569
7570 ioperm.2
7571     mtk
7572         Minor wording changes.
7573
7574 intro.2
7575     mtk
7576         Rewrite to reflect the fact that the _syscallN
7577         macros are no longer available.
7578
7579 io_cancel.2
7580     mtk
7581         Add "Link with -laio" to SYNOPSIS.
7582
7583 io_destroy.2
7584     mtk
7585         Add "Link with -laio" to SYNOPSIS.
7586
7587 io_getevents.2
7588     mtk
7589         Add "Link with -laio" to SYNOPSIS.
7590
7591 io_setup.2
7592     mtk
7593         Add "Link with -laio" to SYNOPSIS.
7594
7595 io_submit.2
7596     Ivana Varekova
7597         Fix include in SYNOPSIS.
7598     mtk
7599         Add "Link with -laio" to SYNOPSIS.
7600
7601 ipc.2
7602     mtk
7603         Add semtimedop() to SEE ALSO.
7604         Note that some architectures don't have ipc(2); instead
7605         real system calls are provided for shmctl(), semctl(), etc.
7606
7607 killpg.2
7608     mtk
7609         Minor wording changes.
7610
7611 listen.2
7612     mtk
7613         Added <sys/types.h> to SYNOPSIS.
7614
7615 sched_setscheduler.2
7616     mtk
7617         Add NOTES para about permissions required to call
7618         sched_setscheduler() on other systems.
7619
7620 select.2
7621     mtk
7622         Noted that 'timeout' can also be changed if select() is
7623         interrupted by a signal.
7624
7625 setup.2
7626     mtk
7627         Remove reference to _syscall0() macro.
7628
7629 shmop.2
7630     mtk
7631         Changed text for EINVAL error.
7632
7633 socketcall.2
7634     mtk
7635         Add recvmsg() and sendmsg() to SEE ALSO.
7636         Note that some architectures don't have socketcall(2); instead
7637         real system calls are provided for socket(), bind(), etc.
7638
7639 swapon.2
7640     Ivana Varekova  / mtk
7641         Update text for EPERM error describing the maximum number of
7642         swap files.  (From downstream Fedora patch.)
7643
7644 write.2
7645     mtk
7646         Added details about seekable files and file offset.
7647         Noted that write() may write less than 'count' bytes, and
7648         gave some examples of why this might occur.
7649         Noted what happens if write() is interrupted by a signal.
7650         Minor wording changes.
7651
7652 __setfpucw.3
7653     mtk
7654         Added a CONFORMING TO section; other minor edits.
7655
7656 confstr.3
7657     mtk
7658         Minor rewrites in code example.
7659
7660 ctime.3
7661     Justin Pryzby
7662         Make SEE ALSO refer to timegm.3
7663
7664 daemon.3
7665     mtk
7666         Small wording change.
7667
7668 dl_iterate_phdr.3
7669     Michael Gehring
7670         Comment was missing closing "*/".
7671
7672 dlopen.3
7673     mtk
7674         Formatting changes, and minor rewordings.
7675     mtk, after a note by Serge van den Boom
7676         Add a comment explaining the need for the rather
7677         strange cast of the return value of dlsym().
7678
7679 fpclassify.3
7680     mtk
7681         Add "isinf" to NAME section.
7682
7683 getgrouplist.3
7684     mtk
7685         Minor rewording.
7686
7687 getline.3
7688     mtk
7689         Minor rewording, and note that '*n* is ignored
7690         if '*lineptr' is NULL.
7691
7692 malloc.3
7693     Ivana Varekova  / mtk
7694         Update description of MALLOC_CHECK_ to include description
7695         for value 3.  (From downstream Fedora patch.)
7696
7697 netlink.3
7698     mtk
7699         Added a CONFORMING TO section; other minor edits.
7700
7701 openpty.3
7702     mtk
7703         Minor changes to SYNOPSIS.
7704
7705 program_invocation_name.3
7706     mtk
7707         Shortened page title to INVOCATION_NAME.
7708
7709 rtnetlink.3
7710     mtk
7711         Added a CONFORMING TO section; other minor edits.
7712
7713 scanf.3
7714     Florian Ernst
7715         Fix duplicated word "the".
7716         (Really fix http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=412467 !)
7717
7718 select_tut.3
7719     mtk
7720         Small wording change.
7721
7722 setnetgrent.3
7723     mtk
7724         Added a CONFORMING TO section.
7725
7726 sigpause.3
7727     mtk
7728         Added a CONFORMING TO section.
7729
7730 strftime.3
7731     Just Pryzby
7732         Small wording fix.
7733     mtk
7734         Note use of "gcc -Wno-format-y2k" to avoid the "`%c' yields only
7735         last 2 digits of year in some locales" warning.
7736
7737 strstr.3
7738     mtk
7739         Add "strcasestr" to NAME section.
7740
7741 syslog.3
7742     mtk
7743         Small wording change.
7744
7745
7746 termios.3
7747     mtk
7748         Reformat SYNOPSIS.
7749         Added a CONFORMING TO section.
7750
7751 timegm.3
7752     mtk
7753         Small wording changes.
7754
7755 ulimit.3
7756     mtk
7757         Remove erroneous text saying that glibc does not provide
7758         <ulimit.h>; it does.
7759
7760 initrd.4
7761     mtk
7762         Various reformattings.
7763
7764 core.5
7765     mtk
7766         Added a sentence noting why core dumps named "core.PID" were useful
7767         with LinuxThreads.
7768
7769 bootparam.7
7770     mtk
7771         Fix capitalization in .SS headings.
7772
7773 epoll.7
7774     mtk
7775         Language clean ups.
7776
7777 feature_test_macros.7
7778     mtk
7779         Added SEE ALSO section.
7780
7781 mq_overview.7
7782     mtk
7783         Reformatted headings; minor rewrites.
7784
7785 sem_overview.7
7786     mtk
7787         Reformatted headings; minor rewrites.
7788
7789 socket.7
7790     Loïc Minier <lool@dooz.org>
7791         Document argument type for SO_REUSEADDR.
7792         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=255881
7793
7794 uri.7
7795     mtk
7796         Wrap long line in SYNOPSIS.
7797
7798 ldconfig.8
7799     mtk
7800         Added SEE ALSO section.
7801
7802
7803 ==================== Changes in man-pages-2.62 ====================
7804
7805 Released: 2007-07-09
7806
7807 This release consists solely of formatting fixes.  There are no changes
7808 to content.
7809
7810 Contributors
7811 ------------
7812
7813 The following people contributed notes, ideas, or patches that have
7814 been incorporated in changes in this release:
7815
7816 Stepan Kasal <kasal@ucw.cz>
7817
7818 Apologies if I missed anyone!
7819
7820
7821 Global changes
7822 --------------
7823
7824 Many many pages
7825     mtk
7826         Many many formatting fixes.
7827
7828 man[013]p/*
7829     Stepan Kasal
7830         Add section number to .TH line for POSIX pages in man[013]p.
7831
7832
7833 ==================== Changes in man-pages-2.63 ====================
7834
7835 Released: 2007-07-16
7836
7837
7838 Contributors
7839 ------------
7840
7841 The following people contributed notes, ideas, or patches that have
7842 been incorporated in changes in this release:
7843
7844 Arnd Bergmann <arndb@de.ibm.com>
7845 Eduardo M. Fleury <efleury@br.ibm.com>
7846 Ivana Varekova <varekova@redhat.com>
7847 Justin Pryzby <justinpryzby@users.sourceforge.net>
7848 Marc Boyer <marc.boyer@enseeiht.fr>
7849 Martin (Joey) Schulze <joey@infodrom.org>
7850 Martin Röhricht <martin@roehricht.info>
7851 Patrick Mansfield <patmans@us.ibm.com>
7852 Pierre Habouzit <madcoder@debian.org>
7853 Stepan Kasal <kasal@ucw.cz>
7854
7855 Apologies if I missed anyone!
7856
7857
7858 Global changes
7859 --------------
7860
7861 gettimeofday.2
7862 madvise.2
7863 msgctl.2
7864 select.2
7865 semctl.2
7866 shmctl.2
7867 syslog.2
7868 stat.2
7869 a64l.3
7870 printf.3
7871 termios.3
7872 xdr.3
7873 sd.4
7874     mtk
7875         Minor wording changes.
7876
7877 obsolete.2
7878 syscall.2
7879 unimplemented.2
7880     mtk
7881         Added SEE ALSO reference to syscalls.2.
7882
7883
7884 New pages
7885 ---------
7886
7887 sgetmask.2
7888     mtk
7889         A real man page for sgetmask(2) and ssetmask(2).
7890         (This page replaces a previous link of the same name, which
7891         linked to signal.2.)
7892
7893 spu_create.2
7894     Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7895         Document the PowerPC SPU spu_create() system call.
7896         (Originally taken from the kernel source file
7897         Documentation/filesystems/spufs.txt.)
7898
7899 spu_run.2
7900     Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7901         Document the PowerPC SPU spu_run() system call.
7902         (Originally taken from the kernel source file
7903         Documentation/filesystems/spufs.txt.)
7904
7905 spufs.7
7906     Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7907         Document the PowerPC SPU file system.
7908         (Originally taken from the kernel source file
7909         Documentation/filesystems/spufs.txt.)
7910
7911
7912 Removed Pages
7913 -------------
7914
7915 __clone.2
7916     mtk
7917         This file was created by accident in 2.61, as a copy of clone.2.
7918         (it should have been a link to clone.2.)
7919
7920 obsolete.2
7921     mtk
7922         Details on this page are covered in syscalls.2 and in
7923         respective syscall man pages (stat.2, uname.2).
7924
7925 undocumented.2
7926     mtk
7927         This page is very out of date, and in any case difficult
7928         to maintain.  Information about undocumented system calls
7929         is maintained in the HOWTOHELP file, and probably in other
7930         places soon.
7931
7932 killpg.3
7933     mtk
7934         This rather incomplete page seems unnecessary since there
7935         is a killpg.2.
7936
7937
7938 New links
7939 ---------
7940
7941 chown32.2
7942 fchown32.2
7943 getegid32.2
7944 geteuid32.2
7945 getgid32.2
7946 getgroups32.2
7947 getresgid32.2
7948 getresuid32.2
7949 getuid32.2
7950 lchown32.2
7951 setfsgid32.2
7952 setfsuid32.2
7953 setgid32.2
7954 setgroups32.2
7955 setregid32.2
7956 setresgid32.2
7957 setresuid32.2
7958 setreuid32.2
7959 setuid32.2
7960     mtk
7961         Added as link to corresponding page without "32".
7962
7963 fcntl64.2
7964 fstat64.2
7965 fstatat64.2
7966 fstatfs64.2
7967 ftruncate64.2
7968 getdents64.2
7969 lstat64.2
7970 pread64.2
7971 pwrite64.2
7972 sendfile64.2
7973 stat64.2
7974 statfs64.2
7975 truncate64.2
7976     mtk
7977         Added as link to corresponding page without "64".
7978
7979 __clone2.2
7980 clone2.2
7981     mtk
7982         Links to clone.2.
7983
7984 ugetrlimit.2
7985     mtk
7986         Link to getrlimit.2.
7987
7988 mq_notify.2
7989 mq_open.2
7990 mq_timedreceive.2
7991 mq_timedsend.2
7992 mq_unlink.2
7993     mtk
7994         Added as links to corresponding section 3 pages.
7995
7996 fadvise64.2
7997 fadvise64_64.2
7998     mtk
7999         Links to posix_fadvise.2.
8000
8001 rt_sigaction.2
8002 rt_sigpending.2
8003 rt_sigprocmask.2
8004 rt_sigtimedwait.2
8005     mtk
8006         Added as link to corresponding page without "rt_" prefix.
8007
8008 rt_sigqueueinfo.2
8009     mtk
8010         Link to sigqueue.2.
8011
8012 madvise1.2
8013 tuxcall.2
8014 vserver.2
8015     mtk / Ivana Varekova
8016         Link to unimplemented.2.
8017
8018
8019 Changes to individual pages
8020 ---------------------------
8021
8022 access.2
8023     mtk
8024         Fairly substantial rewrites of various parts,
8025         and a few additions.
8026
8027 chmod.2
8028     mtk
8029         Update SYNOPSIS to reflect the fact that fchmod(2) needs
8030         either "#define _XOPEN_SOURCE 500" or "#define _BSD_SOURCE".
8031
8032 chown.2
8033     mtk
8034         Update SYNOPSIS to reflect the fact that fchmod(2) and lchown(2)
8035         need either "#define _XOPEN_SOURCE 500" or "#define _BSD_SOURCE".
8036         Added an example program.
8037
8038 killpg.2
8039     mtk
8040         Note that killpg() is actually a library function on Linux.
8041
8042 mmap.2
8043     mtk
8044         Added note that glibc mmap() wrapper nowadays invokes mmap2().
8045
8046 mmap2.2
8047     Ivana Varekova / mtk
8048         On most platforms the unit for 'offset' is 4096 bytes, not
8049         the system page size.
8050     mtk
8051         Rewrote NOTES to note that glibc mmap() wrapper nowadays
8052         invokes this system call.
8053     mtk
8054         Added an EXAMPLE program.
8055
8056 oldfstat.2
8057 oldlstat.2
8058 oldstat.2
8059     mtk
8060         Changed link to point to stat.2 (instead of obsolete.2).
8061
8062 olduname.2
8063 oldolduname.2
8064     mtk
8065         Changed link to point to uname.2 (instead of obsolete.2).
8066
8067 sched_setaffinity.2
8068     Martin Röhricht
8069         Added _GNU_SOURCE to SYNOPSIS.
8070
8071 semctl.2
8072     mtk
8073         Remove reference discussion of ipc(2), since none of the
8074         other System V IPC pages mention ipc(2).
8075
8076 semop.2
8077     mtk
8078         Add an example code segment.
8079
8080 shmctl.2
8081     mtk
8082         Add svipc(7) to SEE ALSO list.
8083
8084 sigaction.2
8085     mtk
8086         Reformatted tables as lists; other minor reformattings and
8087         wording changes.
8088
8089 sigqueue.2
8090     mtk
8091         Added info on rt_sigqueueinfo(2).
8092
8093 sigwaitinfo.2
8094     mtk
8095         Noted that sigwaitinfo() is a library function implemented on
8096         top of sigtimedwait().
8097
8098 ssetmask.2
8099     mtk
8100         Make this link point to new sgetmask.2 instead of signal.2.
8101
8102 stat.2
8103     mtk
8104         Add notes on the different system call interfaces that
8105         have appeared over time.
8106
8107 syscalls.2
8108     mtk
8109         A fairly substantial rewrite of this page,
8110         bringing it up to date with the current
8111         kernel version, and listing all system calls
8112         in tabular form.
8113
8114 uname.2
8115     mtk
8116         Add notes on the different system call interfaces that
8117         have appeared over time.
8118
8119 unimplemented.2
8120     mtk
8121         Add vserver, madvise1 to NAME line.
8122         Removed SEE ALSO reference to obsolete.2.
8123     Ivana Varekova
8124         Add tuxcall to NAME line.
8125
8126 mktemp.3
8127     Patrick Mansfield
8128         Fix description of return value.
8129
8130 strcat.3
8131     Marc Boyer
8132         Minor fix to example program.
8133
8134 undocumented.3
8135     mtk
8136         Add section numbers to function names; remove some functions
8137         since they are documented.
8138
8139 proc.5
8140     mtk
8141         Update/correct text on /proc/malloc.
8142     mtk, after a note by Pierre Habouzit, and a few comments by Justin Pryzby
8143         Update description of /proc/PID/stat to match 2.6.21.
8144         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=417933
8145
8146 inotify.7
8147     mtk
8148         IN_DONT_FOLLOW and IN_ONLYDIR are only available from 2.6.15.
8149
8150 signal.7
8151     Stepan Kasal / mtk
8152         Note SIGRTMIN value depends on glibc.
8153     mtk
8154         Various rewrites and additions to the text in real-time signals.
8155         Add SEE ALSO reference to sgetmask.2.
8156
8157 svipc.7
8158     mtk
8159         Add ipc(2) to SEE ALSO.
8160
8161
8162 ==================== Changes in man-pages-2.64 ====================
8163
8164 Released: 2007-07-27
8165
8166
8167 Contributors
8168 ------------
8169
8170 The following people contributed notes, ideas, or patches that have
8171 been incorporated in changes in this release:
8172
8173 Aleksandr Koltsoff <czr@iki.fi>
8174 Andries Brouwer <Andries.Brouwer@cwi.nl>
8175 Justin Pryzby <justinpryzby@users.sourceforge.net>
8176
8177 Apologies if I missed anyone!
8178
8179
8180 Global changes
8181 --------------
8182
8183 INFINITY.3
8184 _exit.2
8185 a64l.3
8186 abs.3
8187 acct.2
8188 acosh.3
8189 addseverity.3
8190 adjtime.3
8191 asinh.3
8192 atanh.3
8193 atoi.3
8194 brk.2
8195 cbrt.3
8196 cfree.3
8197 chdir.2
8198 chmod.2
8199 chown.2
8200 clearenv.3
8201 clock_getres.3
8202 clone.2
8203 confstr.3
8204 copysign.3
8205 ctermid.3
8206 ctime.3
8207 daemon.3
8208 dirfd.3
8209 div.3
8210 drand48.3
8211 drand48_r.3
8212 dysize.3
8213 ecvt.3
8214 ecvt_r.3
8215 erf.3
8216 euidaccess.3
8217 exp2.3
8218 expm1.3
8219 fdatasync.2
8220 ferror.3
8221 fexecve.3
8222 fgetgrent.3
8223 fgetpwent.3
8224 finite.3
8225 flockfile.3
8226 fopen.3
8227 fpclassify.3
8228 fsync.2
8229 futimes.3
8230 fwide.3
8231 gamma.3
8232 gcvt.3
8233 getcwd.3
8234 getdate.3
8235 getdirentries.3
8236 getdomainname.2
8237 getdtablesize.2
8238 getgrent.3
8239 getgrent_r.3
8240 getgrouplist.3
8241 getgroups.2
8242 gethostbyname.3
8243 gethostid.2
8244 gethostname.2
8245 getlogin.3
8246 getmntent.3
8247 getpagesize.2
8248 getpw.3
8249 getpwent.3
8250 getpwent_r.3
8251 getpwnam.3
8252 getsid.2
8253 getspnam.3
8254 gettimeofday.2
8255 getumask.3
8256 getusershell.3
8257 gsignal.3
8258 hypot.3
8259 inet.3
8260 initgroups.3
8261 insque.3
8262 isalpha.3
8263 iswblank.3
8264 j0.3
8265 kill.2
8266 killpg.2
8267 lgamma.3
8268 lockf.3
8269 log1p.3
8270 log2.3
8271 logb.3
8272 longjmp.3
8273 lrint.3
8274 lround.3
8275 madvise.2
8276 mbsnrtowcs.3
8277 memfrob.3
8278 mincore.2
8279 mkdtemp.3
8280 mknod.2
8281 mkstemp.3
8282 mktemp.3
8283 nan.3
8284 nanosleep.2
8285 nextafter.3
8286 nice.2
8287 on_exit.3
8288 perror.3
8289 posix_memalign.3
8290 posix_openpt.3
8291 printf.3
8292 profil.3
8293 psignal.3
8294 putenv.3
8295 putpwent.3
8296 qecvt.3
8297 rand.3
8298 random.3
8299 rcmd.3
8300 readahead.2
8301 readlink.2
8302 realpath.3
8303 remainder.3
8304 remquo.3
8305 rexec.3
8306 rint.3
8307 round.3
8308 rpmatch.3
8309 scalb.3
8310 scandir.3
8311 scanf.3
8312 seekdir.3
8313 select.2
8314 sem_wait.3
8315 semop.2
8316 setbuf.3
8317 setenv.3
8318 seteuid.2
8319 setjmp.3
8320 setnetgrent.3
8321 setpgid.2
8322 setresuid.2
8323 setreuid.2
8324 sigaltstack.2
8325 siginterrupt.3
8326 significand.3
8327 sigqueue.2
8328 sigvec.3
8329 sigwaitinfo.2
8330 sockatmark.3
8331 stat.2
8332 stime.2
8333 strdup.3
8334 strerror.3
8335 strsep.3
8336 strtod.3
8337 strtok.3
8338 strtol.3
8339 strtoul.3
8340 symlink.2
8341 sync.2
8342 syscall.2
8343 syslog.3
8344 tcgetsid.3
8345 telldir.3
8346 tempnam.3
8347 termios.3
8348 tgamma.3
8349 timegm.3
8350 toascii.3
8351 trunc.3
8352 truncate.2
8353 ttyslot.3
8354 tzset.3
8355 ualarm.3
8356 unlocked_stdio.3
8357 unshare.2
8358 usleep.3
8359 vfork.2
8360 vhangup.2
8361 wait.2
8362 wait4.2
8363 wcscasecmp.3
8364 wcsncasecmp.3
8365 wcsnlen.3
8366 wcsnrtombs.3
8367 wcswidth.3
8368 wordexp.3
8369 wprintf.3
8370     mtk
8371         Added/updated feature test macro requirements for
8372         glibc; see feature_test_macros.7 for details.
8373
8374 Changes to individual pages
8375 ---------------------------
8376
8377 mq_notify.2
8378 mq_open.2
8379 mq_timedreceive.2
8380 mq_timedsend.2
8381 mq_unlink.2
8382     mtk
8383         Fix broken link
8384
8385 setpgid.2
8386     mtk
8387         Fairly substantial changes and corrections, including adding
8388         coverage of all of the interfaces that get/set PGIDs.
8389
8390 syscalls.2
8391     mtk / aeb
8392         Various rewordings; clear up some imprecisions.
8393
8394 lgamma.3
8395     mtk
8396         Added 'signgam' to SYNOPSIS and NAME line.
8397
8398 strerror.3
8399     mtk
8400         Note that the XPG version is provided since glibc 2.3.4.
8401         The page formerly said that the GNU-specific version
8402         is provided by default.  That certainly isn't true
8403         nowadays, since _POSIX_C_SOURCE is set to 200112L by
8404         default, so that the XSI-compliant version is supplied
8405         by default.
8406
8407 man-pages.7
8408     mtk
8409         Added note pointing to feature_test_macros.7 for a description
8410         of how feature test macro requirements should be specified in
8411         manual pages.  Various other minor fixes and changes.
8412
8413 feature_test_macros.7
8414     mtk
8415         Added note about how feature test macros are specified
8416         in manual pages.
8417         Many other corrections, improvements, additions, and
8418         details about differences across glibc versions.
8419
8420
8421 ==================== Changes in man-pages-2.65 ====================
8422
8423 Released: 2007-09-17
8424
8425
8426 Contributors
8427 ------------
8428
8429 The following people contributed notes, ideas, or patches that have
8430 been incorporated in changes in this release:
8431
8432 Aleksandr Koltsoff <czr@iki.fi>
8433 Andi Kleen <ak@suse.de>
8434 Anton Blanchard <anton@samba.org>
8435 Ari Entlich <lmage11@twcny.rr.com>
8436 Carsten Emde <Carsten.Emde@osadl.org>
8437 François Diakhate <diakhate@enseirb.fr>
8438 Geoff Clare <gclare@gclare.org.uk>
8439 Jon Burgess <jburgess777@googlemail.com>
8440 Julien Cristau <jcristau@debian.org>
8441 Lee Schermerhorn <Lee.Schermerhorn@hp.com>
8442 Mats Wichmann <mats.d.wichmann@intel.com>
8443 Maxime Bizon <mbizon@freebox.fr>
8444 Maxime Vaudequin <maxime.vaudequin@gmail.com>
8445 Michael Prokop <mika@grml.org>
8446 Mike Frysinger <vapier@gentoo.org>
8447 Nicolas François <nicolas.francois@centraliens.net>
8448 Nicolas George <nicolas.george@ens.fr>
8449 Paul Brook <paul@nowt.org>
8450 Reuben Thomas <rrt@sc3d.org>
8451 Sam Varshavchik <mrsam@courier-mta.com>
8452 Samuel Thibault <samuel.thibault@ens-lyon.org>
8453 Thomas Huriaux <thomas.huriaux@gmail.com>
8454 Tolga Dalman <tdalman@project-psi.org>
8455 Ulrich Drepper <drepper@redhat.com>
8456 Vincent Lefevre <vincent@vinc17.org>
8457
8458 Apologies if I missed anyone!
8459
8460
8461 Global changes
8462 --------------
8463
8464 Typographical or grammatical errors have been corrected in several
8465 places.
8466
8467 Various pages
8468     mtk
8469         Use 'glibc' consistently to refer to GNU C library.
8470
8471 Various pages
8472     mtk
8473         Order errors under ERRORS alphabetically.
8474
8475 Various pages
8476     Nicolas François
8477         Spelling and formatting fixes, as per
8478         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=439560
8479
8480 intro.2
8481 select.2
8482 fmtmsg.3
8483 getgrent_r.3
8484 envz_add.3
8485 rtime.3
8486 strptime.3
8487 wordexp.3
8488     Maxime Vaudequin
8489         Add "#include <stdlib.h>" (to declare exit(3)) to example program.
8490
8491
8492 New pages
8493 ---------
8494
8495 timeradd.3
8496     mtk
8497         Description of timeradd(), timersub(), timerclear(),
8498         timerisset(), timercmp() macros for operating on
8499         struct timeval.
8500
8501
8502 Removed pages
8503 -------------
8504
8505 fdatasync.2
8506     mtk
8507         Somehow, over time, material on fdatasync(2) crept into
8508         fsync.2, and fdatasync also got added to the NAME section
8509         of fsync.2.  All of the material in fdatasync.2 that was
8510         not already in fsync.2 has now been moved there, and
8511         the former page has been removed.
8512         In place of the content there, is now a link to fsync.2.
8513
8514
8515 New links
8516 ---------
8517
8518 clock_getres.2
8519 clock_gettime.2
8520 clock_settime.2
8521     mtk
8522         Link to man3/clock_getres.3.
8523
8524 fdatasync.2
8525     mtk
8526         Link to fsync.2.
8527
8528 fdopendir.3
8529     mtk
8530         Link to opendir.3.
8531
8532 gethostbyaddr_r.3
8533     Mats Wichmann
8534         Link to gethostbyaddr.3.
8535
8536 timerclear.3
8537 timercmp.3
8538 timerisset.3
8539 timersub.3
8540     mtk
8541         Links to new timeradd.3.
8542
8543
8544 Changes to individual pages
8545 ---------------------------
8546
8547 Makefile
8548     Mike Frysinger
8549         Make the install target of man-pages respect the standard
8550         "DESTDIR" variable as well as check the exit status of the
8551         install command so errors aren't ignored.
8552
8553 get_mempolicy.2
8554     Lee Schermerhorn
8555         changed the "policy" parameter to "mode" through out the
8556         descriptions in an attempt to promote the concept that the memory
8557         policy is a tuple consisting of a mode and optional set of nodes.
8558
8559         added requirement to link '-lnuma' to synopsis
8560
8561         rewrite portions of description for clarification.
8562
8563         added all errors currently returned by sys call.
8564
8565         removed cautionary note that use of MPOL_F_NODE|MPOL_F_ADDR
8566         is not supported.  This is no longer true.
8567
8568         added mmap(2) to SEE ALSO list.
8569
8570 getitimer.2
8571     mtk
8572         Since kernel 2.6.22, Linux setitimer() now conforms to POSIX.1,
8573         giving an EINVAL error for a non-canonical tv_usec value.
8574
8575 gettimeofday.2
8576     mtk
8577         Replace discussion of timer* macros with a pointer
8578         to new page timeradd.3.
8579
8580 ioctl_list.2
8581     Nicolas George
8582         Fixed argument type for BLKGETSIZE.
8583
8584 mbind.2
8585     Lee Schermerhorn
8586
8587         changed the "policy" parameter to "mode" throughout the
8588         descriptions in an attempt to promote the concept that the memory
8589         policy is a tuple consisting of a mode and optional set of nodes.
8590
8591         rewrite portions of description for clarification.
8592
8593             clarify interaction of policy with mmap()'d files and shared
8594             memory regions, including SHM_HUGE regions.
8595
8596             defined how "empty set of nodes" specified and what this
8597             means for MPOL_PREFERRED.
8598
8599             mention what happens if local/target node contains no
8600             free memory.
8601
8602             clarify semantics of multiple nodes to BIND policy.
8603             Note:  subject to change.  We'll fix the man pages when/if
8604                    this happens.
8605
8606         added all errors currently returned by sys call.
8607
8608         added mmap(2), shmget(2), shmat(2) to SEE ALSO list.
8609
8610 mmap.2
8611 mprotect.2
8612     François Diakhate
8613         Add text noting that PROT_WRITE may (and on x86 does)
8614         imply PROT_READ.
8615         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=441387
8616
8617 nfsservctl.2
8618     Aleksandr Koltsoff
8619         Fix prototype.
8620
8621 oldfstat.2
8622 oldlstat.2
8623 oldstat.2
8624     mtk
8625         Fix broken link
8626
8627 prctl.2
8628     mtk
8629         Update arches/kernel versions for PR_SET_UNALAIGN / PR_GET_UNALIGN.
8630
8631 readahead.2
8632     mtk
8633         Removed SEE ALSO reference to nonexistent fadvise.2.
8634
8635 reboot.2
8636     mtk
8637         Place SYNOPSIS comments inside C comments (/* ... */).
8638
8639 sched_setaffinity.2
8640     Samuel Thibault
8641         Note what thread is affected if 'pid' is specified
8642         as 0, or as the value returned by getpid().
8643
8644 sched_setscheduler.2
8645     Carsten Emde
8646         Add text on real-time features of mainline Linux kernel.
8647
8648 select_tut.2
8649     mtk
8650         sync SYNOPSIS with select.2
8651
8652 set_mempolicy.2
8653     Lee Schermerhorn
8654
8655         changed the "policy" parameter to "mode" throughout the
8656         descriptions in an attempt to promote the concept that the memory
8657         policy is a tuple consisting of a mode and optional set of nodes.
8658
8659         added requirement to link '-lnuma' to synopsis
8660
8661         rewrite portions of description for clarification.
8662
8663             clarify interaction of policy with mmap()'d files.
8664
8665             defined how "empty set of nodes" specified and what this
8666             means for MPOL_PREFERRED.
8667
8668             mention what happens if local/target node contains no
8669             free memory.
8670
8671             clarify semantics of multiple nodes to BIND policy.
8672             Note:  subject to change.  We'll fix the man pages when/if
8673                    this happens.
8674
8675         added all errors currently returned by sys call.
8676
8677         added mmap(2) to SEE ALSO list.
8678
8679 sigaction.2
8680     mtk
8681         s/si_sign/si_errno/ in statement about which field is unused.
8682     Ari Entlich
8683         s/SIGILL/SIGCHLD/ for paragraph describing SIGCHLD.
8684
8685 stat.2
8686     mtk
8687         Improve text describing underlying system calls.
8688
8689 swapon.2
8690     Michael Prokop
8691         EINVAL also occurs if target path is on tmpfs or similar.
8692         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435885
8693
8694 sync.2
8695     mtk
8696         Incorporated material from now deleted fdatasync.2.
8697
8698 syscall.2
8699     mtk
8700         Small fix in example program.
8701
8702 uname.2
8703     mtk
8704         Improve text describing underlying system calls.
8705
8706 utime.2
8707     Vincent Lefevre / mtk
8708         Clarify utimes() behaviour when 'times' is NULL.
8709         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=431480
8710     mtk
8711         Other minor clarifications of description of utimes().
8712
8713 copysign.3
8714     Vincent Lefevre
8715         s/sign/sign bit/ to remove ambiguity in description.
8716         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435415
8717
8718 euidaccess.3
8719     mtk
8720         Changed NOTES to VERSIONS.
8721
8722 ffsl.3
8723     mtk
8724         Add ffsl and ffsll to NAME line.
8725
8726 fts.3
8727     mtk
8728         Removed statement that fts functions are expected to appear
8729         soon in POSIX; it's years old and has not yet come to pass.
8730
8731 ftw.3
8732     mtk / Geoff Clare
8733         Fixes/improvements for example program.
8734
8735 getdate.3
8736     mtk
8737         Add getdate_r to NAME section.
8738
8739 getaddrinfo.3
8740     mtk / Geoff Clare
8741         Fixes/improvements for example program.
8742
8743 gethostbyaddr.3
8744     Mats Wichmann
8745         Add documentation for gethostbyaddr_r().
8746         Plus a few other small fixes.
8747
8748 gethostbyname.3
8749     mtk
8750         Add gethostbyname2, gethostbyname2_r, gethostbyname_r,
8751         gethostent_r to NAME line.
8752
8753 getmntent.3
8754     mtk
8755         Fix misnamed function references.
8756
8757 getopt.3
8758     Jon Burgess
8759         Fix small error in example program.
8760
8761 getrpcent.3
8762     mtk
8763         Add setrpcent and endrpcent to NAME line.
8764
8765 gsignal.3
8766     Aleksandr Koltsoff
8767         Fix gsignal() prototype.
8768
8769 hsearch.3
8770     mtk
8771         Add hcreate_r, hdestroy_r, hsearch_r to NAME line.
8772
8773 inet.3
8774     Maxime Bizon
8775         Correct definition of "struct in_addr".
8776
8777 isatty.3
8778     mtk
8779         Minor wording fix.
8780
8781 isgreater.3
8782     mtk
8783         Add islessequal to NAME line.
8784
8785 lgamma.3
8786     Vincent Lefevre
8787         Fix CONFORMING TO section.
8788         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=417592
8789
8790 log1p.3
8791     mtk
8792         Add log1pf and log1pl to NAME line.
8793
8794 longjmp.3
8795     Paul Brook / mtk
8796         After a call to longjmp(), the values of modified, non-volatile
8797         variables in the function that called setjmp() are unspecified.
8798
8799 makecontext.3
8800     Aleksandr Koltsoff
8801         Fix makecontext() prototype.
8802
8803 malloc.3
8804     mtk / Tolga Dalman
8805         Explain what happens for malloc(0), or calloc() where one of the
8806         arguments is 0.
8807     mtk
8808         Added notes on malloc()'s use of sbrk() and mmap().
8809     mtk
8810         Add mmap(2), alloca(3) to SEE ALSO.
8811
8812 mq_close.3
8813 mq_getattr.3
8814 mq_notify.3
8815 mq_open.3
8816 mq_receive.3
8817 mq_send.3
8818 mq_unlink.3
8819     mtk
8820         Add "Link with -lrt." to SYNOPSIS.
8821
8822 opendir.3
8823     Ulrich Drepper; some edits and additional text by mtk
8824         Document fdopendir().
8825
8826 readdir.3
8827     mtk, after a note by Andi Kleen
8828         Document DT_* constants for d_type.
8829     Ulrich Drepper / mtk
8830         Rework discussion of non-standard structure fields.
8831
8832 sem_wait.3
8833     mtk
8834         Minor improvements to example program.
8835
8836 syslog.3
8837     mtk
8838         Add vsyslog to NAME section.
8839
8840 termios.3
8841     Nicolas François
8842         Fix XCASE feature test macro description.
8843
8844 wcsspn.3
8845     Aleksandr Koltsoff
8846         Add return type to prototype.
8847
8848 proc.5
8849     mtk
8850         Improve description of num_threads field under /proc/PID/stat.
8851     Maxime Vaudequin
8852         Fix path error (s%proc/sys%proc/sys/kernel%) in mentions of
8853         /proc/sys/ostype, /proc/sys/osrelease and proc/sys/version.
8854     Maxime Vaudequin
8855         I noticed things to correct and to clarify in subsection
8856         "/proc/filesystems" of proc.5:
8857         - clarify filesystems listing: not only FS compiled
8858           into the kernel, also FS kernel modules currently loaded
8859         - add a reference to fs(5)
8860         - add an explanation for FS marked with "nodev"
8861         - s/mount(1)/mount(8)/, also corrected in section "SEE ALSO"
8862         - clarify usage by mount: the current wording may lead to
8863           think /proc/filesystems is always used by mount when no FS
8864           is specified. So, usage of "may" which IMHO is more
8865           appropriate + additional explanations
8866           In mount(8) we can see:
8867
8868                If no -t option is given, or if the auto type is
8869                specified, mount will try to guess the desired type.
8870                If mount was compiled with the blkid library, the
8871                guessing is done by this library. Otherwise, mount
8872                guesses itself by probing the superblock; if that
8873                does not turn up anything that looks familiar,
8874                mount will try to read the file /etc/filesystems,
8875                or, if that does not exist, /proc/filesystems.
8876                All of the filesystem types listed there will be
8877                tried, except for those that are labeled "nodev"
8878                (e.g., devpts, proc and nfs). If /etc/filesystems
8879                ends in a line with a single * only, mount will
8880                read /proc/filesystems afterwards.
8881     Samuel Thibault
8882         Since linux 2.6.11, /proc/stat has an eighth value for cpu
8883         lines: stolen time, which is the time spent in other operating
8884         systems when running in a virtualized environment.
8885
8886 arp.7
8887         Updated BUGS text referring to jiffies; refer to time.7 instead.
8888
8889 credentials.7
8890     mtk
8891         Add words to note that file system ID is Linux specific.
8892
8893 hier.7
8894     Maxime Vaudequin
8895         This is some corrections for hier.7:
8896         - missing period for /media and /mnt
8897         - /mnt description is not totally correct, it is true for some
8898           distributions but in others /mnt is used as a temporary FS
8899           mount point, as it is specified by FHS:
8900           http://www.pathname.com/fhs/pub/fhs-2.3.html#MNTMOUNTPOINTFORATEMPORARILYMOUNT
8901         - s/X-Windows/X-Window/ (3 occurrences)
8902         - section "SEE ALSO": s/mount(1)/mount(8)/
8903
8904 man-pages.7
8905 man.7
8906 mdoc.7
8907 mdoc.samples.7
8908     mtk / Nicolas François
8909         Nowadays tmac.XXX are called XXX.tmac.
8910
8911 pthreads.7
8912     mtk
8913         Update text about modern threading implementations
8914         (NPTL vs LinuxThreads).
8915
8916 socket.7
8917     mtk, after a note by Andi Kleen
8918         Clarify that SO_SNDTIMEO and SO_RCVTIMEO only have effect for
8919         socket I/O calls; not for multiplexing system calls like
8920         select() and poll().
8921
8922 time.7
8923     mtk
8924         Add SEE ALSO reference to new timeradd.3.
8925
8926
8927 ==================== Changes in man-pages-2.66 ====================
8928
8929 Released: 2007-10-01
8930
8931
8932 Contributors
8933 ------------
8934
8935 The following people contributed notes, ideas, or patches that have
8936 been incorporated in changes in this release:
8937
8938 Amit K. Arora <aarora@linux.vnet.ibm.com>
8939 David Chinner <dgc@sgi.com>
8940 Fredrik Noring <noring@nocrew.org>
8941 Mats Wichmann <mats.d.wichmann@intel.com>
8942 Maxime Vaudequin <maxime.vaudequin@gmail.com>
8943 Ollie Wild <aaw@google.com>
8944 Ulrich Drepper <drepper@redhat.com>
8945
8946 Apologies if I missed anyone!
8947
8948
8949 Global changes
8950 --------------
8951
8952 Typographical or grammatical errors have been corrected in several
8953 places.
8954
8955
8956 New pages
8957 ---------
8958
8959 fallocate.2
8960     David Chinner, with some input from Amit Amora and mtk
8961         Describes the fallocate() system call, new in 2.6.23.
8962
8963
8964 Changes to individual pages
8965 ---------------------------
8966
8967 close.2
8968     Fredrik Noring
8969         Add text cautioning about use of close() in
8970         multithreaded programs.
8971
8972 execve.2
8973     Ollie Wild / mtk
8974         Add text describing limit on total size of argv + envp,
8975         and changes that occurred with 2.6.23.
8976     mtk
8977         Add getopt(3) to SEE ALSO list.
8978
8979 open.2
8980     mtk, Acked by Ulrich Drepper
8981         Added description of O_CLOEXEC (new in 2.6.23) + other
8982         minor fixes for O_DIRECT.
8983
8984 recv.2
8985     mtk
8986         Added description of MSG_CMSG_CLOEXEC (new in 2.6.23).
8987
8988 sysctl.2
8989     mtk
8990         Strengthened the warning against using this system call
8991         and note that it may disappear in a future kernel version.
8992
8993 rpc.3
8994     Mats Wichmann
8995         Fix type definition for 'protocol' in prototypes of pmap_set()
8996         and pmap_getport().
8997
8998
8999 ==================== Changes in man-pages-2.67 ====================
9000
9001 Released: 2007-10-08
9002
9003
9004 Contributors
9005 ------------
9006
9007 The following people contributed notes, ideas, or patches that have
9008 been incorporated in changes in this release:
9009
9010 Andi Kleen <andi@firstfloor.org>
9011 Andrew Josey <a.josey@opengroup.org>
9012 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9013
9014 Apologies if I missed anyone!
9015
9016
9017 Global changes
9018 --------------
9019
9020 *.1p
9021 *.3p
9022     mtk, after a note by Andi Kleen and consultation with Andrew Josey.
9023         Add a PROLOG section:
9024             This manual page is part of the POSIX Programmer's Manual.
9025             The Linux implementation of this interface may differ
9026             (consult the corresponding Linux manual page for details
9027             of Linux behavior), or the interface may not be implemented
9028             on Linux.
9029
9030 *.0p
9031 *.1p
9032 *.3p
9033     mtk
9034         Some formatting fixes, mostly to get rid of unwanted
9035         spaces before "," in formatted output.
9036
9037 *
9038 */*
9039     mtk
9040         Change all occurrences of my email address in man-pages source
9041         to my new gmail address.
9042
9043 Many many pages
9044     Maxime Vaudequin
9045         I noticed useless use of macros with alternating formatting
9046         (".IR" instead ".I" which suffices, ".BR" instead ".B", etc.)
9047         because there is only one element.  For example in ldconfig.8:
9048
9049             -.BR /sbin/ldconfig
9050             +.B /sbin/ldconfig
9051
9052         This is not very important, it only makes the sources more tidy.
9053         To find these I used:
9054
9055             egrep '^\.(B[RI]|R[IB]|I[RB]) ([^ ]+|\"[^\"]\+\")$'
9056
9057         And if you want to make these changes, you can use:
9058
9059             sed 's/^\(\.[BRI]\)[BRI]\( \([^ ]\+\|\"[^\"]\+\"\)\)$/\1\2/g'
9060
9061
9062 ==================== Changes in man-pages-2.68 ====================
9063
9064 Released: 2007-11-19
9065
9066
9067 Contributors
9068 ------------
9069
9070 The following people contributed notes, ideas, or patches that have
9071 been incorporated in changes in this release:
9072
9073 A. Costa <agcosta@gis.net>
9074 Andrew McDonald <andrew@mcdonald.org.uk>
9075 Geoff Clare <gclare@gclare.org.uk>
9076 Heikki Orsila <shd@modeemi.cs.tut.fi>
9077 Hyokyong Kim <hyokyong@ppj.kr>
9078 Ivana Varekova <varekova@redhat.com>
9079 Justin Pryzby <jpryzby+d@quoininc.com>
9080 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9081 Mike Frysinger <vapier@gentoo.org>
9082 Nicolas François <nicolas.francois@centraliens.net>
9083 Pádraig Brady <P@draigBrady.com>
9084 Sam Varshavchik <mrsam@courier-mta.com>
9085 Timo Juhani Lindfors <timo.lindfors@iki.fi>
9086 Ulrich Drepper <drepper@redhat.com>
9087
9088 Apologies if I missed anyone!
9089
9090
9091 Global changes
9092 --------------
9093
9094 faccessat.2
9095 fchmodat.2
9096 fchownat.2
9097 fstatat.2
9098 futimesat.2
9099 linkat.2
9100 mkdirat.2
9101 mknodat.2
9102 readlinkat.2
9103 renameat.2
9104 symlinkat.2
9105 mkfifoat.3
9106     mtk, after http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445436
9107         by Timo Juhani Lindfors
9108         Added <fcntl.h> to SYNOPSIS.
9109
9110 Typographical or grammatical errors have been corrected in several places.
9111
9112
9113 New pages
9114 ---------
9115
9116 _syscall.2
9117     mtk
9118         Created as a new page, by taking the content specific to
9119         the _syscall() macros from intro(2).
9120
9121
9122 Changes to individual pages
9123 ---------------------------
9124
9125 README
9126     mtk
9127         Brought up to date.
9128
9129 man-pages-*-Announce
9130     mtk
9131         Brought the info in here up to date.
9132
9133 intro.1
9134     mtk
9135         Added intro paragraph about section, plus a paragraph
9136         about exit status values.
9137         Move "user intro" text to NOTES.
9138
9139 get_mempolicy.2
9140     mtk
9141         Reorder ERRORS sections alphabetically
9142
9143 intro.2
9144     mtk
9145         Pretty much a complete rewrite, covering some additional topics.
9146         Moved _syscallN() material to new _syscall(2) page.
9147
9148 mbind.2
9149     mtk
9150         Reorder ERRORS sections alphabetically
9151
9152 mmap.2
9153     Maxime Vaudequin
9154         Fix syntax error in example program.
9155
9156 prctl.2
9157     mtk
9158         Linux 2.6.22 added support on Alpha for PR_SET_UNALIGN.
9159
9160 ptrace.2
9161     Nicolas François / mtk
9162         s/PTRACE_POKEUSR/PTRACE_POKEUSER/
9163         s/PTRACE_PEEKUSR/PTRACE_PEEKUSER/
9164
9165 read.2
9166     mtk / Geoff Clare
9167         Add text describing timerfd EINVAL error for read(2).
9168
9169 set_mempolicy.2
9170     mtk
9171         Reorder ERRORS sections alphabetically
9172
9173 syscall.2
9174     mtk
9175         Added _syscall(2) and intro(2) to SEE ALSO section.
9176
9177 syscalls.2
9178     mtk
9179         Added fallocate(2); removed timerfd(2).
9180
9181 sysinfo.2
9182     mtk
9183         Removed reference to example in intro(2).
9184
9185 dlopen.3
9186     mtk
9187         Added "Link with -ldl." to SYNOPSIS.
9188
9189 getaddrinfo.3
9190     Ulrich Drepper / mtk
9191         Remove references to getipnodebyname.3 and getipnodebyaddr.3.
9192
9193 gethostbyname.3
9194     mtk / Ulrich Drepper
9195         Remove SEE ALSO references to getipnodebyname.3 and
9196         getipnodebyaddr.3.
9197
9198     Pádraig Brady / mtk / Ulrich Drepper
9199         Point out that the functions described on this page
9200         are made obsolete by getaddrinfo(3) and getnameinfo(3).
9201
9202 getipnodebyname.3
9203     mtk
9204         Clarify that glibc does not implement these functions.
9205
9206 glob.3
9207     Ulrich Drepper / mtk
9208         Fix description of GLOB_ONLYDIR.
9209     mtk
9210         Added description of GLOB_TILDE_NOMATCH.
9211         Expanded the description of various flags.
9212         Various wording fixes..
9213
9214 intro.3
9215     mtk
9216         Pretty much a complete rewrite, covering some additional topics.
9217
9218 posix_fallocate.3
9219     mtk
9220         Add SEE ALSO referring to fallocate.2.
9221
9222 rpc.3
9223     Sam Varshavchik
9224         Add some arg declarations to prototypes; fix typos.
9225
9226 setbuf.3
9227     Mike Frysinger
9228         Fix text in BUGS section.
9229
9230 sigset.3
9231     mtk
9232         The sigset() bugs were fixed in glibc 2.5.
9233         See http://sourceware.org/bugzilla/show_bug.cgi?id=1951
9234
9235 intro.4
9236     mtk
9237         Minor rewrites.
9238
9239 st.4
9240     Maxime Vaudequin
9241         Various small corrections, formattings and modifications.
9242
9243 elf.5
9244     Mike Frysinger
9245         Document:
9246         - new p_flag: PT_GNU_STACK
9247         - new sections: .gnu.version .gnu.version_d .gnu.version_r
9248           .note.GNU-stack
9249         - new structures: ElfN_Verdef ElfN_Verdaux ElfN_Verneed
9250           ElfN_Vernaux
9251
9252 intro.5
9253     mtk
9254         Minor rewrites.
9255
9256 proc.5
9257     Ivana Varekova / mtk
9258         Add text noting that since kernel 2.6.16, /proc/slabinfo is
9259         only available if CONFIG_SLAB is enabled.
9260     Maxime Vaudequin
9261         Update description of /proc/pci.
9262     Maxime Vaudequin
9263         Give italic formatting to file names in proc.5.
9264     mtk
9265         The display type of the /proc/PID/stat fields changed
9266         %lu to %u in Linux 2.6.22:
9267             flags
9268             rt_priority
9269             policy
9270
9271 slabinfo.5
9272     Ivana Varekova / mtk
9273         Add text noting that since kernel 2.6.16, /proc/slabinfo is
9274         only available if CONFIG_SLAB is enabled.
9275
9276 intro.6
9277     mtk
9278         Minor rewrites.
9279
9280 bootparam.7
9281     Maxime Vaudequin
9282         Update references to files in kernel "Documentation" directory.
9283
9284 intro.7
9285     mtk
9286         Minor rewrites.
9287
9288 ipv6.7
9289     Andrew McDonald
9290         Fix description of IPV6_ROUTER_ALERT option.
9291
9292 standards.7
9293     mtk
9294         Note online location of C99 standard.
9295
9296 intro.8
9297     mtk
9298         Some rewrites, plus new paragraph on exit status values.
9299
9300
9301 ==================== Changes in man-pages-2.69 ====================
9302
9303 Released: 2007-12-03
9304
9305
9306 Contributors
9307 ------------
9308
9309 The following people contributed notes, ideas, or patches that have
9310 been incorporated in changes in this release:
9311
9312 Adam Borowski <kilobyte@angband.pl>
9313 Alain Portal <aportal@univ-montp2.fr>
9314 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
9315 J. Bruce Fields <bfields@citi.umich.edu>
9316 David Härdeman <david@hardeman.nu>
9317 Jeremy Kerr <jk@ozlabs.org>
9318 Luke Browning <lukebr@linux.vnet.ibm.com>
9319 Mats Wichmann <mats.d.wichmann@intel.com>
9320 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9321 Mike Frysinger <vapier@gentoo.org>
9322 Reuben Thomas <rrt@sc3d.org>
9323 Sam Varshavchik <mrsam@courier-mta.com>
9324
9325 Apologies if I missed anyone!
9326
9327
9328 Global changes
9329 --------------
9330
9331 *.[013]p
9332     mtk
9333         Many whitespace clean-ups in formatted output.
9334
9335 mprotect.2
9336 bind.2
9337 mq_notify.3
9338 makecontext.3
9339 fmemopen.3
9340     David Härdeman / mtk
9341         Rename error handling function in example program
9342         (s/die/handle_error/).
9343
9344 Typographical or grammatical errors have been corrected in several places.
9345
9346
9347 Removed pages
9348 -------------
9349
9350 HOWTOHELP
9351 MAINTAINING
9352     mtk
9353         The content of these files is now available in HTML format.
9354
9355 New links
9356 ---------
9357
9358 cfsetspeed.3
9359     mtk
9360         Link to termios.3.
9361
9362
9363 Changes to individual pages
9364 ---------------------------
9365
9366 time.1
9367     Alain Portal
9368         Added "Linux User's Manual" to .TH line.
9369
9370 _syscall.2
9371     aeb / mtk
9372         Remove outdated text about pointer blocks for syscalls that have
9373         more than 5 arguments.
9374
9375 fcntl.2
9376     J. Bruce Fields
9377         Add warning that mandatory locking is unreliable.
9378     J. Bruce Fields
9379         Clarify details in description of file leases.
9380     J. Bruce Fields / mtk
9381         Minor wording edits.
9382     J. Bruce Fields
9383         Add F_GETLEASE under RETURN VALUE.
9384
9385 mmap.2
9386     mtk
9387         Handle errors using a custom handle_error() macro.
9388
9389 sched_setscheduler.2
9390     Mats Wichmann
9391         Add BUGS text noting that the return value from Linux
9392         sched_setschuler() does not conform to POSIX.
9393
9394 spu_create.2
9395     Jeremy Kerr
9396         Various updates and improvements.
9397     Luke Browning
9398         Refinement of text describing a "gang".
9399     mtk
9400         Minor edits.
9401
9402 spu_run.2
9403     Jeremy Kerr
9404         Various updates and improvements.
9405     mtk
9406         Minor edits.
9407
9408 err.3
9409     mtk
9410         Remove HISTORY section.
9411
9412 fopen.3
9413     Mike Frysinger
9414         Document 'e' (close-on-exec) option, new in glibc 2.7.
9415
9416 getloadavg.3
9417     Alain Portal / mtk
9418         Remove HISTORY section.
9419
9420 printf.3
9421     Andries E. Brouwer / mtk
9422         Fix the discussion of stdarg macros in the description of
9423         vprintf() description.
9424
9425 sem_wait.3
9426     mtk
9427         Handle errors using a custom handle_error() macro.
9428
9429 sigsetops.3
9430     Mats Wichmann
9431         Note that sigset_t objects must be initialized
9432         with sigemptyset() or sigfillset() before the other
9433         macros are employed.
9434
9435 termios.3
9436     mtk, after a note by Alain Portal
9437         Added cfsetspeed() to SYNOPSIS.  Added text under CONFORMING TO
9438         noting that cfsetspeed() is BSD specific.
9439
9440 ttyslot.3
9441     Alain Portal
9442         Various references to "getty" were changed to "mingetty", since
9443         that is the manual page more likely to be found on current
9444         systems.  (Completes changes that were made in man-pages-2.44.)
9445
9446 initrd.4
9447     mtk, after a note by Alain Portal
9448         Move "Configuration" section to top of page (like other
9449         section 4 pages) and make it a .SH section.
9450
9451 full.4
9452     mtk
9453         Re-ordered CONFIGURATION section to go before DESCRIPTION.
9454
9455 sk98lin.4
9456     Maxime Vaudequin
9457         Fix reference to kernel Documentation file.
9458
9459 elf.5
9460     mtk
9461         Renamed HISTORY section to NOTES, and removed BSD specific info.
9462
9463 proc.5
9464     Maxime Vaudequin
9465         Mention grub(8) in same sentence as lilo(8).
9466     Maxime Vaudequin
9467         Improve description of /proc/sys/abi and
9468         /proc/sys/kernel/modprobe.
9469
9470 utmp.5
9471     Alain Portal
9472         Various references to "getty" were changed to "mingetty", since
9473         that is the manual page more likely to be found on current
9474         systems.  (Completes changes that were made in man-pages-2.44.)
9475
9476 iso_8859-2.7
9477     Adam Borowski
9478         Reverse the 2.68 change applied by mtk in response to
9479         http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445085
9480         that replaced "Sorbian" with "Serbian".
9481         (Sorbian is a language of 50000 people in Brandenburg.)
9482
9483 man-pages.7
9484     mtk
9485         Added CONFIGURATION to list of "standard" section names.
9486
9487 spufs.7
9488     Jeremy Kerr
9489         Various updates and improvements.
9490     mtk
9491         Minor edits.
9492
9493 tcp.7
9494     Maxime Vaudequin
9495         Fix reference to kernel Documentation file.
9496
9497
9498 ==================== Changes in man-pages-2.70 ====================
9499
9500 Released: 2007-12-06
9501
9502
9503 Global changes
9504 --------------
9505
9506 Many pages
9507     mtk
9508         Remove section numbers for page references where the
9509         reference refers to the page itself.  (This stops man2html
9510         producing links from a page back to itself.)
9511
9512 Typographical or grammatical errors have been corrected in several places.
9513
9514
9515 Changes to individual pages
9516 ---------------------------
9517
9518 get_mempolicy.2
9519     mtk
9520         Add CONFORMING TO section.
9521
9522 io_getevents.2
9523     mtk
9524         Remove redundant SEE ALSO entry.
9525
9526 mbind.2
9527     mtk
9528         Add CONFORMING TO section.
9529
9530 msgop.2
9531     mtk
9532         Remove redundant SEE ALSO entries.
9533
9534 sigprocmask.2
9535     mtk
9536         Remove redundant SEE ALSO entry.
9537
9538 splice.2
9539     mtk
9540         Remove redundant SEE ALSO entry.
9541         Add SEE ALSO referring to vmsplice(2).
9542
9543 csin.3
9544     mtk
9545         Remove redundant SEE ALSO entry.
9546         Add SEE ALSO referring to ccos(3).
9547
9548 gethostbyname.3
9549     mtk
9550         Add gethostbyaddr_r to NAME section.
9551
9552 rint.3
9553     mtk
9554         Remove redundant SEE ALSO entry.
9555
9556 sigsetops.3
9557     mtk
9558         Minor rewording.
9559
9560 epoll.7
9561     mtk
9562         Minor rewording.
9563
9564
9565 ==================== Changes in man-pages-2.71 ====================
9566
9567 Released: 2007-12-14
9568
9569
9570 Contributors
9571 ------------
9572
9573 The following people contributed notes, ideas, or patches that have
9574 been incorporated in changes in this release:
9575
9576 Alain Portal <aportal@univ-montp2.fr>
9577 John Sigler <linux.kernel@free.fr>
9578 Josh Triplett <josh@freedesktop.org>
9579 Mats Wichmann <mats.d.wichmann@intel.com>
9580 Pascal MALAISE <malaise@magic.fr>
9581 Sam Varshavchik <mrsam@courier-mta.com>
9582
9583 Apologies if I missed anyone!
9584
9585
9586 Global changes
9587 --------------
9588
9589 err.3
9590 fts.3
9591 getloadavg.3
9592 queue.3
9593 rcmd.3
9594 rexec.3
9595 stdin.3
9596 elf.5
9597 operator.7
9598     mtk
9599         Replaced the use of mdoc macros on these pages with man
9600         macros.  The only pages in man-pages that still use
9601         mdoc macros are mdoc.7 and mdoc.samples.7.
9602
9603 Typographical or grammatical errors have been corrected in several places.
9604
9605
9606 Deleted pages
9607 -------------
9608
9609 TODO
9610     mtk
9611         This information is now on the website.
9612
9613
9614 Changes to individual pages
9615 ---------------------------
9616
9617 Changes.old
9618     mtk
9619         Reformat various change log entries to use a consistent format.
9620         Expand Debian bug report numbers to be URLs.
9621         Other minor tidy-ups.
9622
9623 fcntl.2
9624     mtk
9625         Document the F_DUPFD_CLOEXEC operation, which is
9626         new in kernel 2.6.24.
9627
9628 listen.2
9629     Josh Triplett
9630         Fix incorrect path for somaxconn.
9631
9632 getpw.3
9633     Alain PORTAL
9634         Add ENOENT error to ERRORS.
9635
9636 sysconf.3
9637     Mats Wichmann
9638         Add documentation of _SC_NPROCESSORS_CONF and _SC_NPROCESSORS_ONLN.
9639
9640 tty.4
9641     John Sigler
9642         Add tty_ioctl(4) to SEE ALSO list.
9643
9644 regex.7
9645     Pascal MALAISE <malaise@magic.fr>
9646         Separate text on back references from that describing basic regexps,
9647         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=379829.
9648     mtk
9649         Remove crufty text about word boundaries.
9650
9651
9652 ==================== Changes in man-pages-2.72 ====================
9653
9654 Released: 2007-12-14
9655
9656
9657 Contributors
9658 ------------
9659
9660 The following people contributed notes, ideas, or patches that have
9661 been incorporated in changes in this release:
9662
9663 Alain Portal <aportal@univ-montp2.fr>
9664 Alex Tuninga <atuninga@google.com>
9665 Bert Wesarg <bert.wesarg@googlemail.com>
9666 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9667 Rob Weryk <rjweryk@uwo.ca>
9668 Sam Varshavchik <mrsam@courier-mta.com>
9669
9670 Apologies if I missed anyone!
9671
9672
9673 Global changes
9674 --------------
9675
9676 Various pages
9677     Alain PORTAL / mtk
9678         Format include files consistently (".I <.*\.h>").
9679
9680 Various pages
9681     Alain PORTAL / mtk
9682         Format pathname in italics (.I).
9683
9684 dbopen.3
9685 mpool.3
9686 recno.3
9687     Alain PORTAL
9688         Remove brackets ([]) around error names.
9689
9690 console.4
9691 tty.4
9692 ttyS.4
9693 issue.5
9694 ttytype.5
9695 utmp.5
9696     mtk / Maxime Vaudequin
9697         Some systems have mingetty(8), others have agetty(8), so both
9698         should be mentioned when we are talking about getty-style programs.
9699
9700
9701 Typographical or grammatical errors have been corrected in several places.
9702
9703
9704 Renamed pages
9705 -------------
9706
9707 filesystems.5
9708     mtk / Alain PORTAL
9709         Was previously fs.5
9710
9711
9712 New links
9713 ---------
9714
9715 argz.3
9716     Bert Wesarg / mtk
9717         Link to argz_add.3.
9718
9719 envz.3
9720     Bert Wesarg / mtk
9721         Link to envz_add.3.
9722
9723 fs.5
9724     mtk / Alain PORTAL
9725         Link to filesystems.5.
9726
9727
9728 Changes to individual pages
9729 ---------------------------
9730
9731 readahead.2
9732     Rob Weryk
9733         Fix declaration of 'offset' in SYNOPSIS.
9734
9735 seteuid.2
9736     mtk
9737         s/SETGUID/SETEUID/ in .TH line.
9738
9739 __setfpucw.3
9740     mtk
9741         Fixed include files references / formatting.
9742
9743 abort.3
9744     mtk, after a note by Alex Tuninga
9745         A fairly significant rewrite to clarify operation of abort().
9746
9747 argz_add.3
9748     Bert Wesarg / mtk
9749         s/envz/envz_add/ in SEE ALSO.
9750
9751 basename.3
9752     mtk
9753         s/DIRNAME/BASENAME/ in .TH line, and swap function names
9754         in NAME section.
9755
9756 envz_add.3
9757     Bert Wesarg / mtk
9758         s/argz/argz_add/ in SEE ALSO.
9759
9760 flockfile.3
9761     mtk
9762         s/LOCKFILE/FLOCKFILE/ in .TH line.
9763
9764 getgrent_r.3
9765     mtk
9766         s/GETGRENT/GETGRENT_R/ in .TH line.
9767
9768 stdio.3
9769     Sam Varshavchik
9770         Reformat function list at end of page as a proper table.
9771
9772 ttyslot.3
9773     Maxime Vaudequin
9774         Revert earlier s/getty/mingetty/.  This page talks about
9775         historical behavior, and that means "getty(8)".
9776
9777 undocumented.3
9778     mtk
9779         Remove reference to "obstack stuff"; it's not clear what
9780         that is about.
9781
9782 console_ioctl.4
9783     mtk
9784         s/CONSOLE_IOCTLS/CONSOLE_IOCTL/ in .TH line.
9785
9786 proc.5
9787     mtk
9788         s/fs (5)/filesystems (5)/
9789
9790 man-pages.7
9791     mtk / Alain PORTAL
9792         Improve discussion of formatting of file names.
9793
9794
9795 ==================== Changes in man-pages-2.73 ====================
9796
9797 Released: 2007-12-14
9798
9799
9800 Contributors
9801 ------------
9802
9803 The following people contributed notes, ideas, or patches that have
9804 been incorporated in changes in this release:
9805
9806 Alain Portal <aportal@univ-montp2.fr>
9807 Pádraig Brady <P@draigBrady.com>
9808 Reuben Thomas <rrt@sc3d.org>
9809
9810 Apologies if I missed anyone!
9811
9812
9813 Global changes
9814 --------------
9815
9816 Various pages
9817     Alain PORTAL
9818         Formatting fixes.
9819
9820 Typographical or grammatical errors have been corrected in several places.
9821
9822
9823 Changes to individual pages
9824 ---------------------------
9825
9826 mknod.2
9827     mtk, after a report by Reuben Thomas
9828         Clarify use of mkfifo() versus mknod().
9829         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=455825
9830
9831 fgetgrent.3
9832     mtk
9833         Small rewording.
9834
9835 fgetpwent.3
9836     mtk
9837         Small rewording.
9838
9839 rcmd.3
9840     mtk
9841         Noted feature test macro requirements.
9842         BUGS: noted that iruserok() is not declared in glibc headers.
9843
9844 filesystems.5
9845     mtk
9846         Added Reiserfs, XFS, JFS to list of file systems.
9847
9848
9849 ==================== Changes in man-pages-2.74 ====================
9850
9851 Released: 2007-12-20
9852
9853
9854 Contributors
9855 ------------
9856
9857 The following people contributed notes, ideas, or patches that have
9858 been incorporated in changes in this release:
9859
9860 Alain Portal <aportal@univ-montp2.fr>
9861 Andrew Morton <akpm@linux-foundation.org>
9862 David Brown <lkml@davidb.org>
9863 Jeremy Kerr <jk@ozlabs.org>
9864 Mats Wichmann <mats.d.wichmann@intel.com>
9865 Sam Morris <sam@robots.org.uk>
9866 Sam Varshavchik <mrsam@courier-mta.com>
9867 Samuel Thibault <samuel.thibault@ens-lyon.org>
9868
9869 Apologies if I missed anyone!
9870
9871
9872 Global changes
9873 --------------
9874
9875 Various pages
9876     Alain PORTAL
9877         Formatting fixes.
9878
9879 Various pages
9880     mtk / Alain Portal
9881         s/``...''/"..."/
9882
9883 Various pages
9884     mtk
9885         s/epoch/Epoch/
9886
9887 Various pages
9888     mtk
9889         Make the standard indent for code samples, shell session
9890         logs, etc. to be ".in +4n".
9891
9892 Typographical or grammatical errors have been corrected in several places.
9893
9894
9895 Changes to individual pages
9896 ---------------------------
9897
9898 _syscall.2
9899     mtk
9900         Nowadays there is _syscall6() also.
9901
9902 chroot.2
9903     mtk
9904         Various minor formatting changes.
9905
9906 epoll_wait.2
9907     mtk
9908         Fix types in structs.
9909         Formatting fixes.
9910
9911 mount.2
9912     mtk, after a note by Sam Morris
9913         Clarify that MS_NODIRATIME provides a subset of the
9914         functionality provided by MS_NOATIME.
9915
9916 sched_setaffinity.2
9917     mtk
9918         Minor rearrangement of text.
9919
9920 select_tut.2
9921     mtk
9922         Fix (my) typos in argument names.
9923         Formatting fixes.
9924
9925 spu_create.2
9926     Jeremy Kerr
9927         We can use context FDs for the dirfd argument to the *at() syscalls.
9928
9929 times.2
9930     mtk, after a note from David Brown and Andrew Morton
9931         http://marc.info/?l=linux-kernel&m=119447727031225&w=2
9932         Rework the text describing the return value to be closer
9933         to the requirements of POSIX.1; move Linux details
9934         to NOTES and add a warning not to rely on those details.
9935         Add a warning about the -1 to -4095 bug which results
9936         in a 41 second window where the glibc wrapper will wrongly
9937         return -1 indicating an error.
9938     mtk
9939         Remove cruft HZ text.
9940         Clarify text describing return value of clock(3).
9941
9942 getw.3
9943     Mats Wichmann
9944         CONFORMING TO: getw() and putw() were in SUSv2, but are not
9945         in POSIX.1-2001.
9946
9947 hash.3
9948     mtk / Alain Portal
9949         Minor rewordings + formatting fixes.
9950
9951 st.4
9952     Alain Portal / mtk
9953         Many formatting fixes.
9954     mtk
9955         Place ERRORS in alphabetical order.
9956
9957 vcs.4
9958     Samuel Thibault
9959         Document VT_GETHIFONTMASK (new in 2.6.18) and add to example program;
9960         attribute/text characters are in the host byte order.
9961         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=456437
9962     mtk
9963         Minor edits.
9964
9965 bootparam.7
9966     Alain PORTAL
9967         Formatting fixes.
9968
9969 inotify.7
9970     mtk
9971         Minor heading changes and reformattings.
9972
9973 man-pages.7
9974     mtk
9975         Note that code segments, structure definitions, shell session
9976         logs, should be indented by 4 spaces.
9977
9978 spufs.7
9979     Jeremy Kerr
9980         Add a little information about the differences to mbox.
9981
9982
9983 ==================== Changes in man-pages-2.75 ====================
9984
9985 Released: 2008-01-08
9986
9987
9988 Contributors
9989 ------------
9990
9991 The following people contributed notes, ideas, or patches that have
9992 been incorporated in changes in this release:
9993
9994 Alain Portal <aportal@univ-montp2.fr>
9995 Andi Kleen <ak@suse.de>
9996 Andreas Henriksson <andreas@fatal.se>
9997 Jeremy Kerr <jk@ozlabs.org>
9998 Justin Pryzby <jpryzby+d@quoinic.com>
9999 Phil Endecott <spam_from_debian_bugs_4@chezphil.org>
10000 Sam Varshavchik <mrsam@courier-mta.com>
10001 Thomas Huriaux <thomas.huriaux@gmail.com>
10002 Timo Sirainen <tss@iki.fi>
10003 Trond Myklebust <trond.myklebust@fys.uio.no>
10004
10005 Apologies if I missed anyone!
10006
10007
10008 Global changes
10009 --------------
10010
10011 Various pages
10012     mtk
10013         (Grammatical) hyphenation was fixed in many places.
10014
10015 epoll_wait.2
10016 mbind.2
10017 spu_run.2
10018 ecvt.3
10019 fmtmsg.3
10020 getnameinfo.3
10021 rtc.4
10022 proc.5
10023 charsets.7
10024 ip.7
10025 ipv6.7
10026 raw.7
10027 uri.7
10028     Justin Pryzby / mtk
10029         Fix incorrect usage of "a" and "an" before following vowel /
10030         consonant, by reviewing the output of the following scripts:
10031
10032             for a in  $(wc */*.? | awk '$1 > 10 {print $4}' | gv total); do
10033                 echo $a
10034                 MANWIDTH=4000 man -l $a 2>/dev/null |
10035                         egrep '(^| )an [^aeiou][a-z]'
10036             done | less
10037
10038             for a in  $(wc */*.? | awk '$1 > 10 {print $4}' | gv total); do
10039                 echo $a
10040                 MANWIDTH=4000 man -l $a 2>/dev/null |
10041                         egrep '(^| )a [aeiou][a-z]'
10042             done| less
10043
10044 err.3
10045 fts.3
10046 queue.3
10047 rcmd.3
10048 rexec.3
10049 stdin.3
10050 elf.5
10051     mtk, after a note by Alain Portal
10052         Improve macros used in 2.71 to convert from "mdoc" to "man".
10053
10054 _exit.2
10055 chroot.2
10056 getgid.2
10057 getpid.2
10058 getrusage.2
10059 getsid.2
10060 gettid.2
10061 getuid.2
10062 iopl.2
10063 kill.2
10064 personality.2
10065 pivot_root.2
10066 ptrace.2
10067 sched_setparam.2
10068 sched_setscheduler.2
10069 sched_yield.2
10070 seteuid.2
10071 setgid.2
10072 setpgid.2
10073 setresuid.2
10074 setreuid.2
10075 setuid.2
10076 unlink.2
10077 wait.2
10078 openpty.3
10079 raise.3
10080 setlogmask.3
10081 sleep.3
10082 ttyslot.3
10083 ulimit.3
10084 tty.4
10085 tty_ioctl.4
10086 path_resolution.7
10087     mtk
10088         s/current process/calling process/
10089
10090 cacheflush.2
10091 clone.2
10092 fcntl.2
10093 getitimer.2
10094 getrlimit.2
10095 mmap.2
10096 mprotect.2
10097 times.2
10098 adjtime.3
10099 byteorder.3
10100 inet.3
10101 offsetof.3
10102 rtc.4
10103 icmp.7
10104 pipe.7
10105 time.7
10106     mtk
10107         s/x86/i386/ since that is the name used in 'arch' directories
10108         in the kernel source, and previously both i386 and x86 were both
10109         used in man pages; also nowadays 'x86' is somewhat ambiguous,
10110         since it is the name of the 'arch' directory for i386 and x86-64.
10111
10112 conj.3
10113 cacos.3
10114 cacosh.3
10115 cabs.3
10116 carg.3
10117 casin.3
10118 casinh.3
10119 catan.3
10120 catanh.3
10121 ccos.3
10122 ccosh.3
10123 cexp.3
10124 cimag.3
10125 clog.3
10126 cosh.3
10127 creal.3
10128 csin.3
10129 csinh.3
10130 ctan.3
10131 ctanh.3
10132 sinh.3
10133 tanh.3
10134     mtk
10135         Various reformattings.
10136
10137 Various pages
10138     Alain Portal
10139         Formating fixes.
10140
10141 mlock.2
10142 mprotect.2
10143 mpool.3
10144 offsetof.3
10145     Alain Portal
10146         Format SYNOPSIS in a manner consistent with other pages.
10147
10148 Various pages
10149     mtk / Alain Portal
10150         Format casts so that there is a non-breaking space after the
10151         type, and remove unnecessary parentheses around the casted value.
10152         Thus, for example, the following:
10153
10154             .IR "(size_t) (\-1)" .
10155
10156         becomes:
10157
10158             .IR "(size_t)\ \-1" .
10159
10160 Various pages
10161     mtk / Alain Portal
10162         Replace "-" by "\-" where a real dash is required.
10163
10164 Various pages
10165     mtk
10166         Make the formatting of instances of '*varname' consistent, changing
10167         instances such as:
10168
10169             .RI * varname
10170
10171         to:
10172
10173             .I *varname
10174
10175 pciconfig_read.2
10176 nfsservctl.2
10177 bstring.3
10178 cpow.3
10179 getipnodebyname.3
10180 getpwnam.3
10181 getrpcent.3
10182 lsearch.3
10183 malloc_hook.3
10184 mpool.3
10185 stdin.3
10186 strtol.3
10187 strtoul.3
10188 unlocked_stdio.3
10189 regex.3
10190 sd.4
10191 resolv.conf.5
10192 utmp.5
10193 futex.7
10194     mtk
10195         Format SYNOPSIS consistently.
10196
10197 drand48.3
10198 drand48_r.3
10199 flockfile.3
10200 erf.3
10201 sigvec.3
10202 timeradd.3
10203 wprintf.3
10204     mtk, after a note by Alain Portal
10205         Standardize sentence used under "Feature Test Macro Requirements"
10206         when referring to all functions shown in the SYNOPSIS.
10207
10208 get_kernel_syms.2
10209 getdents.2
10210 getitimer.2
10211 nanosleep.2
10212 query_module.2
10213 statvfs.2
10214 clock_getres.3
10215 getaddrinfo.3
10216 getgrent.3
10217 getipnodebyname.3
10218 console_ioctl.4
10219 tty_ioctl.4
10220 rtnetlink.7
10221     mtk
10222         Indent structure definitions by +4n.
10223
10224 recv.2
10225 btree.3
10226 dbopen.3
10227 ether_aton.3
10228 fts.3
10229 hash.3
10230 mpool.3
10231 profil.3
10232 rcmd.3
10233 recno.3
10234 rpc.3
10235 xdr.3
10236 console_ioctl.4
10237 ddp.7
10238 ip.7
10239 ipv6.7
10240 svipc.7
10241     mtk
10242         Use C99 standard types in declarations.
10243             s/u_long/unsigned long/
10244             s/ulong/unsigned long/
10245             s/u_char/unsigned char/
10246             s/u_short/unsigned short/
10247             s/ushort/unsigned short/
10248             s/u_int8_t/uint8_t/
10249             s/u_int16_t/uint16_t/
10250             s/u_int32_t/uint32_t/
10251             s/u_int/unsigned int/
10252
10253 exit_group.2
10254 fallocate.2
10255 getdents.2
10256 ioctl_list.2
10257 nfsservctl.2
10258 sched_setaffinity.2
10259 set_tid_address.2
10260 ustat.2
10261 argz_add.3
10262 confstr.3
10263 envz_add.3
10264 getline.3
10265 getpwnam.3
10266 gets.3
10267 getw.3
10268 inet_ntop.3
10269 inet_pton.3
10270 offsetof.3
10271 console_ioctl.4
10272 termcap.5
10273 ascii.7
10274 feature_test_macros.7
10275 netlink.7
10276 operator.7
10277 svipc.7
10278     mtk
10279         Fix unbalanced .nf/.fi pairs.
10280
10281 chmod.2
10282 getxattr.2
10283 listxattr.2
10284 lseek.2
10285 removexattr.2
10286 setxattr.2
10287 stat.2
10288 feature_test_macros.7
10289 fpathconf.3
10290 fopen.3
10291
10292     mtk
10293         Rename argument: s/file*des/fd/ , since that is the name most
10294         commonly used on man pages for a file descriptor argument.
10295
10296 bindresvport.3
10297 des_crypt.3
10298 getopt.3
10299 getrpcent.3
10300 realpath.3
10301 rpc.3
10302 xdr.3
10303     mtk
10304         Removed .SM macros.
10305
10306 madvise.2
10307 getdirentries.3
10308 printf.3
10309 sigvec.3
10310     mtk
10311         Remove extraneous .br macro before/after .SH/.SS.
10312
10313 _syscall.2
10314 lookup_dcookie.2
10315 aio_cancel.3
10316 aio_error.3
10317 aio_fsync.3
10318 aio_read.3
10319 aio_return.3
10320 aio_write.3
10321 canonicalize_file_name.3
10322 envz_add.3
10323 getgrouplist.3
10324 getttyent.3
10325 key_setsecret.3
10326 mtrace.3
10327 tcgetpgrp.3
10328 tcgetsid.3
10329 ttyslot.3
10330 tty_ioctl.4
10331     mtk
10332         Remove extraneous .sp macros.
10333
10334 fcntl.2
10335 outb.2
10336 send.2
10337 syscalls.2
10338 getopt.3
10339 proc.5
10340 man-pages.7
10341 standards.7
10342 tcp.7
10343     mtk
10344         Remove/replace extraneous .sp macros.
10345
10346 Typographical or grammatical errors have been corrected in several places.
10347
10348
10349 Changes to individual pages
10350 ---------------------------
10351
10352 _syscall.2
10353     mtk
10354         Nowadays there are seven macros (see 2.74 change log also).
10355
10356 arch_prctl.2
10357     mtk, Acked by Andi Kleen
10358         Clarify interpretation of 'addr'; plus a few other minor edits
10359         and updates.
10360
10361 bind.2
10362     mtk
10363         Minor rewrites.
10364
10365 close.2
10366     mtk
10367         Clarify relationship between file descriptor and open file
10368         description.
10369
10370 connect.2
10371     mtk, Acked by Andi Kleen
10372         Since kernel 2.2, AF_UNSPEC for unconnecting a connected
10373         socket *is* supported.
10374
10375 execve.2
10376     Alain Portal
10377         Minor rewordings.
10378
10379 futimesat.2
10380     Alain Portal
10381         Remove duplicate "#include <fcntl.h>" from SYNOPSIS.
10382
10383 getgid.2
10384     mtk
10385         Add getresgid(2) and credentials(7) to SEE ALSO.
10386
10387 getpagesize.2
10388     mtk
10389         Small rewording.
10390
10391 getresuid.2
10392     mtk
10393         Rewrote various parts.
10394
10395 getuid.2
10396     mtk
10397         Add getresuid(2) and credentials(7) to SEE ALSO.
10398
10399 ioctl_list.2
10400     Alain Portal
10401         Use proper tables for layout, and various formatting fixes.
10402     mtk
10403         Various formatting fixes.
10404
10405 listen.2
10406     mtk
10407         Rewrote various parts.
10408
10409 mbind.2
10410     Andi Kleen / mtk / Alain Portal
10411         Modify explanation of EINVAL 'maxnode' error.
10412
10413 mmap.2
10414     mtk
10415         Add comma to clarify meaning of a sentence.
10416
10417 open.2
10418     mtk
10419         Clarify initial description of O_EXCL.
10420         Clarify description of behaviors of O_CREAT | O_EXCL
10421         for symbolic links.
10422         Clarify text describing use of lockfiles without O_EXCL.
10423     mtk, with input from Timo Sirainen and Trond Myklebust
10424         O_EXCL is supported on NFSv3 and later, with Linux 2.6 and later.
10425
10426 pipe.2
10427     mtk
10428         Rename 'filedes' argument 'pipefd'.
10429
10430 pivot_root.2
10431     mtk
10432         s/cwd/current working directory/
10433
10434 seteuid.2
10435     mtk
10436         Minor changes.
10437
10438 setpgid.2
10439     mtk
10440         Add credentials(7) to SEE ALSO, and updated copyright credits,
10441         to reflect my rewrite of a few months ago.
10442
10443 setsid.2
10444     mtk
10445         Add getsid(2) and credentials(7) to SEE ALSO.
10446
10447 spu_create.2
10448     Alain Portal / mtk; acked by Jeremy Kerr
10449         Minor formatting/wording changes.
10450     mtk
10451         Put EPERM in right alphabetical position in ERRORS list.
10452
10453 argz_add.3
10454     mtk
10455         Formatting fixes.
10456
10457 atexit.3
10458     mtk
10459         Minor changes to example program.
10460
10461 cerf.3
10462     mtk
10463         These functions are still not present as at glibc 2.7.
10464
10465 dbopen.3
10466     Alain Portal / mtk
10467         Various minor spelling and formatting fixes.
10468
10469 envz_add.3
10470     mtk
10471         Formatting fixes.
10472
10473 fexecve.3
10474     mtk
10475         Fix placement of feature test macro in SYNOPSIS.
10476
10477 fmax.3
10478 fmin.3
10479     mtk
10480         Small rewording.
10481
10482 getline.3
10483     mtk
10484         Minor changes to example program.
10485
10486 getrpcent.3
10487 getrpcport.3
10488     mtk
10489         Use modern C prototypes in SYNOPSIS.
10490
10491 getutent.3
10492     Alain Portal / mtk
10493         Formatting fixes.
10494
10495 mbsnrtowcs.3
10496 mbsrtowcs.3
10497 mbstowcs.3
10498     mtk
10499         Use .IP tags to create properly formatted lists.
10500
10501 rpc.3
10502     mtk
10503         Convert function declarations to use modern C prototypes.
10504         Add text and start of page describing header files
10505         and types required by functions.
10506         Reformat discussion of request under clnt_control().
10507
10508 xdr.3
10509     mtk
10510         Convert function declarations to use modern C prototypes.
10511         Remove crufty "int empty" from xdrrec_eof() description.
10512
10513 console_codes.4
10514     Phil Endecott
10515         Relocate misplaced line:
10516             "and if LF/NL (new line mode) is set also a carriage return;"
10517         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=458338.
10518
10519 console_ioctl.4
10520     mtk
10521         Formatting fixes.
10522
10523 bootparam.7
10524     mtk, after a note by Alan Portal
10525         Fix reference to kernel documentation source file in the
10526         "The Sound Driver" subsection.
10527
10528 man-pages.7
10529     Alain Portal
10530         Move CONFIGURATION description after SYNOPSIS description.
10531     mtk / Alain Portal
10532         Note that header files should be surrounded by angle brackets (<>).
10533
10534 posixoptions.7
10535     mtk
10536         Minor formatting and wording fixes.
10537
10538 rtnetlink.7
10539     Andreas Henriksson
10540         Fix description of RTM_F_EQUALIZE.
10541         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=458325.
10542
10543 signal.7
10544     mtk
10545         Minor formatting and wording fixes.
10546
10547 socket.7
10548     mtk
10549         Small rewording of discussion of O_ASYNC.
10550
10551 spufs.7
10552     mtk / Jeremy Kerr / Alain Portal
10553         s/SPE/SPU/
10554
10555
10556 ==================== Changes in man-pages-2.76 ====================
10557
10558 Released: 2008-01-14
10559
10560
10561 Contributors
10562 ------------
10563
10564 The following people contributed notes, ideas, or patches that have
10565 been incorporated in changes in this release:
10566
10567 Alain Portal <aportal@univ-montp2.fr>
10568 Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
10569 Jeremy Kerr <jk@ozlabs.org>
10570 Sam Varshavchik <mrsam@courier-mta.com>
10571 Trond Myklebust <trond.myklebust@fys.uio.no>
10572
10573 Apologies if I missed anyone!
10574
10575
10576 Global changes
10577 --------------
10578
10579 longjmp.3
10580 printf.3
10581 scanf.3
10582 setbuf.3
10583 setjmp.3
10584 sk98lin.4
10585 environ.7
10586     mtk
10587         Rework/remove use of ".ad" macros.
10588
10589 ioctl_list.2
10590 mlock.2
10591 mprotect.2
10592 mremap.2
10593 syslog.2
10594 cfree.3
10595 mpool.3
10596 offsetof.3
10597 rpc.3
10598 stdin.3
10599     mtk
10600         Fix unbalanced quotes in formatting macros.
10601
10602 ftok.3
10603     mtk
10604         s/i-node/inode/, for consistency with other pages and POSIX.1-2001.
10605
10606 Typographical or grammatical errors have been corrected in several places.
10607
10608
10609 Changes to individual pages
10610 ---------------------------
10611
10612 chown.2
10613     mtk
10614         Minor wording change.
10615
10616 dup.2
10617     mtk
10618         Reordered text in DESCRIPTION and added some details for dup2().
10619
10620 open.2
10621     Trond Myklebust / mtk
10622         Minor fix to O_EXCL changes in previous release.
10623
10624 gettid.2
10625     mtk
10626         Rewrote DESCRIPTION; noted that thread ID is not the same
10627         thing as a POSIX thread ID.
10628
10629 pipe.2
10630     mtk
10631         Rewrote DESCRIPTION; minor additions to EXAMPLE text.
10632
10633 umask.2
10634     mtk
10635         A few rewrites and additions.
10636
10637 strptime.3
10638     Carlo Marcelo Arenas Belon / mtk
10639         Add "#define _XOPEN_SOURCE" to example program.
10640
10641 initrd.4
10642     mtk
10643         Use quotes more consistently in formatting macros.
10644
10645 random.4
10646     mtk, after a report by Daniel Kahn Gilmor
10647         Add 2.6 details for /proc/sys/kernel/random/poolsize.
10648         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=459232.
10649
10650 pthreads.7
10651     mtk
10652         Minor changes.
10653
10654 spufs.7
10655     mtk / Jeremy Kerr
10656         Define abbreviation "MSS".
10657
10658
10659 ==================== Changes in man-pages-2.77 ====================
10660
10661 Released: 2008-01-31
10662
10663
10664 Contributors
10665 ------------
10666
10667 The following people contributed notes, ideas, or patches that have
10668 been incorporated in changes in this release:
10669
10670 Pavel Heimlich <tropikhajma@seznam.cz>
10671 Phil Endecott <phil_vonar_endecott@chezphil.org>
10672 Thomas Huriaux <thomas.huriaux@gmail.com>
10673 Vincent Lefevre <vincent@vinc17.org>
10674 WANG Cong <xiyou.wangcong@gmail.com>
10675
10676 Apologies if I missed anyone!
10677
10678
10679 Global changes
10680 --------------
10681
10682 stdarg.3
10683 bootparam.7
10684     Thomas Huriaux
10685         Fix broken use of single quotes at start of line,
10686         as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=462636
10687
10688 Typographical or grammatical errors have been corrected in several places.
10689
10690 New pages
10691 ---------
10692
10693 remove_COLOPHON.sh
10694     mtk
10695         Script to remove the COLOPHON section from the man pages provided
10696         as command-line arguments.  This is useful to remove the COLOPHON
10697         sections from all of the man pages in two different release trees
10698         in order to do a "diff -ruN" to see the "real" differences
10699         between the trees.
10700
10701
10702 Changes to individual pages
10703 ---------------------------
10704
10705 fcntl.2
10706     mtk
10707         Replace tables with .TP macros.
10708
10709 fork.2
10710     mtk
10711         Added discussion of directory streams.
10712         Removed "#include <sys/types>" from SYNOPSIS.
10713         Changed authorship notice.
10714
10715 futex.2
10716     mtk
10717         Add ENOSYS error to errors.
10718     Phil Endecott
10719         Explicitly describe return value in the event of an error.
10720
10721 inotify_add_watch.2
10722     mtk
10723         Minor wording changes.
10724
10725 splice.2
10726     WANG Cong
10727         Fix types for 2 and 4 arguments in splice prototype.
10728
10729 wait.2
10730     Phil Endecott
10731         Clarify description of return value for WNOHANG.
10732
10733 tkill.2
10734     mtk
10735         Rewrote DESCRIPTION; emphasized that tkill() is obsoleted by
10736         tgkill().
10737
10738 alloca.3
10739     mtk
10740         Change description in NAME section.
10741         Various rewrites and additions (including notes on longjmp() and
10742         SIGSEGV).
10743     mtk / Vincent Lefevre
10744         Weaken warning against use of alloca(), and
10745         point out some cases where it can be useful;
10746         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=461100.
10747
10748 bootparam.7
10749     Pavel Heimlich
10750         Remove junk line.
10751
10752 inotify.7
10753     mtk
10754         Replace tables with .TP macros.
10755         s/MultiSource Synchronization/MultiSource Synchronization (MSS)/
10756
10757
10758 ==================== Changes in man-pages-2.78 ====================
10759
10760 Released: 2008-02-15
10761
10762
10763 Contributors
10764 ------------
10765
10766 The following people contributed notes, ideas, or patches that have
10767 been incorporated in changes in this release:
10768
10769 Davide Libenzi <davidel@xmailserver.org>
10770 Greg Banks <gnb@melbourne.sgi.com>
10771 Michael Tokarev <mjt@tls.msk.ru>
10772 Phil Endecott <phil_vonar_endecott@chezphil.org>
10773
10774 Apologies if I missed anyone!
10775
10776
10777 Global changes
10778 --------------
10779
10780 sigaction.2
10781 signal.2
10782 sigwaitinfo.2
10783 signal.7
10784     mtk
10785         Add SEE ALSO entry referring to new signalfd.2 page.
10786
10787 Typographical or grammatical errors have been corrected in several places.
10788
10789
10790 New pages
10791 ---------
10792
10793 eventfd.2
10794     mtk, with input and review from Davide Libenzi
10795         Documents the eventfd() system call, new in 2.6.22.
10796
10797 signalfd.2
10798     mtk, with input and review from Davide Libenzi
10799         Documents the signalfd() system call, new in 2.6.22.
10800
10801 Changes to individual pages
10802 ---------------------------
10803
10804 futex.2
10805     mtk / Phil Endecott
10806         Improve wording describing error returns.
10807
10808 open.2
10809     Greg Banks
10810         Greatly expand the detail on O_DIRECT.
10811
10812 reboot.2
10813     mtk / Michael Tokarev
10814         Fix RETURN VALUE description: in some cases reboot() does not
10815         return.
10816     mtk
10817         Rename the 'flag' argument to 'cmd', since that is more meaningful,
10818         and also what is used in the kernel source.
10819         Other minor wording changes.
10820
10821
10822 ==================== Changes in man-pages-2.79 ====================
10823
10824 Released: 2008-03-07
10825
10826
10827 Contributors
10828 ------------
10829
10830 The following people contributed notes, ideas, or patches that have
10831 been incorporated in changes in this release:
10832
10833 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
10834 Chris Heath <chris@heathens.co.nz>
10835 Davide Libenzi <davidel@xmailserver.org>
10836 Fernando Luis Vázquez Cao <fernando@oss.ntt.co.jp>
10837 Heikki Orsila <shdl@zakalwe.fi>
10838 Jeremy Kerr <jk@ozlabs.org>
10839 Justin Pryzby <justinpryzby@users.sourceforge.net>
10840 Lasse Kärkkäinen <tronic@trn.iki.fi>
10841 Michael Haardt <michael@moria.de>
10842 Mike Frysinger <vapier@gentoo.org>
10843 Ron Burk <ronburk@gmail.com>
10844 Sam Varshavchik <mrsam@courier-mta.com>
10845 Samuel Thibault <samuel.thibault@ens-lyon.org>
10846 Walter Harms <WHarms@bfs.de>
10847
10848 Apologies if I missed anyone!
10849
10850
10851 Global changes
10852 --------------
10853
10854 Typographical or grammatical errors have been corrected in several places.
10855
10856
10857 New pages
10858 ---------
10859
10860 timerfd_create.2
10861     mtk, with input and review from Davide Libenzi
10862         Documents the timerfd_create(), timerfd_settime(), and
10863         timerfd_gettime() system calls, which are new in 2.6.25.
10864
10865
10866 New links
10867 ---------
10868
10869 timerfd_gettime.2
10870 timerfd_settime.2
10871     mtk
10872         Links to new timerfd_create.2 page.
10873
10874 eventfd_read.3
10875 eventfd_write.3
10876     mtk
10877         Links to eventfd.2.
10878
10879
10880 Changes to individual pages
10881 ---------------------------
10882
10883 Makefile
10884     aeb
10885         Remove code relating to man1/README, which no longer exists.
10886
10887 execve.2
10888     mtk
10889         Clarify detail of RLIMIT_STACK/4 limit for argv+environ.
10890
10891 getitimer.2
10892     mtk
10893         Added SEE ALSO entry referring to timerfd_create.2.
10894
10895 getrusage.2
10896     mtk
10897         Minor rewordings.
10898
10899 open.2
10900     Michael Haardt
10901         Move discussion of 'mode' argument under description of O_CREAT.
10902
10903 signalfd.2
10904     mtk
10905         Fix type for 'ssi_ptr' field.
10906         See http://sources.redhat.com/ml/libc-hacker/2008-01/msg00002.html.
10907
10908 syscalls.2
10909     mtk
10910         Add timerfd_create(), timerfd_settime(), and timerfd_gettime()
10911         to list.
10912
10913 syslog.2
10914     Jeremy Kerr
10915         Add info on command type 10.
10916         Add details on types 6, 7, 8, and 9.
10917         Minor grammar fix.
10918     mtk
10919         Update LOG_BUF_LEN details.
10920         Update RETURN VALUE section.
10921         Notes capability requirements under EPERM error.
10922         Minor fix to description of type==3 and type==4.
10923         Other minor edits.
10924
10925 ctime.3
10926     Walter Harms
10927         Note that POSIX requires localtime() to act as though tzset()
10928         was called, but localtime_r() does not have the same requirement.
10929         See also http://thread.gmane.org/gmane.comp.time.tz/2034/
10930
10931 getaddrinfo.3
10932     mtk
10933         Clarify discussion of NULL 'hints' argument; other minor rewrites.
10934     mtk / Sam Varshavchik
10935         Remove some duplicated text.
10936
10937 malloc.3
10938     Lasse Kärkkäinen / Mike Frysinger / mtk
10939         Clarify description of realloc() behavior for
10940         ((size == 0) && (ptr != NULL)).
10941
10942 posix_fallocate.3
10943     Samuel Thibault
10944         s/stdlib.h/fcntl.h/ in SYNOPSIS.
10945
10946 proc.5
10947     Fernando Luis Vázquez Cao
10948         Update /proc/[number]/cmdline description.
10949         It used to be true that the command line arguments were
10950         not accessible when the process had been swapped out.
10951         In ancient kernels (circa 2.0.*) the problem was that the
10952         kernel relied on get_phys_addr to access the user space buffer,
10953         which stopped working as soon as the process was swapped out.
10954         Recent kernels use get_user_pages for the same purpose and thus
10955         they should not have that limitation.
10956
10957 epoll.7
10958     Davide Libenzi / mtk
10959         Clarify the somewhat unintuitive behavior that occurs if a file
10960         descriptor in an epoll set is closed while other file descriptors
10961         referring to the same underlying open file description remain
10962         open.
10963         See also http://thread.gmane.org/gmane.linux.kernel/596462/.
10964     mtk
10965         Clarify error that occurs if we add an epoll fd to its own set.
10966     mtk
10967         A few minor rewordings.
10968     mtk, after a note by Chris Heath
10969         Rework Q1/A1, describing what happens when adding the same
10970         file descriptor twice to an epoll set, and when adding duplicate
10971         file descriptors to the same epoll set.
10972     Heikki Orsila / mtk / Davide Libenzi
10973         Clarify Q9/A9 to discuss packet/token-oriented files.
10974     mtk, after comments by Davide Libenzi and Chris Heath
10975         Added Q0/A0, making explicit that the key for items in an epoll
10976         set is [file descriptor, open file description].
10977     mtk, after a note by Ron Burk
10978         Change A3, to note that when events are available,
10979         the epoll file descriptor will indicate as being readable.
10980     mtk
10981         Add some further explanation to Q5/A5 about why an epoll file
10982         descriptor cannot be passed across a Unix domain socket.
10983
10984 posixoptions.7
10985     mtk
10986         Add SEE ALSO entry for standards(7).
10987
10988 regex.7
10989     mtk
10990         Add grep(1) to SEE ALSO.
10991         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=348552.
10992
10993 standards.7
10994     mtk
10995         Add SEE ALSO entry for posixoptions(7).
10996
10997 time.7
10998     mtk
10999         Added SEE ALSO entry referring to timerfd_create.2.
11000
11001
11002 ==================== Changes in man-pages-2.80 ====================
11003
11004 Released: 2008-06-05
11005
11006
11007 Contributors
11008 ------------
11009
11010 The following people contributed notes, ideas, or patches that have
11011 been incorporated in changes in this release:
11012
11013 Adrian Bunk <bunk@kernel.org>
11014 Alain Portal <aportal@univ-montp2.fr>
11015 Andreas Herrmann <andreas.herrmann3@amd.com>
11016 Andrew Morton <akpm@linux-foundation.org>
11017 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
11018 Anoop <acv@linux.vnet.ibm.com>
11019 Aurelien Gerome <ag@roxor.cx>
11020 Daniel Burr <dburr@topcon.com>
11021 Davide Libenzi <davidel@xmailserver.org>
11022 Felix Kater <fkater@googlemail.com>
11023 Folkert van Heusden <folkert@vanheusden.com>
11024 Hamaji Shinichiro <shinichiro.hamaji@gmail.com>
11025 Heikki Orsila <shd@modeemi.fi>
11026 Ingo Molnar <mingo@elte.hu>
11027 Justin Pryzby <justinpryzby@users.sourceforge.net>
11028 Karsten Weiss <K.Weiss@science-computing.de>
11029 Martin Pitt <mpitt@debian.org>
11030 Marty Leisner <leisner@rochester.rr.com>
11031 Nicolas François <nicolas.francois@trialog.com>
11032 Nick Piggin <npiggin@suse.de>
11033 Petter Reinholdtsen <pere@hungry.com>
11034 Reuben Thomas <rrt@sc3d.org>
11035 Sam Varshavchik <mrsam@courier-mta.com>
11036 Stuart Brady <sdbrady@ntlworld.com>
11037 Theodoros V. Kalamatianos <thkala@softlab.ece.ntua.gr>
11038 Thomas Huriaux <thomas.huriaux@gmail.com>
11039 Tim Stoakes <tim@stoakes.net>
11040 Timothy Baldwin <T.E.Baldwin99@members.leeds.ac.uk>
11041 Tolga Dalman <tdalman@project-psi.org>
11042
11043 Apologies if I missed anyone!
11044
11045
11046 Global changes
11047 --------------
11048
11049 bdflush.2
11050 inotify_add_watch.2
11051 mprotect.2
11052 sigprocmask.2
11053 ctime.3
11054 getusershell.3
11055 setbuf.3
11056 st.4
11057 ip.7
11058 packet.7
11059     mtk
11060         Replace "(il)legal" by "(not) permitted" or "(in)valid".
11061
11062 read.2
11063 utime.2
11064 filesystems.5
11065 packet.7
11066     mtk
11067         s/time stamp/timestamp/, for consistency with majority use
11068         in other pages, and in POSIX.1.
11069
11070 madvise.2
11071 mbind.2
11072 mincore.2
11073 mmap.2
11074 mmap2.2
11075 msync.2
11076 remap_file_pages.2
11077     mtk
11078         Change name of 'start' argument to 'addr' for consistency
11079         with:
11080             * other memory-related interfaces
11081             * POSIX specification (for those interfaces in POSIX)
11082             * Linux and glibc source code (in at least some cases)
11083
11084 Various pages
11085     mtk
11086         s/filesystem/file system/, for consistency with majority use
11087         in other pages, and in POSIX.1.
11088
11089 Various pages
11090     mtk
11091         s/zeroes/zeros/, for consistency with majority use
11092         in other pages, and in POSIX.1.
11093
11094 abs.3
11095 proc.5
11096     mtk
11097         s/builtin/built-in/, for consistency with majority use
11098         in other pages, and in POSIX.1.
11099
11100 mknod.2
11101 ftw.3
11102     mtk
11103         s/normal file/regular file/
11104
11105 Various pages
11106     mtk
11107         s/nonempty/non-empty/
11108
11109 Various pages
11110     mtk
11111         s/nonzero/non-zero/
11112
11113 Various pages
11114     mtk
11115         s/realtime/real-time/, for consistency with majority usage.
11116
11117 Various pages
11118     mtk
11119         s/command line/command-line/ when used attributively.
11120
11121 Various pages
11122     mtk
11123         Use "run time" when non-attributive, "run-time" when attributive.
11124
11125 Various pages
11126     mtk
11127         Various pages that I wrote carried a slightly modified version
11128         of the "verbatim" license.  In the interests of minimizing
11129         license proliferation, I've reverted the modified form
11130         so that the license is exactly the same as on other pages
11131         carrying the verbatim license.
11132
11133 epoll_ctl.2
11134 getitimer.2
11135 getrlimit.2
11136 unix.7
11137     mtk
11138         s/since kernel x.y.z/since Linux x.y.z/
11139
11140 wait.2
11141 inotify.7
11142     mtk
11143         Reformat kernel version information for flags.
11144
11145 Typographical or grammatical errors have been corrected in several places.
11146 (Special thanks to Nicolas François.)
11147
11148
11149 New pages
11150 ---------
11151
11152 random_r.3
11153     mtk, after a suggestion by aeb
11154         Documents random_r(3), srandom_r(3), initstate_r(3), and
11155         setstate_r(3), which are the reentrant equivalents of
11156         random(3), srandom(3), initstate(3), and setstate(3).
11157
11158
11159 New links
11160 ---------
11161
11162 lutimes.3
11163     mtk
11164         Link to futimes.3.
11165
11166 initstate_r.3
11167 setstate_r.3
11168 srandom_r.3
11169     mtk
11170         Links to random_r.3.
11171
11172 daylight.3
11173 timezone.3
11174 tzname.3
11175     mtk
11176         Links to tzset.3.
11177
11178 isnanf.3
11179 isnanl.3
11180     mtk
11181         Links to finite.3.
11182
11183 encrypt_r.3
11184 setkey_r.3
11185     mtk
11186         Links to encrypt.3.
11187
11188
11189 Changes to individual pages
11190 ---------------------------
11191
11192 clone.2
11193     mtk
11194         Added note that CLONE_STOPPED (which no-one uses anyway) is
11195         now deprecated.
11196
11197 epoll_create.2
11198     mtk
11199         Add NOTES section pointing out that 'size' argument is unused
11200         since kernel 2.6.8.
11201
11202 epoll_ctl.2
11203     mtk
11204         Added portability note to BUGS text for EPOLL_CTL_DEL.
11205
11206 epoll_wait.2
11207     mtk
11208         If the 'sigmask' is NULL, then epoll_pwait() is equivalent
11209         to epoll_wait().
11210
11211 fork.2
11212     mtk
11213         NOTES: since glibc 2.3.3, the glibc NPTL fork() wrapper
11214         bypasses the fork() system call to invoke clone() with
11215         flags providing equivalent functionality.
11216
11217 futex.2
11218     mtk, after a note from Adrian Bunk
11219         FUTEX_FD has been removed, as of kernel 2.6.26.
11220
11221 futimesat.2
11222     mtk
11223         Note that this system call is made obsolete by utimensat(2).
11224
11225 getgroups.2
11226     Petter Reinholdtsen
11227         SEE ALSO: Add getgrouplist(3).
11228         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=479284.
11229     mtk
11230         NGROUPS_MAX increased in kernel 2.6.4.
11231         SEE ALSO: Add credentials(7).
11232     mtk
11233         Reformat DESCRIPTION and RETURN VALUE sections to be more
11234         consistent with man-pages style.
11235         Add some more detail to descriptions of system calls.
11236         Clarified what happens if caller of getgroups() is a member of
11237         more than 'size' supplementary groups.
11238         ERRORS: Add ENOMEM.
11239
11240 getpriority.2
11241     mtk, after a note from Ingo Molnar
11242         Add text in NOTES about the punchier effect of nice values in
11243         kernel 2.6.23 and later.
11244         Add Documentation/scheduler/sched-nice-design.txt to SEE ALSO list.
11245
11246 gettid.2
11247     mtk
11248         Added VERSIONS section noting that this system call first
11249         appeared in 2.4.11.
11250
11251 kill.2
11252     Marty Leisner / mtk
11253         Add text explicitly noting that sig==0 can be used to check for
11254         the existence of a PID or PGID.
11255     mtk
11256         A few minor rewordings.
11257
11258 mbind.2
11259     mtk
11260         The location of the numactl package has changed.
11261
11262 mmap.2
11263     mtk
11264         Added some .SS headings to make structure of page a little
11265         more obvious.
11266     mtk, with input from Nick Piggin
11267         MAP_POPULATE supports both file and anonymous mappings.
11268         Since 2.6.23, MAP_POPULATE supports private mappings.
11269         Since 2.6.23, MAP_NONBLOCK causes MAP_POPULATE to be a no-op.
11270     mtk
11271         NOTES: Added details on mapping address that is selected by
11272         kernel when MAP_FIXED is / isn't specified.
11273
11274 mount.2
11275     mtk
11276         The MS_REMOUNT changes in 2.4 were at 2.4.10 (not 2.4).
11277     mtk
11278         Minor wording change.
11279
11280 msgctl.2
11281     mtk
11282         Clarify that "unused" fields in msginfo structure are
11283         "unused within the kernel".
11284         msginfo.msgpool is measured in kilobytes, not bytes.
11285         Minor rewordings in comments for msginfo structure.
11286
11287 msgop.2
11288     mtk
11289         Various minor rewordings and restructurings for clarity.
11290     mtk, after a note from Reuben Thomas
11291         Remove "msgop" from NAME section.
11292
11293 mkdir.2
11294     mtk
11295         Clarify meaning of "BSD group semantics".
11296         SEE ALSO: add chown(2).
11297
11298 mknod.2
11299     mtk
11300         SEE ALSO: add chown(2) and chmod(2).
11301
11302 mmap.2
11303     mtk
11304         SEE ALSO: add mprotect(2) and shmat(2).
11305
11306 mprotect.2
11307     Hamaji Shinichiro
11308         SYNOPSIS: s/size_t \*len/size_t len/
11309
11310 open.2
11311     mtk
11312         Note that O_CLOEXEC should be in the next POSIX.1 revision.
11313     mtk
11314         More than just ext2 supports "mount -o bsdgroups" nowadays,
11315         so make the discussion about group ownership of new files a bit
11316         more generic.
11317     mtk
11318         SEE ALSO: add chown(2) and chmod(2).
11319
11320 poll.2
11321     mtk
11322         If the 'sigmask' is NULL, then ppoll() is equivalent to poll()
11323         with respect to signal mask manipulations.
11324
11325 posix_fadvise.2
11326     mtk
11327         s/posix_madvise (2)/posix_madvise (3)/;
11328         (The referred-to page still doesn't exist yet, but hopefully
11329         will do sometime soon.)
11330
11331 ptrace.2
11332     Anoop, Acked by Roland McGrath.
11333         Re PTRACE_PEEKUSER: the offsets and data returned might not
11334         match with the definition of struct user.
11335         See also http://lkml.org/lkml/2008/5/8/375
11336
11337 recv.2
11338     Felix Kater / mtk
11339         Improve wording for EAGAIN error in discussion of MSG_DONTWAIT.
11340
11341 rmdir.2
11342     Martin Pitt
11343         POSIX.1 also allows EEXIST for the ENOTEMPTY error condition.
11344         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=467552.
11345
11346 sched_setscheduler.2
11347     mtk, with input from Ingo Molnar
11348         Add description of SCHED_IDLE policy (new in 2.6.23).
11349         Tweak description of SCHED_BATCH.
11350         Minor rewordings.
11351
11352 select_tut.2
11353     Justin Pryzby
11354         Various wording clean-ups.
11355
11356 semctl.2
11357     mtk
11358         Clarify that "unused" fields in seminfo structure are
11359         "unused within the kernel".
11360         Minor rewordings in comments for seminfo structure.
11361
11362 semop.2
11363     Aurelien Gerome
11364         Small fix in example code.
11365
11366 setpgid.2
11367     mtk / Karsten Weiss
11368         Clarify description of setpgid() a little.
11369
11370 shmctl.2
11371     mtk
11372         Clarify that "unused" fields in shminfo structure are
11373         "unused within the kernel".
11374         Minor rewordings in comments for shminfo structure.
11375
11376 shmop.2
11377     mtk, after a note from Reuben Thomas
11378         Remove "shmop" from NAME section.
11379
11380 signalfd.2
11381     mtk
11382         Added BUGS text noting that before kernel 2.6.25, the ssi_int
11383         and ssi_ptr fields are not set.
11384         Added comments describing fields in signalfd_siginfo structure.
11385         Update field names in example program (s/signo/ssi_signo/).
11386         Various small fixes, and remove duplicated sentence.
11387         Minor edits to structure definition.
11388
11389 sigqueue.2
11390     mtk
11391         Added some comments to code in NOTES.
11392
11393 stat.2
11394     mtk
11395         Minor wording change.
11396
11397 symlink.2
11398     mtk
11399         SEE ALSO: add lchown(2).
11400
11401 sync_file_range.2
11402     mtk / Andrew Morton
11403         Remove statement that (SYNC_FILE_RANGE_WAIT_BEFORE |
11404         SYNC_FILE_RANGE_WRITE | SYNC_FILE_RANGE_WAIT_AFTER) is
11405         a traditional fdatasync(2) operation.
11406         See https://bugzilla.mozilla.org/show_bug.cgi?id=421482
11407         comments 129 to 131.
11408
11409 syscalls.2
11410     mtk
11411         This page is now up to date as at kernel 2.6.25.
11412
11413 syslog.2
11414     mtk
11415         Small tidy up of language relating to permissions/capabilities.
11416
11417 timerfd_create.2
11418     mtk
11419         Minor change to example program.
11420         Minor wording change.
11421
11422 utime.2
11423     Reuben Thomas
11424         Remove unnecessary subheading for utimes().
11425         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=477402.
11426     mtk
11427         Change description in NAME line ("or" is not correct: these calls
11428         always change *both* timestamps).
11429         CONFORMING TO: utimes() is in POSIX.1-2001.
11430     mtk
11431         Rename 'buf' argument of utime() to 'times' (like utimes()).
11432         Clarify explanation of EACCES and EPERM errors.
11433         Remove BUGS section, since it doesn't seem to add useful
11434         information.
11435         Clarified discussion of capabilities, and noted that
11436         CAP_DAC_OVERRIDE also has a role.
11437         Other minor rewordings.
11438
11439 wait.2
11440     mtk, after a note by Justin Pryzby
11441         Add a sentence clarifying that even though the default disposition
11442         of SIGCHLD is "ignore", explicitly setting the disposition to
11443         SIG_IGN results in different treatment of zombies.
11444
11445 aio_cancel.3
11446 aio_error.3
11447 aio_fsync.3
11448 aio_read.3
11449 aio_return.3
11450 aio_suspend.3
11451 aio_write.3
11452     Kevin O'Gorman <kogorman@csc.calpoly.edu>
11453         Add "Link with -lrt" to SYNOPSIS.
11454
11455 backtrace.3
11456     Nicolas François
11457         s/backtrace_symbols/backtrace_symbols_fd/ in one sentence.
11458     mtk
11459         Fix bogus reference to variable 'strings': should be:
11460         "the array of pointers".
11461
11462 ctime.3
11463     mtk
11464         Add warning under NOTES that asctime(), ctime(), gmtime(), and
11465         localtime() may each overwrite the static object returned by any
11466         of the other calls.
11467         Other minor edits.
11468
11469 dlopen.3
11470     mtk
11471         Add more detail to the description of the fields in the
11472         structure returned by dladdr().
11473
11474 fexecve.3
11475     mtk
11476         Clean up SYNOPSIS after work by cut-and-paste-Pete:
11477         the necessary header file is <unistd.h> not <sys/time.h>!
11478
11479 futimes.3
11480     mtk
11481         Add documentation of lutimes(), which appeared in glibc 2.6.
11482     mtk
11483         Change description in NAME line ("or" is not correct: these calls
11484         always change *both* timestamps).
11485         CONFORMING TO: futimes() did not come from 4.2BSD.  (It came from
11486         FreeBSD; see the FreeBSD man page.)
11487
11488 getenv.3
11489     mtk
11490         Noted that caller must not modify returned value string.
11491         Noted that getenv() is not reentrant: the buffer may be statically
11492         allocated and overwritten by later calls to getenv(), putenv(),
11493         setenv(), or unsetenv().
11494         Other minor rewrites.
11495
11496 getgrent.3
11497     Petter Reinholdtsen
11498         SEE ALSO: Add getgrouplist(3).
11499         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=479284.
11500
11501 gethostbyname.3
11502     mtk
11503         Add 'h_errno' to NAME list.
11504
11505 getopt.3
11506     mtk
11507         Add 'optarg', 'optind', 'opterr', and 'optopt' to NAME section.
11508         Add subheading for getopt_long() and getopt_long_only()
11509         description.
11510
11511 getpt.3
11512     mtk
11513         Point out that this function should be avoided in favor of
11514         posix_openpt().
11515         Add ERRORS section referring to open(2).
11516
11517 getsubopt.3
11518     Daniel Burr
11519         SYNOPSIS: Fix declaration of valuep.
11520         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=476672.
11521
11522 malloc.3
11523     mtk
11524         RETURN VALUE: Note circumstances in which successful malloc() and
11525         calloc() can return NULL.
11526
11527 mq_open.3
11528     mtk, after a note by Marty Leisner
11529         Note that <fcntl.h> is needed for O_* constants and <sys/stat.h>
11530         is needed for 'mode' constants.
11531
11532 opendir.3
11533     mtk
11534         Describe treatment of close-on-exec flag by opendir() and
11535         fdopendir().
11536
11537 openpty.3
11538     mtk
11539         SEE ALSO: add ttyname(3).
11540
11541 raise.3
11542     mtk / Timothy Baldwin
11543         Clarify semantics of raise() when called from a multithreaded
11544         program.
11545         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=476484.
11546     mtk
11547         Rewrites and additions to various parts of the page.
11548
11549 rand.3
11550     Tolga Dalman / aeb / mtk
11551         Remove outdated warning in NOTES; encourage the use of
11552         random(3) instead.
11553     Folkert van Heusden
11554         Clarify wording describing range of values returned by rand().
11555
11556 random.3
11557     aeb / mtk / Tolga Dalman
11558         Recommend use or random_r(3) for multithreaded applications
11559         that need independent, reproducible sequences of random numbers.
11560
11561         Move references to "The Art of Computer Programming" and
11562         "Numerical Recipes", formerly in rand(3), to this page.
11563
11564         Add drand48(93) to SEE ALSO list.
11565
11566 regex.3
11567     Heikki Orsila
11568         Clarify description of 'rm_eo' field.
11569
11570 sem_open.3
11571     mtk, after a note by Marty Leisner
11572         Note that <fcntl.h> is needed for O_* constants and <sys/stat.h> is
11573         needed for 'mode' constants.
11574
11575 sem_post.3
11576     mtk
11577         Added pointer to example in sem_wait(3).
11578
11579 sem_close.3
11580 sem_destroy.3
11581 sem_getvalue.3
11582 sem_init.3
11583 sem_open.3
11584 sem_post.3
11585 sem_unlink.3
11586 sem_wait.3
11587     mtk, after a note from Marty Leisner
11588         Add text to SYNOPSIS noting the need to link with "-lrt" or
11589         "-pthread".
11590
11591 setenv.3
11592     mtk
11593         setenv() copies 'name' and 'value' (contrast with putenv()).
11594         unsetenv() of a nonexistent variable does nothing and is
11595         considered successful.
11596         Noted that setenv() and unsetenv() need not be reentrant.
11597
11598 shm_open.3
11599     mtk, after a note by Marty Leisner
11600         Note that <fcntl.h> is needed for O_* constants and <sys/stat.h> is
11601         needed for 'mode' constants.
11602
11603 undocumented.3
11604     mtk
11605         initstate_r(3), setkey_r(3), setstate_r(3) are now documented.
11606
11607 utmp.5
11608     Nicolas François
11609         Small rewording.
11610
11611 resolv.conf.5
11612     Nicolas François
11613         gethostname() is in Section 2, not section 3.
11614
11615 ascii.7
11616     Stuart Brady
11617         Fix rendering of ' (backtick) and apostrophe (') in tables
11618
11619 charsets.7
11620     Nicolas François
11621         s/unicode.com/unicode.org/
11622
11623 credentials.7
11624     mtk
11625         NOTES: Pthreads requires that all threads share the same UIDs and
11626         GIDs.  But the Linux kernel maintains separate UIDs and GIDs for
11627         every thread.  NPTL does some work to ensure that credential
11628         changes by any thread are carried through to all POSIX threads in
11629         a process.
11630     mtk
11631         sysconf(_SC_NGROUPS_MAX) can be used to determine the number of
11632         supplementary groups that a process may belong to.
11633         Clarify that supplementary group IDs are specified in POSIX.1-2001.
11634
11635 epoll.7
11636     mtk, after a note from Sam Varshavchik
11637         For answer A2, change "not recommended" to "careful programming
11638         may be required".
11639
11640 inotify.7
11641     mtk
11642         Document SIGIO feature (new in 2.6.25) for inotify file descriptors.
11643     mtk
11644         Note that select()/poll()/epoll_wait() indicate a ready inotify
11645         file descriptor as readable.
11646     mtk
11647         Document IN_ATTRIB in a little more detail.
11648
11649 pthreads.7
11650     Justin Pryzby
11651         Grammar fix, plus fix typo in script.
11652     mtk
11653         Add list of thread-safe functions.
11654
11655 standards.7
11656     mtk
11657         Add a section on the upcoming POSIX revision.
11658
11659 ld.so.8
11660     Justin Pryzby / mtk
11661         Various wording improvements.
11662
11663
11664 ==================== Changes in man-pages-3.00 ====================
11665
11666 Released: 2008-06-12, Konolfingen
11667
11668
11669 Contributors
11670 ------------
11671
11672 The following people contributed notes, ideas, or patches that have
11673 been incorporated in changes in this release:
11674
11675 Andries Brouwer <Andries.Brouwer@cwi.nl>
11676 Stuart Brady <sdbrady@ntlworld.com>
11677
11678 Apologies if I missed anyone!
11679
11680
11681 Global changes
11682 --------------
11683
11684 The POSIX.1 man pages (sections 0p, 1p, 3p) have been moved out
11685 of this package into the separate man-pages-posix package.
11686 This made sense because those pages are seldom changed (only formatting
11687 fixes, etc.) so that it was unnecessary to redistribute them with each
11688 man-pages release.
11689
11690
11691 console_codes.4
11692 random.4
11693 dir_colors.5
11694 proc.5
11695 glob.7
11696     Stuart Brady
11697         s/`/\`/ for backquotes used in command substitution, for
11698         proper rendering in UTF-8.
11699
11700 Various pages
11701     mtk, after a note from Stuart Brady
11702         Using /'x'/ to denote a character (string) renders poorly in
11703         UTF-8, where the two ' characters render as closing single
11704         quotes.  On the other hand, using /`x'/ renders nicely on UTF-8,
11705         where proper opening and closing single quotes are produced by
11706         groff(1), but looks ugly when rendered in ASCII.  Using the
11707         sequence /\\aqx\\aq/ produces a reasonable rendering ('\\aq'
11708         is a vertical "apostrophe quote") in both UTF-8 and ASCII.
11709         So that change is made in a number of pages.
11710         See also http://www.cl.cal.ac.uk/~mgk25/ucs/quotes.html.
11711
11712 Various pages
11713     mtk
11714         Replace form /`string'/ by /"string"/, since the former renders
11715         poorly in ASCII.
11716
11717 termios.3
11718 console_codes.4
11719 tty_ioctl.4
11720 termcap.5
11721 charsets.7
11722     mtk
11723         Control character names (^X) are written boldface, without
11724         quotes.
11725
11726 printf.3
11727 scanf.3
11728 proc.5
11729 glob.7
11730 regex.7
11731     mtk
11732         Various edits to try and bring some consistency to the use of
11733         quotes.
11734
11735
11736 Changes to individual pages
11737 ---------------------------
11738
11739 tty_ioctl.4
11740     mtk
11741         Small rewordings in description of packet mode.
11742
11743 locale.7
11744     mtk
11745         Minor formatting fixes.
11746
11747
11748 ==================== Changes in man-pages-3.01 ====================
11749
11750 Released: 2008-06-25, Munich
11751
11752
11753 Contributors
11754 ------------
11755
11756 The following people contributed notes, ideas, or patches that have
11757 been incorporated in changes in this release:
11758
11759 Alain Portal <aportal@univ-montp2.fr>
11760 Andreas Herrmann <andreas.herrmann3@amd.comm>
11761 Andrew P <ap@zip.com.au>
11762 Andrew Clayton <andrew@digital-domain.net>
11763 Bart Van Assche <bart.vanassche@gmail.com>
11764 Christian Borntraeger <borntraeger@de.ib.com>
11765 Christoph Hellwig <hch@infradead.org>
11766 Daniele Giacomini <appunti2@gmail.com>
11767 Dorin Lazar <dorin.lazar@gmail.com>
11768 George Spelvin <linux@horizon.com>
11769 Jason Englander <jason@englanders.cc>
11770 Jeff Moyer <jmoyer@redhat.com>
11771 Laurent Vivier <laurent.vivier@bull.net>
11772 Masatake YAMOTO <yamoto@redhat.com>
11773 Matt Mackall <mpm@selenic.com>
11774 Neil Horman <nhorman@tuxdriver.com>
11775 Pavel Machek <pavel@suse.cz>
11776 Peter Zijlstra <a.p.zijlstra@chello.nl>
11777 Petr Baudis <pasky@suse.cz>
11778 Petr Gajdos <pgajdos@suse.cz>
11779 Roman Zippel <zippel@linux-m68k.org>
11780 Sam Varshavchik <mrsam@courier-mta.com>
11781 Samuel Thibault <samuel.thibault@ens-lyon.org>
11782 Stephane Chazelas <stephane_chazelas@yahoo.fr>
11783 Stuart Cunningham <stuartc@rd.bbc.co.uk>
11784 Thomas Gleixner <tglx@linutronix.de>
11785 Tolga Dalman <tdalman@project-psi.org>
11786 Yao Zhao <dragonlinux@gmail.com>
11787 WANG Cong <wcong@critical-links.com>
11788
11789 Apologies if I missed anyone!
11790
11791
11792 New and rewritten pages
11793 -----------------------
11794
11795 acct.5
11796     mtk
11797         A complete rewrite of this page, now with much more detail.
11798
11799 hostname.7
11800     mtk
11801         A description of hostname resolution.  Taken from FreeBSD 6.2,
11802         and lightly edited for man-pages style.
11803
11804 symlink.7
11805     mtk
11806         A description of symbolic links.  Taken from FreeBSD 6.2, but
11807         heavily edited for Linux details, improved readability, and
11808         man-pages style.
11809
11810
11811 Newly documented interfaces in existing pages
11812 ---------------------------------------------
11813
11814 getrlimit.2
11815     mtk / Peter Zijlstra
11816         Add description of RLIMIT_RTTIME limit, new in 2.6.25.
11817
11818 mkstemp.3
11819     mtk
11820         Add description of mkostemp(), new in glibc 2.7.
11821
11822 core.5
11823     mtk, after a note by Petr Gajdos; review by Neil Horman
11824         Document core_pattern pipe syntax, which appeared in
11825         kernel 2.6.19.
11826         Add an example program demonstrating use of core_pattern
11827         pipe syntax.
11828     mtk
11829         Document /proc/PID/coredump_filter, new in kernel 2.6.23.
11830         Documentation was based on the text in
11831         Documentation/filesystems/proc.txt, plus testing, and
11832         checking the kernel source.
11833
11834 proc.5
11835     mtk
11836         Document /proc/PID/oom_score, which was new in kernel 2.6.11.
11837         This file displays the "badness" score of the process, which
11838         provides the basis for OOM-killer decisions.
11839     mtk
11840         Document /proc/PID/oom_adj, which was new in kernel 2.6.11.
11841         This file influences the oom_score of a process.
11842     mtk
11843         Document /proc/PID/limits, which was new in 2.6.24.
11844         This file displays a process's resource limits.
11845     mtk
11846         Document /proc/PID/fdinfo/*, which was new in 2.6.22.
11847         These files display info about each descriptor opened by the
11848         process: the current file offset, and the file access mode +
11849         file status flags as set in open() or fcntl(F_SETFL).
11850     mtk
11851         Document /proc/PID/mountinfo, which was new in 2.6.26.
11852         This file displays information about mount points.
11853         Closely based on text from Documentation/filesystems/proc.txt.
11854     mtk
11855         Document /proc/PID/mountstats, which was new in 2.6.17.
11856         This file displays statistics about mount points.
11857     mtk
11858         Document /proc/PID/status.
11859     Samuel Thibault / mtk, review by Laurent Vivier,
11860                 Christian Borntraeger, and Andrew P
11861         Document guest (virtual CPU) time field in /proc/stat.
11862         Document guest (virtual CPU) time fields in /proc/PID/stat.
11863
11864
11865 New links
11866 ---------
11867
11868 mkostemp.3
11869     mtk
11870         Link to mkstemp.3.
11871
11872 getcwd.2
11873     mtk
11874         Link to getcwd.3, which describes several interfaces, among
11875         them getcwd(), which is in fact a system call.
11876
11877
11878 Global changes
11879 --------------
11880
11881 sched_setaffinity.2
11882 sched_setscheduler.2
11883 set_mempolicy.2
11884 mbind.2
11885     mtk
11886         SEE ALSO: Add cpuset(7).
11887
11888 chown.2
11889 faccessat.2
11890 fchmodat.2
11891 fchownat.2
11892 fstatat.2
11893 getxattr.2
11894 link.2
11895 linkat.2
11896 listxattr.2
11897 open.2
11898 readlink.2
11899 removexattr.2
11900 rename.2
11901 setxattr.2
11902 stat.2
11903 symlink.2
11904 symlinkat.2
11905 unlink.2
11906 futimes.3
11907 remove.3
11908 path_resolution.7
11909     mtk
11910         SEE ALSO: Add symlink(7).
11911
11912 intro.1
11913 time.1
11914 fcntl.2
11915 gethostbyname.3
11916 ioctl_list.2
11917     mtk
11918         Wrap source lines so that new sentence starts on new line.
11919
11920 addseverity.3
11921 backtrace.3
11922 dlopen.3
11923 fmtmsg.3
11924 getnameinfo.3
11925 getpt.3
11926 grantpt.3
11927 makecontext.3
11928 ptsname.3
11929 tcgetsid.3
11930 unlockpt.3
11931 wordexp.3
11932     mtk
11933         Added VERSIONS section.
11934
11935 msgctl.2
11936 msgget.2
11937 semget.2
11938 semop.2
11939 pciconfig_read.2
11940 basename.3
11941 cmsg.3
11942 ftok.3
11943 console_ioctl.4
11944 tzfile.5
11945 mq_overview.7
11946 pty.7
11947     mtk
11948         For consistency, "fix" cases where argument of .B or .I was
11949         on the following source line.
11950
11951 adjtimex.2
11952 getrusage.2
11953 io_getevents.2
11954 poll.2
11955 select.2
11956 semop.2
11957 sigwaitinfo.2
11958 aio_suspend.3
11959 clock_getres.3
11960 mq_receive.3
11961 mq_send.3
11962 sem_wait.3
11963 proc.5
11964     mtk
11965         SEE ALSO: add time(7)
11966
11967 Typographical or grammatical errors have been corrected in several places.
11968 (Special thanks to Nicolas François and Alain Portal.)
11969
11970
11971 Changes to individual pages
11972 ---------------------------
11973
11974 acct.2
11975     mtk
11976         Add a few more words to DESCRIPTION.
11977         NOTES: Add pointer to acct(5).
11978
11979 alarm.2
11980     Alain Portal
11981         s/process/calling process/ so as to say that the alarm signal is
11982         delivered to the calling process.
11983
11984 brk.2
11985     Yao Zhao / mtk
11986         Clarify discussion of return value of sbrk().
11987     mtk
11988         DESCRIPTION: Add some sentences giving an overview of these
11989         interfaces.
11990         Add note recommending use of malloc(3).
11991         Change name of brk() argument to the simpler 'addr'.
11992         Add "(void *)" cast to "-1" for error return of sbrk().
11993         Removed some incorrect text about "brk(0)".
11994         Note that SUSv2 specified the return value of sbrk().
11995         Added a detail on the glibc brk() wrapper.
11996         Remove discussions of old standards (C89 and POSIX.1-1990);
11997         CONFORMING TO already discusses the situation with respect
11998         to more recent standards.
11999
12000 chmod.2
12001     mtk
12002         Clarify description of chmod() and fchmod().
12003         Add further detail on S_ISUID, S_ISGID, and S_ISVTX permissions.
12004         Reformat list of permissions bits.
12005
12006 chown.2
12007     mtk
12008         Describe rules governing ownership of new files (bsdgroups
12009         versus sysvgroups, and the effect of the parent directory's
12010         set-group-ID permission bit).
12011
12012 chroot.2
12013     Alain Portal
12014         Clarify description a little.
12015         s/changes the root directory/
12016           changes the root directory of the calling process/
12017
12018 execve.2
12019     mtk
12020         Fix text that warns against use of NULL argv and envp.
12021         Using a NULL envp does in fact seem to be portable (works
12022         on Solaris and FreeBSD), but the Linux semantics for a NULL
12023         argv certainly aren't consistent with other implementations.
12024         See http://bugzilla.kernel.org/show_bug.cgi?id=8408.
12025
12026 getdents.2
12027     mtk, after a note from George Spelvin
12028         Document d_type field, present since kernel 2.6.4.
12029         Other minor edits.
12030
12031 getitimer.2
12032     mtk
12033         Noted that POSIX.1 leaves interactions with alarm(), sleep(),
12034         and usleep() unspecified.
12035         Linux 2.6.16 removed the MAX_SEC_IN_JIFFIES ceiling on timer
12036         values.
12037         Other minor changes.
12038
12039 io_cancel.2
12040 io_destroy.2
12041 io_getevents.2
12042 io_setup.2
12043 io_submit.2
12044     mtk, after a note by Masatake YAMOTO and input from Jeff Moyer
12045         Describe the unconventional error return provided by the
12046         wrapper function in libaio (and contrast with behavior if
12047         the system call is invoked via syscall(2)).
12048         See http://thread.gmane.org/gmane.linux.ltp/4445/
12049     Alain Portal / mtk
12050         Re-order ERRORS and SEE ALSO entries to be alphabetical.
12051
12052 io_getevents.2
12053     Alain Portal
12054         Small wording fix.
12055
12056 io_submit.2
12057     Jeff Moyer
12058         s/AIO request blocks/AIO control blocks/
12059
12060 mknod.2
12061     mtk
12062         Note that EEXIST applies, even if the pathname is a
12063         (possibly dangling) symbolic link.
12064
12065 nanosleep.2
12066     mtk, after a report from Stephane Chazelas
12067         Remove crufty discussion of HZ, and replace with a pointer
12068         to time(7).
12069         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=485636
12070     mtk, after some discussions with Bart Van Assche and Roman Zippel
12071         NOTES: describe CLOCK_REALTIME versus CLOCK_NANOSLEEP
12072         See also http://thread.gmane.org/gmane.linux.kernel/696854/
12073         "nanosleep() uses CLOCK_MONOTONIC, should be CLOCK_REALTIME?"
12074     mtk
12075         Replace mentions of "process' by "thread".
12076         NOTES: describe case where clock_nanosleep() can be preferable.
12077         Some minor rewrites.
12078
12079 open.2
12080     mtk, after a note from Christoph Hellwig
12081         NOTES: Note that access mode flags are not single bits,
12082         and document the Linuxism "access mode 3".
12083         See also http://thread.gmane.org/gmane.linux.kernel/653123.
12084
12085 readdir.2
12086     mtk
12087         Minor wording fixes.
12088
12089 recv.2
12090     Alain Portal
12091         Add comment to 'ee_pad' field in structure definition.
12092
12093 sched_setscheduler.2
12094     mtk
12095         Add pointer to discussion of RLIMIT_RTTIME in getrlimit.2.
12096     mtk, after a note by Andrew Clayton
12097         Rewrote and restructured various parts of the page for greater
12098         clarity.
12099     mtk
12100         Add more detail to the rules that are applied when an
12101         unprivileged process with a non-zero RLIMIT_RTPRIO limit
12102         changes policy and priority.
12103         SEE ALSO: Add Documentation/scheduler/sched-rt-group.txt
12104
12105 sync_file_range.2
12106     Pavel Machek
12107         SYNC_FILE_RANGE_WRITE can block on writes greater than request
12108         queue size.  For some background, see
12109         http://thread.gmane.org/gmane.linux.kernel/687713/focus=688340
12110
12111 syscalls.2
12112     mtk
12113         Added system call history back to version 1.2.
12114         Fix typo on kernel version for pivot_root().
12115
12116 syslog.2
12117     WANG Cong
12118         Document ENOSYS error, which can occur if kernel was built without
12119         CONFIG_PRINTK.
12120
12121 utime.2
12122     Nicolas François
12123         Clarify description of 'times' array for utimes().
12124
12125 adjtime.3
12126     mtk
12127         The longstanding bug that if delta was NULL, olddelta
12128         didn't return the outstanding clock adjustment, is now fixed
12129         (since glibc 2.8 + kernel 2.6.26).
12130         http://sourceware.org/bugzilla/show_bug?id=2449
12131         http://bugzilla.kernel.org/show_bug.cgi?id=6761
12132
12133 dprintf.3
12134     mtk
12135         Note that these functions are included in the next POSIX revision.
12136         Remove editorial discussion about what the functions should have
12137         been named.
12138
12139 ftime.3
12140     mtk
12141         Rewrote various pieces, and added some details.
12142
12143 getaddrinfo.3
12144     mtk
12145         Improve description or 'hints' and 'res' arguments.
12146         Add details on numeric strings that can be specified for 'node'.
12147         Other fairly major restructurings and rewrites to improve
12148         logical structure and clarity of the page.
12149         SEE ALSO: Add hostname(7).
12150
12151 gethostbyname.3
12152     mtk
12153         DESCRIPTION: Add reference to inet_addr(3) for dotted notation.
12154         SEE ALSO: add inet(3).
12155     mtk
12156         Added BUGS section noting that gethostbyname() does not
12157         recognize hexadecimal components in dotted address strings;
12158         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482973
12159
12160 getmntent.3
12161     mtk, after Stuart Cunningham pointed out the typo
12162         Remove statement that LSB deprecates the functions
12163         "endmntent(), setmntent() [sic] and setmntent()".
12164         This doesn't seem to be true (I can't find mention of it
12165         being deprecated in any of the LSB specs).  Rather, LSB simply
12166         doesn't specify these functions.  (LSB 1.3 had a spec of
12167         setmntent(), but not getmntent() or endmntent(), and noted
12168         that having a spec of setmntent() was of little use without
12169         also having a spec of getmntent().)
12170         See also https://lists.linux-foundation.org/pipermail/lsb-discuss/2006-October/003078.html
12171
12172 getnameinfo.3
12173     Tolga Dalman
12174         Remove mention of sa_len field from example code.
12175         That field is a BSDism not present on Linux.
12176     mtk
12177         Various minor changes.
12178
12179 inet.3
12180     mtk / Stephane Chazelas
12181         inet_aton() is *not* in POSIX.1.
12182         Rewrote discussion of why inet_addr() is disfavored.
12183         SEE ALSO: Add getaddrinfo(3).
12184         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482979.
12185     mtk, after a note by Stephane Chazelas
12186         Describe the various address forms supported by inet_aton().
12187     mtk
12188         Rewrite description of inet_network().
12189         Clarify discussion of inet_lnaof(), inet_netof(), and inet_makeaddr().
12190         Add discussion of Classful Addressing, noting that it is obsolete.
12191         Added an EXAMPLE program.
12192     mtk
12193         Relocate discussion of i386 byte order to NOTES.
12194         Note that inet_aton() returns an address in network byte order.
12195         SEE ALSO: Add byteorder(3) and getnameinfo(3).
12196
12197 inet_ntop.3
12198     mtk
12199         Remove unneeded header files from SYNOPSIS.
12200         SEE ALSO: Add inet(3) and getnameinfo(3).
12201         Make NAME line more precise.
12202         Move errors to an ERRORS section.
12203         Add EXAMPLE section pointing to inet_pton(3).
12204
12205 inet_pton.3
12206     mtk / Stephane Chazelas
12207         Remove statement that inet_pton() extends inet_ntoa();
12208         that's not really true, since inet_pton() doesn't support
12209         all of the string forms that are supported by inet_ntoa().
12210         SEE ALSO: Add getaddrinfo(3).
12211         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482987.
12212     mtk
12213         Describe IPv6 address formats.
12214         Describe dotted decimal format in more detail.
12215         Add an example program.
12216     mtk
12217         Remove unneeded header files from SYNOPSIS.
12218         Make NAME line more precise.
12219         Make description of return value more precise.
12220         SEE ALSO: Add inet(3).
12221
12222 mkfifo.3
12223     mtk
12224         Note that EEXIST applies, even if the pathname is a
12225         (possibly dangling) symbolic link.
12226
12227 mkstemp.3
12228     mtk
12229         Fix discussion of O_EXCL flag.
12230         These functions may also fail for any of the errors described
12231         in open(2).
12232         Various other rewordings.
12233
12234 readdir.3
12235     mtk
12236         Document DT_LNK (symbolic link) for d_type field.
12237         Reorder DT_ entries alphabetically.
12238
12239 remainder.3
12240     mtk
12241         Recommend against drem(), in favor of remainder().
12242
12243 scanf.3
12244     mtk, after a note from Stephane Chazelas
12245         Add an ERRORS section documenting at least some of the errors
12246         that may occur for scanf().
12247         See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=487254.
12248     mtk, after a note from Stephane Chazelas; review by Stephane Chazelas
12249         Document the GNU 'a' modifier for dynamically allocating strings.
12250         See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=487254.
12251         Document the GNU 'm' modifier for dynamically allocating strings.
12252
12253 strcat.3
12254     Andreas Herrmann
12255         s/strcat/strncat/ (a typo that changed the semantics in
12256         DESCRIPTION).
12257
12258 strerror.3
12259     mtk, after a note from Daniele Giacomini
12260         Modify SYNOPSIS to show protoypes of both versions of strerror_r(),
12261         and make other small clarifications of the description regarding
12262         the two versions.
12263
12264 random.4
12265     George Spelvin (taking time out from his busy Broadway schedule),
12266     with some tweaks by Matt Mackall and mtk
12267         Add a Usage subsection that recommends most users to use
12268         /dev/urandom, and emphasizes parsimonious usage of
12269         /dev/random.
12270
12271 locale.5
12272     Petr Baudis <pasky@suse.cz>
12273         LC_TIME: Describe first_weekday and first_workday.
12274
12275 proc.5
12276     mtk
12277         The vaious CPU time fields in /proc/stat and /proc/PID/stat
12278         return time in clock ticks (USER_HZ, cputime_to_clock_t(),
12279         sysconf(_SC_CLK_TCK)).
12280         Updated, clarified and expanded the description several
12281         fields in /proc/[number]/stat.
12282     mtk
12283         Clarified and expanded the description of /proc/[number]/fd.
12284     mtk
12285         Updated and clarified the description of /proc/[number]/statm.
12286     mtk
12287         Updated and clarified the description of /proc/sys/fs/dentry-state.
12288     mtk
12289         Many formatting, wording, and grammar fixes.
12290
12291 man-pages.7
12292     mtk
12293         Enhanced description of VERSIONS section.
12294
12295 mq_overview.7
12296     mtk
12297         Note that Linux does not currently support ACLs for POSIX
12298         message queues.
12299
12300 sem_overview.7
12301     mtk
12302         Note that Linux supports ACLs on POSIX named semaphores
12303         since 2.6.19.
12304
12305 time.7
12306     mtk, with some suggestions from Bart Van Assche and Thomas Gleixner
12307         Added some details about where jiffies come into play.
12308         Added section on high-resolution timers.
12309         Mentioned a few other time-related interfaces at various
12310         points in the page.
12311         See http://thread.gmane.org/gmane.linux.kernel/697378.
12312
12313 unix.7
12314     mtk, after a note by Samuel Thibault
12315         Provide a clear description of the three types of address that
12316         can appear in the sockaddr_un structure: pathname, unnamed,
12317         and abstract.
12318
12319
12320 ==================== Changes in man-pages-3.02 ====================
12321
12322 Released: 2008-07-02, Konolfingen
12323
12324
12325 Contributors
12326 ------------
12327
12328 The following people contributed notes, ideas, or patches that have
12329 been incorporated in changes in this release:
12330
12331 Alain Portal <aportal@univ-montp2.fr>
12332 Andries Brouwer <Andries.Brouwer@cwi.nl>
12333 Reuben Thomas <rrt@sc3d.org>
12334 Sam Varshavchik <mrsam@courier-mta.com>
12335 Stephane Chazelas <stephane_chazelas@yahoo.fr>
12336 WANG Cong <xiyou.wangcong@gmail.com>
12337
12338 Apologies if I missed anyone!
12339
12340
12341 New and rewritten pages
12342 -----------------------
12343
12344 clock_nanosleep.2
12345     mtk
12346         A description of the clock_nanosleep() system call,
12347         which was added in kernel 2.6.
12348
12349 getgrouplist.3
12350     mtk
12351         A near complete rewrite, including additional information and
12352         a new example program.
12353
12354 getutmp.3
12355     mtk
12356         Documents getutmp(3) and getutmpx(3).
12357
12358 gnu_get_libc_version.3
12359     mtk
12360         Documents gnu_get_libc_version(3) and gnu_get_libc_release(3).
12361
12362 sigwait.3
12363     mtk
12364         Documents sigwait(3).
12365
12366 shm_overview.7
12367     mtk
12368         An overview of the POSIX shared memory API.
12369
12370
12371 Newly documented interfaces in existing pages
12372 ---------------------------------------------
12373
12374 updwtmp.3
12375     mtk
12376         Document updwtmpx(3).
12377
12378
12379 New links
12380 ---------
12381
12382 getutmpx.3
12383     mtk
12384         Link to getutmp.3.
12385
12386 gnu_get_libc_release.3
12387     mtk
12388         Link to gnu_get_libc_version.3
12389
12390 updwtmpx.3
12391     mtk
12392         Link to updwtmp.3
12393
12394 utmpxname.3
12395     mtk
12396         Link to getutent.3.
12397
12398 utmpx.5
12399     mtk
12400         Link to utmp.5.
12401
12402
12403 Global changes
12404 --------------
12405
12406 Various pages
12407     mtk
12408         s/user name/username/
12409
12410 Various pages
12411     mtk
12412         s/host name/hostname/
12413
12414
12415 Changes to individual pages
12416 ---------------------------
12417
12418 fchmodat.2
12419     Alain Portal
12420         SEE ALSO: add symlink.7.  (3.01 changelog wrongly said this
12421         had been done.)
12422
12423 io_setup.2
12424     Alain Portal
12425         Remove superfluous text from RETURN VALUE.
12426
12427 mmap.2
12428     mtk
12429         SEE ALSO: Add mmap(2), shm_overview(7).
12430
12431 shmget.2
12432 shmop.2
12433     mtk
12434         SEE ALSO: add shm_overview(7).
12435
12436 sigreturn.2
12437     mtk
12438         Added a bit more detail on what sigreturn() actually does.
12439
12440 signalfd.2
12441 sigsuspend.2
12442     mtk
12443         SEE ALSO: Add sigwait(3).
12444
12445 sigwaitinfo.2
12446     mtk
12447         Describe behavior when multiple threads are blocked in
12448         sigwaitinfo()/sigtimedwait().
12449         SEE ALSO: Add sigwait(3).
12450
12451 dirfd.3
12452     mtk
12453         RETURN VALUE: describe return value on success.
12454         Add an ERRORS section documenting POSIX.1-specified errors.
12455
12456 getaddrinfo.3
12457     mtk, after a note by Stephane Chazelas
12458         getaddrinfo() supports specifying IPv6 scope-IDs.
12459
12460 getlogin.3
12461     mtk
12462         ERRORS: add ENOTTY.
12463         SEE ALSO: add utmp(5).
12464
12465 getutent.3
12466     WANG Cong
12467         utmpname() does return a value.
12468     mtk
12469         Add paragraph to start of DESCRIPTION recommending
12470         use of POSIX.1 "utmpx" functions.
12471         CONFORMING TO: mention utmpxname().
12472         Add an ERRORS section.
12473         There are no utmpx equivalents of the _r reentrant functions.
12474         Clarify discussion of return values.
12475         Add pointer to definition of utmp structure in utmp(5).
12476         Clarify discussion of utmpx file on other systems (versus
12477         Linux situation).
12478
12479 getutent.3
12480     mtk
12481         SEE ALSO: add getutmp(3)
12482
12483 inet_pton.3
12484     Stephane Chazelas
12485         Fix error in description of IPv6 presentation format:
12486         s/x.x.x.x.x.x.x.x/x:x:x:x:x:x:x:x/.
12487
12488 setbuf.3
12489     Reuben Thomas / mtk
12490         Fix confused wording for return value of setvbuf().
12491         Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=488104.
12492     mtk
12493         Other minor rewordings.
12494
12495 shm_open.3
12496     mtk
12497         SEE ALSO: add shm_overview(7).
12498
12499 random.4
12500     mtk, after a note by Alain Portal
12501         Slight rewording to make life easier for non-native English
12502         speakers.
12503
12504 utmp.5
12505     mtk
12506         Add discussion of POSIX.1 utmpx specification.
12507         Provide a little more detail on fields of utmp structure.
12508         Added comments to macros for ut_type field.
12509         Correct the description of the ut_id field.
12510     mtk
12511         Consolidate duplicated information about ut_tv and ut_session
12512         on biarch platforms.
12513     mtk
12514         Move some text from CONFORMING TO to NOTES.
12515         Removed some crufty text.
12516         SEE ALSO: add login(3), logout(3), logwtmp(3).
12517         UT_LINESIZE is 32 (not 12).
12518     mtk
12519         SEE ALSO: add getutmp(3)
12520
12521 man-pages.7
12522     mtk
12523         Enhanced the discussion of font conventions.
12524
12525 signal.7
12526     mtk
12527         Note that the delivery order of multiple pending standard
12528         signals is unspecified.
12529         SEE ALSO: Add sigwait(3).
12530
12531
12532 ==================== Changes in man-pages-3.03 ====================
12533
12534 Released: 2008-07-08, Konolfingen
12535
12536
12537 Contributors
12538 ------------
12539
12540 The following people contributed notes, ideas, or patches that have
12541 been incorporated in changes in this release:
12542
12543 Alain Portal <aportal@univ-montp2.fr>
12544 Andi Kleen <ak@muc.de>
12545 Hidetoshi Seto <seto.hidetoshi@jp.fujitsu.com>
12546 Li Zefan <lizf@cn.fujitsu.com>
12547 Paul Jackson <pj@sgi.com>
12548 Sam Varshavchik <mrsam@courier-mta.com>
12549
12550 Apologies if I missed anyone!
12551
12552
12553 New and rewritten pages
12554 -----------------------
12555
12556 getcpu.2
12557     Andi Kleen, with some text and edits by mtk
12558         Documents the getcpu(2) system call, introduced in Linux 2.6.19.
12559
12560 sched_getcpu.3
12561     mtk
12562         Documents sched_getcpu(3), a wrapper for getcpu(2), provided
12563         since glibc 2.6.
12564
12565 cpuset.7
12566     Paul Jackson, with review and editing by mtk, and comments by
12567     Hidetoshi Seto and Li Zefan
12568         A description of the cpuset file system, the mechanism introduced
12569         kernel 2.6.12 for confining processes to designated processors
12570         and nodes.  (Becomes the fourth largest page in man-pages!)
12571
12572
12573 Newly documented interfaces in existing pages
12574 ---------------------------------------------
12575
12576 readdir.3
12577     mtk
12578         Add documentation of readdir_r().
12579
12580
12581 New links
12582 ---------
12583
12584 updwtmpx.3
12585     Alain Portal
12586         Link to updwtmp.3 (3.02 changelog wrongly said this had been done).
12587
12588 readdir_r.3
12589     mtk
12590         Link to readdir.3.
12591
12592
12593 Global changes
12594 --------------
12595
12596 get_mempolicy.2
12597 mbind.2
12598 sched_setaffinity.2
12599 set_mempolicy.2
12600     mtk
12601         SEE ALSO: Add getcpu(2).
12602
12603 accept.2
12604 close.2
12605 connect.2
12606 dup.2
12607 epoll_wait.2
12608 fcntl.2
12609 flock.2
12610 futex.2
12611 msgop.2
12612 poll.2
12613 read.2
12614 recv.2
12615 select.2
12616 semop.2
12617 send.2
12618 sigwaitinfo.2
12619 spu_run.2
12620 wait.2
12621 write.2
12622 aio_suspend.3
12623 mq_receive.3
12624 mq_send.3
12625 scanf.3
12626 sem_wait.3
12627 usleep.3
12628 inotify.7
12629     mtk
12630         ERRORS: Added reference to signal(7) in discussion of EINTR.
12631
12632 Various pages
12633     mtk
12634         Wrapped very long source lines.
12635
12636
12637 Changes to individual pages
12638 ---------------------------
12639
12640 accept.2
12641     mtk
12642         Small wording change.
12643
12644 io_getevents.2
12645     mtk
12646         ERRORS: Add EINTR error.
12647
12648 open.2
12649     mtk
12650         ERRORS: Add EINTR error.
12651
12652 sigaction.2
12653     mtk
12654         Note circumstances in which each SA_* flag is meaningful.
12655     mtk
12656         Describe POSIX specification, and Linux semantics for
12657         SA_NOCLDWAIT when establishing a handler for SIGCHLD.
12658     mtk
12659         Add pointer under SA_RESTART to new text in signal(7)
12660         describing system call restarting.
12661     mtk
12662         Other minor edits.
12663
12664 truncate.2
12665     mtk
12666         ERRORS: Added EINTR error.
12667         A few minor rewordings.
12668
12669 wait.2
12670     mtk
12671         Remove statement that WUNTRACED and WCONTINUED only have effect
12672         if SA_NOCLDSTOP has not been set for SIGCHLD.  That's not true.
12673
12674 errno.3
12675     mtk
12676         Add a pointer to signal(7) for further explanation of EINTR.
12677
12678 getgrouplist.3
12679     mtk
12680         SEE ALSO: Add passwd(5).
12681
12682 readdir.3
12683     mtk
12684         Remove <sys/types.h> from SYNOPSIS; POSIX.1-2001 does not
12685         require it.
12686         Some minor rewordings.
12687
12688 sleep.3
12689     mtk
12690         RETURN VALUE: explicitly mention interruption by signal handler.
12691         SEE ALSO: add signal(7).
12692
12693 usleep.3
12694     mtk
12695         POSIX.1-2001 also only documents EINVAL.
12696
12697 group.5
12698     mtk
12699         SEE ALSO: Add getgrent(3), getgrnam(3).
12700
12701 passwd.5
12702     mtk
12703         SEE ALSO: Add getpwent(3), getpwnam(3).
12704
12705 proc.5
12706     mtk
12707         Add pointer to description of /proc/PID/cpuset in cpuset(7).
12708
12709 signal.7
12710     mtk
12711         Add a section describing system call restarting, and noting
12712         which system calls are affected by SA_RESTART, and which
12713         system calls are never restarted.
12714     mtk
12715         Describe the aberrant Linux behavior whereby a stop signal
12716         plus SIGCONT can interrupt some system calls, even if no
12717         signal handler has been established, and note the system
12718         calls that behave this way.
12719     mtk
12720         Note a few more architectures on which signal numbers are valid.
12721         SEE ALSO: added a number of pages.
12722     mtk
12723         Update async-signal-safe function list for POSIX.1-2004 (which
12724         adds sockatmark()).
12725
12726
12727 ==================== Changes in man-pages-3.04 ====================
12728
12729 Released: 2008-07-15, Konolfingen
12730
12731
12732 Contributors
12733 ------------
12734
12735 The following people contributed notes, ideas, or patches that have
12736 been incorporated in changes in this release:
12737
12738 Alain Portal <aportal@univ-montp2.fr>
12739 Andrea Arcangeli <andrea@cpushare.com>
12740 Andreas Mohr <andi@lisas.de>
12741 Andrew Morgan <morgan@kernel.org>
12742 Erik Bosman <ejbosman@cs.vu.nl>
12743 John Brooks <aspecialj@gmail.com>
12744 Nikanth Karthikesan <knikanth@suse.de>
12745 Pavel Heimlich <tropikhajma@seznam.cz>
12746 Petr Gajdos <pgajdos@suse.cz>
12747 Sam Varshavchik <mrsam@courier-mta.com>
12748 Serge Hallyn <serue@us.ibm.com>
12749 Sripathi Kodi <sripathik@in.ibm.com>
12750 Vincent Lefevre <vincent@vinc17.org>
12751
12752 Apologies if I missed anyone!
12753
12754
12755 Web site
12756 --------
12757
12758 licenses.html
12759     mtk
12760         A page describing the preferred licenses for new pages that
12761         are contributed to man-pages.
12762
12763
12764 New and rewritten pages
12765 -----------------------
12766
12767 utimensat.2
12768     mtk
12769         New page documenting the utimensat() system call, new in 2.6.22,
12770         and futimens() library function.
12771
12772 end.3
12773     mtk
12774         Documents etext, edata, and end symbols.
12775
12776
12777 Newly documented interfaces in existing pages
12778 ---------------------------------------------
12779
12780 memchr.3
12781     mtk
12782         Add description of rawmemchr().
12783
12784 proc.5
12785     mtk
12786         Document /proc/config.gz (new in kernel 2.6).
12787     mtk, based on text from Documentation/vm/sysctl.txt
12788         Document /proc/sys/vm/oom_kill_allocating_task
12789         (new in Linux 2.6.24).
12790         Document /proc/sys/vm/oom_dump_tasks
12791         (new in Linux 2.6.25).
12792         Document /proc/sys/vm/panic_on_oom
12793         (new in Linux 2.6.18).
12794
12795
12796 New links
12797 ---------
12798
12799 edata.3
12800 etext.3
12801     mtk
12802         Links to end.3.
12803
12804 futimens.3
12805     mtk
12806         Link to new utimensat.2.
12807
12808 getdate_err.3
12809     mtk
12810         Link to getdate.3.
12811
12812 h_errno.3
12813     mtk
12814         Link to gethostbyname.3.
12815
12816 optarg.3
12817 opterr.3
12818 optind.3
12819 optopt.3
12820     mtk
12821         Links to getopt.3.
12822
12823 rawmemchr.3
12824     mtk
12825         Link to memchr.3.
12826
12827 sys_errlist.3
12828 sys_nerr.3
12829     mtk
12830         Links to perror.3.
12831
12832
12833 Global changes
12834 --------------
12835
12836 Various pages
12837     mtk
12838         s/parameter/argument/ when talking about the things given
12839         to a function call, for consistency with majority usage.
12840
12841 Various pages
12842     mtk
12843         s/UNIX/Unix/, when not used as part of a trademark,
12844         for consistency with majority usage in pages.
12845
12846 Various pages
12847     mtk, after a note from Alain Portal
12848         Put SEE ALSO entries into alphabetical order.
12849
12850 Various pages
12851     mtk
12852         Remove period at end of SEE ALSO list.
12853
12854 Various pages
12855     mtk, after a note by Alain Portal
12856         Even when the CONFORMING TO section is just a list of standards,
12857         they should be terminated by a period.
12858
12859 getpriority.2
12860 MB_LEN_MAX.3
12861 MB_CUR_MAX.3
12862 fwide.3
12863 mblen.3
12864 rtime.3
12865 st.4
12866 proc.5
12867 bootparam.7
12868 man-pages.7
12869 utf-8.7
12870 tcp.5
12871     mtk / Alain Portal
12872         Small wording fixes -- express <=, <, >=, > in words when in
12873         running text.
12874
12875 sched_setparam.2
12876 sched_setscheduler.2
12877 getgrent_r.3
12878 hash.3
12879     mtk
12880         Minor rewording w.r.t. use of the term "parameter".
12881
12882 Typographical or grammatical errors have been corrected in several
12883 other places.  (Many, many thanks to Alain Portal!)
12884
12885
12886 Changes to individual pages
12887 ---------------------------
12888
12889 capget.2
12890     Andrew Morgan
12891         Update in line with addition of file capabilities and
12892         64-bit capability sets in kernel 2.6.2[45].
12893
12894 clock_nanosleep.2
12895     mtk
12896         Add "Link with -lrt" to SYNOPSIS.
12897
12898 getrusage.2
12899     Sripathi Kodi
12900         Document RUSAGE_THREAD, new in 2.6.26.
12901     mtk
12902         Improve description of RUSAGE_CHILDREN.
12903         Add pointer to /proc/PID/stat in proc(5).
12904         Other minor clean-ups.
12905
12906 ioprio_set.2
12907     Nikanth Karthikesan
12908         Since Linux 2.6.25, CAP_SYS_ADMIN is longer required to set
12909         a low priority (IOPRIO_CLASS_IDLE).
12910
12911 mount.2
12912     mtk
12913         Since Linux 2.6.26, MS_RDONLY honors bind mounts.
12914
12915 openat.2
12916     mtk
12917         SEE ALSO: add utimensat(3).
12918
12919 prctl.2
12920     Serge Hallyn, with some edits/input from mtk
12921         Document PR_CAPBSET_READ and PR_CAPBSET_DROP.
12922     Erik Bosman
12923         Document PR_GET_TSC and PR_SET_TSC.
12924     mtk, reviewed by Andrea Arcangeli
12925         Document PR_SET_SECCOMP and PR_GET_SECCOMP.
12926     mtk
12927         PR_SET_KEEPCAPS and PR_GET_KEEPCAPS operate on a per-thread
12928         setting, not a per-process setting.
12929     mtk
12930         Clarify fork(2) details for PR_SET_PDEATHSIG.
12931     mtk
12932         Add description of PR_SET_SECUREBITS and PR_GET_SECUREBITS,
12933         as well as pointer to further info in capabilities(7).
12934     mtk
12935         PR_GET_ENDIAN returns endianness info in location pointed to by
12936         arg2 (not as function result, as was implied by previous text).
12937     mtk
12938         Expand description of PR_SET_NAME and PR_GET_NAME.
12939     mtk
12940         RETURN VALUE: bring up to date for various options.
12941     mtk
12942         Various improvements in ERRORS.
12943     mtk
12944         Note that PR_SET_TIMING setting of PR_TIMING_TIMESTAMP is not
12945         currently implemented.
12946     mtk
12947         Minor changes:
12948         * Clarify wording for PR_GET_UNALIGN, PR_GET_FPEMU, and
12949           PR_GET_FPEXC.
12950         * Some reformatting of kernel version information.
12951         * Reorder PR_GET_ENDIAN and PR_SET_ENDIAN entries.
12952
12953 readlinkat.2
12954     John Brooks / mtk
12955          Fix and reword erroneous RETURN VALUE text.
12956
12957 recv.2
12958     mtk
12959         Noted which flags appeared in Linux 2.2.
12960
12961 sched_setaffinity.2
12962     mtk, after a Fedora downstream patch
12963         Update type used for cpusetsize argument in SYNOPSIS.
12964
12965 select.2
12966     Andreas Mohr / mtk
12967         Clarify "zero timeout" case.
12968         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=490868.
12969
12970 send.2
12971     mtk
12972         Noted which flags appeared in Linux 2.2.
12973
12974 sigaction.2
12975     mtk
12976         Document si_overrun and si_tid fields of siginfo structure.
12977         Add some text for si_trapno field.
12978         The si_errno field is *generally* unused.
12979     mtk
12980         Put descriptions of SA_* constants in alphabetical order.
12981
12982 signal.2
12983     mtk
12984         Rewrote and expanded portability discussion.
12985         NOTES: Show the raw prototype of signal() (without use of
12986         sighandler_t).
12987
12988 signalfd.2
12989     mtk
12990         Modify description of ssi_trapno field.
12991
12992 swapon.2
12993     mtk
12994         Fix two version number typos for MAX_SWAPFILES discussion:
12995         s/2.6.10/2.4.10/
12996
12997 utime.2
12998     mtk
12999          SEE ALSO: add utimensat(2), futimens(3).
13000
13001 dl_iterate_phdr.3
13002     Alain Portal
13003         SEE ALSO: Add elf(5).
13004
13005 crypt.3
13006     mtk, after a Fedora downstream patch
13007         Describe additional encryption algorithms.
13008         See also: https://bugzilla.redhat.com/show_bug.cgi?id=428280.
13009
13010 errno.3
13011     mtk
13012         Small rewrites in DESCRIPTION.
13013
13014 exec.3
13015     mtk, after a note from Alain Portal
13016         Small rewording.
13017
13018 exp10.3
13019     Alain Portal
13020         SEE ALSO: Add log10(3).
13021
13022 exp2.3
13023     Alain Portal
13024         Add C99 to CONFORMING TO.
13025
13026 fgetgrent.3
13027     Alain Portal
13028         Add references to group(5).
13029     mtk
13030         Minor rewordings.
13031         SEE ALSO: add fopen(3).
13032
13033 fgetpwent.3
13034     Alain Portal
13035         Add reference to passwd(5).
13036     mtk
13037         Minor rewordings.
13038         SEE ALSO: add fopen(3).
13039
13040 frexp.3
13041     Alain Portal
13042         Add C99 to CONFORMING TO.
13043
13044 futimes.3
13045     mtk
13046          SEE ALSO: remove futimesat(2); add utimensat(2).
13047
13048 getopt.3
13049     mtk
13050         Add details on initial value of optind, and note that it can
13051         be reset (to 1) to restart scanning of an argument vector.
13052         Add a NOTES section describing the glibc-specific behavior
13053         when optind is reset to 0 (rather than 1).
13054         See http://groups.google.com/group/comp.unix.programmer/browse_thread/thread/be0d0b7a07a165fb
13055     mtk
13056         Note glibc extensions under CONFORMING TO.
13057
13058 getspnam.3
13059     mtk
13060         Improve comments on struct spwd.
13061
13062 getpw.3
13063     Alain Portal
13064         RETURN VALUE: note that errno is set on error.
13065     mtk
13066         Add EINVAL error.
13067
13068 insque.3
13069     mtk / Alain Portal
13070         Minor rewordings.
13071
13072 log.3
13073     Alain Portal
13074         Remove unnecessary sentence in ERRORS.
13075
13076 log10.3
13077     mtk
13078         SEE ALSO: Add exp10(3).
13079
13080 offsetof.3
13081     Alain Portal
13082         Small wording improvement.
13083
13084 pow.3
13085     Alain Portal
13086         Remove unnecessary sentence in ERRORS.
13087
13088 printf.3
13089     mtk / Alain Portal
13090         Many small formatting fixes.
13091
13092 proc.5
13093     mtk
13094         Remove redundant summary list of files in description of
13095         /proc/sys/kernel.
13096         Make kernel version for /proc/sys/kernel/panic_on_oops more precise.
13097         Make kernel version for /proc/sys/kernel/pid_max more precise.
13098         Add Documentation/sysctl/vm.txt to SEE ALSO.
13099         Other minor edits.
13100
13101 profil.3
13102     mtk / Alain Portal
13103          Small wording improvement.
13104
13105 rtime.3
13106     mtk, after a note by Alain Portal
13107         Clarify meaning of midnight on 1 Jan 1900/1970.
13108     mtk
13109         Remove netdate(1) and rdate(1) from SEE ALSO, since these pages
13110         don't seem to exist on Linux systems.
13111
13112 scanf.3
13113     Vincent Lefevre / mtk
13114         Clarify treatment of initial white space by %% conversion
13115         specification.
13116         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435648.
13117     mtk
13118         Many small formatting fixes.
13119
13120 stdin.3
13121     Alain Portal
13122         Rename CONSIDERATIONS section to NOTES, and relocate
13123         to appropriate place on page.
13124
13125 tmpfile.3
13126     mtk, after a note by Alain Portal
13127         Prepend "POSIX.1-2001 specifies that: " to the sentence stating
13128         that tmpfile() may write to stdout.  (AFAICS, glibc's tmpfile()
13129         does not do this.)
13130
13131 ttyname.3
13132     Alain Portal
13133         Remove unnecessary sentence in ERRORS.
13134
13135 wcsdup.3
13136     Alain Portal
13137         Make wording more precise: the memory allocated by wcsdup(3)
13138         *should* be freed with free(3).
13139
13140 wordexp.3
13141     Alain Portal / mtk
13142         Move example into proper EXAMPLE section.
13143
13144 tty_ioctl.4
13145     mtk / Petr Gajdos
13146         The features in the "Get and Set Window Size" subsection
13147         require the inclusion of <sys/ioctl.h>.
13148
13149 capabilities.7
13150     Serge Hallyn, plus a bit of work by mtk
13151         Document file capabilities, per-process capability bounding set,
13152         changed semantics for CAP_SETPCAP, and other changes in 2.6.2[45].
13153         Add CAP_MAC_ADMIN, CAP_MAC_OVERRIDE, CAP_SETFCAP.
13154         Various smaller fixes.
13155     mtk, plus review by Serge Hallyn and Andrew Morgan
13156         Add text detailing how CAP_SETPCAP (theoretically) permits -- on
13157         pre-2.6.25 kernels, and 2.6.25 and later kernels with file
13158         capabilities disabled -- a thread to change the capability sets
13159         of another thread.
13160         Add section describing rules for programmatically adjusting
13161         thread capability sets.
13162         Add some words describing purpose of inheritable set.
13163         Note existence of CONFIG_SECURITY_CAPABILITIES config option.
13164         Describe rationale for capability bounding set.
13165         Document securebits flags (new in 2.6.26).
13166         Remove obsolete BUGS section.
13167         SEE ALSO: Add getcap(8), setcap(8), and various libcap pages.
13168     mtk
13169         Add text noting that if we set the effective flag for one
13170         file capability, then we must also set the effective flag for all
13171         other capabilities where the permitted or inheritable bit is set.
13172     mtk
13173         Since Linux 2.6.25, CAP_SYS_ADMIN is no longer required for
13174         ioprio_set() to set IOPRIO_CLASS_IDLE class.
13175     mtk
13176         Reword discussion of CAP_LINUX_IMMUTABLE to be file-system neutral.
13177
13178 man-pages.7
13179    mtk
13180        A list of standards in the CONFORMING TO list should be
13181        terminated by a period.
13182        The list of pages in a SEE ALSO list should not be
13183        terminated by a period.
13184
13185 tcp.7
13186     mtk
13187         Correct a detail for sysctl_tcp_adv_win_scale.
13188         Formatting fixes.
13189
13190
13191 ==================== Changes in man-pages-3.05 ====================
13192
13193 Released: 2008-07-23, Konolfingen
13194
13195
13196 Contributors
13197 ------------
13198
13199 The following people contributed notes, ideas, or patches that have
13200 been incorporated in changes in this release:
13201
13202 Alain Portal <aportal@univ-montp2.fr>
13203 Andries Brouwer <Andries.Brouwer@cwi.nl>
13204 Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
13205 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13206 Franck Jousseaume <franck.jousseaume@gmail.com>
13207 Sam Varshavchik <mrsam@courier-mta.com>
13208 Uli Schlacter <psychon@znc.in>
13209
13210 Apologies if I missed anyone!
13211
13212
13213 New and rewritten pages
13214 -----------------------
13215
13216 matherr.3
13217     mtk, with review by Andries Brouwer
13218         A description of the SVID-specified mechanism for reporting
13219         math exceptions.
13220         See http://thread.gmane.org/gmane.linux.man/266.
13221
13222 math_error.7
13223     mtk, with review and suggested input from Andries Brouwer
13224         A description of how math functions report errors.
13225         See http://thread.gmane.org/gmane.linux.man/249.
13226
13227
13228 Global changes
13229 --------------
13230
13231 Various pages
13232     mtk
13233         s/floating point/floating-point/ when used attributively.
13234
13235 Various pages
13236     mtk
13237         For consistency with majority usage:
13238         s/plus infinity/positive infinity/
13239         s/minus infinity/negative infinity/
13240
13241 Typographical or grammatical errors have been corrected in several
13242 other places.
13243
13244
13245 Changes to individual pages
13246 ---------------------------
13247
13248 brk.2
13249     mtk
13250         SEE ALSO: add end(3).
13251
13252 open.2
13253     Brian M. Carlson / mtk
13254         Remove ambiguity in description of support for O_EXCL on NFS.
13255         As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=491791.
13256
13257 prctl.2
13258     mtk
13259         Place options in some semblance of alphabetical order.
13260         (No content or formatting changes were made.)
13261
13262 cerf.3
13263     mtk
13264         Bump version number: these functions are still missing in
13265         glibc 2.8.
13266
13267 fenv.3
13268     mtk
13269         SEE ALSO: Add math_error(7).
13270
13271 INFINITY.3
13272     mtk
13273         SEE ALSO: Add math_error(7).
13274
13275 nan.3
13276     mtk
13277         Remove unneeded "Compile with" piece in SYNOPSIS.
13278         SEE ALSO: Add math_error(7).
13279
13280 rpc.3
13281     mtk / Franck Jousseaume
13282         Fix errors introduced into a few prototypes when converting
13283         function declarations to use modern C prototypes in man-pages-2.75.
13284
13285 ipv6.7
13286     mtk, after a report from Uli Schlacter
13287         Document the IPV6_V6ONLY flag.
13288
13289
13290 ==================== Changes in man-pages-3.06 ====================
13291
13292 Released: 2008-08-05, Konolfingen
13293
13294
13295 Contributors
13296 ------------
13297
13298 The following people contributed notes, ideas, or patches that have
13299 been incorporated in changes in this release:
13300
13301 Andreas Jaeger <aj@novell.com>
13302 Andries Brouwer <Andries.Brouwer@cwi.nl>
13303 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13304 Gernot Tenchio <g.tenchio@telco-tech.de>
13305 Sam Varshavchik <mrsam@courier-mta.com>
13306 Tolga Dalman <tdalman@project-psi.org>
13307
13308 Apologies if I missed anyone!
13309
13310
13311 New and rewritten pages
13312 -----------------------
13313
13314 erfc.3
13315     mtk
13316         Created after removing the erfc() material from erf.3.
13317         Documents the complementary error function.
13318
13319 y0.3
13320     mtk
13321         Created after removing the y*() material from j0.3.
13322         Documents the Bessel functions of the second kind.
13323         Included ERRORS section; noted that an exception is not
13324         raised on underflow, see also
13325         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6806;
13326         and errno is not set on overflow, see also
13327         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808;
13328         Included BUGS section noting that errno is incorrectly
13329         set for pole error; see also
13330         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6807.
13331
13332 scalbln.3
13333     mtk
13334         Created after removing the scalbln*() and scalbn*() material
13335         from scalb.3.  Documents scalbln() and scalbn() functions.
13336         Included ERRORS section; noted that errno is not set; see
13337         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803.
13338
13339
13340 New and changed links
13341 ---------------------
13342
13343 erfcf.3
13344 erfcl.3
13345     mtk
13346         Changed these links to point to new erfc.3 page.
13347
13348 scalblnf.3
13349 scalblnl.3
13350 scalbn.3
13351 scalbnf.3
13352 scalbnl.3
13353     mtk
13354         Changed these links to point to new scalbln.3 page.
13355
13356 y0f.3
13357 y0l.3
13358 y1.3
13359 y1f.3
13360 y1l.3
13361 yn.3
13362 ynf.3
13363 ynl.3
13364     mtk
13365         Changed these links to point to new y0.3 page.
13366
13367
13368 Global changes
13369 --------------
13370
13371 Various pages
13372     mtk
13373         s/floating point/floating-point/ when used attributively.
13374
13375 Typographical or grammatical errors have been corrected in several
13376 other places.
13377
13378
13379 Changes to individual pages
13380 ---------------------------
13381
13382 crypt.3
13383     mtk
13384         Tweak discuss text describing support for Blowfish.
13385
13386 ctime.3
13387     mtk / Gernot Tenchio
13388         Added some words to make clear that the string returned by
13389         ctime() and asctime() is null-terminated.
13390
13391 math_error.7
13392     Sam Varshavchik
13393         Reverse order of SYNOPSIS and NAME sections.
13394     mtk
13395         NOTES: Summarize the state of glibc support for exceptions
13396         and errno for error reporting.
13397
13398
13399 Changes to individual pages (math functions)
13400 --------------------------------------------
13401
13402 Almost all of the changes in this release relate to math man pages.
13403 Very many changes were made to the math pages, including:
13404
13405 * Fixed feature test macros (FTMs).  Often, the FTM requirements
13406   for the "float" and "long double" versions of a math function are
13407   different from the requirements for the "double" version.  Each math
13408   page now shows the correct FTM requirements for all three versions
13409   of the function(s) it describes.  This may have required either
13410   a change to the existing FTM text (if the requirements for the
13411   "double" function were already described), or the addition of an FTM
13412   description to a SYNOPSIS where one was not previously present
13413   (typically because the "double" version of the function does not
13414   require any FTMs to be defined).
13415 * CONFORMING TO: in many cases, POSIX.1-2001 was not mentioned.
13416   Where a function is specified in POSIX.1-2001, this is now noted.
13417   Also, statements about what other standards a function conforms to
13418   were generally clarified.  (The wording about which functions conformed
13419   to C99 was previously often done as an add on sentence; now it is made
13420   part of the first sentence of the CONFORMING TO section, along with
13421   POSIX.1-2001.)
13422 * RETURN VALUE: in many cases, pages lacked descriptions of the return
13423   value when the function arguments are special values such as +0, -0,
13424   NaN (not-a-number), +infinity, -infinity, etc.  This has been fixed.
13425   I carried out tests on glibc 2.8 to ensure that all of these
13426   functions match the RETURN VALUE descriptions (and the POSIX.1-2001
13427   requirements).
13428 * ERRORS: many pages lacked a clear (or indeed any) description of
13429   how errno is set on error and what exception is raised for each error.
13430   This has been fixed.  The ERRORS sections are now generally headed up
13431   as per the POSIX.1 way of doing things, describing Pole / Range /
13432   Domain errors, as applicable.
13433   I carried out tests on glibc 2.8 to ensure that all of these
13434   functions match the ERRORS descriptions.  Deviations from POSIX.1-2001
13435   requirements have been filed as glibc bug reports, and noted in the
13436   man pages.  (The pages now describe the situation for ERRORS as at glibc
13437   2.8; I may eventually try and extend the text with descriptions of
13438   changes in older versions of glibc.)
13439   NOTE: one point that has not been covered in any page is the
13440   circumstances that generate inexact (FE_INEXACT) exceptions.
13441   (The details for these exceptions are not specified in POSIX.1-2001,
13442   and I haven't gone looking for the standards that describe the details.)
13443
13444 acos.3
13445     mtk
13446         SYNOPSIS: Added feature test macro requirements.
13447         RETURN VALUE: Added details for special argument cases.
13448         Rewrote ERRORS section.
13449         Updated CONFORMING TO.
13450
13451 acosh.3
13452     mtk
13453         SYNOPSIS: Fixed feature test macro requirements.
13454         Added RETURN VALUE section.
13455         Rewrote ERRORS section.
13456         Updated CONFORMING TO.
13457
13458 asin.3
13459     mtk
13460         SYNOPSIS: Added feature test macro requirements.
13461         RETURN VALUE: Added details for special argument cases.
13462         Rewrote ERRORS section.
13463         Updated CONFORMING TO.
13464
13465 asinh.3
13466     mtk
13467         SYNOPSIS: Added feature test macro requirements.
13468         DESCRIPTION: Some rewording.
13469         RETURN VALUE: Added details for special argument cases.
13470         Added (null) ERRORS section.
13471         Updated CONFORMING TO.
13472
13473 atan.3
13474     mtk
13475         SYNOPSIS: Added feature test macro requirements.
13476         DESCRIPTION: Some rewording.
13477         RETURN VALUE: Added details for special argument cases.
13478         Added (null) ERRORS section.
13479         Updated CONFORMING TO.
13480
13481 atan2.3
13482     mtk
13483         SYNOPSIS: Added feature test macro requirements.
13484         DESCRIPTION: Some rewording.
13485         RETURN VALUE: Added details for special argument cases.
13486         Added (null) ERRORS section.
13487         Updated CONFORMING TO.
13488
13489 atanh.3
13490     mtk
13491         SYNOPSIS: Fixed feature test macro requirements.
13492         Added RETURN VALUE section.
13493         Rewrote ERRORS section.
13494         Updated CONFORMING TO.
13495         Added BUGS section noting that pole error sets errno to EDOM,
13496         when it should be ERANGE instead; see also
13497         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6759.
13498
13499 cbrt.3
13500     mtk
13501         SYNOPSIS: Fixed feature test macro requirements.
13502         Added RETURN VALUE section.
13503         Added (null) ERRORS section.
13504         Updated CONFORMING TO.
13505
13506 ceil.3
13507     mtk
13508         SYNOPSIS: Added feature test macro requirements.
13509         DESCRIPTION: Enhanced.
13510         RETURN VALUE: Added details for special argument cases.
13511         Rewrote ERRORS section.
13512         Updated CONFORMING TO.
13513         NOTES: Added some details.
13514
13515 copysign.3
13516     mtk
13517         Added RETURN VALUE section.
13518         Updated CONFORMING TO.
13519
13520 cos.3
13521     mtk
13522         SYNOPSIS: Added feature test macro requirements.
13523         Rewrote RETURN VALUE section.
13524         Added ERRORS section; noted errno is not set:
13525         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780.
13526         Updated CONFORMING TO.
13527
13528 cosh.3
13529     mtk
13530         SYNOPSIS: Added feature test macro requirements.
13531         Added RETURN VALUE section.
13532         Added ERRORS section.
13533         Updated CONFORMING TO.
13534
13535 erf.3
13536     mtk
13537         Removed the erfc() material (there is now a new erfc page).
13538         Reason: the functions are logically separate; also their
13539         return values differ, and it would have been confusing
13540         to document them on the same page.
13541         SYNOPSIS: Fixed feature test macro requirements.
13542         Added RETURN VALUE section.
13543         Added ERRORS section; noted that errno is not set; see
13544         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785.
13545         Updated CONFORMING TO.
13546
13547 exp.3
13548     mtk
13549         SYNOPSIS: Added feature test macro requirements.
13550         Added RETURN VALUE section.
13551         Added ERRORS section; noted that errno is not set; see
13552         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6786.
13553         Updated CONFORMING TO.
13554
13555 exp10.3
13556     mtk
13557         SYNOPSIS: Added feature test macro requirements.
13558         Added RETURN VALUE section.
13559         Added ERRORS section; noted that errno is not set for underflow;
13560         see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787.
13561
13562 exp2.3
13563     mtk
13564         Added RETURN VALUE and ERRORS sections.
13565         Updated CONFORMING TO.
13566
13567 expm1.3
13568     mtk
13569         SYNOPSIS: Fixed feature test macro requirements.
13570         Added RETURN VALUE section.
13571         Added ERRORS section; noted that errno is not set for overflow;
13572         see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788.
13573         Updated CONFORMING TO.
13574         Added BUGS section, describing bogus underflow exception for -large,
13575         see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6778;
13576         and describing bogus invalid exception for certain +large,
13577         see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6814.
13578
13579 fabs.3
13580     mtk
13581         SYNOPSIS: Added feature test macro requirements.
13582         Added RETURN VALUE section.
13583         Updated CONFORMING TO.
13584
13585 fdim.3
13586     mtk
13587         SYNOPSIS: Added feature test macro requirements.
13588         DESCRIPTION: Some rewording.
13589         Added RETURN VALUE section.
13590         Added ERRORS section; noted that errno is not set; see
13591         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6796.
13592         Updated CONFORMING TO.
13593
13594 fenv.3
13595     mtk
13596         Make style of writing exception names consistent with other
13597         pages and POSIX.1-2001.
13598         Updated CONFORMING TO.
13599
13600 finite.3
13601     mtk
13602         SYNOPSIS: Fixed feature test macro requirements.
13603
13604 floor.3
13605     mtk
13606         SYNOPSIS: Added feature test macro requirements.
13607         DESCRIPTION: Enhanced.
13608         RETURN VALUE: Added details for special argument cases.
13609         Rewrote ERRORS section.
13610         Updated CONFORMING TO.
13611
13612 fma.3
13613     mtk
13614         SYNOPSIS: Added feature test macro requirements.
13615         DESCRIPTION: Some rewording.
13616         Added RETURN VALUE section.
13617         Added ERRORS section; noted that errno is not set; see
13618         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801.
13619         Updated CONFORMING TO.
13620
13621 fmax.3
13622 fmin.3
13623     mtk
13624         NAME: Make description clearer
13625         SYNOPSIS: Added feature test macro requirements.
13626         SYNOPSIS: Remove unneeded "Compile with" piece.
13627         CONFORMING TO: Added POSIX.1-2001.
13628         Added RETURN VALUE and ERRORS sections.
13629
13630 fmod.3
13631     mtk
13632         SYNOPSIS: Added feature test macro requirements.
13633         RETURN VALUE: Added details for special argument cases.
13634         Rewrote ERRORS section; noted that errno is not always set; see
13635         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
13636         Updated CONFORMING TO.
13637
13638 fpclassify.3
13639     mtk
13640         Minor wording changes.
13641         CONFORMING TO: Added POSIX.1-2001.
13642         SEE ALSO: Add signbit(3).
13643
13644 frexp.3
13645     mtk
13646         SYNOPSIS: Added feature test macro requirements.
13647         Added details to RETURN VALUE section.
13648         Added (null) ERRORS section.
13649         CONFORMING TO: Added POSIX.1-2001.
13650
13651 gamma.3
13652     mtk
13653         SYNOPSIS: Fixed feature test macro requirements.
13654         Added (null) RETURN VALUE section referring to tgamma(3).
13655         Added (null) ERRORS section referring to tgamma(3).
13656         CONFORMING TO: Rewrote.
13657
13658 hypot.3
13659     mtk
13660         SYNOPSIS: Fixed feature test macro requirements.
13661         DESCRIPTION: note that calculation is done without causing
13662         undue overflow or underflow.
13663         Added RETURN VALUE section.
13664         Added ERRORS section; noted that errno is not always set; see
13665         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6795.
13666         Updated CONFORMING TO.
13667
13668 ilogb.3
13669     mtk
13670         SYNOPSIS: Added feature test macro requirements.
13671         Rewrote RETURN VALUE section.
13672         Rewrote ERRORS section; noted that errno is not set, and in some
13673         cases an exception is not raised; see also
13674         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6794.
13675         CONFORMING TO: Added POSIX.1-2001.
13676
13677 isgreater.3
13678     mtk
13679         NAME: Make description clearer
13680         Improve the description of isunordered().
13681         Added RETURN VALUE and ERRORS sections.
13682         Formatting fixes.
13683         A few wording improvements.
13684
13685 j0.3
13686     mtk
13687         Removed material for the y*() functions to a separate y0.3 page.
13688         Reason: the return values and errors/exceptions differ, and it
13689         would have been confusing to document them on the same page.
13690         Added RETURN VALUE section.
13691         Added ERRORS section; noted that errno is not set; see
13692         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6805.
13693
13694 ldexp.3
13695     mtk
13696         SYNOPSIS: Added feature test macro requirements.
13697         Added RETURN VALUE and ERRORS sections.
13698         Updated CONFORMING TO.
13699
13700 lgamma.3
13701     mtk
13702         Note that these functions are deprecated.
13703         SYNOPSIS: Fixed feature test macro requirements.
13704         Added RETURN VALUE and ERRORS sections referring to lgamma(3).
13705         Added BUGS section noting that pole error sets errno to EDOM,
13706         when it should be ERANGE instead; see also
13707         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6777.
13708
13709 log.3
13710     mtk
13711         SYNOPSIS: Added feature test macro requirements.
13712         Added RETURN VALUE section.
13713         Rewrote ERRORS section.
13714         Updated CONFORMING TO.
13715
13716 log10.3
13717     mtk
13718         SYNOPSIS: Added feature test macro requirements.
13719         Added RETURN VALUE section.
13720         Rewrote ERRORS section.
13721         Updated CONFORMING TO.
13722
13723 log1p.3
13724     mtk
13725         SYNOPSIS: Fixed feature test macro requirements.
13726         Added RETURN VALUE section.
13727         Added ERRORS section; noted that errno is not set; see
13728         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6792.
13729         Updated CONFORMING TO.
13730
13731 log2.3
13732     mtk
13733         Added RETURN VALUE section.
13734         Rewrote ERRORS section.
13735         Updated CONFORMING TO.
13736
13737 logb.3
13738     mtk
13739         SYNOPSIS: Fixed feature test macro requirements.
13740         DESCRIPTION: added a little detail; some rewordings.
13741         RETURN VALUE: Added details for special argument cases.
13742         Rewrote ERRORS section; noted that errno is not set; see
13743         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6793.
13744         CONFORMING TO: Added POSIX.1-2001.
13745
13746 lrint.3
13747     mtk
13748         DESCRIPTION: some rewording.
13749         RETURN VALUE: Added details for special argument cases.
13750         Added ERRORS section; noted that errno is not set; see
13751         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6798.
13752         CONFORMING TO: Added POSIX.1-2001.
13753
13754 lround.3
13755     mtk
13756         RETURN VALUE: Added details for special argument cases.
13757         Rewrote ERRORS section; noted that errno is not set; see
13758         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6797.
13759         CONFORMING TO: Added POSIX.1-2001.
13760
13761 modf.3
13762     mtk
13763         SYNOPSIS: Added feature test macro requirements.
13764         RETURN VALUE: Added details for special argument cases.
13765         Added (null) ERRORS section.
13766         CONFORMING TO: Added POSIX.1-2001.
13767
13768 nan.3
13769     mtk
13770         Small wording changes.
13771         CONFORMING TO: Added POSIX.1-2001.
13772
13773 nextafter.3
13774     mtk
13775         SYNOPSIS: Fixed feature test macro requirements.
13776         RETURN VALUE: Added details for special argument cases.
13777         Added ERRORS section; noted that errno is not set; see
13778         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6799.
13779         CONFORMING TO: Added POSIX.1-2001.
13780
13781 pow.3
13782     mtk
13783         SYNOPSIS: Added feature test macro requirements.
13784         Added RETURN VALUE section.
13785         Rewrote ERRORS section.
13786         Updated CONFORMING TO.
13787         Added BUGS section noting that pole error sets errno to EDOM,
13788         when it should be ERANGE instead; see also
13789         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776.
13790
13791 remainder.3
13792     mtk
13793         SYNOPSIS: Fixed feature test macro requirements.
13794         DESCRIPTION: added some details.
13795         RETURN VALUE: Added details for special argument cases.
13796         Rewrote ERRORS section; noted that errno is not always set; see
13797         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
13798         Updated CONFORMING TO.
13799         Added BUGS section noting that remainder(nan(""), 0)
13800         wrongly causes a domain error; see
13801         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6779
13802
13803 remquo.3
13804    mtk
13805         Added RETURN VALUE section.
13806         Added ERRORS section; noted that errno is not set; see
13807         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801.
13808         Updated CONFORMING TO.
13809
13810 fmax.3
13811 fmin.3
13812     mtk
13813         NAME: Make description clearer
13814         SYNOPSIS: Added feature test macro requirements.
13815         SYNOPSIS: Remove unneeded "Compile with" piece.
13816         CONFORMING TO: Added POSIX.1-2001.
13817         Added RETURN VALUE and ERRORS sections.
13818
13819 fmod.3
13820     mtk
13821         SYNOPSIS: Added feature test macro requirements.
13822         RETURN VALUE: Added details for special argument cases.
13823         Rewrote ERRORS section; noted that errno is not always set; see
13824         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
13825         Updated CONFORMING TO.
13826
13827 fpclassify.3
13828         CONFORMING TO: Added POSIX.1-2001.
13829
13830 rint.3
13831     mtk
13832         SYNOPSIS: Fixed feature test macro requirements.
13833         DESCRIPTION: added some details.
13834         RETURN VALUE: Added details for special argument cases.
13835         ERRORS: no errors can occur (previous text was misleading).
13836         CONFORMING TO: Added POSIX.1-2001.
13837         NOTES: point out that lrint() may be preferred in some cases.
13838
13839 round.3
13840     mtk
13841         DESCRIPTION: added some details.
13842         RETURN VALUE: Added details for special argument cases.
13843         ERRORS: no errors can occur (previous text was misleading).
13844         CONFORMING TO: Added POSIX.1-2001.
13845         NOTES: point out that lround() may be preferred in some cases.
13846
13847 scalb.3
13848     mtk
13849         Removed the scalbn() and scalbln() material to a separate
13850         scalbln.3 page.  Reason: scalb() is obsolete; also the
13851         exception/error conditions differ somewhat, so that it
13852         would have been confusing to document them on the same page.
13853         SYNOPSIS: Fixed feature test macro requirements.
13854         DESCRIPTION: some rewrites and added details.
13855         Added RETURN VALUE section.
13856         Added ERRORS section; noted that errno is not set; see
13857         also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803
13858         and http://sources.redhat.com/bugzilla/show_bug.cgi?id=6804.
13859         CONFORMING TO: Rewrote.
13860
13861 signbit.3
13862     mtk
13863         SYNOPSIS: Added feature test macro requirements.
13864         SYNOPSIS: Remove unneeded "Compile with" piece.
13865         Added RETURN VALUE section.
13866         Added (null) ERRORS section.
13867         CONFORMING TO: Added POSIX.1-2001.
13868
13869 sin.3
13870     mtk
13871         SYNOPSIS: Added feature test macro requirements.
13872         Added RETURN VALUE section.
13873         Added ERRORS section; noted errno is not set:
13874         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781.
13875         Updated CONFORMING TO.
13876
13877 sincos.3
13878     mtk
13879         DESCRIPTION: Added details for special argument cases.
13880         Added (null) RETURN VALUE section.
13881         Added ERRORS section.
13882
13883 sinh.3
13884     mtk
13885         SYNOPSIS: Added feature test macro requirements.
13886         Added RETURN VALUE section.
13887         Added ERRORS section.
13888         Updated CONFORMING TO.
13889
13890 sqrt.3
13891     mtk
13892         SYNOPSIS: Added feature test macro requirements.
13893         Added RETURN VALUE section.
13894         Rewrote ERRORS section.
13895         Updated CONFORMING TO.
13896
13897 tan.3
13898     mtk
13899         SYNOPSIS: Added feature test macro requirements.
13900         Added RETURN VALUE section.
13901         Added ERRORS section.
13902         Added ERRORS section; noted errno is not set:
13903         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782.
13904         Updated CONFORMING TO.
13905
13906 tanh.3
13907     mtk
13908         SYNOPSIS: Added feature test macro requirements.
13909         Added RETURN VALUE section.
13910         Added (null) ERRORS section.
13911         Updated CONFORMING TO.
13912
13913 tgamma.3
13914     mtk
13915         Added RETURN VALUE section.
13916         Rewrote ERRORS section; noted that errno is not set /
13917         incorrectly set in some cases; see also
13918         http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809
13919         and http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810.
13920         CONFORMING TO: Added POSIX.1-2001.
13921         Added NOTES section to hold text explaining origin of tgamma().
13922
13923 trunc.3
13924     mtk
13925         RETURN VALUE: small rewording.
13926         CONFORMING TO: Added POSIX.1-2001.
13927         Added NOTES section explaining that result may be too large
13928         to store in an integer type.
13929
13930
13931 ==================== Changes in man-pages-3.07 ====================
13932
13933 Released: 2008-08-12, Konolfingen
13934
13935
13936 Contributors
13937 ------------
13938
13939 The following people contributed notes, ideas, or patches that have
13940 been incorporated in changes in this release:
13941
13942 Alain Portal <aportal@univ-montp2.fr>
13943 Andries Brouwer <Andries.Brouwer@cwi.nl>
13944 Christoph Lameter <cl@linux-foundation.org>
13945 Cliff Wickman <cpw@sgi.com>
13946 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13947 Filippo Santovito <filippo.santovito@email.it>
13948 Gerrit Renker <gerrit@erg.abdn.ac.uk>
13949 Heikki Orsila <shd@modeemi.cs.tut.fi>
13950 Khalil GHORBAL <khalil.ghorbal@cea.fr>
13951 Lee Schermerhorn <lee.schermerhorn@hp.com>
13952 Maxin John <maxin.john@gmail.com>
13953 Reuben Thomas <rrt@sc3d.org>
13954 Samuel Thibault <samuel.thibault@ens-lyon.org>
13955 Sam Varshavchik <mrsam@courier-mta.com>
13956 Soh Kam Yung <sohkamyung@gmail.com>
13957 Stephane Chazelas <stephane_chazelas@yahoo.fr>
13958 Pavel Heimlich <tropikhajma@seznam.cz>
13959 Reuben Thomas <rrt@sc3d.org>
13960
13961 Apologies if I missed anyone!
13962
13963
13964 New and rewritten pages
13965 -----------------------
13966
13967 move_pages.2
13968     Christoph Lameter, various edits and improvements by mtk
13969         Documentation of the move_pages() system call.
13970         This page was formerly part of the numactl package, but really
13971         belongs in man-pages (since it describes a kernel interface).
13972
13973 clock_getcpuclockid.3
13974     mtk
13975         New page documenting the clock_getcpuclockid() library function,
13976         available since glibc 2.2.
13977
13978 udplite.7
13979     Gerrit Renker
13980         Document the Linux implementation of the UDP-Lite protocol,
13981         new in Linux 2.6.20.
13982
13983
13984 Newly documented interfaces in existing pages
13985 ---------------------------------------------
13986
13987 proc.5
13988     Christoph Lameter, minor edits and improvements by mtk
13989         Documentation of the /proc/PID/numa_maps file.
13990         This material was formerly the numa_maps.5 page in the numactl
13991         package, but really belongs in man-pages (since it describes
13992         a kernel interface).
13993
13994
13995 Global changes
13996 --------------
13997
13998 nanosleep.2
13999 inet_ntop.3
14000 inet_pton.3
14001 scanf.3
14002 initrd.4
14003     mtk
14004         Fix mis-ordered (.SH) sections.
14005
14006 connect.2
14007 socket.2
14008 rtnetlink.3
14009 arp.7
14010 ddp.7
14011 ip.7
14012 ipv6.7
14013 netlink.7
14014 packet.7
14015 raw.7
14016 rtnetlink.7
14017 socket.7
14018 tcp.7
14019 udp.7
14020 unix.7
14021 x25.7
14022     mtk
14023         s/PF_/AF_/ for socket family constants.  Reasons: the AF_ and
14024         PF_ constants have always had the same values; there never has
14025         been a protocol family that had more than one address family,
14026         and POSIX.1-2001 only specifies the AF_* constants.
14027
14028 Typographical or grammatical errors have been corrected in several
14029 other places.
14030
14031
14032 Changes to individual pages
14033 ---------------------------
14034
14035 execve.2
14036     mtk
14037         The floating-point environment is reset to the default
14038         during an execve().
14039
14040 get_mempolicy.2
14041     Lee Schermerhorn
14042         Misc cleanup of get_mempolicy(2):
14043         + mention that any mode flags will be saved with mode.
14044           I don't bother to document mode flags here because we
14045           already have a pointer to set_mempolicy(2) for more info
14046           on memory policy.  mode flags are discussed there.
14047         + remove some old, obsolete [IMO] NOTES and 'roff comments.
14048     Lee Schermerhorn
14049         Update the get_mempolicy(2) man page to add in the description of
14050         the MPOL_F_MEMS_ALLOWED flag, added in 2.6.23.
14051     mtk
14052         Document additional EINVAL error that occurs is MPOL_F_MEMS_ALLOWED
14053         is specified with either MPOL_F_ADDR or MPOL_F_NODE.
14054
14055 getitimer.2
14056     mtk
14057         CONFORMING TO: POSIX.1-2008 marks getitimer() and setitimer()
14058         obsolete.
14059
14060 mbind.2
14061     Lee Schermerhorn
14062         Fix error conditions, now that the kernel silently ignores
14063         nodes outside the task's cpuset, as long as one valid node
14064         remains.
14065
14066         Now that cpuset man page exists, we can refer to it.  Remove
14067         stale comment regarding lack thereof.
14068     Lee Schermerhorn
14069         Add brief discussion of mode flags.
14070     Lee Schermerhorn
14071         Attempt to clarify discussion of MPOL_DEFAULT.
14072     mtk
14073         Fix URI reference for libnuma.
14074
14075 mprotect.2
14076     mtk / Maxin John
14077         Remove EFAULT from errors.  Under ENOMEM error, note that
14078         EFAULT was the error produced in some cases for kernels before
14079         2.4.19.
14080
14081 msgctl.2
14082     mtk, after a note from Filippo Santovito
14083         In the ipc_perm structure definition, some fields were
14084         incorrectly named: s/key/__key/ and s/seq/__seq/.
14085
14086 set_mempolicy.2
14087     Lee Schermerhorn
14088         Fix up the error return for nodemask containing nodes disallowed by
14089         the process' current cpuset.  Disallowed nodes are now silently ignored,
14090         as long as the nodemask contains at least one node that is on-line,
14091         allowed by the process' cpuset and has memory.
14092
14093         Now that we have a cpuset man page, we can refer to cpusets directly
14094         in the man page text.
14095
14096     Lee Schermerhorn
14097         Another attempt to rationalize description of MPOL_DEFAULT.
14098
14099         Since ~2.6.25, the system default memory policy is "local allocation".
14100         MPOL_DEFAULT itself is a request to remove any non-default policy and
14101         "fall back" to the surrounding context.  Try to say that without delving
14102         into implementation details.
14103
14104     Lee Schermerhorn
14105         Add discussion of mempolicy mode flags to set_mempolicy(2).
14106         This adds another reason for EINVAL.
14107
14108 setpgid.2
14109     mtk
14110         CONFORMING TO: POSIX.1-2008 marks setpgrp() obsolete.
14111
14112 semctl.2
14113     mtk, after a note from Filippo Santovito
14114         In the ipc_perm structure definition, some fields were
14115         incorrectly named: s/key/__key/ and s/seq/__seq/.
14116
14117 shmctl.2
14118     Filippo Santovito / mtk
14119         In the ipc_perm structure definition, some fields were
14120         incorrectly named: s/key/__key/ and s/seq/__seq/.
14121
14122 utime.2
14123     mtk
14124         CONFORMING TO: POSIX.1-2008 marks utime() obsolete.
14125         CONFORMING TO: POSIX.1-2008 removes the POSIX.1-2001 LEGACY
14126         marking of utimes(), so mention of this point has been
14127         removed from the page.
14128
14129 vfork.2
14130     mtk
14131         CONFORMING TO: POSIX.1-2008 removes the specification of vfork().
14132
14133 atan2.3
14134     Fabian Kreutz
14135         SEE ALSO Add carg(3).
14136
14137 bcmp.3
14138     mtk
14139         CONFORMING TO: POSIX.1-2008 removes the specification of bcmp().
14140
14141 bsd_signal.3
14142     mtk
14143         CONFORMING TO: POSIX.1-2008 removes the specification ofcw
14144         bsd_signal().
14145
14146 bzero.3
14147     mtk
14148         CONFORMING TO: POSIX.1-2008 removes the specification of bzero().
14149
14150 cexp2.3
14151     mtk
14152         AVAILABILITY: These functions are still not in glibc
14153         as at version 2.8.
14154
14155 clock_getres.3
14156     mtk
14157          SEE ALSO: Add clock_getcpuclockid(3).
14158
14159 clog2.3
14160     mtk
14161         AVAILABILITY: These functions are still not in glibc
14162         as at version 2.8.
14163
14164 ctime.3
14165     mtk
14166         POSIX.1-2008 marks asctime(), asctime_r(), ctime(), and ctime_r()
14167         as obsolete.
14168
14169 dprintf.3
14170     mtk
14171        CONFORMING TO: These functions are nowadays in POSIX.1-2008.
14172
14173 ecvt.3
14174     mtk
14175         CONFORMING TO: POSIX.1-2008 removes the specifications of
14176         ecvt() and fcvt().
14177
14178 ftime.3
14179     mtk
14180         CONFORMING TO: POSIX.1-2008 removes the specification of ftime().
14181
14182 ftw.3
14183     mtk
14184         CONFORMING TO: POSIX.1-2008 marks ftw() as obsolete.
14185
14186 gcvt.3
14187     mtk
14188         CONFORMING TO: POSIX.1-2008 removes the specification of gcvt().
14189
14190 getcwd.3
14191     Reuben Thomas / mtk
14192         Clarify description of getcwd() for buf==NULL case;
14193         CONFORMING TO: According to POSIX.1, the behavior of getcwd()
14194         is unspecified for the buf==NULL case.
14195     mtk
14196         Add an introductory paragraph giving an overview of what these
14197         functions do.
14198         Fix error in description of getwd(): it does not truncate the
14199         pathname; rather, it gives an error if the pathname exceeds
14200         PATH_MAX bytes.
14201         Rewrote RETURN VALUE section.
14202         Add EINVAL ENAMETOOLONG errors for getwd().
14203         Various other clarifications and wording fixes.
14204         CONFORMING TO: POSIX.1-2001 does not define any errors for
14205         getwd().
14206         CONFORMING TO: POSIX.1-2008 removes the specification of getwd().
14207
14208 gethostbyname.3
14209     mtk
14210         CONFORMING TO: POSIX.1-2008 removes the specifications of
14211         gethostbyname(), gethostbyaddr(), and h_errno.
14212
14213 gets.3
14214     mtk
14215         CONFORMING TO: POSIX.1-2008 removes the specification of gets().
14216
14217 iconv.3
14218 iconv_close.3
14219 iconv_open.3
14220     mtk
14221         VERSIONS: These functions are available in glibc since version 2.1.
14222
14223 index.3
14224     mtk
14225         CONFORMING TO: POSIX.1-2008 removes the specifications of
14226         index() and rindex().
14227
14228 isalpha.3
14229     mtk
14230         CONFORMING TO: POSIX.1-2008 marks isalpha() as obsolete.
14231
14232 makecontext.3
14233     mtk
14234         CONFORMING TO: POSIX.1-2008 removes the specifications of
14235         makecontext() and swapcontext().
14236
14237 memchr.3
14238     mtk
14239         VERSIONS: memrchr() since glibc 2.2; rawmemchr() since glibc 2.1.
14240
14241 mempcpy.3
14242     mtk
14243         VERSIONS: mempcpy() since glibc 2.1.
14244
14245 mktemp.3
14246     mtk
14247         CONFORMING TO: POSIX.1-2008 removes the specification of mktemp().
14248
14249 opendir.3
14250     mtk
14251         CONFORMING TO: POSIX.1-2008 specifies fdopendir().
14252
14253 rand.3
14254     mtk
14255         CONFORMING TO: POSIX.1-2008 marks rand_r() as obsolete.
14256
14257 siginterrupt.3
14258     mtk
14259         CONFORMING TO: POSIX.1-2008 marks siginterrupt() as obsolete.
14260
14261 sigset.3
14262     mtk
14263         CONFORMING TO: POSIX.1-2008 marks sighold(), sigignore(),
14264         sigpause(), sigrelse(), and sigset() as obsolete.
14265
14266 strchr.3
14267     mtk
14268         VERSIONS: strchrnul() since glibc 2.1.1.
14269
14270 tempnam.3
14271     mtk
14272         CONFORMING TO: POSIX.1-2008 marks tempnam() as obsolete.
14273
14274 tmpnam.3
14275     mtk
14276         CONFORMING TO: POSIX.1-2008 marks tmpnam() as obsolete.
14277
14278 toascii.3
14279     mtk
14280         CONFORMING TO: POSIX.1-2008 marks toascii() as obsolete.
14281
14282 ualarm.3
14283     mtk
14284         CONFORMING TO: POSIX.1-2008 removes the specification of ualarm().
14285
14286 ulimit.3
14287     mtk
14288         CONFORMING TO: POSIX.1-2008 marks ulimit() as obsolete.
14289
14290 usleep.3
14291     mtk
14292         CONFORMING TO: POSIX.1-2008 removes the specification of usleep().
14293
14294 standards.7
14295     mtk
14296         Updated details for POSIX.1-2008, and noted that if
14297         POSIX.1-2001 is listed in the CONFORMING TO section of a man
14298         page, then the reader can assume that the interface is also
14299         specified in POSIX.1-2008, unless otherwise noted.
14300
14301 time.7
14302     mtk
14303          SEE ALSO: Add clock_getcpuclockid(3).
14304
14305 udp.7
14306     mtk
14307         SEE ALSO: add udplite(7).
14308
14309
14310 Changes to individual pages (math functions)
14311 --------------------------------------------
14312
14313 Various changes here following on from the big update to the
14314 math pages in the previous release.  Test results going back
14315 glibc 2.3.2 (so far) allowed updates to various pages to note
14316 changes in historical behavior for error reporting by math
14317 functions.  Thanks to the following people for providing me
14318 with test results on various distributions and glibc versions:
14319 Alain Portal, Andries Brouwer, Fabian Kreutz, Heikki Orsila,
14320 Khalil GHORBAL, Pavel Heimlich, Reuben Thomas, Samuel Thibault,
14321 Soh Kam Yung, and Stephane Chazelas
14322
14323 cabs.3
14324 cacos.3
14325 cacosh.3
14326 carg.3
14327 casin.3
14328 casinh.3
14329 catan.3
14330 catanh.3
14331 ccos.3
14332 ccosh.3
14333 cexp.3
14334 cimag.3
14335 clog.3
14336 clog10.3
14337 conj.3
14338 cpow.3
14339 cproj.3
14340 creal.3
14341 csin.3
14342 csinh.3
14343 csqrt.3
14344 ctan.3
14345 ctanh.3
14346 exp10.3
14347 exp2.3
14348 fdim.3
14349 fenv.3
14350 fma.3
14351 fmax.3
14352 fmin.3
14353 log2.3
14354 lrint.3
14355 lround.3
14356 nan.3
14357 pow10.3
14358 remquo.3
14359 round.3
14360 scalbln.3
14361 sincos.3
14362 tgamma.3
14363 trunc.3
14364     mtk
14365         Added VERSIONS section noting that these functions first
14366         appeared in glibc in version 2.1.
14367
14368 cosh.3
14369     mtk
14370         BUGS: In glibc 2.3.4 and earlier, an FE_OVERFLOW exception is not
14371         raised when an overflow occurs.
14372
14373 fenv.3
14374     mtk / Fabian Kreuz
14375         Provide more detail in the description of rounding modes.
14376         Add text describing FLT_ROUNDS (formerly in fma.3).
14377         Add BUGS section pointing out the FLT_ROUNDS does not reflect
14378         changes by fesetround().
14379
14380 fma.3
14381     mtk
14382         Remove text about FLT_ROUNDS, replacing with a cross-reference
14383         to fenv(3).
14384
14385 fpclassify.3
14386     mtk
14387         CONFORMING TO: Note that the standards provide a weaker guarantee
14388         for the return value of isinf().
14389
14390 log.3
14391     mtk
14392         BUGS: In glibc 2.5 and earlier, log(nan("")) produces a bogus
14393         FE_INVALID exception.
14394
14395 lround.3
14396     mtk
14397         Add reference to fenv(3) for discussion of current rounding mode.
14398
14399 nextafter.3
14400     mtk
14401         BUGS: In glibc 2.5 and earlier these functions do not raise an
14402         FE_UNDERFLOW exception on underflow.
14403
14404 pow.3
14405     mtk
14406         BUGS: described buggy NaN return when x is negative and y is large.
14407         See also: http://sources.redhat.com/bugzilla/show_bug.cgi?id=3866.
14408         BUGS: Note the bogus FE_INVALID exception that occurred in glibc
14409         2.3.2 and earlier on overflow and underflow.
14410
14411 remainder.3
14412     mtk
14413         Add reference to fenv(3) for discussion of current rounding mode.
14414
14415 round.3
14416     mtk
14417         Add reference to fenv(3) for discussion of current rounding mode.
14418
14419 scalb.3
14420     mtk
14421         CONFORMING TO: POSIX.1-2008 removes the specification of scalb().
14422
14423 tgamma.3
14424     mtk
14425         BUGS: In glibc 2.3.3, tgamma(+-0) produced a domain error
14426         instead of a pole error.
14427
14428 y0.3
14429     mtk
14430         In glibc 2.3.2 and earlier, these functions do not raise an
14431         FE_INVALID exception for a domain error.
14432
14433 math_error.7
14434     mtk
14435         Rewrite introductory paragraph.
14436         Point out that a NaN is commonly returned by functions that report
14437         a domain error.
14438
14439
14440 ==================== Changes in man-pages-3.08 ====================
14441
14442 Released: 2008-08-27, Zurich
14443
14444
14445 Contributors
14446 ------------
14447
14448 The following people contributed notes, ideas, or patches that have
14449 been incorporated in changes in this release:
14450
14451 Gerrit Renker <gerrit@erg.abdn.ac.uk>
14452 Li Zefan <lizf@cn.fujitsu.com>
14453 Mike Bianchi <MBianchi@foveal.com>
14454 Sam Varshavchik <mrsam@courier-mta.com>
14455 Venkatesh Srinivas <me@acm.jhu.edu>
14456 Vijay Kumar <vijaykumar@bravegnu.org>
14457
14458 Apologies if I missed anyone!
14459
14460
14461 New and rewritten pages
14462 -----------------------
14463
14464 getnetent_r.3
14465     mtk
14466         Documents getnetent_r(), getnetbyname_r(),
14467         and getnetbyaddr_r(), the reentrant equivalents of
14468         getnetent(), getnetbyname(), and getnetbyaddr().
14469
14470 getprotoent_r.3
14471      mtk
14472         Documents getprotoent_r(), getprotobyname_r(), and
14473         getprotobynumber_r(), the reentrant equivalents of
14474         getprotoent(), getprotobyname(), and getprotobynumber().
14475
14476 getrpcent_r.3
14477      mtk
14478         Documents getrpcent_r(), getrpcbyname_r(), and
14479         getrpcbynumber_r(), the reentrant equivalents of
14480         getrpcent(), getrpcbyname(), and getrpcbynumber().
14481
14482 getservent_r.3
14483      mtk
14484         Documents getservent_r(), getservbyname_r(), and
14485         getservbyport_r(), the reentrant equivalents of
14486         getservent(), getservbyname(), and getservbyport().
14487
14488 numa.7
14489     mtk
14490         A new page giving overview details for the Linux NUMA interfaces.
14491         Incorporates some material from mbind.2, and the description
14492         of /proc/PID/numa_maps from proc.5.
14493
14494
14495 Newly documented interfaces in existing pages
14496 ---------------------------------------------
14497
14498 crypt.3
14499     mtk
14500         Add description of crypt_r().
14501
14502
14503 New and changed links
14504 ---------------------
14505
14506 crypt.3
14507     mtk
14508         New link to crypt.3.
14509
14510 getnetbyname_r.3
14511 getnetbyaddr_r.3
14512     mtk
14513         New links to new getnetent_r.3.
14514
14515 getprotobyname_r.3
14516 getprotobynumber_r.3
14517     mtk
14518         New links to new getprotoent_r.3.
14519
14520 getrpcbyname_r.3
14521 getrpcbynumber_r.3
14522     mtk
14523         New links to new getrpcent_r.3.
14524
14525 getservbyname_r.3
14526 getservbyport_r.3
14527     mtk
14528         New links to new getservent_r.3.
14529
14530 numa_maps.5
14531     mtk
14532         Link to new numa(7) page, which incorporates the
14533         /proc/PID/numa_maps description.
14534         As part of the numactl() package, the /proc/PID/numa_maps
14535         documentation was in a numa_maps.5 page; this link
14536         ensures that "man 5 numa_maps" still works.
14537         (Eventually, we may want to remove this link.)
14538
14539
14540 Global changes
14541 --------------
14542
14543 get_mempolicy.2
14544 mbind.2
14545 move_pages.2
14546 set_mempolicy.2
14547     mtk
14548         Add reference to numa(7) for information on library support.
14549         Added  a VERSIONS section.
14550         SEE ALSO: Add numa(7).
14551
14552 faccessat.2
14553 fchmodat.2
14554 fchownat.2
14555 fstatat.2
14556 mkdirat.2
14557 mknodat.2
14558 linkat.2
14559 openat.2
14560 readlinkat.2
14561 renameat.2
14562 symlinkat.2
14563 unlinkat.2
14564 mkfifoat.3
14565 psignal.3
14566 strsignal.3
14567     mtk
14568         These interfaces are specified in POSIX.1-2008.
14569
14570
14571 Changes to individual pages
14572 ---------------------------
14573
14574 eventfd.2
14575     Vijay Kumar
14576         When an eventfd overflows, select() indicates the file as both
14577         readable and writable (not as having an exceptional condition).
14578
14579 fcntl.2
14580     mtk
14581         F_DUPFD_CLOEXEC is specified in POSIX.1-2008.
14582
14583 getrlimit.2
14584     mtk
14585         NOTES: Add text mentioning the shell 'ulimit' (or 'limit')
14586         built-in command for setting resource limits.
14587
14588 gettimeofday.2
14589     mtk
14590         CONFORMING TO: POSIX.1-2008 marks gettimeofday() as obsolete.
14591
14592 link.2
14593     mtk
14594         Note kernel version where Linux stopped following symbolic
14595         links in 'oldpath'; see also http://lwn.net/Articles/294667.
14596         POSIX.1-2008 makes it implementation-dependent whether or not
14597         'oldpath' is dereferenced if it is a symbolic link.
14598         Add a reference to linkat(2) for an interface that allows
14599         precise control of the treatment of symbolic links.
14600
14601 mbind.2
14602     mtk
14603         Remove material on library support and numactl; that material
14604         is now in numactl.7.
14605
14606 mmap.2
14607     mtk
14608         Add kernel version numbers for MAP_32BIT.
14609         Add some details on MAP_32BIT (see http://lwn.net/Articles/294642).
14610
14611 move_pages.2
14612     mtk
14613         Added VERSIONS (from kernel 2.6.18) and CONFORMING TO sections.
14614
14615 open.2
14616     mtk
14617         O_CLOEXEC is specified in POSIX.1-2008.
14618
14619 socket.2
14620     mtk
14621         s/d/domain/ for name of argument.
14622         Add reference to socket(2) for further information on
14623         domain, type, and protocol arguments.
14624
14625 utimensat.2
14626     mtk
14627         CONFORMING TO: POSIX.1-2008 specifies utimensat() and futimens().
14628
14629 dirfd.3
14630     mtk
14631         CONFORMING TO: Add POSIX.1-2008; other minor changes.
14632
14633 exec.3
14634     mtk
14635         Small rewording: "s/returned/failed with/ [an error]".
14636
14637 fmemopen.3
14638     mtk
14639         Since glibc 2.7, it is possible to seek past the end of
14640         a stream created by open_memstream().  Add a BUGS section
14641         describing the bug in earlier glibc versions.
14642
14643 gethostbyname.3
14644     mtk
14645         Clarify exactly which functions are obsoleted by getnameinfo()
14646         and getaddrinfo().
14647
14648 getnetent.3
14649     mtk
14650         Rephrase description in terms of a database, rather than a file.
14651         Note that each of the get*() functions opens a connection to
14652         the database if necessary.
14653         The database connection is held open between get*() calls if
14654         'stayopen' is non-zero (not necessarily 1).
14655         s/zero terminated list/NULL-terminated list/
14656     mtk
14657         In glibc 2.2, the type of the 'net' argument for getnetbyaddr()
14658         changed from 'long' to 'uint32_t'.
14659     mtk
14660         Note that the gethostbyaddr() 'net' argument is in host byte order.
14661     mtk
14662         RETURN VALUE: emphasize that returned pointer points to a
14663         statically allocated structure.
14664         SEE ALSO: add getnetent_r.3.
14665
14666 getprotoent.3
14667     mtk
14668         Rephrase description in terms of a database, rather than a file.
14669         Note that each of the get*() functions opens a connection to
14670         the database if necessary.
14671         The database connection is held open between get*() calls if
14672         'stayopen' is non-zero (not necessarily 1).
14673         s/zero terminated list/NULL-terminated list/
14674     mtk
14675         RETURN VALUE: emphasize that returned pointer points to a
14676         statically allocated structure.
14677         SEE ALSO: add getprotoent_r.3.
14678
14679 getrpcent.3
14680     mtk
14681         s/rpc/RPC/.
14682         Rephrase description in terms of a database, rather than a file.
14683         Note that each of the get*() functions opens a connection to
14684         the database if necessary.
14685         s/zero terminated list/NULL-terminated list/
14686     mtk
14687         RETURN VALUE: emphasize that returned pointer points to a
14688         statically allocated structure.
14689         SEE ALSO: add getrpcent_r.3.
14690
14691 getservent.3
14692     mtk
14693         Rephrase description in terms of a database, rather than a file.
14694         Note that each of the get*() functions opens a connection to
14695         the database if necessary.
14696         The database connection is held open between get*() calls if
14697         'stayopen' is non-zero (not necessarily 1).
14698         s/zero terminated list/NULL-terminated list/
14699     mtk
14700         RETURN VALUE: emphasize that returned pointer points to a
14701         statically allocated structure.
14702         SEE ALSO: add getservent_r.3.
14703
14704 mkdtemp.3
14705     mtk
14706         CONFORMING TO: this function is specified in POSIX.1-2008.
14707
14708 mq_notify.3
14709     Venkatesh Srinivas
14710         s/sigev_notify_function/sigev_thread_function/
14711         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=494956.
14712
14713 realpath.3
14714     mtk
14715         Relocate text for resolved_path==NULL case to DESCRIPTION.
14716         POSIX.1-2001 leaves the resolved_path==NULL case as
14717         implementation-defined; POSIX.1-2008 specifies the behavior
14718         described in this man page.
14719
14720 sem_init.3
14721     mtk
14722         POSIX.1-2008 rectifies the POSIX.1-2001 omission, specifying
14723         that zero is returned by a successful sem_init() call.
14724
14725 core.5
14726     Mike Bianchi / mtk
14727         Make the page more helpful to non-programmers by referencing
14728         the documentation of the shell's 'ulimit' command in the
14729         discussion of RLIMIT_CORE and RLIMIT_FSIZE.
14730         SEE ALSO: Add bash(1).
14731     mtk
14732         Note that a core dump file can be used in a debugger.
14733
14734 proc.5
14735     mtk
14736         Remove /proc/PID/numa_maps material (it is now in numa(7)).
14737
14738 cpuset.7
14739     mtk
14740         SEE ALSO: Add numa(7).
14741
14742 inotify.7
14743     mtk / Li Zefan
14744          Explain bug that occurred in coalescing identical events in
14745          kernels before 2.6.25.
14746          (See commit 1c17d18e3775485bf1e0ce79575eb637a94494a2
14747          "A potential bug in inotify_user.c" in the 2.6.25 Changelog.)
14748
14749 pthreads.7
14750     mtk
14751         Update thread-safe functions list with changes in POSIX.1-2008.
14752         SEE ALSO: add proc(5).
14753
14754 signal.7
14755     mtk
14756         Update list of async-signal-safe functions for POSIX.1-2008.
14757
14758
14759 ==================== Changes in man-pages-3.09 ====================
14760
14761 Released: 2008-09-10, Munich
14762
14763
14764 Contributors
14765 ------------
14766
14767 The following people contributed notes, ideas, or patches that have
14768 been incorporated in changes in this release:
14769
14770 Bernd Eckenfels <be-mail2006@lina.inka.de>
14771 Bruno Haible <bruno@clisp.org>
14772 Carsten Emde <Carsten.Emde@osadl.org>
14773 Christopher Head <chead@telus.net>
14774 H. Peter Anvin <hpa@zytor.com>
14775 Jan Engelhardt <jengelh@medozas.de>
14776 Joe Korty <joe.korty@ccur.com>
14777 Marko Kreen <markokr@gmail.com>
14778 Martin (Joey) Schulze <joey@infodrom.org>
14779 Mats Wichmann <mats.d.wichmann@intel.com>
14780 Michael Schurter <michael@susens-schurter.com>
14781 Mike Bianchi <MBianchi@foveal.com>
14782 Mike Frysinger <vapier@gentoo.org>
14783 Sam Varshavchik <mrsam@courier-mta.com>
14784 Suka <sukadev@us.ibm.com>
14785 Timothy S. Nelson <wayland@wayland.id.au>
14786 Tolga Dalman <tdalman@project-psi.org>
14787 Török Edwin <edwintorok@gmail.com>
14788
14789 Apologies if I missed anyone!
14790
14791
14792 New and rewritten pages
14793 -----------------------
14794
14795 fopencookie.3
14796     mtk
14797         Document fopencookie(3), a library function that allows
14798         custom implementation of a stdio stream.
14799
14800 networks.5
14801     Martin (Joey) Schulze, with a few light edits by mtk
14802         Documents the /etc/networks file.
14803
14804
14805 Global changes
14806 --------------
14807
14808 Various pages
14809     mtk
14810         s/time zone/timezone/ for consistency across pages and
14811         with POSIX.1.
14812
14813 kill.2
14814 sigaction.2
14815 sigpending.2
14816 sigprocmask.2
14817 sigsuspend.2
14818 confstr.3
14819 ctermid.3
14820 ctime.3
14821 ferror.3
14822 flockfile.3
14823 fopen.3
14824 getaddrinfo.3
14825 getgrnam.3
14826 getnameinfo.3
14827 getopt.3
14828 getpwnam.3
14829 longjmp.3
14830 popen.3
14831 rand.3
14832 readdir.3
14833 setjmp.3
14834 sigsetops.3
14835 sigwait.3
14836 strtok.3
14837 tzset.3
14838 unlocked_stdio.3
14839     mtk
14840         Add/fix feature test macro requirements.
14841
14842
14843 Changes to individual pages
14844 ---------------------------
14845
14846 fcntl.2
14847     mtk, after a note by Mike Bianchi
14848         More clearly and consistently describe whether
14849         or not the third argument to fcntl() is required,
14850         and what its type should be.
14851     mtk
14852         Move description of negative l_len  from NOTES, integrating
14853         it into the discussion of file locking.
14854         Minor rewrites of the text on file locking.
14855
14856 getrusage.2
14857     Bernd Eckenfels
14858         SEE ALSO: Add clock(3), clock_gettime(3).
14859         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=353475
14860
14861 ioctl_list.2
14862     mtk
14863         Remove old sentence about where to send updates for this page.
14864         Add more detail on mount options that prevent updates to atime.
14865
14866 sched_setscheduler.2
14867     Carsten Emde
14868         Update kernel version numbers relating to real-time support.
14869
14870 stat.2
14871     H. Peter Anvin
14872         Note that lstat() will generally not trigger automounter
14873         action, whereas stat() will.
14874
14875 clock.3
14876     Bernd Eckenfels
14877         SEE ALSO: Add clock_gettime(3).
14878         See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=353475
14879
14880 clock_getres.3
14881     Tolga Dalman / mtk
14882         Add "Link with -lrt" to SYNOPSIS; remove now redundant
14883         sentence mentioning librt from NOTES.
14884
14885 getdate.3
14886     mtk
14887         Rewrite description of getdate_r() and integrate into main text
14888         (rather than describing in NOTES).
14889         Other parts rewritten for greater clarity.
14890         Make it clearer in the main text that glibc does not implement %Z;
14891         remove discussion of that point from NOTES.
14892         Added an example program.
14893
14894 hsearch.3
14895     mtk
14896         Noted that table size as specified by 'nel' is immutable.
14897         Described differences between hsearch() and hsearch_r().
14898         Added missing pieces to RETURN VALUE.
14899         Added a number of new entries under ERRORS.
14900         NOTES: added some basic advice on sizing the hash table;
14901         noted that when a table is destroyed, the caller is responsible
14902         for freeing the buffers pointed to by 'key' and 'data' fields.
14903         One of the BUGS was fixed in glibc 2.3.
14904         Rewrote and clarified various other pieces.
14905         Rename arguments for reentrant functions, using same name as
14906         glibc headers: s/ret/retval/; s/tab/htab/.
14907     mtk, after a suggestion by Timothy S. Nelson
14908         Integrate discussion of reentrant functions into main discussion
14909         (rather than as a short paragraph at the end).
14910
14911 iconv.3
14912     Bruno Haible
14913         Describe "shift sequence" input.
14914
14915 ptsname.3
14916     sukadev
14917         Fix return type of ptsname_r() in SYNOPSIS.
14918
14919 readdir.3
14920     H. Peter Anvin
14921         s/stat(2)/lstat(2)/ when discussing d_type (since we
14922         are talking about a case where we might be interested to
14923         whether the file itself is a symbolic link).
14924
14925 sigsetops.3
14926     Chris Head, signed-off-by: Mike Frysinger
14927         Fix typo: s/sigdelset/sigorset/
14928
14929 proc.5
14930     Mats Wichmann / mtk
14931         s/\[number]/[pid]/ in file names for /proc/PID files.
14932         And similar changes for task/[tid] sub-directories.
14933     mtk / Mats Wichmann
14934         In the description if /proc/[pid]/environ, remove reference to
14935         lilo(8)/grub(8) since there seems to be nothing in those pages
14936         that related to this /proc file.
14937     Michael Schurter / mtk
14938         Remove sentence wrongly saying that /proc/meminfo reports
14939         info in bytes;
14940         see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=462969
14941     mtk
14942         Note that /proc/meminfo reports system-wide memory usage
14943         statistics.
14944     Joe Korty
14945         Document new fields in /proc/interrupts that were added in
14946         Linux 2.6.24.
14947
14948 unix.7
14949     Marko Kreen
14950         Since glibc 2.8, _GNU_SOURCE must be defined in order to get
14951         the definition of the ucred structure from <sys/socket.h>.
14952
14953
14954 ==================== Changes in man-pages-3.10 ====================
14955
14956 Released: 2008-09-23, Munich
14957
14958
14959 Contributors
14960 ------------
14961
14962 The following people contributed notes, ideas, or patches that have
14963 been incorporated in changes in this release:
14964
14965 André Goddard Rosa <andre.goddard@gmail.com>
14966 George Spelvin <linux@horizon.com>
14967 Pavel Heimlich <tropikhajma@seznam.cz>
14968 Sam Varshavchik <mrsam@courier-mta.com>
14969 John Reiser <jreiser@bitwagon.com>
14970
14971 Apologies if I missed anyone!
14972
14973
14974 Global changes
14975 --------------
14976
14977 closedir.3
14978 dirfd.3
14979 readdir.3
14980 rewinddir.3
14981 scandir.3
14982 seekdir.3
14983 telldir.3
14984     mtk
14985         Fix 'dir' argument name: should be 'dirp'.
14986         POSIX.1-2008 and glibc call this argument 'dirp' (consistent
14987         with the fact that it is a *pointer* to a DIR structure).
14988
14989
14990 Changes to individual pages
14991 ---------------------------
14992
14993 clone.2
14994     mtk, after a comment by John Reiser
14995         Clarify text describing getpid() caching bug for clone() wrapper.
14996         See also:
14997         http://sourceware.org/bugzilla/show_bug.cgi?id=6910
14998         https://bugzilla.redhat.com/show_bug.cgi?id=417521
14999
15000 getpid.2
15001     mtk, after a comment by John Reiser
15002         Describe getpid()'s PID caching and its consequences.
15003
15004 timerfd_create.2
15005     Sam Varshavchik
15006         s/it_interval/it_value/ when talking about TIMERFD_ABSTIME.
15007
15008 closedir.3
15009     George Spelvin
15010         Clarify closedir()'s treatment of underlying file descriptor.
15011
15012 tsearch.3
15013     André Goddard Rosa
15014         Fix memory leak in example program.
15015         Add use of tdestroy to example program.
15016     mtk
15017         Add "#define _GNU_SOURCE" to example program.
15018
15019 protocols.5
15020     mtk, after a note from Pavel Heimlich
15021         Remove SEE ALSO references to nonexistent Guides to Yellow Pages
15022
15023 services.5
15024     mtk
15025         Remove some out-of-date bugs.
15026     mtk, after a note from Pavel Heimlich
15027         Remove SEE ALSO references to nonexistent Guides to Yellow Pages
15028         and Bind/Hesiod docs.
15029     mtk
15030         Remove crufty text about use of comma instead of slash to separate
15031         port and protocol.
15032
15033
15034 ==================== Changes in man-pages-3.11 ====================
15035
15036 Released: 2008-10-07, Munich
15037
15038
15039 Contributors
15040 ------------
15041
15042 The following people contributed notes, ideas, or patches that have
15043 been incorporated in changes in this release:
15044
15045 André Goddard Rosa <andre.goddard@gmail.com>
15046 Eugene V. Lyubimkin <jackyf.devel@gmail.com>
15047 Gergely Soos <sogerc1@gmail.com>
15048 Kirill A. Shutemov <kirill@shutemov.name>
15049 Marko Kreen <markokr@gmail.com>
15050 Maxin B. John <maxin.john@ap.sony.com>
15051 Maxin John <maxin.john@gmail.com>
15052 Michael Kerrisk <mtk.manpages@gmail.com>
15053 Nicolas François <nicolas.francois@centraliens.net>
15054 Pavel Heimlich <tropikhajma@seznam.cz>
15055 Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
15056 Sam Varshavchik <mrsam@courier-mta.com>
15057
15058 Apologies if I missed anyone!
15059
15060
15061 New and rewritten pages
15062 -----------------------
15063
15064 umount.2
15065     Michael Kerrisk
15066         Create a new page for umount() and umount2() by extracting
15067         existing material from mount.2 page.
15068
15069
15070 New and changed links
15071 ---------------------
15072
15073 umount2.2
15074     Michael Kerrisk
15075         Change link to point to new umount.2
15076             The umount2() material migrated from mount.2 to umount.2
15077
15078
15079 Changes to individual pages
15080 ---------------------------
15081
15082 execve.2
15083     Michael Kerrisk
15084         _SC_ARG_MAX is no longer necessarily constant
15085             POSIX.1-2001 says that the values returned by sysconf()
15086             are constant for the life of the process.
15087             But the fact that, since Linux 2.6.23, ARG_MAX is settable
15088             via RLIMIT_STACK means _SC_ARG_MAX is no longer constant,
15089             since it can change at each execve().
15090     Michael Kerrisk
15091         Linux now imposes a floor on the ARG_MAX limit
15092             Starting with Linux 2.6.23, the ARG_MAX limit became
15093             settable via (1/4 of) RLIMIT_STACK.  This broke ABI
15094             compatibility if RLIMIT_STACK was set such that ARG_MAX
15095             was < 32 pages.  Document the fact that since 2.6.25
15096             Linux imposes a floor on ARG_MAX, so that the old limit
15097             of 32 pages is guaranteed.
15098
15099             For some background on the changes to ARG_MAX in
15100             kernels 2.6.23 and 2.6.25, see:
15101                 http://sourceware.org/bugzilla/show_bug.cgi?id=5786
15102                 http://bugzilla.kernel.org/show_bug.cgi?id=10095
15103                 http://thread.gmane.org/gmane.linux.kernel/646709/focus=648101,
15104                 checked into 2.6.25 as
15105                 commit a64e715fc74b1a7dcc5944f848acc38b2c4d4ee2.
15106
15107             Also some reordering/rewording of the discussion of ARG_MAX.
15108
15109 fallocate.2
15110     Michael Kerrisk
15111         Note lack of glibc wrapper; caller must use syscall(2)
15112             Glibc doesn't (and quite probably won't) include a
15113             wrapper for this system call.  Therefore, point out that
15114             potential callers will need to use syscall(2), and rewrite
15115             the RETURN VALUE text to show things as they would be if
15116             syscall() is used.
15117
15118     Michael Kerrisk
15119         Refer reader to posix_fallocate(3) for portable interface
15120             Add a para to start of page that points out that this is the
15121             low-level, Linux-specific API, and point the reader to
15122             posix_fallocate(3) for the portable API.
15123
15124 getdents.2
15125 readdir.3
15126     Michael Kerrisk
15127         d_type is currently only supported on ext[234]
15128             As at kernel 2.6.27, only ext[234] support d_type.
15129             On other file systems, d_type is always set to DT_UNKNOWN (0).
15130
15131 getdents.2
15132     Michael Kerrisk
15133         Add an example program
15134     Michael Kerrisk
15135         comment out linux_dirent fields with varying location
15136             The location of the fields after d_name varies according to
15137             the size of d_name.  We can't properly declare them in C;
15138             therefore, put those fields inside a comment.
15139     Michael Kerrisk
15140         The DT_* constants are defined in <dirent.h>
15141     Michael Kerrisk
15142         Remove header files from SYNOPSIS
15143             None of the header files provides what is needed.
15144             Calls are made via syscall(2).
15145     Michael Kerrisk
15146         The programmer must define the linux_dirent structure
15147             Point out that this structure is not defined in glibc headers.
15148     Michael Kerrisk
15149         s/dirent/linux_dirent/
15150             The structure isn't currently defined in glibc headers,
15151             and the kernel name of the structure is 'linux_dirent' (as
15152             was already used in some, but not all, places in this page).
15153
15154 getrlimit.2
15155     Michael Kerrisk
15156         Reword/relocate discussion of BSD's historical RLIMIT_OFILE
15157             The old sentence sat on its own in an odd place, and anyway the
15158             modern BSDs use the name RLIMIT_NOFILE.
15159     Michael Kerrisk
15160         Refer to execve(2) for RLIMIT_STACK's effect on ARG_MAX
15161             Refer the reader to new text in execve(2) that describes how
15162             (since Linux 2.6.23) RLIMIT_STACK determines the value of ARG_MAX.
15163
15164 getrusage.2
15165     Michael Kerrisk
15166         Rusage measures are preserved across execve(2)
15167
15168 mlock.2
15169     Maxin John
15170         Add EAGAIN error.
15171
15172 move_pages.2
15173     Nicolas François
15174         Make a detail of EPERM error more precise
15175
15176 mount.2
15177     Michael Kerrisk
15178         Add description of per-process namespaces
15179             Describe per-process namespaces, including discussion
15180             of clone() and unshare CLONE_NEWNS, and /proc/PID/mounts.
15181     Michael Kerrisk
15182         List a few other file systems that we may see in /proc/filesystems
15183             Add some modern file systems to that list (xfs, jfs, ext3,
15184             reiserfs).
15185     Michael Kerrisk
15186         Document MS_SILENT (and MS_VERBOSE)
15187
15188 mount.2
15189 umount.2
15190     Michael Kerrisk
15191         Split umount*() out into a separate page
15192             The length of this page means that it's becoming difficult
15193             to parse which info is specific to mount() versus
15194             umount()/umount2(), so split the umount material out into
15195             its own page.
15196
15197 pause.2
15198     Michael Kerrisk
15199         Remove mention of words "library function"
15200             This really is a system call.
15201
15202 readdir.2
15203     Michael Kerrisk
15204         The programmer must declare the old_linux_dirent structure
15205             Glibc does not provide a definition of this structure.
15206     Michael Kerrisk
15207         s/dirent/old_linux_dirent/
15208             Nowadays, this is the name of the structure in the
15209             kernel sources.
15210     Michael Kerrisk
15211         Remove words "which may change"
15212             These words are slightly bogus: although the interface
15213             is obsolete, for ABI-compatibility reasons, the kernel folk
15214             should never be changing this interface.
15215     Michael Kerrisk
15216         Remove header files from SYNOPSIS
15217             glibc doesn't provide any support for readdir(2),
15218             so remove these header files (which otherwise suggest
15219             that glibc does provide the required pieces).
15220
15221 recv.2
15222     Nicolas François
15223         Move kernel version number to first mention to MSG_ERRQUEUE.
15224
15225 semop.2
15226     Kirill A. Shutemov
15227         Fix typo in example
15228             (The '&' before sop in the semop() call is unneeded.)
15229
15230 send.2
15231     Michael Kerrisk
15232         Make kernel version for MSG_CONFIRM more precise
15233             s/2.3+ only/Since Linux 2.3.15/
15234
15235 sigaction.2
15236     Michael Kerrisk
15237         Refer reader to signal(7) for an overview of signals
15238         Explain semantics of signal disposition during fork() and execve()
15239         Refer to signal(7) for more details on signal mask.
15240
15241 sigaltstack.2
15242     Michael Kerrisk
15243         Explain inheritance of alternate signal stack across fork(2)
15244
15245 sigwaitinfo.2
15246     Michael Kerrisk
15247         Distinguish per-thread and process-wide signals
15248             A sentence clarifying that pending signal set is union of
15249             per-thread and process-wide pending signal sets.
15250
15251     Michael Kerrisk
15252         These interfaces have per-thread semantics
15253             The page was previously fuzzy about whether the these interfaces
15254             have process-wide or per-thread semantics.  (E.g., now the
15255             page states that the calling *thread* (not process) is suspended
15256             until the signal is delivered.)
15257
15258 sigpending.2
15259     Michael Kerrisk
15260         Explain effect of fork() and execve() for pending signal set
15261     Michael Kerrisk
15262         Explain how thread's pending signal set is defined
15263             The pending set is the union of per-thread pending signals
15264             and process-wide pending signals.
15265
15266 sigprocmask.2
15267     Michael Kerrisk
15268         Explain effects of fork() and execve() for signal mask
15269
15270 splice.2
15271     Michael Kerrisk
15272         Note that SPLICE_F_MOVE is a no-op since kernel 2.6.21
15273
15274 syscall.2
15275     Michael Kerrisk
15276         Add more detail about wrapper functions
15277             Add a few more details about work generally done by wrapper
15278             functions.  Note that syscall(2) performs the same steps.
15279
15280 tkill.2
15281     Michael Kerrisk
15282         EINVAL error can also occur for invalid TGID
15283             The EINVAL error on an invalid TGID for tgkill() was
15284             not documented; this change documents it.
15285
15286 utimensat.2
15287     Michael Kerrisk
15288         POSIX.1-2008 revision will likely affect FTMs for futimens()
15289             Make it clear that the POSIX.1 revision that is likely
15290             to affect the feature test macro requirements for futimens()
15291             is POSIX.1-2008.
15292     Nicolas François
15293         Make various wordings a little more precise.
15294             The times argument point to *an array of* structures, and the
15295             man-page should say that consistently.
15296
15297 wait4.2
15298     Michael Kerrisk
15299         wait3() is a library function layered on wait4().
15300             On Linux wait3() is a library function implemented on top
15301             of wait4().  (Knowing this is useful when using strace(2),
15302             for example.)
15303
15304 atan2.3
15305     Nicolas François
15306         Fix error in description of range or return value
15307             In recent changes to the man page, mtk accidentally changed
15308             the description of the return value range to -pi/2..pi/2;
15309             the correct range is -pi..pi.
15310
15311 cmsg.3
15312     Nicolas François
15313         Add parentheses after macro names.
15314
15315 ctime.3
15316     Michael Kerrisk
15317         Clarify mktime()'s use of tm_isdst
15318             Describe use of tm_isdst for input to mktime();
15319             explain how mktime() modifies this field.
15320             (This field is left unchanged in case of error.)
15321
15322             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=500178
15323     Michael Kerrisk
15324         Clarify wording for ctime_r() and asctime_r() to indicate that
15325         the buffer must be at least 26 *bytes*.
15326     Michael Kerrisk
15327         Minor rewording of mktime() description.
15328
15329 floor.3
15330     Nicolas François
15331         floor.3: Fix error in description: s/smallest/largest/
15332
15333 hsearch.3
15334     André Goddard Rosa
15335         Call hdestroy() after using hash table created by hcreate(),
15336         for the sake of completeness
15337
15338 mq_getattr.3
15339     Michael Kerrisk
15340         mq_getattr() and mq_setattr() are layered on mq_getsetattr(2)
15341             mq_getattr() and mq_setattr() are library functions layered on
15342             top of the mq_getsetattr(2) system call.
15343             (This is useful info for users of strace(1).)
15344
15345 mq_receive.3
15346     Michael Kerrisk
15347         mq_send() is a library function layered on mq_timedreceive() syscall
15348              This info is useful for users of strace(1).
15349
15350 mq_send.3
15351     Michael Kerrisk
15352         mq_send() is a library function layered on mq_timedsend() syscall
15353              This info is useful for users of strace(1).
15354
15355 nextafter.3
15356     Nicolas François
15357         Make description more precise: s/next/largest/
15358
15359 readdir.3
15360     Michael Kerrisk
15361         SEE ALSO: add getdents(2)
15362              Because readdir() is implemented on top of getdents(2).
15363
15364 realpath.3
15365     Michael Kerrisk
15366         Clarify that returned pathname is NULL terminated
15367             Also clarify that null-byte is included in PATH_MAX limit.
15368
15369 proc.5
15370     Michael Kerrisk
15371         Rewrite and simplify description of /proc/mounts
15372             Most of the relevant discussion is now under /proc/PID/mounts;
15373             all that needs to be here is a mention of the pre-2.4.19
15374             system-wide namespace situation, and a reference to the
15375             discussion under /proc/PID/mounts.
15376     Michael Kerrisk
15377         Add description of /proc/PID/mounts
15378             Largely cribbed from existing /proc/mounts discussion, which is
15379             about to be rewritten.
15380
15381 mq_overview.7
15382     Michael Kerrisk
15383         Add mq_notify() to list of lib. functions and syscalls in MQ API
15384
15385 signal.7
15386     Michael Kerrisk
15387         Improve description in NAME section
15388         Add mention of sigaltstack(2).
15389         Describe syscalls that synchronously wait for a signal,
15390         Give overview of syscalls that block until a signal is caught
15391         Add overview of interfaces for sending signals.
15392
15393     Michael Kerrisk
15394         Describe semantics w.r.t. fork() and execve()
15395             Include text describing semantics of fork() and execve() for
15396             signal dispositions, signal mask, and pending signal set.
15397
15398
15399 ==================== Changes in man-pages-3.12 ====================
15400
15401 Released: 2008-10-29, Bucaramanga
15402
15403
15404 Contributors
15405 ------------
15406
15407 The following people contributed notes, ideas, or patches that have
15408 been incorporated in changes in this release:
15409
15410 Bert Wesarg <bert.wesarg@googlemail.com>
15411 Christian Grigis <glove@earthling.net>
15412 Christoph Hellwig <hch@infradead.org>
15413 Didier <did447@gmail.com>
15414 Halesh S <halesh.s@india.com>
15415 J.H.M. Dassen (Ray) <fsmla@xinara.org>
15416 Jason Spiro <jasonspiro4@gmail.com>
15417 Lefteris Dimitroulakis <edimitro@tee.gr>
15418 Michael B. Trausch <mike@trausch.us>
15419 Pierre Cazenave <pwc101@noc.soton.ac.uk>
15420 Stefan Puiu <stefan.puiu@gmail.com>
15421
15422 Apologies if I missed anyone!
15423
15424
15425 New and rewritten pages
15426 -----------------------
15427
15428 pthread_attr_init.3
15429     Michael Kerrisk
15430         New page for pthread_attr_init(3) and pthread_attr_destroy(3)
15431
15432 pthread_attr_setdetachstate.3
15433     Michael Kerrisk
15434         New page for pthread_attr_setdetachstate(3) and
15435         pthread_attr_getdetachstate(3)
15436
15437 pthread_attr_setguardsize.3
15438     Michael Kerrisk
15439         New page for pthread_attr_setguardsize(3) and
15440         pthread_attr_getguardsize(3)
15441
15442 pthread_attr_setscope.3
15443     Michael Kerrisk
15444         New page for pthread_attr_setscope(3) and pthread_attr_getscope(3)
15445
15446 pthread_attr_setstack.3
15447     Michael Kerrisk
15448         New page for pthread_attr_setstack(3) and pthread_attr_getstack(3)
15449
15450 pthread_attr_setstackaddr.3
15451     Michael Kerrisk
15452         New page for pthread_attr_setstackaddr(3) and
15453         pthread_attr_getstackaddr(3)
15454
15455 pthread_attr_setstacksize.3
15456     Michael Kerrisk
15457         New page for pthread_attr_setstacksize(3) and
15458         pthread_attr_getstacksize(3)
15459
15460 pthread_create.3
15461     Michael Kerrisk
15462         New page describing pthread_create(3)
15463
15464 pthread_detach.3
15465     Michael Kerrisk
15466         New page for pthread_detach(3)
15467
15468 pthread_equal.3
15469     Michael Kerrisk
15470         New page for pthread_equal(3)
15471
15472 pthread_exit.3
15473     Michael Kerrisk
15474         New page describing pthread_exit(3)
15475
15476 pthread_getattr_np.3
15477     Michael Kerrisk
15478         New page for pthread_getattr_np(3)
15479
15480 pthread_join.3
15481     Michael Kerrisk
15482         New page for pthread_join(3)
15483
15484 pthread_self.3
15485     Michael Kerrisk
15486         New page for pthread_self(3)
15487
15488 pthread_tryjoin_np.3
15489     Michael Kerrisk
15490         New page for pthread_tryjoin_np(3) and pthread_timedjoin_np(3)
15491
15492
15493 Newly documented interfaces in existing pages
15494 ---------------------------------------------
15495
15496 dup.2
15497     Michael Kerrisk
15498         Add description of dup3()
15499             dup3() was added in kernel 2.6.27.
15500
15501 epoll_create.2
15502     Michael Kerrisk
15503         Add description of new epoll_create1()
15504             The new epoll_create1() system call appeared in Linux 2.6.27.
15505
15506 eventfd.2
15507     Michael Kerrisk
15508         Describe eventfd2() and EFD_NONBLOCK and EFD_CLOEXEC
15509             Linux 2.6.27 added eventfd(), which supports a flags argument
15510             that eventfd() did not provide.  The flags so far implemented
15511             are EFD_NONBLOCK and EFD_CLOEXEC,
15512
15513 inotify_init.2
15514     Michael Kerrisk
15515         Add description of inotify_init1()
15516             The inotify_init1() system call was added in Linux 2.6.27.
15517
15518 pipe.2
15519     Michael Kerrisk
15520         Add description of new pipe2() syscall
15521             pipe2() was added in 2.6.27.  Describe the O_NONBLOCK and
15522             O_CLOEXEC flags.
15523
15524 signalfd.2
15525     Michael Kerrisk
15526         Describe signalfd4() and SFD_NONBLOCK and SFD_CLOEXEC
15527             Linux 2.6.27 added signalfd4(), which supports a flags argument
15528             that signalfd() did not provide.  The flags so far implemented
15529             are SFD_NONBLOCK and SFD_CLOEXEC.
15530
15531
15532 New and changed links
15533 ---------------------
15534
15535 dup3.2
15536     Michael Kerrisk
15537         New link to dup.2
15538             dup.2 now contains the description of the new dup3() syscall.
15539
15540 epoll_create1.2
15541     Michael Kerrisk
15542         New link to epoll_create.2
15543             epoll_create.2 now includes a description of the new
15544             epoll_create1() system call.
15545
15546 eventfd2.2
15547     Michael Kerrisk
15548         New link to eventfd.2
15549             The eventfd.2 page has some details on the eventfd2() system call,
15550             which was new in Linux 2.6.27.
15551
15552 inotify_init1.2
15553     Michael Kerrisk
15554         New link to inotify_init.2
15555             inotify_init.2 now includes a description of the new
15556             inotify_init1() system call.
15557
15558 pipe2.2
15559     Michael Kerrisk
15560         New link to pipe.2
15561             pipe(2) now contains a description of the new pipe2() syscall.
15562
15563 pthread_attr_destroy.3
15564     Michael Kerrisk
15565         New link to new pthread_attr_init.3
15566
15567 pthread_attr_getdetachstate.3
15568     Michael Kerrisk
15569         New link to new pthread_attr_setdetachstate.3
15570
15571 pthread_attr_getguardsize.3
15572     Michael Kerrisk
15573         New link to new pthread_attr_setguardsize.3
15574
15575 pthread_attr_getscope.3
15576     Michael Kerrisk
15577         New link to new pthread_attr_setscope.3
15578
15579 pthread_attr_getstack.3
15580     Michael Kerrisk
15581         New link to new pthread_attr_setstack.3
15582
15583 pthread_attr_getstackaddr.3
15584     Michael Kerrisk
15585         New link to new pthread_attr_setstackaddr.3
15586
15587 pthread_attr_getstacksize.3
15588     Michael Kerrisk
15589         New link to new pthread_attr_setstacksize.3
15590
15591 pthread_timedjoin_np.3
15592     Michael Kerrisk
15593         New link to new pthread_tryjoin_np.3
15594
15595 signalfd4.2
15596     Michael Kerrisk
15597         New link to signalfd.2
15598             signalfd.2 now includes text describing signalfd4() system call,
15599             new in Linux 2.6.27.
15600
15601
15602 Global changes
15603 --------------
15604
15605 eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2,
15606 wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3,
15607 fopencookie.3, getdate.3, getgrouplist.3, getprotoent_r.3,
15608 getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3,
15609 makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3,
15610 pthread_create.3, pthread_getattr_np.3, sem_wait.3, strtol.3, core.5
15611     Michael Kerrisk
15612         Add ".SS Program source" to EXAMPLE
15613             Add ".SS Program source" to clearly distinguish shell session and
15614             descriptive text from actual program code.
15615
15616 eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2,
15617 signalfd.2, timerfd_create.2, wait.2, backtrace.3,
15618 clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3,
15619 getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3,
15620 gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3,
15621 malloc.3, matherr.3, offsetof.3, pthread_attr_init.3,
15622 pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3,
15623 strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7
15624     Michael Kerrisk
15625         Format user input in shell sessions in boldface
15626
15627 frexp.3, strftime.3, strtok.3
15628     Michael Kerrisk
15629         Relocate shell session above example program
15630             Move the shell session text that demonstrates the use of
15631             the example program so that it precedes the actual
15632             example program.  This makes the page consistent with the
15633             majority of other pages.
15634
15635
15636 Changes to individual pages
15637 ---------------------------
15638
15639 epoll_create.2
15640     Michael Kerrisk
15641         Say more about unused epoll_create() 'size' arg
15642             Supply a little more explanation about why the 'size' argument
15643             of epoll_create() is nowadays ignored.
15644
15645 eventfd.2
15646     Michael Kerrisk
15647         Remove crufty text relating to flags argument
15648             Remove sentence saying that glibc adds a flags argument
15649             to the syscall; that was only relevant for the older
15650             eventfd() system call.
15651 getdents.2
15652     Christoph Hellwig
15653         Fix text relating to DT_UNKNOWN and 'd_type' support
15654             Some file systems provide partial support for 'dt_type',
15655             returning DT_UNKNOWN for cases they don't support.
15656             Update the discussion of 'd_type' and DT_UNKNOWN to
15657             support this.
15658
15659 getpeername.2, getsockname.2
15660     Michael Kerrisk
15661         SEE ALSO: add ip(7) and unix(7)
15662
15663 getsockopt.2
15664     Michael Kerrisk
15665         EINVAL can also occur if 'optval' is invalid
15666             In some cases, EINVAL can occur if 'optval' is invalid.
15667             Note this, and point reader to an example in ip(7).
15668             In response to:
15669             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=216092
15670
15671 inotify_init.2
15672 pipe.2
15673 timerfd_create.2
15674     Michael Kerrisk
15675         Clarify *_NONBLOCK description
15676             Make it clear that the NONBLOCK flag sets an attribute in the new
15677             open file description.
15678
15679 sched_yield.2
15680     Michael Kerrisk
15681         Rewrite description in terms of threads
15682             The text formerly described the operation of sched_yield() in
15683             terms of processes.  It should be in terms of threads.
15684     Michael Kerrisk
15685         Add NOTES text on appropriate use of sched_yield()
15686             Strategic calls to sched_yield() can be used to improve
15687             performance, but unnecessary use should be avoided.
15688
15689 sigaction.2
15690     Michael Kerrisk
15691         Clarify that sa_mask affects the *per-thread* signal mask
15692             The page didn't previously clearly explain the scope of the
15693             signal mask that is affected by sa_mask.
15694
15695 signalfd.2
15696     Michael Kerrisk
15697         Remove crufty text relating to flags argument
15698             Remove sentence saying that glibc adds a flags argument
15699             to the syscall; that was only relevant for the older
15700             signalfd() system call.
15701
15702 sigprocmask.2
15703     Michael Kerrisk
15704         Clarify that sigprocmask() operates on a per-thread mask
15705             The first sentence of the page was vague on the scope of the
15706             attribute changed by sigprocmask().  Reword to make this
15707             clearer and add a sentence in NOTES to explicitly state that
15708             the signal mask is a per-thread attribute.
15709
15710 socket.2
15711     Michael Kerrisk
15712         Document SOCK_NONBLOCK and SOCK_CLOEXEC flags
15713             These flags, specified in the 'type' argument, are supported
15714             since Linux 2.6.27.
15715
15716 socketpair.2
15717     Michael Kerrisk
15718         Refer to socket(2) for SOCK_CLOEXEC and SOCK_NONBLOCK
15719             Refer the reader to socket(2) for a description of the SOCK_CLOEXEC
15720             and SOCK_NONBLOCK flags, which are supported by socketpair() since
15721             Linux 2.6.27.
15722
15723 syscalls.2
15724     Michael Kerrisk
15725         Add new 2.6.27 system calls
15726             Add pipe2(), dup3(), epoll_create1(), inotify_init1(),
15727             eventfd2(), signalfd4().
15728
15729 timerfd_create.2
15730     Michael Kerrisk
15731         Document timerfd_create() TFD_CLOEXEC and TFD_NONBLOCK
15732             TFD_CLOEXEC and TFD_NONBLOCK are supported since LInux 2.6.27.
15733
15734 vfork.2
15735     Michael Kerrisk
15736         Clarify meaning of "child releases the parent's memory"
15737             The man page was not explicit about how the memory used by
15738             the child is released back to the parent.
15739
15740 ctime.3
15741     Michael Kerrisk
15742         ctime_r() and localtime_r() need not set 'timezone' and 'daylight'
15743             The man page already noted that these functions need not set
15744             'tzname', but things could be clearer: it tzset() is not called,
15745             then the other two variables also are not set.
15746
15747             Also, clarify that ctime() does set 'timezone' and 'daylight'.
15748
15749 dlopen.3
15750     Michael Kerrisk
15751         LD_LIBRARY_PATH is inspected once, at program start-up
15752             Make it clear that LD_LIBRARY_PATH is inspected *once*, at
15753             program start-up.  (Verified from source and by experiment.)
15754
15755 fmemopen.3
15756     Michael Kerrisk
15757         Document binary mode (mode 'b')
15758             Glibc 2.9 adds support to fmemopen() for binary mode opens.
15759             Binary mode is specified by inclusion of the letter 'b' in
15760             the 'mode' argument.
15761
15762 getaddrinfo.3
15763     Michael Kerrisk
15764         Clarify error descriptions with some examples
15765             Clarify the description of some errors by giving examples
15766             that produce the errors.  (Text added for EAI_SERVICE and
15767             EAI_SOCKTYPE.)
15768
15769             Also, add an error case for EAI_BADFLAGS.
15770
15771 gethostbyname.3
15772     Michael Kerrisk
15773         Rationalize text on POSIX.1-2001 obsolete interfaces
15774             POSIX.1 marks gethostbyname(), gethostbyaddr(), and 'h_errno'
15775             as obsolete.  The man page explained this, but with some
15776             duplication.  Remove the duplication, and otherwise tidy up
15777             discussion of this point.
15778
15779 popen.3
15780     Michael Kerrisk
15781         Change one-line description in NAME
15782             s%process I/O%pipe stream to or from a process%
15783     Michael Kerrisk
15784         Document 'e' (close-on-exec) flag
15785             glibc 2.9 implements the 'e' flag in 'type', which sets the
15786             close-on-exec flag on the underlying file descriptor.
15787
15788 raise.3
15789     Michael Kerrisk
15790         SEE ALSO: add pthread_kill(3)
15791
15792 readdir.3
15793     Christoph Hellwig
15794         Fix text relating to DT_UNKNOWN and 'd_type' support
15795             (This mirrors the previous change to getdents.2)
15796             Some file systems provide partial support for 'dt_type',
15797             returning DT_UNKNOWN for cases they don't support.
15798             Update the discussion of 'd_type' and DT_UNKNOWN to
15799             support this.
15800
15801 strcpy.3
15802     Jason Spiro
15803         Strengthen warning about checking against buffer overruns
15804             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=413940
15805
15806 tty_ioctl.4
15807     Michael Kerrisk
15808         Explain capability requirements for TIOCCONS
15809             Explain capability requirements for TIOCCONS, and describe
15810             changes in 2.6.10 relating to capabilities.
15811     Michael Kerrisk
15812         Explain capability requirements for various ioctls
15813             For TIOCSLCKTRMIOS, TIOCSCTTY, TIOCEXCL, explain the exact
15814             capability that is required (the text formerly just said "root"
15815             in each case).
15816
15817 proc.5
15818     Michael Kerrisk
15819         Document /proc/sys/kernel/threads-max
15820             Defines the system-wide limit on the number of threads (tasks).
15821
15822 utmp.5
15823     Pierre Cazenave
15824         It is just "other" who should not have write perms on utmp
15825             The page was vague before, saying that utmp should not be
15826             writable by any user.  This isn't true: it can be, and
15827             typically is, writable by user and group.
15828
15829 epoll.7
15830     Michael Kerrisk
15831         Mention epoll_create1() as part of epoll API
15832             epoll_create1() was added in Linux 2.6.27, and extends the
15833             functionality of epoll_create().
15834
15835 inotify.7
15836     Michael Kerrisk
15837         Mention inotify_init1() in overview of API
15838             Discuss the new inotify_init1() system call in the overview of
15839             the inotify API.
15840
15841 ip.7
15842     Michael Kerrisk
15843         Detail EINVAL error for IP_ADD_MEMBERSHIP socket option
15844             In response to:
15845             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=216092
15846
15847 iso_8859-7.7
15848     Lefteris Dimitroulakis
15849         Add Drachma, Euro, and Greek Ypogegrammeni
15850             Also, amend description of characters 0241 and 0242.
15851
15852 man-pages.7
15853     Michael Kerrisk
15854         Example shell sessions should have user input boldfaced
15855
15856 pthreads.7
15857     Michael Kerrisk
15858         Describe return value from pthreads functions
15859             Describe the usual success (0) and failure (non-zero) returns,
15860             and note that POSIX.1-2001 specifies that pthreads functions
15861             can never fail with the error EINTR.
15862
15863 signal.7
15864     Michael Kerrisk
15865         Timeouts make socket interfaces non-restartable
15866             If setsockopt() is used to set a timeout on a socket(),
15867             then the various socket interfaces are not automatically
15868             restarted, even if SA_RESTART is specified when
15869             establishing the signal handler.  Analogous behavior occurs
15870             for the "stop signals" case.
15871
15872 socket.7
15873     Michael Kerrisk
15874         SEE ALSO: add unix(7)
15875
15876 ld.so.8
15877     Michael Kerrisk
15878         Document LD_USE_LOAD_BIAS
15879             Drawing heavily on Jakub Jelinek's description in
15880             http://sources.redhat.com/ml/libc-hacker/2003-11/msg00127.html
15881             (Subject: [PATCH] Support LD_USE_LOAD_BIAS)
15882         --inhibit-rpath is ignored for setuid/setgid ld.so
15883             The --inhibit-rpath option is ignored if ld.so is setuid/setgid
15884             (not if the executable is setuid/setgid).
15885     Michael Kerrisk
15886         Since glibc 2.4, setuid/setgid programs ignore LD_ORIGIN_PATH
15887     Michael Kerrisk
15888         Fix description of LD_PROFILE and LD_PROFILE_OUTPUT
15889             Clarify that LD_PROFILE is pathname or a soname,
15890             and identify name of profiling output file.
15891             Fix description of LD_PROFILE_OUTPUT, which wasn't even close to
15892             the truth.  (But why did it remain unfixed for so many years?)
15893     Michael Kerrisk
15894         Since glibc 2.3.4, setuid/setgid programs ignore LD_DYNAMIC_WEAK
15895     Michael Kerrisk
15896         Since version 2.3.5, setuid/setgid programs ignore LD_SHOW_AUXV
15897     Michael Kerrisk
15898         Reorder lists of LD_* environment variables alphabetically
15899     Michael Kerrisk
15900         Since glibc 2.3.4, setuid/setgid programs ignore LD_DEBUG
15901
15902
15903 ==================== Changes in man-pages-3.13 ====================
15904
15905 Released: 2008-11-07, Bucaramanga
15906
15907
15908 Contributors
15909 ------------
15910
15911 The following people contributed notes, ideas, or patches that have
15912 been incorporated in changes in this release:
15913
15914 Bert Wesarg <bert.wesarg@googlemail.com>
15915 Karsten Weiss <knweiss@gmail.com>
15916 Lefteris Dimitroulakis <edimitro@tee.gr>
15917 Olaf van der Spek <olafvdspek@gmail.com>
15918 Sam Varshavchik <mrsam@courier-mta.com>
15919 Török Edwin <edwintorok@gmail.com>
15920 Ulrich Mueller <ulm@gentoo.org>
15921 Valdis Kletnieks <Valdis.Kletnieks@vt.edu>
15922
15923 Apologies if I missed anyone!
15924
15925
15926 New and rewritten pages
15927 -----------------------
15928
15929 pthread_attr_setaffinity_np.3
15930     Michael Kerrisk
15931         New page for pthread_attr_setaffinity_np(3) and
15932         pthread_attr_getaffinity_np(3)
15933
15934 pthread_attr_setschedparam.3
15935     Michael Kerrisk
15936         New page for pthread_attr_setschedparam(3) and
15937         pthread_attr_getschedparam(3)
15938
15939 pthread_attr_setschedpolicy.3
15940     Michael Kerrisk
15941         New page for pthread_attr_setschedpolicy(3) and
15942         pthread_attr_getschedpolicy(3)
15943
15944 pthread_setaffinity_np.3
15945     Michael Kerrisk
15946         New page for pthread_setaffinity_np(3) and pthread_getaffinity_np(3)
15947
15948 pthread_setschedparam.3
15949     Michael Kerrisk
15950         New page for pthread_setschedparam(3) and pthread_getschedparam(3)
15951
15952 pthread_setschedprio.3
15953     Michael Kerrisk
15954         New page for pthread_setschedprio(3)
15955
15956
15957 New and changed links
15958 ---------------------
15959
15960 pthread_attr_getaffinity_np.3
15961     Michael Kerrisk
15962         New link to new pthread_attr_setaffinity_np.3
15963
15964 pthread_attr_getschedparam.3
15965     Michael Kerrisk
15966         New link to new pthread_attr_setschedparam.3
15967
15968 pthread_attr_getschedpolicy.3
15969     Michael Kerrisk
15970         New link to new pthread_attr_setschedpolicy.3
15971
15972 pthread_getaffinity_np.3
15973     Michael Kerrisk
15974         New link to new pthread_setaffinity_np.3
15975
15976 pthread_getschedparam.3
15977     Michael Kerrisk
15978         New link to new pthread_setschedparam.3
15979
15980
15981 Global changes
15982 --------------
15983
15984 pthread_attr_setaffinity_np.3
15985 pthread_getattr_np.3
15986 pthread_setaffinity_np.3
15987 pthread_tryjoin_np.3
15988     Michael Kerrisk
15989         Explain _np suffix
15990             Add text to CONFORMING TO explaining that the "_np"
15991             suffix is because these functions are non-portable.
15992
15993
15994 Changes to individual pages
15995 ---------------------------
15996
15997 sched_setaffinity.2
15998     Michael Kerrisk
15999         SEE ALSO: add sched_getcpu(3)
16000
16001 sched_setaffinity.2
16002     Michael Kerrisk
16003         SEE ALSO: Add pthread_setaffinity_np(3)
16004
16005 sched_setaffinity.2
16006     Michael Kerrisk
16007         Clarify EINVAL error for cpusetsize < kernel mask size
16008             For sched_setaffinity(), the EINVAL error that occurs
16009             if 'cpusetsize' is smaller than the kernel CPU set size only
16010             occurs with kernels before 2.6.9.
16011
16012 vfork.2
16013     Michael Kerrisk
16014         Child holds parent's memory until execve() or *termination*
16015             The page was phrased in a few places to describe the child as
16016             holding the parent's memory until the child does an execve(2)
16017             or an _exit(2).  The latter case should really be the more
16018             general process termination (i.e., either _exit(2) or abnormal
16019             termination).
16020
16021 clock_getres.3
16022     Michael Kerrisk
16023         CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID not setabble
16024             According to POSIX.1-2001, the CLOCK_PROCESS_CPUTIME_ID and
16025             CLOCK_THREAD_CPUTIME_ID clocks should be settable, but
16026             currently they are not.
16027
16028 pthread_attr_setstacksize.3
16029     Michael Kerrisk, after a report by Karsten Weiss
16030         EINVAL occurs on some systems if stacksize != page-size
16031             On MacOS X at least, pthread_attr_setstacksize(3) can fail
16032             with EINVAL if 'stacksize' is not a multiple of the system
16033             page size.  Best to mention this so as to aid people writing
16034             portable programs.
16035
16036 pthread_create.3
16037     Karsten Weiss
16038         Fix bug in EXAMPLE program
16039             The calloc() line should read like this instead:
16040
16041                 tinfo = calloc(num_threads, sizeof(struct thread_info));
16042
16043 pthread_exit.3
16044     Michael Kerrisk
16045         BUGS: thread group with a dead leader and stop signals
16046             Document the bug that can occur when a stop signal
16047             is sent to a thread group whose leader has terminated.
16048             http://thread.gmane.org/gmane.linux.kernel/611611
16049             http://marc.info/?l=linux-kernel&m=122525468300823&w=2
16050
16051 resolver.3
16052     Michael Kerrisk
16053         Fix prototype of dn_expand()
16054             The 4th argument is "char *", not "unsigned char *".
16055             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504708
16056
16057 epoll.7
16058     Michael Kerrisk
16059         Fix error handling after accept() in example code
16060             Simply continuing after an error is in most cases wrong,
16061             and can lead to infinite loops (e.g., for EMFILE).
16062             So handle an error by terminating.
16063             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504202
16064
16065 epoll.7
16066     Michael Kerrisk
16067         Add error handling for epoll_wait() call in example code
16068
16069 epoll.7
16070     Michael Kerrisk
16071         Improve example code
16072             Fill in some gaps in example code (variable declarations,
16073             adding listening socket to epoll set).
16074             Give variables more meaningful names.
16075             Other minor changes.
16076             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504202
16077
16078 iso_8859-7.7
16079     Lefteris Dimitroulakis
16080         Add characters for Drachma and Greek Ypogegrammeni
16081             Lines for these two characters were added in the previous patch,
16082             but the actual characters were not included in the 4th column
16083             of the table.  This fixes that.
16084
16085 pthreads.7
16086     Michael Kerrisk
16087         Add a section describing thread IDs
16088             In particular, note that in each pthreads function that takes
16089             a thread ID argument, that ID by definition refers to a thread
16090             in the same process as the caller.
16091
16092
16093 ==================== Changes in man-pages-3.14 ====================
16094
16095 Released: 2008-11-25, Bucaramanga
16096
16097
16098 Contributors
16099 ------------
16100
16101 The following people contributed notes, ideas, or patches that have
16102 been incorporated in changes in this release:
16103
16104 Andreas Henriksson <andreas@fatal.se>
16105 Bert Wesarg <bert.wesarg@googlemail.com>
16106 Cedric Le Goater <clg@fr.ibm.com>
16107 Chris Heath <chris@heathens.co.nz>
16108 Eric Biederman <ebiederm@xmission.com>
16109 Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
16110 Ivana Varekova <varekova@redhat.com>
16111 Jen Axboe <jens.axboe@oracle.com>
16112 Jens Axboe <jens.axboe@oracle.com>
16113 Loïc Domaigne <tech@domaigne.com>
16114 Masanari Iida <masanari.iida@hp.com>
16115 Paul Evans <leonerd@leonerd.org.uk>
16116 Pavel Emelyanov <xemul@openvz.org>
16117 Pierre-Paul Paquin <pierrepaulpaquin@gmail.com>
16118 Serge E. Hallyn <serge@hallyn.com>
16119 Stefano Teso <teso@disi.unitn.it>
16120 Stew Benedict <stewb@linux-foundation.org>
16121 Vegard Nossum <vegard.nossum@gmail.com>
16122
16123 Apologies if I missed anyone!
16124
16125
16126 New and rewritten pages
16127 -----------------------
16128
16129 CPU_SET.3
16130     Michael Kerrisk
16131         New page documenting CPU_* macros
16132             This page contains material moved out of sched_setscheduler(2).
16133             It overwrites a previously existing link file with the same name.
16134     Michael Kerrisk
16135         Add description of macros for dynamically allocated CPU sets
16136             Add descriptions of CPU_ALLOC(), CPU_ALLOC_SIZE(), CPU_FREE(),
16137             CPU_SET_S(), CPU_CLR_S(), CPU_ISSET_S(), CPU_ZERO_S(),
16138             CPU_COUNT_S(), CPU_AND_S(), CPU_OR_S(), CPU_XOR_S(), and
16139             CPU_EQUAL_S().
16140     Michael Kerrisk
16141         Add documentation of CPU_COUNT()
16142     Michael Kerrisk
16143         Add description of CPU_AND(), CPU_OR, CPU_XOR(), and CPU_EQUAL()
16144             Plus a few other small clean-ups of the text
16145     Michael Kerrisk
16146         Various improvements in DESCRIPTION
16147             After review comments by Bert Wesarg:
16148             * Explain that cpu_set_t is a bitset, but should be considered
16149               opaque.
16150             * A CPU set can be duplicated with memset().
16151             * Size of a CPU set is rounded up to size of long.
16152             * CPU_SETSIZE is in bits, but the setsize argument is in bytes.
16153     Michael Kerrisk
16154         Document CPU_ALLOC()/CPU_ALLOC_SIZE() bug
16155             These macros return twice what they should because of thinko
16156             in glibc 2.8 and earlier.  The bug is fixed for glibc 2.9.
16157             http://sourceware.org/bugzilla/show_bug.cgi?id=7029
16158     Michael Kerrisk
16159         NOTES: Discuss use of types in "prototypes" for these macros
16160             The SYNOPSIS shows types for arguments and return values, but
16161             these are really just suggestions: since the interfaces are
16162             macros, the compiler won't catch all violations of
16163             the "type rules".  Warn the reader of this.
16164
16165 pthread_attr_setinheritsched.3
16166     Michael Kerrisk
16167         New page for pthread_attr_setinheritsched(3) and
16168         pthread_attr_getinheritsched(3)
16169
16170 pthread_cancel.3
16171     Michael Kerrisk
16172         New page for pthread_cancel(3)
16173
16174 pthread_cleanup_push.3
16175     Michael Kerrisk
16176         New page for pthread_cleanup_push(3) and pthread_cleanup_pop(3)
16177
16178 pthread_setcancelstate.3
16179     Michael Kerrisk
16180         New page for pthread_setcancelstate(3) and pthread_setcanceltype(3)
16181
16182 pthread_testcancel.3
16183     Michael Kerrisk
16184         New page for pthread_testcancel(3)
16185
16186
16187 Newly documented interfaces in existing pages
16188 ---------------------------------------------
16189
16190 clone.2
16191     Jens Axboe
16192         Document CLONE_IO (new in Linux 2.6.25)
16193             Some text also by mtk.
16194     Michael Kerrisk
16195         Document CLONE_NEWNET
16196     Michael Kerrisk
16197         Document CLONE_NEWUTS (new in Linux 2.6.19)
16198     Michael Kerrisk
16199         Document CLONE_NEWIPC flag (new in Linux 2.6.19)
16200     Michael Kerrisk
16201         Document CLONE_NEWPID flag (new in Linux 2.6.24)
16202
16203 mmap.2
16204     Michael Kerrisk
16205         Document MAP_STACK flag (new in Linux 2.6.27)
16206
16207 arp.7
16208     Michael Kerrisk
16209         Document /proc file retrans_time_ms (new in Linux 2.6.12)
16210     Michael Kerrisk
16211         Document /proc file base_reachable_time_ms (new in Linux 2.6.12)
16212
16213 icmp.7
16214     Michael Kerrisk
16215         Document icmp_ignore_bogus_error_responses (new in Linux 2.2)
16216             Text taken from Documentation/networking/ip-sysctl.txt
16217     Michael Kerrisk
16218         Document icmp_ratelimit and icmp_ratemask (new in Linux 2.4.10)
16219             Text taken from Documentation/networking/ip-sysctl.txt
16220     Michael Kerrisk
16221         Document icmp_echo_ignore_broadcasts (new in Linux 2.6.12)
16222             Text taken from Documentation/networking/ip-sysctl.txt
16223
16224 tcp.7
16225     Michael Kerrisk
16226         Document /proc file tcp_slow_start_after_idle (new in Linux 2.6.18)
16227             Text taken from Documentation/networking/ip-sysctl.txt
16228     Michael Kerrisk
16229         Document /proc file tcp_base_mss (new in Linux 2.6.17)
16230             Text taken from Documentation/networking/ip-sysctl.txt
16231     Michael Kerrisk
16232         Document /proc file tcp_frto_response (new in Linux 2.6.22)
16233             Text taken from Documentation/networking/ip-sysctl.txt
16234     Michael Kerrisk
16235         Document /proc file tcp_moderate_rcvbuf (new in Linux 2.4.17/2.6.7)
16236             Text taken from Documentation/networking/ip-sysctl.txt
16237     Michael Kerrisk
16238         Document /proc file tcp_congestion_control (new in Linux 2.4.13)
16239             Text taken from Documentation/networking/ip-sysctl.txt
16240     Michael Kerrisk
16241         Document /proc file tcp_no_metrics_save (new in Linux 2.6.6)
16242             Text taken from Documentation/networking/ip-sysctl.txt
16243     Michael Kerrisk
16244         Document /proc file tcp_mtu_probing (new in Linux 2.6.17)
16245             Text taken from Documentation/networking/ip-sysctl.txt
16246     Michael Kerrisk
16247         Document /proc file tcp_dma_copybreak (new in Linux 2.6.24)
16248             Text taken from Documentation/networking/ip-sysctl.txt
16249     Michael Kerrisk
16250         Document /proc file tcp_tso_win_divisor (new in Linux 2.6.9)
16251             Text taken from Documentation/networking/ip-sysctl.txt
16252     Michael Kerrisk
16253         Document /proc file tcp_allowed_congestion_control (new in Linux 2.4.20)
16254             Text taken from Documentation/networking/ip-sysctl.txt
16255     Michael Kerrisk
16256         Document /proc file tcp_workaround_signed_windows (new in Linux 2.6.26)
16257             Text taken from Documentation/networking/ip-sysctl.txt
16258     Michael Kerrisk
16259         Document /proc file tcp_available_congestion_control (new in Linux 2.4.20)
16260             Text taken from Documentation/networking/ip-sysctl.txt
16261     Michael Kerrisk
16262         Document /proc file tcp_abc (new in Linux 2.6.15)
16263             Text taken from Documentation/networking/ip-sysctl.txt
16264
16265 udp.7
16266     Michael Kerrisk
16267         Document /proc files udp_mem, udp_rmem_min, and udp_wmem_min
16268             All of these are new in Linux 2.6.25
16269
16270
16271 New and changed links
16272 ---------------------
16273
16274 CPU_ALLOC.3
16275 CPU_ALLOC_SIZE.3
16276 CPU_AND.3
16277 CPU_AND_S.3
16278 CPU_CLR_S.3
16279 CPU_COUNT.3
16280 CPU_COUNT_S.3
16281 CPU_EQUAL.3
16282 CPU_EQUAL_S.3
16283 CPU_FREE.3
16284 CPU_ISSET_S.3
16285 CPU_OR.3
16286 CPU_OR_S.3
16287 CPU_SET_S.3
16288 CPU_XOR.3
16289 CPU_XOR_S.3
16290 CPU_ZERO_S.3
16291     Michael Kerrisk
16292         New link to new CPU_SET.3
16293
16294 CPU_CLR.3
16295 CPU_ISSET.3
16296 CPU_ZERO.3
16297     Michael Kerrisk
16298         Update links to point to CPU_SET.3
16299             The documentation of the CPU_* macros migrated to a new
16300             location: CPU_SET.3.
16301
16302 pthread_attr_getinheritsched.3
16303     Michael Kerrisk
16304         New link to new pthread_attr_setinheritsched.3
16305
16306 pthread_cleanup_pop.3
16307     Michael Kerrisk
16308         New link to new pthread_cleanup_push.3
16309
16310 pthread_setcanceltype.3
16311     Michael Kerrisk
16312         New link to new pthread_setcancelstate.3
16313
16314
16315 Global changes
16316 --------------
16317
16318 clone.2
16319 mount.2
16320 unshare.2
16321 proc.5
16322 path_resolution.7
16323     Michael Kerrisk
16324         Global fix: s/namespace/mount-point namespace/, as appropriate
16325             In recent times, a number of other namespace flags have been
16326             added to clone(2).  As such, it is no longer clear to use
16327             the generic term "namespace" to refer to the particular
16328             namespace controlled by CLONE_NEWNS; instead, use the
16329             term "mount-point namespace".
16330     Michael Kerrisk
16331         Global fix: s/mount-point namespace/mount namespace/
16332             This is more consistent with the term "mounts namespace"
16333             used in the 2008 ACM SIGOPS paper, "Virtual servers
16334             and and checkpoint/restart in mainstream Linux".
16335             (I avoided the "s", because using the plural strikes me
16336             as klunky English, and anyway we don't talk about
16337             the "PIDs namespace" or the "networks namespace", etc..)
16338
16339 connect.2
16340 listen.2
16341 send.2
16342 uname.2
16343 cmsg.3
16344 proc.5
16345 arp.7
16346 ddp.7
16347 icmp.7
16348 ip.7
16349 raw.7
16350 socket.7
16351 tcp.7
16352 udp.7
16353     Michael Kerrisk
16354         Global fix: eliminate mention of the obsolete sysctl(2) interface
16355             Many pages still mention use of the obsolete sysctl(2) system
16356             call, or used the term "sysctls"; rewrite these mentions to
16357             instead be in terms of /proc interfaces.
16358
16359 fcntl.2
16360 signal.2
16361 mbsnrtowcs.3
16362 mbsrtowcs.3
16363 mbtowc.3
16364 wcrtomb.3
16365 wcsnrtombs.3
16366 wcsrtombs.3
16367 wctomb.3
16368     Michael Kerrisk
16369         Global fix: s/multi-thread/multithread/
16370
16371 getdents.2
16372 pthread_attr_init.3
16373 pthread_create.3
16374 pthread_getattr_np.3
16375 pthread_setaffinity_np.3
16376 pthread_setschedparam.3
16377 pthread_tryjoin_np.3
16378     Michael Kerrisk
16379         Use consistent error-handling function names
16380             Many older pages use a handle_error() macro to do simple
16381             error handling from system and library function calls.
16382             Switch these pages to do similar.
16383
16384
16385 Changes to individual pages
16386 ---------------------------
16387
16388 time.1
16389     Michael Kerrisk
16390         Note that some shells have a 'time' built-in command
16391             Therefore, to access the functionality described on this page,
16392             it may be necessary to specify the full pathname.
16393
16394 clone.2
16395     Michael Kerrisk
16396         Place list of CLONE_* flags in alphabetical order
16397             (No content changes.)
16398 fsync.2
16399     Michael Kerrisk
16400         Update feature test macro requirements for fsync()
16401             Since glibc 2.8, the fsync() declaration is also exposed if
16402             _POSIX_C_SOURCE >= 200112L
16403
16404 sched_setaffinity.2
16405     Michael Kerrisk
16406         Add note on system-imposed restrictions on CPUs actually used
16407             After Loïc Domaigne's suggestion for pthread_setaffinity_np(3), add
16408             similar text to this page noting that the system silently
16409             limits the set of CPUs on which the process actually runs to
16410             the set of CPUs physically present and the limits imposed by
16411             cpuset(7).
16412
16413 sched_setaffinity.2
16414     Michael Kerrisk
16415         Removed discussion of CPU_* macros()
16416             These macros are now moving to a separate page.
16417     Michael Kerrisk
16418         Refer reader to pthread_setaffinity_np(3)
16419             pthread_setaffinity_np() is preferable for setting
16420             thread CPU affinity if using the POSIX threads API.
16421
16422 sysctl.2
16423     Michael Kerrisk
16424         Add prominent warning against using this system call
16425             This was already stated under NOTES, but make it even more
16426             prominent by adding a sentence at the start of the DESCRIPTION.
16427
16428 uname.2
16429     Michael Kerrisk
16430         Add C comments describing fields in utsname structure
16431
16432 atan2.3
16433     Stefano Teso
16434         Fix description of range of function value return
16435             The range is not [-pi/2, pi/2], but [-pi, pi].
16436
16437             (mtk: This error was reported by Nicolas François, and
16438             should have been fixed in 3.11, but somewhere along the way,
16439             the fix got lost.)
16440
16441             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=506299
16442
16443 bindresvport.3
16444     Michael Kerrisk
16445         Since glibc 2.8, EPFNOSUPPORT error is now EAFNOSUPPORT
16446             Glibc switched to using a POSIX-specified error code for
16447             this error case.
16448
16449             http://bugs.linuxbase.org/show_bug.cgi?id=2375
16450
16451 clock_getres.3
16452     Michael Kerrisk
16453         CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID not settable
16454             According to POSIX.1-2001, the CLOCK_PROCESS_CPUTIME_ID and
16455             CLOCK_THREAD_CPUTIME_ID clocks should be settable, but
16456             currently they are not.
16457
16458 getgrnam.3
16459     Michael Kerrisk
16460         Clarify and add more detail in RETURN VALUE description
16461             The page was a bit fuzzy in describing the return values for
16462             various cases.  In particular, it needed to be more explicit
16463             in describing what happens for the "not found" case.
16464
16465             This is an analogous change to the change for
16466             getpwnam.3, made after Andreas Henriksson's report.
16467             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787
16468     Michael Kerrisk
16469         Rename arguments to getgrnam_r() and getgrgid_r()
16470             s/gbuf/grp/ and s/gbufp/result/, for consistency
16471             with POSIX.1 argument names.
16472     Michael Kerrisk
16473         Clarify RETURN VALUE description
16474             The page was a bit fuzzy in describing the return values for
16475             various cases.  In particular, it needed to be more explicit
16476             in describing what happens for the "not found" case.
16477
16478             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504708
16479
16480 getpwnam.3
16481     Michael Kerrisk
16482         Rename arguments to getpwnam_r() and getpwuid_r()
16483             s/pwbuf/pwd/ and s/pwbufp/result/, for consistency
16484             with POSIX.1 argument names.
16485     Michael Kerrisk
16486         Clarify and add more detail in RETURN VALUE description
16487             The page was a bit fuzzy in describing the return values for
16488             various cases.  In particular, it needed to be more explicit
16489             in describing what happens for the "not found" case.
16490
16491             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787
16492     Michael Kerrisk
16493         Add an EXAMPLE program for getpwnam_r()
16494
16495 inet_ntop.3
16496     Michael Kerrisk
16497         Rename 'cnt' argument to 'size'
16498             This is consistent with POSIX.1, and also a more sensible name.
16499     Michael Kerrisk
16500         Rework text describing 'size' argument
16501             (After a suggestion by Vegard Nossum.)
16502             Also made a few other small rewordings to in the initial
16503             paragraph.
16504
16505 makecontext.3
16506     Michael Kerrisk
16507         Add text on use of pointer arguments to makecontext()
16508             Passing pointer arguments to makecontext() is possible,
16509             but only on some architectures, and with no guarantees
16510             of portability.
16511
16512             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504699
16513
16514 pthread_attr_setaffinity_np.3
16515     Michael Kerrisk
16516         Various fixes after review by Loïc Domaigne
16517             Reviewed-by: Loïc Domaigne
16518
16519 pthread_attr_setaffinity_np.3
16520 pthread_setaffinity_np.3
16521     Michael Kerrisk
16522         Update to reflect new location of CPU_*() documentation
16523             The CPU_*() macros are now documented in CPU_SET.3;
16524             update to reflect that fact.
16525     Michael Kerrisk
16526         Remove redundant text relating to CPU sets
16527             Information about CPU_SETSIZE can be found in CPU_SET.3, so
16528             remove discussion of it here.
16529
16530 pthread_attr_setschedparam.3
16531 pthread_setschedparam.3
16532     Michael Kerrisk
16533         Remove text saying that only sched_priority is required by POSIX.1
16534             Loïc Domaigne points out that if a system implements
16535             SCHED_SPORADIC (which Linux does not), then other
16536             fields are also specified in sched_param.  The simple
16537             solution is just to remove that phrase from the man
16538             page.
16539
16540 pthread_cancel.3
16541 pthread_detach.3
16542 pthread_join.3
16543 pthread_setaffinity_np.3
16544     Michael Kerrisk
16545         Make text of ESRCH error consistent
16546
16547 pthread_setaffinity_np.3
16548     Michael Kerrisk
16549         Add text to EINVAL error mentioning cpuset(7)
16550     Michael Kerrisk
16551         Various improvements after review by Loïc Domaigne
16552             Various fix-ups after Loïc's review.
16553
16554             Reviewed-by: Loïc Domaigne
16555
16556 pthread_setschedparam.3
16557     Michael Kerrisk
16558         PTHREAD_INHERIT_SCHED is default for inherit scheduler attribute
16559             In EXAMPLE, note that PTHREAD_INHERIT_SCHED is the default for
16560             the inherit scheduler attribute attribute.
16561
16562 syslog.3
16563     Masanari Iida
16564         LOG_KERN messages can't be generated from user processes
16565             Masanari notes that this is an FAQ for logger(1) and that
16566             Solaris and FreeBSD document this point in syslog(3).
16567             The glibc info page also hides this comment in its source:
16568
16569                 Internally, there is also LOG_KERN, but LOG_KERN == 0,
16570                 which means if you try to use it here, just selects default.
16571
16572 proc.5
16573     Ivana Varekova
16574         Fix reference to kernel source file
16575             Use relative reference to Documentation/mtrr.txt.
16576
16577 arp.7
16578     Michael Kerrisk
16579         Add kernel version numbers for /proc interfaces
16580
16581 cpuset.7
16582     Michael Kerrisk
16583         SEE ALSO: add CPU_SET(3)
16584
16585 epoll.7
16586     Michael Kerrisk
16587         Note glibc version that added epoll support
16588
16589 icmp.7
16590     Michael Kerrisk
16591         Add kernel version numbers to /proc file descriptions
16592
16593 inotify.7
16594     Vegard Nossum
16595         Fix description of max_user_watches
16596             It seems that inotify(7) is wrong here:
16597
16598             "/proc/sys/fs/inotify/max_user_watches
16599                 This specifies a limit on the number of watches that can be
16600                 associated with each inotify instance."
16601
16602             On my system, the default value for this variable is 8192. But I
16603             cannot create more than 8192 watches in total for the same UID
16604             even when they are on different inotify instances. So I suggest
16605             to rephrase this as: "This specifies an upper limit on the
16606             number of watches that can be created per real user ID."
16607
16608 ip.7
16609     Michael Kerrisk
16610         Reorder socket options alphabetically
16611     Michael Kerrisk
16612         Added kernel version numbers for IP_* socket options
16613     Michael Kerrisk
16614         Relocate kernel version information for IP_PMTUDISC_PROBE
16615     Michael Kerrisk
16616         Add kernel version numbers for /proc/sys/net/ipv4/ip_* files
16617     Michael Kerrisk
16618         Remove mention of kernel header from description of IP_RECVERR
16619             Looks like glibc has had this definition since about version 2.1.
16620     Michael Kerrisk
16621         Relocate kernel version information for ip_mreqn structure
16622     Michael Kerrisk
16623         Relocate info about Linux-specific sockopts to NOTES
16624             Also add some source comments about non-standard Linux-specific
16625             options that are not yet documented.
16626
16627 netlink.7
16628     Vegard Nossum
16629         Fix incorrect variable names in example code
16630             s/snl/sa/ * 2
16631
16632 pthreads.7
16633     Michael Kerrisk
16634         Add section on cancellation points
16635             This section includes a list of the functions that must and
16636             may be cancellation points.
16637     Michael Kerrisk
16638         Rework, and fix small error in, thread-safe function list
16639             Integrate the changes that occurred in POSIX.1-2008 into the
16640             main list (to be consistent with the list, elsewhere on this
16641             page, of functions that are cancellation points).
16642
16643             Also, fix an error that said that strerror() was added to
16644             the list in POSIX.1-2008.  It was strsignal() that was
16645             added.  (strerror() was already in the list in POSIX.1-2001.)
16646     Michael Kerrisk
16647         Tweak text on sigpause() cancellation point
16648             In POSIX.1-2009, this function moves from the "must be"
16649             to the "may be" list.
16650     Michael Kerrisk
16651         Add ref to signal(7) for further info on use of real-time signals
16652             signal(7) provides some further details on the use of real-time
16653             signals by the two Linux threading implementations.
16654     Michael Kerrisk
16655         SEE ALSO: add pthread_attr_init() and pthread_cancel()
16656
16657 tcp.7
16658     Michael Kerrisk
16659         Update description of tcp_rmem defaults for Linux 2.6
16660     Michael Kerrisk
16661         Add kernel version numbers for TCP_* socket options
16662             Note kernel version were each socket option first appeared.
16663     Michael Kerrisk
16664         The tcp_bic* proc files disappeared in Linux 2.6.13
16665     Michael Kerrisk
16666         tcp_vegas_cong_avoid disappeared in Linux 2.6.13
16667     Michael Kerrisk
16668         Add mention of RFC 4138 for 'tcp_frto' /proc file
16669     Michael Kerrisk
16670         Remove mention of /proc in VERSIONS
16671             This information is not indicated for each /proc interface
16672     Michael Kerrisk
16673         Clarify that tcp_mem measures in units of the system page size
16674     Michael Kerrisk
16675         Update tcp_frto description for 2.6.22 changes
16676             Linux 2.6.22 added a mode value 2 ("Enable SACK-enhanced
16677             F-RTO if flow uses SACK").
16678     Michael Kerrisk
16679         Fix alphabetical order in /proc file list
16680             A few entries were slightly out of order.
16681     Michael Kerrisk
16682         Remove obsolete statement about /proc from VERSIONS
16683             Much of the text has been updated to 2.6.27 or so,
16684             so this statement no longer applies.
16685     Michael Kerrisk
16686         Add kernel version numbers for each /proc interface
16687             Note kernel version where each /proc interface first appeared
16688     Michael Kerrisk
16689         tcp_westwood /proc file disappeared in Linux 2.6.13
16690     Michael Kerrisk
16691         Update description of tcp_wmem defaults for Linux 2.6
16692
16693
16694 ==================== Changes in man-pages-3.15 ====================
16695
16696 Released: 2008-12-05, Bucaramanga
16697
16698
16699 Contributors
16700 ------------
16701
16702 The following people contributed notes, ideas, or patches that have
16703 been incorporated in changes in this release:
16704
16705 Andre Majorel <aym-xunil@teaser.fr>
16706 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
16707 Chris Heath <chris@heathens.co.nz>
16708 Drake Wilson <drake@begriffli.ch>
16709 Mats Wichmann <mats.d.wichmann@intel.com>
16710 Mel Gorman <mel@csn.ul.ie>
16711 Michael Kerrisk <mtk.manpages@gmail.com>
16712 Mike Fedyk <mfedyk@mikefedyk.com>
16713 Pavel Machek <pavel@suse.cz>
16714 Petr Baudis <pasky@suse.cz>
16715 Phil Endecott <phil_vonar_endecott@chezphil.org>
16716 Rob Landley <rob@landley.net>
16717 Sam Varshavchik <mrsam@courier-mta.com>
16718
16719 Apologies if I missed anyone!
16720
16721
16722 New and rewritten pages
16723 -----------------------
16724
16725 makedev.3
16726     Michael Kerrisk
16727         New page for makedev(), major(), and minor() macros
16728
16729 pthread_cleanup_push_defer_np.3
16730     Michael Kerrisk
16731         New page for pthread_cleanup_push_defer_np(3) and
16732         pthread_cleanup_pop_restore_np(3)
16733
16734
16735 Newly documented interfaces in existing pages
16736 ---------------------------------------------
16737
16738 accept.2
16739     Michael Kerrisk
16740         Document accept4() system call, new in Linux 2.6.28
16741
16742 fmemopen.3
16743     Petr Baudis
16744         Add description of open_wmemstream(3)
16745
16746 tcp.7
16747     Michael Kerrisk
16748         Document MSG_TRUNC flag for TCP sockets
16749
16750 New and changed links
16751 ---------------------
16752
16753 accept4.2
16754     Michael Kerrisk
16755         New link to accept.2
16756             accept.2 now documents the new accept4() system call.
16757
16758 open_wmemstream.3
16759     Petr Baudis
16760         New link to fmemopen.3
16761             fmemopen.3 now documents open_wmemstream().
16762 pthread_cleanup_pop_restore_np.3
16763     Michael Kerrisk
16764         New link to new pthread_cleanup_push_defer_np.3
16765
16766
16767 Global changes
16768 --------------
16769
16770 accept.2
16771 listen.2
16772 recv.2
16773 getpeername.2
16774 getsockname.2
16775 shutdown.2
16776 socketpair.2
16777     Michael Kerrisk
16778         Global fix: SEE ALSO: add socket(7)
16779
16780 bind.2
16781 rcmd.3
16782 capabilities.7
16783 ip.7
16784     Michael Kerrisk
16785         Global fix: s/reserved port/privileged port/
16786             Some pages used one term, some pages the other term;
16787             make some consistency.
16788
16789 connect.2
16790 getpeername.2
16791 getsockname.2
16792     Michael Kerrisk
16793         Use consistent argument names
16794             Most other sockets pages are using the names 'addr'
16795             and 'addrlen'; make these pages do the same.
16796
16797 getpeername.2
16798 getsockname.2
16799 getsockopt.2
16800 recv.2
16801 send.2
16802 shutdown.2
16803 sockatmark.3
16804 socket.7
16805 udplite.7
16806     Michael Kerrisk
16807         SYNOPSIS: Rename socket file descriptor argument to 'sockfd'
16808             Many sockets man pages use the name 'sockfd' already.
16809             For consistency, changes the others to do so as well.
16810
16811 gnu_dev_major.3
16812 gnu_dev_makedev.3
16813 gnu_dev_minor.3
16814 major.3
16815 minor.3
16816     Michael Kerrisk
16817         New links to new makedev(3) page
16818
16819
16820 Changes to individual pages
16821 ---------------------------
16822
16823 _exit.2
16824     Michael Kerrisk
16825         Since glibc 2.3, the exit() wrapper function invokes exit_group(2)
16826             This information is useful to users of strace(1).
16827
16828 accept.2
16829     Michael Kerrisk
16830         Clarify details when returned address is truncated
16831             If the returned address is truncated, the 'addrlen' argument
16832             indicates the actual size of the address, rather than a count
16833             of the number of bytes in the truncated buffer.
16834
16835             Also clarify that if 'addr' argument is NULL, then 'addrlen'
16836             should is unused, and should also be NULL.
16837     Michael Kerrisk
16838         Reorder ERRORS list
16839             Some errors were listed under a separate "may" heading.
16840             There's probably no real need to do this; integrate
16841             those errors into the main list.
16842
16843 exit_group.2
16844     Michael Kerrisk
16845         Note that since glibc 2.3, exit(2) invokes exit_group()
16846
16847 futex.2
16848     Michael Kerrisk
16849         Mention that glibc provides no wrapper function for futex()
16850
16851 get_thread_area.2
16852     Michael Kerrisk
16853         Note that glibc provides no wrapper for this system call
16854
16855 getdomainname.2
16856     Michael Kerrisk
16857         Substantial rewrite
16858             Expand description of setdomainname() and getdomainname().
16859             Note that getdomainname() is implemented as a library function
16860             in glibc.
16861             Note limits on size of domain name.
16862             Reorganize ERRORS list.
16863
16864 gethostname.2
16865     Michael Kerrisk
16866         Various parts rewritten
16867             Write a paragraph describing sethostname().
16868
16869             Clarify differences between glibc's gethostbyname() and
16870             the kernel gethostbyname() system calls.
16871
16872 gethostname.2
16873     Michael Kerrisk
16874         Note that HOST_NAME_MAX is 64 on Linux
16875             Also note that in pre-1.0 days, the limit on hostnames
16876             was 8 bytes.
16877
16878 getpeername.2
16879     Michael Kerrisk
16880         Note that returned address may be truncated if buffer is too small
16881
16882 getsid.2
16883     Michael Kerrisk
16884         Simplified version information and moved to a new VERSIONS section
16885
16886 getsockname.2
16887     Michael Kerrisk
16888         Note that returned address is truncated if buffer is too small
16889
16890 mknod.2
16891     Michael Kerrisk
16892         Refer reader to makedev(3) to build a device ID
16893
16894 mmap.2
16895     Michael Kerrisk
16896         Loosen language around how 'addr' hint is interpreted
16897             Mel Gorman reported that in Linux 2.6.27, 'addr' is rounded
16898             down to a page boundary.
16899
16900             Before kernel 2.6.26, if 'addr' was taken as a hint, it was
16901             rounded up to the next page boundary.  Since Linux 2.6.24,
16902             it is rounded down.  Therefore, loosen the description of
16903             this point to say that the address is rounded to "a nearby
16904             page boundary".
16905
16906 open.2
16907     Michael Kerrisk
16908         EFBIG error is now EOVERFLOW (since Linux 2.6.24)
16909             When a 32-bit app opens a file whose size is too big to be
16910             represented in 31-bits, POSIX.1 specifies the error EOVERFLOW.
16911             Linux used to give EFBIG for this case, but 2.6.24 fixed this.
16912
16913             Also, add some text to describe the error scenario in
16914             more detail.
16915
16916 pread.2
16917     Michael Kerrisk
16918         Note that glibc emulation for these calls uses lseek(2)
16919             (This makes it clearer that the emulated calls are not atomic.)
16920
16921 recv.2
16922 send.2
16923     Michael Kerrisk
16924         Make names of "address" and "address length" args more consistent
16925             Make the names of these arguments more consistent with other
16926             sockets man pages.
16927
16928 recv.2
16929     Michael Kerrisk
16930         Clarify details when returned address is truncated
16931             If the recvfrom() returned address is truncated, the 'fromlen'
16932             argument indicates the actual size of the address, rather than
16933             a count of the number of bytes in the truncated buffer.
16934
16935             Also clarify that the 'from' argument can be NULL, in which
16936             case 'fromlen' should is unused, and should also be NULL.
16937     Michael Kerrisk
16938         Internet datagram and netlink sockets support MSG_TRUNC for recv(2)
16939             Internet datagram (since Linux 2.4.27/2.6.8),
16940             and netlink (since Linux 2.6.22) sockets support
16941             the MSG_TRUNC flag for recv(2).
16942
16943 select.2
16944     Michael Kerrisk
16945         Rewrote text describing feature test macros requirement for pselect()
16946
16947 select_tut.2
16948     Michael Kerrisk
16949         Fix SHUT_FD* macros in example program
16950             Add "do {} while (0)"
16951
16952 set_thread_area.2
16953     Michael Kerrisk
16954         Note that glibc provides no wrapper for this system call
16955
16956 setfsgid.2
16957 setfsuid.2
16958     Michael Kerrisk
16959         Simplify version information and move to a VERSIONS section
16960
16961 setsid.2
16962     Michael Kerrisk
16963         Rework RETURN VALUE section; add an ERRORS section
16964
16965 setup.2
16966     Michael Kerrisk
16967         Relocate some CONFORMING TO text to VERSIONS and NOTES
16968
16969 stat.2
16970     Michael Kerrisk
16971         Document EOVERFLOW error
16972     Michael Kerrisk
16973         Refer reader to major() and minor() to decompose a device ID
16974
16975 syscalls.2
16976     Michael Kerrisk
16977         Fix version numbers for a few system calls
16978             Some 2.6 system calls were wrongly mentioned as also being
16979             backported into a 2.4.x kernel.
16980
16981 uname.2
16982     Michael Kerrisk
16983         DESCRIPTION: Point reader at NOTES for further info on field lengths
16984
16985 atan.3
16986     Andries E. Brouwer
16987         Fix return value description
16988             The correct range for the return value is [-pi/2,pi/2].
16989             (mtk's fix in the last change to the return value text was
16990             a botch-up of a (correct) suggestion by Nicolas François.)
16991
16992 atexit.3
16993     Michael Kerrisk
16994         atexit() and on_exit(3) register functions on the same list
16995     Michael Kerrisk
16996         Terminating registered function using longjmp() is undefined
16997             According to POSIX.1, using longjmp() to terminate execution of
16998             a function registered using atexit() produces undefined results.
16999     Michael Kerrisk
17000         Calling exit(3) more than once produces undefined results
17001             If an exit handler itself calls exit(3), the results are
17002             undefined (see the POSIX.1-2001 specification of exit(3)).
17003     Michael Kerrisk
17004         The same exit handler may be registered multiple times
17005     Michael Kerrisk
17006         Calling _exit(2) terminates processing of exit handlers
17007     Michael Kerrisk
17008         Terminating registered function using longjmp() is undefined
17009             According to POSIX.1, using longjmp() to terminate execution of
17010             a function registered using atexit() produces undefined results.
17011
17012 bindresvport.3
17013     Mats Wichmann
17014         SYNOPSIS: s/\*\*/*/ in prototype
17015     Michael Kerrisk
17016         Fix errors regarding port used, plus other rewrites
17017             Glibc's bindresvport() takes no notice of sin->sin_port:
17018             it always returns an arbitrary reserved port in the
17019             anonymous range (512-1023).  (Reported by Mats Wichmann.)
17020
17021             Also:
17022             * Add EADDRINUSE and EACCES errors.
17023             * Mention use of getsockname(2).
17024             * Other minor rewrites and reorderings of the text.
17025             * Explicitly note that glib's bindresvport() ignores
17026               sin->sin_port.
17027             * Change license There's now virtually no text remaining from
17028               the 1.70 version of this page.
17029
17030             Reviewed-by: Mats Wichmann
17031             Reviewed-by: Petr Baudis
17032
17033 dlopen.3
17034     Petr Baudis
17035         Describe confusing dladdr() behavior
17036             dladdr() will act unexpectedly if called from non-pic code on a
17037             compile-time-generated function pointer.
17038
17039 fmemopen.3
17040     Michael Kerrisk
17041         Add VERSIONS section
17042     Petr Baudis
17043         SEE OPEN: Add fopencookie(3)
17044             fopencookie(3) is used to implement fmemopen().
17045
17046 fopen.3
17047     Petr Baudis
17048         SEE ALSO: Add fmemopen(3) and fopencookie(3)
17049
17050 fopencookie.3
17051     Petr Baudis
17052         fopencookie() needs _GNU_SOURCE feature test macro
17053
17054 getaddrinfo.3
17055     Petr Baudis
17056         Document results ordering and /etc/gai.conf
17057             This patch documents the order of the getaddrinfo(3) results
17058             (RFC 3484), how should the application deal with that,
17059             mentions the extremely common cause of having multiple
17060             results per query (both IPv4 and IPv6 addresses available)
17061             and mentions /etc/gai.conf.
17062
17063             (mtk: Minor tweaks, and note glibc version for /etc/gai.conf)
17064
17065 isatty.3
17066     Michael Kerrisk
17067         Complete rewrite of this page, with rather more detail
17068
17069 memmem.3
17070     Michael Kerrisk
17071         Remove sentence saying that libc 5.0.9 is still widely used
17072             That was a *long* time ago.
17073
17074 on_exit.3
17075     Michael Kerrisk
17076         Document handling of registrations on fork(2) and execve(2)
17077             Treatment in these cases is the same as for atexit(3).
17078     Michael Kerrisk
17079         Arg given to registered function is status from *last* call to exit()
17080             It's a subtle point, but if a registered function itself
17081             calls exit(3), then subsequent functions that were registered
17082             with on_exit(3) will see the exit status given to the more
17083             recent exit(3) call.
17084     Michael Kerrisk
17085         Note that same function may be registered multiple times
17086
17087 setlocale.3
17088 locale.7
17089     Michael Kerrisk
17090         Clean up the description of LANGUAGE environment variable
17091             Clean up the $LANGUAGE description, by removing bogus comments
17092             from setlocale(3) and expanding the mention in locale(7).
17093
17094             Maybe you will decide that a more detailed description
17095             should be left to the gettext(3) documentation, but I
17096             actually care about the invisible part of the patch more
17097             since the comments have put me off the track initially
17098             ($LANGUAGE has nothing to do with setlocale(3) and is
17099              completely isolated to gettext, as obvious from the
17100              glibc sources).
17101
17102 proc.5
17103     Michael Kerrisk
17104         /proc/stat: s/minor/disk_idx/ in description of /proc/stat
17105             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=225619
17106
17107 capabilities.7
17108     Drake Wilson
17109         Various minor fixes as per Debian bug 471029
17110             The relevant pieces of
17111             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=471029 are:
17112
17113               - Delete duplicate subentry for KEYCTL_CHOWN/KEYCTL_SETPERM
17114                 operations in the CAP_SYS_ADMIN entry.  (It feels like that
17115                 capability entry should be converted to a list, but I've
17116                 left it in semicolon-delimited form for now.)
17117
17118               - Remove text about ENFILE from the text about the
17119                 /proc/sys/fs/file-max limit in the CAP_SYS_ADMIN entry, since
17120                 this is already described in the man pages for the relevant
17121                 ofile-creating system calls.
17122
17123               - Correct or clarify a few other bits of grammar and such;
17124                 see the diff file itself for details.
17125
17126 socket.7
17127     Michael Kerrisk
17128         SEE ALSO: add tcp(7) and udp(7)
17129
17130 tcp.7
17131     Michael Kerrisk
17132         Relocate out-of-band data discussion
17133             Move to a new subsection entitled "Sockets API".
17134     Michael Kerrisk
17135         Note that MSG_PEEK can be used on out-of-band data
17136
17137 time.7
17138     Michael Kerrisk
17139         SEE ALSO: add clock_gettime(3)
17140
17141 unix.7
17142     Michael Kerrisk
17143         Unix domain sockets don't support the recv() MSG_TRUNC flag
17144     Michael Kerrisk
17145         Retitled subsection "(Un)supported features" to "Sockets API"
17146             This is consistent with the recent change in tcp(7).
17147
17148
17149
17150 ==================== Changes in man-pages-3.16 ====================
17151
17152 Released: 2009-01-13, Christchurch
17153
17154
17155 Contributors
17156 ------------
17157
17158 The following people contributed notes, ideas, or patches that have
17159 been incorporated in changes in this release:
17160
17161 Colin Watson <cjwatson@ubuntu.com>
17162 Florentin Duneau <fduneau@gmail.com>
17163 Petr Baudis <pasky@suse.cz>
17164
17165 Apologies if I missed anyone!
17166
17167
17168 New and rewritten pages
17169 -----------------------
17170
17171 pthread_getcpuclockid.3
17172     Michael Kerrisk
17173         New page documenting pthread_getcpuclockid(3)
17174
17175 libc.7
17176     Michael Kerrisk
17177         New page giving brief overview of C libraries on Linux
17178
17179 rtld-audit.7
17180     Michael Kerrisk
17181         New page documenting dynamic linker auditing API
17182
17183
17184 Newly documented interfaces in existing pages
17185 ---------------------------------------------
17186
17187 ld.so.8
17188     Petr Baudis
17189         Document LD_AUDIT
17190     Petr Baudis
17191         Document LD_POINTER_GUARD
17192
17193
17194 New and changed links
17195 ---------------------
17196
17197 gethostid.2
17198     Michael Kerrisk
17199         New link to new page location in Section 3
17200
17201 sethostid.2
17202     Michael Kerrisk
17203         Change link to point to new page location in Section 3
17204
17205 sethostid.3
17206     Michael Kerrisk
17207         New link to relocated page in Section 3
17208
17209 glibc.7
17210     Michael Kerrisk
17211         New link to new libc.7
17212
17213
17214 Global changes
17215 --------------
17216
17217 syscalls.2
17218 feature_test_macros.7
17219 standards.7
17220     Michael Kerrisk
17221         SEE ALSO: add libc(7)
17222
17223 dlopen.3
17224 ld.so.8
17225     Michael Kerrisk
17226         SEE ALSO: add rtld-audit(7)
17227
17228
17229 Changes to individual pages
17230 ---------------------------
17231
17232 gethostid.2
17233     Michael Kerrisk
17234         Move to Section 3
17235             The interfaces documented in this page are purely glibc.
17236
17237 syscalls.2
17238     Michael Kerrisk
17239         Kernel 2.6.28 adds accept4()
17240
17241 clock_getres.3
17242     Michael Kerrisk
17243         SEE ALSO: Add pthread_getcpuclockid(3)
17244
17245 fmemopen.3
17246     Michael Kerrisk
17247         Fix VERSIONS information
17248
17249 gethostid.3
17250     Michael Kerrisk
17251         Before version 2.2, glibc stored the host ID in /var/adm/hostid
17252             Also: rewrite some text describing the /etc/hostid file, so that
17253             this location is referred to just once on the page.
17254     Michael Kerrisk
17255         RETURN VALUE: describe return value of sethostid()
17256     Michael Kerrisk
17257         Added BUGS section noting that ID can't be guaranteed to be unique
17258     Michael Kerrisk
17259         Added ERRORS section describing errors for sethostid()
17260     Michael Kerrisk
17261         Update section number to reflect relocation into Section 3
17262
17263 printf.3
17264     Michael Kerrisk
17265         Source and destination buffers may not overlap for *s*printf()
17266             http://sourceware.org/bugzilla/show_bug.cgi?id=7075
17267
17268             Some existing code relies on techniques like the following to
17269             append text to a buffer:
17270
17271                 $ cat s.c
17272                 #include <stdio.h>
17273                 char buf[80] = "not ";
17274                 main()
17275                 {
17276                     sprintf(buf, "%sfail", buf);
17277                 puts(buf);
17278                 return 0;
17279                 }
17280
17281                 $ cc s.c
17282                 $ ./a.out
17283                 not fail
17284
17285             However, the standards say the results are undefined if source
17286             and destination buffers overlap, and with suitable compiler
17287             options, recent changes can cause unexpected results:
17288
17289                 $ cc -v 2>&1 | grep gcc
17290                 gcc version 4.3.1 20080507 (prerelease) [gcc-4_3-branch revision 135036] (SUSE Linux)
17291                 $ cc -D_FORTIFY_SOURCE -O2 s.c
17292                 $ ./a.out
17293                 fail
17294
17295 readdir.3
17296     Michael Kerrisk
17297         Rewrite text describing 'dirent' fields standardized in POSIX.1
17298     Michael Kerrisk
17299         Clarify text for return value/errno setting for end-of-stream case
17300
17301 nscd.8
17302     Petr Baudis
17303         Correct NOTES section on reloading configuration files
17304             It behaved this way at least since
17305             "Sun Oct 18 15:02:11 1998 +0000",
17306             some four months after including the nscd implementation
17307             in glibc. But there does seem to be a short window between
17308             glibc-2.1 and glibc-2.1.3 when nscd -i was not available,
17309             I don't think it's worth muddling the point of the page
17310             with that, though.
17311
17312
17313 ==================== Changes in man-pages-3.17 ====================
17314
17315 Released: 2009-01-19, Hobart
17316
17317
17318 Contributors
17319 ------------
17320
17321 The following people contributed notes, ideas, or patches that have
17322 been incorporated in changes in this release:
17323
17324 Adeodato Simó <dato@net.com.org.es>
17325 Bastien ROUCARIES <roucaries.bastien@gmail.com>
17326 Davide Libenzi <davidel@xmailserver.org>
17327 Lefteris Dimitroulakis <edimitro@tee.gr>
17328 Mads Martin Joergensen <mmj@mmj.dk>
17329 Marc Lehmann <schmorp@schmorp.de>
17330 Martin (Joey) Schulze <joey@infodrom.org>
17331 Michael Kerrisk <mtk.manpages@gmail.com>
17332 Petr Baudis <pasky@suse.cz>
17333 Sam Varshavchik <mrsam@courier-mta.com>
17334 Vegard Nossum <vegard.nossum@gmail.com>
17335
17336 Apologies if I missed anyone!
17337
17338
17339 New and rewritten pages
17340 -----------------------
17341
17342 endian.3
17343     Michael Kerrisk
17344         New page documenting byte order conversion functions
17345             Document functions (new in glibc 2.9) for conversion between
17346             host byte order and big-/little- endian byte order:
17347             htobe16(), htole16(), be16toh(), le16toh(),
17348             htobe32(), htole32(), be32toh(), le32toh(),
17349             htobe64(), htole64(), be64toh(), le64toh()
17350
17351 getifaddrs.3
17352     Petr Baudis
17353         New page documenting getifaddrs(3) and freeifaddrs(3)
17354             Many edits and changes of Petr's initial draft by mtk
17355
17356 cp1251.7
17357     Lefteris Dimitroulakis
17358         New page documenting CP 1251 (Windows Cyrillic) character set
17359
17360 iso-8859-10.7
17361     Lefteris Dimitroulakis
17362         New page documenting ISO 8859-10 character set
17363
17364 iso_8859-13.7
17365     Lefteris Dimitroulakis
17366         New page documenting ISO 8859-13 character set
17367
17368 iso_8859-14.7
17369     Lefteris Dimitroulakis
17370         New page documenting ISO 8859-14 character set
17371
17372 iso_8859-3.7
17373     Lefteris Dimitroulakis
17374         New page documenting ISO 8859-3 character set
17375
17376 iso_8859-5.7
17377     Lefteris Dimitroulakis
17378         New page documenting ISO 8859-5 character set
17379
17380 iso_8859-8.7
17381     Lefteris Dimitroulakis
17382         New page documenting ISO 8859-8 character set
17383
17384 koi8-u.7
17385     Lefteris Dimitroulakis
17386         New page documenting KOI8-U character set
17387
17388
17389 Newly documented interfaces in existing pages
17390 ---------------------------------------------
17391
17392 epoll.7
17393     Michael Kerrisk
17394         Document /proc interfaces for limiting kernel memory usage
17395             Document the following /proc files that were added in
17396             Linux 2.6.28:
17397             /proc/sys/fs/epoll/max_user_instances
17398             /proc/sys/fs/epoll/max_user_watches
17399
17400 netdevice.7
17401     Michael Kerrisk
17402         Document recently added interface flags
17403             IFF_LOWER_UP (since Linux 2.6.17)
17404             IFF_DORMANT (since Linux 2.6.17)
17405             IFF_ECHO (since Linux 2.6.25)
17406
17407             Documentation taken from comments in <linux/if.h>
17408
17409
17410 New and changed links
17411 ---------------------
17412
17413 freeifaddrs.3
17414     Michael Kerrisk
17415         New link to new getifaddrs.3
17416
17417 htobe16.3
17418 htole16.3
17419 be16toh.3
17420 le16toh.3
17421 htobe32.3
17422 htole32.3
17423 be32toh.3
17424 le32toh.3
17425 htobe64.3
17426 htole64.3
17427 be64toh.3
17428 le64toh.3
17429     Michael Kerrisk
17430         New links to new endian.3
17431
17432 iso-8859-10.7
17433 iso_8859_10.7
17434 latin6.7
17435     Michael Kerrisk
17436         New links to new iso_8859-10.7
17437
17438 iso-8859-13.7
17439 iso_8859_13.7
17440 latin7.7
17441     Michael Kerrisk
17442         New links to new iso_8859-13.7
17443
17444 iso-8859-14.7
17445 iso_8859_14.7
17446 latin8.7
17447     Michael Kerrisk
17448         New links to new iso_8859-14.7
17449
17450 iso-8859-3.7
17451 iso_8859_3.7
17452 latin3.7
17453     Michael Kerrisk
17454         New links to new iso_8859-3.7
17455
17456 iso-8859-5.7
17457 iso_8859_5.7
17458     Michael Kerrisk
17459         New links to new iso_8859-5.7
17460
17461 iso-8859-8.7
17462 iso_8859_8.7
17463     Michael Kerrisk
17464         New links to new iso_8859-8.7
17465
17466
17467 Changes to individual pages
17468 ---------------------------
17469
17470 bind.2
17471     Michael Kerrisk
17472         SEE ALSO: Add getifaddrs(3)
17473
17474 epoll_create.2
17475     Michael Kerrisk
17476         Document EMFILE error
17477             This error is encountered when the limit imposed by
17478             /proc/sys/fs/epoll/max_user_instances is encountered.
17479     Michael Kerrisk
17480         Clarify distinction between epoll instance and epoll file descriptor
17481             Reword so that the notion of an epoll instance is made clear,
17482             and made distinct from the notion of an epoll file descriptor.
17483             Some other minor rewordings also.
17484
17485 epoll_ctl.2
17486     Michael Kerrisk
17487         Reordered parts of the text
17488     Michael Kerrisk
17489         Introduce notion of epoll instance
17490             Introduce notion of epoll instance as distinct from
17491             epoll file descriptor.  Plus other wording clean-ups.
17492     Michael Kerrisk
17493         Document ENOSPC error (new in Linux 2.6.28)
17494             This error results when the limit imposed by
17495             /proc/sys/fs/epoll/max_user_watches is encountered.
17496
17497 epoll_wait.2
17498     Michael Kerrisk
17499         Introduce the notion of an epoll instance into text
17500
17501 getdents.2
17502     Michael Kerrisk
17503         Before kernel < 2.6.4, 'd_type' was effectively always DT_UNKNOWN
17504
17505 gethostid.2
17506     Michael Kerrisk
17507         Rename file (was misnamed gethostd.2 in previous release)
17508
17509 getsockname.2
17510     Michael Kerrisk
17511         SEE ALSO: Add getifaddrs(3)
17512
17513 signalfd.2
17514     Michael Kerrisk
17515         Fix description of fork() semantics
17516             The page text described the semantics of the initial
17517             implementation of signalfd().  These were changed early on,
17518             but the man page wasn't updated.
17519
17520 byteorder.3
17521     Michael Kerrisk
17522         SEE ALSO: add endian(3)
17523
17524 longjmp.3
17525     Michael Kerrisk
17526         Clarify wording re saving/restoring signal mask
17527     Michael Kerrisk
17528         siglongjmp() restores signal mask iff 'savesigs' was non-zero
17529             Note that siglongjmp() restores signal mask if, and only
17530             if, 'savesigs' argument of sigsetjmp() was non-zero.  (Previous
17531             text omitted the "and only if".)
17532
17533 memccpy.3
17534     Michael Kerrisk
17535         Fix CONFORMING TO: s/C99/POSIX.1-2001/
17536     Michael Kerrisk
17537         If the memory areas overlap, the results are undefined
17538
17539 sethostid.3
17540     Michael Kerrisk
17541         Rename file (was misnamed sethostd.3 in previous release)
17542
17543 setjmp.3
17544     Michael Kerrisk
17545         Clarify wording re saving/restoring signal mask
17546     Michael Kerrisk
17547         Clarify when setjmp() provides BSD vs System V signal mask semantics
17548
17549 strsep.3
17550     Michael Kerrisk
17551         BUGS: explicitly list problems afflicting strsep()
17552             Previously, the page said this function suffered the same
17553             problems as strtok(), but in fact strsep() doesn't suffer
17554             from all of the same problems as strtok(), so explicitly
17555             list just the problems of strsep() in the strsep.3 page.
17556
17557 proc.5
17558     Michael Kerrisk
17559         Add pointer to epoll(7) for description of epoll /proc files
17560
17561 epoll.7
17562     Michael Kerrisk
17563         Various wording changes to improve clarity and consistency
17564
17565
17566 ==================== Changes in man-pages-3.18 ====================
17567
17568 Released: 2009-02-10, Christchurch
17569
17570
17571 Contributors
17572 ------------
17573
17574 The following people contributed notes, ideas, or patches that have
17575 been incorporated in changes in this release:
17576
17577 Andi Kleen <andi@firstfloor.org>
17578 Bastien ROUCARIES <roucaries.bastien@gmail.com>
17579 Christian Siebert <christian.siebert@s2000.tu-chemnitz.de>
17580 Christopher Head <chead@telus.net>
17581 Florentin Duneau <fduneau@gmail.com>
17582 Guillem Jover <guillem@debian.org>
17583 Lefteris Dimitroulakis <edimitro@tee.gr>
17584 Lucio Maciel <luciofm@gmail.com>
17585 Michael Kerrisk <mtk.manpages@gmail.com>
17586 Mike Frysinger <vapier@gentoo.org>
17587 Peter Zijlstra <peterz@infradead.org>
17588 Petr Baudis <pasky@suse.cz>
17589 Sam Varshavchik <mrsam@courier-mta.com>
17590 Satyam Sharma <ssatyam@cse.iitk.ac.in>
17591 Sebastian Kienzl <seb@riot.org>
17592 Timo Sirainen <tss@iki.fi>
17593 Vegard Nossum <vegard.nossum@gmail.com>
17594
17595 Apologies if I missed anyone!
17596
17597
17598 New and rewritten pages
17599 -----------------------
17600
17601 armscii-8.7
17602     Lefteris Dimitroulakis
17603         New page documenting ArmSCII-8 character set
17604
17605 iso_8859-11.7
17606     Lefteris Dimitroulakis
17607         New page documenting ISO 8859-11 character set
17608
17609 iso_8859-4.7
17610     Lefteris Dimitroulakis
17611         New page documenting ISO 8859-4 character set
17612
17613 iso_8859-6.7
17614     Lefteris Dimitroulakis
17615         New page describing ISO 8859-6 character set
17616
17617 pthread_kill.3
17618     Michael Kerrisk
17619         New page documenting pthread_kill(3)
17620
17621 pthread_kill_other_threads_np.3
17622     Michael Kerrisk
17623         New page documenting pthread_kill_other_threads_np(3)
17624
17625 pthread_sigmask.3
17626     Michael Kerrisk
17627         New page documenting pthread_sigmask(3)
17628
17629
17630 Newly documented interfaces in existing pages
17631 ---------------------------------------------
17632
17633 clock_getres.3
17634     Michael Kerrisk
17635         Document CLOCK_MONOTONIC_RAW, new in 2.6.28
17636
17637
17638 New and changed links
17639 ---------------------
17640
17641 clock_gettime.2
17642 clock_settime.2
17643 clock_getres.3
17644 clock_gettime.3
17645 clock_settime.3
17646     Michael Kerrisk
17647         Update links to reflect the fact that clock_* pages are now in
17648         Section 2
17649
17650 iso-8859-11.7
17651 iso_8859_11.7
17652     Michael Kerrisk
17653         New links to new iso_8859-11.7
17654
17655 iso-8859-4.7
17656 iso_8859_4.7
17657 latin4.7
17658     Michael Kerrisk
17659         New links to new iso_8859-4.7
17660
17661 iso-8859-6.7
17662 iso_8859_6.7
17663     Michael Kerrisk
17664         New links to new iso_8859-6.7
17665
17666 tis-620.7
17667     Michael Kerrisk
17668         New link to new iso_8859-11.7
17669
17670
17671 Global changes
17672 --------------
17673
17674 clock_nanosleep.2
17675 getrusage.2
17676 timerfd_create.2
17677 clock.3
17678 clock_getcpuclockid.3
17679 ftime.3
17680 pthread_create.3
17681 pthread_getcpuclockid.3
17682 pthread_tryjoin_np.3
17683 sem_wait.3
17684 time.7
17685     Michael Kerrisk
17686         Global fix: Fix xrefs to clock_*.? pages to reflect move to section 2
17687
17688 clock_nanosleep.2
17689 execve.2
17690 fork.2
17691 nanosleep.2
17692 sigaction.2
17693 timerfd_create.2
17694 pthread_getcpuclockid.3
17695 ualarm.3
17696 usleep.3
17697 pthreads.7
17698 time.7
17699     Michael Kerrisk
17700         Global fix: s/(3)/(2)/ in section number xrefs for timer_*() API
17701             The POSIX timers API is implemented (mostly) within the kernel,
17702             so thse interfaces are system calls.  Although there are as yet
17703             no man pages, when they are added they should be in Section 2,
17704             not 3.  Therefore fix those pages that currently refer to these
17705             interfaces as being in Section 3.
17706
17707
17708 Changes to individual pages
17709 ---------------------------
17710
17711 capget.2
17712     Andi Kleen
17713         Add some details and relocate a paragraph
17714             While writing a little program using capset
17715             I found the capset manpage quite light on crucial
17716             details and I had to resort to RTFS.
17717
17718             This patch improves the points I found unclear
17719             and also moves one misplaced paragraph around.
17720
17721 clock_getres.2
17722     Michael Kerrisk
17723         Move page from Section 3 to Section 2
17724
17725 eventfd.2
17726     Michael Kerrisk
17727         glibc eventfd() supports the use of eventfd2() since version 2.9
17728
17729 fork.2
17730     Michael Kerrisk
17731         SEE ALSO: add daemon(3)
17732
17733 getdents.2
17734     Michael Kerrisk
17735         Remove unneeded HAVE_D_TYPE from example program
17736             Since d_type will always just return DT_UNKNOWN before
17737             kernel 2.6.4, we don't need to use a conditional for
17738             determining whether we use this flag.
17739
17740 nanosleep.2
17741     Michael Kerrisk
17742         Relocated misplaced BUGS heading
17743
17744 select_tut.2
17745     Michael Kerrisk
17746         Clean up error checking in example program (no semantic changes)
17747     Michael Kerrisk
17748         Many parts tidied and rewritten
17749             Remove some redundant text, clarify various pieces,
17750             tidy example code, etc.
17751     Michael Kerrisk
17752         Bug fixes + rewrites in example program
17753             Sebastien pointed out that the first example program
17754             wrongly thinks it can count signals.
17755             Also, some further rewrites by mtk.
17756
17757 socket.2
17758     Michael Kerrisk
17759         BUGS: Remove discussion SOCK_UUCP
17760             As time goes on, this sentence becomes less a piece of humor,
17761             and more a puzzle.
17762
17763 stat.2
17764     Michael Kerrisk
17765         Note that open(O_NOATIME) also causes st_atime not to be updated
17766
17767 timerfd_create.2
17768     Michael Kerrisk
17769         Add BUGS noting that timerfd supports fewer clock types than
17770         timer_create()
17771
17772 btowc.3
17773     Michael Kerrisk
17774         SEE ALSO: add wctob(3)
17775
17776 clock_getcpuclockid.3
17777     Michael Kerrisk
17778         SEE ALSO: add pthread_getcpuclockid(3)
17779
17780 cos.3
17781     Michael Kerrisk
17782         SEE ALSO: add sincos(3)
17783
17784 fexecve.3
17785     Timo Sirainen
17786         Note that fexecve() depends on a mounted /proc
17787             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514043
17788     Michael Kerrisk
17789         CONFORMING TO: note addition of fexecve() in POSIX.1-2008
17790     Michael Kerrisk
17791         'fd' must be opened read-only and refer to a file that is executable
17792
17793 fmemopen.3
17794     Michael Kerrisk
17795         CONFORMING TO: note that these functions are in POSIX.1-2008
17796
17797 getifaddrs.3
17798     Lucio Maciel
17799         Fix memory leak in example program
17800     Petr Baudis
17801         Various small fixes
17802
17803 getpwnam.3
17804     Michael Kerrisk
17805         SEE ALSO: add getspnam(3)
17806
17807 getumask.3
17808     Michael Kerrisk
17809         Updated glibc version number in NOTES
17810
17811 ilogb.3
17812     Michael Kerrisk
17813         SEE ALSO: add significand(3)
17814
17815 intro.3
17816     Michael Kerrisk
17817         SEE ALSO: add libc(7)
17818
17819 isalpha.3
17820     Michael Kerrisk
17821         Fix statement that isalpa() is obsolete; should be isascii()
17822             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=512709
17823     Michael Kerrisk
17824         SEE ALSO: add toascii(3)
17825
17826 mq_notify.3
17827     Michael Kerrisk
17828         Add cross reference to pthread_attr_init(3)
17829
17830 pthread_attr_setaffinity_np.3
17831     Michael Kerrisk
17832         SYNOPSIS: Fix declaration of 'attr'
17833
17834 pthread_getcpuclockid.3
17835     Michael Kerrisk
17836         SYNOPSIS: fix type of 'thread'
17837
17838 qsort.3
17839     Michael Kerrisk
17840         EXAMPLE: remove unnecessary "#include <unistd.h>"
17841
17842 random.3
17843     Michael Kerrisk
17844         SEE ALSO: add random_r(3)
17845
17846 remainder.3
17847     Michael Kerrisk
17848         SEE ALSO: add div(3)
17849
17850 scandir.3
17851     Michael Kerrisk
17852         CONFORMING TO: alphasort() and scandir() are added to POSIX.1-2008
17853     Michael Kerrisk
17854         CONFORMING TO: note that versionsort() was added to glibc in
17855         version 2.1
17856
17857 sem_wait.3
17858     Michael Kerrisk
17859         SEE ALSO: add clock_gettime(2)
17860
17861 significand.3
17862     Michael Kerrisk
17863         Add CONFORMING TO noting that this function is unstandardized
17864
17865 sigwait.3
17866     Michael Kerrisk
17867         Add EXAMPLES section referring to pthread_sigmask(3)
17868
17869 sin.3
17870     Michael Kerrisk
17871         SEE ALSO: add sincos(3)
17872
17873 stpcpy.3
17874     Michael Kerrisk
17875         Add BUGS section noting the possibility of buffer overruns
17876     Michael Kerrisk
17877         Add missing pieces/fix various problems in example program
17878     Michael Kerrisk
17879         CONFORMING TO: stpcpy() is nowadays on the BSDs
17880     Michael Kerrisk
17881         SEE ALSO: add stpcpy.3
17882
17883 wcscasecmp.3
17884     Michael Kerrisk
17885         CONFORMING TO: note that this function is added in POSIX.1-2008
17886
17887 wcsdup.3
17888     Michael Kerrisk
17889         CONFORMING TO: note that this function was added in POSIX.1-2008
17890
17891 wcsncasecmp.3
17892     Michael Kerrisk
17893         CONFORMING TO: note that this function is added in POSIX.1-2008
17894
17895 wctob.3
17896     Michael Kerrisk
17897         SEE ALSO: add btowc(3)
17898
17899 proc.5
17900     Michael Kerrisk
17901         Remove mention of epoll/max_user_instances
17902             (Since this interface appeared in 2.6.28, and then
17903             disappeared in 2.6.29.)
17904
17905 ascii.7
17906     Michael Kerrisk
17907         Update SEE ALSO list to include pages added in 3.17
17908     Michael Kerrisk
17909         SEE ALSO: add recently added iso_8859-*(7) pages
17910
17911 epoll.7
17912     Michael Kerrisk
17913         remove documentation of /proc/sys/fs/epoll/max_user_instances
17914             This /proc interface appeared in 2.6.28. but will be
17915             removed in 2.6.29.
17916
17917             Also, document change in default value of
17918             /proc/sys/fs/epoll/max_user_watches (was 1/32 of lowmem,
17919             now 1/25 of lowmem).
17920
17921 koi8-r.7
17922     Michael Kerrisk
17923         SEE ALSO: add koi8-u(7); remove crufty text
17924
17925 standards.7
17926     Michael Kerrisk
17927         Update to note that latest POSIX/SUS was ratified in 2008
17928
17929 time.7
17930     Michael Kerrisk
17931         SEE ALSO: add pthread_getcpuclockid(3)
17932
17933
17934 ==================== Changes in man-pages-3.19 ====================
17935
17936 Released: 2009-02-20, Putaruru
17937
17938
17939 Contributors
17940 ------------
17941
17942 The following people contributed notes, ideas, or patches that have
17943 been incorporated in changes in this release:
17944
17945 Christian Siebert <christian.siebert@gmail.com>
17946 Jan Engelhardt <jengelh@medozas.de>
17947 Jens Thoms Toerring <jt@toerring.de>
17948 Kir Kolyshkin <kir@openvz.org>
17949 Mark Hills <mark@pogo.org.uk>
17950 Michael Kerrisk <mtk.manpages@gmail.com>
17951 Parag Warudkar <parag.lkml@gmail.com>
17952 Peter Zijlstra <a.p.zijlstra@chello.nl>
17953 Sami Liedes <sliedes@cc.hut.fi>
17954
17955 Apologies if I missed anyone!
17956
17957
17958 New and rewritten pages
17959 -----------------------
17960
17961 timer_create.2
17962     Michael Kerrisk
17963         New page documenting timer_create(2)
17964
17965 timer_delete.2
17966     Michael Kerrisk
17967         New page documenting timer_delete(2)
17968
17969 timer_getoverrun.2
17970     Michael Kerrisk
17971         New page documenting timer_getoverrun(2)
17972
17973 timer_settime.2
17974     Michael Kerrisk
17975         New page documenting timer_settime(2) and timer_gettime(2)
17976
17977
17978 New and changed links
17979 ---------------------
17980
17981 timer_gettime.2
17982     Michael Kerrisk
17983         New link to new timer_settime.2
17984
17985
17986 Global changes
17987 --------------
17988
17989 Various pages
17990     Kir Kolyshkin
17991         Trivial punctuation fixes in SEE ALSO
17992             In SEE ALSO, when a few man pages are referenced, those
17993             are divided by commas.  Every reference is on a separate
17994             line, and all lines but the last one should end with
17995             comma. I spotted one place where there is no comma in
17996             between references, and mocked up an awk script to find
17997             similar places:
17998
17999             for f in man*/*; do
18000                 awk '
18001                     /^.SH ["]SEE ALSO["]/ {
18002                         sa=1; print "== " FILENAME " =="; print; next
18003                     }
18004                     /^\.(PP|SH)/ {
18005                         sa=0; no=0; next
18006                     }
18007                     /^\.BR/ {
18008                         if (sa==1) {
18009                             print;
18010                             if (no == 1)
18011                                 print "Missing comma in " FILENAME " +" FNR-1; no=0
18012                         }
18013                     }
18014                     /^\.BR .*)$/ {
18015                         if (sa==1)
18016                             no=1;
18017                         next
18018                     }
18019                     /\.\\"/ {next}
18020                     /.*/ {
18021                         if (sa==1) {
18022                             print; next
18023                         }
18024                     }
18025                 ' $f;
18026             done | fgrep 'Missing comma'
18027
18028             This patch fixes all the places found by the above script.
18029
18030             Also, there is an extra dot at the end of uri.7 "SEE ALSO"
18031             section.  Removed as per man-pages(7) recommendation.
18032
18033
18034 Changes to individual pages
18035 ---------------------------
18036
18037 getitimer.2
18038 clock_getcpuclockid.3
18039 time.7
18040     Michael Kerrisk
18041         SEE ALSO: add timer_create(2)
18042
18043 getitimer.2
18044     Michael Kerrisk
18045         Rename arguments for consistency with other timer pages
18046             Also some other minor wording improvements
18047
18048 splice.2
18049     Mark Hills
18050         ERRORS: Add EINVAL case for file opened O_APPEND
18051             Target file cannot be opened in append (O_APPEND) mode
18052
18053             In kernels prior to v2.6.27 splice() to a file in
18054             append mode is broken, and since that version it is
18055             disallowed. It is possible this behaviour may change
18056             in the future; see the kernel commit message
18057             (efc968d450e013049a662d22727cf132618dcb2f) for more
18058             information.
18059
18060 syscalls.2
18061     Michael Kerrisk
18062         Note that getpmsg(2) and putmsg(2) are unimplemented
18063             See See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514771
18064
18065 timerfd_create.2
18066     Michael Kerrisk
18067         ERRORS: add EFAULT
18068
18069 timerfd_create.2
18070     Michael Kerrisk
18071         Rename timerfd_settime() 'curr_value' arg to 'old_value'
18072             For consistency with related pages.
18073
18074 vm86.2
18075     Parag Warudkar
18076         CONFORMING TO: Add 32-bit specific
18077             Note that this call is only on *32-bit* Intel
18078
18079 mq_open.3
18080     Michael Kerrisk
18081         ERRORS: add ENOENT error for name == "/"
18082
18083 mq_open.3
18084     Michael Kerrisk
18085         ERRORS: Add EACCES error for name containing > 1 slash
18086
18087 sem_open.3
18088     Michael Kerrisk
18089         ERRORS: add EINVAL error where name == "/"
18090
18091 sem_open.3
18092     Jens Thoms Toerring
18093         Add case of non-well-formed name to ENOENT
18094
18095 shm_open.3
18096     Michael Kerrisk
18097         Clarify rules for construction of shared memory object names
18098
18099 proc.5
18100     Michael Kerrisk
18101         Add description of /proc/sys/kernel/sysrq
18102             Reported by: Goerghe Cosorea <gheorghe.coserea@gmail.com>
18103
18104 proc.5
18105     Michael Kerrisk
18106         Put /proc/modules entry in correct alphabetical order
18107
18108 ascii.7
18109     Kir Kolyshkin
18110         Fix formatting of tables on second page to use monospaced font
18111
18112 mq_overview.7
18113     Michael Kerrisk
18114         Clarify construction rules for message queue object names
18115
18116 sem_overview.7
18117     Michael Kerrisk
18118         Clarify construction rules for semaphore object names
18119             See also http://groups.google.com/group/comp.os.linux.development.apps/browse_thread/thread/b4a67caa765cb65f
18120
18121
18122
18123 ==================== Changes in man-pages-3.20 ====================
18124
18125 Released: 2009-03-31, Christchurch
18126
18127
18128 Contributors
18129 ------------
18130
18131 The following people contributed notes, ideas, or patches that have
18132 been incorporated in changes in this release:
18133
18134 Alan Curry <pacman@kosh.dhis.org>
18135 Américo Wang <xiyou.wangcong@gmail.com>
18136 Andi Kleen <andi@firstfloor.org>
18137 Carlos O'Donell <carlos@systemhalted.org>
18138 Chunming Chang <cchang@aerohive.com>
18139 Colin Watson <cjwatson@debian.org>
18140 Eelco Dolstra <e.dolstra@tudelft.nl>
18141 Jan Engelhardt <jengelh@medozas.de>
18142 Jens Thoms Toerring <jt@toerring.de>
18143 Johannes Stezenbach <js@sig21.net>
18144 Leandro A. F. Pereira <leandro@tia.mat.br>
18145 Martin Gebert <martin.gebert@alpha-bit.de>
18146 Michael Kerrisk <mtk.manpages@gmail.com>
18147 Mike O'Connor <stew@vireo.org>
18148 Mike Frysinger <vapier@gentoo.org>
18149 Nikanth Karthikesan <knikanth@suse.de>
18150 Reuben Thomas <rrt@femur.dyndns.org>
18151 Reuben Thomas <rrt@sc3d.org>
18152 Roland McGrath <roland@redhat.com>
18153 Sam Varshavchik <mrsam@courier-mta.com>
18154 Simon Gomizelj <simongmzlg@gmail.com>
18155 Tanaka Akira <akr@fsij.org>
18156 Teddy Hogeborn <teddy@fukt.bsnet.se>
18157 Walter Jontofsohn <wjontofs@atriumberlin.de>
18158
18159 Apologies if I missed anyone!
18160
18161
18162 New and rewritten pages
18163 -----------------------
18164
18165 cpuid.4
18166     Andi Kleen
18167         New page for cpuid access device
18168
18169 msr.4
18170     Andi Kleen
18171         New page documenting x86 CPU MSR access device
18172
18173
18174 Newly documented interfaces in existing pages
18175 ---------------------------------------------
18176
18177 proc.5
18178     Américo Wang
18179         Document /proc/sys/vm/swappiness
18180     Michael Kerrisk
18181         Document /proc/sysrq-trigger
18182
18183
18184 Global changes
18185 --------------
18186
18187 timer_create.2
18188 timer_delete.2
18189 timer_getoverrun.2
18190 timer_settime.2
18191 numa.7
18192     Michael Kerrisk
18193         Make source layout of 'Link with' text consistent with other pages
18194             No actual change to formatted output, but this makes the
18195             page sources more consistent for the purpose of grepping, etc.
18196
18197 mempcpy.3
18198 signbit.3
18199 significand.3
18200     Michael Kerrisk
18201         Global fix: acknowledge FSF in copyright
18202             These pages are heavily based on original material in
18203             glibc info pages, but the comments in the source of the pages
18204             did not acknowledge the FSF copyright on the original material.
18205             Fix that.
18206
18207 accept.2
18208 read.2
18209 recv.2
18210 send.2
18211 write.2
18212     Michael Kerrisk
18213         Fix discussion of EAGAIN/EWOULDBLOCK errors
18214             For a non-blocking socket, POSIX.1-2001/2008 allow either
18215             EAGAIN or EWOULDBLOCK to be returned in cases where a call
18216             would have blocked.  Although these constants are defined
18217             with the same value on most Linux architectures (PA-RISC
18218             is the exception), POSIX.1 does not require them to have
18219             the same value.  Therefore, a portable application using
18220             the sockets API should test for both errors when checking
18221             this case.
18222
18223             (NB POSIX.1 only mentions EWOULDBLOCK in the context of
18224             the sockets interfaces.)
18225
18226             Change made after a note cross-posted on linux-arch@vger,
18227             http://thread.gmane.org/gmane.linux.debian.ports.hppa/5615
18228             and a suggestion for write(2) from Carlos O'Donell
18229
18230 basename.3
18231 getgrent.3
18232 getgrnam.3
18233 getpwent.3
18234 getpwnam.3
18235 readdir.3
18236     Michael Kerrisk
18237         Note that returned pointer should not be given to free()
18238
18239 armscii-8.7
18240 cp1251.7
18241 iso_8859-10.7
18242 iso_8859-11.7
18243 iso_8859-13.7
18244 iso_8859-14.7
18245 iso_8859-15.7
18246 iso_8859-16.7
18247 iso_8859-2.7
18248 iso_8859-3.7
18249 iso_8859-4.7
18250 iso_8859-5.7
18251 iso_8859-6.7
18252 iso_8859-7.7
18253 iso_8859-8.7
18254 iso_8859-9.7
18255 koi8-r.7
18256 koi8-u.7
18257     Michael Kerrisk
18258         Add explicit character set encoding to first line of source
18259             Nowadays mandb has provision to understand a character set
18260             encoding that is explicitly indicated in the first line
18261             of the source.  As pointed out by Colin Watson, including
18262             such an explicit indication on pages encoded in anything
18263             other than ISO 8859-1 or UTF-8 is useful for man-pages
18264             that aren't shipped in UTF-8.
18265
18266             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519209
18267             and for some other background (responded to by Colin Watson
18268             in the above report):
18269             http://thread.gmane.org/gmane.comp.internationalization.linux/6040
18270             ("man page encoding", 5 Jul 2005)
18271
18272
18273 Changes to individual pages
18274 ---------------------------
18275
18276 fallocate.2
18277     Michael Kerrisk
18278         VERSIONS: glibc support is provided since version 2.10
18279
18280 fcntl.2
18281     Michael Kerrisk
18282         Remove mention of EWOULDBLOCK from discussion of mandatory locking
18283             In the kernel, the error on encountering a mandatory lock is
18284             EAGAIN.  Although EAGAIN and EWOULDBLOCK are the same on
18285             most Linux architectures, on some they are not, so don't
18286             mention EWOULDBLOCK as it is misleading.  (Mea culpa.)
18287
18288 getcontext.2
18289     Michael Kerrisk
18290         Note that POSIX.1-2008 removes the specification of getcontext()
18291
18292 getitimer.2
18293     Michael Kerrisk
18294         Note that POSIX.1-2008 recommends POSIX timers API instead of this API
18295
18296 gettimeofday.2
18297     Michael Kerrisk
18298         Note that POSIX.1-2008 recommends clock_gettime() instead of this API
18299
18300 ptrace.2
18301     Michael Kerrisk
18302         Note use of 'data' for PTRACE_SYS{CALL,EMU} and PTRACE_*_SINGLESTEP
18303             These operations use the 'data' argument as a signal number,
18304             like PTRACE_CONT.
18305
18306 ptrace.2
18307     Mike Frysinger
18308         only reference <sys/user.h>
18309             The kernel no longer installs linux/user.h, so update
18310             references to sys/user.h.
18311
18312 recv.2
18313     Michael Kerrisk
18314         Add 'iovec' defn to defn of 'msghdr' structure
18315             The 'msghdr' structure includes a field of type 'iovec',
18316             so show the definition of that structure in this page.
18317
18318 rename.2
18319     Michael Kerrisk
18320         Make ENOENT description consistent with POSIX.1-2008
18321
18322 timerfd_create.2
18323     Michael Kerrisk
18324         ERRORS: add EINVAL for invalid 'flags' for timer_settime()
18325
18326 truncate.2
18327     Michael Kerrisk
18328         SYNOPSIS: Fix description of feature test macro requirements
18329             After a report by Arvid Norlander.
18330
18331 bcopy.3
18332     Michael Kerrisk
18333         Note that POSIX.1-2008 removes specification of bcopy()
18334
18335 bsd_signal.3
18336     Michael Kerrisk
18337         Note that POSIX.1-2008 recommends sigaction(2) instead of this API
18338
18339 ctime.3
18340     Michael Kerrisk
18341         Note that POSIX.1-2008 recommends strftime(3) instead of these functions
18342
18343 ecvt.3
18344     Michael Kerrisk
18345         Note that POSIX.1-2008 recommends sprintf(3) instead of these functions
18346
18347 gcvt.3
18348     Michael Kerrisk
18349         Note that POSIX.1-2008 recommends sprintf(3) instead of this function
18350
18351 getcwd.3
18352     Michael Kerrisk
18353         Note that getcwd() should be used instead of the obsolete getwd()
18354
18355 getgrent.3
18356     Michael Kerrisk
18357         Returned buffer may be statically allocated and overwritten by
18358         later calls
18359
18360 gethostbyname.3
18361     Michael Kerrisk
18362         POSIX.1-2008 recommends getaddrinfo(3) and getnameinfo(3) instead
18363
18364 getnetent_r.3
18365     Michael Kerrisk
18366         Fix function name in text: s/getnetbynumber_r/getnetbyaddr_r/
18367             The SYNOPSIS showed the right function name (getnetbyaddr_r),
18368             but the text repeatedly used the wrong name (getnetbynumber_r).
18369             Probably, this was a cut-and-paste error.
18370
18371 getpwent.3
18372     Michael Kerrisk
18373         Returned buffer may be statically allocated and overwritten by
18374         later calls
18375
18376 index.3
18377     Michael Kerrisk
18378         Note that POSIX.1-2008 recommends strchr(3) and strrchr(3) instead
18379
18380 isalpha.3
18381     Michael Kerrisk
18382         Explain why POSIX.1-2008 marks isascii(3) obsolete
18383
18384 lockf.3
18385     Nikanth Karthikesan
18386         Update pointer to documentation in kernel source
18387
18388 makecontext.3
18389     Michael Kerrisk
18390         Note that POSIX.1-2008 recommends the use of POSIX threads instead
18391
18392 mq_notify.3
18393     Michael Kerrisk
18394         Document the POSIX.1-2008 optional EINVAL error
18395             POSIX.1-2008 allows an optional EINVAL error if
18396             notification==NULL and the caller is not currently
18397             registered to receive notifications.
18398
18399 posix_fallocate.3
18400     Michael Kerrisk
18401         Clarify that EINVAL also occurs of 'len' *equals* zero
18402             See http://bugzilla.kernel.org/show_bug.cgi?id=12919
18403
18404 posix_fallocate.3
18405     Michael Kerrisk
18406         Document POSIX.1-2001 and POSIX.1-2008 specifications for EINVAL error
18407             See http://bugzilla.kernel.org/show_bug.cgi?id=12919
18408
18409 posix_memalign.3
18410     Michael Kerrisk
18411         Document handling of size==0 case for posix_memalign()
18412
18413 pthread_exit.3
18414     Michael Kerrisk
18415         Fix error in DESCRIPTION: s/pthread_create/pthread_exit/
18416
18417 realpath.3
18418     Michael Kerrisk
18419         Rework resolved_path==NULL discussion w.r.t. POSIX.1-200[18]
18420             Although the page already mentioned the resolved_path==NULL
18421             feature, and that this feature was added in POSIX.1-2008, there
18422             was still some crufty text in BUGS that hadn't been updated to
18423             reflect the POSIX.1-2008 changes.
18424
18425             Also, some other minor wording and grammar fixes.
18426
18427 scalb.3
18428     Michael Kerrisk
18429         Note that POSIX.1-2008 recommends scalbln*(3) instead
18430
18431 seekdir.3
18432     Michael Kerrisk
18433         SYNOPSIS: Fix type of 'offset' argument: s/off_t/long/
18434             And add a NOTES section pointing out that 'off_t'
18435             was indeed used in glibc 2.1.1 and earlier.
18436             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519230
18437
18438 sem_post.3
18439     Michael Kerrisk
18440         Document EOVERFLOW error
18441
18442 shm_open.3
18443     Michael Kerrisk
18444         Recast discussion on name length to exclude terminating NULL byte
18445             Probably it's clearer to describe the length of the IPC object
18446             name as a count that excludes the null terminator.
18447
18448 siginterrupt.3
18449     Michael Kerrisk
18450         Note that POSIX.1-2008 recommends sigaction() instead
18451
18452 sigset.3
18453     Michael Kerrisk
18454         Note APIs that POSIX.1-2008 recommends instead of these obsolete APIs
18455
18456 strftime.3
18457     Michael Kerrisk
18458         Small fix to description of %G
18459             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=516677
18460
18461 strftime.3
18462     Michael Kerrisk
18463         Add details on ISO 8601 week-based dates
18464             ISO 8602 week-based dates are relevant for %G, %g, and %V,
18465             and the existing details on these dates are a little thin.
18466
18467 strftime.3
18468     Michael Kerrisk
18469         Remove mention of year from ISO 8601 standard
18470             The text mentioned the 1988 8601 standard, but there have
18471             already been two revisions of the standard since then, so
18472             simply remove mention of the year.
18473
18474 telldir.3
18475     Michael Kerrisk
18476         SYNOPSIS: Fix return type: s/off_t/long/
18477             And add a NOTES section pointing out that 'off_t'
18478             was indeed used in glibc 2.1.1 and earlier.
18479             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519230
18480
18481 timeradd.3
18482     Michael Kerrisk
18483         Note that on some systems, <=, >=, == don't work for timercmp()
18484
18485 timeradd.3
18486     Michael Kerrisk
18487         SYNOPSIS: Fix return types of timerisset() and timercmp()
18488
18489 toascii.3
18490     Michael Kerrisk
18491         Note why POSIX.1-2008 marks this function obsolete
18492
18493 console_ioctl.4
18494     Alan Curry
18495         Fix 'argp' type for KDGETLED description
18496             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=517485
18497
18498 group.5
18499     Michael Kerrisk
18500         Various minor rewordings and improvements
18501
18502 resolv.conf.5
18503     Michael Kerrisk
18504         Document 'ip6-bytestring' option
18505
18506 resolv.conf.5
18507     Michael Kerrisk
18508         Document 'edns0' option
18509
18510 resolv.conf.5
18511     Michael Kerrisk
18512         Document 'ip6-dotint' / 'no-ip6-dotint' option
18513
18514 resolv.conf.5
18515     Michael Kerrisk
18516         Note that maximum value of 'ndots' option is capped to 15
18517
18518 resolv.conf.5
18519     Michael Kerrisk
18520         Note that maximum value of 'timeout' option is capped to 30
18521
18522 hier.7
18523     Michael Kerrisk
18524         Add description of /srv
18525             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=520904
18526
18527 ip.7
18528     Michael Kerrisk
18529         Fix type used to declare sin6_port
18530             The page should use the type specified by POSIX,
18531             rather than the (equivalent) type used in the kernel
18532
18533 ipv6.7
18534     Teddy Hogeborn
18535         Fix types used to declare sin6_family and sin6_port
18536             The page should use the types specified by POSIX,
18537             rather than the (equivalent) types used in the kernel.
18538
18539             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=517074
18540
18541 mq_overview.7
18542     Michael Kerrisk
18543         Recast discussion on name length to exclude terminating NULL byte
18544             Probably it's clearer to describe the length of the IPC object
18545             name as a count that excludes the null terminator.
18546
18547 rtld-audit.7
18548     Michael Kerrisk
18549         Note that multiple libraries in LD_AUDIT doesn't work
18550             This is reportedly fixed in glibc 2.10.
18551             See http://sourceware.org/bugzilla/show_bug.cgi?id=9733
18552
18553 sem_overview.7
18554     Michael Kerrisk
18555         Fix discussion of length of semaphore names
18556             Because of the "sem." prefix added by glibc to a semaphore
18557             name, the limit on the length of the name (excluding the
18558             terminating null byte) is 251 characters.
18559
18560
18561 ==================== Changes in man-pages-3.21 ====================
18562
18563 Released: 2009-04-15, Los Gatos
18564
18565
18566 Contributors
18567 ------------
18568
18569 The following people contributed notes, ideas, or patches that have
18570 been incorporated in changes in this release:
18571
18572 Frank Dana <ferdnyc@gmail.com>
18573 Michael Kerrisk <mtk.manpages@gmail.com>
18574 Roman Byshko <rbyshko@gmail.com>
18575
18576 Apologies if I missed anyone!
18577
18578
18579 New and rewritten pages
18580 -----------------------
18581
18582 pthread_setconcurrency.3
18583     Michael Kerrisk
18584         New page documenting pthread_setconcurrency(3) and
18585         pthread_getconcurrency(3)
18586
18587 pthread_yield.3
18588     Michael Kerrisk
18589         New page documenting pthread_yield(3)
18590
18591
18592 New and changed links
18593 ---------------------
18594
18595 pthread_getconcurrency.3
18596     Michael Kerrisk
18597         New link to new pthread_setconcurrency(3)
18598
18599 Changes to individual pages
18600 ---------------------------
18601
18602 initrd.4
18603     Michael Kerrisk
18604         Various minor wording improvements
18605
18606 initrd.4
18607     Frank Dana
18608         Add missing word in description
18609
18610 feature_test_macros.7
18611     Michael Kerrisk
18612         Update for glibc 2.10 changes to <features.h>
18613             From glibc 2.10, <features.h> understands the values 200809
18614             for _POSIX_C_SOURCE and 700 for _XOPEN_SOURCE, and makes
18615             corresponding changes to defaults for other feature test macros.
18616     Michael Kerrisk
18617         Add an example program
18618             This example program makes it possible to explore what
18619             feature test macros are set depending on the glibc version
18620             and the macros that are explicitly set.
18621
18622 ldconfig.8
18623     Michael Kerrisk
18624         /etc/ld.so.conf also include libraries found in /lib and /usr/lib
18625
18626
18627 ==================== Changes in man-pages-3.22 ====================
18628
18629 Released: 2009-07-25, Munich
18630
18631
18632 Contributors
18633 ------------
18634
18635 The following people contributed notes, ideas, or patches that have
18636 been incorporated in changes in this release:
18637
18638 Adrian Dewhurst <sailor@sailorfrag.net>
18639 Alexander Lamaison <awl03@doc.ic.ac.uk>
18640 Bryan Østergaard <kloeri@exherbo.org>
18641 Christopher Head <chead@telus.net>
18642 Doug Goldstein <cardoe@gentoo.org>
18643 Florentin Duneau <fduneau@gmail.com>
18644 Gokdeniz Karadag <gokdenizk@gmail.com>
18645 Jeff Moyer <jmoyer@redhat.com>
18646 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
18647 Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
18648 Mark Hills <mark@pogo.org.uk>
18649 Michael Kerrisk <mtk.manpages@gmail.com>
18650 Mike Frysinger <vapier@gentoo.org>
18651 Petr Baudis <pasky@suse.cz>
18652 Reimar Döffinger <Reimar.Doeffinger@gmx.de>
18653 Ricardo Garcia <rg3.zeluan@gmail.com>
18654 Rui Rlex <rui.rlex@gmail.com>
18655 Shachar Shemesh <shachar@debian.org>
18656 Tolga Dalman <tdalman@project-psi.org>
18657 ku roi <kuroibox@yahoo.de>
18658 sobtwmxt <sobtwmxt@sdf.lonestar.org>
18659
18660 Apologies if I missed anyone!
18661
18662
18663 Changes to individual pages
18664 ---------------------------
18665
18666 clone.2
18667     Michael Kerrisk
18668         Rewrite crufty text about number of args in older version of clone()
18669                 Some bit rot had crept in regarding the discussion of the
18670                 number of arguments in older versions of this syscall.
18671                 Simplify the text to just say that Linux 2.4 and earlier
18672                 didn't have ptid, tls, and ctid arguments.
18673
18674                 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533868
18675     Michael Kerrisk
18676         Fix version number for CLONE_NEWIPC
18677             It's 2.6.19, not 2.4.19.
18678     Michael Kerrisk
18679         Fix errors in argument names in text (ptid, ctd)
18680
18681 execve.2
18682     Mike Frysinger
18683         Remove erroneous statement that pending signal set is cleared
18684         on execve(2).
18685
18686 fcntl.2
18687     Michael Kerrisk
18688         The kernel source file mandatory.txt is now mandatory-locking.txt
18689     Michael Kerrisk
18690         The Documentation/* files are now in Documentation/filesystems
18691
18692 flock.2
18693     Michael Kerrisk
18694         Remove unneeded reference to Documentation/mandatory.txt
18695             Mandatory locks are only implemented by fcntl() locking
18696     Michael Kerrisk
18697         The Documentation/* files are now in Documentation/filesystems
18698
18699 fork.2
18700     Jeff Moyer
18701         Document fork() behaviour for the Linux native AIO io_context
18702             It was noted on lkml that the fork behaviour is documented
18703             for the POSIX AIO calls, but not for the Linux native calls.
18704             Here is a patch which adds a small blurb that folks will
18705             hopefully find useful.
18706
18707             Upon fork(), the child process does not inherit the
18708             io_context_t data structures returned by io_setup,
18709             and thus cannot submit further asynchronous I/O or
18710             reap event completions for said contexts.
18711
18712 getdents.2
18713     Michael Kerrisk
18714         The d_type field is fully supported on Btrfs
18715
18716 mount.2
18717     Michael Kerrisk
18718         Document MS_STRICTATIME, update description of MS_RELATIME
18719             Starting with Linux 2.6.30, the MS_RELATIME behavior became
18720             the default, and MS_STRICTATIME is required to obtain the
18721             traditional semantics.
18722
18723 poll.2
18724     Michael Kerrisk
18725         Remove EBADF error from ERRORS
18726             As reported by Motohiro:
18727
18728             "man poll" describe this error code.
18729
18730             >ERRORS
18731             > EBADF  An invalid file descriptor was given in one of the sets.
18732
18733             but current kernel implementation ignore invalid file descriptor,
18734             not return EBADF.
18735             ...
18736
18737             In the other hand, SUSv3 talk about
18738
18739             > POLLNVAL
18740             >  The specified fd value is invalid. This flag is only valid in the
18741             >  revents member; it shall ignored in the events member.
18742
18743             and
18744
18745             > If the value of fd is less than 0, events shall be ignored, and
18746             > ireevents shall be set to 0 in that entry on return from poll().
18747
18748             but, no desribe EBADF.
18749             (see http://www.opengroup.org/onlinepubs/009695399/functions/poll.html)
18750
18751             So, I think the implementation is correct.
18752
18753             Why don't we remove EBADF description?
18754
18755 sigaction.2
18756     Michael Kerrisk
18757         Expand description of si_utime and si_stime fields of siginfo_t
18758
18759 stat.2
18760     Michael Kerrisk
18761         Improve wording of ENOTDIR error
18762
18763 syscalls.2
18764     Michael Kerrisk
18765         Add preadv() and pwritev(), new in kernel 2.6.30
18766
18767 wait.2
18768     Gokdeniz Karadag
18769         Document CLD_DUMPED and CLD_TRAPPED si_code values
18770
18771 daemon.3
18772     Michael Kerrisk
18773         Clarify discussion of 'noclose' and 'nochdir' arguments
18774
18775 ffs.3
18776     Petr Baudis
18777         SEE ALSO: add memchr(3)
18778
18779 fmemopen.3
18780     Petr Baudis
18781         Relocate BUGS section to correct position
18782     Petr Baudis
18783         NOTES: there is no file descriptor associated with the returned stream
18784             Alexander Lamaison pointed out that this is not obvious
18785             from the documentation, citing an example with passing the
18786             FILE * handle to a function that tries to fstat() its
18787             fileno() in order to determine the buffer size.
18788     Michael Kerrisk
18789         CONFORMING TO: remove note that these functions are GNU extensions
18790             That sentence is now redundant, since these functions
18791             are added in POSIX.1-2008.
18792
18793 lockf.3
18794     Michael Kerrisk
18795         Clarify relationship between fcntl() and lockf() locking
18796
18797 memchr.3
18798     Petr Baudis
18799         SEE ALSO: add ffs(3)
18800
18801 readdir.3
18802     Michael Kerrisk
18803         The d_type field is fully supported on Btrfs
18804
18805 setjmp.3
18806     Mike Frysinger
18807         Fix typo and clarify RETURN description
18808             The word "signal" was duplicated in NOTES, and the RETURN
18809             section refers to setjmp() and sigsetjmp(), and mentions
18810             longjmp(), but not siglongjmp().
18811
18812 strcmp.3
18813     Petr Baudis
18814         SEE ALSO: add strverscmp(3)
18815
18816 strcpy.3
18817     Mark Hills
18818         SEE ALSO: Add strdup(3)
18819
18820 complex.7
18821     Michael Kerrisk
18822         Add missing header file for example program
18823     Reimar Döffinger
18824         Fix type used in example code
18825         man complex (from release 3.18) contains the following code:
18826             complex z = cexp(I * pi);
18827         Reading the C99 standard, "complex" is not a valid type,
18828         and several compilers (Intel ICC, ARM RVCT) will refuse to compile.
18829         It should be
18830             double complex z = cexp(I * pi); instead.
18831
18832 environ.7
18833     Michael Kerrisk
18834         Note that last element in environ array is NULL
18835             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=528628
18836     Michael Kerrisk
18837         Wording fixes
18838
18839 mq_overview.7
18840     Michael Kerrisk
18841         Note that mkdir and mount commands here need superuser privilege
18842     Michael Kerrisk
18843         Fix example showing contents of /dev/mqueue file
18844
18845 standards.7
18846     Michael Kerrisk
18847         Remove references to dated books
18848             Gallmeister and Lewine are rather old books. Probably,
18849             there are better books to consult nowadays, and anyway,
18850             this man page isn't intended to be a bibliography.
18851
18852
18853 ==================== Changes in man-pages-3.23 ====================
18854
18855 Released: 2009-09-30, Munich
18856
18857
18858 Contributors
18859 ------------
18860
18861 The following people contributed notes, ideas, or patches that have
18862 been incorporated in changes in this release:
18863
18864 Aaron Gardner <aaron.j.gardner@gmail.com>
18865 Andrey Vihrov <vihrov@gmail.com>
18866 Christoph Hellwig <hch@lst.de>
18867 Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
18868 Leslie P. Polzer <sky@viridian-project.de>
18869 Marc Lehmann <debian-reportbug@plan9.de>
18870 Mark Hills <mark@pogo.org.uk>
18871 Michael Kerrisk <mtk.manpages@gmail.com>
18872 Mike Frysinger <vapier@gentoo.org>
18873 Nicolas François <nicolas.francois@centraliens.net>
18874 Serge Hallyn <serue@us.ibm.com>
18875 Siward de Groot <siward@ziggo.nl>
18876 rui rlex <rui.rlex@gmail.com>
18877
18878 Apologies if I missed anyone!
18879
18880
18881 Changes to individual pages
18882 ---------------------------
18883
18884 execve.2
18885 pipe.2
18886 tee.2
18887 fmemopen.3
18888 mq_notify.3
18889 qsort.3
18890     Michael Kerrisk
18891         Replace use of assert() by code that checks argc
18892             See http://bugzilla.kernel.org/show_bug.cgi?id=13569
18893
18894             As noted by Andrey:
18895             The purpose of the assert macro, defined in <assert.h>,
18896             is to provide a tool to check for programming mistakes
18897             or program logic errors. However, the assert macro must
18898             never be used to perform checks for run time errors,
18899             since, with the NDEBUG macro defined, expressions within
18900             the assert macro invocations are not evaluated/checked
18901             for, resulting in behavior that was not originally intended.
18902             ...
18903             The pages affected in the core package are
18904
18905             execve(2)
18906             pipe(2)
18907             tee(2)
18908             fmemopen(3)
18909             mq_notify(3)
18910             qsort(3)
18911
18912 getrusage.2
18913     Michael Kerrisk
18914         ru_inblock and ru_oublock are now implemented
18915             These fields of the rusage structure are filled in since
18916             Linux 2.6.22.
18917
18918 mmap.2
18919     Michael Kerrisk
18920         Add brief documentation of MAP_HUGETLB
18921             This flag is new in 2.6.32, and serves a similar
18922             purpose to the shmget() SHM_HUGETLB flag.
18923
18924 open.2
18925     Christoph Hellwig
18926         add some comments on O_SYNC and friends
18927
18928 poll.2
18929     Michael Kerrisk
18930         Clarify wording describing of 'nfds' argument.
18931             reported by: rui rlex <rui.rlex@gmail.com>
18932
18933 semctl.2
18934     Nicolas François
18935         Remove some redundant words
18936
18937 setpgid.2
18938     Michael Kerrisk
18939         Add an explanation of orphaned process groups
18940
18941 splice.2
18942 tee.2
18943 vmsplice.2
18944     Mark Hills
18945         Fix return type
18946             Since glibc 2.7, the return type for these functions
18947             is ssize_t (formerly it was long).
18948
18949 stat.2
18950     Nicolas François
18951         Fix small bug in example program
18952             Since it is a failure, EXIT_FAILURE looks more appropriate
18953             than EXIT_SUCCESS.
18954
18955 umount.2
18956     Michael Kerrisk
18957         glibc only exposes MNT_DETACH and MNT_EXPIRE since version 2.11
18958             See http://sourceware.org/bugzilla/show_bug.cgi?id=10092
18959
18960 exit.3
18961     Michael Kerrisk
18962         Add a pointer to explanation of orphaned process groups in setpgid(2)
18963
18964 fflush.3
18965     Michael Kerrisk
18966         fflush() discards buffered input
18967
18968 ffs.3
18969     Michael Kerrisk
18970         Clarify that ffsl() and ffsll() are GNU extensions
18971
18972 getaddrinfo.3
18973     Michael Kerrisk
18974         Note nonstandard assumed hints.ai_flags value when hints is NULL
18975             When hints is NULL, glibc assumes hints.ai_flags is
18976             AI_V4MAPPED|AI_ADDRCONFIG whereas POSIX says 0.
18977             According to Ulrich Drepper, glibc's behavior is better.
18978
18979 getmntent.3
18980     Mike Frysinger
18981         setmntent() argument is 'filename' not 'fp'
18982             The description of setmntent() formerly used the wrong
18983             argument name.
18984
18985 posix_fallocate.3
18986     Nicolas François
18987         Fix reference to POSIX.1-2008
18988             The sentence mentions twice POSIX.1-2001.
18989             I guess the second one should be POSIX.1-2008.
18990             This should be checked in the standard.
18991
18992 setenv.3
18993     Michael Kerrisk
18994         Improve ERRORS section
18995             Add ENOMEM error; improve EINVAL description. Also, make
18996             RETURN VALUE section a little more accurate in its mention
18997             of errno.
18998
18999 strftime.3
19000     Nicolas François
19001         Fix error in description: s/Monday/Thursday/
19002
19003 proc.5
19004     Nicolas François
19005         Fix page cross reference
19006             max_user_watches is better explained in epoll(7) than inotify(7).
19007
19008 proc.5
19009     Michael Kerrisk
19010         dmesg is in section 1, not section 8
19011
19012 capabilities.7
19013     Michael Kerrisk
19014         FS UID manipulations affect CAP_LINUX_IMMUTABLE and CAP_MKNOD
19015             Nowadays, file system UID manipulations also affect
19016             CAP_LINUX_IMMUTABLE (since 2.6.3) and CAP_MKNOD (since 2.6.29).
19017
19018 capabilities.7
19019     Michael Kerrisk
19020         Fix version number for CAP_MKNOD in FS UID manipulations
19021             A recent patch said "since 2.6.29". It should have
19022             been "since 2.6.30".
19023
19024 capabilities.7
19025     Nicolas François
19026         Reword a bad sentence in description of capability bounding set.
19027
19028 mq_overview.7
19029     Michael Kerrisk
19030         Change documented ranges for msg_max and msgsize_max
19031             Linux 2.6.28 changed the permissible ranges for
19032             these /proc files.
19033
19034 tcp.7
19035 udp.7
19036     Nicolas François
19037         Replace references to syctl interfaces with /proc
19038
19039
19040 ==================== Changes in man-pages-3.24 ====================
19041
19042 Released: 2010-02-25, Munich
19043
19044
19045 Contributors
19046 ------------
19047
19048 The following people contributed notes, ideas, or patches that have
19049 been incorporated in changes in this release:
19050
19051 Andi Kleen <andi@firstfloor.org>
19052 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
19053 Ansgar Burchardt <ansgar@2008.43-1.org>
19054 Bela Lubkin <filbo@armory.com>
19055 Bill O. Gallmeister <bog.kernel@gmail.com>
19056 Christoph Hellwig <hch@lst.de>
19057 Colin Watson <cjwatson@debian.org>
19058 Dan Jacobson <jidanni@jidanni.org>
19059 David Howells <dhowells@redhat.com>
19060 Denis Barbier <bouzim@gmail.com>
19061 Doug Manley <doug.manley@gmail.com>
19062 Edward Welbourne <eddy@opera.com>
19063 Fang Wenqi <anton.fang@gmail.com>
19064 Frédéric Brière <fbriere@fbriere.net>
19065 Garrett Cooper <yaneurabeya@yahoo.com>
19066 Ihar Hrachyshka <ihar.hrachyshka@gmail.com>
19067 Jann Poppinga <jann.poppinga@gmx.de>
19068 Jason Goldfine-Middleton <jasonwoodfine@gmail.com>
19069 Jason Noakes <jjnoakes@gmail.com>
19070 Jonathan Nieder <jrnieder@gmail.com>
19071 Kevin <tsubasa.xw@gmail.com>
19072 Mark Hills <mark@pogo.org.uk>
19073 Markus Peuhkuri <puhuri@iki.fi>
19074 Michael Kerrisk <mtk.manpages@gmail.com>
19075 Michael Witten <mfwitten@gmail.com>
19076 Mike Frysinger <vapier@gentoo.org>
19077 Sam Liao <phyomh@gmail.com>
19078 Samy Al Bahra <sbahra@repnop.org>
19079 Stuart Kemp <skemp@alertlogic.com>
19080 sunjiangangok <sunjiangangok@gmail.com>
19081 Tobias Stoeckmann <tobias@bugol.de>
19082 Vlastimil Babka <caster@gentoo.org>
19083 Yuri Kozlov <yuray@komyakino.ru>
19084
19085 Apologies if I missed anyone!
19086
19087
19088 New and rewritten pages
19089 -----------------------
19090
19091 add_key.2
19092     David Howells
19093         New page documenting add_key(2)
19094             Taken from keyutils-1.1 package.
19095
19096 keyctl.2
19097     David Howells
19098         New page documenting keyctl(2)
19099             Taken from keyutils-1.1 package.
19100
19101 request_key.2
19102     David Howells
19103         New page documenting request_key(2)
19104             Taken from keyutils-1.1 package.
19105
19106
19107 Global changes
19108 --------------
19109
19110 Various pages
19111     Michael Kerrisk
19112         Global fix: s/non-root/unprivileged/
19113
19114 Various pages
19115     Michael Kerrisk
19116         Global fix: s/non-privileged/unprivileged/
19117
19118 Various pages
19119     Michael Kerrisk
19120         Global fix:  /non-superuser/unprivileged user/
19121
19122 Various pages
19123     Michael Kerrisk
19124         s/non-/non/
19125             The tendency in English, as prescribed in style guides like
19126             Chicago MoS, is toward removing hyphens after prefixes
19127             like "non-" etc.
19128
19129 Various pages
19130     Michael Kerrisk
19131         Global fix: s/re-/re/
19132             The tendency in English, as prescribed in style guides like
19133             Chicago MoS, is toward removing hyphens after prefixes
19134             like "re-" etc.
19135
19136 Various pages
19137     Michael Kerrisk
19138         Global fix: s/multi-/multi/
19139             The tendency in English, as prescribed in style guides like
19140             Chicago MoS, is toward removing hyphens after prefixes
19141             like "multi-" etc.
19142
19143 Various pages
19144     Michael Kerrisk
19145         Global fix: s/pre-/pre/
19146             The tendency in English, as prescribed in style guides like
19147             Chicago MoS, is toward removing hyphens after prefixes
19148             like "pre-" etc.
19149
19150 Various pages
19151     Michael Kerrisk
19152         Global fix: s/sub-/sub/
19153             The tendency in English, as prescribed in style guides like
19154             Chicago MoS, is toward removing hyphens after prefixes
19155             like "sub-" etc.
19156
19157 stime.2
19158 time.2
19159 utimensat.2
19160 ctime.3
19161 difftime.3
19162 ftime.3
19163 getspnam.3
19164 mq_receive.3
19165 mq_send.3
19166 rtime.3
19167 sem_wait.3
19168 strftime.3
19169 strptime.3
19170 timeradd.3
19171 rtc.4
19172 core.5
19173 proc.5
19174 icmp.7
19175 time.7
19176     Michael Witten
19177         Global fix: Consistently define the Epoch
19178             All definitions of the Epoch have been refactored to the following:
19179
19180               1970-01-01 00:00:00 +0000 (UTC)
19181
19182             That form is more consistent, logical, precise, and internationally
19183             recognizable than the other variants.
19184
19185             Also, some wording has been altered as well.
19186
19187 spu_create.2
19188 getopt.3
19189 passwd.5
19190     Michael Kerrisk
19191         Global fix: s/non-existing/nonexistent/
19192
19193 faccessat.2
19194 fchmodat.2
19195 fchownat.2
19196 fstatat.2
19197 futimesat.2
19198 linkat.2
19199 mkdirat.2
19200 mknodat.2
19201 openat.2
19202 readlinkat.2
19203 renameat.2
19204 symlinkat.2
19205 unlinkat.2
19206 utimensat.2
19207 mkfifoat.3
19208     Michael Kerrisk
19209         Update feature test macro requirements
19210             Starting in glibc 2.10, defining _XOPEN_SOURCE >= 700,
19211             or _POSIX_C_SOURCE >= 200809 exposes the declarations of
19212             these functions.
19213
19214
19215 Changes to individual pages
19216 ---------------------------
19217
19218 clock_getres.2
19219     Michael Kerrisk
19220         Update text on nonsetabble CLOCK_*_CPUTIME_ID clocks
19221             SUSv3 permits, but does not require CLOCK_THREAD_CPUTIME_ID and
19222             CLOCK_PROCESS_CPUTIME_ID to be settable.
19223             See http://bugzilla.kernel.org/show_bug.cgi?id=11972.
19224
19225 execve.2
19226     Colin Watson
19227         Fix description of treatment of caught signals
19228             Caught signals reset to their default on an execve() (not
19229             to being ignored).
19230
19231 fcntl.2
19232     Michael Kerrisk
19233         s/F_OWNER_GID/F_OWNER_PGRP/
19234             Peter Zijlstra took the name change I suggested.
19235     Michael Kerrisk
19236         Document F_[SG]ETOWN_EX; update details on F_SETOWN
19237             Linux 2.6.32 adds F_SETOWN_EX and F_GETOWN_EX.
19238             Linux 2.6.12 changed (broke) the former behavior of
19239             F_SETOWN with respect to threads.
19240
19241 intro.2
19242 intro.3
19243     Michael Kerrisk
19244         Make subsection heading consistent with other intro.? pages
19245             These pages used "Copyright Terms"; the other intro.? pages
19246             used "Copyright Conditions". Make these pages like the others.
19247
19248 sendfile.2
19249     Michael Kerrisk
19250         Clarify behavior when 'offset' is NULL
19251
19252 seteuid.2
19253     Michael Kerrisk
19254         Note unstandardized behavior for effective ID
19255             POSIX.1 doesn't require that the effective ID can be changed
19256             to the same value it currently has (a no-op). The man page
19257             should note this, since some other implementations
19258             don't permit it.
19259
19260 setgid.2
19261     Michael Kerrisk
19262         Fix EPERM error description
19263             s/effective group ID/real group ID/
19264             This bug lived in man pages for 15 years before Jason
19265             spotted it! I checked back in Linux 1.0, and the behavior
19266             was as the fixed man page describes.
19267
19268 setreuid.2
19269     Michael Kerrisk
19270         Add more detail on POSIX.1 specification for these syscalls
19271
19272 setuid.2
19273     Michael Kerrisk
19274         Remove crufty statement that seteuid() is not in POSIX
19275             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=569812
19276
19277 stime.2
19278 strftime.3
19279 tzset.3
19280 zic.8
19281     Michael Witten
19282         GMT -> UTC (where appropriate)
19283
19284 sync_file_range.2
19285     Christoph Hellwig
19286         Add some big warnings re data integrity
19287             This system call is by design completely unsuitable for any data
19288             integrity operations.  Make that very clear in the manpage.
19289
19290 CPU_SET.3
19291     Vlastimil Babka
19292         SYNOPSIS: Fix return types for CPU_COUNT_*()
19293             These functions return 'int' not void'.
19294
19295 confstr.3
19296     Michael Kerrisk
19297         Fix feature test macro requirements
19298
19299 daemon.3
19300     Michael Kerrisk
19301         Fix description of 'nochdir' argument.
19302             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=554819
19303
19304 gethostbyname.3
19305     Michael Kerrisk
19306         Document feature test macro requirements for herror() and hstrerror()
19307             Since glibc 2.8, one of _BSD_SOURCE, _SVID_SOURCE,
19308             or _GNU_SOURCE is required.
19309
19310 getline.3
19311     Michael Kerrisk
19312         Update to reflect that these functions were standardized in POSIX.1-2008
19313
19314 getnameinfo.3
19315     Michael Kerrisk
19316         Document feature test macros requirements for NI_MAXHOST and NI_MAXSERV
19317             Since glibc 2.8, one of _BSD_SOURCE, _SVID_SOURCE, or _GNU_SOURCE
19318             must be defined to obtain these definitions.
19319
19320 getopt.3
19321     Jonathan Nieder
19322         Fix feature test macro requirements
19323
19324 memchr.3
19325     Michael Kerrisk
19326         Add feature text macro requirements for memrchr()
19327
19328 nextafter.3
19329     Michael Kerrisk
19330         Fix notable error in DESCRIPTION.
19331         "less than y" should be "less than x".
19332
19333 popen.3
19334     Michael Kerrisk
19335         Fix feature test macro requirements
19336
19337 pthread_attr_setdetachstate.3
19338 pthread_attr_setschedparam.3
19339 pthread_attr_setschedpolicy.3
19340     Denis Barbier
19341         Argument name is 'attr' not 'thread'
19342             The function argument was misnamed in the DESCRIPTION on these
19343             three pages.
19344
19345 rtnetlink.3
19346     Michael Kerrisk
19347         Various fixes in example code
19348             Edward reported a problem in the example code, where a variable
19349             seems to be misnamed. Upon inspection, there seem to be a few
19350             such instances, and this patch is my best guess at how things
19351             should look.
19352
19353 sched_getcpu.3
19354     Michael Kerrisk
19355         Place correct header file in SYNOPSIS
19356
19357 sleep.3
19358     Bill O. Gallmeister
19359         sleep() puts calling *thread* to sleep (not calling *process*)
19360
19361 sleep.3
19362     Bill O. Gallmeister
19363         Add nanosleep(2) to SEE ALSO
19364
19365 strftime.3
19366     Michael Kerrisk
19367         %z is defined in SUSv3
19368             So, substitute "GNU" tag in man page by "SU".
19369
19370 strftime.3
19371     Michael Witten
19372         Move 822-compliant date format example to EXAMPLES section
19373             The RFC 822-compliant date format given in the description
19374             of `%z' is now moved to the `EXAMPLES' section (note: `EXAMPLE'
19375             has been renamed `EXAMPLES').
19376
19377             Furthermore, that format example is now actually
19378             RFC 822-compliant (using `%y' instead of `%Y') and has been
19379             qualified as being correct only when in the context of at least
19380             an English locale. Also, `%T' is used in place of `%H:%M:%S'.
19381
19382             For completeness, an RFC 2822-compliant format example has been
19383             similarly added.
19384
19385 strftime.3
19386     Michael Witten
19387         Expand introductory text
19388
19389 strftime.3
19390     Michael Witten
19391         Clarification of %z specifier
19392
19393 string.3
19394     Mark Hills
19395         Add stpcpy() to this list of string functions
19396
19397 strptime.3
19398     Michael Kerrisk
19399         Initialize tm structure in example program
19400
19401 undocumented.3
19402     Michael Kerrisk
19403         Remove pages now documented
19404             By now, the following are documented:
19405
19406                 fopencookie(3)
19407                 freeifaddrs(3)
19408                 rawmemchr(3)
19409                 readdir_r(3)
19410                 getutmp(3)
19411                 getutmpx(3)
19412                 utmpxname(3)
19413
19414             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=554819
19415
19416 group.5
19417     Michael Kerrisk
19418         s/passwd/password/
19419             The page inconsistently used "passwd" and "password"
19420             to refer to the same field.
19421
19422 capabilities.7
19423     Michael Kerrisk
19424         Update securebits discussion to use SECBIT_* flags
19425
19426 feature_test_macros.7
19427     Michael Kerrisk
19428         _POSIX_C_SOURCE >= 200808 defines _ATFILE_SOURCE
19429             Since glibc 2.10, _POSIX_C_SOURCE >= 200808 defines _ATFILE_SOURCE
19430
19431 path_resolution.7
19432     Michael Kerrisk
19433         Add readlink(2) to SEE ALSO
19434     Michael Kerrisk
19435         Fix NAME line
19436             The poorly constructed part preceding "\-" causes apropos
19437             not to be able to find the subject.
19438
19439             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=558300
19440
19441 signal.7
19442     Michael Kerrisk
19443         Fix discussion of SIGUNUSED
19444             Clarify that this signal really is synonymous with SIGSYS.
19445             See http://bugzilla.kernel.org/show_bug.cgi?id=14449
19446
19447
19448 ==================== Changes in man-pages-3.25 ====================
19449
19450 Released: 2010-06-20, Munich
19451
19452
19453 Contributors
19454 ------------
19455
19456 The following people contributed notes, ideas, or patches that have
19457 been incorporated in changes in this release:
19458
19459 Alexander E. Patrakov <patrakov@gmail.com>
19460 Andi Kleen <andi@firstfloor.org>
19461 Andrew Klossner <andrew@cesa.opbu.xerox.com>
19462 André Goddard Rosa <andre.goddard@gmail.com>
19463 Bo Borgerson <gigabo@gmail.com>
19464 Christian Franke <nobody@nowhere.ws>
19465 Daisuke HATAYAMA <d.hatayama@jp.fujitsu.com>
19466 David Sommerseth <davids@redhat.com>
19467 Denis Barbier <bouzim@gmail.com>
19468 Eric Blake <ebb9@byu.net>
19469 Fang Wenqi <anton.fang@gmail.com>
19470 Francesco Cosoleto <cosoleto@gmail.com>
19471 Gernot Tenchio <gernot@tenchio.de>
19472 Hugh Dickins <hughd@google.com>
19473 Ivana Hutarova Varekova <varekova@redhat.com>
19474 Jan Blunck <jblunck@novell.com>
19475 Jan Engelhardt <jengelh@medozas.de>
19476 Jan Kara <jack@suse.cz>
19477 Jeff Barry <JeffBatHome@myletters.us>
19478 Manfred Schwarb <manfred99@gmx.ch>
19479 Mark Hills <mark@pogo.org.uk>
19480 Martin (Joey) Schulze <joey@infodrom.org>
19481 Michael Kerrisk <mtk.manpages@gmail.com>
19482 Mihai Paraschivescu <paraschivescu_mihail@yahoo.com>
19483 Mike Frysinger <vapier@gentoo.org>
19484 Miklos Szeredi <miklos@szeredi.hu>
19485 Petr Baudis <pasky@suse.cz>
19486 Petr Gajdos <pgajdos@suse.cz>
19487 Petr Uzel <petr.uzel@suse.cz>
19488 Pierre Habouzit <madcoder@madism.org>
19489 Reuben Thomas <rrt@sc3d.org>
19490 Rob Landley <rob@landley.net>
19491 Robert Wohlrab <robert.wohlrab@gmx.de>
19492 Serge E. Hallyn <serge@hallyn.com>
19493 Tolga Dalman <tdalman@project-psi.org>
19494 Tom Swigg <swiggtc@lsbu.ac.uk>
19495 Walter Harms <wharms@bfs.de>
19496 Yuri Kozlov <yuray@komyakino.ru>
19497
19498 Apologies if I missed anyone!
19499
19500
19501 New and rewritten pages
19502 -----------------------
19503
19504 migrate_pages.2
19505     Andi Kleen
19506         New page documenting migrate_pages(2).
19507             Andi's text based on the move_pages.2 page;
19508             additional edits by mtk.
19509             migrate_pages(2) was new in Linux 2.6.16.
19510
19511 quotactl.2
19512     Jan Kara
19513         Major updates
19514             Update the page to consolidate information from the
19515             outdated man-pages quotactl.2 page and the quotactl.2
19516             page in the "quota-tools" pachage. The page in "quota-tools"
19517             has now been dropped by Jan Kara, so that there is just one
19518             canonical quotactl.2 page (in pan-pages).
19519     Michael Kerrisk
19520             Various other pieces added to the page by mtk.
19521
19522
19523 Newly documented interfaces in existing pages
19524 ---------------------------------------------
19525
19526 fcntl.2
19527     Michael Kerrisk
19528         Document F_SETPIPE_SZ and F_GETPIPE_SZ
19529             These commands, new in kernel 2.6.35, set and get the capacity
19530             of pipes.
19531
19532 madvise.2
19533     Andi Kleen
19534         Document MADV_HWPOISON
19535     Michael Kerrisk
19536         Added documentation of MADV_MERGEABLE and MADV_UNMERGEABLE
19537             These flags (used for Kernel Samepage Merging, KSM)
19538             are new in 2.6.32.
19539     Andi Kleen
19540         Document MADV_SOFT_OFFLINE
19541             This operation was added in Linux 2.6.33.
19542
19543 mmap.2
19544     Michael Kerrisk
19545         Document MAP_UNINITIALIZED flag
19546             New in Linux 2.6.33.
19547
19548 prctl.2
19549     Andi Kleen
19550         Document the hwpoison prctls in 2.6.32
19551
19552 sched_setscheduler.2
19553     Michael Kerrisk
19554         Document SCHED_RESET_ON_FORK
19555             New in Linux 2.6.32
19556
19557 umount.2
19558     Michael Kerrisk
19559         Document UMOUNT_NOFOLLOW
19560             New in Linux 2.6.34.
19561
19562 mkstemp.3
19563     Michael Kerrisk
19564         Document mkstemps() and mkostemps()
19565             These functions are new in glibc 2.11. They allow the template
19566             string to include a suffix after the "XXXXXX" string.
19567
19568 proc.5
19569     Michael Kerrisk
19570         Document /proc/sys/vm/memory_failure_early_kill
19571             New in 2.6.32. Description based on the text in
19572             Documentation/sysctl/vm.txt.
19573     Michael Kerrisk
19574         Document /proc/sys/vm/memory_failure_recovery
19575             New in Linux 2.6.32.  Description based on the text in
19576             Documentation/sysctl/vm.txt.
19577     Michael Kerrisk
19578         Document /proc/sys/fs/pipe-max-size
19579
19580 socket.7
19581     Jan Engelhardt
19582         Document SO_DOMAIN and SO_PROTOCOL
19583             These read-only socket options were new in Linux 2.6.32.
19584
19585
19586 New and changed links
19587 ---------------------
19588
19589 fstatvfs.2
19590     Michael Kerrisk
19591         Adjust link to point to Section 3
19592
19593 fstatvfs.3
19594 statvfs.2
19595     Michael Kerrisk
19596         New link to page relocated to Section 3
19597
19598 mkstemps.3
19599 mkostemps.3
19600     Michael Kerrisk
19601         New links to mkstemp.3
19602             mkstemp.3 now describes mkstemps(3) and mkostemps(3).
19603
19604 timer_create.2
19605 timer_delete.2
19606 timer_getoverrun.2
19607 timer_settime.2
19608 getline.3
19609     Michael Kerrisk
19610         Add 'L' to constants in feature test macro specifications
19611             Be consistent with POSIX, which uses constants such as 200809L.
19612
19613
19614 Global changes
19615 --------------
19616
19617 open.2
19618 sync_file_range.2
19619 umount.2
19620     Michael Kerrisk
19621         Global fix: s/filesystem/file system/
19622
19623
19624 Changes to individual pages
19625 ---------------------------
19626
19627 fcntl.2
19628     Michael Kerrisk
19629         Note that glibc 2.11 papers over the kernel F_GETOWN bug
19630             Since version 2.11, glibc works around the kernel limitation for
19631             process groups IDs < 4096 by implementing F_GETOWN via F_GETOWN_EX.
19632
19633 futex.2
19634     Michael Kerrisk
19635         Various fixes in SEE ALSO
19636
19637 getpriority.2
19638 nice.2
19639     Francesco Cosoleto
19640         Move renice from section 8 to section 1
19641
19642 getrusage.2
19643     Mark Hills
19644         Add ru_maxrss
19645             See kernel commit 1f10206.
19646     Mark Hills
19647         Description of maintained fields
19648             These descriptions are taken from NetBSD 5.0's getrusage(2).
19649     Michael Kerrisk
19650         Enhanced description of various fields
19651
19652 mlock.2
19653     Michael Kerrisk
19654         /proc/PID/status VmLck shows how much memory a process has locked
19655             After a note from Tom Swigg, it seems sensible mention VmLck here.
19656
19657 mount.2
19658     Petr Uzel
19659         Fix incorrect path
19660
19661 move_pages.2
19662     Andi Kleen
19663         Clarify includes/libraries
19664
19665 mremap.2
19666     Michael Kerrisk
19667         Clarify existence of fifth argument.
19668
19669 msgctl.2
19670 semctl.2
19671 shmctl.2
19672     Francesco Cosoleto
19673         Move ipcs from section 8 to section 1
19674
19675 open.2
19676     Michael Kerrisk
19677         Remove ambiguity in text on NFS and O_EXCL.
19678
19679 poll.2
19680     Michael Kerrisk
19681         Fix discussion of ppoll() timeout argument
19682             1. Rename ppoll)(_ argument to "timeout_ts" to distinguish it
19683                from the poll() argument in the text.
19684             2. More accurately describe the poll() call that is equivalent
19685                to ppoll().
19686
19687 posix_fadvise.2
19688     Michael Kerrisk
19689         Add sync_file_range(2) under SEE ALSO
19690
19691 prctl.2
19692     Michael Kerrisk
19693         Correct PR_SET_KEEPCAPS description
19694             The "keep capabilities" flag only affects the treatment of
19695             permitted capabilities, not effective capabilities.
19696             Also: other improvements to make the PR_SET_KEEPCAPS text clearer.
19697
19698 select_tut.2
19699     Michael Kerrisk
19700         Fix bug in example program
19701
19702 sigaction.2
19703     Michael Kerrisk
19704         Add TRAP_BRANCH and TRAP_HWBKPT to si_code values for SIGTRAP
19705     Michael Kerrisk
19706         Rearrange text describing fields set by sigqueue(2)
19707     Michael Kerrisk
19708         Add details for signals sent by POSIX message queue notifications
19709     Michael Kerrisk
19710         Improve description of various siginfo_t fields
19711     Michael Kerrisk
19712         Add some details for SIGTRAP and si_trapno
19713     Andi Kleen
19714         Document hwpoison signal extensions
19715
19716 statfs.2
19717     Michael Kerrisk
19718         Bring statfs struct type declarations closer to glibc reality
19719     Fang Wenqi
19720         Add definition EXT4_SUPER_MAGIC = 0xEF53
19721     Michael Kerrisk
19722         Document f_frsize field.
19723
19724 statvfs.2
19725     Michael Kerrisk
19726         Move this page to section 3 (since it's a library call)
19727
19728 swapon.2
19729     Ivana Hutarova Varekova
19730         Note effect of CONFIG_MEMORY_FAILURE on MAX_SWAPFILES
19731             From 2.6.32, MAX_SWAPFILES is decreased by 1 if the kernel is
19732             built with CONFIG_MEMORY_FAILURE.
19733
19734 syscalls.2
19735     Michael Kerrisk
19736         Bring system call list up to date with Linux 2.6.33
19737     Michael Kerrisk
19738         Fix kernel version number for utimes()
19739
19740 cproj.3
19741     Michael Kerrisk
19742         Note fix for C99 conformance in glibc 2.12.
19743
19744 crypt.3
19745     Petr Baudis
19746         Correct note on key portion significance
19747             As Marcel Moreaux notes:
19748
19749                 The Linux manpage for crypt()[1] contains the following
19750                 statement as the last sentence of the NOTES section:
19751
19752                     In the SHA implementation the entire key is significant
19753                     (instead of only the first 8 bytes in MD5).
19754
19755                 It should probably say "DES" where it says "MD5" (and maybe
19756                 "MD5/SHA" where it says "SHA"), because in MD5 password hashing,
19757                 the entire key is significant, not just the first 8 bytes.
19758
19759             This patch fixes the wording.
19760
19761 fmemopen.3
19762     Michael Kerrisk
19763         Bug fix in example program
19764
19765 ftw.3
19766     Michael Kerrisk
19767         Note that if 'fn' changes CWD, the results are undefined
19768     Michael Kerrisk
19769         Clarify description of fpath argument
19770             As reported by Pierre Habouzit, 'fpath' is not relative
19771             to 'dirpath'. It is either relative to the calling process's
19772             current working directory (if 'dirpath' was relative), or it
19773             is absolute (if 'dirpath' was absolute).
19774
19775 getaddrinfo.3
19776     Christian Franke
19777         Fix a field name mixup: s/ai_family/ai_flags/
19778
19779 getline.3
19780     Robert Wohlrab
19781         Remove unneeded check before free()
19782             The manpage of getline shows an example with an extra NULL pointer
19783             check before it calls free. This is unneeded according to free(3):
19784
19785                  If ptr is NULL, no operation is performed.
19786
19787             This patch removes the "if" check.
19788
19789             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572508
19790
19791 log.3
19792 log10.3
19793 log2.3
19794     Jan Engelhardt
19795         Add cross-references to other-base logarithmic functions
19796
19797 opendir.3
19798     Petr Baudis
19799         Specify feature test macro requirements for fdopendir(3)
19800             Currently, there is no note on the fact that fdopendir() is
19801             POSIX.2008-only.
19802
19803 openpty.3
19804     Eric Blake
19805         Use const as appropriate
19806     Michael Kerrisk
19807         Note glibc version that added "const" to function arguments
19808     Michael Kerrisk
19809         Explicitly note that these functions are not in POSIX
19810
19811 resolver.3
19812     Michael Kerrisk
19813         Fix declaration of dn_comp() in SYNOPSIS
19814             Remove the second 'exp_dn' from the calling signature.
19815
19816 termios.3
19817     Michael Kerrisk
19818         Change NOFLSH text to speak of characters, not signals
19819
19820 core.5
19821     Michael Kerrisk
19822         Update description of coredump_filter
19823             Kernel 2.6.24 added MMF_DUMP_ELF_HEADERS.
19824             Kernel 2.6.28 added MMF_DUMP_HUGETLB_PRIVATE and
19825             MMF_DUMP_HUGETLB_SHARED.
19826
19827 elf.5
19828     Daisuke HATAYAMA
19829         Document PN_XNUM extension
19830             In linux-2.6.34-rc1, an ELF core extension was added; user-land
19831             tools manipulating ELF core dump such as gdb and binutils has
19832             already been modified before; so elf.5 needs to be modified
19833             accordingly.
19834
19835             You can follow information on the ELF extension via the LKML post:
19836             http://lkml.org/lkml/2010/1/3/103
19837             Date        Mon, 04 Jan 2010 10:06:07 +0900 (JST)
19838             Subject     ... elf coredump: Add extended numbering support
19839
19840             This Linux-specific extension was added in kernel 2.6.34.
19841
19842             Reviewed-by: Petr Baudis <pasky@suse.cz>
19843
19844     Michael Kerrisk
19845         Remove EI_BRAND
19846             As reported by Yuri Kozlov  and confirmed by Mike Frysinger,
19847             EI_BRAND is not in GABI
19848             (http://www.sco.com/developers/gabi/latest/ch4.eheader.html)
19849             It looks to be a BSDism
19850     Michael Kerrisk
19851         Remove words under '.note': "described below"
19852             The existing text is broken, because there is
19853             no '"Note Section" format' describe below. Simplest
19854             solution is to remove the words "described below".
19855
19856 filesystems.5
19857     Jeff Barry
19858         Add discussion of ntfs and ext4
19859
19860 proc.5
19861     Michael Kerrisk
19862         Simplify description of /proc/sys and /proc/sys/fs
19863             In the description of these directories, there's no need
19864             to list all the files and subdirectories that they contain;
19865             that information is provided by the entries that follow.
19866
19867 services.5
19868     Yuri Kozlov
19869         Remove crufty reference to nonexistent BUGS section
19870
19871 capabilities.7
19872     Michael Kerrisk
19873         Document CAP_SYS_RESOURCE and F_SETPIPE_SZ
19874             With CAP_SYS_RESOURCE, a process can increase pipe capacity above
19875             /proc/sys/ps/pipe-max-size.
19876     Michael Kerrisk
19877         Add get_robust_list() info under CAP_SYS_PTRACE
19878     Michael Kerrisk
19879         Add MADV_HWPOISON under CAP_SYS_ADMIN
19880
19881 signal.7
19882     Michael Kerrisk
19883         Make a clearer statement about nonportable aspect of signal(2)
19884             Make a clearer statement that signal(2) is less portable for
19885             establishing a signal handler.
19886
19887 socket.7
19888     Michael Kerrisk
19889         Use consistent language to describe read-only socket options
19890
19891 udp.7
19892     Michael Kerrisk
19893         Add FIONREAD warning.
19894             Warn that FIONREAD can't can't distinguish case of a zero-length
19895             datagram from the case where no datagrams are available.
19896
19897
19898 ==================== Changes in man-pages-3.26 ====================
19899
19900 Released: 2010-09-04, Munich
19901
19902
19903 Contributors
19904 ------------
19905
19906 The following people contributed notes, ideas, or patches that have
19907 been incorporated in changes in this release:
19908
19909 Alexander Shishkin <virtuoso@slind.org>
19910 Brian Sutin <Brian.Sutin@hs.utc.com>
19911 Denis Barbier <bouzim@gmail.com>
19912 Guillem Jover <guillem@hadrons.org>
19913 Jianhua Li <jhlicc@gmail.com>
19914 Linus Nilsson <lajnold@gmail.com>
19915 Lenaic Huard <lenaic.huard@laposte.net>
19916 Mac <mac@mcrowe.com>
19917 Martin Schulze <joey@infodrom.org>
19918 Maxin John <maxin.john@gmail.com>
19919 Michael Kerrisk <mtk.manpages@gmail.com>
19920 Nicholas Hunt <nhunt@cs.washington.edu>
19921 Peng Haitao <penght@cn.fujitsu.com>
19922 Peter Stuge <peter@stuge.se>
19923 Przemyslaw Szczepaniak <Przemyslaw.Szczepaniak@imgtec.com>
19924 Scott Walls <sawalls@umich.edu>
19925 TAN Yee Fan <tanyeefa@comp.nus.edu.sg>
19926 Wu Fengguang <fengguang.wu@intel.com>
19927 Yitzchak Gale <gale@sefer.org>
19928 Yuri Kozlov <yuray@komyakino.ru>
19929
19930 Apologies if I missed anyone!
19931
19932 Newly documented interfaces in existing pages
19933 ---------------------------------------------
19934
19935 eventfd.2
19936     Michael Kerrisk
19937         Document EFD_SEMAPHORE
19938             Document the EFD_SEMAPHORE flag, added in kernel 2.6.30.
19939             Also restructured some parts of the text to fit with the
19940             addition of the EFD_SEMAPHORE text.
19941
19942
19943 Global changes
19944 --------------
19945
19946 getaddrinfo.3
19947 getipnodebyname.3
19948 st.4
19949     Michael Kerrisk
19950         s/logical OR/bitwise OR/
19951
19952
19953 Changes to individual pages
19954 ---------------------------
19955
19956 clock_nanosleep.2
19957     Michael Kerrisk
19958         Fix discussion of return value when interrupted by a signal
19959
19960 epoll_ctl.2
19961     Yuri Kozlov
19962         Small fix to types in data structures
19963
19964 eventfd.2
19965     Alexander Shishkin
19966         Clarified close-on-exec behavior
19967
19968 madvise.2
19969     Michael Kerrisk
19970         Improve discussion of MADV_SOFT_OFFLINE
19971
19972 mkdir.2
19973     Michael Kerrisk
19974         Add EMLINK error to ERRORS
19975
19976 mq_getsetattr.2
19977 mq_close.3
19978 mq_getattr.3
19979 mq_notify.3
19980 mq_send.3
19981 mq_unlink.3
19982     Lnac Huard
19983         Fix return type in SYNOPSIS (s/mqd_t/int/)
19984
19985 recv.2
19986 send.2
19987     Michael Kerrisk
19988         Remove obsolete reference to glibc version in NOTES
19989
19990 recv.2
19991 send.2
19992     Nicholas Hunt
19993         Adjust type shown for msg_controllen to glibc reality
19994             This patch fixes the type of msg_controllen in the struct msghdr
19995             definition given in send.2 and recv.2 to match the definition in
19996             glibc and the kernel.
19997
19998 select.2
19999     Michael Kerrisk
20000         Update NOTES on old glibc pselect()
20001             Make it clear that modern glibc uses the kernel pselect()
20002             on systems where it is available.
20003             See https://bugzilla.kernel.org/show_bug.cgi?id=14411
20004
20005 statfs.2
20006     Guillem Jover
20007         Fix copy & paste error for __SWORD_TYPE definition
20008
20009 sysfs.2
20010     Michael Kerrisk
20011         Clarify that this syscall is obsolete.
20012             And strengthen recommendation to use /proc/filesystems instead.
20013
20014 write.2
20015     Michael Kerrisk
20016         Add EDESTADDRREQ error
20017
20018 a64l.3
20019     Peng Haitao
20020         Fix error in NOTES, s/a64l/l64a/
20021
20022 error.3
20023     Linus Nilsson
20024         Change "perror" to "strerror" in DESCRIPTION of error()
20025
20026 mq_send.3
20027     Michael Kerrisk
20028         Fix EAGAIN description (s/empty/full)
20029
20030 initrd.4
20031     Yuri Kozlov
20032         Fix IP address in explanation of NFS example
20033
20034 tzfile.5
20035     Michael Kerrisk
20036         Add information on version 2 format timezone files
20037             Updated using information from the tzcode 2010l release at
20038             ftp://elsie.nci.nih.gov/pub.
20039             (It's an open question whether or not a version of tzfile.5
20040             should live independently in man-pages. It was added to the
20041             man-pages set many years ago. For now, I'll follow a
20042             conservative course that causes least pain to downstream,
20043             by continuing to maintain a separate copy in man-pages.)
20044
20045             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=594219
20046
20047
20048 ==================== Changes in man-pages-3.27 ====================
20049
20050 Released: 2010-09-22, Nuernberg
20051
20052
20053 Contributors
20054 ------------
20055
20056 The following people contributed notes, ideas, or patches that have
20057 been incorporated in changes in this release:
20058
20059 caishuxian <caishuxian@gmail.com>
20060 Denis Barbier <bouzim@gmail.com>
20061 Denis Silakov <silakov@ispras.ru>
20062 der Mouse <mouse@rodents-montreal.org>
20063 Jan Kratochvil  <jan.kratochvil@redhat.com>
20064 Jim Belton <jim.belton@gmail.com>
20065 Jiri Olsa <jolsa@redhat.com>
20066 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
20067 Mark Hills <mark@pogo.org.uk>
20068 Matthew Flaschen <matthew.flaschen@gatech.edu>
20069 Michael Kerrisk <mtk.manpages@gmail.com>
20070 Ozgur Gurcan <ozgur.gurcan@lpp.polytechnique.fr>
20071 Petr Baudis <pasky@suse.cz>
20072 Remi Denis-Courmont <remi@remlab.net>
20073 Tanaka Akira <akr@fsij.org>
20074 Tim Stoakes <tim@stoakes.net>
20075 W. Trevor King <wking@drexel.edu>
20076 Yuri Kozlov <yuray@komyakino.ru>
20077
20078 Apologies if I missed anyone!
20079
20080
20081 New and rewritten pages
20082 -----------------------
20083
20084 sigevent.7
20085     Petr Baudis, Michael Kerrisk
20086         New page to centralize description of sigevent structure
20087             Several interfaces use this structure. Best to centralize the
20088             common details in one place. Content taken from the existing
20089             timerfd_create.2 and mq_open.3 pages, with additions by
20090             Petr Baudis and Michael Kerrisk.
20091
20092
20093 Newly documented interfaces in existing pages
20094 ---------------------------------------------
20095
20096 ip.7
20097     Jiri Olsa
20098         Document IP_NODEFRAG
20099             This option is new in Linux 2.6.36
20100
20101 unix.7
20102     Michael Kerrisk
20103         Document SIOCINQ ioctl() operation
20104
20105
20106 Global changes
20107 --------------
20108
20109 _exit.2
20110 brk.2
20111 chdir.2
20112 chmod.2
20113 chown.2
20114 chroot.2
20115 clock_nanosleep.2
20116 getdtablesize.2
20117 gethostname.2
20118 getpagesize.2
20119 getsid.2
20120 killpg.2
20121 mknod.2
20122 mknodat.2
20123 posix_fadvise.2
20124 pread.2
20125 readlink.2
20126 setpgid.2
20127 setreuid.2
20128 sigaltstack.2
20129 stat.2
20130 symlink.2
20131 sync.2
20132 truncate.2
20133 vfork.2
20134 wait.2
20135 wait4.2
20136 a64l.3
20137 abs.3
20138 acos.3
20139 acosh.3
20140 asin.3
20141 asinh.3
20142 atan.3
20143 atan2.3
20144 atanh.3
20145 atoi.3
20146 cbrt.3
20147 ceil.3
20148 clock_getcpuclockid.3
20149 copysign.3
20150 cos.3
20151 cosh.3
20152 dirfd.3
20153 div.3
20154 dprintf.3
20155 ecvt.3
20156 erf.3
20157 erfc.3
20158 exp.3
20159 exp2.3
20160 expm1.3
20161 fabs.3
20162 fdim.3
20163 fexecve.3
20164 ffs.3
20165 floor.3
20166 fma.3
20167 fmax.3
20168 fmemopen.3
20169 fmin.3
20170 fmod.3
20171 fpclassify.3
20172 frexp.3
20173 fwide.3
20174 gamma.3
20175 gcvt.3
20176 getcwd.3
20177 getdate.3
20178 getgrent.3
20179 gethostid.3
20180 getpass.3
20181 getpwent.3
20182 getsubopt.3
20183 getw.3
20184 hypot.3
20185 ilogb.3
20186 insque.3
20187 isalpha.3
20188 isgreater.3
20189 iswblank.3
20190 j0.3
20191 j0.3
20192 ldexp.3
20193 lockf.3
20194 log.3
20195 log10.3
20196 log1p.3
20197 log2.3
20198 logb.3
20199 lrint.3
20200 lround.3
20201 mbsnrtowcs.3
20202 mkdtemp.3
20203 mkstemp.3
20204 mktemp.3
20205 modf.3
20206 mq_receive.3
20207 mq_send.3
20208 nan.3
20209 nextafter.3
20210 posix_fallocate.3
20211 posix_memalign.3
20212 pow.3
20213 printf.3
20214 qecvt.3
20215 random.3
20216 realpath.3
20217 remainder.3
20218 remquo.3
20219 rint.3
20220 rint.3
20221 round.3
20222 scalb.3
20223 scalbln.3
20224 scanf.3
20225 siginterrupt.3
20226 signbit.3
20227 sigset.3
20228 sin.3
20229 sinh.3
20230 sqrt.3
20231 stpcpy.3
20232 stpncpy.3
20233 strdup.3
20234 strdup.3
20235 strnlen.3
20236 strsignal.3
20237 strtod.3
20238 strtol.3
20239 strtoul.3
20240 tan.3
20241 tanh.3
20242 tgamma.3
20243 trunc.3
20244 ttyslot.3
20245 ualarm.3
20246 usleep.3
20247 wcpcpy.3
20248 wcpncpy.3
20249 wcscasecmp.3
20250 wcsdup.3
20251 wcsncasecmp.3
20252 wcsnlen.3
20253 wcsnrtombs.3
20254 wprintf.3
20255     Michael Kerrisk
20256         Add/fix/update feature test macro requirements in SYNOPSIS
20257             Various changes to:
20258             * Update feature test requirements to note changes in
20259               recent glibc releases
20260             * Correct errors in feature test macro requirements
20261             * Add feature test macro requirements to pages where
20262               the requirements were not previously stated.
20263
20264 accept.2
20265 clone.2
20266 dup.2
20267 fallocate.2
20268 pipe.2
20269 readahead.2
20270 sched_setaffinity.2
20271 unshare.2
20272 CPU_SET.3
20273 endian.3
20274 euidaccess.3
20275 fexecve.3
20276 getpt.3
20277 getpw.3
20278 getumask.3
20279 getutmp.3
20280 gnu_get_libc_version.3
20281 makedev.3
20282 matherr.3
20283 mbsnrtowcs.3
20284 memfrob.3
20285 pthread_attr_setaffinity_np.3
20286 pthread_getattr_np.3
20287 pthread_setaffinity_np.3
20288 pthread_tryjoin_np.3
20289 tcgetsid.3
20290 wcscasecmp.3
20291 wcsncasecmp.3
20292 wcsnlen.3
20293 wcsnrtombs.3
20294 wcswidth.3
20295 rtld-audit.7
20296     Michael Kerrisk
20297         SYNOPSIS: Add reference to feature_test_macros(7)
20298             These pages specify feature test macros in the function
20299             prototypes. Add a reference to feature_test_macros(7),
20300             so that readers are pointed to the information that
20301             feature test macros must be defined before including
20302             *any* header file.
20303
20304 clock_nanosleep.2
20305 clock_getcpuclockid.3
20306 getnetent_r.3
20307 getprotoent_r.3
20308 getrpcent_r.3
20309 getservent_r.3
20310 sigwait.3
20311     Michael Kerrisk
20312         RETURN VALUE: Note that "positive error numbers" are listed in ERRORS
20313
20314 fcntl.2
20315 intro.2
20316 open.2
20317 poll.2
20318 ftw.3
20319 intro.3
20320 matherr.3
20321 system.3
20322 tmpnam.3
20323 unix.7
20324     Michael Kerrisk
20325         Note that feature test macros must be defined before *any* includes
20326             Programmers often make the mistake of including a feature test
20327             macro only after having already included some header files.
20328             This patch adds some text at opportune places to remind
20329             programmers to do things the right way.
20330
20331 index.3
20332 stpcpy.3
20333 strcasecmp.3
20334 strcat.3
20335 strchr.3
20336 strcmp.3
20337 strcoll.3
20338 strcpy.3
20339 strdup.3
20340 strfry.3
20341 strpbrk.3
20342 strsep.3
20343 strspn.3
20344 strstr.3
20345 strtok.3
20346 strxfrm.3
20347     Michael Kerrisk
20348         SEE ALSO: Add reference to string(3)
20349             The idea here is to provide a route to discover other
20350             string functions.
20351
20352 armscii-8.7
20353 cp1251.7
20354 iso_8859-3.7
20355 iso_8859-5.7
20356 iso_8859-6.7
20357 iso_8859-8.7
20358 iso_8859-10.7
20359 iso_8859-11.7
20360 iso_8859-13.7
20361 iso_8859-14.7
20362 koi8-u.7
20363     Denis Barbier
20364         Fix decimal values in encoding tables
20365             Octal and hexadecimal values are right, but there are some
20366             off-by one errors in decimal values.  Correct values are
20367             printed by this command:
20368
20369               perl -pi -e 'if (s/^([0-7]+)\t([0-9]+)\t([0-9a-fA-F]+)//)
20370                 {printf "%03o\t%d\t%s", hex($3), hex($3), $3;};' man7/*.7
20371
20372
20373 Changes to individual pages
20374 ---------------------------
20375
20376 capget.2
20377     Michael Kerrisk
20378         SYNOPSIS: Remove unneeded "undef _POSIX_SOURCE"
20379
20380 fcntl.2
20381     Michael Kerrisk
20382         Add feature test macro requirements for F_GETOWN and F_SETOWN
20383
20384 fcntl.2
20385     Michael Kerrisk
20386         Note feature test macro requirements for F_DUPFD_CLOEXEC
20387
20388 getrlimit.2
20389     Michael Kerrisk
20390         Document units for RLIMIT_RTTIME limit
20391             This limit is in microseconds
20392
20393             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=596492
20394
20395 lseek.2
20396     Michael Kerrisk
20397         Removed note about return type on ancient systems
20398
20399 mount.2
20400     Michael Kerrisk
20401         Definitions of various MS_* constants only appeared in glibc 2.12
20402             See http://sourceware.org/bugzilla/show_bug.cgi?id=11235
20403
20404 stat.2
20405     Michael Kerrisk
20406         Update information on nanosecond timestamp fields
20407             Update feature test macro requirements for exposing these fields.
20408             Note that these fields are specified in POSIX.1-2008.
20409
20410 timer_create.2
20411     Michael Kerrisk
20412         Factor out generic material that was moved to new sigevent(7) page
20413
20414 aio_fsync.3
20415     Michael Kerrisk
20416         Add reference to new sigevent(7) page
20417
20418 atanh.3
20419     Michael Kerrisk
20420         glibc 2.10 fixed pole error bug
20421             http://sourceware.org/bugzilla/show_bug.cgi?id=6759
20422             was resolved.
20423
20424 cerf.3
20425     Michael Kerrisk
20426         Make it clearer that this function is unimplemented
20427
20428 cos.3
20429     Michael Kerrisk
20430         errno is now correctly set to EDOM on a domain error
20431             http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780
20432             was (silently) resolved.
20433
20434 expm1.3
20435     Michael Kerrisk
20436         errno is now correctly set to ERANGE on a range error
20437             http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788
20438             was (silently) resolved.
20439
20440 fmod.3
20441     Michael Kerrisk
20442         errno is now correctly set to EDOM for the x==inf domain error
20443             http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784
20444             was (silently) resolved.
20445
20446 insque.3
20447     Michael Kerrisk
20448         Noted prev == NULL bug in glibc 2.4 and earlier
20449             As noted by Remi Denis-Courmont, glibc nowadays allows
20450             'prev' to be NULL, as required by POSIX for initializing
20451             a linear list. But in glibc 2.4 and earlier, 'prev' could
20452             not be NULL. Add a BUGS section noting this.
20453
20454             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=551201
20455     Michael Kerrisk
20456         Added info on circular lists, and initializing circular lists
20457     Michael Kerrisk
20458         Added example program
20459
20460 lgamma.3
20461     Michael Kerrisk
20462         glibc 2.10 fixed pole error bug
20463             http://sourceware.org/bugzilla/show_bug.cgi?id=6777
20464             was (silently) resolved.
20465
20466 log2.3
20467     Matthew Flaschen
20468         log2() function does not conform to C89
20469             log2(), log2f(), and log2l() do not conform to C89.
20470             They are defined in C99.  See http://flash-gordon.me.uk/ansi.c.txt
20471             and http://www.schweikhardt.net/identifiers.html
20472
20473 mq_notify.3
20474     Michael Kerrisk
20475         Factor out generic material that was moved to new sigevent(7) page
20476
20477 pow.3
20478     Michael Kerrisk
20479         errno is now correctly set to ERANGE on a pole error
20480             http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776
20481             was (silently) resolved.
20482
20483 pthread_kill_other_threads_np.3
20484     Michael Kerrisk
20485         CONFORMING TO: Note meaning of "_np" suffix
20486
20487 rand.3
20488     Michael Kerrisk
20489         Clarify description of range of returned value
20490     Michael Kerrisk
20491         Add an example program
20492     Michael Kerrisk
20493         Expand description of rand_r()
20494
20495 random.3
20496     W. Trevor King
20497         Update initstate() return value description to match glibc
20498
20499 readdir.3
20500     Michael Kerrisk
20501         Clarify that "positive error numbers" are listed in ERRORS
20502
20503 rexec.3
20504     Michael Kerrisk
20505         SYNOPSIS: Add header file and feature test macro requirements
20506
20507 sigpause.3
20508     Michael Kerrisk
20509         Correct discussion of when BSD vs SysV version is used in glibc
20510
20511 sin.3
20512     Michael Kerrisk
20513         errno is now correctly set to EDOM on a domain error
20514             http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781
20515             was (silently) resolved.
20516
20517 tan.3
20518     Michael Kerrisk
20519         errno is now correctly set to EDOM on a domain error
20520             http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782
20521             was (silently) resolved.
20522
20523 wcscasecmp.3
20524 wcsncasecmp.3
20525 wcsnlen.3
20526     Michael Kerrisk
20527         Added VERSIONS section
20528
20529 boot.7
20530     Yuri Kozlov
20531         Update list of major Linux distributions
20532
20533 feature_test_macros.7
20534     Michael Kerrisk
20535         Make text on required placement of macros more prominent
20536             Move the text that notes the requirement that feature test macros
20537             must be defined before including any header files to the top of
20538             the page, and highlight the text further, so that the reader will
20539             not miss this point.
20540
20541 pthreads.7
20542 signal.7
20543     Michael Kerrisk
20544         Add SEE ALSO reference to new sigevent(7) page
20545
20546 tcp.7
20547     Michael Kerrisk
20548         Clarify header file details for SIOCINQ and SIOCOUTQ
20549             Also note synonymous FIONREAD and TIOCOUTQ.
20550
20551
20552 ==================== Changes in man-pages-3.28 ====================
20553
20554 Released: 2010-10-04, Munich
20555
20556
20557 Contributors
20558 ------------
20559
20560 The following people contributed notes, ideas, or patches that have
20561 been incorporated in changes in this release:
20562
20563 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
20564 Denis Barbier <bouzim@gmail.com>
20565 Jan Kara <jack@suse.cz>
20566 Landijk <landijk-user@yahoo.com>
20567 Lennart Poettering <mzjro@0pointer.net>
20568 Michael Haardt <michael@moria.de>
20569 Michael Kerrisk <mtk.manpages@gmail.com>
20570 Petr Baudis <pasky@suse.cz>
20571 Sam Varshavchik <mrsam@courier-mta.com>
20572
20573 Apologies if I missed anyone!
20574
20575
20576 New and rewritten pages
20577 -----------------------
20578
20579 getaddrinfo_a.3
20580     Petr Baudis
20581         New page documenting getaddrinfo_a()
20582             The page also documents gai_suspend(), gai_cancel(),
20583             and gai_error().
20584
20585 aio.7
20586     Michael Kerrisk
20587         New page providing an overview of POSIX asynchronous I/O
20588
20589
20590 Newly documented interfaces in existing pages
20591 ---------------------------------------------
20592
20593 exec.3
20594     Michael Kerrisk
20595         Document execvpe()
20596             This function was added to glibc in version 2.11.
20597             Also various other small rewrites in the page.
20598
20599
20600 New and changed links
20601 ---------------------
20602
20603 gai_cancel.3
20604 gai_error.3
20605 gai_suspend.3
20606     Petr Baudis
20607         New links to new getaddrinfo_a.3 page
20608
20609 error_one_per_line.3
20610     Michael Kerrisk
20611          Fix misnamed link file (was error_on_per_line.3)
20612
20613 execvpe.3
20614     Michael Kerrisk
20615         New link to exec.3
20616
20617 sigstack.3
20618     Michael Kerrisk
20619         New link to sigaltstack.2
20620             No new programs should use sigstack(3). Point the user to the
20621             better sigalstack(2), whose man page briefly mentions sigstack(3).
20622
20623 vlimit.3
20624     Michael Kerrisk
20625         New link to getrlimit.2
20626             No new programs should use vlimit(3). Point the user to the
20627             better setrlimit(2), whose man page briefly mentions vlimit(3).
20628
20629 vtimes.3
20630     Michael Kerrisk
20631         New link to getrusage.2
20632             No new programs should use vtimes(3). Point the user to the
20633             better getrusage(2), whose man page briefly mentions vtimes(3).
20634
20635
20636 Global changes
20637 --------------
20638
20639 Various pages
20640     Michael Kerrisk
20641         Switch to American usage: "-wards" ==> "-ward"
20642             American English uses "afterward" in preference to "afterwards",
20643             and so on
20644
20645 chdir.2
20646 chmod.2
20647 chown.2
20648 gethostname.2
20649 getsid.2
20650 pread.2
20651 setpgid.2
20652 sigaltstack.2
20653 stat.2
20654 truncate.2
20655 wait.2
20656 dirfd.3
20657 getsubopt.3
20658 mkdtemp.3
20659 mkstemp.3
20660 siginterrupt.3
20661 strdup.3
20662     Michael Kerrisk
20663         Simplify feature test macro requirements
20664
20665
20666 Changes to individual pages
20667 ---------------------------
20668
20669 getrlimit.2
20670     Michael Kerrisk
20671         Add mention of the ancient vlimit() function
20672
20673 getrusage.2
20674     Michael Kerrisk
20675         Add mention of the ancient vtimes() function
20676
20677 io_cancel.2
20678 io_destroy.2
20679 io_getevents.2
20680 io_setup.2
20681 io_submit.2
20682     Michael Kerrisk
20683         SEE ALSO: add aio(7)
20684
20685 sched_setscheduler.2
20686     Michael Kerrisk
20687         ERRORS: note that NULL 'param' yields EINVAL
20688
20689 stat.2
20690     Michael Kerrisk
20691         Note feature test macro requirements for blkcnt_t and blksize_t
20692
20693 timer_create.2
20694     Michael Kerrisk
20695         Standardize on name 'sevp' for sigevent argument
20696
20697 truncate.2
20698     Michael Kerrisk
20699         Correct and simplify ftruncate() feature test macro requirements
20700             The glibc 2.12 feature test macro requirements for ftruncate() are
20701             buggy; see http://sourceware.org/bugzilla/show_bug.cgi?id=12037.
20702             Corrected the requirements in the SYNOPSIS, and added a BUGS
20703             section describing the problem in glibc 2.12.
20704
20705 aio_cancel.3
20706     Michael Kerrisk
20707         Add pointer to aio(7) for example program
20708         Refer the reader to aio(7) for a description of the aiocb structure
20709         CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20710
20711 aio_error.3
20712     Michael Kerrisk
20713         Wording improvements in RETURN VALUE
20714         Add pointer to aio(7) for example program
20715         Refer the reader to aio(7) for a description of the aiocb structure
20716         CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20717
20718 aio_fsync.3
20719     Michael Kerrisk
20720         Refer the reader to aio(7) for a description of the aiocb structure
20721         CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20722
20723 aio_read.3
20724     Michael Kerrisk
20725         Various minor rewordings and additions
20726         Add pointer to sigevent(7) for details of notification of I/O completion
20727         Add pointer to aio(7) for example program
20728         Refer the reader to aio(7) for a description of the aiocb structure
20729         CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20730
20731 aio_return.3
20732     Michael Kerrisk
20733         Improve description in RETURN VALUE
20734         Add pointer to aio(7) for example program
20735         Refer the reader to aio(7) for a description of the aiocb structure
20736         CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20737
20738 aio_suspend.3
20739     Michael Kerrisk
20740         Various additions and rewordings.
20741             Give some arguments more meaningful names.
20742             More explicitly describe the 'nitems' argument.
20743             Explicitly note that return is immediate if an I/O operation
20744             has already completed.
20745             Note that aio_error(3) should be used to scan the aiocb list
20746             after a successful return.
20747             Add references to other relevant pages.
20748             Various other pieces rewritten.
20749         Refer the reader to aio(7) for a description of the aiocb structure
20750         CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20751
20752 aio_write.3
20753     Michael Kerrisk
20754         Add pointer to sigevent(7) for details of notification of I/O completion
20755         Various minor rewordings and additions
20756         Refer the reader to aio(7) for a description of the aiocb structure
20757         CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20758
20759 clearenv.3
20760     Michael Kerrisk
20761         Fix error in feature test macro requirements
20762
20763 dysize.3
20764     Michael Kerrisk
20765         Remove crufty statement about old SCO bug
20766
20767 exec.3
20768     Michael Kerrisk
20769         Add feature test macro requirements for execvpe()
20770         Rewrite description of PATH and mention _CS_PATH
20771         Note execvp() and execlp() behavior for filename containing a slash
20772
20773 getaddrinfo.3
20774     Michael Kerrisk
20775         Add SEE ALSO reference to new getaddrinfo_a.3 page
20776
20777 gethostbyname.3
20778     Michael Kerrisk
20779         Fix formatting of feature test macros
20780
20781 getw.3
20782     Michael Kerrisk
20783         Fix feature test macros
20784
20785 malloc.3
20786     Landijk
20787         Remove editorializing comments on memory overcommitting
20788             See https://bugzilla.kernel.org/show_bug.cgi?id=19332
20789     Michael Kerrisk
20790         Various minor reorganizations and wording fix-ups
20791
20792 mq_notify.3
20793     Michael Kerrisk
20794         Standardize on name 'sevp' for sigevent argument
20795
20796 nl_langinfo.3
20797     Michael Haardt
20798         Make it clear that nl_langinfo() interacts with setlocale()
20799         Add an example program
20800
20801 posix_openpt.3
20802     Michael Kerrisk
20803         Fix feature test macro requirements
20804
20805 rand.3
20806     Michael Kerrisk
20807         Remove duplicate #include in example program
20808
20809 strtok.3
20810     Petr Baudis
20811         Add reference to strtok() example in getaddrinfo(3)
20812
20813 inotify.7
20814     Michael Kerrisk
20815         Added section noting limitations and caveats of inotify
20816
20817 sigevent.7
20818     Michael Kerrisk
20819         Add SEE ALSO reference to new getaddrinfo_a.3 page
20820         Add SEE ALSO referring to new aio(7) page
20821
20822 suffixes.7
20823     Michael Kerrisk
20824         Change explanation of ".rpm" to "RPM software package"
20825
20826
20827 ==================== Changes in man-pages-3.29 ====================
20828
20829 Released: 2010-10-19, Detroit
20830
20831
20832 Contributors
20833 ------------
20834
20835 The following people contributed notes, ideas, or patches that have
20836 been incorporated in changes in this release:
20837
20838 Balazs Scheidler <bazsi@balabit.hu>
20839 David Prevot <davidp@altern.org>
20840 Denis Barbier <bouzim@gmail.com>
20841 Guillem Jover <guillem@hadrons.org>
20842 Ivana Varekova <varekova@redhat.com>
20843 Lennart Poettering <mzxreary@0pointer.de>
20844 Michael Kerrisk <mtk.manpages@gmail.com>
20845 Sam Varshavchik <mrsam@courier-mta.com>
20846 Simon Paillard <simon.paillard@resel.enst-bretagne.fr>
20847 Stephan Mueller <stephan.mueller@atsec.com>
20848 Thomas Jarosch <thomas.jarosch@intra2net.com>
20849 Yuri Kozlov <yuray@komyakino.ru>
20850
20851 Apologies if I missed anyone!
20852
20853
20854 New and rewritten pages
20855 -----------------------
20856
20857 subpage_prot.2
20858     Michael Kerrisk
20859         New page documenting the PowerPC-specific subpage_prot(2)
20860
20861 aio_init.3
20862     Michael Kerrisk
20863         New page documenting aio_init(3)
20864
20865
20866 Newly documented interfaces in existing pages
20867 ---------------------------------------------
20868
20869 posix_fadvise.2
20870     Michael Kerrisk
20871         Document the architecture-specific arm_fadvise64_64() system call
20872             This ARM-specific system call fixes the argument ordering
20873             for that architecture. Since Linux 2.6.14.
20874
20875 sync_file_range.2
20876     Michael Kerrisk
20877         Document the architecture-specific sync_file_range2() system call
20878             As described in commit edd5cd4a9424f22b0fa08bef5e299d41befd5622,
20879             the sync_file_range() argument order is broken for some
20880             architectures (PowerPC, ARM, tile). The remedy was a different
20881             system call using the right argument order on those architectures.
20882
20883 psignal.3
20884     Guillem Jover
20885         Document psiginfo()
20886             psiginfo() was added to glibc in version 2.10.
20887     Michael Kerrisk
20888         Add details, VERSIONS, and BUGS for psiginfo()
20889
20890 ip.7
20891     Balazs Scheidler
20892         Document IP_RECVORIGDSTADDR
20893         Document IP_TRANSPARENT
20894     Michael Kerrisk
20895         Document IP_FREEBIND
20896             Text based on input from Lennart Poettering and Balazs Scheidler.
20897             See https://bugzilla.kernel.org/show_bug.cgi?id=20082
20898
20899
20900 New and changed links
20901 ---------------------
20902
20903 arm_fadvise64_64.2
20904     Michael Kerrisk
20905         New link to posix_fadvise.2
20906
20907 arm_sync_file_range.2, sync_file_range2.2
20908     Michael Kerrisk
20909         New links to sync_file_range.2
20910
20911 arrm_fadvise.2
20912     Michael Kerrisk
20913         New link to posix_fadvise.2
20914
20915 psiginfo.3
20916     Guillem Jover
20917         New link to psignal.3
20918
20919
20920 Global changes
20921 --------------
20922
20923 Many pages
20924     Michael Kerrisk
20925         global fix: s/Unix/UNIX/
20926             The man pages were rather inconsistent in the use of "Unix"
20927             versus "UNIX". Let's go with the trademark usage.
20928
20929 Various pages
20930     Michael Kerrisk
20931         Global fix: s/pseudo-terminal/pseudoterminal/
20932
20933 grantpt.3, ptsname.3, unlockpt.3, pts.4
20934     Michael Kerrisk
20935         Global fix: s/pty/pseudoterminal/
20936
20937 recv.2, cmsg.3, unix.7
20938     Michael Kerrisk
20939         global fix: s/UNIX socket/UNIX domain socket/
20940
20941 fmtmsg.3, gethostbyname.3, termios.3
20942     Michael Kerrisk
20943         Global fix: s/Unixware/UnixWare/
20944
20945
20946 Changes to individual pages
20947 ---------------------------
20948
20949 inotify_rm_watch.2
20950     Michael Kerrisk
20951         SYNOPSIS: fix type of 'wd' argument
20952
20953 posix_fadvise.2
20954     Michael Kerrisk
20955         Rewrite VERSIONS, noting that the system call is fadvise64()
20956
20957 syscalls.2
20958     Michael Kerrisk
20959         Add the PowerPC-specific subpage_prot() system call
20960         Add sync_file_range2()
20961
20962 truncate.2
20963     Michael Kerrisk
20964         Fix feature test macros
20965
20966 aio_cancel.3
20967 aio_error.3
20968 aio_fsync.3
20969 aio_read.3
20970 aio_return.3
20971 aio_suspend.3
20972 aio_write.3
20973     Michael Kerrisk
20974         SEE ALSO: Add lio_listio(3)
20975
20976 gai_cancel.3
20977 gai_error.3
20978 gai_suspend.3
20979     Michael Kerrisk
20980         Make these into links
20981             In the previous release, these files were accidentally made copies
20982             of getaddrinfo_a.3, instead of being made as link files.
20983
20984 getifaddrs.3
20985     Thomas Jarosch
20986         Prevent possible NULL pointer access in example program
20987
20988 malloc.3
20989     Michael Kerrisk
20990         Emphasize that malloc() and realloc() do not initialize allocated memory
20991
20992 malloc_hook.3
20993     Ivana Varekova
20994         Warn that these functions are deprecated
20995
20996 strcpy.3
20997     Michael Kerrisk
20998         Formatting fixes in strncpy() example implementation code
20999
21000 ip.7
21001     Michael Kerrisk
21002         Reword NOTES on Linux-specific options
21003
21004 sigevent.7
21005     Michael Kerrisk
21006         SEE ALSO: Add aio_read(3), aio_write(3), and lio_listio(3)
21007
21008 unix.7
21009     Michael Kerrisk
21010         Document the autobind feature
21011     Michael Kerrisk
21012         Fix description of abstract socket names
21013             As reported by Lennart Poettering:
21014                 The part about "abstract" sockets is misleading as it suggests
21015                 that the sockaddr returned by getsockname() would necessarily
21016                 have the size of sizeof(struct sockaddr), which however is not
21017                 the case: getsockname() returns exactly the sockaddr size that
21018                 was passed in on bind(). In particular, two sockets that are
21019                 bound to the same sockaddr but different sizes are completely
21020                 independent.
21021             See https://bugzilla.kernel.org/show_bug.cgi?id=19812
21022     Michael Kerrisk
21023         Fix description of "pathname" sockets
21024             As reported by Lennart Poettering:
21025                The part about "pathname" sockets suggests usage of
21026                sizeof(sa_family_t) + strlen(sun_path) + 1
21027                for calculating the sockaddr size. Due to alignment/padding
21028                this is probably not a good idea. Instead, one should use
21029                offsetof(struct sockaddr_un, sun_path) + strlen() + 1
21030                or something like that.
21031             See https://bugzilla.kernel.org/show_bug.cgi?id=19812
21032
21033
21034 ==================== Changes in man-pages-3.30 ====================
21035
21036 Released: 2010-11-01, Munich
21037
21038
21039 Contributors
21040 ------------
21041
21042 The following people contributed notes, ideas, or patches that have
21043 been incorporated in changes in this release:
21044
21045 Andi Kleen <andi@firstfloor.org>
21046 Bernhard Walle <bernhard@bwalle.de>
21047 David Prevot <davidp@altern.org>
21048 Eric W. Biederman <ebiederm@xmission.com>
21049 Florian Lehmann <flo.lehmann@googlemail.com>
21050 Jan Engelhardt <jengelh@medozas.de>
21051 Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
21052 Michael Kerrisk <mtk.manpages@gmail.com>
21053 Paul Mackerras <paulus@samba.org>
21054 Pádraig Brady <P@draigbrady.com>
21055 Reuben Thomas <rrt@sc3d.org>
21056 scarlettsp <scarlettsp@gmail.com>
21057 Yuri Kozlov <yuray@komyakino.ru>
21058
21059 Apologies if I missed anyone!
21060
21061
21062 New and rewritten pages
21063 -----------------------
21064
21065 kexec_load.2
21066     Andi Kleen
21067         New page documenting kexec_load(2)
21068     Michael Kerrisk
21069         Add license
21070     Michael Kerrisk
21071         Incorporate fixes from Eric W. Biederman
21072             Eric noted that a few instances of "virtual" should
21073             be "physical" and noted:
21074
21075                 There is an expectation that at hand off from sys_kexec that
21076                 virtual and physical addresses will be identity mapped. But
21077                 this isn't the old Alpha booting convention where you have
21078                 a virtual address and then you have to parse the page table
21079                 to figure out where your kernel was actually loaded.
21080     Michael Kerrisk
21081         Additions and edits by mtk
21082             Various wording and layout improvements.
21083             Fixed the name of a constant: s/KEXEC_ARCH_I386/KEXEC_ARCH_386/.
21084             Added RETURN VALUE and ERRORS sections.
21085             Added VERSIONS section
21086             Note that CONFIG_KEXEC is needed
21087             Removed details of using syscall; the reader can find them in
21088             syscall(2).
21089             Added some details for KEXEC_PRESERVE_CONTEXT.
21090             Revised the text mentioning the kernel header, since it is
21091             not yet exported, and it's not certain that it will be.
21092
21093 lio_listio.3
21094     Michael Kerrisk
21095         New page documenting lio_listio(3)
21096
21097
21098 Newly documented interfaces in existing pages
21099 ---------------------------------------------
21100
21101 reboot.2
21102     Andi Kleen
21103         Document LINUX_REBOOT_KEXEC
21104             Some fix-ups by Michael Kerrisk
21105     Michael Kerrisk
21106         Place 'cmd' values in alphabetical order.
21107
21108 unshare.2
21109     Michael Kerrisk
21110         Document CLONE_NEWIPC
21111     Michael Kerrisk
21112         Document CLONE_NEWNET
21113     Lucian Adrian Grijincu
21114         Improve description of CLONE_NEWNET
21115             CLONE_NEWNET creates a new network namespace from scratch.
21116             You don't have anything from the old network namespace in
21117             the new one. Even the loopback device is new.
21118     Michael Kerrisk
21119         Document CLONE_SYSVSEM
21120     Michael Kerrisk
21121         Document CLONE_NEWUTS
21122     Michael Kerrisk
21123         Relocate discussion of CAP_SYS_ADMIN to CLONE_NEWNS section
21124             And rewrite the EPERM description to be more general in
21125             preparation for the new flags to be documented.
21126
21127
21128 Global changes
21129 --------------
21130
21131 Various pages
21132     Michael Kerrisk
21133         Add reference to feature_test_macros(7)
21134             Some pages simply list feature test macro requirements in
21135             the form:
21136
21137                 #define #GNU_SOURCE
21138                 #include <someheader.h>
21139
21140             For these pages, add a "See feature_test_macros(7)" comment
21141             on the "#define" line.
21142
21143 Various pages
21144     Michael Kerrisk
21145         SEE ALSO: Remove redundant reference to feature_test_macros(7)
21146
21147 Various pages
21148     David Prevot
21149         Use greater consistency in NAME line
21150         (Remove definite article at start of descriptive clause.)
21151
21152 Various pages
21153     Michael Kerrisk
21154         SEE ALSO: Place entries in correct order
21155
21156 Various pages
21157     Michael Kerrisk
21158         ERRORS: Place entries in correct order
21159
21160 Various pages
21161     Michael Kerrisk
21162         Add section number to references to functions documented in other pages
21163
21164 Various pages
21165     Michael Kerrisk
21166         Remove redundant section number in page references
21167             Remove section number in function references that are for
21168             functions documented on this page.
21169
21170 armscii-8.7
21171 iso_8859-3.7
21172 iso_8859-4.7
21173 iso_8859-5.7
21174 iso_8859-6.7
21175 iso_8859-10.7
21176 iso_8859-11.7
21177 iso_8859-13.7
21178 iso_8859-14.7
21179 koi8-u.7
21180     David Prevot
21181         Capitalize hexadecimal numbers
21182
21183
21184 Changes to individual pages
21185 ---------------------------
21186
21187 access.2
21188     Michael Kerrisk
21189         Note use of faccessat(2) for checking symbolic link permissions
21190     Michael Kerrisk
21191         Give an example of a safer alternative to using access()
21192
21193 clone.2
21194     Michael Kerrisk
21195         Clarify when CLONE_NEWNET implementation was completed
21196
21197 faccessat.2
21198     Michael Kerrisk
21199         Note that faccessat() is racy
21200
21201 fcntl.2
21202     Michael Kerrisk
21203         RETURN VALUE: Improve description of F_GETFD and F_GETFL
21204
21205 inotify_add_watch.2
21206     Michael Kerrisk
21207         Document ENOENT error
21208
21209 mlock.2
21210     Michael Kerrisk
21211         Improve wording describing /proc/PID/status /VmLck field
21212     Michael Kerrisk
21213         shmctl() SHM_LOCKed memory is not included in VmLck
21214
21215 reboot.2
21216     Michael Kerrisk
21217         Place 'cmd' values in alphabetical order
21218
21219 subpage_prot.2
21220     Michael Kerrisk
21221         Change 1-line page description
21222     Michael Kerrisk
21223         Improvements after review by Paul Mackerras
21224
21225 timer_settime.3
21226     Michael Kerrisk
21227         Remove redundant SEE ALSO reference
21228
21229 euidaccess.3
21230     Michael Kerrisk
21231         Note the use of faccessat(2) to operate on symbolic links
21232     Michael Kerrisk
21233         Note that the use of euidaccess() is racy
21234
21235 fenv.3
21236     Michael Kerrisk
21237         Clarify wording relating to glibc version
21238
21239 getgrent.3
21240 getgrent_r.3
21241 getgrnam.3
21242     Michael Kerrisk
21243         Refer reader for group(5) for more info on group structure
21244
21245 getopt.3
21246     Bernhard Walle
21247         Use constants in getopt_long() example
21248             The description of getopt_long() mentions the constants
21249             required_argument, no_argument and optional_argument.
21250             Use them in the example to make the code easier to understand.
21251
21252 getpw.3
21253     Michael Kerrisk
21254         Change comment describing pw_gecos
21255
21256 getpw.3
21257 getpwent.3
21258 getpwent_r.3
21259     Michael Kerrisk
21260         Refer reader to passwd(5) for more info on the passwd structure
21261
21262 getpwent.3
21263 getpwnam.3
21264     Michael Kerrisk
21265         Note that pw_gecos is not in POSIX
21266             And change the comment describing this field
21267
21268 getpwent_r.3
21269     Michael Kerrisk
21270         Change comment describing pw_gecos
21271
21272 getpwnam.3
21273     Michael Kerrisk
21274         Some rewording and restructuring
21275
21276 sched_getcpu.3
21277     Michael Kerrisk
21278         Fix feature test macro requirements
21279
21280 strnlen.3
21281     Michael Kerrisk
21282         Fix feature test macro requirements
21283
21284 group.5
21285     Michael Kerrisk
21286         Various minor rewordings
21287
21288 hosts.5
21289 protocols.5
21290 spufs.7
21291 termio.7
21292     David Prevot
21293         Remove definite article from NAME section
21294             Please find inline another tiny patch in order to shrink
21295             the definite article from some other pages (found with
21296             "rgrep -i ' \\\- the' man*").
21297
21298 passwd.5
21299     Michael Kerrisk
21300         Various minor rewordings
21301
21302 proc.5
21303     Michael Kerrisk
21304         Add reference to mlock(2) for further info on /proc/PID/status VmLck
21305
21306 armscii-8.7
21307     David Prevot
21308         Write the character set name as ArmSCII
21309
21310 cp1251.7
21311     David Prevot
21312         Capitalize hexadecimal numbers
21313
21314 ip.7
21315     David Prevot
21316         Fix name of socket option: s/IP_TTL/IP_TRANSPARENT/
21317     David Prevot
21318         Place socket options in alphabetical order
21319
21320 koi8-r.7
21321     David Prevot
21322         Fix special character names
21323             Comparing to koi8-u.7, I noticed some inconsistencies in special
21324             character names. After checking with the following Unicode related
21325             pages, please find inline (and gzipped attached, hopefully not
21326             messing with encoding), a patch in order to make it right, on an
21327             Unicode point of view.
21328
21329             http://www.unicode.org/charts/PDF/U2500.pdf
21330             http://www.unicode.org/charts/PDF/U25A0.pdf
21331             http://www.unicode.org/charts/PDF/U0080.pdf
21332             http://www.unicode.org/charts/PDF/U1D400.pdf
21333     David Prevot
21334         Fix SEE ALSO reference and letter names
21335             The koi8-r(7) (Russian Net Character Set) manual page refers
21336             to iso-8859-7(7) manual page, which is the Latin/Greek one.
21337             I guess it should refer instead to the iso-8859-5(7)
21338             (Latin/Cyrillic) one. This is addressed at the end of the patch.
21339
21340             It has also been spotted that letter names are different in
21341             this manual page and in the Unicode related page [0], the
21342             first part of the page address this.
21343
21344                     0: http://www.unicode.org/charts/PDF/U0400.pdf
21345
21346 man-pages.7
21347     Michael Kerrisk
21348         Update example
21349             The old example used the chmod(2) man page, but the
21350             feature test macro requirements on that page had changed.
21351             Update to use an example from a different page (acct(2),
21352             whose feature test macro requirements are probably unlikely
21353             to change in the future).
21354
21355
21356 ==================== Changes in man-pages-3.31 ====================
21357
21358 Released: 2010-11-12, Munich
21359
21360
21361 Contributors
21362 ------------
21363
21364 The following people contributed notes, ideas, or patches that have
21365 been incorporated in changes in this release:
21366
21367 Andi Kleen <andi@firstfloor.org>
21368 David Prevot <davidp@altern.org>
21369 Denis Barbier <bouzim@gmail.com>
21370 Krzysztof Żelechowski <giecrilj@stegny.2a.pl>
21371 Michael Kerrisk <mtk.manpages@gmail.com>
21372 Yuri Kozlov <yuray@komyakino.ru>
21373
21374 Apologies if I missed anyone!
21375
21376
21377 Newly documented interfaces in existing pages
21378 ---------------------------------------------
21379
21380 getrlimit.2
21381     Michael Kerrisk
21382         Added documentation of prlimit()
21383             prlimit() is new in kernel 2.6.36.
21384
21385 inotify.7
21386     Michael Kerrisk
21387         Document IN_EXCL_UNLINK
21388             This flag was added in Linux 2.6.36.
21389             See kernel commit 8c1934c8d70b22ca8333b216aec6c7d09fdbd6a6.
21390
21391
21392 New and changed links
21393 ---------------------
21394
21395 prlimit.2
21396     Michael Kerrisk
21397         New link to getrlimit.2
21398
21399
21400 Changes to individual pages
21401 ---------------------------
21402
21403 getrlimit.2
21404     Michael Kerrisk
21405         Remove unneeded text in DESCRIPTION
21406
21407 intro.2
21408     Michael Kerrisk
21409         Added various pages to SEE ALSO
21410
21411 kexec_load.2
21412     Michael Kerrisk
21413         Add kernel version where KEXEC_PRESERVE_CONTEXT first appeared
21414         Added kernel version number where KEXEC_ON_CRASH first appeared
21415         Fix copyright
21416             Make copyright in the name of Intel corporation
21417         VERSIONS: Fix version number
21418             kexec_load() was first implemented in 2.6.13, though the entry
21419             in the system call table was reserved starting in 2.6.7.
21420
21421 migrate_pages.2
21422     Michael Kerrisk
21423         SEE ALSO: Add reference to Documentation/vm/page_migration
21424
21425 sched_setaffinity.2
21426     Michael Kerrisk
21427         Add missing word "real" to "user ID"
21428
21429 syscalls.2
21430     Michael Kerrisk
21431         Fix kernel version number for kexec_load
21432             kexec_load() was first implemented in 2.6.13, though the entry
21433             in the system call table was reserved starting in 2.6.7.
21434     Michael Kerrisk
21435         Add prlimit() to list
21436
21437 intro.3
21438     Michael Kerrisk
21439         Added various pages to SEE ALSO
21440
21441 printf.3
21442     Michael Kerrisk
21443         Formatting fixes in example code
21444
21445 hostname.7
21446     Michael Kerrisk
21447         Small improvement to description of domains
21448             See: https://bugzilla.novell.com/show_bug.cgi?id=651900
21449
21450
21451 ==================== Changes in man-pages-3.32 ====================
21452
21453 Released: 2010-12-03, Munich
21454
21455
21456 Contributors
21457 ------------
21458
21459 The following people contributed notes, ideas, or patches that have
21460 been incorporated in changes in this release:
21461
21462 A. Costa <agcosta@gis.net>
21463 Denis Barbier <bouzim@gmail.com>
21464 Emil Mikulic <emikulic@gmail.com>
21465 Eugene Kapun <abacabadabacaba@gmail.com>
21466 Hugh Dickins <hughd@google.com>
21467 Ivana Hutarova Varekova <varekova@redhat.com>
21468 Joern Heissler <kernelbugs@joern.heissler.de>
21469 Lars Wirzenius <liw@liw.fi>
21470 Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
21471 Michael Kerrisk <mtk.manpages@gmail.com>
21472 Petr Uzel <petr.uzel@suse.cz>
21473 Roger Pate <roger@qxxy.com>
21474 Török Edwin <edwintorok@gmail.com>
21475 Yuri Kozlov <yuray@komyakino.ru>
21476
21477 Apologies if I missed anyone!
21478
21479
21480 New and rewritten pages
21481 -----------------------
21482
21483 pthread_sigqueue.3
21484     Michael Kerrisk
21485         New page documenting pthread_sigqueue()
21486             pthread_sigqueue() is new in glibc 2.11 (requires a kernel with
21487             rt_tgsigqueinfo(), added in Linux 2.6.31).
21488
21489
21490 Newly documented interfaces in existing pages
21491 ---------------------------------------------
21492
21493 readv.2
21494     Michael Kerrisk
21495         Add documentation of preadv() and pwritev()
21496             The preadv() and pwritev() system calls were added in
21497             Linux 2.6.30.
21498
21499
21500 New and changed links
21501 ---------------------
21502
21503 preadv.2
21504     Michael Kerrisk
21505         New link to readv.2
21506
21507 pwritev.2
21508     Michael Kerrisk
21509         New link to readv.2
21510
21511
21512 Changes to individual pages
21513 ---------------------------
21514
21515 chdir.2
21516     Michael Kerrisk
21517         Remove redundant and incorrect info on FTMs from NOTES
21518
21519 chown.2
21520     Michael Kerrisk
21521         Add NOTES explaining 32-bit system calls added in Linux 2.4
21522
21523 clock_nanosleep.2
21524     Michael Kerrisk
21525         Clarify that clock_nanosleep() suspends the calling *thread*
21526
21527 epoll_create.2
21528     Michael Kerrisk
21529         Note that 'size' argument must be greater than 0
21530             See https://bugzilla.kernel.org/show_bug.cgi?id=23872
21531     Michael Kerrisk
21532         Added VERSIONS section
21533
21534 epoll_ctl.2
21535     Michael Kerrisk
21536         Added VERSIONS section
21537
21538 epoll_wait.2
21539     Michael Kerrisk
21540         Updated VERSIONS section
21541
21542 fcntl.2
21543     Michael Kerrisk
21544         Add notes on fcntl64()
21545
21546 fstatat.2
21547     Michael Kerrisk
21548         Add NOTES on fstatat64(), the name of the underlying system call
21549
21550 getdents.2
21551     Michael Kerrisk
21552         Added notes on getdents64()
21553
21554 getgid.2
21555     Michael Kerrisk
21556         Add NOTES explaining 32-bit system calls added in Linux 2.4
21557
21558 getgroups.2
21559     Michael Kerrisk
21560         Add NOTES explaining 32-bit system calls added in Linux 2.4
21561
21562 getpagesize.2
21563     Michael Kerrisk
21564         Improve description of getpagesize()
21565             Improve description of getpagesize() and relocate discussion
21566             of sysconf(_SC_PAGESIZE).
21567
21568             In part inspired by
21569             http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=537272
21570
21571 getresuid.2
21572     Michael Kerrisk
21573         Add NOTES explaining 32-bit system calls added in Linux 2.4
21574
21575 getrlimit.2
21576     Michael Kerrisk
21577         Add example program for prlimit()
21578
21579 getuid.2
21580     Michael Kerrisk
21581         Add NOTES explaining 32-bit system calls added in Linux 2.4
21582
21583 open.2
21584     Ivana Hutarova Varekova
21585         O_EXCL can be used without O_CREAT for block devices
21586             Since Linux 2.6 there is a possibility to use O_EXCL without
21587             O_CREAT. See patch: http://lkml.org/lkml/2003/8/10/221.
21588
21589 pread.2
21590     Michael Kerrisk
21591         Add notes on pread64() and pwrite64()
21592             See https://bugzilla.kernel.org/show_bug.cgi?id=23072
21593     Michael Kerrisk
21594         SEE ALSO: add readv(3)
21595
21596 readv.2
21597     Michael Kerrisk
21598         Wording fix: readv() and writev() are system calls, not functions
21599
21600 sendfile.2
21601     Michael Kerrisk
21602         Add notes on sendfile64()
21603
21604 setfsgid.2
21605     Michael Kerrisk
21606         Add NOTES explaining 32-bit system calls added in Linux 2.4
21607
21608 setfsuid.2
21609     Michael Kerrisk
21610         Add NOTES explaining 32-bit system calls added in Linux 2.4
21611
21612 setgid.2
21613     Michael Kerrisk
21614         Add NOTES explaining 32-bit system calls added in Linux 2.4
21615
21616 setresuid.2
21617     Michael Kerrisk
21618         Add NOTES explaining 32-bit system calls added in Linux 2.4
21619
21620 setreuid.2
21621     Michael Kerrisk
21622         Add NOTES explaining 32-bit system calls added in Linux 2.4
21623
21624 setuid.2
21625     Michael Kerrisk
21626         Add NOTES explaining 32-bit system calls added in Linux 2.4
21627
21628 sigqueue.2
21629 pthreads.7
21630 signal.7
21631     Michael Kerrisk
21632         SEE ALSO: Add pthread_sigqueue(3)
21633
21634 stat.2
21635     Michael Kerrisk
21636         Fix EOVERFLOW error description
21637             2<<31 should read 1<<31 (which equals 2^31).
21638
21639 statfs.2
21640     Michael Kerrisk
21641         Add notes on statfs64() and fstatfs64()
21642
21643 swapon.2
21644     Hugh Dickins
21645         Document SWAP_FLAG_DISCARD and discarding of swap pages
21646
21647 truncate.2
21648     Michael Kerrisk
21649         Add notes on truncate64() and ftruncate64()
21650
21651 memcpy.3
21652     Michael Kerrisk
21653         Change "should not overlap" to "must not overlap"
21654             glibc 2.12 changed things so that applications that use memcpy() on
21655             overlapping regions will encounter problems. (The standards have
21656             long said that the behavious is undefined if the memory areas
21657             overlap.)
21658
21659             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=603144
21660             In reference of http://lwn.net/Articles/414467/
21661             and http://article.gmane.org/gmane.comp.lib.glibc.alpha/15278
21662
21663 usleep.3
21664     Petr Uzel
21665         usleep() suspends calling thread, not process
21666
21667 core.5
21668     Michael Kerrisk
21669         Change single quote to double quote in shell session example
21670             The example section has a sample shell session containing:
21671
21672             echo '|$PWD/core_pattern_pipe_test %p UID=%u GID=%g sig=%s'
21673
21674             But $PWD won't be expanded in single quotes. It should be double
21675             quotes around the entire argument or some other form.
21676
21677 pthreads.7
21678     Michael Kerrisk
21679         Added description of async-cancel-safe functions
21680
21681 unix.7
21682     Michael Kerrisk
21683         Reworded the text of various errors
21684     Michael Kerrisk
21685         Added ENOENT error
21686
21687
21688 ==================== Changes in man-pages-3.33 ====================
21689
21690 Released: 2011-09-16, Munich
21691
21692
21693 Contributors
21694 ------------
21695
21696 The following people contributed patches/fixes or (noted in brackets
21697 in the changelog below) reports, notes and ideas that have been
21698 incorporated in changes in this release:
21699
21700 Akira Fujita <a-fujita@rs.jp.nec.com>
21701 Alexander Schuch <Alex.Schuch@gmx.de>
21702 Andries Brouwer <Andries.Brouwer@cwi.nl>
21703 Brian M. Carlson <sandals@crustytoothpaste.net>
21704 Dan Jacobson <jidanni@jidanni.org>
21705 Folkert van Heusden <folkert.mobiel@gmail.com>
21706 Graham Gower <graham.gower@gmail.com>
21707 Hendrik Jan Thomassen <hjt@atcomputing.nl>
21708 Jan Engelhardt <jengelh@medozas.de>
21709 Joey Adams <joeyadams3.14159@gmail.com>
21710 Johannes Laire <johannes@laire.fi>
21711 Jon Grant <jg@jguk.org>
21712 Josh Triplett <josh@joshtriplett.org>
21713 Konstantin Ritt <ritt.ks@gmail.com>
21714 Luis Javier Merino <ninjalj@gmail.com>
21715 Michael Kerrisk <mtk.manpages@gmail.com>
21716 Mike Frysinger <vapier@gentoo.org>
21717 Mikel Ward <mikel@mikelward.com>
21718 Nick Black <dankamongmen@gmail.com>
21719 Paul Evans <leonerd@leonerd.org.uk>
21720 Petr Pisar <ppisar@redhat.com>
21721 Przemyslaw Pawelczyk <przemyslaw@pawelczyk.it>
21722 Regid Ichira <regid23@yahoo.com>
21723 Reuben Thomas <rrt@sc3d.org>
21724 Richard B. Kreckel <kreckel@ginac.de>
21725 Ryan Mullen <rmmullen@gmail.com>
21726 Sebastian Geiger <sbastig@gmx.net>
21727 Sebastian Unger <sebunger@gmx.net>
21728 Seonghun Lim <wariua@gmail.com>
21729 Serge E. Hallyn <serge.hallyn@canonical.com>
21730 Simon Cross <hodgestar@gmail.com>
21731 Simon Paillard <spaillard@debian.org>
21732 Stan Sieler <sieler@me.com>
21733 Timmy Lee <scuttimmy@gmail.com>
21734 Tolga Dalman <tolga.dalman@googlemail.com>
21735 Tomislav Jonjic <jonjic@cs.unibo.it>
21736 Yuri Kozlov <yuray@komyakino.ru>
21737 Wei Luosheng <weiluosheng001@gmail.com>
21738
21739 Apologies if I missed anyone!
21740
21741
21742 Newly documented interfaces in existing pages
21743 ---------------------------------------------
21744
21745 sync.2
21746     Michael Kerrisk
21747         Added new syncfs() system call
21748             syncfs() was added in Linux 2.6.39.
21749
21750
21751 New and changed links
21752 ---------------------
21753
21754 syncfs.2
21755     Michael Kerrisk
21756         New link for sync(2).
21757
21758
21759 Global changes
21760 --------------
21761
21762 Various pages
21763     Simon Paillard
21764         Global fix:  properly escape minus sign
21765
21766
21767 Changes to individual pages
21768 ---------------------------
21769
21770 clone.2
21771     Michael Kerrisk
21772         Note that CLONE_STOPPED was removed in 2.6.38
21773
21774 execve.2
21775     Michael Kerrisk  [Sebastian Geiger]
21776         Note that the first argv[] value should contain name of executable
21777
21778 fcntl.2
21779     Michael Kerrisk  [Reuben Thomas]
21780         Note that F_GETFL also retrieves file access mode
21781
21782 getrlimit.2
21783     Michael Kerrisk  [Ryan Mullen]
21784         Remove mention of kernel versions in discussion of RLIMIT_CPU
21785     Michael Kerrisk  [Seonghun Lim]
21786         Fix example program and add _FILE_OFFSET_BITS requirement
21787
21788 mlock.2
21789     Michael Kerrisk  [Brian M. Carlson]
21790         Clarify EINVAL error
21791             See http://bugs.debian.org/cgi-bin/bugreport.cgi?625747
21792     Michael Kerrisk  [Seonghun Lim]
21793         Simplify and correct text for EPERM error
21794
21795 mprotect.2
21796     Seonghun Lim
21797         Fix off-by-one error in a memory range
21798     Seonghun Lim
21799         Fix small bug in example program
21800             The description of the example program says that it makes the
21801             third page "read-only". Thus use PROT_READ instead of PROT_NONE.
21802
21803 open.2
21804     Folkert van Heusden
21805         Remove text describing O_CLOEXEC as Linux-specific
21806             O_CLOEXEC is specified in POSIX.1-2008, as noted
21807             elsewhere in the page.
21808
21809 readlink.2
21810     Michael Kerrisk  [Dan Jacobson]
21811         SEE ALSO: Add readlink(1)
21812
21813 sendfile.2
21814     Akira Fujita
21815         Since 2.6.33, 'out_fd' can refer to any file type
21816             Linux kernel commit cc56f7de7f00d188c7c4da1e9861581853b9e92f
21817             meant sendfile(2) can work with any output file.
21818     Michael Kerrisk
21819         Shift text on falling back to read()/write() to NOTES
21820     Michael Kerrisk  [Tolga Dalman]
21821         Remove mention of kernel version for 'in_fd' argument
21822     Tolga Dalman
21823         Add an explicit reference to splice(2)
21824             Unlike sendfile(), splice() can transfer data
21825             between a pair of sockets.
21826
21827 sigaction.2
21828     Michael Kerrisk  [Tolga Dalman]
21829         Add a little info about ucontext_t
21830
21831 stat.2
21832     Michael Kerrisk  [Jon Grant]
21833         Small rewording of ENAMETOOLONG error
21834
21835 sync.2
21836     Michael Kerrisk
21837         Some rewrites to description of sync()
21838
21839 syscalls.2
21840     Michael Kerrisk
21841         Added fanotify_init() and fanotify_mark() to syscall list
21842     Michael Kerrisk
21843         Added new 2.6.39 system calls
21844     Michael Kerrisk
21845         Updated for Linux 3.0 system calls
21846     Michael Kerrisk
21847         Update kernel version at head of syscall list
21848     Michael Kerrisk
21849         Update to mention 3.x kernel series
21850
21851 syslog.2
21852     Michael Kerrisk  [Serge E. Hallyn]
21853         Update for kernel 2.6.37 changes
21854             Document /proc/sys/kernel/dmesg_restrict.
21855             Document CAP_SYSLOG.
21856
21857 time.2
21858     Michael Kerrisk  [Alexander Schuch]
21859         NOTES: Fix description of "Seconds since the Epoch"
21860
21861 timerfd_create.2
21862     Michael Kerrisk  [Josh Triplett]
21863         Note behavior when timerfd_settime() old_value is NULL
21864         See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513
21865     Tomislav Jonjic
21866         Fix small error in description of timerfd_settime()
21867
21868 truncate.2
21869     Seonghun Lim
21870         Remove redundant EINTR description
21871
21872 unlink.2
21873     Hendrik Jan Thomassen
21874         Improve EBUSY description
21875
21876 cacos.3
21877 cacosh.3
21878 catan.3
21879 catanh.3
21880     Michael Kerrisk  [Richard B. Kreckel, Andries Brouwer]
21881         Fix formula describing function
21882             The man pages for cacos(), cacosh(), catan(), catanh()
21883             contain incorrect formulae describing the functions.
21884
21885 cacos.3
21886     Michael Kerrisk
21887         Add example program
21888
21889 cacosh.3
21890     Michael Kerrisk
21891         Add example program
21892
21893 cacosh.3
21894 casinh.3
21895 catan.3
21896 catanh.3
21897     Michael Kerrisk
21898         SEE ALSO: Add reference to inverse function
21899
21900 catan.3
21901     Michael Kerrisk
21902         Add example program
21903
21904 catanh.3
21905     Michael Kerrisk
21906         Add example program
21907
21908 ccos.3
21909 ccosh.3
21910 csin.3
21911 csinh.3
21912 ctan.3
21913 ctanh.3
21914     Michael Kerrisk
21915         SEE ALSO Add reference to "arc" inverse function
21916
21917 cexp.3
21918     Michael Kerrisk
21919         SEE ALSO: add cexp(3)
21920
21921 clog.3
21922     Michael Kerrisk
21923         SEE ALSO: Add reference to clog(2)
21924
21925 crypt.3
21926     Michael Kerrisk  [Jan Engelhardt]
21927         Fix header file and feature test macro requirements for crypt_r()
21928
21929 err.3
21930     Seonghun Lim
21931         Clean up description of error message source
21932             In the second paragraph of DESCRIPTION section, one of the
21933             sources of error messages is incorrect: the four functions obtain
21934             error message only from errno, and "a code" is just relevant
21935             with errc() and warnc(), which are not present on Linux.
21936             see http://www.unix.com/man-page/freebsd/3/ERR/ .
21937
21938             Then, the third paragraph becomes a duplicate.
21939
21940 fflush.3
21941     Regid Ichira
21942         Fix wording error
21943             See http://bugs.debian.org/cgi-bin/bugreport.cgi?614021
21944
21945 hsearch.3
21946     Seonghun Lim
21947         Update ERRORS section
21948             EINVAL can occur for hdestroy_r().
21949             EINVAL can't occur for hcreate().
21950             Other minor fixes.
21951
21952 lockf.3
21953     Michael Kerrisk  [Mikel Ward]
21954         ERRORS: EBADF can also occur for nonwritable file descriptor
21955             As noted in the DESCRIPTION, the file descriptor must be writable
21956             in order to place a lock.
21957
21958 malloc.3
21959     Seonghun Lim
21960         Reorder prototypes in SYNOPSIS
21961             calloc() comes before realloc() in the other sections,
21962             so should do in SYNOPSIS, too.
21963
21964 mbstowcs.3
21965     Michael Kerrisk
21966         SEE ALSO: add reference to wcstombs(3)
21967
21968 memcmp.3
21969     Michael Kerrisk  [Sebastian Unger]
21970         Clarify that comparison interprets bytes as "unsigned char"
21971
21972 realpath.3
21973     Michael Kerrisk  [Seonghun Lim]
21974         Fix EINVAL error
21975             Since glibc 2.3, resolved_path can be non-NULL (with the
21976             semantics already documented in the page).
21977
21978 scandir(3)
21979     Mike Frysinger
21980         Add ENOENT/ENOTDIR errors
21981
21982 siginterrupt.3
21983     Michael Kerrisk  [Luis Javier Merino]
21984         Remove misleading sentence about signal(2) and system call interruption
21985
21986 strlen.3
21987     Michael Kerrisk  [Jon Grant]
21988         SEE ALSO: Add strnlen(3)
21989
21990 strnlen.3
21991     Michael Kerrisk  [Jon Grant]
21992         CONFORMING TO: Note that strnlen() is in POSIX.1-2008
21993
21994 strtoul.3
21995     Michael Kerrisk  [Tolga Dalman]
21996         Fix NOTES section constants
21997
21998 termios.3
21999     Michael Kerrisk
22000         Use "terminal special characters" consistently throughout page
22001     Michael Kerrisk  [Paul Evans]
22002         Add documentation of _POSIX_VDISABLE
22003             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=627841
22004     Michael Kerrisk
22005         Add a description of STATUS character
22006     Michael Kerrisk
22007         Added description of SWTCH character
22008     Michael Kerrisk
22009         Add names of terminal special characters
22010     Michael Kerrisk
22011         List terminal special characters in alphabetical order
22012
22013 wcstombs.3
22014     Michael Kerrisk
22015         SEE ALSO: add mbstowcs(3)
22016
22017 console_codes.4
22018     Petr Pisar
22019         Add ESC [ 3 J
22020             Linux 3.0 (commit f8df13e0a901fe55631fed66562369b4dba40f8b)
22021             implements \E[3J to allow scrambling content of console
22022             including scroll-back buffer
22023             (http://thread.gmane.org/gmane.linux.kernel/1125792).
22024
22025 proc.5
22026     Michael Kerrisk  [Stan Sieler]
22027         Add description of 'PPid' field of /proc/PID/status
22028     Michael Kerrisk  [Stan Sieler]
22029         Add description of 'SigQ' field of /proc/PID/status
22030
22031 capabilities.7
22032     Michael Kerrisk  [Serge E. Hallyn]
22033         Document CAP_SYSLOG and related changes in Linux 2.6.37
22034     Michael Kerrisk
22035         File capabilities are no longer optional
22036             Starting with Linux 2.6.33, the CONFIG_SECURITY_FILE_CAPABILITIES
22037             has been removed, and file capabilities are always part of the
22038             kernel.
22039
22040 complex.7
22041     Michael Kerrisk
22042         Updated SEE ALSO list to include all complex math functions
22043
22044 ipv6.7
22045     Michael Kerrisk  [Simon Cross]
22046         Fix description of address notation: "8 4-digit hexadecimal numbers"
22047
22048 signal.7
22049     Seonghun Lim
22050         Remove crufty repeated info about LinuxThreads
22051
22052 unix.7
22053     Michael Kerrisk
22054         Add pointer to cmsg(3) for an example of the use of SCM_RIGHTS
22055
22056
22057 ==================== Changes in man-pages-3.34 ====================
22058
22059 Released: 2011-09-23, Munich
22060
22061
22062 Contributors
22063 ------------
22064
22065 The following people contributed patches/fixes or (noted in brackets
22066 in the changelog below) reports, notes and ideas that have been
22067 incorporated in changes in this release:
22068
22069 Alan Curry <pacman@kosh.dhis.org>
22070 Benjamin Poirier <benjamin.poirier@gmail.com>
22071 Brian M. Carlson <sandals@crustytoothpaste.net>
22072 David Howells <dhowells@redhat.com>
22073 David Prévot <taffit@debian.org>
22074 Denis Barbier <bouzim@gmail.com>
22075 Doug Goldstein <cardoe@cardoe.com>
22076 Eric Blake <eblake@redhat.com>
22077 Guillem Jover <guillem@hadrons.org>
22078 Jon Grant <jg@jguk.org>
22079 Michael Kerrisk <mtk.manpages@gmail.com>
22080 Neil Horman <nhorman@tuxdriver.com>
22081 Paul Pluzhnikov <ppluzhnikov@google.com>
22082 Reuben Thomas <rrt@sc3d.org>
22083 Stefan Puiu <stefan.puiu@gmail.com>
22084 Stephan Mueller <stephan.mueller@atsec.com>
22085 Stephen Cameron <scameron@beardog.cce.hp.com>
22086 Sunil Mushran <sunil.mushran@oracle.com>
22087
22088 Apologies if I missed anyone!
22089
22090
22091 New and rewritten pages
22092 -----------------------
22093
22094 rt_sigqueueinfo.2
22095     Michael Kerrisk  [Stephan Mueller]
22096         New page for rt_sigqueueinfo(2) and rt_tgsigqueueinfo(2)
22097             This replaces the previous '.so' man page link file for
22098             rt_sigqueueinfo.2, which linked to this sigqueue() man page.
22099
22100 cciss.4
22101     Stephen M. Cameron
22102         New man page for cciss driver
22103             I obtained the information in this man page as a consequence
22104             of having worked on the cciss driver for the past several years,
22105             and having written considerable portions of it.
22106     Michael Kerrisk
22107         Copyedit by mtk
22108
22109 hpsa.4
22110     Stephen M. Cameron
22111         New man page for the hpsa driver
22112             I obtained the information in this man page as a consequence
22113             of being the main author of the hpsa driver.
22114     Michael Kerrisk
22115         Copyedits my mtk
22116
22117
22118 Newly documented interfaces in existing pages
22119 ---------------------------------------------
22120
22121 fstatat.2
22122     Michael Kerrisk  [David Howells]
22123         Document AT_NO_AUTOMOUNT
22124             This flag was added in Linux 2.6.38.
22125
22126 lseek.2
22127     Michael Kerrisk  [Eric Blake, Sunil Mushran]
22128         Document SEEK_HOLE and SEEK_DATA
22129             These flags, designed for discovering holes in a file,
22130             were added in Linux 3.1. Included comments from Eric
22131             Blake and Sunil Mushran.
22132
22133 madvise.2
22134     Doug Goldstein
22135         Add MADV_HUGEPAGE and MADV_NOHUGEPAGE
22136             Document the MADV_HUGEPAGE and MADV_NOHUGEPAGE flags added to
22137             madvise() in Linux 2.6.38.
22138
22139
22140 New and changed links
22141 ---------------------
22142
22143 rt_tgsigqueueinfo.2
22144     Michael Kerrisk
22145         New link to new rt_sigqueueinfo.2 page
22146
22147 sigqueue.2
22148     Michael Kerrisk
22149         Create link to page that was relocated to section 3
22150
22151
22152 Global changes
22153 --------------
22154
22155 Various pages
22156     Michael Kerrisk
22157         Change reference to "sigqueue(2)" to "sigqueue(3)"
22158
22159
22160 Changes to individual pages
22161 ---------------------------
22162
22163 fallocate.2
22164     Michael Kerrisk
22165         ERRORS: Add EPERM and ESPIPE errors
22166
22167 lseek.2
22168     Michael Kerrisk  [Alan Curry, Reuben Thomas]
22169         Remove suspect note about 'whence' being incorrect English
22170
22171 prctl.2
22172     Paul Pluzhnikov
22173         PR_SET_DUMPABLE makes process non-ptrace-attachable
22174
22175 readlink.2
22176     Guillem Jover
22177         Document using st_size to allocate the buffer
22178     Michael Kerrisk
22179         Added copyright text + changelog note for Guillem Jover's patch
22180
22181 sched_setscheduler.2
22182     Michael Kerrisk
22183         Document 2.6.39 changes to rules governing changes from SCHED_IDLE policy
22184             Since Linux 2.6.39, unprivileged processes under the
22185             SCHED_IDLE policy can switch to another nonrealtime
22186             policy if their nice value falls within the range
22187             permitted by their RLIMIT_NICE limit.
22188
22189 tkill.2
22190     Michael Kerrisk
22191         SEE ALSO: Add rt_sigqueueinfo (2)
22192
22193 btowc.3, wctob.3
22194     Michael Kerrisk  [Brian M. Carlson]
22195         Add pointers to better, thread-safe alternative functions
22196             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=606899
22197
22198 fwide.3
22199     Michael Kerrisk
22200         Add _ISOC95_SOURCE to feature test macro requirements
22201             Since glibc 2.12, _ISOC95_SOURCE can also be used to expose
22202             prototype of this function.
22203
22204 index.3
22205     Michael Kerrisk  [Jon Grant]
22206         Fix text mentioning terminating null
22207
22208 pthread_sigqueue.3
22209     Michael Kerrisk
22210         Replace explicit mention of rt_tgsigqueueinfo() with SEE ALSO reference
22211
22212 sigqueue.3
22213     Michael Kerrisk
22214         Move this page to section 3
22215             Now that the underlying system call rt_sigqueueinfo(2) is
22216             properly documented, move sigqueue() to Section 3, since
22217             it is really a library function.
22218     Michael Kerrisk
22219         Update text in line with existence of new rt_sigqueueinfo.2 page
22220
22221 wcsnlen.3
22222     Jon Grant
22223         Improve description of 'maxlen' argument
22224             It's worth clarifying 'maxlen' is in wide-char units, not bytes.
22225
22226 wprintf.3
22227     Michael Kerrisk
22228         Add _ISOC95_SOURCE to feature test macro requirements
22229             Since glibc 2.12, _ISOC95_SOURCE can also be used to expose
22230             prototype of these functions.
22231
22232 feature_test_macros.7
22233     Michael Kerrisk
22234         Document _ISOC95_SOURCE
22235             _ISOC95_SOURCE was added in glibc 2.12 as a means
22236             to expose C90 Amendment 1 definitions.
22237
22238 ip.7
22239     Benjamin Poirier  [Neil Horman]
22240         Improve description of IP_MTU_DISCOVER
22241
22242 signal.7
22243     Michael Kerrisk
22244         SEE ALSO: Add rt_sigqueueinfo(2)
22245
22246
22247 ==================== Changes in man-pages-3.35 ====================
22248
22249 Released: 2011-10-04, Munich
22250
22251
22252 Contributors
22253 ------------
22254
22255 The following people contributed patches/fixes or (noted in brackets
22256 in the changelog below) reports, notes and ideas that have been
22257 incorporated in changes in this release:
22258
22259 Andi Kleen <andi@firstfloor.org>
22260 David Prévot <taffit@debian.org>
22261 Denis Barbier <bouzim@gmail.com>
22262 Eric W. Biederman <ebiederm@xmission.com>
22263 Guillem Jover <guillem@hadrons.org>
22264 Jon Grant <jg@jguk.org>
22265 Kevin Lyda <kevin@ie.suberic.net>
22266 Michael Kerrisk <mtk.manpages@gmail.com>
22267 Mike Frysinger <vapier@gentoo.org>
22268 Reuben Thomas <rrt@sc3d.org>
22269
22270 Apologies if I missed anyone!
22271
22272
22273 New and rewritten pages
22274 -----------------------
22275
22276 recvmmsg.2
22277     Andi Kleen, Michael Kerrisk
22278         New man page for recvmmsg(2)
22279
22280 setns.2
22281     Eric W. Biederman
22282         New manual page for setns(2)
22283     Michael Kerrisk
22284         Various improvements
22285
22286
22287 Global changes
22288 --------------
22289
22290 Various pages
22291     Michael Kerrisk
22292         Global fix: remove spaces around em-dash
22293             Normal English typographical convention is not to have
22294             spaces around em dashes.
22295
22296 Various pages
22297     Michael Kerrisk
22298         Global fix: s/null pointer/NULL pointer/
22299
22300 Various pages
22301     Michael Kerrisk
22302         Global fix: use ORing
22303             Use "ORing", not "OR'ing", nor an italic ".IR OR ing".
22304
22305 Various pages
22306     Michael Kerrisk
22307         Global fix: consistent use of "null wide character"
22308             Bring more consistency to the discussion of
22309             "[terminating] null wide character"
22310             by writing (at least in the initial use in a page)
22311             "[terminating] null wide character (L'\0')".
22312
22313 Various pages
22314     Michael Kerrisk
22315         Global fix: consistent use of "null byte"
22316             Bring more consistency to the discussion of
22317             "[terminating] null byte"
22318             by writing (at least in the initial use in a page)
22319             "[terminating] null byte ('\0')".
22320
22321 mount.2, prctl.2
22322     Michael Kerrisk
22323         s/task/thread/ for consistency with other pages
22324
22325
22326 Changes to individual pages
22327 ---------------------------
22328
22329 lseek.2
22330     Guillem Jover
22331         CONFORMING TO: Note other systems that have SEEK_HOLE+SEEK_DATA
22332
22333 recv.2
22334     Michael Kerrisk
22335         Add mention of recvmmsg(2)
22336
22337 recvmmsg.2
22338     Michael Kerrisk
22339         SEE ALSO: add sendmmsg(2)
22340
22341 send.2
22342     Michael Kerrisk
22343         CONFORMING TO: POSIX.1-2008 adds MSG_NOSIGNAL
22344
22345 sigwaitinfo.2
22346     Michael Kerrisk
22347         Note that attempts to wait for SIGKILL and SIGSTOP are silently ignored
22348
22349 stat.2
22350     Michael Kerrisk
22351         Note POSIX.1-2001 and POSIX.1-2008 requirements for lstat()
22352     Michael Kerrisk
22353         Regarding automounter action, add a reference to fstatat(2)
22354     Michael Kerrisk
22355         Clean up text describing which POSIX describes S_IF* constants
22356
22357 aio_cancel.3
22358     Michael Kerrisk  [Jon Grant]
22359         Clarify meaning of "return status" and "error status"
22360
22361 gets.3
22362     Michael Kerrisk
22363         POSIX.1-2008 marks gets() obsolescent
22364             The page formerly erroneously stated that POSIX.1-2008
22365             removed the specification of this function.
22366
22367 mbsnrtowcs.3
22368     Michael Kerrisk
22369         CONFORMING TO: Add POSIX.1-2008
22370             This function is specified in the POSIX.1-2008 revision.
22371
22372 regex.3
22373     Michael Kerrisk  [Reuben Thomas]
22374         Change "terminating null" to "terminating null byte"
22375
22376 stpcpy.3
22377 stpncpy.3
22378     Mike Frysinger
22379         Note that these functions are in POSIX.1-2008
22380             Update the "CONFORMING TO" sections of these functions to
22381             note that they are now part of the POSIX.1-2008 standard.
22382
22383 stpncpy.3
22384     Michael Kerrisk
22385         Change "terminating null" to "terminating null byte"
22386
22387 strcpy.3
22388     Mike Frysinger
22389         SEE ALSO: Add stpncpy(3)
22390
22391 strdup.3
22392     Michael Kerrisk
22393         CONFORMING TO: strndup() is in POSIX.1-2008
22394
22395 wcpcpy.3
22396 wcpncpy.3
22397 wcsnlen.3
22398 wcsnrtombs.3
22399     Michael Kerrisk
22400         CONFORMING TO: Add POSIX.1-2008
22401             These functions are specified in the POSIX.1-2008 revision.
22402
22403 proc.5
22404     Eric W. Biederman
22405         Document /proc/[pid]/ns/
22406     Michael Kerrisk
22407         Some edit's to Eric Biederman's /proc/[pid]/ns/ additions
22408
22409 capabilities.7
22410     Michael Kerrisk
22411         List setns(2) as an operation allowed by CAP_SYS_ADMIN
22412
22413
22414 ==================== Changes in man-pages-3.36 ====================
22415
22416 Released: 2012-02-27, Christchurch
22417
22418
22419 Contributors
22420 ------------
22421
22422 The following people contributed patches/fixes or (noted in brackets
22423 in the changelog below) reports, notes and ideas that have been
22424 incorporated in changes in this release:
22425
22426 Alain Benedetti <alainb06@free.fr>
22427 carado <carado@savhon.org>
22428 Christoph Hellwig <hch@lst.de>
22429 Clemens Ladisch <clemens@ladisch.de>
22430 David Prévot <taffit@debian.org>
22431 Elie De Brauwer <eliedebrauwer@gmail.com>
22432 Guillem Jover <guillem@hadrons.org>
22433 Jessica McKellar <jesstess@mit.edu>
22434 Josef Bacik <josef@redhat.com>
22435 Junjiro Okajima <jro@mx3.ttcn.ne.jp>
22436 Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
22437 Michael Kerrisk <mtk.manpages@gmail.com>
22438 Mike Frysinger <vapier@gentoo.org>
22439 Pat Pannuto <pat.pannuto@gmail.com>
22440 Salvo Tomaselli <tiposchi@tiscali.it>
22441 Simone Piccardi <piccardi@truelite.it>
22442 Slaven Rezic <srezic@iconmobile.com>
22443 starlight <starlight@binnacle.cx>
22444 Stephan Mueller <stephan.mueller@atsec.com>
22445 Vijay Rao <vijay@portuosus.com>
22446 Walter Haidinger <walter.haidinger@gmx.at>
22447 Walter Harms <wharms@bfs.de>
22448 Yang Yang <wdscxsj@gmail.com>
22449
22450 Apologies if I missed anyone!
22451
22452
22453 New and rewritten pages
22454 -----------------------
22455
22456 sendmmsg.2
22457     Michael Kerrisk  [Stephan Mueller]
22458         New page for sendmmsg(2)
22459             Some pieces inspired by an initial attempt by Stephan Mueller.
22460
22461
22462 Newly documented interfaces in existing pages
22463 ---------------------------------------------
22464
22465 fallocate.2
22466     Lucian Adrian Grijincu
22467         Document FALLOC_FL_PUNCH_HOLE
22468             FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38,
22469             for punching holes in the allocated space in a file.
22470
22471
22472 Changes to individual pages
22473 ---------------------------
22474
22475 dup.2
22476     Michael Kerrisk
22477         SYNOPSIS: Add "#include <fcntl.h>" for O_* constants
22478
22479 fallocate.2
22480     Michael Kerrisk
22481         Substantial restructuring of DESCRIPTION
22482             The addition of a second class of operation ("hole punching")
22483             to the man page made it clear that some significant restructuring
22484             is required. So I substantially reworked the page, including the
22485             preexisting material on the default "file allocation" operation.
22486     Michael Kerrisk  [Josef Bacik]
22487         Add further details for FALLOC_FL_PUNCH_HOLE
22488     Michael Kerrisk
22489         ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE
22490
22491 fork.2
22492     Michael Kerrisk
22493         NOTES: Describe clone() call equivalent to fork()
22494
22495 fsync.2
22496     Christoph Hellwig
22497         Various improvements
22498             - explain the situation with disk caches better
22499             - remove the duplicate fdatasync() explanation in the NOTES
22500               section
22501             - remove an incorrect note about fsync() generally requiring two
22502               writes
22503             - remove an obsolete ext2 example note
22504             - fsync() works on any file descriptor (doesn't need to be
22505               writable); correct the EBADF error code explanation
22506     Michael Kerrisk  [Guillem Jover]
22507         Note that some systems require a writable file descriptor
22508             An edited version of Guillem Jover's comments:
22509             [While the file descriptor does not need to be writable on Linux]
22510             that's not a safe portable assumption to make on POSIX in general
22511             as that behavior is not specified and as such is
22512             implementation-specific. Some Unix systems do actually fail on
22513             read-only file descriptors, for example [HP-UX and AIX].
22514
22515 mount.2
22516     Michael Kerrisk  [Junjiro Okajima]
22517         Removed erroneous statement about MS_RDONLY and bind mounts
22518
22519 open.2
22520     Jessica McKellar
22521         Fix grammar in O_DIRECT description
22522             Some small grammar fixes to the O_DIRECT description.
22523
22524 pipe.2
22525     Michael Kerrisk  [Salvo Tomaselli]
22526         SYNOPSIS: Add "#include <fcntl.h>" for O_* constants
22527             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750
22528
22529 sched_rr_get_interval.2
22530     Clemens Ladisch
22531         Update notes on modifying quantum
22532             Since Linux 2.6.24, it is no longer possible to
22533             modify the SCHED_RR quantum using setpriority(2).
22534             (Slight edits to Clemens' patch by mtk.)
22535     Michael Kerrisk
22536         Reordered various pieces of text
22537     Michael Kerrisk
22538         Reworded text of ESRCH error
22539
22540 send.2
22541     Michael Kerrisk
22542         Add mention of sendmmsg(2)
22543
22544 sync.2
22545     Michael Kerrisk  [Simone Piccardi]
22546         PROTOTYPE: Fix return type of syncfs()
22547
22548 vfork.2
22549     Michael Kerrisk  [starlight]
22550         Clarify what is duplicated in the child
22551             Add some words to make it clear to the reader that vfork(),
22552             like fork(), creates duplicates of process attributes
22553             in the child.
22554     Michael Kerrisk
22555         Note clone() flags equivalent to vfork()
22556     Michael Kerrisk  [starlight, Mike Frysinger]
22557         Add some notes on reasons why vfork() still exists
22558     Michael Kerrisk  [starlight]
22559         Clarify that calling *thread* is suspended during vfork()
22560     Michael Kerrisk
22561         CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete
22562
22563 gets.3
22564     Michael Kerrisk
22565         Document C11 and glibc 2.16 changes affecting gets()
22566
22567 pthread_sigmask.3
22568     Michael Kerrisk  [Pat Pannuto]
22569         Fix comment that was inconsistent with code in example program
22570
22571 sem_wait.3
22572     Walter Harms
22573         EXAMPLE: Remove extraneous line of output from shell session
22574
22575 wcsnrtombs.3
22576 wcsrtombs.3
22577 wcstombs.3
22578     Michael Kerrisk
22579         Fix-ups for e9c23bc636426366d659809bc99cd84661e86464
22580
22581 core.5
22582     Michael Kerrisk  [Junjiro Okajima]
22583         Document %E specifier for core_pattern
22584
22585 passwd.5
22586     Michael Kerrisk  [Walter Haidinger]
22587         s/asterisk/asterisk (*)/ to improve clarity
22588     Michael Kerrisk
22589         Correct note on passwd field value when shadowing is enabled
22590             When password shadowing is enabled, the password field
22591             contains an 'x' (not "*').
22592
22593 proc.5
22594     Elie De Brauwer
22595         Fix description of fourth field of /proc/loadavg
22596             SIgned-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
22597
22598 resolv.conf.5
22599     Michael Kerrisk  [Slaven Rezic]
22600         Describe syntax used for comments
22601             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=656994
22602
22603 feature_test_macros.7
22604     Michael Kerrisk
22605         Document _ISOC11_SOURCE
22606
22607 inotify.7
22608     Michael Kerrisk  [Yang Yang]
22609         Note that 'cookie' field is set to zero when unused
22610
22611 man.7
22612     Michael Kerrisk
22613         Various fixes for description of NAME section
22614             As noted by reporter:
22615             * The code sample given for the NAME section is incomplete because
22616               the actual content sample is not given.
22617             * Additionally, the description assumes that the item described is
22618               a command, which need not be the case.
22619             * The command makewhatis is not present on my system; the
22620               documented tool to create the whatis database is called mandb.
22621             * The description on .SH NAME in man(7) should either copy the
22622               relevant paragraph of lexgrog(1) or refer to it.
22623
22624
22625 ==================== Changes in man-pages-3.37 ====================
22626
22627 Released: 2012-03-06, Christchurch
22628
22629
22630 Contributors
22631 ------------
22632
22633 The following people contributed patches/fixes or (noted in brackets
22634 in the changelog below) reports, notes and ideas that have been
22635 incorporated in changes in this release:
22636
22637 Denys Vlasenko <dvlasenk@redhat.com>
22638 Mark R. Bannister <cambridge@users.sourceforge.net>
22639 Michael Kerrisk <mtk.manpages@gmail.com>
22640 Oleg Nesterov <oleg@redhat.com>
22641 Tejun Heo <tj@kernel.org>
22642
22643 Apologies if I missed anyone!
22644
22645
22646 New and rewritten pages
22647 -----------------------
22648
22649 getent.1
22650     Mark R. Bannister
22651         New page to document 'getent' binary provided by glibc
22652
22653
22654 Changes to individual pages
22655 ---------------------------
22656
22657 bdflush.2
22658     Michael Kerrisk
22659         Note that bdflush() is deprecated, and does nothing
22660
22661 nfsservctl.2
22662     Michael Kerrisk
22663         Note that this system call was removed in Linux 3.1
22664
22665 ptrace.2
22666     Denys Vlasenko  [Oleg Nesterov, Tejun Heo]
22667         add extended description of various ptrace quirks
22668             Changes include:
22669
22670             s/parent/tracer/g, s/child/tracee/g - ptrace interface now
22671             is sufficiently cleaned up to not treat tracing process
22672             as parent.
22673
22674             Deleted several outright false statements:
22675             - pid 1 can be traced
22676             - tracer is not shown as parent in ps output
22677             - PTRACE_ATTACH is not "the same behavior as if tracee had done
22678               a PTRACE_TRACEME": PTRACE_ATTACH delivers a SIGSTOP.
22679             - SIGSTOP _can_ be injected.
22680             - Removed mentions of SunOS and Solaris as irrelevant.
22681             - Added a few more known bugs.
22682
22683             Added a large block of text in DESCRIPTION which doesn't focus
22684             on mechanical description of each flag and operation, but rather
22685             tries to describe a bigger picture. The targeted audience is
22686             a person which is reasonably knowledgeable in Unix but did not
22687             spend years working with ptrace, and thus may be unaware of its
22688             quirks. This text went through several iterations of review by
22689             Oleg Nesterov and Tejun Heo.
22690             This block of text intentionally uses as little markup as possible,
22691             otherwise future modifications to it will be very hard to make.
22692     Michael Kerrisk
22693         Global clean-up of page
22694             * Wording and formatting fixes to existing text and
22695               Denys Vlasenko's new text.
22696             * Various technical amendments and improvements to
22697               Denys Vlasenko's new text.
22698             * Added FIXME for various problems with the current text.
22699     Michael Kerrisk
22700         Integrated changes after further review from Denys Vlasenko
22701
22702 syscalls.2
22703     Michael Kerrisk
22704         Note that nfsservctl(2) was removed in Linux 3.1
22705         Note that bdflush(2) is deprecated
22706
22707 capabilities.7
22708     Michael Kerrisk
22709         Add CAP_WAKE_ALARM
22710     Michael Kerrisk
22711         Add various operations under CAP_SYS_ADMIN
22712         Add perf_event_open(2) to CAP_SYS_ADMIN
22713         Add VM86_REQUEST_IRQ vm86(2) command to CAP_SYS_ADMIN
22714         Update CAP_NET_ADMIN with notes from include/linux/capability.h
22715         Add nfsservctl(2) to CAP_SYS_ADMIN
22716     Michael Kerrisk
22717         Add ioctl(FIBMAP) under CAP_SYS_RAWIO
22718     Michael Kerrisk
22719         Add virtual terminal ioctl()s under CAP_SYS_TTY_CONFIG
22720     Michael Kerrisk
22721         Update CAP_NET_RAW with notes from include/linux/capability.h
22722     Michael Kerrisk
22723         Add F_SETPIPE_SZ case to CAP_SYS_RESOURCE
22724         Add POSIX messages queues queues_max case to CAP_SYS_RESOURCE
22725         Update CAP_SYS_RESOURCE with notes from include/linux/capability.h
22726     Michael Kerrisk
22727         SEE ALSO: Add libcap(3)
22728
22729 ld.so.8
22730     Michael Kerrisk
22731         Add --audit command-line option
22732
22733
22734 ==================== Changes in man-pages-3.38 ====================
22735
22736 Released: 2012-03-25, Christchurch
22737
22738
22739 Contributors
22740 ------------
22741
22742 The following people contributed patches/fixes or (noted in brackets
22743 in the changelog below) reports, notes, and ideas that have been
22744 incorporated in changes in this release:
22745
22746 Akihiro MOTOKI <amotoki@gmail.com>
22747 Artyom Pervukhin <artyom@evasive.ru>
22748 Beňas Petr <xbenas00@stud.fit.vutbr.cz>
22749 Ben Bacarisse <software@bsb.me.uk>
22750 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
22751 David Prévot <david@tilapin.org>
22752 Denis Barbier <bouzim@gmail.com>
22753 Denys Vlasenko <vda.linux@googlemail.com>
22754 Eric Blake <ebb9@byu.net>
22755 Iain Fraser <iainkfraser@gmail.com>
22756 Justin T Pryzby <justinp@norchemlab.com>
22757 Kirill Brilliantov <brilliantov@inbox.ru>
22758 Mark R Bannister <mark@proseconsulting.co.uk>
22759 Matthew Gregan <kinetik@flim.org>
22760 Michael Kerrisk <mtk.manpages@gmail.com>
22761 Nix <nix@esperi.org.uk>
22762 Peter Schiffer <pschiffe@redhat.com>
22763 Sergei Zhirikov <sfzhi@yahoo.com>
22764
22765 Apologies if I missed anyone!
22766
22767
22768 New and rewritten pages
22769 -----------------------
22770
22771 get_nprocs_conf.3
22772     Beňas Petr
22773         New page documenting get_nprocs_conf(3) and get_nprocs(3)
22774     Michael Kerrisk
22775         Some additions and improvements
22776
22777 malloc_get_state.3
22778     Michael Kerrisk
22779         New page documenting malloc_get_state(3) and malloc_set_state(3)
22780
22781 mallopt.3
22782     Michael Kerrisk
22783         New man page for mallopt(3)
22784
22785 mtrace.3
22786     Michael Kerrisk
22787         Complete rewrite of page, adding much more detail
22788
22789 scandirat.3
22790     Mark R Bannister
22791         New page for scandirat(3) (new in glibc 2.15)
22792
22793
22794 Newly documented interfaces in existing pages
22795 ---------------------------------------------
22796
22797 posix_memalign.3
22798     Michael Kerrisk
22799         Document aligned_alloc(3)
22800             aligned_alloc() is new in C11.
22801     Michael Kerrisk
22802         Document pvalloc(3)
22803
22804 qsort.3
22805     Mark R Bannister
22806         Add documentation of qsort_r(3)
22807     Ben Bacarisse
22808         Improvements to Mark R Bannister's qsort_r() patch
22809     Michael Kerrisk
22810         Add VERSIONS section for qsort_r()
22811
22812
22813 New and changed links
22814 ---------------------
22815
22816 aligned_alloc.3
22817     Michael Kerrisk
22818         New link to posix_memalign.3
22819
22820 get_nprocs.3
22821     Beňas Petr
22822         Link to new get_nprocs_conf.3 page
22823
22824 malloc_set_state.3
22825     Michael Kerrisk
22826         Link to new malloc_get_state.3 page
22827
22828 pvalloc.3
22829     Michael Kerrisk
22830         New link to posix_memalign.3
22831
22832
22833 Global changes
22834 --------------
22835
22836 Various pages
22837     Michael Kerrisk
22838         Global formatting fix: balance .nf/.fi pairs
22839
22840 Various pages
22841     Michael Kerrisk
22842         Global fix: place sections in correct order
22843
22844 Various pages
22845     Michael Kerrisk  [Justin T Pryzby]
22846         Global fix: Remove duplicated words
22847             Remove instances of duplicate words found using Justin's
22848             grep-fu:
22849
22850                 for f in man?/*.[1-9]; do
22851                     grep -HE ' ([[:alpha:]]{2,} +)\1' "$f" |
22852                         grep -Evw '(proc|hugetlbfs|XXX*|root|long) *\1';
22853                 done | grep -E --colo ' ([[:alpha:]]{2,} +)\1'
22854
22855 Various pages
22856     Michael Kerrisk
22857         Correct order of SEE ALSO entries
22858
22859
22860 Changes to individual pages
22861 ---------------------------
22862
22863 futimesat.2
22864     Michael Kerrisk
22865         PROTOTYPE: Correct header file and feature test macro requirements
22866
22867 keyctl.2
22868     Bjarni Ingi Gislason
22869         Strip trailing tabs from source line
22870             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=664688
22871
22872 ptrace.2
22873     Denys Vlasenko
22874         Document PTRACE_GETEVENTMSG for PTRACE_EVENT_EXEC
22875     Denys Vlasenko
22876         Various fixes to recent updates of this page
22877
22878 symlinkat.2
22879     Michael Kerrisk  [Eric Blake]
22880         PROTOTYPE: Correct header file
22881
22882 syscalls.2
22883     Michael Kerrisk
22884         Remove unimplemented system calls from main syscall list
22885             The unimplemented system calls are in any case noted lower down
22886             in the page. Also: rearrange the text describing the unimplemented
22887             system calls.
22888     Michael Kerrisk
22889         Note a few system calls that were removed in Linux 2.6
22890     Michael Kerrisk
22891         Add process_vm_readv(2) and process_vm_writev(2)
22892
22893 unlinkat.2
22894     Michael Kerrisk  [Eric Blake]
22895         PROTOTYPE: Correct header file
22896     Michael Kerrisk
22897         PROTOTYPE: Add <fcntl.h> for AT_* constants
22898
22899 utimensat.2
22900     Michael Kerrisk
22901         PROTOTYPE: Add <fcntl.h> for AT_* constants
22902
22903 copysign.3
22904     Michael Kerrisk  [Tolga Dalman]
22905         DESCRIPTION: Add a couple of examples
22906
22907 malloc.3
22908     Michael Kerrisk
22909         NOTES: Add a short discussion of arenas
22910     Michael Kerrisk
22911         Replace discussion of MALLOC_CHECK_ with pointer to mallopt(3)
22912     Michael Kerrisk
22913         SEE ALSO: Add mtrace(3)
22914         SEE ALSO: add malloc_get_state(3)
22915
22916 posix_memalign.3
22917     Michael Kerrisk
22918         Rename memalign() argument
22919             Rename "boundary" to "alignment" for consistency
22920             with posix_memalign().
22921     Michael Kerrisk
22922         Improve discussion of feature test macros and header files for valloc(3)
22923
22924 rtnetlink.3
22925     Kirill Brilliantov  [Sergei Zhirikov]
22926         Fix example code, rta_len assignment should use RTA_LENGTH()
22927             See also http://bugs.debian.org/655088
22928
22929 scandir.3
22930     Mark R Bannister
22931         SEE ALSO: Add scandirat(3)
22932
22933 sigqueue.3
22934     Nix
22935         Remove rt_sigqueueinfo from TH line
22936             rt_sigqueueinfo() now has its own manual page, so should not
22937             be listed in the .TH line of this page.
22938
22939 tzset.3
22940     Peter Schiffer
22941         Correct description for Julian 'n' date format
22942             The Julian 'n' date format counts starting from 0, not 1.
22943     Michael Kerrisk
22944         Add some clarifying remarks to discussion of Julian day formats
22945
22946 packet.7
22947     Michael Kerrisk  [Iain Fraser]
22948         Fix comment on 'sll_hatype' field
22949
22950 tcp.7
22951     Michael Kerrisk  [Artyom Pervukhin]
22952         Correct RFC for TIME_WAIT assassination hazards
22953
22954
22955 ==================== Changes in man-pages-3.39 ====================
22956
22957 Released: 2012-04-17, Christchurch
22958
22959
22960 Contributors
22961 ------------
22962
22963 The following people contributed patches/fixes or (noted in brackets
22964 in the changelog below) reports, notes, and ideas that have been
22965 incorporated in changes in this release:
22966
22967 Abhijith Das <adas@redhat.com>
22968 Alexander Kruppa <akruppa@gmail.com>
22969 Andreas Jaeger <aj@suse.com>
22970 Armin Rigo <arigo@tunes.org>
22971 Cyrill Gorcunov <gorcunov@openvz.org>
22972 Denys Vlasenko <vda.linux@googlemail.com>
22973 Eric Blake <ebb9@byu.net>
22974 Felix <fkater@googlemail.com>
22975 Jak <jak@gmx.ca>
22976 Jeff Mahoney <jeffm@suse.com>
22977 Jesus Otero <jesus.otero@rysg.es>
22978 Jonathan Nieder <jrnieder@gmail.com>
22979 Kevin O'Gorman <kevinogorman4@gmail.com>
22980 Mark R Bannister <mark@proseconsulting.co.uk>
22981 Michael Kerrisk <mtk.manpages@gmail.com>
22982 Michael Welsh Duggan <mwd@cert.org>
22983 Mike Frysinger <vapier@gentoo.org>
22984 Petr Gajdos <pgajdos@suse.cz>
22985 Regid Ichira <regid23@yahoo.com>
22986 Reuben Thomas <rrt@sc3d.org>
22987 Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
22988 Simone Piccardi <piccardi@truelite.it>
22989 Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
22990 <who@connect.carleton.ca>
22991
22992 Apologies if I missed anyone!
22993
22994
22995 New and rewritten pages
22996 -----------------------
22997
22998 malloc_trim.3
22999     Michael Kerrisk
23000         New man page for malloc_trim(3)
23001
23002 malloc_usable_size.3
23003     Michael Kerrisk
23004         New man page for malloc_usable_size(3)
23005
23006
23007 Newly documented interfaces in existing pages
23008 ---------------------------------------------
23009
23010 prctl.2
23011     Cyrill Gorcunov
23012         Document PR_SET_MM (new in Linux 3.3)
23013     Michael Kerrisk
23014         Various edits and improvements to Cyrill's patch
23015
23016
23017 Changes to individual pages
23018 ---------------------------
23019
23020 epoll_create.2
23021     Michael Kerrisk
23022         Rework discussion of 'size' argument
23023     Michael Kerrisk
23024         Add .SS for description of epoll_create1()
23025
23026 epoll_wait.2
23027     Michael Kerrisk  [Armin Rigo]
23028         Another thread can add to epoll instance while epoll_wait is blocked
23029             See https://bugzilla.kernel.org/show_bug.cgi?id=43072
23030     Michael Kerrisk
23031         Clarify that epoll_pwait() blocks calling *thread*
23032         A few wording improvements
23033
23034 fchmodat.2
23035     Michael Kerrisk  [Mike Frysinger]
23036         Note difference between glibc wrapper and underlying system call
23037             The wrapper function has a 'flags' argument (which currently
23038             serves no purpose), while the underlying system call does not.
23039
23040 fcntl.2
23041     Abhijith Das
23042         Explain behaviour of F_GETLEASE during lease break
23043     Michael Kerrisk  [Eric Blake]
23044         Change type of arg from "long" to "int"
23045             Various fcntl(2) commands require an integral 'arg'.
23046             The man page said it must be "long" in all such cases.
23047             However, for the cases covered by POSIX, there is an
23048             explicit requirement that these arguments be "int".
23049             Update the man page to reflect. Probably, all of the
23050             other "long" cases (not specified in POSIX) should
23051             be "int", and this patch makes them so. Based on a
23052             note fromEric Blake, relating to F_DUPFD_CLOEXEC.
23053
23054 gettimeofday.2
23055     Michael Kerrisk
23056         Reorganize content
23057             The main change is to move the historical information about
23058             the 'tz_dsttime' to NOTES.
23059     Michael Kerrisk  [Felix]
23060         Note that compiler issues warnings if 'tv' is NULL
23061
23062 mmap.2
23063     Michael Kerrisk  [Kevin O'Gorman]
23064         Clarify that this system call should not be invoked directly
23065             See https://bugzilla.kernel.org/show_bug.cgi?id=42892
23066     Michael Kerrisk
23067         Clarify NOTES discussion of mmap() versus mmap2()
23068
23069 poll.2
23070     Michael Kerrisk  [Michael Welsh Duggan]
23071         Document negative value in 'fd' field
23072     Michael Kerrisk
23073         Document semantics of passing zero in 'events' field
23074
23075 ptrace.2
23076     Denys Vlasenko
23077         Various fixes
23078             For some reason, the PTRACE_TRACEME paragraph talks about some
23079             general aspects of ptraced process behavior. It repeats the
23080             "tracee stops on every signal" information even though that was
23081             already explained just a few paragraphs before. Then it describes
23082             legacy SIGTRAP on execve().
23083
23084             This patch deletes the first part, and moves the second part up,
23085             into the general ptrace description. It also adds
23086             "If PTRACE_O_TRACEEXEC option is not in effect" to the description
23087             of the legacy SIGTRAP on execve().
23088
23089             The patch also amends the part which says "For requests other
23090             than PTRACE_KILL, the tracee must be stopped." - PTRACE_ATTACH
23091             also doesn't require that.
23092
23093 sigaction.2
23094     Michael Kerrisk  [Andreas Jaeger, ]
23095         Clarify that the use of SI_SIGIO is for Linux 2.2 only
23096             See also http://sourceware.org/bugzilla/show_bug.cgi?id=6745
23097
23098 sigprocmask.2
23099     Mike Frysinger
23100         ERRORS: add EFAULT
23101
23102 times.2
23103     Michael Kerrisk  [Simone Piccardi]
23104         ERRORS: Add EFAULT
23105
23106 div.3
23107     Michael Kerrisk  [Reuben Thomas]
23108         CONFORMING TO: Add C99
23109
23110 fread.3
23111     Regid Ichira
23112         Clarify further that return value is number of items, not bytes
23113             See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=665780
23114
23115 getaddrinfo.3
23116     Michael Kerrisk  [Jak]
23117         Correct type of ai_addrlen field
23118
23119 malloc.3
23120     Michael Kerrisk
23121         SEE ALSO: add malloc_usable_size(3)
23122         SEE ALSO: Add malloc_trim(3)
23123
23124 mallopt.3
23125     Michael Kerrisk
23126         Fix text describing M_PERTURB and free()
23127         SEE ALSO: Add malloc_trim(3)
23128
23129 memchr.3
23130     Michael Kerrisk  [Reuben Thomas]
23131         Remove mention of terminating null in description of rawmemchr()
23132
23133 perror.3
23134     Michael Kerrisk  [Jesus Otero]
23135         Note that use of 'sys_errlist' is deprecated
23136
23137 rcmd.3
23138     Michael Kerrisk
23139         glibc eventually added a declaration of iruserok() in version 2.12
23140
23141 sysconf.3
23142     Michael Kerrisk  [Ricardo Catalinas Jiménez]
23143         Add mention of _SC_SYMLOOP_MAX
23144
23145 nologin.5
23146     Michael Kerrisk  [Tetsuo Handa]
23147         nologin must not only exist, but *be readable* to be effective
23148
23149 nsswitch.conf.5
23150     Mark R Bannister
23151         Significant rewrites and improvements
23152             This patch applies to nsswitch.conf.5 in man-pages-3.36.
23153
23154             My changes almost completely rewrite large sections of the
23155             man page. They are needed to add clarity, correct grammar,
23156             reduce confusion, and bring up-to-date with the latest glibc.
23157             I have checked the man page against the nss source code in
23158             glibc 2.14.90.
23159
23160             Historical notes are demoted to the footer.
23161
23162             The rewrite makes the man page much clearer to
23163             understand, more authoratitive, and easier to read.
23164     Michael Kerrisk
23165         Light edits to Mark Bannister's changes
23166
23167 capabilities.7
23168     Michael Kerrisk
23169         Add prctl(PR_SET_MM) to CAP_SYS_RESOURCE
23170
23171 epoll.7
23172     Michael Kerrisk
23173         Some minor clarifications at start of DESCRIPTION
23174
23175 netlink.7
23176     Jeff Mahoney  [Petr Gajdos]
23177         Note cases where nonprivileged users can use netlink multicast groups
23178             See also https://bugzilla.novell.com/show_bug.cgi?id=754611
23179
23180 unix.7
23181     Michael Kerrisk  [Tetsuo Handa]
23182         Add a detail on autobind feature
23183
23184 ld.so.8
23185     Jonathan Nieder  [Reuben Thomas]
23186         Document effect of hwcaps on search path
23187             Wording by Aurelien Jarno from Debian glibc's r4701 (2011-06-04).
23188
23189             Addresses http://bugs.debian.org/622385
23190
23191
23192 ==================== Changes in man-pages-3.40 ====================
23193
23194 Released: 2012-04-27, Christchurch
23195
23196
23197 Contributors
23198 ------------
23199
23200 The following people contributed patches/fixes or (noted in brackets
23201 in the changelog below) reports, notes, and ideas that have been
23202 incorporated in changes in this release:
23203
23204 Alexey Toptygin <alexeyt@freeshell.org>
23205 Bernhard Walle <bernhard@bwalle.de>
23206 Brian F. G. Bidulock <bidulock@openss7.org>
23207 Brian M. Carlson <sandals@crustytoothpaste.net>
23208 Christopher Yeoh <cyeoh@au1.ibm.com>
23209 Daniel J Blueman <daniel@quora.org>
23210 Eric Blake <eblake@redhat.com>
23211 Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
23212 James Hunt <james.hunt@ubuntu.com>
23213 John Sullivan <jsrhbz@kanargh.force9.co.uk>
23214 Jon Grant <jg@jguk.org>
23215 lepton <ytht.net@gmail.com>
23216 Marcel Holtmann <marcel@holtmann.org>
23217 Michael Kerrisk <mtk.manpages@gmail.com>
23218 Mike Frysinger <vapier@gentoo.org>
23219 Petr Baudis <pasky@ucw.cz>
23220 Simon Paillard <spaillard@debian.org>
23221 Stefan Puiu <stefan.puiu@gmail.com>
23222 Ulrich Drepper <drepper@gmail.com>
23223 Vadim Mikhailov <vadim.mikhailov@gmail.com>
23224
23225 Apologies if I missed anyone!
23226
23227
23228 New and rewritten pages
23229 -----------------------
23230
23231 process_vm_readv.2
23232     Mike Frysinger, Christopher Yeoh, Michael Kerrisk
23233         New page for process_vm_readv(2) and process_vm_writev(2)
23234
23235 mcheck.3
23236     Michael Kerrisk
23237         New man page for mcheck(3) and related functions
23238             Also describes mcheck_check_all(3), mcheck_pedantic(3),
23239             and mprobe(3)
23240
23241
23242 Newly documented interfaces in existing pages
23243 ---------------------------------------------
23244
23245 rcmd.3
23246     Michael Kerrisk
23247         Document "_af" variants of these functions
23248             Document rcmd_af(), rresvport_af(), iruserok_af(), ruserok_af().
23249             Also some restructuring and other clarifications.
23250
23251 rexec.3
23252     Michael Kerrisk
23253         Document rexec_af()
23254
23255
23256 New and changed links
23257 ---------------------
23258
23259 iruserok_af.3
23260 rcmd_af.3
23261 rresvport_af.3
23262 ruserok_af.3
23263     Michael Kerrisk
23264         New links to rcmd.3
23265
23266 rexec_af.3
23267     Michael Kerrisk
23268         New link to rexec.3
23269
23270
23271 Changes to individual pages
23272 ---------------------------
23273
23274 clock_getres.2
23275     Michael Kerrisk
23276         Clarify difference between CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW
23277             Note interactions of these two clocks with discontinuous
23278             adjustments to the system time and NTP/adjtime(2).
23279
23280 fallocate.2
23281     Michael Kerrisk  [John Sullivan]
23282         Fix description of ENOSYS and EOPNOTSUP errors
23283             As reported in https://bugzilla.redhat.com/show_bug.cgi?id=680214
23284
23285 fchmodat.2
23286     Michael Kerrisk  [Mike Frysinger]
23287         Improve discussion of difference between wrapper and underlying syscall
23288
23289 gettimeofday.2
23290     Michael Kerrisk
23291         gettimeofday() is affected by discontinuous jumps in the system time
23292             Advise reader to use clock_gettime(2), if they need a
23293             monotonically increasing time source.
23294     Michael Kerrisk
23295         SEE ALSO: Add clock_gettime(2)
23296
23297 prctl.2
23298     Michael Kerrisk
23299         Add PR_TASK_PERF_EVENTS_DISABLE and PR_TASK_PERF_EVENTS_ENABLE
23300             Add some basic documentation of these operations, with a pointer to
23301             tools/perf/design.txt for more information.
23302     Michael Kerrisk  [Marcel Holtmann]
23303         Amend details of PR_SET_PDEATHSIG
23304
23305 ptrace.2
23306     Michael Kerrisk  [Mike Frysinger]
23307         Note SPARC deviation with respect to get/set regs
23308             SPARC reverses the use of 'addr' and 'data' for
23309             PTRACE_GETREGS, PTRACE_GETFPREGS, PTRACE_SETREGS,
23310             and PTRACE_SETFPREGS.
23311
23312 send.2
23313     Stefan Puiu
23314         Document EACCES error case for UDP
23315
23316 sigaction.2
23317     Michael Kerrisk
23318         Remove mention of raise(3) for SI_USER
23319             For a long time now, glibc's raise(3) didn't yield SI_USER
23320             for the signal receiver, so remove mention of raise(3)
23321             here. The user can deduce the details, if needed, by looking
23322             at the recently updated raise(3) page.
23323
23324 aio_cancel.3
23325     Michael Kerrisk  [Jon Grant]
23326         Rewrite RETURN VALUE section to be clearer
23327
23328 aio_init.3
23329     Michael Kerrisk  [Jon Grant]
23330         Remove extraneous "POSIX" from NAME section
23331
23332 btree.3
23333 dbopen.3
23334 hash.3
23335 mpool.3
23336 recno.3
23337     Michael Kerrisk  [Brian M. Carlson]
23338         Note that glibc no longer provides these interfaces
23339             glibc stopped providing these interfaces with v2.2.
23340             Nowadays, the user that finds these pages probably wants
23341             the libdb API, so note this in the page.
23342
23343             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=337581
23344
23345 fopen.3
23346     Michael Kerrisk
23347         BUGS: Note limitation on number of flag characters parsed in 'mode'
23348     Michael Kerrisk
23349         Note that 'c' and 'e' flags are ignored for fdopen()
23350             Determined from reading libio/iofdopen.c.
23351     Michael Kerrisk
23352         Document ",ccs=string" feature of 'mode' for fopen()/freopen()
23353
23354 getgrnam.3
23355     Michael Kerrisk  [Ulrich Drepper]
23356         Fix discussion of _SC_GETGR_R_SIZE_MAX
23357             The value is not meant to be a maximum (as was specified in
23358             SUSv3) but an initial guess at the required size
23359             (as specified in SUSv4).
23360
23361 getpwnam.3
23362     Michael Kerrisk  [Ulrich Drepper]
23363         Fix discussion of _SC_GETPW_R_SIZE_MAX
23364             The value is not meant to be a maximum (as was specified in
23365             SUSv3) but an initial guess at the required size
23366             (as specified in SUSv4).
23367
23368 malloc.3
23369 mallopt.3
23370 mtrace.3
23371     Michael Kerrisk
23372         SEE ALSO: add mcheck(3)
23373
23374 memchr.3
23375     Michael Kerrisk
23376         Clarify description, omitting mention of "strings" and "characters"
23377             The existing text slipped into talking about characters and
23378             strings, which could mislead readers into thing that, for
23379             example, searches for the byte '\0' are treated specially.
23380             Therefore, rewrite in terms of "bytes" and "memory areas".
23381
23382             At the same time, make a few source file clean-ups.
23383
23384 mkstemp.3
23385     Michael Kerrisk
23386         Add "mkstemps" and "mkostemps" to NAME line
23387
23388 posix_openpt.3
23389     Michael Kerrisk  [Vadim Mikhailov]
23390         Add some details on use of the slave pathname
23391             An explicit pointer to ptsname(3) is useful, as is a note
23392             of the fact that the slave device pathname exists only as
23393             long as the master device is held open.
23394
23395 raise.3
23396     Michael Kerrisk
23397         Add some notes on underlying system call that is used
23398
23399 rcmd.3
23400     Michael Kerrisk
23401         Add some details of the rresvport() 'port' argument
23402
23403 resolver.3
23404     Petr Baudis
23405         Note that many options are documented in resolv.conf(5)
23406
23407 scandir.3
23408     Michael Kerrisk  [Daniel J Blueman]
23409         Improve EXAMPLE source code: s/0/NULL/ in scandir() call
23410
23411 strchr.3
23412     James Hunt
23413         Explain behavior when searching for '\0'
23414
23415 strerror.3
23416     Eric Blake  [Stefan Puiu]
23417         Improve strerror_r() description
23418             POSIX requires that perror() not modify the static storage
23419             returned by strerror().  POSIX 2008 and C99 both require that
23420             strerror() never return NULL (a strerror() that always
23421             returns "" for all inputs is valid for C99, but not for POSIX).
23422
23423             http://sourceware.org/bugzilla/show_bug.cgi?id=12204
23424             documents glibc's change to come into compliance with POSIX
23425             regarding strerror_r() return value.  The GNU strerror_r() use
23426             of 'buf' was confusing - I ended up writing a test program that
23427             proves that 'buf' is unused for valid 'errnum', but contains
23428             truncated "unknown message" for out-of-range 'errnum'.
23429
23430             See also http://austingroupbugs.net/view.php?id=382
23431     Bernhard Walle
23432         Correct description of error return for XSI strerror_r()
23433     Michael Kerrisk [Eric Blake]
23434         Note how to use 'errno' to detect errors when calling strerror()
23435     Michael Kerrisk  [Jon Grant]
23436         Add an example of the kind of string returned by strerror()
23437
23438 resolv.conf.5
23439     Petr Baudis
23440         Document "single-request" option
23441
23442 inotify.7
23443     Michael Kerrisk
23444         Note buffer size that guarantees being able to read at least one event
23445     James Hunt
23446         Correct description of size of inotify_event structure
23447
23448 iso_8859-1.7
23449     Eugen Dedu
23450         Add "-" for SOFT HYPHEN
23451             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=156154
23452
23453 netdevice.7
23454     Brian F. G. Bidulock
23455         Document some SIOC configuration ioctls
23456             This patch adds common but missing SIOC configuration ioctls to
23457             the netdevice.7 manual pages that are not documented anywhere
23458             else. SIOCSIFPFLAGS and SIOCGIFPFLAGS are linux-specific. Flag
23459             values come from Linux 2.6.25 kernel headers for sockios. The
23460             others are standard BSD ioctls that have always been implemented
23461             by Linux and were verified from inspecting netdevice.c kernel
23462             code.
23463
23464 socket.7
23465     Michael Kerrisk  [Alexey Toptygin]
23466         Correct description of SO_BROADCAST
23467
23468 tcp.7
23469     lepton
23470         Correct description for TCP_MAXSEG on modern kernel
23471
23472
23473 ==================== Changes in man-pages-3.41 ====================
23474
23475 Released: 2012-05-11, Christchurch
23476
23477
23478 Contributors
23479 ------------
23480
23481 The following people contributed patches/fixes or (noted in brackets
23482 in the changelog below) reports, notes, and ideas that have been
23483 incorporated in changes in this release:
23484
23485 Akihiro MOTOKI <amotoki@gmail.com>
23486 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
23487 Angelo Borsotti <angelo.borsotti@gmail.com>
23488 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
23489 Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
23490 Casper Dik <Casper.Dik@oracle.com>
23491 David Prévot <taffit@debian.org>
23492 D. Barbier <bouzim@gmail.com>
23493 Eric Blake <eblake@redhat.com>
23494 Hugh Dickins <hughd@google.com>
23495 Ivana Varekova <varekova@redhat.com>
23496 Jakub Jelinek <jakub@redhat.com>
23497 Jan Kara <jack@suse.cz>
23498 Jason Baron <jbaron@redhat.com>
23499 Jean-Michel Vourgère <jmv_deb@nirgal.com>
23500 Jeff Moyer <jmoyer@redhat.com>
23501 Josh Triplett <josh@joshtriplett.org>
23502 Kasper Dupont <kasperd@gmail.com>
23503 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
23504 Lauri Kasanen <curaga@operamail.com>
23505 Mel Gorman <mgorman@suse.de>
23506 Michael Kerrisk <mtk.manpages@gmail.com>
23507 Mike Frysinger <vapier@gentoo.org>
23508 Nick Piggin <npiggin@gmail.com>
23509 Paul Pluzhnikov <ppluzhnikov@google.com>
23510 Petr Baudis <pasky@ucw.cz>
23511 Ralph Corderoy <ralph@inputplus.co.uk>
23512 Rich Felker <bugdal@aerifal.cx>
23513 Simone Piccardi <piccardi@truelite.it>
23514 Simon Paillard <spaillard@debian.org>
23515 Stefan Puiu <stefan.puiu@gmail.com>
23516 Stephen Hemminger <shemminger@vyatta.com>
23517 Vincent Lefevre <vincent@vinc17.net>
23518 Yuri Kozlov <yuray@komyakino.ru>
23519
23520 Apologies if I missed anyone!
23521
23522
23523 New and rewritten pages
23524 -----------------------
23525
23526 get_robust_list.2
23527     Ivana Varekova  [Michael Kerrisk]
23528         New page documenting get_robust_list(2) and set_robust_list(2)
23529
23530 mallinfo.3
23531     Michael Kerrisk [KOSAKI Motohiro, Paul Pluzhnikov]
23532         New page for mallinfo(3)
23533
23534 malloc_info.3
23535     Michael Kerrisk  [Jakub Jelinek]
23536         New page for malloc_info(3)
23537
23538 malloc_stats.3
23539     Michael Kerrisk  [KOSAKI Motohiro]
23540         New man page for malloc_stats(3)
23541
23542
23543 Newly documented interfaces in existing pages
23544 ---------------------------------------------
23545
23546 madvise.2
23547     Jason Baron
23548         Document MADV_DONTDUMP and MADV_DODUMP
23549
23550
23551 New and changed links
23552 ---------------------
23553
23554 set_robust_list.2
23555     Michael Kerrisk
23556         New link to new get_robust_list.2 page
23557
23558 LIST_ENTRY.3
23559 LIST_HEAD.3
23560 LIST_INIT.3
23561 LIST_INSERT_AFTER.3
23562 LIST_INSERT_HEAD.3
23563 LIST_REMOVE.3
23564 TAILQ_ENTRY.3
23565 TAILQ_HEAD.3
23566 TAILQ_INIT.3
23567 TAILQ_INSERT_AFTER.3
23568 TAILQ_INSERT_HEAD.3
23569 TAILQ_INSERT_TAIL.3
23570 TAILQ_REMOVE.3
23571 CIRCLEQ_ENTRY.3
23572 CIRCLEQ_HEAD.3
23573 CIRCLEQ_INIT.3
23574 CIRCLEQ_INSERT_AFTER.3
23575 CIRCLEQ_INSERT_BEFORE.3
23576 CIRCLEQ_INSERT_HEAD.3
23577 CIRCLEQ_INSERT_TAIL.3
23578 CIRCLEQ_REMOVE.3
23579     Michael Kerrisk
23580         New link to queue.3
23581             The queue(3) page documents these macros, so it makes sense to
23582             have links for the names.
23583
23584 DES_FAILED.3
23585     Michael Kerrisk
23586         New link to des_crypt.3
23587             The des_crypt(3) page documents this macro, so it makes sense
23588             to have a link for the name.
23589
23590 qsort_r.3
23591     Michael Kerrisk
23592         New link to qsort.3
23593             Overlooked to add this link in 3.38, when documentation of
23594             qsort_r() was added to the qsort.3 page.
23595
23596
23597 Global changes
23598 --------------
23599
23600 faccessat.2
23601 fchmodat.2
23602 fchownat.2
23603 fstatat.2
23604 futimesat.2
23605 inotify_init.2
23606 linkat.2
23607 mkdirat.2
23608 mknodat.2
23609 openat.2
23610 readlinkat.2
23611 renameat.2
23612 setns.2
23613 splice.2
23614 symlinkat.2
23615 sync.2
23616 tee.2
23617 unlinkat.2
23618 vmsplice.2
23619     Michael Kerrisk  [Lauri Kasanen]
23620         Global fix: note glibc version that added library support
23621
23622 confstr.3
23623 strcasecmp.3
23624 strcat.3
23625 strcmp.3
23626 strcpy.3
23627 strdup.3
23628 strftime.3
23629 strlen.3
23630 strnlen.3
23631 strpbrk.3
23632 strspn.3
23633 strtok.3
23634 strxfrm.3
23635     Michael Kerrisk  [Andries E. Brouwer]
23636         Clarify that these functions operate on bytes, not (wide) characters
23637             Change 'character(s)' to 'byte(s)' to make clear that these
23638             functions operate on bytes, not wide / UTF8 characters.
23639             (POSIX uses 'byte(s)' similarly, to make this point.)
23640
23641 icmp.7
23642 ipv6.7
23643 packet.7
23644 raw.7
23645 rtnetlink.7
23646 unix.7
23647 x25.7
23648     Michael Kerrisk
23649         Remove names of constants from NAME line
23650             Some of the sockets/network protocol pages included names of
23651             the corresponding address family constants in the NAME line,
23652             but this wasn't done consistently across all pages, and probably
23653             it adds little value in those pages that did do this. So, remove
23654             these constants from those pages that have them in the NAME
23655             section.
23656
23657
23658 Changes to individual pages
23659 ---------------------------
23660
23661 clock_getres.2
23662     Michael Kerrisk  [Josh Triplett]
23663         Expand description of CLOCK_REALTIME
23664             Make it clear that this clock may be discontinuous, and is
23665             affected my incremental NTP and clock-adjtime(2) adjustments.
23666
23667             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=540872
23668
23669 epoll_wait.2
23670     Michael Kerrisk
23671         Clarify that 'timeout' is a *minimum* interval
23672             Make it clear that 'timeout' is a minimum interval; the actual
23673             interval will be rounded up to the system clock granularity,
23674             and may overrun because of kernel scheduling delays.
23675
23676 execve.2
23677     Michael Kerrisk
23678         Rewording to deemphasize libc5 details
23679
23680 fork.2
23681     Mike Frysinger
23682         ERRORS: add ENOSYS
23683             Can occur on, for example, non-MMU hardware.
23684
23685 getcpu.2
23686     Mike Frysinger
23687         Add RETURN VALUE and ERRORS sections
23688     Michael Kerrisk
23689         Refer reader to NOTES for more info about 'tcache'
23690     Michael Kerrisk
23691         DESCRIPTION: reword a sentence to be clearer
23692
23693 io_cancel.2
23694 io_destroy.2
23695 io_getevents.2
23696 io_setup.2
23697 io_submit.2
23698     Michael Kerrisk
23699         Rewrite to focus on system call API
23700             Rewrite to focus on the system call interface, adding
23701             some notes on the libaio wrapper differences.
23702             See the following mail:
23703             2012-05-07 "aio manuals", linux-man@vger
23704             http://thread.gmane.org/gmane.linux.man/1935/focus=2910
23705
23706             Other minor rewrites.
23707
23708 mount.2
23709     Michael Kerrisk
23710         Comment out an old Linux libc detail
23711
23712 open.2
23713     Nick Piggin  [KOSAKI Motohiro, Jan Kara, Hugh Dickins]
23714         Describe race of direct I/O and fork()
23715             Rework 04cd7f64, which didn't capture the details correctly.
23716             See the April/May 2012 linux-man@ mail thread "[PATCH]
23717             Describe race of direct read and fork for unaligned buffers"
23718             http://thread.gmane.org/gmane.linux.kernel.mm/77571
23719
23720 poll.2
23721     Michael Kerrisk
23722         Clarify that 'timeout' is a *minimum* interval
23723             Make it clear that 'timeout' is a minimum interval; the actual
23724             interval will be rounded up to the system clock granularity,
23725             and may overrun because of kernel scheduling delays.
23726     Michael Kerrisk
23727         Clarify discussion of wrapper function emulation
23728             Clarify that glibc (as well as old libc) provides emulation
23729             using select(2) on older kernels that don't have a poll()
23730             system call.
23731     Michael Kerrisk
23732         Make the meaning of a zero timeout explicit
23733             Clarify that timeout==0 causes an immediate return, even if
23734             no file descriptors are ready.
23735
23736 pread.2
23737     Michael Kerrisk  [Kasper Dupont]
23738         BUGS: Note O_APPEND + pwrite() does the wrong thing
23739             See https://bugzilla.kernel.org/show_bug.cgi?id=43178
23740
23741 recvmmsg.2
23742     Michael Kerrisk
23743         Clarify that 'timeout' is a *minimum* interval
23744             Make it clear that 'timeout' interval will be rounded up to the
23745             system clock granularity, and may overrun because of kernel
23746             scheduling delays.
23747
23748 select.2
23749     Michael Kerrisk
23750         Clarify that 'timeout' is a *minimum* interval
23751             Make it clear that 'timeout' is a minimum interval; the actual
23752             interval will be rounded up to the system clock granularity,
23753             and may overrun because of kernel scheduling delays.
23754     Michael Kerrisk
23755         Expand description of the self-pipe trick
23756     Michael Kerrisk
23757         Add further details on pselect6() system call that underlies pselect()
23758
23759 semop.2
23760     Michael Kerrisk
23761         Clarify that 'timeout' of semtimedop() is a *minimum* interval
23762             Make it clear that 'timeout' interval will be rounded up to the
23763             system clock granularity, and may overrun because of kernel
23764             scheduling delays.
23765
23766 signal.2
23767     Michael Kerrisk
23768         Note that 'sig_t' requires _BSD_SOURCE
23769             Also remove some old Linux libc details
23770
23771 sigwaitinfo.2
23772     Michael Kerrisk
23773         Clarify that 'timeout' of sigtimedwait() is a *minimum* interval
23774             Make it clear that 'timeout' is a minimum interval; the actual
23775             interval will be rounded up to the system clock granularity,
23776             and may overrun because of kernel scheduling delays.
23777
23778 stat.2
23779     Bjarni Ingi Gislason
23780         Formatting fixes
23781             From "groff -ww" (or "man --warnings=w ..."):
23782
23783                 warning: around line 442: table wider than line width
23784
23785             GNU man uses line length of 78.
23786
23787             Use text blocks.  Two spaces between sentences or better: start
23788             each sentence in a new line.
23789
23790 syscalls.2
23791     Bjarni Ingi Gislason
23792         Formatting fixes
23793             From "groff -ww ..." (or "man --warnings=w ..."):
23794
23795                 warning: around line 157: table wider than line width
23796
23797             Have to use text blocks.  Move some text to its correct column.
23798             Split text to two columns to avoid hyphenation.
23799
23800 sysinfo.2
23801     Michael Kerrisk
23802         Remove reference to obsolete libc5
23803
23804 syslog.2
23805     Michael Kerrisk
23806         Remove some details about obsolete Linux libc
23807
23808 aio_cancel.3
23809 aio_error.3
23810 aio_fsync.3
23811 aio_read.3
23812 aio_return.3
23813 aio_suspend.3
23814 aio_write.3
23815     Michael Kerrisk
23816         ERRORS: Add/update ENOSYS error
23817
23818 aio_cancel.3
23819     Michael Kerrisk
23820         Clarify what happens when a request isn't successfully canceled
23821     Michael Kerrisk
23822         Add pointers to aio(7) and sigevent(7)
23823
23824 dbopen.3
23825     Michael Kerrisk
23826         SYNOPSIS: Add header file <fcntl.h>
23827             Upstreamed from Debian, and consistent with FreeBSD
23828             dbopen(3) man page.
23829
23830 fmemopen.3
23831     Michael Kerrisk
23832         Note details of POSIX.1-2008 specification of 'b' in 'mode'
23833     Michael Kerrisk  [Rich Felker]
23834         BUGS: fmemopen() doesn't correctly set file position in some cases
23835             If 'mode' is append, but 'size' does not cover a null byte
23836             in 'buf', then fmemopen() incorrectly sets the initial file
23837             position to -1, rather than the next byte after the end of
23838             the buffer.
23839
23840             See http://sourceware.org/bugzilla/show_bug.cgi?id=13151
23841     Michael Kerrisk
23842         BUGS: fmemopen() incorrectly handles size==0 case
23843             If size is zero, fmemopen() fails, This is surprising behavior,
23844             and not specified in POSIX.1-2008.
23845
23846             See http://sourceware.org/bugzilla/show_bug.cgi?id=11216
23847
23848             Reported-by; Alex Shinn <alexshinn@gmail.com>
23849     Michael Kerrisk
23850         BUGS: Note silent ABI change for fmemopen() in glibc 2.9
23851     Michael Kerrisk  [Rich Felker]
23852         BUGS: Append mode does not force writes to append
23853             Append mode correctly sets the initial offset but does
23854             not force subsequent writes to append at end of stream.
23855
23856             See http://sourceware.org/bugzilla/show_bug.cgi?id=13152
23857     Michael Kerrisk  [Eric Blake]
23858         BUGS: Note inconsistent treatment of 'b' in 'mode'
23859             fopen() permits, for example, both "w+b" and "wb+",
23860             but only the latter is meaningful to fmemopen().
23861
23862             See http://sourceware.org/bugzilla/show_bug.cgi?id=12836
23863
23864 fopencookie.3
23865     Michael Kerrisk  [Petr Baudis]
23866         Correct description of return for user-supplied 'write' function
23867             See http://sourceware.org/bugzilla/show_bug.cgi?id=2074
23868
23869 getaddrinfo.3
23870     Jean-Michel Vourgère
23871         Note that AI_ADDRCONFIG is not affected by loopback addresses
23872             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=660479
23873
23874 iconv.3
23875     Michael Kerrisk
23876         Upstream useful NOTE from Debian
23877             Warn the reader that the pointer arguments can't be
23878             interpreted as C style strings. Also, note possible
23879             alignment requirements for the referenced bytes sequences,
23880     Michael Kerrisk
23881         Write a better paragraph introducing iconv() and its arguments
23882
23883 isgreater.3
23884     Michael Kerrisk  [Vincent Lefevre]
23885         Clarify that the arguments to these macros must be real-floating
23886             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=609033
23887
23888 lio_listio.3
23889     Michael Kerrisk
23890         Clarify that async notification occurs when *all* I/Os complete
23891
23892 makedev.3
23893     Michael Kerrisk
23894         SYNOPSIS: Correct return types of major() and minor()
23895             See https://bugzilla.redhat.com/show_bug.cgi?id=754188
23896
23897             Reported-by; Zdenek Kabelac <zkabelac@redhat.com>
23898
23899 malloc.3
23900     Michael Kerrisk
23901         SEE ALSO: Add malloc_info(3)
23902
23903 malloc_get_state.3
23904     Michael Kerrisk
23905         Fix wordos in function names in NAME line
23906
23907 mallopt.3
23908     Michael Kerrisk
23909         Fix example program
23910             The example code was a version that was not consistent with
23911             the shell output shown on the page.
23912
23913             Reported-bY: Simon Paillard <spaillard@debian.org>
23914     Michael Kerrisk
23915         Restore accidentally omitted line in shell session
23916     Michael Kerrisk
23917         SEE ALSO: Add malloc_stats(3)
23918
23919 mmap64.3
23920     Michael Kerrisk
23921         Change target of link to mmap.2 (was mmap2.2)
23922             Upstreamed from Red Hat / Fedora
23923
23924 realpath.3
23925     Michael Kerrisk  [Casper Dik]
23926         Remove note about Solaris possibly returning a relative path
23927
23928 syslog.3
23929     Michael Kerrisk  [Ralph Corderoy]
23930         Document behavior when 'ident' argument to openlog() is NULL
23931             See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/382096
23932     Michael Kerrisk
23933         Update CONFORMING TO for POSIX.1-2008
23934             POSIX.1-2008 doesn't change any details, but make
23935             that more explicit.
23936
23937 undocumented.3
23938     Michael Kerrisk
23939         Remove some functions that have been documented
23940
23941 sd.4
23942     Michael Kerrisk
23943         Remove reference to nonexistent scsi(4) page
23944             Upstreamed from RedHat / Fedora
23945
23946 sk98lin.4
23947     Michael Kerrisk  [Stephen Hemminger]
23948         Note that this driver was removed in 2.6.28
23949             See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/528020
23950
23951 passwd.5
23952     Michael Kerrisk
23953         Upstream pieces from Red Hat/Fedora
23954             Note mention of empty password field.
23955             Add description of "*NP*" in password field.
23956     Michael Kerrisk
23957         Various minor fixes and improvements
23958
23959 proc.5
23960     Michael Kerrisk
23961         Note that CAP_SYS_ADMIN processes can override file-max
23962             Upstreamed from red Hat / Fedora
23963     Michael Kerrisk
23964         Document  /proc/[pid]/cgroup
23965             Upstreamed from Red Hat / Fedora
23966
23967 resolv.conf.5
23968     Michael Kerrisk
23969         Take a Debian improvement into upstream
23970
23971 tzfile.5
23972     Michael Kerrisk
23973         Mention timezone directories in DESCRIPTION
23974             Note that timezone files are usually in /usr/lib/zoneinfo
23975             or /usr/share/zoneinfo.
23976     Michael Kerrisk
23977         Drop SYNOPSIS
23978             The SYNOPSIS doesn't correspond to a user-visible file.
23979     Michael Kerrisk
23980         SEE ALSO: Add pointer to glibc source file timezone/tzfile.h
23981     Michael Kerrisk
23982         SEE ALSO: add tzset(3) and tzselect(8)
23983
23984 ascii.7
23985     Bjarni Ingi Gislason
23986         Indent for "troff" makes table too wide
23987             Fix following from "groff -t -ww ...":
23988
23989                 warning: around line 53: table wider than line width
23990
23991             Extra indent for "troff" makes the table look misplaced
23992             (default "ps" output).
23993
23994 cp1251.7
23995     Bjarni Ingi Gislason
23996         table too wide
23997             From "nroff -ww -t ...":
23998
23999                 warning: around line 44: table wider than line width
24000
24001             Columns are made narrower (column gutter decreased).
24002
24003 ipv6.7
24004     Stefan Puiu
24005         Add ENODEV error for bind() to link-local IPv6 address
24006
24007 signal.7
24008     Michael Kerrisk  [Simone Piccardi]
24009         Clarify that SIGLOST is unused
24010     Michael Kerrisk
24011         Comment out crufty BUGS text on SIGLOST
24012             It must be a very long time since the statement there
24013             about SIGLOST was true. (The text seems to date back to
24014             1996.)
24015     Michael Kerrisk
24016         Update architectures for tables of signal numbers
24017
24018 utf-8.7
24019     Brian M. Carlson
24020         Two clarifications
24021             This patch clarifies that 0xc0 and 0xc1 are not valid in any UTF-8
24022             encoding[0], and it also references RFC 3629 instead of RFC 2279.
24023
24024             [0] In order to have 0xc0, you'd have to have a two-byte encoding
24025             with all the data bits zero in the first byte (and thus only six
24026             bits of data), which would be an ASCII character encoded in the
24027             non-shortest form.  Similarly with 0xc1.
24028
24029             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=538641
24030
24031 ldconfig.8
24032 nscd.8
24033     Michael Kerrisk
24034         Remove path prefix from NAME line
24035             Command names shown in NAME are normally just the basename,
24036             not the full pathname of the command.
24037
24038
24039 ==================== Changes in man-pages-3.42 ====================
24040
24041 Released: 2012-08-14, Konolfingen
24042
24043
24044 Contributors
24045 ------------
24046
24047 The following people contributed patches/fixes or (noted in brackets
24048 in the changelog below) reports, notes, and ideas that have been
24049 incorporated in changes in this release:
24050
24051 Aaron Peschel <aaron.peschel@gmail.com>
24052 Adrian Dabrowski <atrox@seclab.tuwien.ac.at>
24053 Akihiro MOTOKI <amotoki@gmail.com>
24054 Alan Curry <pacman@kosh.dhis.org>
24055 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
24056 Christoph Lameter <cl@linux.com>
24057 Colin McCabe <cmccabe@alumni.cmu.edu>
24058 Daniel Zingaro <daniel.zingaro@utoronto.ca>
24059 David Prévot <taffit@debian.org>
24060 Denys Vlasenko <vda.linux@gmail.com>
24061 Henry Hu <henry.hu.sh@gmail.com>
24062 Herbert Xu <herbert@gondor.apana.org.au>
24063 Jan Engelhardt <jengelh@medozas.de>
24064 Jim Hill <gjthill@gmail.com>
24065 JoonSoo Kim <js1304@gmail.com>
24066 Kalle Olavi Niemitalo <kon@iki.fi>
24067 Martin H <textshell-tSIEzQ@neutronstar.dyndns.org>
24068 Michael Kerrisk <mtk.manpages@gmail.com>
24069 Michael S. Tsirkin <mst@redhat.com>
24070 Rasmus Villemoes <Rasmus.Villemoes@decode.is>
24071 Sami Kerola <kerolasa@iki.fi>
24072 Sam Varshavchik <mrsam@courier-mta.com>
24073 Shawn Landden <shawnlandden@gmail.com>
24074 Simon Paillard <spaillard@debian.org>
24075 Tolga Dalman <tolga.dalman@googlemail.com>
24076 Ulrich Drepper <drepper@gmail.com>
24077 Марк Коренберг <socketpair@gmail.com>
24078
24079 Apologies if I missed anyone!
24080
24081
24082 Global changes
24083 --------------
24084
24085 Various pages
24086     Sami Kerola
24087         Global fix: use UR macro where applicable
24088             The syntax .UR http://example.com paired with .UE will create
24089             links which one can interact, if the pager allows that.  One
24090             way to see the effect is ask the man(1) command to use browser
24091             display, e.g.:
24092
24093                 man -H man7/uri.7
24094
24095             ("\:" is optional groff syntax to permit hyphenless line breaks.)
24096
24097
24098 Changes to individual pages
24099 ---------------------------
24100
24101 ldd.1
24102     Michael Kerrisk
24103         Add security note on untrusted executables
24104             See also http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
24105             and
24106             http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html
24107
24108 clone.2
24109     Michael Kerrisk
24110         Rewrite discussion of sys_clone
24111
24112 futex.2
24113     Марк Коренберг
24114         Consolidate error descriptions to ERRORS
24115     Michael Kerrisk
24116         Various wording fix-ups
24117     Michael Kerrisk
24118         Fix description of EINVAL error
24119             The current text seems incorrect. Replace with a more general
24120             description.
24121
24122 getdents.2
24123 select_tut.2
24124 atof.3
24125 atoi.3
24126 pthread_create.3
24127 pthread_sigmask.3
24128 rtime.3
24129 setbuf.3
24130 tsearch.3
24131 netlink.7
24132     Michael Kerrisk  [Jan Engelhardt]
24133         Remove unneeded casts
24134
24135 get_robust_list.2
24136 get_thread_area.2
24137 getcpu.2
24138 getdents.2
24139 gettid.2
24140 io_cancel.2
24141 io_destroy.2
24142 io_getevents.2
24143 io_setup.2
24144 io_submit.2
24145 ioprio_set.2
24146 kexec_load.2
24147 llseek.2
24148 modify_ldt.2
24149 mq_getsetattr.2
24150 pivot_root.2
24151 readdir.2
24152 rt_sigqueueinfo.2
24153 set_thread_area.2
24154 sgetmask.2
24155 spu_create.2
24156 spu_run.2
24157 subpage_prot.2
24158 sysctl.2
24159 tkill.2
24160     Michael Kerrisk
24161         Add note to SYNOPSIS that there is no glibc wrapper for system call
24162             Reduce the chance that the reader may be misled into thinking
24163             that there is a wrapper function for this system call by noting
24164             explicitly in the SYNOPSIS that there is no glibc wrapper and
24165             pointing the reader to NOTES for further details.
24166
24167 ioprio_set.2
24168     Colin McCabe
24169         Clarify the multithreaded behavior of ioprio_set(2)
24170     Michael Kerrisk  [Марк Коренберг, Kalle Olavi Niemitalo]
24171         Document who==0 for IOPRIO_WHO_PROCESS and IOPRIO_WHO_PGRP
24172             For IOPRIO_WHO_PROCESS, who==0 means operate on the caller.
24173             For IOPRIO_WHO_PGRP, who==0 means operate on the caller's
24174             process group.
24175
24176             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=652443
24177
24178 migrate_pages.2
24179     Michael Kerrisk  [Christoph Lameter, JoonSoo Kim]
24180         Fix description of return value
24181
24182 mount.2
24183     Michael Kerrisk
24184         For MS_REMOUNT, source is ignored
24185
24186 mprotect.2
24187     Michael Kerrisk  [Rasmus Villemoes]
24188         'addr' argument is not const
24189             As reported by Rasmus:
24190
24191                 Both my system's man-pages (3.22) and the latest online
24192                 (3.41) show:
24193
24194                     int mprotect(const void *addr, size_t len, int prot);
24195
24196                 as the prototype for mprotect(2). However, POSIX [1] and the
24197                 actual sys/mman.h (on all the systems I checked) do not have
24198                 the const qualifier on the first argument.
24199
24200 msgctl.2
24201 semctl.2
24202 shmctl.2
24203 svipc.7
24204     Michael Kerrisk
24205         Don't mention that ipc_perm is defined in <sys/ipc.h>
24206             There's no need to mention that the 'ipc_perm' structure
24207             is defined in <sys/ipc.h>. That's an implementation detail,
24208             and furthermore <sys/ipc.h> is itself included by the other
24209             System V IPC header files. The current text might lead the
24210             reader to conclude that they must include <sys/ipc.h>, which
24211             is not the case (it is required neither on Linux, nor by the
24212             standards).
24213
24214 msgctl.2
24215 msgget.2
24216 msgop.2
24217 semctl.2
24218 semget.2
24219 semop.2
24220 shmctl.2
24221 shmget.2
24222     Michael Kerrisk
24223         NOTES: <sys/types.h> and <sys/ipc.h> aren't strictly needed
24224             Add text to NOTES to say that the <sys/types.h> and <sys/ipc.h>
24225             header files aren't required by Linux or the standards, but may
24226             be needed for portability to old systems.
24227
24228 ptrace.2
24229     Denys Vlasenko
24230         Explain WNOHANG behavior and EINTR bug
24231             I didn't like the "SIGKILL operates similarly, with exceptions"
24232             phrase (if it's different, then it's not "similar", right?),
24233             and now I got around to changing it. Now it says simply:
24234             "SIGKILL does not generate signal-delivery-stop and therefore
24235             the tracer can't suppress it."
24236
24237             Replaced "why WNOHANG is not reliable" example with a more
24238             realistic one (the one which actually inspired to add this
24239             information to man page in the first place): we got
24240             ESRCH - process is gone! - but waitpid(WNOHANG) can still
24241             confusingly return 0 "no processes to wait for".
24242
24243             Replaced "This means that unneeded trailing arguments may
24244             be omitted" part with a much better recommendation
24245             to never do that and to supply zero arguments instead.
24246             (The part about "undocumentedness" of gcc behavior was bogus,
24247             btw - deleted).
24248
24249             Expanded BUGS section with the explanation and an example
24250             of visible strace behavior on the buggy syscalls which
24251             exit with EINTR on ptrace attach. I hope this will lead
24252             to people submitting better bug reports to lkml about
24253             such syscalls.
24254
24255 seteuid.2
24256     Michael Kerrisk
24257         Note glibc version where setegid() implementation changed
24258             In glibc 2.2/2.3, setegid() switched from setregid() to setresgid().
24259
24260 set_tid_address.2
24261     Michael Kerrisk
24262         Rename 'ctid' argument for consistency with clone(2) page
24263     Michael Kerrisk
24264         Some rewordings and minor clarifications
24265
24266 sigwaitinfo.2
24267     Michael Kerrisk  [Daniel Zingaro]
24268         Some wording clarifications
24269             Mainly rewording things like "is delivered" to "becomes pending",
24270             which is more accurate terminology.
24271
24272 syscall.2
24273     Michael Kerrisk
24274         Add some more details to the description of syscall(2)
24275             And add another example of using syscall() to the program example.
24276
24277 syscalls.2
24278     Michael Kerrisk
24279         Add kcmp(2)
24280     Michael Kerrisk
24281         Move discussion of set_zone_reclaim(2) out of main table
24282             This system call was never visible to user space, so it makes
24283             sense to move it out of the main table of system calls into
24284             the notes below the table.
24285
24286 getifaddrs.3
24287     Michael Kerrisk  [Adrian Dabrowski]
24288         Note that ifa_addr and ifa_netmask can be NULL
24289
24290 readdir.3
24291     Michael Kerrisk  [Jan Engelhardt]
24292         Handle -1 error from pathconf() in example code snippet
24293             Improve the example demonstrating allocation of a buffer
24294             for readdir_r() to handle -1 error return from pathconf().
24295             Otherwise, naive readers may think that pathconf() return
24296             value can be used without checking.
24297
24298 realpath.3
24299     Shawn Landden
24300         Use past tense with ancient history (libc4, libc5)
24301
24302 regex.3
24303     Michael Kerrisk
24304         Correct SEE ALSO reference to glibc manual "regex" section
24305
24306 rtime.3
24307     Michael Kerrisk  [Jan Engelhardt]
24308         Fix broken pointer cast in example code
24309
24310 sem_close.3
24311 sem_destroy.3
24312 sem_getvalue.3
24313 sem_init.3
24314 sem_open.3
24315 sem_post.3
24316 sem_unlink.3
24317 sem_wait.3
24318 sem_overview.7
24319     Michael Kerrisk
24320         Note that "cc -pthread" is required; "-lrt" no longer works
24321             See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/874418
24322
24323 sigwait.3
24324     Michael Kerrisk
24325         Reword "is delivered" to "becomes pending"
24326
24327 strcat.3
24328     Michael Kerrisk
24329         Add some text to emphasize the dangers of buffer overruns
24330     Michael Kerrisk
24331         NOTES: Add discussion of strlcat()
24332
24333 strcpy.3
24334     Michael Kerrisk
24335         Note that info is lost when strncpy() doesn't null terminate
24336     Michael Kerrisk
24337         Add some text to emphasize possibility of buffer runs with strcpy()
24338     Michael Kerrisk
24339         NOTES: Add a discussion of strlcpy()
24340             Inspired by https://lwn.net/Articles/506530/
24341     Michael Kerrisk
24342         Fix description of the null-byte padding performed by strncpy()
24343
24344 tsearch.3
24345     Michael Kerrisk
24346         NOTES: remove redundant discussion of unorthodox use of term "postorder"
24347             This point is already covered at greater length in the main
24348             text of the page (See the piece "More commonly, ...").
24349     Michael Kerrisk
24350         Clarify use for first argument to the twalk() 'action' function
24351             There's a number of details in POSIX that are omitted in
24352             the current version of this page.
24353     Michael Kerrisk
24354         Some wording fixes
24355
24356 core.5
24357     Michael Kerrisk
24358         Note effect of madvise(2) MADV_DONTDUMP flag
24359
24360 capabilities.7
24361     Michael Kerrisk
24362         Document CAP_BLOCK_SUSPEND
24363
24364 glob.7
24365     Bjarni Ingi Gislason
24366         Change 8 bit characters to 7 bit representation
24367             Fixes rendering errors for accented 'a' characters.
24368     Michael Kerrisk  [Aaron Peschel]
24369         Update bash(1) command used to obtain classical globbing behavior
24370             The man page formerly noted the bash(1) v1 command to do this.
24371
24372 iso_8859-1.7
24373     Bjarni Ingi Gislason
24374         Explanation of SOFT HYPHEN and the code for it
24375             <groff: iso_8859-2.7>:89: warning: can't find special character `shc'
24376
24377             This is the only "iso_8859-*.7" file that has this (now)
24378             undefined character.  The code in column four in "iso_8859-1.7" is
24379             "0x2D" ("HYPHEN, MINUS SIGN" or "HYPHEN-MINUS") instead of "0xAD".
24380             See Debian bug 156154 (or package "manpages").
24381
24382             There should be an explanation for this graphic character and the
24383             code should be 0xAD in iso_8859-1.7 (as in all others), even
24384             though "[gn]roff" does not display a "HYPHEN" in that position of
24385             the table.
24386
24387             The line with "SOFT HYPHEN" gets a footnote and a short
24388             explanation.
24389
24390 mdoc.7
24391     Bjarni Ingi Gislason
24392         Fixing a warning and a table
24393             Fis warning from "groff -ww ..." (or "man --warnings=w ..."):
24394
24395                 <groff: mdoc.7>:294: warning:
24396                 tab character in unquoted macro argument
24397
24398             In one table the distance between columns is too small in the
24399             "ps" output.  (Bug in the groff "doc.tmac" macro?)
24400
24401 mdoc.samples.7
24402     Bjarni Ingi Gislason
24403         Fix warnings from [ng]roff, corrections
24404             From "man -ww ..." (groff -ww ...):
24405
24406                 <standard input>:541: warning:
24407                 tab character in unquoted macro argument
24408                 [+3 similar warnings]
24409                 <standard input>:813: warning: macro `Pu' not defined
24410                 Usage: .Rv -std in sections 2 and 3 only (#1669)
24411                 mdoc warning: A .Bl directive has no matching .El (#1821)
24412
24413             String "Pu" defined as a row of punctuation characters.
24414             ".Bl" and ".El" fixed.
24415             Some arguments, that start with a period or are the name of a
24416             macro, protected with "\&".
24417             Variable name for macro ".Rv" corrected.
24418
24419 netdevice.7
24420     Bjarni Ingi Gislason
24421         Line in table too long
24422             Fix warning from "man ..." ("nroff -ww ..."):
24423
24424                 nroff: netdevice.7: warning: around line 98:
24425                 table wider than line width
24426
24427             Fix: No right adjustment in text blocks in tables.
24428
24429             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673873
24430
24431 netlink.7
24432     Bjarni Ingi Gislason
24433         Line in table is too long
24434             Fix warning from "man ..." ("nroff -ww ..."):
24435
24436                 nroff: netlink.7: warning: around line 195:
24437                 table wider than line width
24438
24439             Horizontal line incorporated into table.
24440             No right adjustment of text blocks in tables.
24441
24442             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673875
24443     Simon Paillard  [Herbert Xu]
24444         Change description of "*_pid" fields to "Port ID"
24445             As reported by Herbert Xu, these should not be considered as PIDs.
24446
24447             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=383296
24448
24449 rtnetlink.7
24450     Bjarni Ingi Gislason
24451         Line in table too long
24452             Fix warning from "man ..." ("nroff -ww ..."):
24453
24454                 nroff: rtnetlink.7: warning: around line 415:
24455                 table wider than line width
24456
24457             Column gutter reduced to fit line length.
24458             Right adjustment in text blocks removed in tables.
24459             Some header made centered in tables.
24460             One table put on same page.
24461
24462             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674051
24463
24464 socket.7
24465     Martin H
24466         Document SO_MARK socket option
24467             Commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0 in Jan 2008 added
24468             the new SO_MARK socket option.
24469
24470             This patch is based on text from the commit message.
24471
24472             See https://bugzilla.kernel.org/show_bug.cgi?id=16461.
24473
24474 svipc.7
24475     Michael Kerrisk
24476         SYNOPSIS: Remove include of <sys/types.h> and <sys/ipc.h>
24477             Including <sys/types.h> and <sys/ipc.h> isn't needed on Linux
24478             and isn't really relevant for the explanation on this page.
24479
24480
24481 ==================== Changes in man-pages-3.43 ====================
24482
24483 Released: 2012-10-05, Munich
24484
24485
24486 Contributors
24487 ------------
24488
24489 The following people contributed patches/fixes or (noted in brackets
24490 in the changelog below) reports, notes, and ideas that have been
24491 incorporated in changes in this release:
24492
24493 Adrian Bunk <bunk@kernel.org>
24494 Anatoli Klassen <anatoli@aksoft.net>
24495 Andreas Schwab <schwab@linux-m68k.org>
24496 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
24497 David Prévot <taffit@debian.org>
24498 Eric Dumazet <edumazet@google.com>
24499 Florian Weimer <fweimer@redhat.com>
24500 Frédéric Brière <fbriere@fbriere.net>
24501 Fredrik Arnerup <arnerup@kth.se>
24502 Guillem Jover <guillem@hadrons.org>
24503 Jan Engelhardt <jengelh@inai.de>
24504 Michael Kerrisk <mtk.manpages@gmail.com>
24505 Simon Josefsson <simon@josefsson.org>
24506 Stephane Fillod <fillods@users.sf.net>
24507 Trevor Woerner <twoerner@gmail.com>
24508 Yuri Kozlov <yuray@komyakino.ru>
24509
24510 Apologies if I missed anyone!
24511
24512
24513 Newly documented interfaces in existing pages
24514 ---------------------------------------------
24515
24516 getenv.3
24517     Michael Kerrisk  [Florian Weimer, Andreas Schwab]
24518         Document secure_getenv(3)
24519
24520
24521 New and changed links
24522 ---------------------
24523
24524 phys.2
24525     Michael Kerrisk
24526         New link to unimplemented.2
24527
24528 secure_getenv.3
24529     Michael Kerrisk
24530         New link to getenv.3
24531
24532
24533 Global changes
24534 --------------
24535
24536 Various pages
24537     Michael Kerrisk
24538         Global fix: s/-/\\-/ when real hyphen is required (e.g., in code)
24539
24540 Various pages
24541     David Prévot [Michael Kerrisk]
24542         Global fix: Various consistency fixes for SEE ALSO
24543
24544 Various pages
24545     Michael Kerrisk
24546         Global fix: use "Linux kernel source" consistently
24547             Rather than "kernel source".
24548
24549 Various pages
24550     Michael Kerrisk
24551         Global fix: disable justification and hyphenation in SEE ALSO
24552             For a better visual result, disable justification and hyphenation
24553             in SEE ALSO where page names are long.
24554
24555 syscalls.2
24556 uname.2
24557 boot.7
24558     Michael Kerrisk
24559         Global fix: s/OS/operating system/
24560
24561
24562 Changes to individual pages
24563 ---------------------------
24564
24565 epoll_wait.2
24566     Michael Kerrisk  [Fredrik Arnerup]
24567         Describe timeout limitation in kernels < 2.6.37
24568             As reported by Fredrik (and as far as I can tell the problem
24569             went back to 2.6.0):
24570
24571             The timeout argument has an upper limit. Any values above that
24572             limit are treated the same as -1, i.e. to wait indefinitely.
24573             The limit is given by:
24574
24575                 #define EP_MAX_MSTIMEO min(1000ULL * MAX_SCHEDULE_TIMEOUT / HZ, \
24576                 (LONG_MAX - 999ULL) / HZ)
24577
24578             That is, the limit depends on the size of a long and the timer
24579             frequency.  Assuming the a long is never smaller than 32 bits
24580             and HZ never larger than 1000, the worst case is 35 minutes.
24581             I think this should be mentioned under "BUGS".
24582
24583             Although this is likely to be fixed in the future
24584             (http://lkml.org/lkml/2010/8/8/144), the problem exists in
24585             at least 2.6.14 - 2.6.35. I don't know if select(2) and poll(2)
24586             are affected.
24587
24588             https://bugzilla.kernel.org/show_bug.cgi?id=20762
24589     Michael Kerrisk
24590         Add pointer to select(2) for discussion of close in another thread
24591
24592 getitimer.2
24593     Michael Kerrisk  [Trevor Woerner]
24594         Note Linux's odd handling of the new_value==NULL case
24595     Michael Kerrisk  [Trevor Woerner]
24596         Fix types used to declare fields in timeval struct
24597
24598 keyctl.2
24599     David Prévot
24600         Reorder SEE ALSO, without .br
24601
24602 poll.2
24603     Michael Kerrisk
24604         Add pointer to select(2) for discussion of close in another thread
24605
24606 select.2
24607     Michael Kerrisk  [Stephane Fillod]
24608         Note behavior if monitored file descriptor is closed in another thread
24609             Executive summary: a sane application can't rely on any
24610             particular behavior if another thread closes a file descriptor
24611             being monitored by select().
24612
24613             See https://bugzilla.kernel.org/show_bug.cgi?id=40852
24614     Michael Kerrisk
24615         Clarify equivalent pselect() code in terms of threads
24616             s/sigprogmask/pthread_sigmask/
24617
24618 semop.2
24619     Michael Kerrisk
24620         Recast discussion of blocking behavior in terms of threads
24621             semop() blocks the calling thread, not the process.
24622     Michael Kerrisk
24623         SEE ALSO: Add clone(2)
24624             Give reader a clue about CLONE_SYSVSEM.
24625
24626 shutdown.2
24627     Michael Kerrisk  [Eric Dumazet]
24628         Document EINVAL error (and associated bug)
24629             Eric Dumazet noted that EINVAL was not documented. Some further
24630             digging shows that it's also not diagnosed consistently.
24631             See https://bugzilla.kernel.org/show_bug.cgi?id=47111.
24632
24633 sigaction.2
24634     Michael Kerrisk
24635         Tweak SA_RESETHAND description
24636
24637 timer_settime.2
24638     Michael Kerrisk
24639         Small rewording around discussion of pointer arguments
24640
24641 wait4.2
24642     Adrian Bunk
24643         Note that these functions are nonstandard and recommend alternatives
24644             Some edits to Adrian's patch by mtk.
24645     Michael Kerrisk
24646         CONFORMING TO: Note SUS details for wait3()
24647
24648 gnu_get_libc_version.3
24649     Michael Kerrisk
24650         Remove unneeded "#define _GNU_SOURCE" from SYNOPSIS
24651
24652 pthread_kill.3
24653 pthread_sigqueue.3
24654     Michael Kerrisk
24655         Remove wording "another"
24656             Writing "another thread" in these pages implies that these
24657             functions can't be used to send a signal to the calling thread
24658             itself, which is of course untrue.
24659
24660 sigvec.3
24661     Michael Kerrisk
24662         Add "int" arg to sv_handler definition in sigvec structure
24663     Michael Kerrisk
24664         Fix small error in discussion of blocking of signals
24665             The signal that causes the handler to be invoked is blocked,
24666             but saying "by default" implies that this can be changed via
24667             the API. It cannot. (One needs sigaction(2) for that.)
24668
24669 syslog.3
24670     Simon Josefsson
24671         Remove (apparently bogus) text claiming LOG_AUTH is deprecated
24672             LOG_AUTH is in POSIX, and widely available. There
24673             seems to be no basis to the claim it is deprecated.
24674
24675             Quoting Simon:
24676                 I cannot find any other source that claim LOG_AUTH is
24677                 deprecated in any way.  LOG_AUTH is distinct from
24678                 LOG_AUTHPRIV.  The GNU C Library manual only documents
24679                 LOG_AUTH.  The header files contains both without any
24680                 comment.  Common systems like Debian appear to refer to
24681                 both auth and authpriv facilities in syslog configurations.
24682                 Popular daemons appear to use both facilities.
24683                 Both facilities are discussed in several RFCs.
24684
24685             See https://bugzilla.kernel.org/show_bug.cgi?id=46091
24686
24687 ttyname.3
24688     Michael Kerrisk
24689         SEE ALSO: Add ctermid(3)
24690
24691 proc.5
24692     Michael Kerrisk
24693         Clarify header file related to 'flags' field of /proc/PID/stat
24694     Michael Kerrisk  [Frédéric Brière]
24695         Update description of 'starttime' field of /proc/PID/stat
24696             The unit of measurement changed from jiffies to clock ticks in
24697             Linux 2.6.
24698
24699             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=675891
24700     Michael Kerrisk
24701         Document /proc/sys/kernel/kptr_restrict
24702     Michael Kerrisk [Kees Cook]
24703         Document /proc/sys/fs/protected_symlinks
24704             Based on text in Documentation/sysctl/fs.txt by Kees Cook
24705     Michael Kerrisk [Kees Cook]
24706         Document /proc/sys/fs/protected_hardlinks
24707             Based on text in Documentation/sysctl/fs.txt by Kees Cook
24708
24709 capabilities.7
24710     Michael Kerrisk
24711         Document interaction of CAP_SYSLOG and /proc/sys/kernel/kptr_restrict
24712
24713 ip.7
24714     Michael Kerrisk
24715         SEE ALSO: Add ipv6(7)
24716         SEE ALSO: Add icmp(7)
24717
24718 man-pages.7
24719     Michael Kerrisk
24720         Add some advice about disabling hyphenation in SEE ALSO
24721
24722 ld.so.8
24723     Michael Kerrisk
24724         Describe interpretation of slashes in dependency strings
24725     Michael Kerrisk
24726         Repeat note that LD_LIBRARY_PATH is ignored in privileged programs
24727             This point is already noted when discussing search order for
24728             libraries, but it's worth repeating under the specific discussion
24729             of LD_LIBRARY_PATH further down the page.
24730     Michael Kerrisk
24731         Add some details for LD_PRELOAD
24732         Note that LD_PRELOAD list separator can be space or colon
24733
24734
24735 ==================== Changes in man-pages-3.44 ====================
24736
24737 Released: 2012-11-07, Barcelona
24738
24739
24740 Contributors
24741 ------------
24742
24743 The following people contributed patches/fixes or (noted in brackets
24744 in the changelog below) reports, notes, and ideas that have been
24745 incorporated in changes in this release:
24746
24747 Bert Hubert <bert.hubert@netherlabs.nl>
24748 David Prévot <taffit@debian.org>
24749 James Youngman <jay@gnu.org>
24750 Kees Cook <keescook@chromium.org>
24751 Lars Wirzenius <liw@iki.fi>
24752 Lucas De Marchi <lucas.de.marchi@gmail.com>
24753 Michael Kerrisk <mtk.manpages@gmail.com>
24754 Rusty Russell <rusty@rustcorp.com.au>
24755 Simon Paillard <spaillard@debian.org>
24756 Thomas Habets <thomas@habets.se>
24757
24758 Apologies if I missed anyone!
24759
24760
24761 New and rewritten pages
24762 -----------------------
24763
24764 delete_module.2
24765     Michael Kerrisk
24766         Rewrite to Linux 2.6+ reality
24767     Michael Kerrisk
24768         Change license and copyright
24769             There is now nothing left of the original FSF-copyrighted
24770             page. So, change the copyright and license.
24771     Michael Kerrisk  [Lucas De Marchi, Rusty Russell]
24772         Substantial reorganization after comments from Rusty Russell
24773             Rusty notes that O_NONBLOCK is almost always used in
24774             practice. Therefore, it would be better to reorganize
24775             the page to consider that "the default".
24776
24777 init_module.2
24778     Michael Kerrisk
24779         Rewrite to Linux 2.6+ reality
24780     Michael Kerrisk
24781         Change copyright and license
24782             Little of the original page now remains. Change
24783             copyright and license
24784     Michael Kerrisk  [Rusty Russell]
24785         Changes after review comments from Rusty Russell
24786     Kees Cook
24787         Add various pieces describing Linux 2.6+ behavior
24788             Pieces take from, or inspired by, a patch sent by Kees.
24789
24790 getauxval.3
24791     Michael Kerrisk
24792         Document getauxval() function added in glibc 2.16
24793
24794
24795 Global changes
24796 --------------
24797
24798 Various pages
24799     Michael Kerrisk
24800         Global fix: Use consistent capitalization in NAME section
24801             The line(s) in the NAME section should only use capitals
24802             where English usage dictates that. Otherwise, use
24803             lowercase throughout.
24804
24805 Various pages
24806     Michael Kerrisk
24807         Global fix: "userspace" ==> "user space" or "user-space"
24808             Existing pages variously use "userspace or "user space".
24809             But, "userspace" is not quite an English word.
24810             So change "userspace" to "user space" or, when used
24811             attributively, "user-space".
24812
24813
24814 Changes to individual pages
24815 ---------------------------
24816
24817 clock_getres.2
24818 clock_nanosleep.2
24819     Michael Kerrisk
24820         Linking with -lrt is no longer needed from glibc 2.17 onward
24821
24822 create_module.2
24823     Michael Kerrisk
24824         Note that this system call is present only in kernels before 2.6
24825     Michael Kerrisk
24826         Note that ENOSYS probably indicates kernel 2.6+
24827
24828 execve.2
24829     Michael Kerrisk
24830         Document treatment of PR_SET_PDEATHSIG on execve()
24831     Michael Kerrisk
24832         Document treatment of SECBIT_KEEP_CAPS securebits flag on execve()
24833
24834 fork.2
24835     Michael Kerrisk
24836         Note treatment of default timer slack value on fork()
24837
24838 getdomainname.2
24839     Simon Paillard  [Lars Wirzenius]
24840         Point out that these calls relate to NIS, not DNS
24841             See http://bugs.debian.org/295635
24842
24843 get_kernel_syms.2
24844     Michael Kerrisk
24845         Note that this system call is present only in kernels before 2.6
24846
24847 ipc.2
24848     Michael Kerrisk
24849         Update note on architectures that don't have ipc()
24850             Replace mention of ia64 with x86-64 and ARM.
24851
24852 link.2
24853     Michael Kerrisk
24854         Add EPERM error triggered by /proc/sys/fs/protected_hardlink
24855
24856 prctl.2
24857     Michael Kerrisk
24858         Mention Documentation/prctl/no_new_privs.txt for PR_SET_NO_NEW_PRIVS
24859     Kees Cook
24860         update seccomp sections for mode 2 (BPF)
24861             This adds a short summary of the arguments used
24862             for "mode 2" (BPF) seccomp.
24863     Michael Kerrisk
24864         Small improvements to PR_SET_SECCOMP discussion
24865             Note type of 'arg3' for SECCOMP_MODE_FILTER.
24866             Add pointer to Documentation/prctl/seccomp_filter.txt.
24867     Michael Kerrisk
24868         Note 'seccomp' semantics with respect to fork(), execve(), and prctl()
24869     Michael Kerrisk
24870         Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK
24871     Michael Kerrisk
24872         Reword PR_SET_NAME and PR_GET_NAME in terms of threads
24873             Plus tfix
24874     Kees Cook
24875         document PR_SET_NO_NEW_PRIVS, PR_GET_NO_NEW_PRIVS
24876             This adds a short description of the no_new_privs bit,
24877             as described in Documentation/prctl/no_new_privs.txt.
24878
24879 ptrace.2
24880     Michael Kerrisk
24881         Clarify that some operations are not present on all architectures
24882             PTRACE_GETREGS, PTRACE_SETGREFS, PTRACE_GETFPREGS,
24883             and PTRACE_GETSPREGS are not present on all architectures.
24884             PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP are present only
24885             on x86.
24886
24887             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=122383
24888
24889 query_module.2
24890     Michael Kerrisk
24891         Add a few words clarifying reference to /sys/module
24892     Michael Kerrisk
24893         Note that this system call is present only in kernels before 2.6
24894     Michael Kerrisk
24895         Note that ENOSYS probably indicates kernel 2.6+
24896     Michael Kerrisk
24897         SEE ALSO: Add modinfo(8) and lsinfo(8)
24898     Michael Kerrisk
24899         Move some information in NOTES to VERSIONS
24900
24901 socketcall.2
24902     Michael Kerrisk
24903         Update note on architectures that don't have socketcall()
24904             Replace mention of ia64 with x86-64 and ARM.
24905
24906 times.2
24907     Thomas Habets
24908         Recommend clock_gettime(2) as alternative to times(2)
24909
24910 clock_getcpuclockid.3
24911     Michael Kerrisk
24912         Linking with -lrt is no longer needed from glibc 2.17 onward
24913
24914 fts.3
24915     Simon Paillard  [James Youngman]
24916         Improve description of physical vs. logical tree walking
24917             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=633505
24918
24919 getenv.3
24920     Michael Kerrisk
24921         SEE ALSO: add getauxval(3)
24922
24923 proc.5
24924     Michael Kerrisk
24925         Document /proc/meminfo
24926             Info mostly taken from Documentation/filesystems/proc.txt
24927             and Documentation/vm/hugetlbpage.txt.
24928     Michael Kerrisk
24929         Default for /proc/sys/fs/protected_{hardlinks,symlinks} is now 0
24930             The default setting of 1 in/proc/sys/fs/protected_hardlinks
24931             and /proc/sys/fs/protected_symlinks caused one too many
24932             breakages for Linus's taste, so commit 561ec64ae67e changed
24933             the default for both files to 0.
24934         Note system call error yielded by /proc/sys/fs/protected_symlinks
24935             Note that violating 'protected_symlinks' restrictions
24936             causes system calls to fail with the error EACCES.
24937     Michael Kerrisk
24938         Since Linux 2.6.27, /proc/sys/kernel/modprobe depends on CONFIG_MODULES
24939
24940 ipv6.7
24941     Bert Hubert
24942         Document IPV6_RECVPKTINFO
24943
24944 man-pages.7
24945     Michael Kerrisk
24946         Note rules for capitalization in NAME section
24947
24948 time.7
24949     Michael Kerrisk
24950         Add a subsection on timer slack
24951
24952 ld.so.8
24953     Michael Kerrisk
24954         SEE ALSO: add getauxval(3)
24955
24956
24957 ==================== Changes in man-pages-3.45 ====================
24958
24959 Released: 2012-12-21, Christchurch
24960
24961
24962 Contributors
24963 ------------
24964
24965 The following people contributed patches/fixes or (noted in brackets
24966 in the changelog below) reports, notes, and ideas that have been
24967 incorporated in changes in this release:
24968
24969 Andi Kleen <andi@firstfloor.org>
24970 Cyril Hrubis <chrubis@suse.cz>
24971 David Prévot <taffit@debian.org>
24972 Elie De Brauwer <eliedebrauwer@gmail.com>
24973 Eric Dumazet <eric.dumazet@gmail.com>
24974 Felipe Pena <felipensp@gmail.com>
24975 Florian Weimer <fweimer@redhat.com>
24976 Gao Feng <gaofeng@cn.fujitsu.com>
24977 Jan Glauber <jang@linux.vnet.ibm.com>
24978 Jim Paris <jim@jtan.com>
24979 Jon Grant <jg@jguk.org>
24980 Julien Cristau <jcristau@debian.org>
24981 Michael Kerrisk <mtk.manpages@gmail.com>
24982 Mike Frysinger <vapier@gentoo.org>
24983 Rens van der Heijden <rens.vanderheijden@uni-ulm.de>
24984 Simon Paillard <spaillard@debian.org>
24985 Thierry Vignaud <thierry.vignaud@gmail.com>
24986 Trevor Woerner <twoerner@gmail.com>
24987 YOSHIFUJI Hideaki <yoshfuji@linux-ipv6.org>
24988
24989 Apologies if I missed anyone!
24990
24991
24992 New and rewritten pages
24993 -----------------------
24994
24995 s390_runtime_instr.2
24996     Jan Glauber
24997         New page for s390-specific s390_runtime_instr(2)
24998
24999 if_nameindex.3
25000     YOSHIFUJI Hideaki
25001         Document if_nameindex(3) and if_freenameindex(3)
25002     Michael Kerrisk
25003         Edits, improvements and corrections to Hideaki's page
25004     Michael Kerrisk
25005         Add an example program
25006
25007 if_nametoindex.3
25008     YOSHIFUJI Hideaki
25009         New page documenting if_nametoindex(3) and if_indextoname(3)
25010
25011
25012 New and changed links
25013 ---------------------
25014
25015 if_freenameindex.3
25016     Michael Kerrisk
25017         New link to if_nameindex.3
25018
25019 if_indextoname.3
25020     Michael Kerrisk
25021         New link to if_nametoindex.3
25022
25023
25024 Global changes
25025 --------------
25026
25027 sysconf.3
25028 cciss.4
25029     Michael Kerrisk
25030         Global fix: s/runtime/run time/
25031
25032
25033 Changes to individual pages
25034 ---------------------------
25035
25036 clone.2
25037     Michael Kerrisk
25038         Since 2.6.30, CLONE_NEWIPC also supports POSIX message queues
25039
25040 delete_module.2
25041     Michael Kerrisk
25042         Small rewording of description of effect of O_TRUNC
25043
25044 getrlimit.2
25045     Michael Kerrisk  [Trevor Woerner]
25046         Document Linux's nonstandard treatment or RLIMIT_CPU soft limit
25047             Upon encountering the RLIMIT_CPU soft limit when a SIGXCPU handler
25048             has been installed, Linux invokes the signal handler *and* raises
25049             the soft limit by one second. This behavior repeats until the
25050             limit is encountered.  No other implementation that I tested
25051             (Solaris 10, FreeBSD 9.0, OpenBSD 5.0) does this, and it seems
25052             unlikely to be POSIX-conformant. The (Linux-specific)
25053             RLIMIT_RTTIME soft limit exhibits similar behavior.
25054     Michael Kerrisk
25055         Point reader at discussion of /proc/[pid]/limits in proc(5)
25056
25057 io_getevents.2
25058     Michael Kerrisk
25059         io_getevents() may cause segfault when called with invalid ctx_id
25060             For reference see: http://marc.info/?l=linux-aio&m=130089887002435&w=2
25061
25062 recv.2
25063     Michael Kerrisk  [Eric Dumazet]
25064         UNIX domain sockets support MSG_TRUNC since 3.4
25065
25066 sendmmsg.2
25067     Elie De Brauwer
25068         Add example program for sendmmsg()
25069
25070 stat.2
25071     Simon Paillard
25072         Clarify description of EOVERFLOW error
25073             The EOVERFLOW error is not only for st_size, but also
25074             inode and block size fields. See glibc source file
25075             sysdeps/unix/sysv/linux/xstatconv.c and kernel source
25076             file fs/stat.c. Also, fix bit/byte confusion
25077             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604928
25078
25079 syscalls.2
25080     Michael Kerrisk
25081         Update various references to "i386" to "x86"
25082     Michael Kerrisk
25083         Add s390_runtime_instr(2)
25084
25085 sysctl.2
25086     Michael Kerrisk
25087         Mention CONFIG_SYSCTL_SYSCALL
25088     Michael Kerrisk
25089         Calls to sysctl() log warnings to the kernel log since 2.6.24
25090
25091 syslog.2
25092     Michael Kerrisk
25093         Substantially reorganize discussion of commands
25094             Make the layout of the discussion of the commands
25095             more readable.
25096     Michael Kerrisk
25097         Add kernel symbolic 'type' names
25098     Michael Kerrisk
25099         Clarify SYSLOG_ACTION_SIZE_UNREAD semantics
25100             SYSLOG_ACTION_SIZE_UNREAD returns the number of bytes
25101             available for reading via SYSLOG_ACTION_READ.
25102     Michael Kerrisk
25103         Clarify where SYSLOG_ACTION_READ_ALL places data it reads
25104     Michael Kerrisk
25105         Clarify semantics of SYSLOG_ACTION_CLEAR
25106             The SYSLOG_ACTION_CLEAR command (5) does not really clear
25107             the ring buffer; rather it affects the semantics of what
25108             is returned by commands 3 (SYSLOG_ACTION_READ_ALL) and
25109             4 (SYSLOG_ACTION_READ_CLEAR).
25110     Michael Kerrisk
25111         Clarify discussion of privileges for commands 3 and 10
25112     Michael Kerrisk
25113         Add mention of CONFIG_LOG_BUF_SHIFT
25114
25115 wait.2
25116     Michael Kerrisk
25117         BUGS: Document odd waitid() behavior when 'infop' is NULL
25118
25119 getifaddrs.3
25120     Michael Kerrisk  [Julien Cristau]
25121         Update description of ifa_data to Linux 2.6+ reality
25122             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778
25123
25124 memcmp.3
25125     Michael Kerrisk  [Jon Grant]
25126         Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
25127             Note that sign of result equals sign of difference between
25128             first two bytes that differ (treated as "unsigned char")."
25129
25130 mkstemp.3
25131     Michael Kerrisk  [Florian Weimer]
25132         Deemphasize discussion of mode 066 in glibc 2.0.6
25133             Glibc 2.0.6 is now so ld that the discussion of details
25134             of that version can be deemphasized placing just under
25135             NOTES.
25136
25137             See https://bugzilla.kernel.org/show_bug.cgi?id=51811
25138
25139 strcmp.3
25140     Michael Kerrisk  [Jon Grant]
25141         Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
25142             Note that sign of result equals sign of difference between
25143             first two bytes that differ (treated as "unsigned char")."
25144
25145 ttyname.3
25146     Michael Kerrisk
25147         Fix confused text in ERRORS
25148             The existing text suggested that the ERRORS applied
25149             only for ttyname_r(). However, 2 of the 3 errors
25150             can occur for ttyname().
25151
25152 undocumented.3
25153     Michael Kerrisk
25154         Remove some now documented functions
25155
25156 proc.5
25157     Michael Kerrisk  [Jim Paris]
25158         Correct description of SwapFree in /proc/meminfo
25159     Michael Kerrisk
25160         Note change of /proc/[pid]/limits file permissions in 2.6.36
25161
25162 resolv.conf.5
25163     Simon Paillard
25164         Document IPv6 format for nameserver
25165             See: http://bugs.debian.org/610036
25166
25167 capabilities.7
25168     Michael Kerrisk  [Rens van der Heijden]
25169         Correct URL for POSIX.1e draft
25170
25171 ipv6.7
25172     Gao Feng
25173         Add description of getsockopt() for IPV6_MTU
25174             In IPv4,IP_MTU is only supported by getsockopt.
25175             In IPv6, we can use IPV6_MTU to set socket's MTU,
25176             but the return value of getsockopt() is the path MTU.
25177
25178 rtnetlink.7
25179     Michael Kerrisk  [Julien Cristau]
25180         Update description of IFLA_STATS to Linux 2.6+ reality
25181             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778
25182
25183 socket.7
25184     Michael Kerrisk  [YOSHIFUJI Hideaki]
25185         Document 'sockaddr' and 'sockaddr_storage' types
25186     Andi Kleen
25187         Explain effect of SO_SNDTIMEO for connect()
25188             When SO_SNDTIMEO is set before connect(), then connect()
25189             may return EWOULDBLOCK when the timeout fires.
25190
25191
25192 ==================== Changes in man-pages-3.46 ====================
25193
25194 Released: 2013-01-27, Canberra
25195
25196
25197 Contributors
25198 ------------
25199
25200 The following people contributed patches/fixes or (noted in brackets
25201 in the changelog below) reports, notes, and ideas that have been
25202 incorporated in changes in this release:
25203
25204 Andrew Perepechko <andrew_perepechko@xyratex.com>
25205 Cédric Boutillier <cedric.boutillier@gmail.com>
25206 Cyrill Gorcunov <gorcunov@openvz.org>
25207 Daan Spitz <daan.f.spitz@gmail.com>
25208 David Prévot <taffit@debian.org>
25209 Elie De Brauwer <eliedebrauwer@gmail.com>
25210 Garrett Cooper <yanegomi@gmail.com>
25211 James Noble <James.Noble@daktronics.com>
25212 Justin Lebar <justin.lebar@gmail.com>
25213 Kees Cook <keescook@chromium.org>
25214 Lucas De Marchi <lucas.demarchi@profusion.mobi>
25215 Mark Hills <mark@pogo.org.uk>
25216 Maxin B. John <maxin.john@gmail.com>
25217 Michael Kerrisk <mtk.manpages@gmail.com>
25218 Michal Gorny <mgorny@gentoo.org>
25219 Peter Budny <bigpeteb@gmail.com>
25220 Peter Lekeynstein <lekensteyn@gmail.com>
25221 Rusty Russell <rusty@rustcorp.com.au>
25222 Samuel Thibault <sthibault@debian.org>
25223 Sam Varshavchik <mrsam@courier-mta.com>
25224 Shawn Landden <shawnlandden@gmail.com>
25225 Simon Paillard <spaillard@debian.org>
25226 Starlight <starlight.2013q1@binnacle.cx>
25227 Theodore Ts'o <tytso@mit.edu>
25228 Wolfgang Rohdewald <wolfgang@rohdewald.de>
25229 Zsbán Ambrus <ambrus@math.bme.hu>
25230
25231 Apologies if I missed anyone!
25232
25233
25234 New and rewritten pages
25235 -----------------------
25236
25237 kcmp.2
25238     Cyrill Gorcunov, Michael Kerrisk
25239         New page for kcmp(2)
25240
25241
25242 Newly documented interfaces in existing pages
25243 ---------------------------------------------
25244
25245 init_module.2
25246     Michael Kerrisk  [Kees Cook, Rusty Russell, Lucas De Marchi]
25247         Document finit_module(2)
25248     Rusty Russell  [Lucas De Marchi, Kees Cook]
25249         Document finit_module() 'flags' argument
25250             Document MODULE_INIT_IGNORE_MODVERSIONS and
25251             MODULE_INIT_IGNORE_VERMAGIC. (Some edits by mtk.)
25252
25253
25254 New and changed links
25255 ---------------------
25256
25257 finit_module.2
25258     Michael Kerrisk
25259         New link to init_module.2
25260
25261 __after_morecore_hook.3
25262 __free_hook.3
25263 __malloc_initialize_hook.3
25264 __memalign_hook.3
25265 __realloc_hook.3
25266     Michael Kerrisk
25267         New link to malloc_hook.3
25268
25269
25270 Global changes
25271 --------------
25272
25273 Various pages
25274     Michael Kerrisk
25275         Global fix: s/tty/terminal/
25276
25277
25278 Changes to individual pages
25279 ---------------------------
25280
25281 clone.2
25282     Michael Kerrisk
25283         Add kernel versions for various CLONE_* constants
25284     Michael Kerrisk
25285         CLONE_NEWIPC governs mechanisms that don't have filesystem pathnames
25286     Michael Kerrisk
25287         CLONE_NEWIPC doesn't mount the POSIX MQ file system
25288     Michael Kerrisk
25289         Add an example program (CLONE_NEWUTS)
25290     Michael Kerrisk
25291         Some reworking of CLONE_NEWIPC text
25292             No substantial content changes.
25293     Michael Kerrisk
25294         SEE ALSO: add kcmp(2)
25295         SEE ALSO: add setns(2)
25296
25297 fallocate.2
25298     Michael Kerrisk
25299         FALLOC_FL_* flags are defined in glibc only since 2.18
25300
25301 getxattr.2
25302 removexattr.2
25303 setxattr.2
25304     Michael Kerrisk  [Andrew Perepechko, ]
25305         Note that ENOATTR is a synonym for ENODATA
25306             Various people have pointed out that strace(1) shows ENODATA
25307             for the case where the named attribute does not exist, or
25308             the process has no access to this attribute. ENODATA
25309             and ENOATTR are in fact defined as synonyms. Point this out
25310             in the man page, so that people understand the strace(1) info.
25311
25312             See https://bugzilla.kernel.org/show_bug.cgi?id=51871
25313
25314 getxattr.2
25315 listxattr.2
25316 removexattr.2
25317 setxattr.2
25318     Michael Kerrisk
25319         Put errors under ERRORS section
25320             The errno values on these pages were listed in a nonstandard
25321             way under the RETURN VALUE section. Put them in ERRORS sections.
25322
25323 init_module.2
25324     Michael Kerrisk  [Rusty Russell]
25325         ERRORS: Add errors for module signatures (EBADMSG, ENOKEY)
25326
25327 link.2
25328 mkdir.2
25329 mknod.2
25330 open.2
25331 rename.2
25332 symlink.2
25333 write.2
25334 mkfifo.3
25335     Mark Hills
25336         Document EDQUOT error
25337             The return error EDQUOT is not documented in open(2), write(2),
25338             symlink(2) etc.
25339
25340             Whether inodes or disk blocks are required for each function
25341             is something I based on received wisdom and BSD documentation,
25342             rather than tracing the code to the kernel. For symlink(2)
25343             this certainly depends on the file system type.
25344
25345 listxattr.2
25346     Michael Kerrisk  [Theodore Ts'o]
25347         Fix RETURN VALUE description
25348             On success, 0 may be returned, so change wording from
25349             "positive number" to "nonnegative number".
25350
25351 outb.2
25352     Michael Kerrisk
25353         Add SYNOPSIS
25354
25355 prctl.2
25356     Kees Cook
25357         Document PR_SET_PTRACER
25358             Document the Yama LSM's prctl handler that allows processes to
25359             declare ptrace restriction exception relationships via
25360             PR_SET_PTRACER.
25361     Michael Kerrisk
25362         Make it explicit that PR_SET_PTRACER replaces previous setting
25363             The attribute is a scalar, not a list.
25364     Shawn Landden
25365         Document EINVAL error for PR_SET_PTRACER
25366     Michael Kerrisk
25367         Document PR_GET_TID_ADDRESS
25368
25369 ptrace.2
25370     Michael Kerrisk
25371         Document PTRACE_O_EXITKILL
25372     Michael Kerrisk
25373         Place PTRACE_SETOPTIONS list in alphabetical order
25374
25375 query_module.2
25376     Michael Kerrisk
25377         Must be called using syscall(2)
25378             Yes, the call is way obsolete, but add this info
25379             for completeness.
25380
25381 recvmmsg.2
25382     Elie De Brauwer
25383         Add/correct kernel version info for recvmmsg() and MSG_WAITFORNONE
25384             This patch isolates the since/version related fixes as requested.
25385             This change introduces the following delta:
25386              * The page states it was added in 2.6.32 but it is only added
25387                 2.6.33 (ref: http://kernelnewbies.org/Linux_2_6_33)
25388              * The MSG_WAITFORONE flag was in turn only added in 2.6.34
25389                (ref: http://kernelnewbies.org/Linux_2_6_34)
25390     Elie De Brauwer
25391         Add an example program
25392
25393 setns.2
25394     Michael Kerrisk
25395         Add example program
25396
25397 sigaction.2
25398     Michael Kerrisk  [Zsbán Ambrus]
25399         Note feature test macro requirements for 'siginfo_t'
25400             See https://bugzilla.kernel.org/show_bug.cgi?id=52931
25401
25402 syscalls.2
25403     Michael Kerrisk
25404         Add kern_features(2)
25405     Michael Kerrisk
25406         Add utrap_install(2)
25407             Sparc-specific, present since ancient times
25408     Michael Kerrisk
25409         Add finit_module(2)
25410
25411 sysctl.2
25412     Michael Kerrisk  [Garrett Cooper]
25413         ERRORS: EACCES as a synonym for EPRM
25414             See https://bugzilla.kernel.org/show_bug.cgi?id=46731
25415             and http://thread.gmane.org/gmane.linux.ltp/11413/focus=957635
25416                 From: Garrett Cooper <yanegomi <at> gmail.com>
25417                 Subject: Re: [LTP] [PATCH] sysctl03: sysctl returns EACCES after 2.6.33-rc1
25418                 Newsgroups: gmane.linux.kernel, gmane.linux.ltp
25419                 Date: 2010-03-04 18:35:33 GMT
25420
25421 unshare.2
25422     Michael Kerrisk
25423         Update NOTES on unimplemented flags
25424     Michael Kerrisk
25425         Fix text problems in description of CLONE_FS
25426     Michael Kerrisk
25427         SEE ALSO: add kcmp(2)
25428         SEE ALSO: add setns(2)
25429     Michael Kerrisk
25430         Reorder CLONE_NEWUTS entry in list
25431
25432 difftime.3
25433     Michael Kerrisk  [Michal Gorny]
25434         Remove crufty text about 'time_t' on "other systems"
25435             Back in 2006, some text came in via Debian patches that seems
25436             crufty. Remove it.
25437
25438             See https://bugzilla.kernel.org/show_bug.cgi?id=46731
25439
25440 getaddrinfo.3
25441 getnameinfo.3
25442     Michael Kerrisk  [Peter Budny]
25443         Fix some confused references to function names
25444             See https://bugzilla.kernel.org/show_bug.cgi?id=52741
25445
25446 getspnam.3
25447     Michael Kerrisk  [Wolfgang Rohdewald]
25448         ERRORS: Add EACCES
25449             See https://bugzilla.kernel.org/show_bug.cgi?id=52681
25450
25451 __setfpucw.3
25452     Michael Kerrisk
25453         Add proper page cross refs for alternate functions
25454
25455 core.5
25456 proc.5
25457     Kees Cook
25458         Clarify suid_dumpable versus core_pattern
25459             In Linux 3.6, additional requirements were placed on core_pattern
25460             when suid_dumpable is set to 2. Document this and include commit
25461             references.
25462     Justin Lebar
25463         statm's "shared" field refers to pages backed by files
25464             I noticed that statm's "shared" field doesn't match the sum of
25465             all the "shared" entries in smaps [1].
25466
25467             The kernel docs explain that statm's "shared" field is "number of
25468             pages that are shared (i.e. backed by a file)" [2].  smaps appears
25469             to call a page shared if it's mapped by at least two processes,
25470             which explains this discrepancy.
25471
25472             I'm not a kernel hacker, but it appears to me they do mean "i.e."
25473             and not "e.g." in the statm description: In
25474             fs/proc/task_mmu.c::task_statm, I see
25475
25476                 *shared = get_mm_counter(mm, MM_FILEPAGES);
25477
25478             Here's a patch which updates the man page to match the (hopefully
25479             correct) kernel docs.
25480
25481             [1] https://bugzilla.mozilla.org/show_bug.cgi?id=807181
25482             [2] http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob;f=Documentation/filesystems/proc.txt;h=a1793d670cd01bd374eddf54ffdfc768504291ff;hb=HEAD
25483
25484 proc.5
25485     Kees Cook
25486         Put /proc/sys/kernel/hotplug in alphabetical order
25487     Kees Cook
25488         Document /proc/sys/kernel/dmesg_restrict
25489     Kees Cook
25490         Linux 3.4 changed permissions needed to change kptr_restrict
25491     Michael Kerrisk  [Samuel Thibault, Simon Paillard]
25492         Add field numbers for /proc/PID/stat
25493             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
25494         Add numbering to /proc/stat "cpu" fields
25495             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
25496     Michael Kerrisk
25497         Reorganize text describing /proc/stat "cpu" fields
25498     Michael Kerrisk
25499         Rewording of suid_dumpable text after comments from Kees Cook
25500     Michael Kerrisk  [Samuel Thibault, Simon Paillard]
25501         Add field numbers for /proc/[pid]/statm
25502             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
25503     Michael Kerrisk
25504         Document /proc/stat "cpu" "nice_guest" field
25505             Info taken from commit ce0e7b28fb75cb003cfc8d0238613aaf1c55e797
25506     Michael Kerrisk  [Peter Lekeynstein]
25507         Document /prod/[pid]/oom_score_adj
25508             Text taken directly from Documentation/filesystems/proc.txt,
25509             with some light editing.
25510
25511             See https://bugzilla.kernel.org/show_bug.cgi?id=50421
25512
25513 shells.5
25514     Michael Kerrisk
25515         Add /etc/bash to list of example shells
25516
25517 ttytype.5
25518     Michael Kerrisk
25519         Add proper xref for termcap and terminfo pages
25520
25521 capabilities.7
25522     Michael Kerrisk
25523         Add kcmp(2) under CAP_SYS_PTRACE
25524
25525 man-pages.7
25526     Michael Kerrisk
25527         Update description of Section 7
25528
25529
25530 ==================== Changes in man-pages-3.47 ====================
25531
25532 Released: 2013-02-12, Christchurch
25533
25534
25535 Contributors
25536 ------------
25537
25538 The following people contributed patches/fixes or (noted in brackets
25539 in the changelog below) reports, notes, and ideas that have been
25540 incorporated in changes in this release:
25541
25542 David Prévot <taffit@debian.org>
25543 D. Barbier <bouzim@gmail.com>
25544 Lennart Poettering <lennart@poettering.net>
25545 Michael Kerrisk <mtk.manpages@gmail.com>
25546 Mike Frysinger <vapier@gentoo.org>
25547 Peter Schiffer <pschiffe@redhat.com>
25548 Radek Pazdera <rpazdera@redhat.com>
25549 Reuben Thomas <rrt@sc3d.org>
25550 Shawn Landden <shawnlandden@gmail.com>
25551 Simon Paillard <spaillard@debian.org>
25552 Vince Weaver <vweaver1@eecs.utk.edu>
25553
25554 Apologies if I missed anyone!
25555
25556
25557 New and rewritten pages
25558 -----------------------
25559
25560 perf_event_open.2
25561     Vincent Weaver
25562         New page documenting perf_event_open(2)
25563
25564 pthread_setname_np.3
25565     Chandan Apsangi, Michael Kerrisk
25566         New page for pthread_setname_np(3) and pthread_getname_np(3)
25567
25568 sln.8
25569     Michael Kerrisk  [Peter Schiffer]
25570         New page documenting the 'sln' command provided by glibc
25571             Inspired by a Red Hat downstream page, but with rather
25572             more detail.
25573
25574
25575 Newly documented interfaces in existing pages
25576 ---------------------------------------------
25577
25578 prctl.2
25579     Michael Kerrisk  [Shawn Landden, Lennart Poettering]
25580         Document PR_SET_CHILD_SUBREAPER and PR_GET_CHILD_SUBREAPER
25581
25582 ip.7
25583     Radek Pazdera
25584         Add source-specific multicast sockopts
25585             This patch adds documentation of several source-specific multicast
25586             socket options that were added to kernel with implementation
25587             of IGMPv3 in 2.5.68.
25588
25589             The following socket options were added:
25590               IP_ADD_SOURCE_MEMBERSHIP
25591               IP_DROP_SOURCE_MEMBERSHIP
25592               IP_BLOCK_SOURCE
25593               IP_UNBLOCK_SOURCE
25594               IP_MSFILTER
25595
25596
25597 Pages moved across sections
25598 ---------------------------
25599
25600 getcontext.3
25601     Michael Kerrisk
25602         This page really belongs in Section 3 (moved from Section 2)
25603
25604 getdtablesize.3
25605     Michael Kerrisk
25606         Move from Section 2
25607
25608
25609 New and changed links
25610 ---------------------
25611
25612 getcontext.2
25613     Michael Kerrisk
25614         Make link to page moved into Section 3
25615
25616 getdtablesize.2
25617     Michael Kerrisk
25618         Link to renamed getdtablesize.3
25619
25620 setcontext.2
25621     Michael Kerrisk
25622         Modify link to point to Section 3
25623
25624 pthread_getname_np.3
25625     Michael Kerrisk
25626         New link to new pthread_setname_np.3
25627
25628 setcontext.3
25629     Michael Kerrisk
25630         Link to getcontext page renamed into Section 3
25631
25632
25633 Changes to individual pages
25634 ---------------------------
25635
25636 fallocate.2
25637     Michael Kerrisk
25638         SEE ALSO: add fallocate(1)
25639
25640 flock.2
25641     Michael Kerrisk
25642         SEE ALSO: add flock(1)
25643
25644 fork.2
25645     Michael Kerrisk
25646         SEE ALSO: add exit(2)
25647
25648 getpriority.2
25649     Michael Kerrisk
25650         BUGS: note that nice value is per-thread on Linux
25651
25652 getrlimit.2
25653     Michael Kerrisk
25654         SEE ALSO: add prlimit(1)
25655
25656 gettid.2
25657     Michael Kerrisk
25658         SEE ALSO: add various system calls that use thread IDs
25659
25660 ioprio_set.2
25661     Michael Kerrisk
25662         SEE ALSO: add ionice(1)
25663
25664 sched_setaffinity.2
25665     Michael Kerrisk
25666         SEE ALSO: add taskset(1)
25667
25668 sched_setparam.2
25669     Michael Kerrisk
25670         Scheduling policy and parameters are per-thread on Linux
25671             Direct the reader to the discussion in sched_setscheduler(2).
25672
25673 sched_setscheduler.2
25674     Michael Kerrisk
25675         Scheduling policy and parameters are per-thread on Linux
25676     Michael Kerrisk
25677         SEE ALSO: add chrt(1)
25678
25679 setsid.2
25680     Michael Kerrisk
25681         SEE ALSO: add setsid(1)
25682
25683 shmop.2
25684     Michael Kerrisk  [Peter Schiffer]
25685         ERRORS: Add EIDRM
25686             Taken from Red Hat downstream patch
25687
25688 sigaction.2
25689 makecontext.3
25690     Michael Kerrisk
25691         Change getcontext/setcontext page ref to Section 3
25692
25693 signal.2
25694     Michael Kerrisk  [Reuben Thomas]
25695         Clarify System V vs BSD semantics for signal()
25696
25697 syscalls.2
25698     Michael Kerrisk
25699         The list on this page is not just syscalls common to all platforms
25700     Michael Kerrisk
25701         Add perfctr(2)
25702         Add ppc_rtas(2)
25703     Michael Kerrisk
25704         Add kernel version number of utrap_install(2)
25705
25706 unimplemented.2
25707     Michael Kerrisk  [Peter Schiffer]
25708         Remove mention of kernel version number in DESCRIPTION
25709
25710 inet.3
25711     Michael Kerrisk  [Peter Schiffer]
25712         Fix error in EXAMPLE using inet_aton()
25713             See https://bugzilla.redhat.com/show_bug.cgi?id=837090
25714             Patch taken from Red Hat downstream.
25715
25716 posix_fallocate.3
25717     Michael Kerrisk
25718         SEE ALSO: add fallocate(1)
25719
25720 regex.3
25721     Reuben Thomas
25722         Clarify details of matching
25723             The first is that it's far from clear that the end points of the
25724             complete string match are stored in the zero'th element of the
25725             regmatch_t array; secondly, the phrase "next largest substring
25726             match" is positively misleading, implying some sort of size
25727             ordering, whereas in fact they are ordered according to their
25728             appearance in the regex pattern.
25729
25730 scanf.3
25731     Michael Kerrisk
25732         Clarify meaning of "string conversions" for 'm' modifier
25733     Mike Frysinger
25734         Update %a vs %m documentation
25735             POSIX.1-2008 adopted the 'm' flag for dynamic allocation. Update
25736             page to cover it and relegate the glibc-specific 'a' flag to
25737             NOTES.
25738
25739 strtol.3
25740     Michael Kerrisk  [Peter Schiffer]
25741         Replace some bogus text about "thousands separator"
25742             See https://bugzilla.redhat.com/show_bug.cgi?id=652870
25743
25744 sysconf.3
25745     Michael Kerrisk  [Peter Schiffer]
25746         Use "_SC_PAGESIZE" consistently on page
25747             s/_SC_PAGE_SIZE/_SC_PAGESIZE/ in one instance.
25748             From Red Hat downstream patch.
25749
25750 nscd.conf.5
25751     Peter Schiffer
25752         Add max-db-size and auto-propagate descriptions, default values, + misc
25753              * added missing valid services (services and netgroup)
25754              * added many default values for options
25755              * reordered options according to the nscd.conf file
25756                (logical order)
25757              * added 2 missing options: max-db-size and auto-propagate
25758
25759 nsswitch.conf.5
25760     Peter Schiffer
25761         Mention initgroups db
25762
25763 proc.5
25764     Michael Kerrisk
25765         Document /proc/profile
25766     Michael Kerrisk  [Peter Schiffer]
25767         Update /proc/sys/fs/file-nr to include Linux 2.6 details
25768     Michael Kerrisk
25769         Clarify relationship between file-max and file-nr
25770             The third value in /proc/sys/fs/file-nr is the same as
25771             the value in /proc/sys/fs/file-max.
25772     Michael Kerrisk
25773         Note message written to kernel log when file-max limit is hit
25774             Info from Documentation/sysctl/fs.txt.
25775     Michael Kerrisk
25776         Mention lscpu(1) under discussion of /proc/cpuinfo
25777
25778 resolv.conf.5
25779     Michael Kerrisk  [Peter Schiffer]
25780         Document "single-request-reopen" option
25781             Taken from Red Hat downstream patch
25782
25783             See https://bugzilla.redhat.com/show_bug.cgi?id=717770
25784             See http://thread.gmane.org/gmane.linux.man/3161
25785
25786 utmp.5
25787     Michael Kerrisk
25788         SEE ALSO: add utmpdump(1)
25789
25790 cpuset.7
25791     Simon Paillard
25792         Add missing 'cpuset.' prefix for some flags
25793             See kernel commit e21a05cb408bb9f244f11a0813d4b355dad0822e
25794
25795 svipc.7
25796     Michael Kerrisk
25797         SEE ALSO: add ipcmk(1), ipcrm(1), ipcs(1)
25798
25799 termio.7
25800     Michael Kerrisk
25801         SEE ALSO: add reset(1), setterm(1), stty(1), tty(4)
25802
25803 ld.so.8
25804     Michael Kerrisk  [Peter Schiffer]
25805         LD_VERBOSE does not work with ld.so --list and --verify
25806             From Red Hat downstream patch
25807
25808             See https://bugzilla.redhat.com/show_bug.cgi?id=532629
25809     Michael Kerrisk
25810         SEE ALSO: add sln(8)
25811
25812 zdump.8
25813     Michael Kerrisk  [Peter Schiffer]
25814         Bring up to date with zdump --help
25815             Patch taken from Red Hat downstream.
25816
25817
25818 ==================== Changes in man-pages-3.48 ====================
25819
25820 Released: 2013-03-05, Munich
25821
25822
25823 Contributors
25824 ------------
25825
25826 The following people contributed patches/fixes or (noted in brackets
25827 in the changelog below) reports, notes, and ideas that have been
25828 incorporated in changes in this release:
25829
25830 Andrey Vagin <avagin@openvz.org>
25831 Aristeu Rozanski <aris@ruivo.org>
25832 Colin Walters <walters@verbum.org>
25833 Cyril Hrubis <chrubis@suse.cz>
25834 Cyrill Gorcunov <gorcunov@openvz.org>
25835 Daniel P. Berrange <berrange@redhat.com>
25836 David Prévot <taffit@debian.org>
25837 D. Barbier <bouzim@gmail.com>
25838 Denys Vlasenko <vda.linux@googlemail.com>
25839 Flavio Leitner <fbl@redhat.com>
25840 Graham Gower <graham.gower@gmail.com>
25841 Ivana Varekova <varekova@redhat.com>
25842 Kai Kunschke <kai@kunfoo.org>
25843 Marcela Maslanova <mmaslano@redhat.com>
25844 Marc Lehmann <debian-reportbug@plan9.de>
25845 Marshel Abraham <Marshel.Abraham@in.bosch.com>
25846 Michael Kerrisk <mtk.manpages@gmail.com>
25847 Nathan Stratton Treadway <kernelbugs@nathanst.com>
25848 Pavel Emelyanov <xemul@parallels.com>
25849 Peter Schiffer <pschiffe@redhat.com>
25850 Simon Heimberg <simohe@besonet.ch>
25851 Simon Paillard <spaillard@debian.org>
25852 Török Edwin <edwintorok@gmail.com>
25853 Ulrich Drepper <drepper@redhat.com>
25854 Zack Weinberg <zackw@panix.com>
25855
25856 Apologies if I missed anyone!
25857
25858
25859 New and rewritten pages
25860 -----------------------
25861
25862 getunwind.2
25863     Marcela Maslanova
25864         New page documenting getunwind(2)
25865             Taken from Red Hat downstream man pages set
25866     Michael Kerrisk
25867         Much rewriting
25868             Some text taken from arch/ia64/kernel/unwind.c.
25869
25870 perfmonctl.2
25871     Ivana Varekova
25872         New page documenting IA-64-specific perfmonctl(2)
25873             Taken from Red Hat downstream man pages
25874     Michael Kerrisk
25875         Rework discussion of PFM_CREATE_CONTEXT
25876         Add VERSIONS and CONFORMING TO
25877         Note that there is no glibc wrapper
25878         Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
25879             These don't exist, and it appears they never have.
25880         Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
25881             The types that were being used don't exist!
25882         Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL
25883
25884 gai.conf.5
25885     Ulrich Drepper
25886         New page documenting gai.conf
25887             Taken from Red Hat downstream pages
25888
25889 nss.5
25890     Ulrich Drepper
25891         New page describing nss.conf
25892
25893
25894 Newly documented interfaces in existing pages
25895 ---------------------------------------------
25896
25897 clock_getres.2
25898     Cyril Hrubis
25899         Document CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE
25900     Cyril Hrubis
25901         Document CLOCK_BOOTTIME
25902     Michael Kerrisk
25903         Some improvements to CLOCK_BOOTTIME description
25904
25905 ptrace.2
25906     Denys Vlasenko
25907         Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends
25908             Document PTRACE_GETREGSET, PTRACE_SETREGSET,
25909             PTRACE_SEIZE, PTRACE_INTERRUPT, and PTRACE_LISTEN.
25910
25911
25912 New and changed links
25913 ---------------------
25914
25915 fattach.2
25916 fdetach.2
25917 getmsg.2
25918 isastream.2
25919 putmsg.2
25920     Michael Kerrisk  [Peter Schiffer]
25921         New link to unimplemented.2
25922             Taken from Red Hat downstream.
25923
25924             See https://bugzilla.redhat.com/show_bug.cgi?id=436407
25925
25926
25927 Global changes
25928 --------------
25929
25930 Many pages
25931     Michael Kerrisk
25932         Global fix: remove unneeded double quotes in .SH headings
25933
25934 Many pages
25935     Michael Kerrisk
25936         Global fix: remove unneeded double quotes in .SS headings
25937
25938 Many pages
25939     Michael Kerrisk
25940         Global fix: use consistent capitalization in .SS headings
25941             Capitalization in .SS sections across pages (and sometimes even
25942             within a single page) is wildly inconsistent. Make it consistent.
25943             Capitalize first word in heading, but otherwise use lower case,
25944             except where English usage (e.g., proper nouns) or programming
25945             language requirements (e.g., identifier names) dictate otherwise.
25946
25947 Many pages
25948     Michael Kerrisk  [Denys Vlasenko]
25949         Remove double blank lines in output
25950
25951 Various pages
25952     Michael Kerrisk
25953         Fix order of SH sections
25954
25955
25956 Changes to individual pages
25957 ---------------------------
25958
25959 accept.2
25960     Michael Kerrisk
25961         NAME: Add "accept4"
25962
25963 access.2
25964     Colin Walters
25965         Note that access() may also fail for FUSE
25966             Since in some cases (e.g. libguestfs's guestmount) it also has the
25967             semantics where files can appear owned by root, but are actually
25968             mutable by the user, despite what one might infer from the Unix
25969             permissions.
25970
25971 getpeername.2
25972     Michael Kerrisk  [Kai Kunschke]
25973         Clarify semantics of getpeername() for datagram sockets
25974             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674034
25975
25976 getuid.2
25977     Michael Kerrisk
25978         Remove duplicate section heading
25979
25980 mmap.2
25981     Cyril Hrubis
25982         Add note about partial page in BUGS section
25983             This adds a note about Linux behavior with partial page at the end
25984             of the object. The problem here is that a page that contains only
25985             part of a file (because the file size is not multiple of PAGE_SIZE)
25986             stays in page cache even after the mapping is unmapped and the file
25987             is closed. So if some process dirties such page, other mappings
25988             will see the changes rather than zeroes.
25989     Michael Kerrisk  [Török Edwin]
25990         Some 'flags' values require a feature test macro to be defined
25991             Add text to NOTES noting that some MAP_* constants are
25992             defined only if a suitable feature test macro is defined.
25993             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=542601
25994     Cyril Hrubis
25995         Document EOVERFLOW error
25996
25997 open.2
25998     Michael Kerrisk
25999         Clarify list of file creation flags
26000             POSIX.1-2008 TC1 clarified this, so that O_CLOEXEC,
26001             O_DIRECTORY, and O_NOFOLLOW are also in this list.
26002
26003 prctl.2
26004     Cyrill Gorcunov
26005         Add some details for PR_GET_TID_ADDRESS
26006
26007 read.2
26008     Michael Kerrisk  [Zack Weinberg]
26009         Clarify interaction of count==0 and error checking
26010             POSIX deliberately leaves this case open, so the man
26011             page should be less specific about what happens.
26012
26013             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533232
26014     Michael Kerrisk  [Marc Lehmann]
26015         Remove crufty text about O_NONBLOCK on files
26016             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700529
26017     Michael Kerrisk
26018         Clarify details for seekable files
26019
26020 unimplemented.2
26021     Michael Kerrisk  [Peter Schiffer]
26022         Add various STREAMS interfaces to NAME
26023             Taken from Red Hat downstream.
26024
26025             See https://bugzilla.redhat.com/show_bug.cgi?id=436407
26026
26027 cexp2.3
26028     Michael Kerrisk
26029         Still does not exist in glibc 2.17
26030
26031 exit.3
26032     Michael Kerrisk
26033         Note that a call to execve() clears exit handler registrations
26034
26035 getaddrinfo.3
26036     Michael Kerrisk
26037         SEE ALSO: Add gai.conf(5)
26038
26039 malloc_trim.3
26040     Michael Kerrisk
26041         Remove duplicate section title
26042
26043 printf.3
26044     Marshel Abraham  [Graham Gower, Graham Gower]
26045         Fix error handling in example code
26046             See https://bugzilla.kernel.org/show_bug.cgi?id=23282
26047
26048 pthread_yield.3
26049     Michael Kerrisk  [Aristeu Rozanski]
26050         Add _GNU_SOURCE feature test macro to SYNOPSIS
26051
26052 resolver.3
26053 resolv.conf.5
26054     Michael Kerrisk  [Nathan Stratton Treadway, Simon Heimberg]
26055         RES_DEBUG is only available if glibc is compiled with debug support
26056             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=692136
26057             and https://bugzilla.kernel.org/show_bug.cgi?id=43061
26058
26059 strtol.3
26060     Michael Kerrisk  [Peter Schiffer]
26061         Remove crufty text from previous fix
26062
26063 core.5
26064     Michael Kerrisk
26065         Document CONFIG_COREDUMP
26066
26067 capabilities.7
26068     Andrey Vagin
26069         Nonexistent bits are no longer shown as set in /proc/PID/status Cap*
26070
26071 inotify.7
26072     Michael Kerrisk
26073         A monitoring process can't easily distinguish events triggered by itself
26074
26075 ip.7
26076     Flavio Leitner  [Peter Schiffer]
26077         Improve explanation about calling listen() or connect()
26078
26079 man-pages.7
26080     Michael Kerrisk
26081         Describe rules for capitalization in .SS headings
26082
26083 rtnetlink.7
26084     Pavel Emelyanov
26085         Add info about ability to create links with given index
26086             Since kernel v3.7 the RTM_NEWLINK message now accepts nonzero
26087             values in ifi_index field. Mention this fact in the respective
26088             rtnetlink.7 section.
26089
26090 socket.7
26091     Pavel Emelyanov
26092         SO_BINDTODEVICE is now readable
26093             SO_BINDTODEVICE is readable since since kernel 3.8.
26094
26095
26096 ==================== Changes in man-pages-3.49 ====================
26097
26098 Released: 2013-03-10, Munich
26099
26100
26101 Contributors
26102 ------------
26103
26104 The following people contributed patches/fixes or (noted in brackets
26105 in the changelog below) reports, notes, and ideas that have been
26106 incorporated in changes in this release:
26107
26108 Michael Kerrisk <mtk.manpages@gmail.com>
26109
26110
26111 Global changes
26112 --------------
26113
26114 The goal of the changes below to consistently format copyright
26115 and license information in the comments in the page source
26116 at the top of each page. This allows for easy scripting to
26117 extract that information. Following these changes the comments
26118 the top of the page source should now consistently have the form:
26119
26120     .\" <copyright info, possibly spread over several lines>
26121     .\"
26122     .\" %%%LICENSE_START(<license-type>)
26123     .\" <license text>
26124     .\" %%%LICENSE_END
26125     .\" <other comments>
26126
26127 Note that the 'license-type' is merely descriptive.  Its purpose is
26128 to simplify scripting for the purpose of gathering statistics on
26129 types of licenses used in man-pages.  It is NOT a statement about
26130 the actual licensing of the page; that license is contain INSIDE the
26131 LICENSE_START...LICENSE_END clause.
26132
26133 All pages
26134     Michael Kerrisk
26135         Add a LICENSE_START()...LICENSE_END clause in source at
26136         top of each page that encapsulates the license text.
26137     Michael Kerrisk
26138         Put copyright info at top of page, followed by blank line and LICENSE
26139
26140 Various pages
26141     Michael Kerrisk
26142          Update info in source comments on where to get a copy of the GPL
26143
26144 Various pages
26145     Michael Kerrisk
26146         Remove "Hey Emacs" comment in page source
26147             Only certain pages have this; there is no consistency, so
26148             remove it from all pages
26149     Michael Kerrisk
26150         Remove "-*- nroff -*-" comment at top of source
26151
26152
26153 ==================== Changes in man-pages-3.50 ====================
26154
26155 Released: 2013-03-15, Munich
26156
26157
26158 Contributors
26159 ------------
26160
26161 The following people contributed patches/fixes or (noted in brackets
26162 in the changelog below) reports, notes, and ideas that have been
26163 incorporated in changes in this release:
26164
26165 Andrey Vagin <avagin@openvz.org>
26166 Bernhard Kuemel <bernhard@bksys.at>
26167 Elie De Brauwer <eliedebrauwer@gmail.com>
26168 Erik Saule <erik.saule@bmi.osu.edu>
26169 Florian Weimer <fweimer@bfk.de>
26170 Friedrich Delgado Friedrichs <friedel@nomaden.org>
26171 Jonathan Nieder <jrnieder@gmail.com>
26172 Jose Luis Domingo Lopez <debian@24x7linux.com>
26173 Mark R Bannister <mark@proseconsulting.co.uk>
26174 Michael Kerrisk <mtk.manpages@gmail.com>
26175 Sam Varshavchik <mrsam@courier-mta.com>
26176 Simon Paillard <spaillard@debian.org>
26177
26178 Apologies if I missed anyone!
26179
26180
26181 New and rewritten pages
26182 -----------------------
26183
26184 canonicalize_file_name.3
26185     Michael Kerrisk
26186         Rewrite page, adding much more detail
26187
26188
26189 Global changes
26190 --------------
26191
26192 Various pages
26193     Michael Kerrisk
26194         Global fix: s/END_LICENSE/LICENSE_END/
26195
26196 Various pages
26197     Michael Kerrisk
26198         Global fix: s/bitmask/bit mask/
26199
26200
26201 Changes to individual pages
26202 ---------------------------
26203
26204 getent.1
26205     Mark R Bannister
26206         netgroup description incorrectly refers to initgroups
26207
26208 capget.2
26209     Michael Kerrisk
26210         Update URL for libcap
26211
26212 fork.2
26213     Michael Kerrisk
26214         Port access permission bits (ioperm()) are turned off in the child
26215
26216 futex.2
26217     Michael Kerrisk
26218         'timeout' is a minimum duration that the call will wait, not a maximum
26219
26220 ioperm.2
26221     Michael Kerrisk
26222         Note that iopl() level of 3 is needed to access ports
26223     Michael Kerrisk
26224         'num' is *bits* not bytes!
26225     Michael Kerrisk
26226         Linux 2.6.8 lifted the port limit to 65,536
26227             See http://article.gmane.org/gmane.linux.kernel/202624/
26228             From: Stas Sergeev <stsp <at> aknet.ru>
26229             Subject: [patch][rfc] Larger IO bitmap
26230             Date: 2004-05-07 19:55:03 GMT
26231     Michael Kerrisk
26232         ioperm() operates on the calling *thread* (not process)
26233     Michael Kerrisk
26234         Clarify meaning of 'turn_on' argument
26235             Plus form formatting fixes.
26236     Michael Kerrisk
26237         Clarify that default state of permission bits in child is off
26238     Michael Kerrisk
26239         NOTES: add mention of /proc/ioports
26240     Michael Kerrisk
26241         SEE ALSO: add outb(2)
26242
26243 iopl.2
26244     Michael Kerrisk
26245         CAP_SYS_RAWIO is required to *raise* the I/O privilege level
26246     Michael Kerrisk
26247         Clarify that the two least significant bits of 'level' are what matter
26248     Michael Kerrisk
26249         SEE ALSO: add outb(2)
26250
26251 syscalls.2
26252     Michael Kerrisk
26253         Add version information for all (other) syscalls
26254     Michael Kerrisk
26255         Add perfmonctl(2)
26256
26257 futimes.3
26258     Michael Kerrisk  [Jonathan Nieder]
26259         ERRORS: Add ENOSYS for lutimes()
26260             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=620746
26261
26262 getpass.3
26263     Michael Kerrisk  [Erik Saule]
26264         Suggest use of the ECHO flag as an alternative
26265             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=644261
26266
26267 realpath.3
26268     Michael Kerrisk
26269         Document GNU extensions for EACCES and ENOENT errors
26270
26271 stdarg.3
26272     Michael Kerrisk  [Friedrich Delgado Friedrichs]
26273         Describe va_copy()
26274             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=575077
26275
26276 termios.3
26277     Michael Kerrisk  [Bernhard Kuemel]
26278         Mention that noncanonical mode does not do input processing
26279             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=643854
26280
26281 random.4
26282     Elie De Brauwer
26283         Document write and document the ioctl interface of /dev/random
26284             The update consists out of two parts:
26285              - a minor thing which just documents what happens if a write to
26286                /dev/(u)random is performed, which is used in the example
26287                script but not explicitly mentioned.
26288              - the other (biggest) part is the documentation of the ioctl()
26289                interface which /dev/(u)random exposes. This ioctl() lives in
26290                drivers/char/random.c and the primitives can be found in
26291                include/linux/random.h
26292
26293             One comment remains, there used to be an RNDGETPOOL ioctl() which
26294             disappeared in v2.6.9. I found two patches on the net:
26295             - http://www.kernel.org/pub/linux/kernel/people/akpm/patches/2.6/2.6.8.1/2.6.8.1-mm4/broken-out/dev-random-remove-rndgetpool-ioctl.patch
26296             - https://lkml.org/lkml/2004/3/25/168
26297
26298             But as far as I can tell the first one got applied but the 2nd
26299             one seems more correct. The result is that even today one can
26300             still find traces of the RNDGETPOOL ioctl() in the header files.
26301             Is this there for historical reasons or because it might break
26302             userspace, even though using it will just give an EINVAL.
26303
26304 bootparam.7
26305     Jose Luis Domingo Lopez
26306         Document 'rootfstype' option
26307             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182014
26308
26309 capabilities.7
26310     Michael Kerrisk
26311         Add various pieces under CAP_SYS_RAWIO
26312             Info obtained by grepping the kernel source.
26313     Michael Kerrisk
26314         Add CAP_SYS_RESOURCE /proc/PID/oom_score_adj case
26315
26316 netlink.7
26317     Andrey Vagin
26318         Add a note about broadcast messages to multiple groups
26319
26320 socket.7
26321     Michael Kerrisk  [Florian Weimer]
26322         Define _GNU_SOURCE to obtain the definition of 'struct ucred'
26323             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572210
26324
26325
26326 ==================== Changes in man-pages-3.51 ====================
26327
26328 Released: 2013-04-17, Munich
26329
26330
26331 Contributors
26332 ------------
26333
26334 The following people contributed patches/fixes or (noted in brackets
26335 in the changelog below) reports, notes, and ideas that have been
26336 incorporated in changes in this release:
26337
26338 Andreas Jaeger <aj@suse.de>
26339 Andrew Clayton <andrew@digital-domain.net>
26340 Brian M. Carlson <sandals@crustytoothpaste.net>
26341 Changhee Han <ch0.han@lge.com>
26342 Cyril Hrubis <chrubis@suse.cz>
26343 Damien Grassart <damien@grassart.com>
26344 David Prévot <taffit@debian.org>
26345 Denis Barbier <bouzim@gmail.com>
26346 Jeff Moyer <jmoyer@redhat.com>
26347 Krzysztof Konopko <krzysztof.konopko@gmail.com>
26348 Kyle McMartin <kyle@mcmartin.ca>
26349 Mark H Weaver <mhw@netris.org>
26350 Michael Kerrisk <mtk.manpages@gmail.com>
26351 Mike Frysinger <vapier@gentoo.org>
26352 Nicolas Hillegeer <nicolas@hillegeer.com>
26353 Pavel Emelyanov <xemul@parallels.com>
26354 Peter Schiffer <pschiffe@redhat.com>
26355 Radek Pazdera <rpazdera@redhat.com>
26356 Ralph Loader <suckfish@ihug.co.nz>
26357 Simon Paillard <spaillard@debian.org>
26358 The Wanderer <wanderer@fastmail.fm>
26359
26360 Apologies if I missed anyone!
26361
26362
26363 Newly documented interfaces in existing pages
26364 ---------------------------------------------
26365
26366 sched_rr_get_interval.2
26367     Michael Kerrisk
26368         Document /proc/sys/kernel/sched_rr_timeslice_ms
26369
26370 proc.5
26371     Pavel Emelyanov
26372         Document /proc/[pid]/map_files directory
26373             This directory was added in Linux v3.3 and provides info about
26374             files being mmap-ed in a way very similar to how /proc/[pid]/fd
26375             works.
26376
26377             v2: Added examples of how links look like and noted dependency
26378             on kernel config option CONFIG_CHECKPOINT_RESTORE.
26379     Michael Kerrisk
26380         Document /proc/sys/kernel/shm_rmid_forced
26381
26382 capabilities.7
26383     Michael Kerrisk
26384         Document /proc/sys/kernel/cap_last_cap
26385
26386
26387 Global changes
26388 --------------
26389
26390 Various pages
26391     Michael Kerrisk
26392         Global fix: fix placement of word "only"
26393
26394 Various pages
26395     Simon Paillard
26396         License headers: consistent format
26397
26398 Various pages
26399     Michael Kerrisk
26400         Global fix: s/since kernel/since Linux/
26401
26402 Various System V IPC pages in Section 2
26403     Michael Kerrisk
26404         Add "System V" to .TH line and text
26405             Make it clear that these pages relate to System V IPC,
26406             not POSIX IPC.
26407
26408
26409 Changes to individual pages
26410 ---------------------------
26411
26412 access.2
26413     Michael Kerrisk  [The Wanderer]
26414         Clarify RETURN VALUE for F_OK
26415             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=705293
26416
26417 alarm.2
26418     Michael Kerrisk
26419         Correct the description of behavior when 'seconds' is 0
26420
26421 clone.2
26422     Michael Kerrisk  [Peter Schiffer]
26423         Add prototype for syscall to SYNOPSIS
26424             And further clarify the distinction between the system call
26425             and the wrapper function in the introductory text.
26426     Michael Kerrisk
26427         Update feature test macro requirements
26428             The requirements quietly changed changed in glibc 2.14
26429
26430             See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
26431     Michael Kerrisk  [Mike Frysinger]
26432         Clarify differences between clone2() syscall and wrapper function
26433     Michael Kerrisk  [Mike Frysinger]
26434         Note those architectures where the sys_clone argument order differs
26435     Michael Kerrisk  [Mike Frysinger]
26436         Add short subsection noting that blackfin, m68k, and sparc are different
26437     Michael Kerrisk
26438         Move clone2() text to subsection in description
26439             The description of ia64 clone2() should follow the discussion
26440             of the raw system call interface.
26441     Michael Kerrisk
26442         Change subhead for ia64 discussion
26443
26444 getcpu.2
26445     Michael Kerrisk
26446         Recommend that 'tcache' should be specified as NULL nowadays
26447
26448 io_cancel.2
26449     Jeff Moyer, Michael Kerrisk  [Cyril Hrubis]
26450         Improve description
26451
26452 io_destroy.2
26453     Jeff Moyer
26454         Improve description
26455             The description was rather vague, citing a "list of I/O contexts"
26456             and stating that it "can" cancel outstanding requests.  This
26457             update makes things more concrete so that the reader knows exactly
26458             what's going on.
26459
26460 io_getevents.2
26461     Jeff Moyer
26462         The 'timeout' argument is not updated
26463             I looked back through the kernel code, and the timeout was
26464             never updated in any case.  I've submitted a patch upstream
26465             to change the comment above io_getevents.
26466
26467 io_setup.2
26468     Jeff Moyer
26469         Clarify nr_events
26470             nr_events is technically the number of completion events that can
26471             be stored in the completion ring.  The wording of the man page:
26472             "capable of receiving at least nr_events" seems dubious to me,
26473             only because I worry that folks might interpret that to mean
26474             'nr_events' total, instead of 'nr_events' concurrently.
26475
26476             Further, I've added information on where to find the per-user
26477             limit on 'nr_events', /proc/sys/fs/aio-max-nr.  Let me know if
26478             you think that is not relevant.
26479
26480 listxattr.2
26481     Michael Kerrisk
26482         Explain use of 'size' argument
26483
26484 lseek.2
26485     Michael Kerrisk  [Andreas Jaeger]
26486         _GNU_SOURCE must be defined to get SEEK_DATA and SEEK_HOLE definitions
26487             See http://sourceware.org/bugzilla/show_bug.cgi?id=15312
26488
26489 mmap.2
26490     Michael Kerrisk
26491         Add pointers to relevant /proc files described in proc(5)
26492
26493 posix_fadvise.2
26494 pread.2
26495 readahead.2
26496 sync_file_range.2
26497 truncate.2
26498     Michael Kerrisk
26499         Refer to syscall(2) for ABI semantics on certain 32-bit architectures
26500             Also: in sync_file_range.2 and posix_fadvise.2 remove description
26501             of conventional calling signature as flawed, and in
26502             posix_fadvise.2, de-emphasize focus on ARM, and rather phrase
26503             as a more general discussion of certain architectures.
26504
26505 readdir.2
26506     Michael Kerrisk
26507         readdir(2) doesn't exist on x86-64
26508
26509 semop.2
26510     Michael Kerrisk
26511         Clarify the discussion of 'semadj'
26512
26513 shmctl.2
26514     Michael Kerrisk
26515         Refer to proc(5) for description of /proc/sys/kernel/shm_rmid_forced
26516
26517 syscall.2
26518     Changhee Han
26519         Add notes that caution users when passing arguments to syscall()
26520             For example, passing 'long long' on ARM-32 requires special
26521             treatment.
26522     Mike Frysinger [Michael Kerrisk]
26523         Document the exact calling convention for architecture system calls
26524     Mike Frysinger  [Kyle McMartin]
26525         Add PA-RISC details under calling conventions
26526     Michael Kerrisk  [Mike Frysinger]
26527         Refine discussion of ARM and other ABIs
26528
26529 syscalls.2
26530     Michael Kerrisk
26531         Update kernel version number at start of list
26532
26533 umask.2
26534     Michael Kerrisk
26535         SEE ALSO: add acl(5)
26536
26537 unshare.2
26538     Michael Kerrisk
26539         Update feature test macro requirements
26540             The requirements quietly changed changed in glibc 2.14
26541
26542             See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
26543
26544 fopencookie.3
26545     Michael Kerrisk  [Ralph Loader]
26546         Correct definition of cookie_io_functions_t
26547
26548 pthread_setname_np.3
26549     Andrew Clayton
26550         The thread argument is passed in by value
26551
26552 readir.3
26553 seekdir.3
26554 telldir.3
26555     Michael Kerrisk
26556         Eliminate the implication that these functions deal with "offsets"
26557             The directory position dealt with by the readdir() and
26558             friends is not a simple file offset in modern file systems.
26559             Typically, it is some kind of cookie value. Add text and
26560             make other changes to these pages to eliminate the
26561             implication that this is an offset, and warn the reader
26562             that directory positions should be treated strictly as
26563             opaque values.
26564
26565             In the process, rename the 'offset' argument of seekdir(3)
26566             to 'loc', and add some text to readdir(3) to note that
26567             the 'd_off' field is the same value returned by telldir(3)
26568             at the current directory position.
26569
26570             See also https://lwn.net/Articles/544298/
26571
26572 scalb.3
26573     Mark H Weaver
26574         Fix prototypes for scalbf() and scalbl()
26575
26576 sched_getcpu.3
26577     Michael Kerrisk
26578         Update feature test macro requirements
26579             The requirements quietly changed changed in glibc 2.14
26580
26581             See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
26582
26583 ualarm.3
26584     Michael Kerrisk  [Nicolas Hillegeer]
26585         Add note on the behavior when 'usecs' is zero
26586             POSIX.1-2001 does not specify the behavior in this case
26587             and no other system that I checked documented the behavior.
26588             Probably, most or all systems do what Linux does in this
26589             case: cancel any pending alarm, just as alarm(0) does.
26590             Add that info in NOTES.
26591
26592 elf.5
26593     Mike Frysinger
26594         Add byte positions for all EI_xxx fields
26595             When describing e_ident, most of the EI_xxx defines mention the
26596             exact byte number.  This is useful when manually hacking an ELF
26597             with a hex editor.  However, the last few fields don't do this,
26598             which means you have to count things up yourself.
26599             Add a single word to each so you don't have to do that.
26600
26601 proc.5
26602     Michael Kerrisk
26603         Refer to sched_rr_get_interval(2) for info on sched_rr_timeslice_ms
26604             Since Linux 3.9, /proc/sys/kernel/sched_rr_timeslice_ms can
26605             be used to change the SCHED_RR quantum.
26606     Michael Kerrisk
26607         SEE ALSO: Add sysctl(8)
26608     Krzysztof Konopko
26609         Simplify the example of printing out environ
26610             The binutils package contains a very handy utility to
26611             print out null-byte delimited strings from a file.  This
26612             can replace a rather complex expression with cat(1)
26613             provided as an example for printing out /proc/[pid]/environ.
26614     Michael Kerrisk
26615         Update /proc/PID/maps example
26616             Update to 64-bit example that includes "[heap]", "[stack],
26617             and "[vdso]"
26618     Michael Kerrisk
26619         Formatting fixes for /proc/PID/maps
26620     Mike Frysinger
26621         Document the "pathname" field of /proc/PID/maps
26622     Michael Kerrisk
26623         Add reference to capabilities(7) for /proc/sys/kernel/cap_last_cap
26624     Michael Kerrisk
26625         /proc/PID/maps: add a reference to mmap(2)
26626
26627 ip.7
26628     Radek Pazdera
26629         Document IP_MULTICAST_ALL
26630             This commit adds documentation for the IP_MULTICAST_ALL socket
26631             option.
26632
26633             The option was added to the Linux kernel in 2.6.31:
26634
26635                 Author Nivedita Singhvi <niv@us.ibm.com>
26636                 Commit f771bef98004d9d141b085d987a77d06669d4f4f
26637
26638             The description is based on a previous one [3] posted by the
26639             original author of the code -- Nivedita, but it is slightly
26640             re-worded.
26641
26642             I tested it myself and it works as described.
26643
26644             References:
26645                 [1] http://lxr.free-electrons.com/source/net/ipv4/ip_sockglue.c#L972
26646                 [2] http://lxr.free-electrons.com/source/net/ipv4/igmp.c#L2267
26647                 [3] http://patchwork.ozlabs.org/patch/28902/
26648
26649 units.7
26650     Brian M. Carlson
26651         units should use an actual µ
26652             The units(7) man page uses an ASCII u in place of the actual Greek
26653             letter mu.  Since we're in the twenty-first century, with
26654             UTF-8-compatible terminals and terminal emulators, we should use
26655             the actual letter µ instead of an ASCII approximation.
26656
26657             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=704787
26658
26659
26660 ==================== Changes in man-pages-3.52 ====================
26661
26662 Released: 2013-07-04, Christchurch
26663
26664
26665 Contributors
26666 ------------
26667
26668 The following people contributed patches/fixes or (noted in brackets
26669 in the changelog below) reports, notes, and ideas that have been
26670 incorporated in changes in this release:
26671
26672 Adrian Bunk <bunk@kernel.org>
26673 Andrea Remondini <andrea@undeadlinks.com>
26674 Anthony Foiani <anthony.foiani@gmail.com>
26675 Brian Norris <computersforpeace@gmail.com>
26676 Cyril Hrubis <chrubis@suse.cz>
26677 Dan Jacobson <jidanni@jidanni.org>
26678 David Prévot <taffit@debian.org>
26679 Eric S. Raymond <esr@thyrsus.com>
26680 Georg Sauthoff <mail@georg.so>
26681 Jeff Moyer <jmoyer@redhat.com>
26682 Jérémie Galarneau <jeremie.galarneau@efficios.com>
26683 Jon Grant <jg@jguk.org>
26684 Manuel Traut <manut@linutronix.de>
26685 Марк Коренберг <socketpair@gmail.com>
26686 Michael Kerrisk <mtk.manpages@gmail.com>
26687 Mike Frysinger <vapier@gentoo.org>
26688 Pavel Emelyanov <xemul@parallels.com>
26689 Peng Haitao <penght@cn.fujitsu.com>
26690 Peter LaDow <petela@gocougs.wsu.edu>
26691 Petr Gajdos <pgajdos@suse.cz>
26692 Regid <regid23@nt1.in>
26693 Siddhesh Poyarekar <siddhesh@redhat.com>
26694 Simone Piccardi <piccardi@truelite.it>
26695 Simon Paillard <spaillard@debian.org>
26696 Vince Weaver <vincent.weaver@maine.edu>
26697 Yuri Kozlov <yuray@komyakino.ru>
26698
26699 Apologies if I missed anyone!
26700
26701
26702 Newly documented interfaces in existing pages
26703 ---------------------------------------------
26704
26705 perf_event_open.2
26706     Vince Weaver
26707         Add PERF_IOC_FLAG_GROUP documentation
26708             The perf_event_open() ENABLE/DISABLE/RESET ioctls can take an
26709             argument, PERF_IOC_FLAG_GROUP.  This wasn't documented at all
26710             until about a year ago (despite the support being there from
26711             the beginning) so I missed this when initially writing
26712             the man page.
26713
26714 socket.7
26715     Pavel Emelyanov, Michael Kerrisk
26716         Document SO_PEEK_OFF option
26717             Since Linux 3.4 there appeared an ability to specify the
26718             offset in bytes from which the data will be MSG_PEEK-ed.
26719             Describe this socket option in the socket(7) page, where
26720             all the other socket options are described.
26721
26722
26723 Global changes
26724 --------------
26725
26726 Various pages
26727     Michael Kerrisk
26728         Convert inline formatting (\fX...\fP) to dot-directive formatting
26729
26730 readdir.2
26731 asprintf.
26732 getline.3
26733 getlogin.3
26734 pthread_setname_np.3
26735 readdir.3
26736 strerror.3
26737     Michael Kerrisk  [Jon Grant]
26738         Clarify that terminating null byte is '\0'
26739
26740
26741 Changes to individual pages
26742 ---------------------------
26743
26744 execve.2
26745     Peter LaDow
26746        Add envp to the Linux notes about NULL pointers
26747             During the review of static analysis results, we discovered a
26748             functional, but non-portable, use of execve().  For example:
26749
26750                 char *cmd[] = { "/path/to/some/file", NULL };
26751                 execve(cmd[0], cmd, NULL);
26752
26753             The call succeeds.  Yet, the static analysis tool (rightly)
26754             pointed out that envp could be dereferenced.  But digging into
26755             glibc and the kernel, it appears that like argv, envp when NULL
26756             is treated as if it were an empty list.
26757
26758             So, to clear things up, I'm submitting this patch to update the
26759             man page to indicate that envp is treated like argv.
26760
26761 fallocate.2
26762     Michael Kerrisk
26763         RETURN VALUE: mention that 'errno' is set on error
26764
26765 io_setup.2
26766     Cyril Hrubis  [Jeff Moyer]
26767         Clarify the nr_events parameter
26768             Currently the io_setup.2 man page describes what the kernel really
26769             does, i.e., that the resulting context may be able to hold more
26770             than the 'nr_event's operations because the memory allocated in
26771             kernel is rounded to be multiple of page size.
26772
26773             It is better not to expose this implementation detail and
26774             simply state that the resulting context is suitable for
26775             'nr_events' operations.
26776
26777 perf_event_open.2
26778     Vince Weaver
26779         Clarify the perf_event_open() wakeup_events/wakeup_watermark fields
26780             Clarify the perf_event_open() wakeup_events/wakeup_watermark
26781             fields a bit, based on info from kernel commit cfeb1d90a1b1.
26782     Vince Weaver
26783         Update to match the Linux 3.10 release
26784             This patch updates the perf_event_open() documentation to include
26785             new interfaces added in the 3.10 kernel.
26786
26787             It also documents a few [To be documented] instances left over
26788             from the 3.7 kernel.
26789     Vince Weaver
26790         Small correction to description of 'flags' argument
26791
26792 prctl.2
26793     Michael Kerrisk
26794         Note equivalents of PR_SET_NAME
26795             pthread_setname_np() and pthread_getname_np() and
26796             /proc/self/task/TID/comm provide access to the same
26797             attribute.
26798
26799 pread.2
26800     Michael Kerrisk  [Марк Коренберг]
26801         pread() and pwrite() are especially useful in multithreaded applications
26802
26803 recv.2
26804     Michael Kerrisk
26805         RETURN VALUE: mention that 'errno' is set on error
26806
26807 semctl.2
26808     Michael Kerrisk  [Simone Piccardi]
26809         'sem_nsems' is 'unsigned long' since Linux 2.4
26810
26811 shmget.2
26812     Michael Kerrisk
26813         Rewrite RETURN VALUE and mention that 'errno' is set on error
26814
26815 sigaction.2
26816     Michael Kerrisk  [Brian Norris]
26817         RETURN VALUE: mention that 'errno' is set on error
26818
26819 signal.2
26820     Michael Kerrisk
26821         RETURN VALUE: mention that 'errno' is set on error
26822
26823 sigpending.2
26824     Michael Kerrisk
26825         RETURN VALUE: mention that 'errno' is set on error
26826
26827 sigprocmask.2
26828     Michael Kerrisk
26829         RETURN VALUE: mention that 'errno' is set on error
26830
26831 sigsuspend.2
26832     Michael Kerrisk
26833         RETURN VALUE: mention that 'errno' is set on error
26834
26835 syscall.2
26836     Mike Frysinger
26837         Document s390/s390x calling convention
26838
26839 a64l.3
26840     Peng Haitao
26841         ATTRIBUTES: Note function that is not thread-safe
26842             The function l64a() is not thread safe.
26843
26844 abs.3
26845     Peng Haitao
26846         ATTRIBUTES: Note functions that are thread-safe
26847             The functions abs(), labs(), llabs() and imaxabs() are
26848             thread-safe.
26849
26850 aio_error.3
26851     Peng Haitao
26852         ATTRIBUTES: Note function that is thread-safe
26853             The function aio_error() is thread safe.
26854
26855 aio_return.3
26856     Peng Haitao
26857         ATTRIBUTES: Note function that is thread-safe
26858             The function aio_return() is thread safe.
26859
26860 alloca.3
26861     Adrian Bunk
26862         Correct information on getting non-inlined version with gcc+glibc
26863             - remove the incorrect information that -fno-builtin would help
26864             - add -std=c11 to the list of strict options
26865             - emphasize more that both the gcc option and not including
26866               alloca.h are needed
26867             - add the #ifdef from the glibc alloca.h to make the situation
26868               clearer
26869
26870 bindresvport.3
26871     Peng Haitao
26872         ATTRIBUTES: Note function that is thread-safe
26873             Before glibc 2.17, bindresvport() is not thread-safe.
26874             Since glibc 2.17, it is thread-safe, the patch can refer to URL:
26875             http://sourceware.org/git/?p=glibc.git;a=commit;h=f6da27e53695ad1cc0e2a9490358decbbfdff5e5
26876
26877 canonicalize_file_name.3
26878     Michael Kerrisk
26879         Put CONFORMING TO section in right location
26880
26881 catgets.3
26882     Michael Kerrisk  [Jon Grant]
26883         Clarify that null byte is '\0'
26884
26885 ceil.3
26886     Peng Haitao
26887         ATTRIBUTES: Note functions that are thread-safe
26888             The functions ceil(), ceilf() and ceill() are thread safe.
26889
26890 cimag.3
26891     Peng Haitao
26892         ATTRIBUTES: Note functions that are thread-safe
26893             The functions cimag(), cimagf() and cimagl() are thread safe.
26894
26895 clock_getcpuclockid.3
26896     Peng Haitao
26897         ATTRIBUTES: Note function that is thread-safe
26898             The function clock_getcpuclockid() is thread safe.
26899
26900 conj.3
26901     Peng Haitao
26902         ATTRIBUTES: Note functions that are thread-safe
26903             The functions conj(), conjf() and conjl() are thread safe.
26904
26905 crypt.3
26906     Peng Haitao
26907         ATTRIBUTES: Note function that is not thread-safe
26908             The function crypt() is not thread safe.
26909
26910 ctermid.3
26911     Peng Haitao
26912         ATTRIBUTES: Note function that is thread safe with exceptions
26913             The function ctermid() is thread safe with exceptions.
26914
26915 dirfd.3
26916     Michael Kerrisk
26917         RETURN VALUE: mention that 'errno' is set on error
26918
26919 drand48.3
26920     Peng Haitao
26921         ATTRIBUTES: Note functions that are not thread-safe
26922             The functions drand48(), erand48(), lrand48(), nrand48(),
26923             mrand48(), jrand48(), srand48(), seed48() and lcong48() are
26924             not thread safe.
26925
26926 ecvt.3
26927     Peng Haitao
26928         ATTRIBUTES: Note functions that are not thread-safe
26929             The functions ecvt() and fcvt() return a string located in a
26930             static buffer which is overwritten by the next call to the
26931             functions, so they are not thread-safe.
26932
26933 encrypt.3
26934     Peng Haitao
26935         ATTRIBUTES: Note functions that are not thread-safe
26936             The functions encrypt() and setkey() are not thread safe.
26937
26938 ether_aton.3
26939     Peng Haitao
26940         ATTRIBUTES: Note functions that are not thread-safe
26941             The functions ether_aton() and ether_ntoa() are not thread safe.
26942
26943 fcloseall.3
26944     Peng Haitao
26945         ATTRIBUTES: Note function that is not thread-safe
26946             The function fcloseall() is not thread safe.
26947
26948 ferror.3
26949     Peng Haitao
26950         ATTRIBUTES: Note functions that are thread-safe
26951             The functions ferror(), clearerr(), feof() and fileno() are
26952             thread safe.
26953
26954 fgetgrent.3
26955     Michael Kerrisk
26956         RETURN VALUE: mention that 'errno' is set on error
26957
26958 fgetpwent.3
26959     Michael Kerrisk
26960         RETURN VALUE: mention that 'errno' is set on error
26961
26962 fgetwc.3
26963     Michael Kerrisk
26964         RETURN VALUE: mention that 'errno' is set on error
26965
26966 fmtmsg.3
26967     Peng Haitao
26968         ATTRIBUTES: Note function that is thread-safe
26969             Before glibc 2.16, fmtmsg() is not thread-safe.
26970             Since glibc 2.16, it is thread-safe, the patch can refer to URL:
26971             http://sourceware.org/git/?p=glibc.git;a=commit;h=7724defcf8873116fe4efab256596861eef21a94
26972
26973 fputwc.3
26974     Michael Kerrisk
26975         RETURN VALUE: mention that 'errno' is set on error
26976
26977 getdate.3
26978     Peng Haitao
26979         ATTRIBUTES: Note functions that are and aren't thread-safe
26980
26981 getgrent.3
26982     Peng Haitao
26983         ATTRIBUTES: Note function that is not thread-safe
26984             The function getgrent() is not thread safe.
26985
26986 getgrnam.3
26987     Peng Haitao
26988         ATTRIBUTES: Note functions that are and aren't thread-safe
26989
26990 getline.3
26991     Michael Kerrisk
26992         RETURN VALUE: mention that 'errno' is set on error
26993
26994 getlogin.3
26995     Peng Haitao
26996         ATTRIBUTES: Note function that is not thread-safe
26997             The function getlogin() is not thread safe.
26998             The function cuserid() is thread-safe with exceptions.
26999     Michael Kerrisk
27000         RETURN VALUE: mention that 'errno' is set on error
27001
27002 getpass.3
27003     Peng Haitao
27004         ATTRIBUTES: Note functions that are not thread-safe
27005
27006 getpwent.3
27007     Peng Haitao
27008         ATTRIBUTES: Note function that is not thread-safe
27009             The function getpwent() is not thread safe.
27010
27011 getpwnam.3
27012     Peng Haitao
27013         ATTRIBUTES: Note functions that are and aren't thread-safe
27014
27015 getspnam.3
27016     Michael Kerrisk
27017         RETURN VALUE: mention that 'errno' is set on error
27018
27019 getttyent.3
27020     Peng Haitao
27021         ATTRIBUTES: Note functions that are not thread-safe
27022
27023 getusershell.3
27024     Peng Haitao
27025         ATTRIBUTES: Note functions that are not thread-safe
27026             The functions getusershell(), setusershell() and endusershell()
27027             are not thread safe.
27028
27029 getutent.3
27030     Michael Kerrisk
27031         RETURN VALUE: mention that 'errno' is set on error
27032
27033 hsearch.3
27034     Michael Kerrisk
27035         RETURN VALUE: mention that 'errno' is set on error
27036
27037 hsearch.3
27038     Peng Haitao
27039         ATTRIBUTES: Note functions that are not thread-safe
27040             The functions hsearch(), hcreate() and hdestroy() are not
27041             thread-safe.
27042
27043 localeconv.3
27044     Peng Haitao
27045         ATTRIBUTES: Note functions that are not thread-safe
27046             The function localeconv() returns a pointer to a structure which
27047             might be overwritten by subsequent calls to localeconv() or by
27048             calls to setlocale(), so it is not thread-safe.
27049     Peng Haitao
27050         Add RETURN VALUE section
27051
27052 malloc_info.3
27053     Michael Kerrisk
27054         RETURN VALUE: mention that 'errno' is set on error
27055
27056 mblen.3
27057     Peng Haitao
27058         ATTRIBUTES: Note function that is not thread-safe
27059             The function mblen() is not thread safe.
27060
27061 mbrlen.3
27062     Peng Haitao
27063         ATTRIBUTES: Note function that is thread safe with exceptions
27064             The function mbrlen() is thread safe with exceptions.
27065
27066 mbrtowc.3
27067     Peng Haitao
27068         ATTRIBUTES: Note function that is thread safe with exceptions
27069             The function mbrtowc() is thread safe with exceptions.
27070
27071 mktemp.3
27072     Michael Kerrisk
27073         RETURN VALUE: mention that 'errno' is set on error
27074
27075 modf.3
27076     Peng Haitao
27077         ATTRIBUTES: Note functions that are thread-safe
27078             The functions modf(), modff() and modfl() are thread safe.
27079
27080 popen.3
27081     Michael Kerrisk
27082         RETURN VALUE: mention that 'errno' is set on error
27083
27084 pthread_attr_setinheritsched.3
27085     Michael Kerrisk
27086         Note the scheduling attributes affected by this function
27087
27088 pthread_attr_setschedparam.3
27089 pthread_attr_setschedpolicy.3
27090 pthread_attr_setscope.3
27091     Michael Kerrisk  [Manuel Traut, Siddhesh Poyarekar]
27092         The inherit-scheduler attribute must be set to PTHREAD_EXPLICIT_SCHED
27093             In order for the attributes set by these functions to have
27094             an effect, the caller must use pthread_attr_setinheritsched(3)
27095             to set the inherit-scheduler attribute of the attributes object
27096             to PTHREAD_EXPLICIT_SCHED.
27097
27098 ptsname.3
27099     Peng Haitao
27100         ATTRIBUTES: Note function that is not thread-safe
27101             The function ptsname() is not thread safe.
27102
27103 putenv.3
27104     Michael Kerrisk
27105         RETURN VALUE: mention that 'errno' is set on error
27106
27107 putpwent.3
27108     Michael Kerrisk
27109         RETURN VALUE: mention that 'errno' is set on error
27110
27111 qecvt.3
27112     Peng Haitao
27113         ATTRIBUTES: Note functions that are not thread-safe
27114             The functions qecvt() and qfcvt() are not thread-safe.
27115
27116 random.3
27117     Michael Kerrisk
27118         RETURN VALUE: mention that 'errno' is set on error
27119     Michael Kerrisk
27120         Add EINVAL error for setstate()
27121     Michael Kerrisk
27122         BUGS: initstate() does not return NULL on error
27123             http://sourceware.org/bugzilla/show_bug.cgi?id=15380
27124
27125 random_r.3
27126     Michael Kerrisk
27127         RETURN VALUE: mention that 'errno' is set on error
27128
27129 readdir.3
27130     Peng Haitao
27131         ATTRIBUTES: Note functions that are not thread-safe
27132             The data returned by readdir() may be overwritten by subsequent
27133             calls to readdir() for the same directory stream, so it is not
27134             thread-safe.
27135
27136 re_comp.3
27137     Peng Haitao
27138         ATTRIBUTES: Note functions that are not thread-safe
27139             The functions re_comp() and re_exec() are not thread safe.
27140
27141 rexec.3
27142     Peng Haitao
27143         ATTRIBUTES: Note functions that are not thread-safe
27144             The functions rexec() and rexec_af() are not thread safe.
27145
27146 round.3
27147     Peng Haitao
27148         ATTRIBUTES: Note functions that are thread-safe
27149             The functions round(), roundf() and roundl() are thread safe.
27150
27151 scalbln.3
27152     Peng Haitao
27153         ATTRIBUTES: Note functions that are thread-safe
27154             The functions scalbn(), scalbnf(), scalbnl(), scalbln(),
27155             scalblnf() and scalblnl() are thread safe.
27156
27157 scandir.3
27158     Michael Kerrisk
27159         RETURN VALUE: mention that 'errno' is set on error
27160
27161 siginterrupt.3
27162     Michael Kerrisk
27163         RETURN VALUE: mention that 'errno' is set on error
27164
27165 signbit.3
27166     Peng Haitao
27167         ATTRIBUTES: Note macro that is thread-safe
27168             The macro signbit() is thread safe.
27169
27170 sigsetops.3
27171     Michael Kerrisk
27172         RETURN VALUE: mention that 'errno' is set on error
27173
27174 stdio_ext.3
27175     Peng Haitao
27176         ATTRIBUTES: Note functions that are not thread-safe
27177             The functions __fbufsize(), __fpending(), __fpurge() and
27178             __fsetlocking() are not thread safe.
27179
27180 strdup.3
27181     Michael Kerrisk
27182         RETURN VALUE: mention that 'errno' is set on error
27183
27184 strerror.3
27185     Peng Haitao
27186         ATTRIBUTES: Note function that is not thread-safe
27187             The function strerror() is not thread safe.
27188
27189 strftime.3
27190     Michael Kerrisk
27191         Clarify details of return value
27192     Michael Kerrisk
27193         BUGS: 'errno' is not set if the result string would exceed 'max' bytes
27194
27195 strtok.3
27196     Peng Haitao
27197         ATTRIBUTES: Note function that is not thread-safe
27198             The function strtok() is not thread safe.
27199     Michael Kerrisk  [Georg Sauthoff]
27200         Add more detail on the operation of strtok()
27201             Add a number of missing details on the operation of strtok()
27202
27203 tempnam.3
27204     Michael Kerrisk
27205         RETURN VALUE: mention that 'errno' is set on error
27206
27207 timegm.3
27208     Jérémie Galarneau
27209         copy the string returned by getenv()
27210             The example of a portable version of timegm() uses the string
27211             returned by getenv() after calling setenv() on the same
27212             environment variable. The tz string may be invalid as per
27213             getenv.3:
27214
27215                     "The string pointed to by the return value of getenv()
27216                      may be statically allocated, and can be modified by a
27217                      subsequent call to getenv(), putenv(3), setenv(3), or
27218                      unsetenv(3)."
27219
27220 tmpnam.3
27221     Peng Haitao
27222         ATTRIBUTES: Note function that is thread safe with exceptions
27223             The function tmpnam() is thread safe with exceptions.
27224
27225 trunc.3
27226     Peng Haitao
27227         ATTRIBUTES: Note functions that are thread-safe
27228             The functions trunc(), truncf() and truncl() are thread safe.
27229
27230 ttyname.3
27231     Michael Kerrisk
27232         ATTRIBUTES: Note functions that are and aren't thread-safe
27233
27234 ttyslot.3
27235     Michael Kerrisk
27236         ATTRIBUTES: Note functions that are not thread-safe
27237
27238 usleep.3
27239     Michael Kerrisk
27240         RETURN VALUE: mention that 'errno' is set on error
27241
27242 wcsdup.3
27243     Michael Kerrisk
27244         RETURN VALUE: mention that 'errno' is set on error
27245
27246 core.5
27247     Michael Kerrisk
27248         Implicitly adding the PID to a core filename was dropped in 2.6.27
27249
27250 proc.5
27251     Michael Kerrisk
27252         Document /proc/[pid]/fd/ anon_inode symlinks
27253     Mike Frysinger
27254         Document /proc/[pid]/fd/ symlinks a bit more
27255             Describe the type:[inode] syntax used in this dir
27256
27257 bootparam.7
27258     Michael Kerrisk  [Dan Jacobson]
27259         Remove outdated text on LILO and LoadLin
27260             Strike the discussion of LILO and LoadLin, which
27261             are long obsolete, and make a brief mention of GRUB.
27262             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604019
27263     Regid
27264         Remove mention of the deprecated rdev(8)
27265             The deprecated rdev(8) command was removed from util-linux in 2010.
27266             See https://git.kernel.org/?p=utils/util-linux/util-linux.git;a=commit;h=a3e40c14651fccf18e7954f081e601389baefe3fO
27267     Andrea Remondini
27268         Document the 'resume' boot parameter
27269
27270 inotify.7
27271     Michael Kerrisk  [Jon Grant]
27272         Clarify that null byte is '\0'
27273
27274 iso_8859-2.7
27275     Eric S. Raymond
27276         Remove incorrect reference to nonexistent groff glyph \[shc]
27277             The reference incorrectly attempted to duplicate an
27278             actual soft hyphen (hex 0xad) just before it in the file.
27279
27280 man-pages.7
27281     Peng Haitao
27282         Add description of "ATTRIBUTES"
27283             "ATTRIBUTES" section can mention thread safety,
27284             cancellation safety, and async-cancel-safety.
27285
27286 socket.7
27287     Michael Kerrisk
27288         Note that 'optval' for socket options is an 'int' in most cases
27289
27290 tcp.7
27291     Michael Kerrisk
27292         Note that 'optval' for socket options is an 'int' in most cases
27293
27294 udp.7
27295     Michael Kerrisk
27296         Note that 'optval' for socket options is an 'int' in most cases
27297
27298
27299 ==================== Changes in man-pages-3.53 ====================
27300
27301 Released: 2013-07-31, Munich
27302
27303
27304 Contributors
27305 ------------
27306
27307 The following people contributed patches/fixes or (noted in brackets
27308 in the changelog below) reports, notes, and ideas that have been
27309 incorporated in changes in this release:
27310
27311 Al Viro <viro@ZenIV.linux.org.uk>
27312 Andrey Vagin <avagin@openvz.org>
27313 Benjamin Poirier <bpoirier@suse.de>
27314 Chris Heath <chris@heathens.co.nz>
27315 Chuck Coffing <clc@alum.mit.edu>
27316 David Prévot <taffit@debian.org>
27317 Denys Vlasenko <dvlasenk@redhat.com>
27318 Dmitry V. Levin <ldv@altlinux.org>
27319 Felix Schulte <Felix_Schulte@McAfee.com>
27320 Graud <graud@gmx.com>
27321 Michael Kerrisk <mtk.manpages@gmail.com>
27322 Oleg Nesterov <oleg@redhat.com>
27323 Peng Haitao <penght@cn.fujitsu.com>
27324 Peter Schiffer <pschiffe@redhat.com>
27325 Simon Paillard <spaillard@debian.org>
27326 Vince Weaver <vincent.weaver@maine.edu>
27327
27328 Apologies if I missed anyone!
27329
27330
27331 New and rewritten pages
27332 -----------------------
27333
27334 restart_syscall.2
27335     Michael Kerrisk
27336         New page for restart_syscall(2) system call
27337
27338
27339 Newly documented interfaces in existing pages
27340 ---------------------------------------------
27341
27342 fchownat.2
27343     Michael Kerrisk
27344         Document AT_EMPTY_PATH
27345
27346 fstatat.2
27347     Michael Kerrisk
27348         Document AT_EMPTY_PATH
27349
27350 linkat.2
27351     Michael Kerrisk
27352         Document AT_EMPTY_PATH
27353
27354 open.2
27355     Michael Kerrisk [Al Viro]
27356         Document O_PATH
27357             See also https://bugzilla.redhat.com/show_bug.cgi?id=885740
27358
27359
27360 Changes to individual pages
27361 ---------------------------
27362
27363 clock_nanosleep.2
27364 futex.2
27365 nanosleep.2
27366 poll.2
27367 sigaction.2
27368 sigreturn.2
27369 signal.7
27370     Michael Kerrisk
27371         SEE ALSO: add restart_syscall(2)
27372
27373 open.2
27374     Michael Kerrisk [Geoffrey Thomas]
27375         Remove warning that O_DIRECTORY is only for use with opendir(3)
27376             O_DIRECTORY can also be used with, for example, O_PATH.
27377
27378 perf_event_open.2
27379     Vince Weaver
27380         Improve PERF_SAMPLE_BRANCH_STACK documentation
27381     Vince Weaver
27382         Fix indentation of the MMAP layout section
27383             The indentation of the MMAP layout section wasn't quite right.
27384             I think this improves things but I admit I'm not an expert at the
27385             low-level indentation directives.
27386     Vince Weaver
27387         Update PERF_IOC_FLAG_GROUP info
27388             It turns out PERF_IOC_FLAG_GROUP was broken from 75f937f24bd9
27389             (in Linux 2.6.31, the initial perf_event release) until
27390             724b6daa1 (Linux 3.4).
27391
27392             I've done some extensive kernel source code digging plus
27393             running tests of various kernels and I hope the info
27394             presented is accurate now.
27395
27396             (Patch edited somewhat by mtk.)
27397     Vince Weaver
27398         Improve sysfs files documentation
27399             This improves the documentation of the various
27400             perf_event_open()-related sysfs files.
27401
27402 ptrace.2
27403     Denys Vlasenko  [Oleg Nesterov, Dmitry V. Levin]
27404         If SEIZE was used, initial auto-attach stop is EVENT_STOP
27405             For every PTRACE_O_TRACEfoo option, mention that old-style SIGSTOP
27406             is replaced by PTRACE_EVENT_STOP if PTRACE_SEIZE attach was used.
27407
27408             Mention the same thing again in the description of
27409             PTRACE_EVENT_STOP.
27410     Denys Vlasenko  [Oleg Nesterov, Dmitry V. Levin]
27411         Mention that PTRACE_PEEK* libc API and kernel API are different
27412     Denys Vlasenko  [Oleg Nesterov, Dmitry V. Levin]
27413         Clarify PTRACE_INTERRUPT, PTRACE_LISTEN, and group-stop behavior
27414
27415 readlink.2
27416     Michael Kerrisk
27417         Document use of empty 'pathname' argument
27418     Michael Kerrisk
27419         Change error check in example program from "< 0" to "== -1"
27420     Chuck Coffing
27421         Fix possible race condition in readlink.2 example
27422             I noticed that the example in the readlink.2 man pages does error
27423             checking for a race condition that would cause the value of the
27424             symbolic link to get larger.  However, it doesn't handle the
27425             opposite case, in which the value gets shorter.  (The NULL
27426             terminator is always set at the old, longer offset.)  This could
27427             cause the program to operate on uninitialized data.
27428
27429 setpgid.2
27430     Michael Kerrisk  [Graud]
27431         s/SIGTSTP/SIGTTIN/ when discussing reads from terminal
27432             See https://bugzilla.kernel.org/show_bug.cgi?id=60504
27433
27434 clog2.3
27435     Michael Kerrisk
27436         Note that these functions are still not present in glibc 2.17
27437
27438 dirfd.3
27439     Peng Haitao
27440         ATTRIBUTES: Note function that is thread-safe
27441             The function dirfd() is thread safe.
27442
27443 div.3
27444     Peng Haitao
27445         ATTRIBUTES: Note functions that are thread-safe
27446             The functions div(), ldiv(), lldiv() and imaxdiv() are thread
27447             safe.
27448
27449 fabs.3
27450     Peng Haitao
27451         ATTRIBUTES: Note functions that are thread-safe
27452             The functions fabs(), fabsf() and fabsl() are thread safe.
27453
27454 fdim.3
27455     Peng Haitao
27456         ATTRIBUTES: Note functions that are thread-safe
27457             The functions fdim(), fdimf() and fdiml() are thread safe.
27458
27459 fflush.3
27460     Peng Haitao
27461         ATTRIBUTES: Note function that is thread-safe
27462             The function fflush() is thread safe.
27463
27464 finite.3
27465     Peng Haitao
27466         ATTRIBUTES: Note functions that are thread-safe
27467             The functions finite(), finitef(), finitel(), isinf(), isinff(),
27468             isinfl(), isnan(), isnanf() and isnanl() are thread safe.
27469
27470 flockfile.3
27471     Peng Haitao
27472         ATTRIBUTES: Note functions that are thread-safe
27473             The functions flockfile(), ftrylockfile() and funlockfile() are
27474             thread safe.
27475
27476 floor.3
27477     Peng Haitao
27478         ATTRIBUTES: Note functions that are thread-safe
27479             The functions floor(), floorf() and floorl() are thread safe.
27480
27481 resolv.conf.5
27482     Simon Paillard
27483         Explain how to set empty domain
27484             See http://bugs.debian.org/463575
27485
27486 capabilities.7
27487     Michael Kerrisk
27488         Add open_by_handle_at(2) under CAP_DAC_READ_SEARCH
27489
27490 inotify.7
27491     Michael Kerrisk  [Felix Schulte]
27492         Clarify description of IN_MOVED_FROM and IN_MOVED_TO
27493
27494 man-pages.7
27495     Michael Kerrisk
27496         DESCRIPTION should note versions for new interface features or behavior
27497
27498 udp.7
27499     Benjamin Poirier
27500         Add missing #include directive
27501             Using the UDP_CORK socket option documented in udp.7 requires
27502             including <netinet/udp.h>.
27503
27504 ld.so.8
27505     Michael Kerrisk
27506         Rework rpath token expansion text
27507     Michael Kerrisk
27508         Describe $PLATFORM rpath token
27509     Michael Kerrisk
27510         Describe $LIB rpath token
27511     Michael Kerrisk
27512         Document LD_BIND_NOT
27513     Michael Kerrisk  [Simon Paillard]
27514         Add reference to pthreads(7) in discussion of LD_ASSUME_KERNEL
27515
27516
27517 ==================== Changes in man-pages-3.54 ====================
27518
27519 Released: 2013-09-17, Munich
27520
27521
27522 Contributors
27523 ------------
27524
27525 The following people contributed patches/fixes or (noted in brackets
27526 in the changelog below) reports, notes, and ideas that have been
27527 incorporated in changes in this release:
27528
27529 A. Costa <agcosta@gis.net>
27530 Akihiro MOTOKI <amotoki@gmail.com>
27531 Andreas Wiese <aw-lkml@instandbesetzt.net>
27532 Andrew Hunter <andrewhhunter@gmail.com>
27533 Chen Gang <gang.chen@asianux.com>
27534 Christopher Hall <chall0@gmail.com>
27535 Christos Tsopokis <christos@tsopokis.gr>
27536 David Prévot <taffit@debian.org>
27537 D. Barbier <bouzim@gmail.com>
27538 Doug Goldstein <cardoe@cardoe.com>
27539 Elie De Brauwer <eliedebrauwer@gmail.com>
27540 Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
27541 Felix Janda <felix.janda@posteo.de>
27542 G.raud <graud@gmx.com>
27543 Hannes Landeholm <hannes@jumpstarter.io>
27544 J. Bruce Fields <bfields@fieldses.org>
27545 J. Bruce Fields <bfields@redhat.com>
27546 Johan Erlandsson <jeoerl@gmail.com>
27547 Jon Grant <jg@jguk.org>
27548 Magnus Reftel <magnus.reftel@gmail.com>
27549 Marko Myllynen <myllynen@redhat.com>
27550 Michael Kerrisk <mtk.manpages@gmail.com>
27551 Oleg Nesterov <oleg@redhat.com>
27552 Peng Haitao <penght@cn.fujitsu.com>
27553 Peter Schiffer <pschiffe@redhat.com>
27554 Robert Harris <robert.harris@fixnetix.com>
27555 Rodrigo Campos <rodrigo@sdfg.com.ar>
27556 Simon Paillard <spaillard@debian.org>
27557 Stas <stas.grumbler@gmail.com>
27558 Vince Weaver <vincent.weaver@maine.edu>
27559 Will Newton <will.newton@linaro.org>
27560 Zdenek Pavlas <zpavlas@redhat.com>
27561 Zsbán Ambrus <ambrus@math.bme.hu>
27562
27563 Apologies if I missed anyone!
27564
27565
27566
27567 Newly documented interfaces in existing pages
27568 ---------------------------------------------
27569
27570 ioctl_list.2
27571     Zsbán Ambrus
27572         Document FAT_IOCTL_GET_ATTRIBUTES
27573             The attached patch adds four ioctls from linux/msdos_fs.h to the
27574             ioctl_list(2) manpage.
27575
27576             The ioctl FAT_IOCTL_GET_ATTRIBUTES reads FAT attributes of a
27577             file a mounted vfat file system.  I tested this on Linux
27578             2.6.33, an example script can be found at
27579             http://www.perlmonks.com/?node_id=832623
27580
27581
27582 Global changes
27583 --------------
27584
27585 Various pages
27586     Michael Kerrisk
27587         Global fix: s/file system/filesystem/
27588             Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
27589             "filesystem" is the form used by the great majority of man pages
27590             outside the man-pages project and in a number of other sources,
27591             so let's go with that.
27592
27593
27594 Changes to individual pages
27595 ---------------------------
27596
27597 access.2
27598     J. Bruce Fields
27599         Fix outdated NFS information
27600             Note that NFS versions since version 3 support an "access" call
27601             so that the client doesn't have to guess permissions or ID
27602             mapping on its own.
27603
27604             (See RFC 1813 sections 1.7 and 3.3.4.)
27605
27606 adjtimex.2
27607     Michael Kerrisk
27608         SEE ALSO: Add adjtimex(8)
27609
27610 clock_getres.2
27611     Michael Kerrisk  [Rodrigo Campos]
27612         Note circumstances in which "SMP" note applies.
27613     Michael Kerrisk
27614         Add kernel version for CLOCK_*_CPUTIME_ID
27615             CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID
27616             appeared in 2.6.12.
27617     Michael Kerrisk
27618         Add VERSIONS section
27619
27620 futex.2
27621     Michael Kerrisk
27622         The 'timeout' can be rounded upwards by clock granularity and also overrun
27623
27624 kill.2
27625     Michael Kerrisk
27626         Small improvements to text on historical rules for permissions
27627
27628 nfsservctl.2
27629     Michael Kerrisk
27630         Note commands that were only in Linux 2.4.x and earlier
27631
27632 open.2
27633     Robert Harris
27634         Add mmap(2) to list of calls that fail when given an O_PATH descriptor
27635     Doug Goldstein
27636         Add EINVAL to errors list
27637             EINVAL can be returned by open(2) when the underlying filesystem
27638             doesn't support O_DIRECT. It is documented in the NOTES section
27639             but this patch adds it to the list of possible errors.
27640
27641 perf_event_open.2
27642     Vince Weaver
27643         PERF_SAMPLE_BRANCH_STACK updates
27644             This started out as just adding the new perf_event_open features
27645             from Linux 3.11 (which was the addition of transactional memory
27646             defines for PERF_SAMPLE_BRANCH_STACK samples) but turned into a
27647             general cleanup of the PERF_SAMPLE_BRANCH_STACK documentation.
27648
27649             The main clarification is that at least one of the non-privilege
27650             values must be set or else perf_event_open() will return an EINVAL
27651             error.
27652     Michael Kerrisk
27653         Reorder text describing fields of 'perf_event_header' structure
27654             Place the fields with the shorter descriptions first, to make the
27655             information easier to read.
27656
27657 poll.2
27658     Michael Kerrisk
27659         Clarify wording of 'timeout' as a "minimum" interval
27660
27661 sched_setaffinity.2
27662     Michael Kerrisk  [Christos Tsopokis]
27663         Clarify that these system calls affect a per-thread attribute
27664
27665 sched_setparam.2
27666     Michael Kerrisk
27667         Clarify that this system call applies to threads (not processes)
27668
27669 sched_setscheduler.2
27670     Michael Kerrisk
27671         Clarify that this system call applies to threads (not processes)
27672
27673 select.2
27674     Michael Kerrisk  [G.raud]
27675         Clarify wording of 'timeout' as a "minimum" interval
27676
27677 setfsgid.2
27678     Michael Kerrisk  [Oleg Nesterov]
27679         Clarify description of return value
27680             More clearly describe the weirdness in the return value of this
27681             system call, and note the problems it creates in BUGS
27682     Michael Kerrisk
27683         Correct header file in SYNOPSIS
27684     Michael Kerrisk
27685         Refer to setfsuid(2) for an explanation of why setfsgid() is obsolete
27686     Michael Kerrisk
27687         Wording improvements
27688
27689 setfsuid.2
27690     Michael Kerrisk  [Oleg Nesterov]
27691         Clarify description of return value
27692             More clearly describe the weirdness in the return value of this
27693             system call, and note the problems it creates in BUGS
27694     Michael Kerrisk  [Chen Gang]
27695         Clarify historical details and note that setfsuid() is obsolete
27696     Michael Kerrisk
27697         Wording improvements
27698     Michael Kerrisk
27699         Correct header file in SYNOPSIS
27700
27701 sigwaitinfo.2
27702     Michael Kerrisk
27703         Clarify wording of 'timeout' as a "minimum" interval
27704
27705 syscall.2
27706     Johan Erlandsson
27707         Add missing argument in example
27708     Johan Erlandsson
27709         Correct registers for arm/EABI
27710             Registers was off by one.
27711
27712             Reference:
27713             http://www.arm.linux.org.uk/developer/patches/viewpatch.php?id=3105/4
27714
27715             See also:
27716             http://peterdn.com/post/e28098Hello-World!e28099-in-ARM-assembly.aspx
27717             https://wiki.debian.org/ArmEabiPort
27718             http://en.wikipedia.org/wiki/Calling_convention#ARM
27719
27720 wait.2
27721     Michael Kerrisk  [Hannes Landeholm]
27722         Add details on the fifth argument provided by raw waitid() system call
27723             See https://bugzilla.kernel.org/show_bug.cgi?id=60744
27724
27725 clock.3
27726     Michael Kerrisk
27727         clock() switched from using times(2) to clock_gettime() in glibc 2.18
27728
27729 drand48_r.3
27730     Peng Haitao
27731         ATTRIBUTES: Note functions that are thread-safe
27732             The functions drand48_r(), erand48_r(), lrand48_r(),
27733             nrand48_r(), mrand48_r(), jrand48_r(), srand48_r(), seed48_r(),
27734             and lcong48_r() are thread safe.
27735
27736 fma.3
27737     Peng Haitao
27738         ATTRIBUTES: Note functions that are thread-safe
27739             The functions fma(), fmaf() and fmal() are thread safe.
27740
27741 fmax.3
27742     Peng Haitao
27743         ATTRIBUTES: Note functions that are thread-safe
27744             The functions fmax(), fmaxf() and fmaxl() are thread safe.
27745
27746 fmin.3
27747     Peng Haitao
27748         ATTRIBUTES: Note functions that are thread-safe
27749             The functions fmin(), fminf() and fminl() are thread safe.
27750
27751 fpclassify.3
27752     Peng Haitao
27753         ATTRIBUTES: Note functions that are thread-safe
27754             The functions fpclassify(), isfinite(), isnormal(), isnan(), and
27755             isinf() are thread safe.
27756
27757 frexp.3
27758     Peng Haitao
27759         ATTRIBUTES: Note functions that are thread-safe
27760             The functions frexp(), frexpf() and frexpl() are thread safe.
27761
27762 gethostbyname.3
27763     Michael Kerrisk  [Jon Grant]
27764         gai_strerror() is the modern replacement for herror() and hstrerror()
27765     Michael Kerrisk
27766         Update feature test macro requirements for herror() and hstrerror()
27767     Michael Kerrisk
27768         Add feature test macro requirements for h_errno
27769
27770 ilogb.3
27771     Peng Haitao
27772         ATTRIBUTES: Note functions that are thread-safe
27773             The functions ilogb(), ilogbf() and ilogbl() are thread safe.
27774
27775 ldexp.3
27776     Peng Haitao
27777         ATTRIBUTES: Note functions that are thread-safe
27778             The functions ldexp(), ldexpf() and ldexpl() are thread safe.
27779
27780 lrint.3
27781     Peng Haitao
27782         ATTRIBUTES: Note functions that are thread-safe
27783             The functions lrint(), lrintf(), lrintl(), llrint(), llrintf(),
27784             and llrintl() are thread safe.
27785
27786 lround.3
27787     Peng Haitao
27788         ATTRIBUTES: Note functions that are thread-safe
27789             The functions lround(), lroundf(), lroundl(), llround(),
27790             llroundf() and llroundl() are thread safe.
27791
27792 lseek64.3
27793     Peng Haitao
27794         ATTRIBUTES: Note function that is thread-safe
27795             The function lseek64() is thread safe.
27796
27797 mbsinit.3
27798     Peng Haitao
27799         ATTRIBUTES: Note function that is thread-safe
27800             The function mbsinit() is thread safe.
27801
27802 nextafter.3
27803     Peng Haitao
27804         ATTRIBUTES: Note functions that are thread-safe
27805             The functions nextafter(), nextafterf(), nextafterl(),
27806             nexttoward(), nexttowardf() and nexttowardl() are thread safe.
27807
27808 posix_memalign.3
27809     Michael Kerrisk  [Will Newton]
27810         'errno" is indeterminate after a call to posix_memalign()
27811     Michael Kerrisk  [Will Newton]
27812         Clarify wording on "return value" when size==0
27813
27814 printf.3
27815     Christopher Hall
27816         Correctly describe the meaning of a negative precision
27817             The printf(3) manpage says that a negative precision is taken to
27818             be zero, whereas printf(3p) says that a negative precision is
27819             taken as if the precision were omitted.  glibc agrees with the
27820             latter (POSIX) specification.
27821
27822             Test code:
27823
27824                 printf("%f\n",42.0);      // "42.000000"
27825                 printf("%.*f\n",0,42.0);  // "42"
27826                 printf("%.*f\n",-1,42.0); // "42.000000"
27827
27828             This patch corrects the explanation to match what actually happens.
27829
27830 rewinddir.3
27831     Peng Haitao
27832         ATTRIBUTES: Note function that is thread-safe
27833             The function rewinddir() is thread safe.
27834
27835 rint.3
27836     Peng Haitao
27837         ATTRIBUTES: Note functions that are thread-safe
27838             The functions nearbyint(), nearbyintf(), nearbyintl(), rint(),
27839             rintf() and rintl() are thread safe.
27840
27841 seekdir.3
27842     Peng Haitao
27843         ATTRIBUTES: Note function that is thread-safe
27844             The function seekdir() is thread safe.
27845
27846 telldir.3
27847     Peng Haitao
27848         ATTRIBUTES: Note function that is thread-safe
27849             The function telldir() is thread safe.
27850
27851 wctomb.3
27852     Peng Haitao
27853         ATTRIBUTES: Note function that is not thread-safe
27854             The function wctomb() is not thread safe.
27855
27856 wavelan.4
27857     Michael Kerrisk  [Elie De Brauwer]
27858         This driver disappeared in 2.56.35
27859
27860 dir_colors.5
27861     Michael Kerrisk  [Stas]
27862         Add various synonyms
27863             See http://bugs.debian.org/553477
27864     Simon Paillard  [Stas]
27865         Add keywords SUID, SGID, STICKY, STICKY_OTHER_WRITABLE, OTHER_WRITABLE
27866             See http://bugs.debian.org/553477
27867             See ls.c and dircolors.c in coreutils
27868
27869 proc.5
27870     Peter Schiffer
27871         Document /proc/[pid]/io file
27872             Attempt to document fields in the /proc/[pid]/io file, based on
27873             the Documentation/filesystems/proc.txt. The text will probably
27874             need some grammar corrections.
27875     Michael Kerrisk  [Marko Myllynen]
27876         /proc/sys/fs/inode-max went away in Linux 2.4
27877             Also, the 'preshrink' field in /proc/sys/fs/inode-state became
27878             a dummy value in Linux 2.4.
27879
27880             See https://bugzilla.kernel.org/show_bug.cgi?id=60836
27881     Michael Kerrisk  [A. Costa]
27882         Note block size used by /proc/partitions
27883             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=666972
27884     Michael Kerrisk
27885         Add rationale on drop_caches and note that it can hurt performance
27886             See also http://lwn.net/Articles/562211/
27887
27888 bootparam.7
27889     Michael Kerrisk  [Eugen Dedu]
27890         Remove "lilo" entries from SEE ALSO
27891             See http://bugs.debian.org/604019
27892
27893 inotify.7
27894     Michael Kerrisk
27895         SEE ALSO: add inotifywait(1) and inotifywatch(1)
27896
27897 ip.7
27898     Simon Paillard
27899         IP_MULTICAST_IF setsockopt recognizes struct mreq (compatibility)
27900             Kernel added compatibility only recently in
27901             3a084ddb4bf299a6e898a9a07c89f3917f0713f7
27902             See: http://bugs.debian.org/607979
27903
27904 standards.7
27905     Michael Kerrisk
27906         Add mention of SUSv4-TC1 (POSIX.1-2013)
27907
27908
27909 ==================== Changes in man-pages-3.55 ====================
27910
27911 Released: 2013-12-12, Christchurch
27912
27913
27914 Contributors
27915 ------------
27916
27917 The following people contributed patches/fixes or (noted in brackets
27918 in the changelog below) reports, notes, and ideas that have been
27919 incorporated in changes in this release:
27920
27921 Alfred Agrell <alfred@agrell.info>
27922 Andreas Sandberg <andreas.sandberg@it.uu.se>
27923 Christoph Hellwig <hch@infradead.org>
27924 David Gibson <david@gibson.dropbear.id.au>
27925 David Prévot <taffit@debian.org>
27926 Fabrice Bauzac <libnoon@gmail.com>
27927 Greg Price <price@mit.edu>
27928 Jon Grant <jg@jguk.org>
27929 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
27930 Liu Jiaming <storypku@gmail.com>
27931 Maxin B. John <maxin.john@enea.com>
27932 Michael Kerrisk <mtk.manpages@gmail.com>
27933 Paolo Bonzini <bonzini@gnu.org>
27934 Peng Haitao <penght@cn.fujitsu.com>
27935 Robert P. J. Day <rpjday@crashcourse.ca>
27936 Rodrigo Campos <rodrigo@sdfg.com.ar>
27937 Shawn Landden <shawn@churchofgit.com>
27938 Trevor Bramwell <trevor@bramwell.net>
27939 Vince Weaver <vincent.weaver@maine.edu>
27940 Yang Yang <yangyang.gnu@gmail.com>
27941 Yuanhang Zheng <zhengyhn@gmail.com>
27942 Yuri Kozlov <yuray@komyakino.ru>
27943 janh <a0vhv@t-online.de>
27944
27945 Apologies if I missed anyone!
27946
27947
27948 Global changes
27949 --------------
27950
27951 assert.3
27952 assert_perror.3
27953 rexec.3
27954 rpc.3
27955     Michael Kerrisk  [Jon Grant]
27956         Reword a sentence to use more gender-neutral language
27957
27958
27959 Changes to individual pages
27960 ---------------------------
27961
27962 execve.2
27963     Michael Kerrisk
27964         'arg...' for interpreter scripts starts with argv[1]
27965
27966 fallocate.2
27967     Christoph Hellwig
27968         Clarify the zeroing behavior
27969             fallocate() zeroes only space that did not previously contain
27970             data, but leaves existing data untouched.
27971
27972 futex.2
27973     Rodrigo Campos
27974         Fix link to Rusty's futex example library
27975             When I asked to webmaster@kernel.org, Konstantin Ryabitsev
27976             answered that the ".nl." is "an obsolete scheme and really
27977             should be changed to just ftp.kernel.org".
27978
27979 getgroups.2
27980     Michael Kerrisk
27981         Note that NGROUPS_MAX is defined in <limits.h>
27982     Michael Kerrisk
27983         Clarify that sysconf(_SC_NGROUPS_MAX) is a run-time technique
27984     Michael Kerrisk
27985         Document /proc/sys/kernel/ngroups_max
27986
27987 ioctl.2
27988     Michael Kerrisk  [KOSAKI Motohiro, David Gibson]
27989         'request' argument is typed as 'unsigned long' in glibc
27990             See https://bugzilla.kernel.org/show_bug.cgi?id=42705
27991
27992 perf_event_open.2
27993     Vince Weaver
27994         Linux 3.12 rdpmc/mmap
27995             It turns out that the perf_event mmap page rdpmc/time setting was
27996             broken, dating back to the introduction of the feature.  Due
27997             to a mistake with a bitfield, two different values mapped to
27998             the same feature bit.
27999
28000             A new somewhat backwards compatible interface was introduced
28001             in Linux 3.12.  A much longer report on the issue can be found
28002             here:
28003                https://lwn.net/Articles/567894/
28004     Vince Weaver
28005         Linux 3.12 adds PERF_SAMPLE_IDENTIFIER
28006             A new PERF_SAMPLE_IDENTIFIER sample type was added in Linux 3.12.
28007     Vince Weaver
28008         E2BIG documentation
28009             The following documents the E2BIG error return for
28010             perf_event_open().
28011
28012             I actually ran into this error the hard way and it took me
28013             half a day to figure out why my ->size value was changing.
28014     Vince Weaver
28015         Linux 3.12 adds PERF_EVENT_IOC_ID
28016             A new perf_event related ioctl, PERF_EVENT_IOC_ID, was added
28017             in Linux 3.12.
28018     Vince Weaver
28019         PERF_COUNT_SW_DUMMY support
28020             Support for the PERF_COUNT_SW_DUMMY event type was added in
28021             Linux 3.12.
28022     Vince Weaver  [Andreas Sandberg]
28023         PERF_EVENT_IOC_PERIOD update
28024             The PERF_EVENT_IOC_PERIOD ioctl was broken until 2.6.36,
28025             and it turns out that the ARM architecture has some
28026             differing behavior too.
28027
28028 pipe.2
28029     Trevor Bramwell
28030         Fix error in example program
28031
28032 poll.2
28033     Michael Kerrisk  [Paolo Bonzini]
28034         Clarify meaning of events==0
28035             events==0 does not mean that revents is always returned as
28036             zero. The "output only" events (POLLHUP, POLLERR, POLLNVAL)
28037             can still be returned.
28038
28039             See https://bugzilla.kernel.org/show_bug.cgi?id=61911
28040
28041 readlink.2
28042     Michael Kerrisk  [Yuanhang Zheng]
28043         Fix typo in error message in example program
28044
28045 recv.2
28046     Michael Kerrisk
28047         Remove out-of-date statement that UNIX domain does not support MSG_TRUNC
28048             Should have removed that sentence as part of
28049             commit a25601b48b822eb1882ae336574b8d062a17e564
28050
28051 sched_get_priority_max.2
28052     Michael Kerrisk
28053         Add SCHED_IDLE to discussion
28054
28055 send.2
28056     Michael Kerrisk
28057         RETURN VALUE: these calls return number of bytes (not characters) sent
28058
28059 setreuid.2
28060     Michael Kerrisk
28061         Small clarification to description of when saved set-user-ID is set
28062
28063 sigpending.2
28064     Michael Kerrisk
28065         Note treatment of signals that are blocked *and* ignored
28066
28067 stat.2
28068     Michael Kerrisk
28069         Note filesystem support for nanosecond timestamps
28070             Add some detail on which native filesystems do and don't
28071             support nanosecond timestamps.
28072     Michael Kerrisk
28073         Cosmetic reworking of timestamp discussion in NOTES
28074     Michael Kerrisk  [Yang Yang]
28075         Update discussion of nanosecond timestamps
28076             The existing text describes the timestamp fields as 'time_t'
28077             and delegates discussion of nanosecond timestamps under NOTES.
28078             Nanosecond timestamps have been around for a while now,
28079             and are in POSIX.1-2008, so reverse the orientation of the
28080             discussion, putting the nanosecond fields into DESCRIPTION
28081             and detailing the historical situation under NOTES.
28082
28083 symlink.2
28084     Michael Kerrisk
28085         Further fine tuning of argument names
28086             Follow-up to f2ae6dde0c68448bec986d12fe32268a2c98bfd9
28087             See https://sourceware.org/bugzilla/show_bug.cgi?id=16073
28088     Michael Kerrisk  [Fabrice Bauzac]
28089         Give arguments of symlink() more meaningful names
28090
28091 adjtime.3
28092     Peng Haitao
28093         ATTRIBUTES: Note function that is thread-safe
28094             The function adjtime() is thread safe.
28095
28096 alloca.3
28097     Peng Haitao
28098         ATTRIBUTES: Note function that is thread-safe
28099             The function alloca() is thread safe.
28100
28101 asinh.3
28102     Peng Haitao
28103         ATTRIBUTES: Note functions that are thread-safe
28104             The functions asinh(), asinhf() and asinhl() are thread safe.
28105
28106 atan.3
28107     Peng Haitao
28108         ATTRIBUTES: Note functions that are thread-safe
28109             The functions atan(), atanf() and atanl() are thread safe.
28110
28111 atof.3
28112     Peng Haitao
28113         ATTRIBUTES: Note function that is thread safe with exceptions
28114             The function atof() is thread safe with exceptions.
28115
28116 atoi.3
28117     Peng Haitao
28118         ATTRIBUTES: Note functions that are thread safe with exceptions
28119             The functions atoi(), atol() and atoll() are thread safe with
28120             exceptions.
28121
28122 bcmp.3
28123     Peng Haitao
28124         ATTRIBUTES: Note function that is thread-safe
28125             The function bcmp() is thread safe.
28126
28127 bcopy.3
28128     Peng Haitao
28129         ATTRIBUTES: Note function that is thread-safe
28130             The function bcopy() is thread safe.
28131
28132 bsd_signal.3
28133     Peng Haitao
28134         ATTRIBUTES: Note function that is thread-safe
28135             The function bsd_signal() is thread safe.
28136
28137 bzero.3
28138     Peng Haitao
28139         ATTRIBUTES: Note function that is thread-safe
28140             The function bzero() is thread safe.
28141
28142 cbrt.3
28143     Peng Haitao
28144         ATTRIBUTES: Note functions that are thread-safe
28145             The functions cbrt(), cbrtf() and cbrtl() are thread safe.
28146
28147 copysign.3
28148     Peng Haitao
28149         ATTRIBUTES: Note functions that are thread-safe
28150             The functions copysign(), copysignf() and copysignl() are thread
28151             safe.
28152
28153 cos.3
28154     Peng Haitao
28155         ATTRIBUTES: Note functions that are thread-safe
28156             The functions cos(), cosf() and cosl() are thread safe.
28157
28158 cproj.3
28159     Peng Haitao
28160         ATTRIBUTES: Note functions that are thread-safe
28161             The functions cproj(), cprojf() and cprojl() are thread safe.
28162
28163 creal.3
28164     Peng Haitao
28165         ATTRIBUTES: Note functions that are thread-safe
28166             The functions creal(), crealf() and creall() are thread safe.
28167
28168 daemon.3
28169     Peng Haitao
28170         ATTRIBUTES: Note function that is thread-safe
28171             The function daemon() is thread safe.
28172
28173 des_crypt.3
28174     Peng Haitao
28175         ATTRIBUTES: Note functions that are thread-safe
28176             The functions ecb_crypt(), cbc_crypt() and des_setparity() are
28177             thread safe.
28178
28179 difftime.3
28180     Peng Haitao
28181         ATTRIBUTES: Note function that is thread-safe
28182             The function difftime() is thread safe.
28183
28184 dysize.3
28185     Peng Haitao
28186         ATTRIBUTES: Note function that is thread-safe
28187             The function dysize() is thread safe.
28188
28189 erf.3
28190     Peng Haitao
28191         ATTRIBUTES: Note functions that are thread-safe
28192             The functions erf(), erff() and erfl() are thread safe.
28193
28194 erfc.3
28195     Peng Haitao
28196         ATTRIBUTES: Note functions that are thread-safe
28197             The functions erfc(), erfcf() and erfcl() are thread safe.
28198
28199 euidaccess.3
28200     Peng Haitao
28201         ATTRIBUTES: Note functions that are thread-safe
28202             The functions euidaccess() and eaccess() are thread safe.
28203
28204 expm1.3
28205     Peng Haitao
28206         ATTRIBUTES: Note functions that are thread-safe
28207             The functions expm1(), expm1f() and expm1l() are thread safe.
28208
28209 fexecve.3
28210     Michael Kerrisk
28211         POSIX.1-2008 specifies fexecve()
28212     Michael Kerrisk
28213         Explain the use and rationale of fexecve()
28214
28215 ftime.3
28216     Peng Haitao
28217         ATTRIBUTES: Note function that is thread-safe
28218             The function ftime() is thread safe.
28219
28220 ftok.3
28221     Peng Haitao
28222         ATTRIBUTES: Note function that is thread-safe
28223             The function ftok() is thread safe.
28224
28225 ftw.3
28226     Michael Kerrisk
28227         nftw() visits directories with FTW_D if FTW_DEPTH was not specified
28228     Michael Kerrisk
28229         Explain probable cause of FTW_NS
28230
28231 futimes.3
28232     Peng Haitao
28233         ATTRIBUTES: Note functions that are thread-safe
28234             The functions futimes() and lutimes() are thread safe.
28235
28236 getaddrinfo.3
28237     Michael Kerrisk
28238         Explain one use case for AI_ADDRCONFIG
28239     Michael Kerrisk
28240         Highlight difference in ai_flags when hints==NULL
28241             NOTES already described how glibc differs from POSIX.
28242             Add a pointer to that text from the point in DESCRIPTION
28243             where hints==NULL is discussed.
28244
28245 kcmp.3
28246     Shawn Landden
28247         Reword slightly awkward section
28248
28249 malloc.3
28250     Greg Price
28251         Scale back promises of alignment
28252             It's not true that the return value is suitably aligned for "any
28253             variable"; for example, it's unsuitable for a variable like
28254               float *x __attribute__ ((__vector_size__ (32)));
28255             which requires 32-byte alignment.  Types like this are defined in
28256             <avxintrin.h>, and with 16-byte alignment in <emmintrin.h> and
28257             <xmmintrin.h>, so the application programmer need not even know
28258             that a vector_size attribute has been applied.
28259
28260             On an x86 architecture, a program that loads from or stores to a
28261             pointer with this type derived from malloc can crash because GCC
28262             generates an aligned load/store, like MOVDQA.
28263
28264             The C99 standard (TC3, as of N1256) does say the return value is
28265             suitably aligned for "any type of object".  The C11 standard (as
28266             of N1570) revises this to any type with "fundamental alignment",
28267             which means an alignment "supported by the implementation in all
28268             contexts", which I suppose tautologically includes aligning
28269             malloc/realloc return values.
28270
28271             The actual behavior of current glibc malloc is to align to the
28272             greater of 2 * sizeof(size_t) and __alignof__ (long double),
28273             which may be one bit greater than this commit promises.
28274
28275 mq_receive.3
28276     Michael Kerrisk  [janh]
28277         msg_len must be greater than *or equal to* mq_msgsize
28278             See https://bugzilla.kernel.org/show_bug.cgi?id=64571
28279
28280 setenv.3
28281     Michael Kerrisk
28282         Clarify that setenv() returns success in the overwrite==0 case
28283
28284 sigsetops.3
28285     Michael Kerrisk  [Robert P. J. Day]
28286         Add 'const' to sigisemptyset(), sigorset(), sigandset() declarations
28287     Michael Kerrisk
28288         Rework text describing sigisemptyset(), sigorset(), and sigandset()
28289
28290 statvfs.3
28291     Peng Haitao
28292         ATTRIBUTES: Note functions that are thread-safe
28293             The functions statvfs() and fstatvfs() are thread safe.
28294
28295 stdarg.3
28296     Peng Haitao
28297         ATTRIBUTES: Note macros that are thread-safe
28298             The macros va_start(), va_arg(), va_end() and va_copy() are
28299             thread safe.
28300
28301 termios.3
28302     Peng Haitao
28303         ATTRIBUTES: Note functions that are thread-safe
28304             The functions tcgetattr(), tcsetattr(), tcsendbreak(),
28305             tcdrain(), tcflush(), tcflow(), cfmakeraw(), cfgetispeed(),
28306             cfgetospeed(), cfsetispeed(), cfsetospeed() and cfsetspeed()
28307             are thread safe.
28308
28309 ungetwc.3
28310     Peng Haitao
28311         ATTRIBUTES: Note function that is thread-safe
28312             The function ungetwc() is thread safe.
28313
28314 unlockpt.3
28315     Peng Haitao
28316         ATTRIBUTES: Note function that is thread-safe
28317             The function unlockpt() is thread safe.
28318
28319 usleep.3
28320     Peng Haitao
28321         ATTRIBUTES: Note function that is thread-safe
28322             The function usleep() is thread safe.
28323
28324 wcpcpy.3
28325     Peng Haitao
28326         ATTRIBUTES: Note function that is thread-safe
28327             The function wcpcpy() is thread safe.
28328
28329 wcscasecmp.3
28330     Peng Haitao
28331         ATTRIBUTES: Note function that is thread safe with exceptions
28332             The function wcscasecmp() is thread safe with exceptions.
28333
28334 wcscat.3
28335     Peng Haitao
28336         ATTRIBUTES: Note function that is thread-safe
28337             The function wcscat() is thread safe.
28338
28339 wcschr.3
28340     Peng Haitao
28341         ATTRIBUTES: Note function that is thread-safe
28342             The function wcschr() is thread safe.
28343
28344 wcscmp.3
28345     Peng Haitao
28346         ATTRIBUTES: Note function that is thread-safe
28347             The function wcscmp() is thread safe.
28348
28349 wcscpy.3
28350     Peng Haitao
28351         ATTRIBUTES: Note function that is thread-safe
28352             The function wcscpy() is thread safe.
28353
28354 wcscspn.3
28355     Peng Haitao
28356         ATTRIBUTES: Note function that is thread-safe
28357             The function wcscspn() is thread safe.
28358
28359 wcslen.3
28360     Peng Haitao
28361         ATTRIBUTES: Note function that is thread-safe
28362             The function wcslen() is thread safe.
28363
28364 wcsncasecmp.3
28365     Peng Haitao
28366         ATTRIBUTES: Note function that is thread safe with exceptions
28367             The function wcsncasecmp() is thread safe with exceptions.
28368
28369 wcsncat.3
28370     Peng Haitao
28371         ATTRIBUTES: Note function that is thread-safe
28372             The function wcsncat() is thread safe.
28373
28374 wcsncmp.3
28375     Peng Haitao
28376         ATTRIBUTES: Note function that is thread-safe
28377             The function wcsncmp() is thread safe.
28378
28379 wcsncpy.3
28380     Peng Haitao
28381         ATTRIBUTES: Note function that is thread-safe
28382             The function wcsncpy() is thread safe.
28383
28384 wcsnlen.3
28385     Peng Haitao
28386         ATTRIBUTES: Note function that is thread-safe
28387             The function wcsnlen() is thread safe.
28388
28389 wcspbrk.3
28390     Peng Haitao
28391         ATTRIBUTES: Note function that is thread-safe
28392             The function wcspbrk() is thread safe.
28393
28394 wcsrchr.3
28395     Peng Haitao
28396         ATTRIBUTES: Note function that is thread-safe
28397             The function wcsrchr() is thread safe.
28398
28399 wcsspn.3
28400     Peng Haitao
28401         ATTRIBUTES: Note function that is thread-safe
28402             The function wcsspn() is thread safe.
28403
28404 wcsstr.3
28405     Peng Haitao
28406         ATTRIBUTES: Note function that is thread-safe
28407             The function wcsstr() is thread safe.
28408
28409 wcstoimax.3
28410     Peng Haitao
28411         ATTRIBUTES: Note functions that are thread safe with exceptions
28412             The functions wcstoimax() and wcstoumax() are thread safe with
28413             exceptions.
28414
28415 wcstok.3
28416     Peng Haitao
28417         ATTRIBUTES: Note function that is thread-safe
28418             The function wcstok() is thread safe.
28419
28420 wcswidth.3
28421     Peng Haitao
28422         ATTRIBUTES: Note function that is thread safe with exceptions
28423             The function wcswidth() is thread safe with exceptions.
28424
28425 wctrans.3
28426     Peng Haitao
28427         ATTRIBUTES: Note function that is thread safe with exceptions
28428             The function wctrans() is thread safe with exceptions.
28429
28430 wctype.3
28431     Peng Haitao
28432         ATTRIBUTES: Note function that is thread safe with exceptions
28433             The function wctype() is thread safe with exceptions.
28434
28435 wcwidth.3
28436     Peng Haitao
28437         ATTRIBUTES: Note function that is thread safe with exceptions
28438             The function wcwidth() is thread safe with exceptions.
28439
28440 wmemchr.3
28441     Peng Haitao
28442         ATTRIBUTES: Note function that is thread-safe
28443             The function wmemchr() is thread safe.
28444
28445 wmemcmp.3
28446     Peng Haitao
28447         ATTRIBUTES: Note function that is thread-safe
28448             The function wmemcmp() is thread safe.
28449
28450 wmemcpy.3
28451     Peng Haitao
28452         ATTRIBUTES: Note function that is thread-safe
28453             The function wmemcpy() is thread safe.
28454
28455 wmemmove.3
28456     Peng Haitao
28457         ATTRIBUTES: Note function that is thread-safe
28458             The function wmemmove() is thread safe.
28459
28460 wmemset.3
28461     Peng Haitao
28462         ATTRIBUTES: Note function that is thread-safe
28463             The function wmemset() is thread safe.
28464
28465 tty_ioctl.4
28466     Michael Kerrisk  [Liu Jiaming]
28467         Note that 'arg' should be 0 in the usual case when using TIOCSCTTY
28468     Michael Kerrisk
28469         Rework text on root to discuss just in terms of capabilities
28470
28471 proc.5
28472     Michael Kerrisk
28473         Document /proc/sys/kernel/ngroups_max
28474
28475 capabilities.7
28476     Michael Kerrisk
28477         Fix 2 version numbers under "Effect of user ID changes on capabilities"
28478
28479 feature_test_macros.7
28480     Michael Kerrisk
28481         Add _ISOC11_SOURCE to example program
28482
28483 tcp.7
28484     Michael Kerrisk
28485         Fix (nontrivial) wordo in discussion of MSG_TRUNC
28486             s/MSG_PEEK/MSG_TRUNC/
28487
28488 ld.so.8
28489     Michael Kerrisk  [Alfred Agrell]
28490         Fix crufty wording in one sentence
28491
28492
28493 ==================== Changes in man-pages-3.56 ====================
28494
28495 Released: 2014-01-11, Christchurch
28496
28497 In memory of Doris Church (1939-2013)
28498
28499
28500 Contributors
28501 ------------
28502
28503 The following people contributed patches/fixes or (noted in brackets
28504 in the changelog below) reports, notes, and ideas that have been
28505 incorporated in changes in this release:
28506
28507 Andre Majorel <aym-xunil@teaser.fr>
28508 Arif Zaman <arifz@lums.edu.pk>
28509 Bert Wesarg <bert.wesarg@googlemail.com>
28510 Daniel Borkmann <dborkman@redhat.com>
28511 David Malcolm <dmalcolm@redhat.com>
28512 David Prévot <taffit@debian.org>
28513 Dongsheng Song <dongsheng.song@gmail.com>
28514 Elie De Brauwer <eliedebrauwer@gmail.com>
28515 James Smith <james@theta.pw>
28516 Janne Blomqvist <blomqvist.janne@gmail.com>
28517 Joseph S. Myers <joseph@codesourcery.com>
28518 Luke Hutchison <luke.hutch@mit.edu>
28519 Marco Dione <mdione@grulic.org.ar>
28520 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
28521 Mathieu Malaterre <malat@debian.org>
28522 Matthias Klose <doko@debian.org>
28523 Michael Kerrisk <mtk.manpages@gmail.com>
28524 Mike Frysinger <vapier@gentoo.org>
28525 Moritz 'Morty' Strübe <morty@gmx.net>
28526 Nadav Har'El <nyh@math.technion.ac.il>
28527 Ondřej Bílka <neleai@seznam.cz>
28528 Prádraig Brady <P@draigBrady.com>
28529 Peng Haitao <penght@cn.fujitsu.com>
28530 Raphael Geissert <geissert@debian.org>
28531 Shawn Landden <shawn@churchofgit.com>
28532 Simon Paillard <spaillard@debian.org>
28533 Stephen Kell <srk31@srcf.ucam.org>
28534 Sudhanshu Goswami <Sudhanshu.Goswami@emc.com>
28535 Sworddragon2 <sworddragon2@aol.com>
28536 Vince Weaver <vincent.weaver@maine.edu>
28537 Willem de Bruijn <willemb@google.com>
28538 Yuri Kozlov <yuray@komyakino.ru>
28539
28540 Apologies if I missed anyone!
28541
28542
28543 New and rewritten pages
28544 -----------------------
28545
28546 fgetc.3
28547 gets.3
28548     David Malcolm
28549         Split gets(3) to isolate unsafe gets(3) to a page on its own
28550             Currently man3/gets.3 documents various safe I/O functions, along
28551             with the toxic "gets" function.
28552
28553             At the risk of being melodramatic, this strikes me as akin to
28554             storing rat poison in a food cabinet, in the same style of
28555             packaging as the food, but with a post-it note on it saying
28556             "see warnings below".
28557
28558             I think such "never use this" functions should be quarantined
28559             into their own manpages, rather than listing them alongside
28560             sane functions.
28561
28562             The attached patch does this for "gets", moving the documentation
28563             of the good functions from man3/gets.3 into man3/fgetc.3,
28564             updating the SO links in the relevant functions to point at the
28565             latter.
28566
28567             It then rewrites man3/gets.3 to spell out that "gets" is toxic
28568             and should never be used (with a link to CWE-242 for good
28569             measure).
28570     Michael Kerrisk  [Andre Majorel]
28571         Tweaks to David Malcolm's patch
28572
28573 vdso.7
28574     Mike Frysinger
28575         New page documenting the vDSO mapped into each process by the kernel
28576
28577
28578 Newly documented interfaces in existing pages
28579 ---------------------------------------------
28580
28581 reboot.2
28582     Elie De Brauwer
28583         Document LINUX_REBOOT_SW_SUSPEND
28584
28585
28586 New and changed links
28587 ---------------------
28588
28589 fgets.3
28590 getc.3
28591 getchar.3
28592 ungetc.3
28593     Michael Kerrisk
28594         Adjust links to gets(3) to point to fgetc(3)
28595
28596
28597 Global changes
28598 --------------
28599
28600 Various pages
28601     Michael Kerrisk
28602         Global fix of "NULL pointer"
28603             Change "NULL pointer" to "NULL" or null pointer".
28604             POSIX uses the term "null pointer", not "NULL pointer".
28605
28606 Various pages
28607     Michael Kerrisk
28608         Stylistic changes to code example
28609             For ease of reading, don't embed assignments inside if().
28610
28611 Various pages
28612     Michael Kerrisk
28613         Replace uses of "i.e.," in main text with "that is" or similar
28614             Usual man-pages style is to use "i.e." only within
28615             parenthetical expressions.
28616
28617 Various pages
28618     Michael Kerrisk
28619         Replace uses of "e.g." in main text with "for example" or similar
28620                 Usual man-pages style is to use "e.g." only within
28621                 parenthetical expressions.
28622
28623 Various pages
28624     Michael Kerrisk
28625         Add "Program source" subheading under EXAMPLE
28626
28627 Various pages
28628     Michael Kerrisk
28629         Add "static" to global variables and functions in example program
28630
28631
28632 Changes to individual pages
28633 ---------------------------
28634
28635 clock_getres.2
28636     Michael Kerrisk  [Nadav Har'El]
28637         Improve description of CLOCK_PROCESS_CPUTIME_ID
28638             See https://bugzilla.kernel.org/show_bug.cgi?id=67291
28639
28640 close.2
28641     Michael Kerrisk  [P?draig Brady]
28642         Note that errors from close() should be used only for diagnosis
28643             In particular, retrying after EINTR is a bad idea.
28644
28645             See http://austingroupbugs.net/view.php?id=529
28646
28647             See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/37702
28648             Subject: [RFC][BZ #14627] Make linux close errno to EINPROGRESS
28649                      when interrupted in signal.
28650
28651 execve.2
28652     Michael Kerrisk  [Marco Dione]
28653         Add further cases to EFAULT error
28654             See https://sourceware.org/bugzilla/show_bug.cgi?id=16402
28655
28656 perf_event_open.2
28657     Vince Weaver  [Sudhanshu Goswami]
28658         Clarify issues with the disabled bit
28659             Clarify the perf_event_open behavior with respect to the disabled
28660             bit and creating event groups.
28661     Vince Weaver  [Sudhanshu Goswami]
28662         Clarify issues with the exclusive bit
28663             Warn that using the perf_event_open "exclusive" bit, while
28664             it might seem like a good idea, might lead to all 0 results
28665             in some common usage cases.
28666
28667 reboot.2
28668     Elie De Brauwer
28669         Mention RB_POWER_OFF
28670             The manpage did not mention RB_POWER_OFF which is the glibc
28671             symbolic name for LINUX_REBOOT_CMD_POWER_OFF.
28672
28673             $ cd /usr/include
28674             $ cat x86_64-linux-gnu/sys/reboot.h | grep POWER_OFF
28675              define RB_POWER_OFF        0x4321fedc
28676     Elie De Brauwer
28677         Add "Linux" to kernel version numbers
28678     Michael Kerrisk
28679         Add RB_SW_SUSPEND synonym
28680     Michael Kerrisk
28681         Add RB_KEXEC synonym
28682
28683 setpgid.2
28684     Michael Kerrisk  [Joseph S. Myers]
28685         BSD getpgrp() and setpgrp() go away in glibc 2.19
28686
28687 socket.2
28688     Michael Kerrisk  [Dongsheng Song]
28689         Remove crufty statement that AF_INET does not support SOCK_SEQPACKET
28690             Linux AF_INET supports SOCK_SEQPACKET via SCTP.
28691
28692 syscall.2
28693     Mike Frysinger
28694         Fix ia64 registers
28695             The original list of registers was created by confusing strace
28696             source code--this is for parsing legacy 32-bit code (which is
28697             dead and no one cares). Update the list to reflect native ia64
28698             syscall interface.
28699
28700 syscall.2
28701 syscalls.2
28702 getauxval.3
28703     Mike Frysinger
28704         Add references to new vdso(7) page
28705
28706 utimensat.2
28707     Michael Kerrisk
28708         Small wording improvement for times!=NULL case
28709
28710 dlopen.3
28711     Michael Kerrisk  [Mike Frysinger]
28712         Update remarks on cast needed when assigning dlsym() return value
28713             POSIX.1-2013 eases life when casting the dlsym() return value to a
28714             function pointer
28715     Michael Kerrisk  [Stephen Kell]
28716         Fix description of dli_sname
28717             See https://sourceware.org/bugzilla/show_bug.cgi?id=16262
28718
28719 getline.3
28720     Michael Kerrisk  [Luke Hutchison]
28721         Correct description of how '*n' is used when '*lineptr' == NULL
28722             See https://sourceware.org/bugzilla/show_bug.cgi?id=5468
28723     Michael Kerrisk
28724         Remove SEE ALSO reference to unsafe gets(3)
28725
28726 mcheck.3
28727     Simon Paillard  [Raphael Geissert]
28728         typo in compiler flag
28729             See http://bugs.debian.org/732464
28730
28731 mkstemp.3
28732     Michael Kerrisk  [Janne Blomqvist]
28733         Better describe 'flags' that can be specified for mkostemp()
28734
28735 printf.3
28736     Michael Kerrisk  [Arif Zaman]
28737         Fix memory leak in snprintf() example
28738             See http://stackoverflow.com/questions/19933479/snprintf-man-page-example-memory-leak
28739
28740 pthread_kill.3
28741     Michael Kerrisk  [Mathieu Desnoyers]
28742         POSIX.1-2008 removes ESRCH
28743             POSIX.1-2001 mistakenly documented an ESRCH error, and
28744             POSIX.1-2008 removes this error. Glibc does return
28745             this error in cases where it can determine that a thread ID
28746             is invalid, but equally, the use of an invalid thread ID
28747             can cause a segmentation fault.
28748
28749 puts.3
28750     Michael Kerrisk
28751         SEE ALSO: replace reference to gets(3) with fgets(3)
28752
28753 scanf.3
28754     Michael Kerrisk  [Ondřej Bílka]
28755         Improve discussion of obsolete 'a' dynamic allocation modifier
28756
28757 setjmp.3
28758     Michael Kerrisk  [Joseph S. Myers]
28759         BSD setjmp() semantics go away in glibc 2.19
28760
28761 sigpause.3
28762     Michael Kerrisk  [Joseph S. Myers]
28763         BSD sigpause() goes away in glibc 2.19
28764     Michael Kerrisk
28765         Correct feature text macro requirements
28766     Peng Haitao
28767         ATTRIBUTES: Note function that is thread-safe
28768             The function sigpause() is thread safe.
28769
28770 sigqueue.3
28771     Peng Haitao
28772         ATTRIBUTES: Note function that is thread-safe
28773             The function sigqueue() is thread safe.
28774
28775 sigwait.3
28776     Peng Haitao
28777         ATTRIBUTES: Note function that is thread-safe
28778             The function sigwait() is thread safe.
28779
28780 sin.3
28781     Peng Haitao
28782         ATTRIBUTES: Note functions that are thread-safe
28783             The functions sin(), sinf() and sinl() are thread safe.
28784
28785 sincos.3
28786     Peng Haitao
28787         ATTRIBUTES: Note functions that are thread-safe
28788             The functions sincos(), sincosf() and sincosl() are thread safe.
28789
28790 string.3
28791     Moritz 'Morty' Strübe
28792         Add short description of the functions
28793             It is helpful to have a short description about what the different
28794             functions in string.h do.
28795     Michael Kerrisk
28796         Fixes and enhancements to Moritz Strübe's patch
28797
28798 strptime.3
28799     Michael Kerrisk  [Mathieu Malaterre, Simon Paillard]
28800         Add number ranges to comments in 'tm' structure
28801             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729570
28802     Michael Kerrisk
28803         Point to ctime(3) for more details on 'tm' structure
28804     Michael Kerrisk
28805         Some rewording and reorganization
28806
28807 strsep.3
28808     Michael Kerrisk
28809         Clarify description
28810             The use of "symbols" in the existing description is confusing;
28811             it's "bytes". Other fixes as well.
28812
28813 strspn.3
28814     Michael Kerrisk  [Mathieu Malaterre]
28815         Improve description in NAME
28816             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=723659
28817
28818 strstr.3
28819     Michael Kerrisk
28820         Clarify RETURN VALUE: s/substring/located substring/
28821
28822 sysv_signal.3
28823     Peng Haitao
28824         ATTRIBUTES: Note function that is thread-safe
28825             The function sysv_signal() is thread safe.
28826
28827 tan.3
28828     Peng Haitao
28829         ATTRIBUTES: Note functions that are thread-safe
28830             The functions tan(), tanf() and tanl() are thread safe.
28831
28832 tanh.3
28833     Peng Haitao
28834         ATTRIBUTES: Note functions that are thread-safe
28835             The functions tanh(), tanhf() and tanhl() are thread safe.
28836
28837 toascii.3
28838     Peng Haitao
28839         ATTRIBUTES: Note function that is thread-safe
28840             The function toascii() is thread safe.
28841
28842 toupper.3
28843     Peng Haitao
28844         ATTRIBUTES: Note functions that are thread safe with exceptions
28845             The functions toupper() and tolower() are thread safe with
28846             exceptions.
28847
28848 towctrans.3
28849     Peng Haitao
28850         ATTRIBUTES: Note function that is thread-safe
28851             The function towctrans() is thread safe.
28852
28853 towlower.3
28854     Peng Haitao
28855         ATTRIBUTES: Note function that is thread safe with exceptions
28856             The function towlower() is thread safe with exceptions.
28857
28858 towupper.3
28859     Peng Haitao
28860         ATTRIBUTES: Note function that is thread safe with exceptions
28861             The function towupper() is thread safe with exceptions.
28862
28863 ualarm.3
28864     Peng Haitao
28865         ATTRIBUTES: Note function that is thread-safe
28866             The function ualarm() is thread safe.
28867
28868 wcpncpy.3
28869     Peng Haitao
28870         ATTRIBUTES: Note function that is thread-safe
28871             The function wcpncpy() is thread safe.
28872
28873 proc.5
28874     Michael Kerrisk  [Sworddragon2]
28875         Fix formula for CommitLimit under /proc/meminfo
28876             See https://bugzilla.kernel.org/show_bug.cgi?id=60991
28877
28878 credentials.7
28879     Michael Kerrisk
28880         List APIs that operate on process groups
28881     Michael Kerrisk
28882         Add details on controlling terminal and foreground/background jobs
28883
28884 feature_test_macros.7
28885     Michael Kerrisk
28886         Document _DEFAULT_SOURCE
28887     Michael Kerrisk  [Joseph S. Myers]
28888         From glibc 2.19, _BSD_SOURCE no longer causes __FAVOR_BSD
28889             Starting with glibc 2.19, _BSD_SOURCE no longer causes BSD
28890             definitions to be favored in cases where standards conflict.
28891
28892 libc.7
28893     Mike Frysinger
28894         SEE ALSO: add various entries
28895
28896 man-pages.7
28897     Michael Kerrisk  [Mike Frysinger]
28898         Add STYLE GUIDE section
28899             Incorporate some of the existing material in the page
28900             into the STYLE GUIDE, and add a lot more material, mainly
28901             drawn from the "Global changes" sections in the release
28902             changelogs.
28903     Michael Kerrisk
28904         Add historical note on reason for use of American spelling
28905     Michael Kerrisk  [Mike Frysinger]
28906         Various improvements to style guide
28907
28908 packet.7
28909     Willem de Bruijn  [Daniel Borkmann]
28910         Document fanout, ring, and auxiliary options
28911             This patch adds descriptions of the common packet socket options
28912               PACKET_AUXDATA, PACKET_FANOUT, PACKET_RX_RING, PACKET_STATISTICS,
28913               PACKET_TX_RING
28914             and the ring-specific options
28915               PACKET_LOSS, PACKET_RESERVE, PACKET_TIMESTAMP, PACKET_VERSION
28916     Michael Kerrisk
28917         Add kernel version numbers for PACKET_VERSION and PACKET_TIMESTAMP
28918
28919 ld.so.8
28920     Michael Kerrisk  [Matthias Klose]
28921         Default output file for D_DEBUG is stderr not stdout
28922             See https://sourceware.org/bugzilla/show_bug.cgi?id=6874
28923
28924
28925
28926 ==================== Changes in man-pages-3.57 ====================
28927
28928 Released: 2014-01-24, Munich
28929
28930
28931 Contributors
28932 ------------
28933
28934 The following people contributed patches/fixes or (noted in brackets
28935 in the changelog below) reports, notes, and ideas that have been
28936 incorporated in changes in this release:
28937
28938 Andi Kleen <andi@firstfloor.org>
28939 Andre Majorel <aym-xunil@teaser.fr>
28940 Andrey Vagin <avagin@openvz.org>
28941 Andy Lutomirski <luto@amacapital.net>
28942 Axel Beckert <abe@debian.org>
28943 Bernhard Walle <bernhard@bwalle.de>
28944 Brandon Edens <bedens@fitbit.com>
28945 Eliezer Tamir <eliezer.tamir@linux.intel.com>
28946 Gioele Barabucci <gioele@svario.it>
28947 Ian Abbott <abbotti@mev.co.uk>
28948 Jerry Chu <hkchu@google.com>
28949 Jonas Jonsson <jonas@websystem.se>
28950 Marc Lehmann <debian-reportbug@plan9.de>
28951 Michael Kerrisk <mtk.manpages@gmail.com>
28952 Mike Frysinger <vapier@gentoo.org>
28953 Peng Haitao <penght@cn.fujitsu.com>
28954 Reuben Thomas <rrt@sc3d.org>
28955 Simone Piccardi <piccardi@truelite.it>
28956 Simon Paillard <spaillard@debian.org>
28957 Thomas Posch <man-pages@online.posch.name>
28958 Tilman Schmidt <tilman@imap.cc>
28959 Vince Weaver <vincent.weaver@maine.edu>
28960 Yuri Kozlov <yuray@komyakino.ru>
28961 Марк Коренберг <socketpair@gmail.com>
28962
28963 Apologies if I missed anyone!
28964
28965
28966 Newly documented interfaces in existing pages
28967 ---------------------------------------------
28968
28969 msgop.2
28970     Michael Kerrisk
28971         Document MSG_COPY
28972
28973 open.2
28974     Michael Kerrisk, Andy Lutomirski
28975         Document O_TMPFILE
28976             O_TMPFILE is new in Linux 3.11
28977
28978 perf_event_open.2
28979     Vince Weaver  [Andi Kleen]
28980         PERF_SAMPLE_TRANSACTION support in Linux 3.13
28981             The following patch adds descriptions of the new perf_event_open.2
28982             PERF_SAMPLE_TRANSACTION sample type as added in Linux 3.13.
28983
28984             The descriptions are based on information provided by Andi Kleen,
28985             both in the e-mail
28986
28987                 [PATCH 1/6] perf, core: Add generic transaction flags v5
28988
28989             sent to the linux-kernel list as well as an e-mail
28990
28991                 [PATCH] Document transaction flags in perf_event_open manpage
28992
28993             sent to the linux-man list.
28994
28995             The implementation is based heavily on the Intel Haswell
28996             processor.  Documentation can be found at this page:
28997             http://software.intel.com/en-us/blogs/2013/05/03/intelr-transactional-synchronization-extensions-intelr-tsx-profiling-with-linux-0
28998             as well as in section 18.11.5.1 of volume 3 of the
28999             Intel 64 and IA-32 Architecture Software Developer's Manual.
29000
29001 ptrace.2
29002     Andrey Vagin
29003         Add description for PTRACE_PEEKSIGINFO
29004             Retrieve signals without removing them from a queue.
29005     Andrey Vagin
29006         Add description for PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
29007             These two commands allow to examine and change mask of blocked
29008             signals.
29009
29010 socket.7
29011     Eliezer Tamir
29012         Add description for SO_BUSY_POLL
29013             Add description for the SO_BUSY_POLL socket option.
29014
29015 tcp.7
29016     Michael Kerrisk  [Jerry Chu]
29017         Document TCP_USER_TIMEOUT
29018             Text slightly adapted from Jerry Chu's (excellent) commit
29019             message (commit dca43c75e7e545694a9dd6288553f55c53e2a3a3).
29020     Michael Kerrisk
29021         Document TCP_CONGESTION
29022
29023
29024 Global changes
29025 --------------
29026
29027 Various pages
29028     Michael Kerrisk
29029         Reword to avoid use of "etc."
29030
29031 Various pages
29032     Peng Haitao  [Andre Majorel]
29033         Make wording around thread-safety and setlocale() more precise
29034
29035 getdate.3
29036 strptime.3
29037 locale.5
29038     Michael Kerrisk
29039         Replace "weekday" with less ambiguous language
29040             Notwithstanding POSIX's use of the term "weekday", in everyday
29041             English, "weekday" is commonly understood to mean a day in the
29042             set [Monday..Friday] (vs one of the "weekend" days).
29043
29044
29045 Changes to individual pages
29046 ---------------------------
29047
29048 epoll_wait.2
29049     Michael Kerrisk  [Jonas Jonsson]
29050         Clarify wording of EINTR error
29051             See https://bugzilla.kernel.org/show_bug.cgi?id=66571
29052
29053 faccessat.2
29054     Michael Kerrisk
29055         Note that the system call takes only three arguments
29056
29057 fallocate.2
29058     Michael Kerrisk
29059         Note filesystems that support  FALLOC_FL_PUNCH_HOLE operation
29060
29061 fcntl.2
29062     Michael Kerrisk
29063         BUGS: The O_SYNC and O_DSYNC flags are not modifiable using F_SETFL
29064     Michael Kerrisk
29065         Add susbsections under BUGS
29066             There's several bugs listed. It's helpful to mark
29067             them separately.
29068     Michael Kerrisk
29069         POSIX.1 specifies F_SETOWN and F_GETOWN for sockets/SIGURG
29070
29071 getrlimit.2
29072     Michael Kerrisk  [Марк Коренберг]
29073         Note that rlim_cur can be set lower than current resource consumption
29074
29075 getsockopt.2
29076     Michael Kerrisk
29077         SEE ALSO: add ip(7) and udp(7)
29078
29079 keyctl.2
29080     Michael Kerrisk
29081         SEE ALSO: mention Documentation/security/keys.txt
29082
29083 linkat.2
29084     Michael Kerrisk
29085         Add ENOENT for O_TMPFILE created with O_EXCL
29086     Michael Kerrisk
29087         ERRORS: Add EINVAL
29088
29089 lseek.2
29090     Michael Kerrisk
29091         Note which filesystems support SEEK_HOLE/SEEK_DATA
29092
29093 msgop.2
29094     Michael Kerrisk
29095         Note that MSG_EXCEPT is Linux-specific
29096
29097 open.2
29098     Michael Kerrisk
29099         Update CONFORMING TO
29100             Add POSIX.1-2008.  Add mention of O_TMPFILE.
29101             Update text on various flags that were added in POSIX.1-2008, and
29102             whose definitions can, since glibc 2.12, be obtained by suitably
29103             defining _POSIX_C_SOURCE or _XOPEN_SOURCE
29104     Michael Kerrisk
29105         Add pointer in description to BUGS, for O_ASYNC limitation
29106     Michael Kerrisk
29107         Remove crufty duplicate text on modifying file status flags
29108
29109 ptrace.2
29110     Michael Kerrisk
29111         Add details to descriptions of PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
29112
29113 select.2
29114     Michael Kerrisk  [Marc Lehmann]
29115         RETURN VALUE: Fix discussion of treatment of file descriptor sets
29116             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=574370
29117
29118 syscalls.2
29119     Michael Kerrisk
29120         Remove madvise1() from main list
29121             madvise1() is one of the system calls that was never
29122             implemented, and listed toward the bottom of the page.
29123
29124 timer_create.2
29125     Michael Kerrisk
29126         Add pointer to proc(5) for info on /proc/[pid]/timers
29127
29128 unlinkat.2
29129     Michael Kerrisk  [Mike Frysinger:]
29130         ERRORS: Add EISDIR
29131             See https://bugzilla.kernel.org/show_bug.cgi?id=29702
29132
29133 ferror.3
29134     Michael Kerrisk
29135         clearerr(), feof(), and ferror() are also POSIX-conformant
29136     Michael Kerrisk  [Reuben Thomas]
29137         CONFORMING TO: add fileno()
29138
29139 gets.3
29140     Ian Abbott
29141         SEE ALSO: add fgets(3)
29142
29143 mq_receive.3
29144 mq_send.3
29145     Michael Kerrisk  [Simone Piccardi]
29146         SYNOPSIS: s/unsigned/unsigned int/
29147
29148 printf.3
29149     Michael Kerrisk
29150         Small reorganization of text in EXAMPLE
29151
29152 rand.3
29153     Michael Kerrisk
29154         s/unsigned/unsigned int/ in example
29155
29156 stpcpy.3
29157     Peng Haitao
29158         ATTRIBUTES: Note function that is thread-safe
29159             The function stpcpy() is thread safe.
29160
29161 stpncpy.3
29162     Peng Haitao
29163         ATTRIBUTES: Note function that is thread-safe
29164             The function stpncpy() is thread safe.
29165
29166 strcat.3
29167     Peng Haitao
29168         ATTRIBUTES: Note functions that are thread-safe
29169             The functions strcat() and strncat() are thread safe.
29170
29171 strchr.3
29172     Peng Haitao
29173         ATTRIBUTES: Note functions that are thread-safe
29174             The functions strchr(), strrchr() and strchrnul() are thread safe.
29175
29176 strcmp.3
29177     Peng Haitao
29178         ATTRIBUTES: Note functions that are thread-safe
29179             The functions strcmp() and strncmp() are thread safe.
29180
29181 strftime.3
29182     Brandon Edens
29183         Change "week day" to "day of week"
29184             See https://bugzilla.kernel.org/show_bug.cgi?id=68861
29185
29186 strstr.3
29187     Peng Haitao
29188         ATTRIBUTES: Note function that is thread safe with exceptions
29189             The function strstr() is thread safe.
29190             The function strcasestr() is thread safe with exceptions.
29191
29192 strtod.3
29193     Peng Haitao
29194         ATTRIBUTES: Note functions that are thread safe with exceptions
29195             The functions strtod(), strtof() and strtold() are thread safe
29196             with exceptions.
29197
29198 strtoimax.3
29199     Peng Haitao
29200         ATTRIBUTES: Note functions that are thread safe with exceptions
29201             The functions strtoimax() and strtoumax() are thread safe with
29202             exceptions.
29203
29204 strtol.3
29205     Peng Haitao
29206         ATTRIBUTES: Note functions that are thread safe with exceptions
29207             The functions strtol(), strtoll() and strtoq() are thread safe
29208             with exceptions.
29209
29210 tcgetpgrp.3
29211     Peng Haitao
29212         ATTRIBUTES: Note functions that are thread-safe
29213             The functions tcgetpgrp() and tcsetpgrp() are thread safe.
29214
29215 tcgetsid.3
29216     Peng Haitao
29217         ATTRIBUTES: Note function that is thread-safe
29218             The function tcgetsid() is thread safe.
29219
29220 core.5
29221     Bernhard Walle
29222         Mention that %E exists since Linux 3.0
29223             '%E' in the 'core_pattern' has been introduced in kernel commit
29224             57cc083ad9e1bfeeb4a0ee831e7bb008c8865bf0 which was included in
29225             version 3.0. Add that information to the manual page.
29226
29227 filesystems.5
29228     Michael Kerrisk  [Axel Beckert]
29229         Add reference to proc(5) for more details on /proc/filesystems
29230             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=735590
29231
29232 locale.5
29233     Michael Kerrisk
29234         SEE ALSO: add locale(7)
29235
29236 proc.5
29237     Michael Kerrisk
29238         Document /proc/[pid]/timers
29239     Michael Kerrisk
29240         Update discussion of wchan
29241             Remove crufty reference to /etc/psdatabase in /proc/PID/stat.
29242             Add /proc/PID/wchan.
29243
29244             See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/737452
29245
29246 environ.7
29247     Michael Kerrisk  [Gioele Barabucci]
29248         Correct reference to locale(7) (not locale(5))
29249             locale(7) is the right place for details of the LC_*
29250             environment variables.
29251
29252             See http://bugs.debian.org/638186
29253     Michael Kerrisk
29254         Improve references for discussion of locale environment variables
29255     Michael Kerrisk
29256         SEE ALSO: add catopen(3)
29257     Michael Kerrisk
29258         SEE ALSO: add locale(5)
29259
29260 man-pages.7
29261     Michael Kerrisk
29262         Prefer "usable" over "useable"
29263
29264 netdevice.7
29265     Tilman Schmidt
29266         Document SIOCGIFCONF case ifc_req==NULL
29267             Add the missing description of the possibility to call SIOCGIFCONF
29268             with ifc_req==NULL to determine the needed buffer size, as
29269             described in
29270             http://lkml.indiana.edu/hypermail/linux/kernel/0110.1/0506.html
29271             and verified against source files net/core/dev_ioctl.c and
29272             net/ipv4/devinet.c in the current kernel git tree.
29273             This functionality has been present since the beginning of the 2.6
29274             series. It's about time it gets documented.
29275
29276             While I'm at it, also generally clarify the section on
29277             SIOCGIFCONF.
29278
29279 standards.7
29280     Michael Kerrisk
29281         Enhance description of V7
29282     Michael Kerrisk
29283         Add C11
29284
29285 tcp.7
29286     Michael Kerrisk
29287         Describe format of tcp_*_congestion_control /proc files
29288             Describe format of tcp_allowed_congestion_control and
29289             tcp_available_congestion_control.
29290
29291
29292 ==================== Changes in man-pages-3.58 ====================
29293
29294 Released: 2014-02-11, Munich
29295
29296
29297 Contributors
29298 ------------
29299
29300 The following people contributed patches/fixes or (noted in brackets
29301 in the changelog below) reports, notes, and ideas that have been
29302 incorporated in changes in this release:
29303
29304 Cyril Hrubis <chrubis@suse.cz>
29305 Daniel Borkmann <dborkman@redhat.com>
29306 David Prévot <taffit@debian.org>
29307 Fabrice Bauzac <libnoon@gmail.com>
29308 Michael Kerrisk <mtk.manpages@gmail.com>
29309 Mike Frysinger <vapier@gentoo.org>
29310 Network Nut <sillystack@gmail.com>
29311 Ola Olsson <ola1olsson@gmail.com>
29312 Peng Haitao <penght@cn.fujitsu.com>
29313 Peter Schiffer <pschiffe@redhat.com>
29314 Simone Piccardi <piccardi@truelite.it>
29315 Simon Paillard <spaillard@debian.org>
29316 Yuri Kozlov <yuray@komyakino.ru>
29317 Марк Коренберг <socketpair@gmail.com>
29318 未卷起的浪 <ayjj_8109@qq.com>
29319
29320 Apologies if I missed anyone!
29321
29322
29323 Newly documented interfaces in existing pages
29324 ---------------------------------------------
29325
29326 pipe.2
29327     Michael Kerrisk
29328         Document the pipe2() O_DIRECT flag added in Linux 3.4
29329
29330 packet.7
29331     Daniel Borkmann
29332         Document PACKET_QDISC_BYPASS
29333             New in Linux 3.14.
29334
29335
29336 Global changes
29337 --------------
29338
29339 Various pages
29340     Simon Paillard
29341         Formatting fix: add space between function and () if BR or IR
29342             Detected through the regex:
29343                 git grep -P '^\.(BR|IR) [\w]*\([\d]*\)$'
29344
29345 Various pages
29346     Simon Paillard
29347         Formatting fix: add space between word and punctuation if BR or IR
29348             Detected through the regex:
29349                 git grep -P '^\.(BR|IR) [^ ]*[,\.]$'
29350
29351             Could probably be extended to match more cases and fix in perl.
29352
29353 Various pages
29354     Michael Kerrisk
29355         Use Oxford comma
29356
29357 gettid.2
29358 restart_syscall.2
29359 passwd.5
29360 socket.7
29361     Michael Kerrisk
29362         Fix order of SEE ALSO entries
29363
29364
29365 Changes to individual pages
29366 ---------------------------
29367
29368 epoll_wait.2
29369     Michael Kerrisk  [Network Nut]
29370         Remove word "minimum" from the description of 'timeout'
29371
29372 epoll_wait.2
29373 poll.2
29374 select.2
29375     Michael Kerrisk
29376         Go into more detail on timeout and when call will cease blocking
29377
29378 getxattr.2
29379 listxattr.2
29380 removexattr.2
29381 setxattr.2
29382     Michael Kerrisk  [Fabrice Bauzac]
29383         Correct header file is <sys/xattr.h> (not <xattr/xattr.h>)
29384             See https://bugzilla.kernel.org/show_bug.cgi?id=70141
29385
29386 msgctl.2
29387     Cyril Hrubis
29388         Add note about ignored arg to IPC_RMID
29389
29390 prctl.2
29391     Michael Kerrisk  [Марк Коренберг]
29392         PR_SET_PDEATHSIG value is preserved across execve(2)
29393
29394 recv.2
29395     Michael Kerrisk
29396         Rework and reorganize the text in various parts of the page.
29397         Isolate details specific to recv() vs recvfrom() vs recvmsg()
29398             Place details specific to each system call under a
29399             a separate subheading.
29400         Rework discussion of 'src_addr' and 'addrlen' for recvfrom()
29401         Add description of 'buf' and 'len' in recvfrom() section
29402         'addrlen' should be 0 (*not* NULL) when 'src_addr' is NULL
29403         Improve text describing recvfrom() call that is equivalent to recv()
29404     Michael Kerrisk  [未卷起的浪]
29405         Describe the various cases where the return value can be 0
29406
29407 shmctl.2
29408     Michael Kerrisk
29409         Note that 'buf' is ignored for IPC_RMID
29410
29411 symlinkat.2
29412     Michael Kerrisk
29413         Make argument names consistent with symlink(2) page
29414
29415 isalpha.3
29416     Peng Haitao
29417         ATTRIBUTES: Note functions that are thread-safe
29418             The functions isalnum(), isalpha(), isascii(), isblank(),
29419             iscntrl(), isdigit(), isgraph(), islower(), isprint(),
29420             ispunct(), isspace(), isupper() and isxdigit() are thread safe.
29421
29422 isatty.3
29423     Peng Haitao
29424         ATTRIBUTES: Note function that is thread-safe
29425             The function isatty() is thread safe.
29426
29427 isgreater.3
29428     Peng Haitao
29429         ATTRIBUTES: Note macros that are thread-safe
29430             The macros isgreater(), isgreaterequal(), isless(),
29431             islessequal(), islessgreater() and isunordered() are thread safe.
29432
29433 iswalnum.3
29434     Peng Haitao
29435         ATTRIBUTES: Note function that is thread safe with exceptions
29436             The function iswalnum() is thread safe with exceptions.
29437
29438 iswalpha.3
29439     Peng Haitao
29440         ATTRIBUTES: Note function that is thread safe with exceptions
29441             The function iswalpha() is thread safe with exceptions.
29442
29443 iswblank.3
29444     Peng Haitao
29445         ATTRIBUTES: Note function that is thread safe with exceptions
29446             The function iswblank() is thread safe with exceptions.
29447
29448 iswcntrl.3
29449     Peng Haitao
29450         ATTRIBUTES: Note function that is thread safe with exceptions
29451             The function iswcntrl() is thread safe with exceptions.
29452
29453 lockf.3
29454     Michael Kerrisk  [Simone Piccardi]
29455         Fix incorrect argument mentioned under EINVAL error
29456
29457 pthread_kill.3
29458     Michael Kerrisk
29459         Add feature test macro requirements
29460
29461 pthread_sigmask.3
29462     Michael Kerrisk
29463         Add feature test macro requirements
29464
29465 strtoul.3
29466     Peng Haitao
29467         ATTRIBUTES: Note functions that are thread safe with exceptions
29468             The functions strtoul(), strtoull() and strtouq() are thread safe
29469             with exceptions.
29470
29471 nscd.conf.5
29472     Peter Schiffer
29473         Add note about default values
29474
29475 proc.5
29476     Michael Kerrisk
29477         SEE ALSO: Add some further kernel Documentation/sysctl files
29478
29479 man-pages.7
29480     Michael Kerrisk
29481         ATTRIBUTES sections come after VERSIONS
29482             Peng Haitao has consistently ordered the ATTRIBUTES after
29483             VERSIONS, so adjust the text in man-pages.7
29484
29485 vdso.7
29486     Michael Kerrisk
29487         Add words "virtual dynamic shared object" in DESCRIPTION
29488
29489
29490 ==================== Changes in man-pages-3.59 ====================
29491
29492 Released: 2014-02-16, Munich
29493
29494
29495 Contributors
29496 ------------
29497
29498 The following people contributed patches/fixes or (noted in brackets
29499 in the changelog below) reports, notes, and ideas that have been
29500 incorporated in changes in this release:
29501
29502 Michael Kerrisk <mtk.manpages@gmail.com>
29503 Peter Schiffer <pschiffe@redhat.com>
29504 Weizhou Pan <cs.wzpan@gmail.com>
29505
29506 Apologies if I missed anyone!
29507
29508
29509 Global changes
29510 --------------
29511
29512 Various pages
29513     Peter Schiffer, Michael Kerrisk  [Weizhou Pan]
29514         Convert pages containing non-ASCII in source code comments to use UTF-8
29515             Done using a slightly modified version of Peter Schiffer's
29516             convert_to_utf_8.sh script. The script was modified so as *not*
29517             a "coding:" marker to the groff source. For now, we'll only put
29518             that marker on pages that contain non-ASCII characters in the
29519             rendered text.
29520
29521             See https://bugzilla.kernel.org/show_bug.cgi?id=60807
29522
29523 armscii-8.7
29524 cp1251.7
29525 iso_8859-1.7
29526 iso_8859-10.7
29527 iso_8859-11.7
29528 iso_8859-13.7
29529 iso_8859-14.7
29530 iso_8859-15.7
29531 iso_8859-16.7
29532 iso_8859-2.7
29533 iso_8859-3.7
29534 iso_8859-4.7
29535 iso_8859-5.7
29536 iso_8859-6.7
29537 iso_8859-7.7
29538 iso_8859-8.7
29539 iso_8859-9.7
29540 koi8-r.7
29541 koi8-u.7
29542     Peter Schiffer, Michael Kerrisk  [Weizhou Pan]
29543         Convert pages containing non-ASCII to use UTF-8
29544             Done using Peter Schiffer's convert_to_utf_8.sh script.
29545             These pages containing non-ASCII in the rendered characters, and
29546             so the script inserts a "coding:" marker into the groff source.
29547
29548             See https://bugzilla.kernel.org/show_bug.cgi?id=60807
29549
29550
29551 ==================== Changes in man-pages-3.60 ====================
29552
29553 Released: 2014-02-18, Munich
29554
29555
29556 Contributors
29557 ------------
29558
29559 The following people contributed patches/fixes or (noted in brackets
29560 in the changelog below) reports, notes, and ideas that have been
29561 incorporated in changes in this release:
29562
29563 David Prévot <taffit@debian.org>
29564 D. Barbier <bouzim@gmail.com>
29565 Kalle Olavi Niemitalo <kon@iki.fi>
29566 Michael Kerrisk <mtk.manpages@gmail.com>
29567 Simon Paillard <spaillard@debian.org>
29568
29569 Apologies if I missed anyone!
29570
29571
29572 Changes to individual pages
29573 ---------------------------
29574 sigvec.3
29575     Michael Kerrisk  [Kalle Olavi Niemitalo]
29576         Fix error in code snippet
29577             s/sigpause/sigmask/
29578
29579 armscii-8.7
29580 cp1251.7
29581 iso_8859-1.7
29582 iso_8859-10.7
29583 iso_8859-11.7
29584 iso_8859-13.7
29585 iso_8859-14.7
29586 iso_8859-15.7
29587 iso_8859-16.7
29588 iso_8859-2.7
29589 iso_8859-3.7
29590 iso_8859-4.7
29591 iso_8859-5.7
29592 iso_8859-6.7
29593 iso_8859-7.7
29594 iso_8859-8.7
29595 iso_8859-9.7
29596 koi8-u.7
29597     Michael Kerrisk  [Simon Paillard]
29598         Remove comment that glyphs in column 4 may not display correctly
29599             With the conversion to UTF-8, the glyphs in column 4 of the
29600             tables in these pages will display regardless of whether the
29601             environment is configured for the corresponding character set.
29602
29603 iso_8859-11.7
29604 iso_8859-13.7
29605     D. Barbier  [Simon Paillard]
29606         Fix encoding mistakes in 5f7f4042b8848127d852c6fa7c02e31ccfaeeae5
29607             Fixed via:
29608
29609               for f in iso_8859-11 iso_8859-13; do
29610                 cp man7/$f.7 $f
29611                 iconv -f utf8 -t latin1 $f | iconv -f iso-${f#iso_} -t utf8 > man7/$f.7
29612               done
29613
29614
29615
29616
29617 ==================== Changes in man-pages-3.61 ====================
29618
29619 Released: 2014-02-26, Munich
29620
29621
29622 Contributors
29623 ------------
29624
29625 The following people contributed patches/fixes or (noted in brackets
29626 in the changelog below) reports, notes, and ideas that have been
29627 incorporated in changes in this release:
29628
29629 Andrew Hunter <ahh@google.com>
29630 Carlos O'Donell <carlos@redhat.com>
29631 Christoph Hellwig <hch@infradead.org>
29632 Daniel Borkmann <dborkman@redhat.com>
29633 Duncan de Wet <duncandewet@gmail.com>
29634 Kir Kolyshkin <kir@openvz.org>
29635 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
29636 Michael Kerrisk <mtk.manpages@gmail.com>
29637 Neil Horman <nhorman@tuxdriver.com>
29638 Peng Haitao <penght@cn.fujitsu.com>
29639 Simon Paillard <spaillard@debian.org>
29640 Sulaiman Mustafa <seininn@hush.com>
29641 Xiawei Chen <chenxiawei@gmail.com>
29642
29643 Apologies if I missed anyone!
29644
29645
29646 New and rewritten pages
29647 -----------------------
29648
29649 A note from Christoph Hellwig prompted me to perform a task that has
29650 been queued for a while: merging the text of the man pages for the
29651 *at([23]) ("directory file descriptor") APIs into their corresponding
29652 traditional pages.  When the *at([23]) pages were originally written
29653 (mostly in 2006), the APIs were not part of POSIX and (in most cases)
29654 were not available on other systems. So, it made some sense to wall
29655 them off into their own separate pages. Eight years later, with the
29656 APIs now all in POSIX (except scandirat()), it is much more sensible
29657 to document the newer APIs alongside their traditional counterparts,
29658 so that the newer APIs are not "hidden", and the reader can more
29659 easily see the differences between the APIs.
29660
29661 Thus, the text of 14 pairs of pages has been merged, and the "merged
29662 from" pages have been converted to links to the "merged to" pages.
29663 Along the way, a few other fixes were made to the pages, as noted
29664 below.
29665
29666 One page that did not undergo such a change was utimensat(2), which
29667 is different enough from utime(2) that it warrants a separate page.
29668 Unlike the other *at() pages, the utimensat(2) page was also already
29669 self-contained, rather than defining itself in terms of differences
29670 from utime(2) as the other *at() pages did.
29671
29672 access.2
29673     Michael Kerrisk
29674         Merge text from faccessat(2)
29675     Michael Kerrisk
29676         Remove faccessat() race warning
29677             That point is already covered in existing text in this page.
29678     Michael Kerrisk
29679         access() also conforms to POSIX.1-2008
29680
29681 chmod.2
29682     Michael Kerrisk
29683         Merge text from fchmodat(2)
29684     Michael Kerrisk
29685         Use argument name 'pathname' throughout page
29686             (Some APIs were using 'path' while others used 'pathname')
29687     Michael Kerrisk
29688         CONFORMING TO: chmod() and fchmod() are also in POSIX.1-2008
29689
29690 chown.2
29691     Michael Kerrisk
29692         Merge text of fchownat(2)
29693     Michael Kerrisk
29694         AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE
29695     Michael Kerrisk
29696         Use argument name 'pathname' throughout page
29697             (Some APIs were using 'path' while others used 'pathname')
29698     Michael Kerrisk
29699         Remove sentence that fchownat() is present on Solaris
29700             That point was only really relevant before fchownat() was
29701             standardized in POSIX.1.2008.
29702     Michael Kerrisk
29703         CONFORMING TO: chown(), fchown(), lchown() are in POSIX.1-2008
29704
29705 link.2
29706     Michael Kerrisk
29707         Merge text of linkat(2)
29708     Michael Kerrisk
29709         CONFORMING TO: link() is in POSIX.1-2008
29710     Michael Kerrisk
29711         AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE
29712
29713 mkdir.2
29714     Michael Kerrisk
29715         Merge text of mkdirat(2)
29716     Michael Kerrisk
29717         CONFORMING TO: mkdir() is in POSIX.1-2008
29718
29719 mknod.2
29720     Michael Kerrisk
29721         Merge text of mknodat(2)
29722     Michael Kerrisk
29723         CONFORMING TO: mknod(2) is in POSIX.1-2008
29724
29725 open.2
29726     Michael Kerrisk
29727         Merge text from openat(2)
29728     Michael Kerrisk
29729         Remove sentence that openat() is present on Solaris
29730             That point was only really relevant before openat() was
29731             standardized in POSIX.1.2008.
29732
29733 readlink.2
29734     Michael Kerrisk
29735         Merge text of readlinkat(2)
29736     Michael Kerrisk
29737         CONFORMING TO: readlink() is in POSIX.1-2008.
29738     Michael Kerrisk
29739         Use argument name 'pathname' throughout page
29740             (Some APIs were using 'path' while others used 'pathname')
29741
29742 rename.2
29743     Michael Kerrisk
29744         Merge text of renameat(2)
29745     Michael Kerrisk
29746         CONFORMING TO: rename(2) is in POSIX.1-2008
29747
29748 stat.2
29749     Michael Kerrisk
29750         Merge text from fstatat(2)
29751     Michael Kerrisk
29752         AT_EMPTY_PATH and AT_NO_AUTOMOUNT are Linux-specific
29753             These flags require _GNU_SOURCE.
29754     Michael Kerrisk
29755         Use argument name 'pathname' throughout page
29756             (Some APIs were using 'path' while others used 'pathname')
29757     Michael Kerrisk
29758         Remove sentence that fstatat() is present on Solaris
29759             That point was only really relevant before fstatat() was
29760             standardized in POSIX.1.2008.
29761     Michael Kerrisk
29762         CONFORMING TO: stat(), fstat(), lstat() are specified in POSIX.1-2008
29763
29764 symlink.2
29765     Michael Kerrisk
29766         Merge text of symlinkat(2)
29767     Michael Kerrisk
29768         CONFORMING TO: symlink() is in POSIX.1-2008
29769
29770 unlink.2
29771     Michael Kerrisk
29772         Merge text of unlinkat(2)
29773     Michael Kerrisk
29774         Remove sentence that unlinkat() is present on Solaris
29775             That point was only really relevant before unlinkat() was
29776             standardized in POSIX.1.2008.
29777     Michael Kerrisk
29778         CONFORMING TO: unlink() is in POSIX.1-2008
29779
29780 mkfifo.3
29781     Michael Kerrisk
29782         Merge text of mkfifoat(3)
29783     Michael Kerrisk
29784         CONFORMING TO: mkfifo() is in POSIX.1-2008
29785
29786 scandir.3
29787     Michael Kerrisk
29788         Merge text of scandirat(3)
29789     Michael Kerrisk
29790         Update feature test macro requirements
29791             The FTM requirements changed in glibc 2.10.
29792     Michael Kerrisk
29793         Remove libc4/libc5 note under CONFORMING TO
29794             No-one much cares about Linux libc these days.
29795     Michael Kerrisk
29796         Put detail about alphasort under a NOTES heading
29797             This text was under CONFORMING TO, which made no sense.
29798     Michael Kerrisk
29799         Rework CONFORMING TO text
29800
29801
29802 Newly documented interfaces in existing pages
29803 ---------------------------------------------
29804
29805 prctl.2
29806     Kir Kolyshkin
29807         Document PR_SET_MM options in Linux 3.5
29808             Some of the PR_SET_MM options were merged to vanilla kernel
29809             later, and appeared in Linux 3.5. Those are:
29810
29811                - PR_SET_MM_ARG_START
29812                - PR_SET_MM_ARG_END
29813                - PR_SET_MM_ENV_START
29814                - PR_SET_MM_ENV_END
29815                - PR_SET_MM_AUXV
29816                - PR_SET_MM_EXE_FILE
29817
29818 socket.7
29819     Neil Horman
29820         Document the SO_RXQ_OVFL socket option
29821     Michael Kerrisk
29822         Add kernel version number for SO_RXQ_OVFL
29823
29824
29825 New and changed links
29826 ---------------------
29827
29828 faccessat.2
29829     Michael Kerrisk
29830         Convert to link to access.2
29831
29832 fchmodat.2
29833     Michael Kerrisk
29834         Convert to link to chmod.2
29835
29836 fchownat.2
29837     Michael Kerrisk
29838         Convert to link to chown.2
29839
29840 fstatat.2
29841     Michael Kerrisk
29842         Convert to link to stat.2
29843
29844 linkat.2
29845     Michael Kerrisk
29846         Convert to link to link.2
29847
29848 mkdirat.2
29849     Michael Kerrisk
29850         Convert to link to mkdir.2
29851
29852 mknodat.2
29853     Michael Kerrisk
29854         Convert to link to mknod.2
29855
29856 openat.2
29857     Michael Kerrisk
29858         Convert to link to open.2
29859
29860 readlinkat.2
29861     Michael Kerrisk
29862         Convert to link to symlink.2
29863
29864 renameat.2
29865     Michael Kerrisk
29866         Convert to link rename.2
29867
29868 symlinkat.2
29869     Michael Kerrisk
29870         Convert to link to symlink.2
29871
29872 unlinkat.2
29873     Michael Kerrisk
29874         Convert to link to unlink.2
29875
29876 mkfifoat.3
29877     Michael Kerrisk
29878         Convert to link to mkfifo.3
29879
29880 scandirat.3
29881     Michael Kerrisk
29882         Convert to link to scandir.3
29883
29884
29885 Changes to individual pages
29886 ---------------------------
29887
29888 alarm.2
29889     Michael Kerrisk
29890         Note semantics of alarm with respect to fork() and execve()
29891
29892 fcntl.2
29893     Michael Kerrisk
29894         Warn that F_GETLK info may already be out of date when the call returns
29895
29896 intro.2
29897     Michael Kerrisk
29898         Describe policy on documenting differences between syscall and glibc API
29899
29900 mmap2.2
29901     Michael Kerrisk
29902         Reword note on glibc mmap() wrapper invocation of mmap2()
29903     Michael Kerrisk
29904         This system call does not exist on x86-64
29905
29906 msgctl.2
29907     Michael Kerrisk
29908         ERRORS: add EPERM for unprivileged attempt to set msg_qbytes > MSGMNB
29909
29910 prctl.2
29911     Michael Kerrisk  [Xiawei Chen]
29912         Clarify that PR_GET_TIMERSLACK is returned as the function result
29913     Michael Kerrisk
29914         Clarify that PR_GET_SECCOMP is returned as function result
29915     Michael Kerrisk
29916         Clarify that PR_GET_NO_NEW_PRIVS is returned as function result
29917
29918 ptrace.2
29919     Michael Kerrisk  [Andrew Hunter]
29920         Make it clearer that glibc and syscall APIs differ for PTRACE_PEEK*
29921             Thanks to Denys Vlasenko's additions in 78686915aed6bd12
29922             this page does note that the glibc API for PTRACE_PEEK*
29923             differs from the raw syscall interface. But, as the report
29924             at https://bugzilla.kernel.org/show_bug.cgi?id=70801 shows,
29925             this information could be more obvious. This patch makes its so.
29926
29927 sgetmask.2
29928     Michael Kerrisk
29929         Note that these system calls don't exist on x86-64
29930
29931 swapon.2
29932     Michael Kerrisk
29933         Split EINVAL cases into separate entries under ERRORS
29934     Michael Kerrisk
29935         Add EINVAL error for invalid flags to swapon()
29936
29937 syscalls.2
29938     Michael Kerrisk
29939         SEE ALSO: add intro(2)
29940
29941 umount.2
29942     Michael Kerrisk
29943         Split EINVAL cases into separate items
29944     Michael Kerrisk
29945         ERRORS: Add EINVAL case that was new in 2.6.34
29946
29947 utime.2
29948     Michael Kerrisk
29949         Add note that modern applications probably want utimensat(2) etc.
29950
29951 crypt.3
29952     Michael Kerrisk  [KOSAKI Motohiro]
29953         ERRORS: Add EINVAL and EPERM errors
29954             See https://bugzilla.kernel.org/show_bug.cgi?id=69771
29955
29956 getifaddrs.3
29957     Michael Kerrisk
29958         Enhance example program
29959             Print statistics for AF_PACKET interfaces.
29960             Add missing feature test macro definition.
29961             Reformat output.
29962
29963 iswctype.3
29964     Peng Haitao
29965         ATTRIBUTES: Note function that is thread-safe
29966             The function iswctype() is thread safe.
29967
29968 sem_post.3
29969     Peng Haitao
29970         ATTRIBUTES: Note function that is thread-safe
29971             The function sem_post() is thread safe.
29972
29973 sem_unlink.3
29974     Peng Haitao
29975         ATTRIBUTES: Note function that is thread-safe
29976             The function sem_unlink() is thread safe.
29977
29978 sem_wait.3
29979     Peng Haitao
29980         ATTRIBUTES: Note functions that are thread-safe
29981             The functions sem_wait(), sem_trywait() and sem_timedwait() are
29982             thread safe.
29983
29984 setbuf.3
29985     Peng Haitao
29986         ATTRIBUTES: Note functions that are thread-safe
29987             The functions setbuf(), setbuffer(), setlinebuf() and setvbuf()
29988             are thread safe.
29989
29990 strlen.3
29991     Peng Haitao
29992         ATTRIBUTES: Note function that is thread-safe
29993             The function strlen() is thread safe.
29994
29995 strnlen.3
29996     Peng Haitao
29997         ATTRIBUTES: Note function that is thread-safe
29998             The function strnlen() is thread safe.
29999
30000 strpbrk.3
30001     Peng Haitao
30002         ATTRIBUTES: Note function that is thread-safe
30003             The function strpbrk() is thread safe.
30004
30005 strsep.3
30006     Peng Haitao
30007         ATTRIBUTES: Note function that is thread-safe
30008             The function strsep() is thread safe.
30009
30010 swab.3
30011     Peng Haitao
30012         ATTRIBUTES: Note function that is thread-safe
30013             The function swab() is thread safe.
30014
30015 resolv.conf.5
30016     Carlos O'Donell
30017         DESCRIPTION: mention that the data is trusted
30018             In a recent discussion about DNSSEC it was brought to my
30019             attention that not all system administrators may understand
30020             that the information in /etc/resolv.conf is fully trusted.
30021             The resolver implementation in glibc treats /etc/resolv.conf
30022             as a fully trusted source of DNS information and passes on
30023             the AD-bit for DNSSEC as trusted.
30024
30025             This patch adds a clarifying sentence to make it absolutely
30026             clear that indeed this source of information is trusted.
30027
30028 ascii.7
30029     Michael Kerrisk  [Sulaiman Mustafa]
30030         Fix rendering of single quote (decimal character 39)
30031     Michael Kerrisk
30032         SEE ALSO: add utf-8(7)
30033     Michael Kerrisk  [Duncan de Wet]
30034         Remove mention of ISO 8859-1 as being the default encoding on Linux
30035
30036 packet.7
30037     Neil Horman
30038         Document PACKET_FANOUT_QM fanout mode
30039     Michael Kerrisk
30040         Add kernel version for PACKET_FANOUT_QM
30041     Daniel Borkmann
30042         Improve PACKET_QDISC_BYPASS description
30043
30044 socket.7
30045     Michael Kerrisk
30046         Add kernel version number for SO_BUSY_POLL
30047
30048
30049 ==================== Changes in man-pages-3.62 ====================
30050
30051 Released: 2014-03-11, Munich
30052
30053
30054 Contributors
30055 ------------
30056
30057 The following people contributed patches/fixes or (noted in brackets
30058 in the changelog below) reports, notes, and ideas that have been
30059 incorporated in changes in this release:
30060
30061 Cyril Hrubis <chrubis@suse.cz>
30062 Joseph S. Myers <joseph@codesourcery.com>
30063 Marius Gaubas <marius@livejournalinc.com>
30064 Michael Kerrisk <mtk.manpages@gmail.com>
30065 Mike Frysinger <vapier@gentoo.org>
30066 Peng Haitao <penght@cn.fujitsu.com>
30067 Rick Stanley <rstanley@rsiny.com>
30068 Simon Paillard <spaillard@debian.org>
30069
30070 Apologies if I missed anyone!
30071
30072
30073 New and rewritten pages
30074 -----------------------
30075
30076 locale.1
30077     Michael Kerrisk [review from Mike Frysinger]
30078         New page describing locale(1)
30079
30080
30081 Newly documented interfaces in existing pages
30082 ---------------------------------------------
30083
30084 locale.5
30085     Michael Kerrisk
30086         Document LC_ADDRESS
30087     Michael Kerrisk
30088         Document LC_IDENTIFICATION
30089     Michael Kerrisk
30090         Document LC_MEASUREMENT
30091     Michael Kerrisk
30092         Document LC_NAME
30093     Michael Kerrisk
30094         Document LC_PAPER
30095     Michael Kerrisk
30096         Document LC_TELEPHONE
30097
30098
30099 Removed Pages
30100 -------------
30101
30102 sync.8
30103     Michael Kerrisk  [Christoph Hellwig, Pádraig Brady]
30104         Sometime in the 20th century (before my watch), a sync(8)
30105         page into man-pages. It documents the sync command from
30106         "fileutils", which long ago become coreutils, and the
30107         piece under NOTES note some behavior of sync(2)
30108         that ceased to be true many years ago.  The man-pages
30109         project generally focuses on only Linux kernel and
30110         (g)libc interfaces, so this sync(8) page doesn't really
30111         belong.  Furthermore, coreutils has a sync(1) page which
30112         covers the same command. After dicussions on the
30113         coreutils list, I've decided to retire this page from
30114         man-pages.
30115
30116 Changes to individual pages
30117 ---------------------------
30118
30119 clone.2
30120     Michael Kerrisk
30121         Note that CLONE_THREAD also in effect requires CLONE_VM
30122
30123 stat.2
30124     Michael Kerrisk  [Marius Gaubas]
30125         Warn the reader that the 'stat' structure definition is not precise
30126             Padding fields aren't shown, and the order of fields varies
30127             somewhat across architectures.
30128
30129 gethostbyname.3
30130     Michael Kerrisk
30131         Remove redundant FTM requirements
30132             _GNU_SOURCE implies _SVID_SOURCE and _BSD_SOURCE, so
30133
30134                 _BSD_SOURCE || _SVID_SOURCE || _GNU_SOURCE
30135
30136             is the same as
30137
30138                 _BSD_SOURCE || _SVID_SOURCE
30139
30140 getutmp.3
30141     Michael Kerrisk
30142         SEE ALSO: add utmpdump(1)
30143
30144 log1p.3
30145     Peng Haitao
30146         ATTRIBUTES: Note functions that are thread-safe
30147             The functions log1p(), log1pf() and log1pl() are thread safe.
30148
30149 logb.3
30150     Peng Haitao
30151         ATTRIBUTES: Note functions that are thread-safe
30152             The functions logb(), logbf() and logbl() are thread safe.
30153
30154 memccpy.3
30155     Peng Haitao
30156         ATTRIBUTES: Note function that is thread-safe
30157             The function memccpy() is thread safe.
30158
30159 memchr.3
30160     Peng Haitao
30161         ATTRIBUTES: Note functions that are thread-safe
30162             The functions memchr(), memrchr() and rawmemchr() are thread safe.
30163
30164 mktemp.3
30165     Michael Kerrisk
30166         Make warning not to use this function more prominent
30167
30168 qecvt.3
30169     Michael Kerrisk  [Joseph S. Myers]
30170         Recommend snprintf(3) not sprintf(3)
30171
30172 raise.3
30173     Peng Haitao
30174         ATTRIBUTES: Note function that is thread-safe
30175             The function raise() is thread safe.
30176
30177 remove.3
30178     Peng Haitao
30179         ATTRIBUTES: Note function that is thread-safe
30180             The function remove() is thread safe.
30181
30182 sem_destroy.3
30183     Peng Haitao
30184         ATTRIBUTES: Note function that is thread-safe
30185             The function sem_destroy() is thread safe.
30186
30187 sem_getvalue.3
30188     Peng Haitao
30189         ATTRIBUTES: Note function that is thread-safe
30190             The function sem_getvalue() is thread safe.
30191
30192 sem_init.3
30193     Peng Haitao
30194         ATTRIBUTES: Note function that is thread-safe
30195             The function sem_init() is thread safe.
30196
30197 sockatmark.3
30198     Peng Haitao
30199         ATTRIBUTES: Note function that is thread-safe
30200             The function sockatmark() is thread safe.
30201
30202 strcpy.3
30203     Peng Haitao
30204         ATTRIBUTES: Note functions that are thread-safe
30205             The functions strcpy() and strncpy() are thread safe.
30206     Michael Kerrisk  [Rick Stanley]
30207         Fix a bug, and improve discussion of forcing termination with strncpy()
30208
30209 strspn.3
30210     Peng Haitao
30211         ATTRIBUTES: Note functions that are thread-safe
30212             The functions strspn() and strcspn() are thread safe.
30213
30214 tempnam.3
30215     Michael Kerrisk
30216         Make warning not to use this function more prominent
30217
30218 tmpnam.3
30219     Michael Kerrisk
30220         Recommend use mkstemp(3) or tmpfile(3) instead
30221
30222 locale.5
30223     Michael Kerrisk
30224         Add intro section that lists all of the LC categories
30225     Michael Kerrisk
30226         'p_cs_precedes' is for *positive* values
30227     Michael Kerrisk
30228         Clarify 'p_sign_posn' and 'n_sign_posn'; simplify 'n_sign_posn'
30229             Add initial sentence for 'p_sign_posn' and 'n_sign_posn'.
30230             Remove repeated list for 'n_sign_posn'.
30231     Michael Kerrisk
30232         Document LC_MESSAGES 'yesstr' and 'nostr'
30233     Michael Kerrisk
30234         Clarify LC_MONETARY 'n_cs_precedes'
30235     Michael Kerrisk
30236         LC_MONETARY: Document 'int_p_sign_posn' and 'int_n_sign_posn'
30237     Michael Kerrisk
30238         Clarify/rework 'p_cs_precedes' and 'n_cs_precedes'
30239     Michael Kerrisk
30240         LC_MONETARY: document 'int_p_sep_by_space' and 'int_n_sep_by_space'
30241     Michael Kerrisk
30242         Remove crufty reference to POSIX.2
30243     Michael Kerrisk
30244         LC_MONETARY: document 'int_p_cs_precedes' and 'int_n_cs_precedes'
30245     Michael Kerrisk
30246         Clarify/simplify 'n_sep_by_space'
30247     Michael Kerrisk
30248         LC_TIME: document 'cal_direction' and 'date_fmt'
30249     Michael Kerrisk
30250         Clarify 'p_sep_by_space'
30251
30252 feature_test_macros.7
30253     Michael Kerrisk
30254         _BSD_SOURCE and _SVID_SOURCE are deprecated in glibc 2.20
30255     Michael Kerrisk
30256         _GNU_SOURCE implicitly defines other macros
30257             Saying that _GNU_SOURCE has the "effects of" other macros is not
30258             quite precise.
30259     Michael Kerrisk
30260         Reword glibc version for _ISOC95_SOURCE
30261     Michael Kerrisk
30262         _ISOC99_SOURCE also exposes C95 definitions
30263     Michael Kerrisk
30264         _ISOC11_SOURCE implies the effects of _ISOC99_SOURCE
30265     Michael Kerrisk
30266         Note version number for _POSIX_C_SOURCE >= 200112L implies C99/C95
30267             _POSIX_C_SOURCE >= 200112L causes C95 definitions to be
30268             exposed only since glibc 2.12 and C99 definitions only
30269             since 2.10.
30270     Michael Kerrisk
30271         _XOPEN_SOURCE may implicitly define _POSIX_SOURCE and _POSIX_C_SOURCE
30272     Michael Kerrisk
30273         Reword glibc version for _ISOC99_SOURCE
30274     Michael Kerrisk
30275         Rework discussion of _ISOC99_SOURCE
30276     Michael Kerrisk
30277         Improve discussion of _DEFAULT_SOURCE
30278     Michael Kerrisk
30279         _POSIX_C_SOURCE >= 200112L implies C95 and C95 features
30280
30281
30282
30283 ==================== Changes in man-pages-3.63 ====================
30284
30285 Released: 2014-03-18, Munich
30286
30287
30288 Contributors
30289 ------------
30290
30291 The following people contributed patches/fixes or (noted in brackets
30292 in the changelog below) reports, notes, and ideas that have been
30293 incorporated in changes in this release:
30294
30295 Carlos O'Donell <carlos@redhat.com>
30296 Christoph Hellwig <hch@infradead.org>
30297 Corrado Zoccolo <czoccolo@gmail.com>
30298 Gregory P. Smith <gps@google.com>
30299 Joseph S. Myers <joseph@codesourcery.com>
30300 Michael Kerrisk <mtk.manpages@gmail.com>
30301 Mike Frysinger <vapier@gentoo.org>
30302 Peng Haitao <penght@cn.fujitsu.com>
30303 Phillip Susi <psusi@ubuntu.com>
30304 Robert P. J. Day <rpjday@crashcourse.ca>
30305 Stefan Puiu <stefan.puiu@gmail.com>
30306 Zhu Yanhai <zhu.yanhai@gmail.com>
30307
30308 Apologies if I missed anyone!
30309
30310
30311 New and rewritten pages
30312 -----------------------
30313
30314 duplocale.3
30315     Michael Kerrisk
30316         New page documenting duplocale(3)
30317
30318 newlocale.3
30319     Michael Kerrisk  [Mike Frysinger]
30320         New page documenting newlocale(3) and freelocale(3)
30321
30322 towlower.3
30323     Michael Kerrisk
30324         Largely rewrite description of towlower() to be simpler and clearer
30325
30326 towupper.3
30327     Michael Kerrisk
30328         Largely rewrite description of towupper() to be simpler and clearer
30329
30330 uselocale.3
30331     Michael Kerrisk
30332         New page documenting uselocale(3)
30333
30334
30335 Newly documented interfaces in existing pages
30336 ---------------------------------------------
30337
30338 open.2
30339     Michael Kerrisk
30340         Document O_DSYNC and rewrite discussion of O_SYNC
30341
30342 isalpha.3
30343     Michael Kerrisk
30344         Document the "_l" locale APIs
30345             The GNU C library v2.3 added some locale APIs, most of which
30346             were later specified in POSIX.1-2008, namely:
30347
30348                    isalnum_l()
30349                    isalpha_l()
30350                    isblank_l()
30351                    iscntrl_l()
30352                    isdigit_l()
30353                    isgraph_l()
30354                    islower_l()
30355                    isprint_l()
30356                    ispunct_l()
30357                    isspace_l()
30358                    isupper_l()
30359                    isxdigit_l()
30360                    isascii_l()
30361
30362             Also update and correct various pieces in CONFORMING TO
30363             (and remove a few crufty old pieces there).
30364
30365 strerror.3
30366     Michael Kerrisk
30367         Document strerror_l()
30368
30369 toupper.3
30370     Michael Kerrisk
30371         Document toupper_l() and tolower_l()
30372
30373 towlower.3
30374     Michael Kerrisk
30375         Document towlower_l()
30376
30377 towupper.3
30378     Michael Kerrisk
30379         Document towupper_l()
30380
30381 proc.5
30382     Michael Kerrisk
30383         Document /proc/sys/kernel/random/uuid
30384
30385 locale.7
30386     Michael Kerrisk
30387         Document LC_ADDRESS
30388         Document LC_IDENTIFICATION
30389         Document LC_MEASUREMENT
30390         Document LC_NAME
30391         Document LC_PAPER
30392         Document LC_TELEPHONE
30393
30394
30395 New and changed links
30396 ---------------------
30397
30398 freelocale.3
30399     Michael Kerrisk
30400         New link to new newlocale.3 page
30401
30402 isalnum_l.3
30403 isascii_l.3
30404 isblank_l.3
30405 iscntrl_l.3
30406 isdigit_l.3
30407 isgraph_l.3
30408 islower_l.3
30409 isprint_l.3
30410 ispunct_l.3
30411 isspace_l.3
30412 isupper_l.3
30413 isxdigit_l.3
30414     Michael Kerrisk
30415         New links to isalpha.3
30416
30417 tolower_l.3
30418 toupper_l.3
30419     Michael Kerrisk
30420         New links to toupper.3
30421
30422 towlower_l.3
30423     Michael Kerrisk
30424         New link to towlower.3
30425
30426 towupper_l.3
30427     Michael Kerrisk
30428         New link to towupper.3
30429
30430
30431 Global changes
30432 --------------
30433
30434 Various pages
30435     Michael Kerrisk
30436         Global change: "upper case" ==> "uppercase", "lower case" ==> lowercase"
30437
30438
30439 Changes to individual pages
30440 ---------------------------
30441
30442 mount.2
30443     Michael Kerrisk
30444         SEE ALSO: add blkid(1)
30445
30446 msgop.2
30447     Michael Kerrisk
30448         Document two MSG_COPY failure modes
30449             Since Linux 3.14, the kernel now diagnoses two errors
30450             when using msgrcv() MSG_COPY:
30451             * MSG_COPY must be specified with IPC_NOWAIT
30452             * MSG_COPY can't be specified with MSG_EXCEPT
30453
30454 open.2
30455     Michael Kerrisk
30456         Organize some material under additional subheadings in NOTES
30457             There's an amorphous mass of material under NOTES.  Structure
30458             it with some subheadings, and do a little reorganizing.
30459     Michael Kerrisk
30460         Add other system calls and functions that are like openat()
30461             fanotify_mark(2), name_to_handle_at(2), and scandirat(3) have a
30462             directory file descriptor argument for the same reason as openat().
30463             Also: reword the rationale for the *at() functions somewhat.
30464     Michael Kerrisk
30465         Clarify ELOOP error interaction with O_PATH
30466
30467 readahead.2
30468     Phillip Susi  [Corrado Zoccolo, Gregory P. Smith, Zhu Yanhai, Michael Kerrisk, Christoph Hellwig]
30469         Don't claim the call blocks until all data has been read
30470             The readahead(2) man page was claiming that the call blocks until
30471             all data has been read into the cache.  This is incorrect.
30472
30473             See https://bugzilla.kernel.org/show_bug.cgi?id=54271
30474
30475 stat.2
30476     Michael Kerrisk
30477         SEE ALSO: add ls(1) and stat(1)
30478
30479 fts.3
30480     Christoph Hellwig  [Michael Kerrisk]
30481         The fts(3) API does not work with LFS builds
30482             As pointed out during a recent discussion on libc-hacker the
30483             fts(3) APIs can't be used with large file offsets:
30484
30485                 https://sourceware.org/bugzilla/show_bug.cgi?id=15838
30486
30487 mbrtowc.3
30488 mbsnrtowcs.3
30489 mbsrtowcs.3
30490 mbtowc.3
30491     Michael Kerrisk
30492         Add entries in SEE ALSO
30493             Mainly inspired by the POSIX pages.
30494
30495 mbsinit.3
30496     Michael Kerrisk
30497         SEE ALSO: add mbrlen(3), mbrtowc(3), and wcrtomb(3)
30498
30499 mbsrtowcs.3
30500 wcsrtombs.3
30501     Michael Kerrisk
30502         SEE ALSO: add mbsinit(3)
30503
30504 mbstowcs.3
30505     Michael Kerrisk  [Stefan Puiu]
30506         Add example program
30507             And add some SEE ALSO entries
30508
30509 memcmp.3
30510     Peng Haitao
30511         ATTRIBUTES: Note function that is thread-safe
30512             The function memcmp() is thread safe.
30513
30514 memcpy.3
30515     Peng Haitao
30516         ATTRIBUTES: Note function that is thread-safe
30517             The function memcpy() is thread safe.
30518
30519 memfrob.3
30520     Peng Haitao
30521         ATTRIBUTES: Note function that is thread-safe
30522             The function memfrob() is thread safe.
30523
30524 memmem.3
30525     Peng Haitao
30526         ATTRIBUTES: Note function that is thread-safe
30527             The function memmem() is thread safe.
30528
30529 memmove.3
30530     Peng Haitao
30531         ATTRIBUTES: Note function that is thread-safe
30532             The function memmove() is thread safe.
30533
30534 mempcpy.3
30535     Peng Haitao
30536         ATTRIBUTES: Note functions that are thread-safe
30537             The functions mempcpy() and wmempcpy() are thread safe.
30538
30539 memset.3
30540     Peng Haitao
30541         ATTRIBUTES: Note function that is thread-safe
30542             The function memset() is thread safe.
30543
30544 strerror.3
30545     Michael Kerrisk
30546         CONFORMING TO: strerror() and strerror_r() are in POSIX.1-2008
30547     Michael Kerrisk
30548         Add SS heading for strerror_r()
30549
30550 toupper.3
30551     Michael Kerrisk
30552         Rewrite to more explicitly bring locales into the discussion
30553     Michael Kerrisk
30554         Retitle BUGS section to NOTES
30555             These are not really bugs, just background info.
30556
30557 wcrtomb.3
30558 wcsnrtombs.3
30559 wcsrtombs.3
30560 wcstombs.3
30561 wctomb.3
30562     Michael Kerrisk
30563         SEE ALSO: add various entries
30564             Mainly inspired by POSIX
30565
30566 core.5
30567     Mike Frysinger  [Michael Kerrisk]
30568         Document core_pattern %d specifier
30569         Document %P core_pattern specifier
30570     Michael Kerrisk
30571         Rearrange core_pattern specifiers alphabetically
30572
30573 locale.5
30574     Michael Kerrisk
30575         SEE ALSO: add newlocale(3) + duplocale(3)
30576
30577 feature_test_macros.7
30578     Michael Kerrisk  [Joseph S. Myers]
30579         Remove mention of bogus _ISOC95_SOURCE macro
30580             The _ISOC95_SOURCE macro is defined in <features.h>, but it
30581             does nothing. So remove discussion of it, and move some of
30582             the discussion of C95 under the _ISOC99_SOURCE subhead.
30583     Michael Kerrisk  [Carlos O'Donell]
30584         Add packaging note for _BSD_SOURCE/_SVID_SOURCE/_DEFAULT_SOURCE
30585             To compile warning-free across glibc < 2.20 and glibc >= 2.20
30586             code may been to define both _DEFAULT_SOURCE and either
30587             _BSD_SOURCE or _SVID_SOURCE.
30588     Michael Kerrisk
30589         Reword description of C90
30590
30591 locale.7
30592     Michael Kerrisk
30593         Add subsection on POSIX.1-2008 (originally GNU) extensions to locale API
30594     Michael Kerrisk
30595         Remove reference to LI18NUX2000
30596             LI18NUX2000 is difficult to even find these days, and in any case
30597             this page does not document gettext(), so notes about gettext()
30598             in the CONFORMING TO section here make no sense.
30599     Michael Kerrisk
30600         SEE ALSO: add mbstowcs(3) and wcstombs(3)
30601         SEE ALSO: add newlocale(3) + duplocale(3)
30602
30603 man-pages.7
30604     Michael Kerrisk
30605         Add preferred term "superblock"
30606     Michael Kerrisk
30607         Add preferred terms "uppercase" and "lowercase"
30608
30609
30610
30611 ==================== Changes in man-pages-3.64 ====================
30612
30613 Released: 2014-04-06, Munich
30614
30615
30616 Contributors
30617 ------------
30618
30619 The following people contributed patches/fixes or (noted in brackets
30620 in the changelog below) reports, notes, and ideas that have been
30621 incorporated in changes in this release:
30622
30623 Abhay Sachan <sachan.abhay@gmail.com>
30624 Alexey Samsonov <samsonov@google.com>
30625 Andrey Vagin <avagin@openvz.org>
30626 Aneesh Kumar K.V <aneesh.kumar@linux.vnet.ibm.com>
30627 Christoph Hellwig <hch@infradead.org>
30628 David Prévot <taffit@debian.org>
30629 Eric Dumazet <edumazet@google.com>
30630 Eric W. Biederman <ebiederm@xmission.com>
30631 Jan Kara <jack@suse.cz>
30632 Kir Kolyshkin <kir@openvz.org>
30633 Michael Kerrisk <mtk.manpages@gmail.com>
30634 Mike Frysinger <vapier@gentoo.org>
30635 NeilBrown <neilb@suse.de>
30636 Peng Haitao <penght@cn.fujitsu.com>
30637 Peter Hurley <peter@hurleysoftware.com>
30638 Petr Gajdos <pgajdos@suse.cz>
30639 Robert P. J. Day <rpjday@crashcourse.ca>
30640 Vince Weaver <vincent.weaver@maine.edu>
30641 Yuri Kozlov <yuray@komyakino.ru>
30642
30643 Apologies if I missed anyone!
30644
30645
30646 New and rewritten pages
30647 -----------------------
30648
30649 open_by_handle_at.2
30650     Michael Kerrisk [Mike Frysinger, Neil Brown, Aneesh Kumar K.V,
30651     Christoph Hellwig]
30652         New page describing name_to_handle_at(2) and open_by_handle_at(2)
30653
30654 inotify.7
30655     Michael Kerrisk
30656         Rewrite introductory section
30657         Reorganize "Limitations and caveats" subsection
30658     Michael Kerrisk
30659         Further describe the race when adding a watch to a new subtree
30660     Michael Kerrisk
30661         Directory renames may invalidate multiple paths cached by application
30662     Michael Kerrisk
30663         Add paragraph on cache consistency checking
30664     Michael Kerrisk
30665         Mention cache rebuilding to handle overflow events
30666     Michael Kerrisk
30667         Moving an object to another filesystem generates IN_DELETE_SELF
30668     Michael Kerrisk [Jan Kara]
30669         Add text on dealing with rename() events
30670     Michael Kerrisk
30671         Note rationale and consequences of event coalescing
30672     Michael Kerrisk  [Eric W. Biederman]
30673         Inotify doesn't work for remote and pseudo filesystems
30674     Michael Kerrisk
30675         Add some examples of events generated by various system calls
30676     Michael Kerrisk
30677         BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped
30678             A silent change as a result of the fanotify work in kernel 2.6.36.
30679     Michael Kerrisk
30680         Note that IN_DELETE_SELF will be followed by IN_IGNORED
30681     Michael Kerrisk
30682         Note that IN_UNMOUNT will be followed by an IN_IGNORED event
30683     Michael Kerrisk
30684         Inotify does not report events for mmap(2) and msync(2)
30685     Michael Kerrisk
30686         Add examples of syscalls that trigger IN_ATTRIB
30687     Michael Kerrisk
30688         Add some examples of syscalls that trigger IN_MODIFY
30689     Michael Kerrisk
30690         execve(2) also generates IN_ACCESS
30691     Michael Kerrisk
30692         Add examples of syscalls that trigger IN_CREATE
30693
30694
30695 Newly documented interfaces in existing pages
30696 ---------------------------------------------
30697
30698 perf_event_open.2
30699     Vince Weaver [Michael Kerrisk]
30700         Document the PERF_FLAG_FD_CLOEXEC flag
30701             The Linux 3.14 release adds support for the PERF_FLAG_FD_CLOEXEC
30702             flag.
30703
30704 feature_test_macros.7
30705     Michael Kerrisk
30706         Document _LARGEFILE_SOURCE
30707
30708 tcp.7
30709     Michael Kerrisk  [Eric Dumazet]
30710         Document /proc/sys/net/ipv4/tcp_autocorking
30711             Text heavily based on Documentation/networking/ip-sysctl.txt
30712
30713
30714 New and changed links
30715 ---------------------
30716
30717 name_to_handle_at.2
30718     Michael Kerrisk
30719         New link to new open_by_handle_at(2) page
30720
30721
30722 Global changes
30723 --------------
30724
30725 fmemopen.3
30726 getaddrinfo.3
30727 mq_notify.3
30728 offsetof.3
30729 aio.7
30730     Michael Kerrisk
30731         Print size_t/ssize_t values using %z printf() modifier
30732             There are fewer and fewer systems these days that don't
30733             support the %z specifier mandated in C99.  So replace the
30734             use of %ld/%lu + (long) cast with %zd/%zu.
30735
30736
30737 Changes to individual pages
30738 ---------------------------
30739
30740 bdflush.2
30741 fsync.2
30742 sync.2
30743     Kir Kolyshkin
30744         SEE ALSO: remove update(8) reference
30745             Remove reference to update(8) man page, since there is no such
30746             page. This is an ancient BSD leftover I believe.
30747
30748 chown.2
30749     Michael Kerrisk
30750         Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
30751
30752 getxattr.2
30753     Abhay Sachan
30754         Fix RETURN VALUE description
30755             A EA can have length zero.
30756
30757 inotify_add_watch.2
30758     Michael Kerrisk
30759         ERRORS: add ENAMETOOLONG
30760
30761 inotify_init.2
30762     Michael Kerrisk
30763         Add pointer to inotify(7)
30764
30765 link.2
30766     Michael Kerrisk
30767         When AT_EMPTY_PATH is specified, 'olddirfd' must not refer to a
30768         directory
30769
30770 mmap.2
30771     Andrey Vagin
30772         The file descriptor for a file mapping must be readable
30773             There is no difference between MAP_SHARED and MAP_PRIVATE.
30774
30775 open.2
30776     Michael Kerrisk
30777         SEE ALSO: add open_by_name_at(2)
30778
30779 perf_event_open.2
30780     Vince Weaver
30781         Document PERF_EVENT_IOC_PERIOD behavior change
30782             Linux 3.14 (in commit bad7192b842c83e580747ca57104dd51fe08c223)
30783             changes the perf_event PERF_EVENT_IOC_PERIOD ioctl() behavior
30784             on all architectures to update immediately, to match the behavior
30785             found on ARM.
30786
30787 stat.2
30788     Michael Kerrisk
30789         Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
30790
30791 syscalls.2
30792     Michael Kerrisk
30793         Add sched_getattr() and sched_setattr()
30794             And update kernel version to 3.14
30795
30796 abort.3
30797     Peng Haitao
30798         ATTRIBUTES: Note function that is thread-safe
30799             The function abort() is thread safe.
30800
30801 confstr.3
30802     Michael Kerrisk
30803         SEE ALSO: add getconf(1), fpathconf(3), sysconf(3), pathconf(3)
30804
30805 exit.3
30806     Peng Haitao
30807         ATTRIBUTES: Note function that is not thread-safe
30808             The function exit() is not thread safe.
30809
30810 fenv.3
30811     Peng Haitao
30812         ATTRIBUTES: Note functions that are thread-safe
30813             The functions feclearexcept(), fegetexceptflag(), feraiseexcept(),
30814             fesetexceptflag(), fetestexcept(), fegetround(), fesetround(),
30815             fegetenv(), feholdexcept(), fesetenv(), feupdateenv(),
30816             feenableexcept(), fedisableexcept() and fegetexcept() are thread
30817             safe.
30818
30819 fpathconf.3
30820     Michael Kerrisk
30821         SEE ALSO: add confstr(3)
30822
30823 fseek.3
30824     Michael Kerrisk  [Petr Gajdos]
30825         Document EINVAL error for negative file offset
30826
30827 fseeko.3
30828     Michael Kerrisk
30829         Add feature test macro requirements
30830
30831 fts.3
30832     Michael Kerrisk  [Mike Frysinger]
30833         Remove mention of "32-bit systems" in BUGS
30834
30835 fwide.3
30836 wprintf.3
30837     Michael Kerrisk  [Robert P. J. Day]
30838         Remove mention of bogus _ISOC95_SOURCE feature test macro
30839
30840 getline.3
30841     Alexey Samsonov
30842         Caller should free the allocated buffer even if getline() failed
30843             Relevant discussion in glibc bugzilla:
30844             https://sourceware.org/bugzilla/show_bug.cgi?id=5666
30845
30846 getloadavg.3
30847     Peng Haitao
30848         ATTRIBUTES: Note function that is thread-safe
30849             The function getloadavg() is thread safe.
30850
30851 getpt.3
30852     Peng Haitao
30853         ATTRIBUTES: Note function that is thread-safe
30854             The function getpt() is thread safe.
30855
30856 if_nametoindex.3
30857     Peng Haitao
30858         ATTRIBUTES: Note functions that are thread-safe
30859             The functions if_nametoindex() and if_indextoname() are thread safe.
30860
30861 index.3
30862     Peng Haitao
30863         ATTRIBUTES: Note functions that are thread-safe
30864             The functions index() and rindex() are thread safe.
30865
30866 mkfifo.3
30867     Peng Haitao
30868         ATTRIBUTES: Note functions that are thread-safe
30869             The functions mkfifo() and mkfifoat() are thread safe.
30870
30871 netlink.3
30872     Michael Kerrisk
30873         SEE ALSO: make the reference for libnetlink the libnetlink(3) man page
30874
30875 random.3
30876     Peng Haitao
30877         ATTRIBUTES: Note functions that are thread-safe
30878             The functions random(), srandom(), initstate() and setstate()
30879             are thread safe.
30880
30881 random_r.3
30882     Peng Haitao
30883         ATTRIBUTES: Note functions that are thread-safe
30884             The functions random_r(), srandom_r(), initstate_r() and
30885             setstate_r() are thread safe.
30886
30887 sigvec.3
30888     Peng Haitao
30889         ATTRIBUTES: Note functions that are thread-safe
30890             The functions sigvec(), sigblock(), sigsetmask() and
30891             siggetmask() are thread safe.
30892
30893             The macro sigmask() is thread safe.
30894
30895 sysconf.3
30896     Michael Kerrisk
30897         SEE ALSO: add confstr(3)
30898
30899 termios.3
30900     Michael Kerrisk  [Peter Hurley]
30901         Fix error in discussion of MIN > 0, TIME == 0 noncanonical mode
30902             As reported by Peter Hurley, for the MIN > 0, TIME == 0 case:
30903
30904                 read() may unblock when MIN bytes are available but return
30905                 up to the 'count' parameter if more input arrives in between
30906                 waking and copying into the user buffer.
30907                 ...
30908                 read() may also _not_ return until MIN bytes have been
30909                 received, even if 'count' bytes have been received.
30910     Michael Kerrisk
30911         Add a note on interaction of O_NONBLOCK with noncanonical MIN/TIME
30912             POSIX leaves the behavior open.
30913     Michael Kerrisk
30914         Clarify termination conditions for MIN > 0, TIME > 0
30915     Michael Kerrisk
30916         Clarify behavior if data is available before noncanonical read()
30917     Michael Kerrisk
30918         Add descriptive titles to noncanonical read() cases
30919
30920 symlink.7
30921     Michael Kerrisk
30922         Add subsection on opening a symbolic link with O_PATH
30923     Michael Kerrisk
30924         name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
30925     Michael Kerrisk
30926         Mention use of readlink(2) to read contents of a symlink
30927
30928
30929 ==================== Changes in man-pages-3.65 ====================
30930
30931 Released: 2014-04-20, Munich
30932
30933
30934 Contributors
30935 ------------
30936
30937 The following people contributed patches/fixes or (noted in brackets
30938 in the changelog below) reports, notes, and ideas that have been
30939 incorporated in changes in this release:
30940
30941 Alex Thorlton <athorlton@sgi.com>
30942 Ashish Sangwan <a.sangwan@samsung.com>
30943 Christopher Covington <cov@codeaurora.org>
30944 Christoph Hellwig <hch@infradead.org>
30945 Craig McQueen <craig.mcqueen@beamcommunications.com>
30946 Dave Chinner <david@fromorbit.com>
30947 David Prévot <taffit@debian.org>
30948 Greg Troxel <gdt@ir.bbn.com>
30949 Matthew Dempsky <mdempsky@chromium.org>
30950 Michael Kerrisk <mtk.manpages@gmail.com>
30951 Mike Frysinger <vapier@gentoo.org>
30952 Namjae Jeon <namjae.jeon@samsung.com>
30953 Peng Haitao <penght@cn.fujitsu.com>
30954 Petr Gajdos <pgajdos@suse.cz>
30955 Richard Hansen <rhansen@bbn.com>
30956 Simon Paillard <spaillard@debian.org>
30957 Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
30958 Vince Weaver <vincent.weaver@maine.edu>
30959 Yuri Kozlov <yuray@komyakino.ru>
30960
30961 Apologies if I missed anyone!
30962
30963
30964 New and rewritten pages
30965 -----------------------
30966
30967 inet_net_pton.3
30968     Michael Kerrisk
30969         New page describing inet_net_pton(3) and inet_net_ntop(3)
30970
30971
30972 Newly documented interfaces in existing pages
30973 ---------------------------------------------
30974
30975 fallocate.2
30976     Michael Kerrisk, Namjae Jeon [Christoph Hellwig, Dave Chinner]
30977         Document FALLOC_FL_COLLAPSE_RANGE
30978
30979 prctl.2
30980     Michael Kerrisk  [Alex Thorlton]
30981         Document PR_SET_THP_DISABLE and PR_GET_THP_DISABLE
30982
30983 proc.5
30984     Michael Kerrisk
30985         Document /proc/[pid]/stack
30986     Michael Kerrisk
30987         Document /proc/[pid]/clear_refs
30988
30989
30990 New and changed links
30991 ---------------------
30992
30993 inet_net_ntop.3
30994     Michael Kerrisk
30995         New link to new inet_net_pton.3
30996
30997
30998 Changes to individual pages
30999 ---------------------------
31000
31001 fcntl.2
31002     Michael Kerrisk
31003         Note the race when O_CLOEXEC is used at same time as fork()+execve()
31004
31005 madvise.2
31006     Michael Kerrisk
31007         SEE ALSO: see prctl(2)
31008             Because of PR_SET_THP_DISABLE.
31009
31010 mlock.2
31011     Michael Kerrisk
31012         Describe treatment of MCL_FUTURE during fork(2) and execve(2)
31013
31014 msync.2
31015     Michael Kerrisk  [Richard Hansen, Greg Troxel]
31016         Warn that one of MS_SYNC or MS_ASYNC is required
31017
31018 open.2
31019     Michael Kerrisk
31020         Add more detail on the race that O_CLOEXEC is designed to avoid
31021     Michael Kerrisk  [Matthew Dempsky]
31022         Remove crufty text stating that O_DIRECTORY is Linux-specific
31023     Michael Kerrisk
31024         Note which filesystems support O_TMPFILE
31025
31026 perf_event_open.2
31027     Vince Weaver [Michael Kerrisk]
31028         Clarify EACCES and EPERM errors
31029             Clarify the reasons for EACCES and EPERM errors.
31030     Vince Weaver [Michael Kerrisk]
31031         Make the ERRORS section more comprehensive.
31032             Determined both by code inspection and by writing a large
31033             number of test programs.
31034
31035 personality.2
31036     Michael Kerrisk
31037         Available execution domains are listed in <sys/personality.h>
31038     Michael Kerrisk
31039         Fix discussion of return value
31040
31041 prctl.2
31042     Michael Kerrisk
31043         ERRORS: document EINVAL for PR_GET_NO_NEW_PRIVS
31044         ERRORS: document EINVAL for PR_SET_PDEATHSIG
31045         ERRORS: document EINVAL for PR_SET_TIMING
31046         ERRORS: document EINVAL for PR_SET_DUMPABLE
31047         ERRORS: document EINVAL for PR_SET_NO_NEW_PRIVS
31048
31049 shmget.2
31050     Michael Kerrisk
31051         Rewrite description of SHMMNI default value
31052     Michael Kerrisk
31053         Note default value of SHMMAX
31054         Note default value for SHMALL
31055
31056 byteorder.3
31057     Peng Haitao
31058         ATTRIBUTES: Note functions that are thread-safe
31059             The functions htonl(), htons(), ntohl() and ntohs() are thread
31060             safe.
31061
31062 fexecve.3
31063     Michael Kerrisk  [Steven Stewart-Gallus]
31064         If 'fd' is a close-on-exec file descriptor for a script, fexecve() fails
31065             See https://bugzilla.kernel.org/show_bug.cgi?id=74481
31066
31067 ffs.3
31068     Peng Haitao
31069         ATTRIBUTES: Note functions that are thread-safe
31070             The functions ffs(), ffsl() and ffsll() are thread safe.
31071
31072 getauxval.3
31073     Peng Haitao
31074         ATTRIBUTES: Note function that is thread-safe
31075             The function getauxval() is thread safe.
31076
31077 getcontext.3
31078     Peng Haitao
31079         ATTRIBUTES: Note functions that are thread-safe
31080             The functions getcontext() and setcontext() are thread safe.
31081
31082 getsubopt.3
31083     Peng Haitao
31084         ATTRIBUTES: Note function that is thread-safe
31085             The function getsubopt() is thread safe.
31086
31087 getutmp.3
31088     Peng Haitao
31089         ATTRIBUTES: Note functions that are thread-safe
31090             The functions getutmp() and getutmpx() are thread safe.
31091
31092 inet.3
31093     Michael Kerrisk
31094         Note success and error return for inet_aton()
31095
31096 inet.3
31097     Michael Kerrisk  [Craig McQueen]
31098         The form 'a.b' if is suitable for Class A addresses (not class C)
31099     Michael Kerrisk
31100         SEE ALSO: add inet_net_pton(3)
31101
31102 makecontext.3
31103     Peng Haitao
31104         ATTRIBUTES: Note functions that are thread-safe
31105             The functions makecontext() and swapcontext() are thread safe.
31106
31107 pthread_attr_setdetachstate.3
31108     Peng Haitao
31109         ATTRIBUTES: Note functions that are thread-safe
31110             The functions pthread_attr_setdetachstate() and
31111             pthread_attr_getdetachstate() are thread safe.
31112
31113 pthread_attr_setguardsize.3
31114     Peng Haitao
31115         ATTRIBUTES: Note functions that are thread-safe
31116             The functions pthread_attr_setguardsize() and
31117             pthread_attr_getguardsize() are thread safe.
31118
31119 sigsetops.3
31120     Peng Haitao
31121         ATTRIBUTES: Note functions that are thread-safe
31122             The functions sigemptyset(), sigfillset(), sigaddset(),
31123             sigdelset(), sigismember(), sigisemptyset(), sigorset() and
31124             sigandset() are thread safe.
31125
31126 proc.5
31127     Petr Gajdos
31128         Improve /proc/[pid]/smaps entries description
31129     Michael Kerrisk
31130         /proc/PID/smaps is present only if CONFIG_PROC_PAGE_MONITOR
31131     Michael Kerrisk
31132         Note kernel version for /proc/sys/kernel/{shmall,shmmax}
31133     Michael Kerrisk
31134         Note kernel version for /proc/sys/kernel/{msgmax,msgmnb}
31135
31136 capabilities.7
31137     Michael Kerrisk
31138         SEE ALSO: add capsh(1)
31139
31140 libc.7
31141     Michael Kerrisk
31142         Add musl libc
31143
31144
31145 ==================== Changes in man-pages-3.66 ====================
31146
31147 Released: 2014-05-08, Munich
31148
31149
31150 Contributors
31151 ------------
31152
31153 The following people contributed patches/fixes or (noted in brackets
31154 in the changelog below) reports, notes, and ideas that have been
31155 incorporated in changes in this release:
31156
31157 Alan Curry <rlwinm@sdf.org>
31158 Carsten Andrich <carsten.andrich@tu-ilmenau.de>
31159 Daniel Borkmann <dborkman@redhat.com>
31160 David Prévot <taffit@debian.org>
31161 Eric Siegerman <pub08-knl@davor.org>
31162 Heinrich Schuchardt <xypron.glpk@gmx.de>
31163 Jan Kara <jack@suse.cz>
31164 Jan Moskyto Matejka <mq@suse.cz>
31165 John Marshall <jm18@sanger.ac.uk>
31166 Lukáš Czerner <lczerner@redhat.com>
31167 Manfred Spraul <manfred@colorfullife.com>
31168 Michael Kerrisk <mtk.manpages@gmail.com>
31169 Miklos Szeredi <miklos@szeredi.hu>
31170 Neil Horman <nhorman@tuxdriver.com>
31171 Peng Haitao <penght@cn.fujitsu.com>
31172 Peter Schiffer <pschiffe@redhat.com>
31173 Randy Dunlap <rdunlap@infradead.org>
31174 Silvan Jegen <s.jegen@gmail.com>
31175 Simon Paillard <spaillard@debian.org>
31176 Stefan Puiu <stefan.puiu@gmail.com>
31177 Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
31178 Stijn Hinterding <contact@stijnhinterding.nl>
31179 Willem de Bruijn <willemb@google.com>
31180 Yuri Kozlov <yuray@komyakino.ru>
31181
31182 Apologies if I missed anyone!
31183
31184
31185 New and rewritten pages
31186 -----------------------
31187
31188 fanotify_init.2
31189     Heinrich Schuchardt, Michael Kerrisk
31190         New page documenting fanotify_init(2)
31191
31192 fanotify_mark.2
31193     Heinrich Schuchardt, Michael Kerrisk
31194         New page documenting fanotify_mark(2)
31195
31196 sched_setscheduler.2
31197     Michael Kerrisk
31198         Page rewritten
31199             Stripped out the general scheduling material, which
31200             moved to sched(7), and rewrote much of the remainder.
31201             Changed copyright and license since pretty much all
31202             of the content was or is written by mtk.
31203
31204 fanotify.7
31205     Heinrich Schuchardt, Michael Kerrisk
31206         New page providing overview of the fanotify API
31207
31208 sched.7
31209     Michael Kerrisk
31210         New page providing an overview of the scheduling APIs
31211             Most of this content derives from sched_setscheduler(2). In
31212             preparation for adding a sched_setattr(2) page, it makes
31213             sense to isolate out this general content to a separate
31214             page that is referred to by the other scheduling pages.
31215
31216
31217 Newly documented interfaces in existing pages
31218 ---------------------------------------------
31219
31220 fallocate.2
31221     Lukas Czerner [Michael Kerrisk]
31222         Document FALLOC_FL_ZERO_RANGE
31223             FALLOC_FL_ZERO_RANGE was added in Linux 3.14,
31224             for zeroing ranges in the allocated space in a file.
31225
31226 rename.2
31227     Miklos Szeredi [Michael Kerrisk]
31228         Document renameat2() system call added in Linux 3.15
31229
31230 shmop.2
31231     Michael Kerrisk
31232         Document SHM_EXEC
31233
31234
31235 Changes to individual pages
31236 ---------------------------
31237
31238 flock.2
31239     Michael Kerrisk
31240         Employ term "open file description" in DESCRIPTION
31241             And include reference to open(2) for an explanation of the term.
31242
31243 getpriority.2
31244     Michael Kerrisk
31245         SEE ALSO: add sched(7)
31246
31247 getsockopt.2
31248     Carsten Andrich
31249         SEE ALSO: add packet(7)
31250
31251 link.2
31252     Michael Kerrisk  [Steven Stewart-Gallus]
31253         Document ENOENT error for linkat()
31254             See https://bugzilla.kernel.org/show_bug.cgi?id=73301
31255
31256 msgget.2
31257     Michael Kerrisk
31258         Reword EEXIST error
31259
31260 msgop.2
31261     Michael Kerrisk
31262         Note capability required to raise MQ size beyond MSGMNB
31263
31264 msync.2
31265     Michael Kerrisk  [Heinrich Schuchardt]
31266         s/flushes... back to disk/flushes... back to filesystem/
31267
31268 nice.2
31269     Michael Kerrisk
31270         SEE ALSO: add sched(7)
31271
31272 open.2
31273     Peter Schiffer
31274         Update note on alignment of user buffer and file offset for O_DIRECT
31275             The sentence in open(2) man page in notes for O_DIRECT flag:
31276
31277                 "Under Linux 2.6, alignment to 512-byte boundaries suffices."
31278
31279             is not universally correct. The alignment is a property of the
31280             storage, for example, 4k-sector drives with no 512 byte sector
31281             emulation will be unable to perform 512-byte direct I/O.
31282     Michael Kerrisk
31283         Note some of the various synonyms for "open file description"
31284     Michael Kerrisk
31285         Remove repetitious text on use of fcntl() to change file status flags
31286
31287 open_by_handle_at.2
31288     Michael Kerrisk
31289         Mention FreeBSD analogs
31290
31291 posix_fadvise.2
31292     Michael Kerrisk  [Eric Siegerman]
31293         Fix wording error under "Architecture-specific variants"
31294             See https://bugzilla.kernel.org/show_bug.cgi?id=75431
31295
31296 process_vm_readv.2
31297     Michael Kerrisk  [Stijn Hinterding]
31298         Add feature test macro requirements
31299             The _GNU_SOURCE FTM must be defined.
31300
31301 read.2
31302     Michael Kerrisk
31303         BUGS: detail nonatomicity bug with respect to file offset updates
31304             This bug was fixed in Linux 3.14, with commit
31305             9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
31306             See also http://thread.gmane.org/gmane.linux.kernel/1649458
31307
31308 sched_get_priority_max.2
31309     Michael Kerrisk
31310         Small changes consistent with migration of content to sched(7)
31311
31312 sched_rr_get_interval.2
31313     Michael Kerrisk
31314         Small changes consistent with migration of content to sched(7)
31315
31316 sched_setaffinity.2
31317     Michael Kerrisk
31318         Small changes consistent with migration of content to sched(7)
31319
31320 sched_setparam.2
31321     Michael Kerrisk
31322         Small changes consistent with migration of content to sched(7)
31323
31324 sched_yield.2
31325     Michael Kerrisk
31326         Small changes consistent with migration of content to sched(7)
31327
31328 semget.2
31329     Michael Kerrisk
31330         Consolidate discussion on noninitialization of semaphores
31331             The fact that semget() does not initialize the semaphores
31332             in a new set was covered in two places (in DESCRIPTION
31333             and BUGS). Consolidate these into one place (in NOTES)
31334             and also point out that POSIX.1-2008 says that a future
31335             version of the standard may require an implementation to
31336             initialize the semaphores to 0.
31337     Michael Kerrisk
31338         Clarify SEMMNS versus SEMMSL*SEMMNI
31339     Michael Kerrisk
31340         Rework EINVAL text a little
31341     Michael Kerrisk
31342         Clarify wording for EEXIST error
31343
31344 shmget.2
31345     Manfred Spraul
31346         Clarify SHMALL
31347             The default for SHMALL is a limit of 8 GB, regardless of
31348             PAGE_SIZE. The current documentation does not mention that
31349             and is therefore more difficult to understand than necessary.
31350     Manfred Spraul
31351         Correct math error
31352             2097152 is 2^21, not 2^20.
31353     Michael Kerrisk
31354         Reword EEXIST error
31355     Michael Kerrisk
31356         Clarify one of the EINVAL cases
31357     Michael Kerrisk
31358         Note that SHM_NORESERVE is a Linux extension
31359     Michael Kerrisk  [Simon Paillard]
31360         Fix kernel version numbers in discussion of SHMALL
31361     Michael Kerrisk
31362         Rework EINVAL text
31363     Michael Kerrisk
31364         Move and rework discussion of mode bits
31365     Michael Kerrisk
31366         Reword description of O_EXCL
31367
31368 shmop.2
31369     Michael Kerrisk
31370         Move fork(2), execve(2), _exit(2) discussion to NOTES
31371     Michael Kerrisk
31372         Add subheads for shmat() and shmdt()
31373     Michael Kerrisk
31374         Rework discussion of SHM_RDONLY and SHM_REMAP into list format
31375     Michael Kerrisk
31376         Structure the attach cases as a list
31377
31378 sigaction.2
31379     Alan Curry
31380         Fix bad cross reference (times(2) not time(2))
31381             The system call that reports child CPU usage is times(2),
31382             not time(2).
31383
31384 symlink.2
31385     Michael Kerrisk  [Steven Stewart-Gallus]
31386         Document ENOENT error for symlinkat()
31387             See https://bugzilla.kernel.org/show_bug.cgi?id=73301
31388
31389 syscalls.2
31390     Michael Kerrisk
31391         Add renameat2()
31392             And bump kernel version.
31393
31394 write.2
31395     Michael Kerrisk
31396         BUGS: detail nonatomicity bug with respect to file offset updates
31397             This bug was fixed in Linux 3.14, with commit
31398             9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
31399             See also http://thread.gmane.org/gmane.linux.kernel/1649458
31400
31401 pthread_attr_setinheritsched.3
31402     Peng Haitao
31403         ATTRIBUTES: Note functions that are thread-safe
31404             The functions pthread_attr_setinheritsched() and
31405             pthread_attr_getinheritsched() are thread safe.
31406
31407 pthread_attr_setschedparam.3
31408     Peng Haitao
31409         ATTRIBUTES: Note functions that are thread-safe
31410             The functions pthread_attr_setschedparam() and
31411             pthread_attr_getschedparam() are thread safe.
31412
31413 pthread_attr_setschedpolicy.3
31414     Peng Haitao
31415         ATTRIBUTES: Note functions that are thread-safe
31416             The functions pthread_attr_setschedpolicy() and
31417             pthread_attr_getschedpolicy() are thread safe.
31418
31419 pthread_attr_setscope.3
31420     Peng Haitao
31421         ATTRIBUTES: Note functions that are thread-safe
31422             The functions pthread_attr_setscope() and pthread_attr_getscope()
31423             are thread safe.
31424
31425 pthread_attr_setstack.3
31426     Peng Haitao
31427         ATTRIBUTES: Note functions that are thread-safe
31428             The functions pthread_attr_setstack() and pthread_attr_getstack()
31429             are thread safe.
31430
31431 sched_getcpu.3
31432     Michael Kerrisk
31433         SEE ALSO: add sched(7)
31434
31435 termios.3
31436     Michael Kerrisk  [Yuri Kozlov]
31437         Rework intro text for 'c_oflag'
31438     Michael Kerrisk
31439         OFDEL is in POSIX.1-2001, so remove "(Not in POSIX)" text
31440
31441 proc.5
31442     Jan Moskyto Matejka  [Randy Dunlap]
31443         Improve description of /proc/stat 'intr' field
31444             The sum at the beginning of line "intr" includes also
31445             unnumbered interrupts.
31446
31447 packet.7
31448     Carsten Andrich  [Neil Horman]
31449         Improve sockopt documentation for packet sockets
31450     Carsten Andrich  [Willem de Bruijn]
31451         PACKET_LOSS has inverse meaning
31452     Stefan Puiu  [Daniel Borkmann, Carsten Andrich]
31453         Status in PACKET_RX_RING is actually a bit mask
31454     Michael Kerrisk  [Carsten Andrich]
31455         SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c
31456
31457
31458 ==================== Changes in man-pages-3.67 ====================
31459
31460 Released: 2014-05-21, Munich
31461
31462
31463 Contributors
31464 ------------
31465
31466 The following people contributed patches/fixes or (noted in brackets
31467 in the changelog below) reports, notes, and ideas that have been
31468 incorporated in changes in this release:
31469
31470 Andy Lutomirski <luto@amacapital.net>
31471 Aurelien Jarno <aurelien@aurel32.net>
31472 Bill Allombert <ballombe@debian.org>
31473 Christoph Hellwig <hch@infradead.org>
31474 Davidlohr Bueso <davidlohr@hp.com>
31475 Heinrich Schuchardt <xypron.glpk@gmx.de>
31476 Ingo Schwarze <schwarze@usta.de>
31477 Jan Kara <jack@suse.cz>
31478 Jon Grant <jg@jguk.org>
31479 Juri Lelli <juri.lelli@gmail.com>
31480 Lucas De Marchi <lucas.demarchi@profusion.mobi>
31481 Michael Kerrisk <mtk.manpages@gmail.com>
31482 Peng Haitao <penght@cn.fujitsu.com>
31483 Peter Zijlstra <peterz@infradead.org>
31484 Rasmus Villemoes <rv@rasmusvillemoes.dk>
31485 Sam Varshavchik <mrsam@courier-mta.com>
31486 Simon Paillard <spaillard@debian.org>
31487 Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
31488 Török Edwin <edwin@etorok.net>
31489 William Morriss <wjmelements@gmail.com>
31490 Yuri Kozlov <yuray@komyakino.ru>
31491
31492 Apologies if I missed anyone!
31493
31494
31495 New and rewritten pages
31496 -----------------------
31497
31498 sched_setattr.2
31499     Michael Kerrisk, Peter Zijlstra [Juri Lelli]
31500         New page describing sched_setattr(2) and sched_getattr(2)
31501
31502 system.3
31503     Michael Kerrisk
31504         Rewrote large parts of the page and added a number of details
31505
31506
31507 Newly documented interfaces in existing pages
31508 ---------------------------------------------
31509
31510 sched.7
31511     Peter Zijlstra, Michael Kerrisk  [Juri Lelli]
31512         Document SCHED_DEADLINE
31513
31514 New and changed links
31515 ---------------------
31516
31517 renameat2.2
31518     Michael Kerrisk
31519         New link to rename.2
31520
31521 sched_getattr.2
31522     Michael Kerrisk
31523         New link to new sched_setattr
31524
31525
31526 Changes to individual pages
31527 ---------------------------
31528
31529 bind.2
31530     Michael Kerrisk
31531         ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
31532
31533 chown.2
31534     Michael Kerrisk
31535         NOTES: Add some subheadings
31536
31537 connect.2
31538     Michael Kerrisk  [William Morriss]
31539         ERRORS: Add EADDRNOTAVAIL for ephemeral port range exhaustion
31540             Verified from testing and the kernel source.
31541             See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=745775
31542     Michael Kerrisk
31543         Remove mention of ip_local_port_range under EAGAIN error
31544
31545 create_module.2
31546 delete_module.2
31547 init_module.2
31548 query_module.2
31549     Michael Kerrisk  [Lucas De Marchi]
31550         Clarify glibc header file declaration/ABI wrapper details
31551             create_module(), delete_module(), init_module(), and
31552             query_module() are not declared in header files, but
31553             through an accident of history glibc provides an ABI
31554             for them that it continues to maintain, for
31555             compatibility reasons.
31556
31557 execve.2
31558     Michael Kerrisk  [Steven Stewart-Gallus]
31559         Note SIGKILL case when execve() fails beyond the point of no return
31560     Michael Kerrisk
31561         NOTES: Add a subheading and reorder paragraphs
31562
31563 fanotify_init.2
31564     Heinrich Schuchardt [Michael Kerrisk]
31565         Document range of permitted flags for event_f_flags
31566             With a new patch included in the mm tree, event_f_flags is
31567             checked for allowable values.
31568
31569 fcntl.2
31570     Michael Kerrisk
31571         Add "file locking" subheading under NOTES
31572
31573 fork.2
31574     Michael Kerrisk
31575         ERRORS: SCHED_DEADLINE tasks can fail with EAGAIN
31576             SCHED_DEADLINE tasks can fail with EAGAIN unless the
31577             reset-on-fork flag is set.
31578
31579 futex.2
31580     Michael Kerrisk
31581         Note that there is no glibc wrapper
31582
31583 getpriority.2
31584     Rasmus Villemoes
31585         Fix prototypes for getpriority() and setpriority()
31586             The who argument has type id_t (which happens to be u32 on linux).
31587
31588 get_robust_list.2
31589     Rasmus Villemoes
31590         Add <sys/types.h> to synopsis of get_robust_list()
31591             If one were to implement wrappers for [gs]et_robust_list() using the
31592             given prototypes, one would also have to include sys/types.h to get
31593             a definition of size_t.
31594
31595 getrusage.2
31596     Michael Kerrisk  [Bill Allombert]
31597         _GNU_SOURCE must be defined to obtain RUSAGE_THREAD definition
31598             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=746569
31599
31600 link.2
31601 open.2
31602     Andy Lutomirski [Michael Kerrisk]
31603         Update AT_EMPTY_PATH and O_PATH documentation
31604
31605 listen.2
31606     Michael Kerrisk
31607         ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
31608
31609 mbind.2
31610     Rasmus Villemoes
31611         Fix prototype for mbind(2)
31612             The nmask argument is const. The return type in numaif.h is long.
31613             (Well, at least <numaif.h> says nmask is const. The current kernel
31614             does not define it as a const argument, but sys_mbind() only
31615             passes it to get_nodes(), which does treat it as const.)
31616
31617 msgop.2
31618     Davidlohr Bueso [Michael Kerrisk]
31619         Enhance description of "full queue" criteria
31620
31621 poll.2
31622     Rasmus Villemoes
31623         Add <signal.h> to synopsis for ppoll()
31624             One needs to #include <signal.h> to get the definition of the
31625             type (sigset_t) of the mask argument to ppoll().
31626
31627 readlink.2
31628     Rasmus Villemoes
31629         Fix return type of readlinkat()
31630
31631 recv.2
31632     Michael Kerrisk
31633         Clarify details of msg_name and msg_namelen fields
31634
31635 recvmmsg.2
31636     Michael Kerrisk
31637         Describe timeout bug
31638             See https://bugzilla.kernel.org/show_bug.cgi?id=75371
31639             and http://thread.gmane.org/gmane.linux.man/5677
31640
31641 remap_file_pages.2
31642     Andy Lutomirski [Christoph Hellwig, Andy Lutomirski]
31643         remap_file_pages() has no benefit for real files
31644             Linux commit 3ee6dafc677a68e461a7ddafc94a580ebab80735 caused
31645             remap_file_pages to be emulated when used on real file.
31646
31647 sched_get_priority_max.2
31648     Michael Kerrisk
31649         'policy' can also be SCHED_DEADLINE
31650
31651 sched_setaffinity.2
31652     Rasmus Villemoes
31653         Fix prototype for sched_setaffinity()
31654             The mask argument is const.
31655
31656 sched_setparam.2
31657     Michael Kerrisk
31658         ERRORS: mark errors that apply just for sched_setparam()
31659     Michael Kerrisk
31660         ERRORS: Add EINVAL for invalid arguments
31661     Michael Kerrisk
31662         SEE ALSO: add sched_setattr(2)
31663
31664 sched_setscheduler.2
31665     Michael Kerrisk
31666         ERRORS: mark errors that apply just to sched_setscheduler()
31667     Michael Kerrisk
31668         ERRORS: add EINVAL case for pid < 0
31669     Michael Kerrisk
31670         ERRORS: separate out EINVAL cases
31671
31672 semget.2
31673     Michael Kerrisk
31674         NOTES: Add subheadings and reorder paragraphs
31675
31676 semop.2
31677     Rasmus Villemoes
31678         Fix prototypes for semop() and semtimedop()
31679             The nsops arguments have type size_t, not unsigned, and the
31680             timeout argument of semtimedop() is const.
31681     Michael Kerrisk
31682         NOTES: Add a subheading
31683
31684 send.2
31685     Michael Kerrisk
31686         Add details on various 'msghdr' fields
31687     Michael Kerrisk
31688         ERRORS: Add EAGAIN for ephemeral port range exhaustion
31689     Michael Kerrisk
31690         Add some subheadings under DESCRIPTION
31691
31692 shmget.2
31693     Michael Kerrisk
31694         NOTES: Add a subheading
31695
31696 stat.2
31697     Michael Kerrisk  [Aurelien Jarno]
31698         Describe feature test macro requirements for file type test macros
31699             See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=728240
31700     Michael Kerrisk
31701         Update FTM requirements for lstat()
31702     Michael Kerrisk
31703         Split discussion of 'st_mode' fields into type and permissions
31704     Michael Kerrisk
31705         Move text on S_I*() macros to follow text on S_I* macros
31706             That ordering is more logical
31707
31708 stime.2
31709     Rasmus Villemoes
31710         Fix prototype for stime()
31711             The argument is const, both according to the actual header files and
31712             according to <http://www.sco.com/developers/devspecs/vol1a.pdf>.
31713
31714 syscall.2
31715     Rasmus Villemoes
31716         Fix prototype for syscall()
31717             The first argument and the return value of syscall() has type long,
31718             not int.
31719
31720 getopt.3
31721     Michael Kerrisk
31722         EXAMPLE: Add subheadings to distinguish the two example programs
31723
31724 malloc.3
31725     Michael Kerrisk
31726         Reword text referring to mallopt(3)
31727             Linux libc is no longer "recent"; drop mention of it.
31728
31729 pthread_attr_setinheritsched.3
31730 pthread_attr_setschedparam.3
31731 pthread_attr_setschedpolicy.3
31732 pthread_setaffinity_np.3
31733 pthread_setschedparam.3
31734 pthread_setschedprio.3
31735 pthread_yield.3
31736 pthreads.7
31737     Michael Kerrisk
31738         Change references to "sched_setscheduler(2)" to "sched(7)"
31739             Change consistent with the fact that the scheduling overview
31740             page is now sched(7) not sched_setscheduler(2).
31741
31742 pthread_attr_setstackaddr.3
31743     Peng Haitao
31744         ATTRIBUTES: Note functions that are thread-safe
31745             The functions pthread_attr_setstackaddr() and
31746             pthread_attr_getstackaddr() are thread safe.
31747
31748 pthread_attr_setstacksize.3
31749     Peng Haitao
31750         ATTRIBUTES: Note functions that are thread-safe
31751             The functions pthread_attr_setstacksize() and
31752             pthread_attr_getstacksize() are thread safe.
31753
31754 pthread_kill.3
31755     Peng Haitao
31756         ATTRIBUTES: Note function that is thread-safe
31757             The function pthread_kill() is thread safe.
31758
31759 pthread_kill_other_threads_np.3
31760     Peng Haitao
31761         ATTRIBUTES: Note function that is thread-safe
31762             The function pthread_kill_other_threads_np() is thread safe.
31763
31764 pthread_self.3
31765     Peng Haitao
31766         ATTRIBUTES: Note function that is thread-safe
31767             The function pthread_self() is thread safe.
31768
31769 pthread_setcancelstate.3
31770     Michael Kerrisk
31771         Add paragraph breaks to "Asynchronous cancelability" subsection
31772
31773 pthread_setcancelstate.3
31774     Peng Haitao
31775         ATTRIBUTES: Note functions that are thread-safe
31776             The functions pthread_setcancelstate() and
31777             pthread_setcanceltype() are thread safe.
31778     Michael Kerrisk
31779         NOTES: Add some subheadings
31780
31781 pthread_setschedparam.3
31782     Peng Haitao
31783         ATTRIBUTES: Note functions that are thread-safe
31784             The functions pthread_setschedparam() and pthread_getschedparam()
31785             are thread safe.
31786
31787 pthread_setschedprio.3
31788     Peng Haitao
31789         ATTRIBUTES: Note function that is thread-safe
31790             The function pthread_setschedprio() is thread safe.
31791
31792 pthread_sigmask.3
31793     Peng Haitao
31794         ATTRIBUTES: Note function that is thread-safe
31795             The function pthread_sigmask() is thread safe.
31796
31797 pthread_sigqueue.3
31798     Peng Haitao
31799         ATTRIBUTES: Note function that is thread-safe
31800             The function pthread_sigqueue() is thread safe.
31801
31802 pthread_testcancel.3
31803     Peng Haitao
31804         ATTRIBUTES: Note function that is thread-safe
31805             The function pthread_testcancel() is thread safe.
31806
31807 pthread_yield.3
31808     Peng Haitao
31809         ATTRIBUTES: Note function that is thread-safe
31810             The function pthread_yield() is thread safe.
31811
31812 remquo.3
31813     Peng Haitao
31814         ATTRIBUTES: Note functions that are thread-safe
31815             The functions remquo(), remquof() and remquol() are thread safe.
31816
31817 rtime.3
31818     Peng Haitao
31819         ATTRIBUTES: Note function that is thread-safe
31820             The function rtime() is thread safe.
31821
31822 sched_getcpu.3
31823     Peng Haitao
31824         ATTRIBUTES: Note function that is thread-safe
31825             The function sched_getcpu() is thread safe.
31826
31827 stpcpy.3
31828     Ingo Schwarze
31829         Note some history of stpcpy()
31830             Quoting Ingo:
31831             I just noticed that the stpcpy(3) manual contains a speculation
31832             that appears to be untrue on closer investigation:  That function
31833             did not originate in MS DOS, but in Lattice C on AmigaDOS.
31834
31835             Here is a patch against the git master HEAD to fix that, and add
31836             some more historical information.  To provide some background and
31837             allow you to more easily verify the correctness of the patch, i'm
31838             appending my mail to <misc@openbsd.org>, where i'm giving some
31839             more details about the history and pointing to some primary
31840             sources.  That mail also contains the (similar, but shorter)
31841             patch i just committed to the OpenBSD manual page.
31842
31843 strcasecmp.3
31844     Michael Kerrisk  [Aurelien Jarno, Török Edwin]
31845         Explain why strcasecmp()+strncasecmp() are also declared in <string.h>
31846             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729436
31847
31848 strcpy.3
31849     Michael Kerrisk
31850         NOTES: Add a subheading
31851
31852 fd.4
31853     Michael Kerrisk  [Sam Varshavchik]
31854         Fix floppy disk device names
31855             The naming convention shown in the page was ancient.
31856             Now, the page is consistent with Documentation/devices.txt
31857             (where it is noted that "The use of the capital letters
31858             D, H and E for the 3.5" models have been deprecated, since
31859             the drive type is insignificant for these devices"
31860
31861 proc.5
31862     Michael Kerrisk
31863         Document /proc/timer_stats
31864     Michael Kerrisk
31865         (Briefly) document /proc/timer_list
31866     Michael Kerrisk
31867         Add /proc/sys/kernel/{sched_rt_period_us,sched_rt_runtime_us}
31868             Reference sched(7) for an explanation of these two files
31869
31870 capabilities.7
31871     Michael Kerrisk
31872         Mention sched_setattr(2) under CAP_SYS_NICE
31873
31874 cpuset.7
31875     Michael Kerrisk
31876         SEE ALSO: add sched(7)
31877
31878 credentials.7
31879     Michael Kerrisk
31880         Mention sched_getattr() as a place where credentials are checked
31881
31882 fanotify.7
31883     Heinrich Schuchardt  [Jan Kara]
31884         BUGS: error events can be lost when reading from fanotify FD
31885     Michael Kerrisk  [Heinrich Schuchardt]
31886         Fix description of FAN_EVENT_NEXT()
31887             FAN_EVENT_NEXT() does not update 'meta'; rather, it returns a
31888             pointer to the next metadata structure. In addition, generally
31889             rework the description to be a bit clearer and more detailed.
31890     Heinrich Schuchardt
31891         Document FAN_EVENT_METADATA_LEN
31892
31893 ip.7
31894     Michael Kerrisk
31895         Note cases where an ephemeral port is used
31896     Michael Kerrisk
31897         Remove BUGS text on glibc failing to declare in_pktinfo
31898     Michael Kerrisk
31899         Clarify 'ip_local_port_range' and mention the term "ephemeral ports"
31900     Michael Kerrisk
31901         Note some more details about assignment of ephemeral ports
31902     Michael Kerrisk
31903         BUGS: ephemeral port range exhaustion is diagnosed inconsistently
31904             Different system calls use different 'errno' values to diagnose
31905             exhaustion of the ephemeral port range.
31906
31907 sched.7
31908     Michael Kerrisk
31909         Document sched_rt_period_us and sched_rt_runtime_us /proc files
31910             And rework and relocate the text on dealing with runaway
31911             real-time processes.
31912     Michael Kerrisk
31913         Mention sched_setattr(2) in list of APIs that can change policies
31914     Michael Kerrisk
31915         sched_setattr(2) can also be used to set 'nice' value
31916     Michael Kerrisk
31917         Remove mention of sched_setscheduler() when talking about sched_priority
31918             There are nowadays multiple ways to set sched_priority (and
31919             in fact there always were, since we also had sched_setparam(2)).
31920     Michael Kerrisk
31921         SEE ALSO: Add Documentation/scheduler/sched-design-CFS.txt
31922     Michael Kerrisk
31923         Don't mention sched_setscheduler(2) in discussions of setting policies
31924             In a couple of places, sched_setscheduler(2) is mentioned as the
31925             way of setting policies. But now there is sched_setattr(2) as
31926             well, rewrite the text in a more generic way.
31927     Michael Kerrisk
31928         Rework summary text describing sched_setattr(2) and sched_getattr(2)
31929             Note that these APIs are a superset of sched_setscheduler(2)
31930             and sched_getscheduler(2).
31931     Michael Kerrisk
31932         Remove crufty text relating to sched_setscheduler()
31933             All of the removed text is in sched_setscheduler(2) and
31934             should have been trimmed from this page.
31935     Michael Kerrisk
31936         SEE ALSO: Mention more files in Documentation/scheduler/ directory
31937
31938
31939 ==================== Changes in man-pages-3.68 ====================
31940
31941 Released: 2014-05-28, Munich
31942
31943
31944 Contributors
31945 ------------
31946
31947 The following people contributed patches/fixes or (noted in brackets
31948 in the changelog below) reports, notes, and ideas that have been
31949 incorporated in changes in this release:
31950
31951 Alastair McKinstry <mckinstry@computer.org>
31952 Carsten Grohmann <carstengrohmann@gmx.de>
31953 Colin Williams <colinwilliams1968@gmail.com>
31954 Heinrich Schuchardt <xypron.glpk@gmx.de>
31955 Lars Wirzenius <liw@iki.fi>
31956 Marko Myllynen <myllynen@redhat.com>
31957 Michael Kerrisk <mtk.manpages@gmail.com>
31958 Peng Haitao <penght@cn.fujitsu.com>
31959 Rasmus Villemoes <rv@rasmusvillemoes.dk>
31960 Richard Braakman <richard.braakman@jollamobile.com>
31961 Simon Paillard <spaillard@debian.org>
31962
31963 Apologies if I missed anyone!
31964
31965
31966 New and rewritten pages
31967 -----------------------
31968
31969 localedef.1
31970     Marko Myllynen, Richard Braakman, Alastair McKinstry, Lars Wirzenius
31971         New page for localedef(1)
31972             Add new page based on Debian localedef(1) page.
31973
31974
31975 New and changed links
31976 ---------------------
31977
31978 procfs.5
31979     New link to proc.5
31980         Since the term "procfs" is widely used, it seems reasonable to have
31981         a link from that name to proc(5).
31982
31983
31984 Changes to individual pages
31985 ---------------------------
31986
31987 locale.1
31988     Marko Myllynen
31989         Provide a step-by-step example of how to use a custom locale
31990     Marko Myllynen
31991         Use LC_TELEPHONE instead of LC_MESSAGES in the example
31992             yesstr/nostr in LC_MESSAGES are planned to be changed at some
31993             point [1], so it's better to provide an example which won't
31994             be obsoleted by that change.
31995
31996             [1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975
31997
31998 adjtimex.2
31999     Michael Kerrisk
32000         Add feature test macro requirements
32001
32002 clone.2
32003     Michael Kerrisk
32004         ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
32005
32006 fork.2
32007     Michael Kerrisk
32008         ERRORS: add pid_max and threads-max to EAGAIN
32009             And rewrite text to be the same as pthread_create(3).
32010
32011 getrlimit.2
32012     Michael Kerrisk
32013         RLIMIT_NPROC is not enforced if CAP_SYS_ADMIN or CAP_SYS_RESOURCE
32014
32015 remap_file_pages.2
32016     Rasmus Villemoes
32017         Fix prototype
32018             The pgoff argument has type size_t, not ssize_t (and in the
32019             kernel it is unsigned long).
32020
32021 set_mempolicy.2
32022     Rasmus Villemoes
32023         Fix prototype for set_mempolicy(2)
32024             The nodemask argument is const. The return type in numaif.h is long.
32025
32026 swapon.2
32027     Rasmus Villemoes
32028         Remove header from synopsis
32029             The <asm/page.h> header is not readily available, and the comment
32030             seems to indicate that it is for getting PAGE_SIZE. But it is
32031             never mentioned why one would need to know that, and it is in any
32032             case better obtained using sysconf(), provided by <unistd.h>.
32033
32034 a64l.3
32035     Rasmus Villemoes
32036         Fix prototype for a64l()
32037             The argument is const, both according to POSIX and the
32038             glibc headers.
32039
32040 adjtime.3
32041     Rasmus Villemoes
32042         Add required header
32043             The prototype for adjtime(3) is declared in <sys/time.h>.
32044
32045 argz_add.3
32046     Rasmus Villemoes
32047         Fix prototypes
32048             Update the prototypes of argz_{delete,extract,next} to agree with
32049             glibc headers and manual.
32050
32051 bstring.3
32052     Rasmus Villemoes
32053         Fix prototypes
32054             The length parameter n has type size_t in bcmp(), bcopy() and
32055             bzero().
32056
32057 envz_add.3
32058     Rasmus Villemoes
32059         Fix prototypes
32060             The envz_len parameters for envz_entry() and envz_get() are not
32061             passed by reference.
32062
32063 fpathconf.3
32064     Rasmus Villemoes
32065         Fix prototype
32066             The path argument to pathconf() is const.
32067
32068 fseek.3
32069     Rasmus Villemoes
32070         Fix prototype
32071             The pos argument to fsetpos() is const.
32072
32073 gcvt.3
32074     Rasmus Villemoes
32075         Fix prototype
32076             The ndigit parameter to gcvt() has type int.
32077
32078 getaddrinfo_a.3
32079     Rasmus Villemoes
32080         Fix prototype
32081             The pointer arguments to gai_suspend() are const.
32082
32083 getauxval.3
32084     Rasmus Villemoes
32085         Fix permissions
32086             There doesn't seem to be any reason for getauxval.3 to be
32087             executable...
32088
32089 getnameinfo.3
32090     Rasmus Villemoes
32091         Fix prototype
32092             The hostlen and servlen parameters have type socklen_t.
32093             (The types changed in glibc 2.2)
32094     Michael Kerrisk
32095         Note types of 'hostlen'; and 'servlen' in glibc < 2.2
32096
32097 getrpcent.3
32098     Rasmus Villemoes
32099         Fix prototype
32100             The argument to getrpcbyname() is const.
32101
32102 getrpcport.3
32103     Rasmus Villemoes
32104         Add #include and fix prototype
32105             The prototype for getrpcport() is obtained by #include'ing
32106             <rpc/rpc.h>. Also, update its prototype.
32107
32108 getspnam.3
32109     Rasmus Villemoes
32110         Fix prototype
32111             The struct spwd argument to putspent() is const.
32112
32113 getutent.3
32114     Rasmus Villemoes
32115         Fix prototypes
32116             The arguments to getutid(), getutline(), and pututline()
32117             are const.
32118
32119 inet.3
32120     Rasmus Villemoes
32121         Fix prototype
32122             The parameters to inet_makeaddr have type in_addr_t.
32123
32124 inet_net_pton.3
32125     Rasmus Villemoes
32126         srcfix, cfix
32127             Use a consistent style throughout the man-pages.
32128
32129 key_setsecret.3
32130     Rasmus Villemoes
32131         Fix prototypes
32132             Remove const qualifiers from arguments to key_decryptsession,
32133             key_encryptsession, and key_setsecret.
32134
32135 makecontext.3
32136     Rasmus Villemoes
32137         Fix prototype
32138             The second argument to swapcontext() is const.
32139
32140 makedev.3
32141     Rasmus Villemoes
32142         Fix prototype
32143             gnu_dev_makedev, and hence its trivial macro wrapper makedev, takes
32144             two unsigned int parameters; this is consistent with it being the
32145             inverse of (gnu_dev_)major/minor, which return unsigned int.
32146
32147 malloc_trim.3
32148     Rasmus Villemoes
32149         Fix prototype
32150             As mentioned further down, malloc_trim returns an integer.
32151
32152 mq_getattr.3
32153     Rasmus Villemoes
32154         Fix prototype
32155             The newattr parameter to mq_setattr is const.
32156
32157 newlocale.3
32158     Marko Myllynen
32159         List all available category masks
32160     Michael Kerrisk
32161         Add LC_ALL_MASK description
32162
32163 nl_langinfo.3
32164     Marko Myllynen
32165         Expand the example code a bit
32166             Better illustrate querying elements from different categories.
32167
32168 perror.3
32169     Rasmus Villemoes
32170         Fix declaration
32171             The elements of the array sys_errlist are also const.
32172
32173 pthread_attr_setaffinity_np.3
32174 pthread_attr_setdetachstate.3
32175 pthread_attr_setguardsize.3
32176 pthread_attr_setinheritsched.3
32177 pthread_attr_setschedparam.3
32178 pthread_attr_setschedpolicy.3
32179 pthread_attr_setscope.3
32180 pthread_attr_setstack.3
32181 pthread_attr_setstackaddr.3
32182 pthread_attr_setstacksize.3
32183     Rasmus Villemoes
32184         Constify parameters
32185             Each of the pthread_attr_get* functions extract some piece of
32186             information from a pthread_attr_t, which is passed by const
32187             reference. Add the const keyword to the prototypes of these
32188             functions.
32189
32190 pthread_cleanup_push_defer_np.3
32191     Michael Kerrisk  [Rasmus Villemoes]
32192         Add feature test macro requirements
32193
32194 pthread_create.3
32195     Michael Kerrisk  [Carsten Grohmann]
32196         Add pid_max limit to EAGAIN error cases
32197
32198 pthread_equal.3
32199     Peng Haitao
32200         ATTRIBUTES: Note function that is thread-safe
32201             The function pthread_equal() is thread safe.
32202
32203 pthread_exit.3
32204     Peng Haitao
32205         ATTRIBUTES: Note function that is thread-safe
32206             The function pthread_exit() is thread safe.
32207
32208 pthread_getcpuclockid.3
32209     Peng Haitao
32210         ATTRIBUTES: Note function that is thread-safe
32211             The function pthread_getcpuclockid() is thread safe.
32212
32213 pthread_setaffinity_np.3
32214     Peng Haitao
32215         ATTRIBUTES: Note functions that are thread-safe
32216             The functions pthread_setaffinity_np() and
32217             pthread_getaffinity_np() are thread safe.
32218
32219 pthread_setconcurrency.3
32220     Peng Haitao
32221         ATTRIBUTES: Note functions that are thread-safe
32222             The functions pthread_setconcurrency() and
32223             pthread_getconcurrency() are thread safe.
32224
32225 pthread_setname_np.3
32226     Rasmus Villemoes
32227         Fix prototype
32228             The name parameter of pthread_getname_np is an output parameter and
32229             hence not const.
32230
32231 pthread_setschedparam.3
32232     Rasmus Villemoes
32233         Fix prototypes
32234             Add return type for pthread_{s,g}etschedparam.
32235
32236 pthread_setschedprio.3
32237     Rasmus Villemoes
32238         Fix prototype
32239             Add return type for pthread_setschedprio.
32240
32241 pthread_sigqueue.3
32242     Rasmus Villemoes
32243         Add missing #include <signal.h>
32244
32245 rcmd.3
32246     Rasmus Villemoes
32247         Fix prototypes
32248             Unlike the BSDs, the second argument of rcmd() and rcmd_af() has
32249             type unsigned short.
32250             The first argument of iruserok_af() has type const void*.
32251
32252 re_comp.3
32253     Rasmus Villemoes
32254         Fix prototypes
32255             re_comp and re_exec take const char* arguments.
32256
32257 resolver.3
32258     Rasmus Villemoes
32259         Fix prototypes and extern-declaration
32260             Fix const- and signedness of various char* parameters.
32261
32262             Also, there is no "struct state", but _res is a struct
32263             __res_state. (Actually, _res is errno-like in that it is really a
32264             macro expanding to (*__res_state()).)
32265
32266 rexec.3
32267     Rasmus Villemoes
32268         Fix prototypes
32269             The user, passwd and cmd arguments to rexec and rexec_af are all
32270             const.
32271
32272 rtime.3
32273     Rasmus Villemoes
32274         Replace header
32275             The header <rpc/des_crypt.h> does not provide rtime();
32276             <rpc/auth_des.h> does, as is also implied in both the NOTES and
32277             EXAMPLE sections.
32278
32279 scandir.3
32280     Rasmus Villemoes
32281         Fix prototypes
32282             The alphasort and versionsort functions take arguments of type
32283             const struct dirent **, not const void *.
32284
32285 setlocale.3
32286     Michael Kerrisk  [Marko Myllynen]
32287         Simplify locale category listing and add GNU-specific locale categories
32288             Some information that was here will move to locale(7).
32289     Marko Myllynen
32290         Remove now obsolete NOTES section
32291
32292 setnetgrent.3
32293     Rasmus Villemoes
32294         Fix prototype
32295             The buflen argument to getnetgrent_r has type size_t.
32296
32297 sigvec.3
32298     Rasmus Villemoes
32299         Fix prototype
32300             The vec argument to sigvec is const.
32301
32302 tsearch.3
32303     Rasmus Villemoes
32304         Fix prototype
32305             The rootp argument to tfind is "void * const *",
32306             not "const void **".
32307
32308 core.5
32309     Michael Kerrisk
32310         Core dump files are nowadays core.pid by default
32311
32312 locale.5
32313     Marko Myllynen
32314         Document mon_grouping and grouping properly
32315     Michael Kerrisk
32316         Note default value for 'first_workday'
32317     Michael Kerrisk  [Marko Myllynen]
32318         Add brief descriptions of collating-element and collating-symbol
32319     Marko Myllynen
32320         t_fmt_ampm is needed only for locales that employ AM/PM convention
32321     Michael Kerrisk  [Marko Myllynen]
32322         Remove crufty reference to /usr/lib/nls/src
32323             That file is nowhere to be found
32324     Marko Myllynen
32325         Clarify LC_TIME/am_pm and LC_NAME keywords usage
32326             am_pm should be defined only if AM/PM convention is used to signal
32327             applications they should not try to print them when using them in
32328             unwanted.
32329
32330             Same for all LC_NAME keywords expect for name_fmt which should be
32331             always defined.
32332     Marko Myllynen
32333         Clarify lang_term / lang_lib
32334             As noted by Keld Simonsen in the lib-locales@sourceware mailing
32335             list:
32336
32337                 https://sourceware.org/ml/libc-locales/2014-q2/msg00008.html
32338                 From: Keld Simonsen <keld at rap dot rap dot dk>
32339                 To: Marko Myllynen <myllynen at redhat dot com>
32340                 Date: Tue, 29 Apr 2014 17:02:09 +0200
32341
32342                 lang_term reflects ISO 639-2/T (terminology) codes, while
32343                 lang_lib reflects ISO 639-2/B (bibliographic) codes.
32344                 lang_term is preferred over lang_lib codes for locale names.
32345                 There are 20 specific ISO 639-2/B codes.
32346     Marko Myllynen
32347         Correct the FILES section
32348
32349 proc.5
32350     Michael Kerrisk
32351         'pid_max' is a system-wide limit on number of threads and processes
32352             Since PIDs > /proc/sys/kernel/pid_max are not allocated, this
32353             file thus also imposes a system-wide limit on the number of
32354             threads and processes.
32355
32356 capabilities.7
32357     Michael Kerrisk
32358         CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
32359     Michael Kerrisk
32360         CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
32361
32362 charsets.7
32363     Michael Kerrisk  [Marko Myllynen]
32364         Remove crufty statement that Romanian may be switching to ISO 8859-16
32365     Michael Kerrisk
32366         Remove ancient paragraph on charsets supported in glibc 2.3.2
32367             That test is rather ancient, and probably of little use.
32368
32369 fanotify.7
32370     Heinrich Schuchardt
32371         Fix to example program: fanotify read() should use aligned buffer
32372
32373 inotify.7
32374     Heinrich Schuchardt
32375         Add example program
32376             This example of the usage of the inotify API shows the
32377             usage of inotify_init1(2) and inotify_add_watch(2) as well
32378             as polling and reading from the inotify file descriptor.
32379     Heinrich Schuchardt
32380         munmap() does not generate inotify events
32381
32382 locale.7
32383     Marko Myllynen [Michael Kerrisk]
32384         Document the LOCPATH environment variable
32385     Michael Kerrisk
32386         Add further details on various categories
32387
32388
32389
32390 ==================== Changes in man-pages-3.69 ====================
32391
32392 Released: 2014-06-14, Munich
32393
32394
32395 Contributors
32396 ------------
32397
32398 The following people contributed patches/fixes or (noted in brackets
32399 in the changelog below) reports, notes, and ideas that have been
32400 incorporated in changes in this release:
32401
32402 Cyril Hrubis <chrubis@suse.cz>
32403 Jan Chaloupka <jchaloup@redhat.com>
32404 Jeff Layton <jlayton@poochiereds.net>
32405 Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
32406 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
32407 Marko Myllynen <myllynen@redhat.com>
32408 Michael Kerrisk <mtk.manpages@gmail.com>
32409 NeilBrown <neilb@suse.de>
32410 Peng Haitao <penght@cn.fujitsu.com>
32411 Petr Gajdos <pgajdos@suse.cz>
32412 Qian Lei <qianl.fnst@cn.fujitsu.com>
32413 Rasmus Villemoes <rv@rasmusvillemoes.dk>
32414 Vasiliy Kulikov <segoon@openwall.com>
32415 Walter Harms <wharms@bfs.de>
32416 Yuri Kozlov <yuray@komyakino.ru>
32417
32418 Apologies if I missed anyone!
32419
32420
32421 New and rewritten pages
32422 -----------------------
32423
32424 iconv.1
32425     Marko Myllynen  [Michael Kerrisk]
32426         New page for the iconv(1) command
32427
32428 iconvconfig.8
32429     Marko Myllynen
32430         New page for iconvconfig(8)
32431
32432
32433 Newly documented interfaces in existing pages
32434 ---------------------------------------------
32435
32436 fcntl.2
32437     Jeff Layton, Michael Kerrisk
32438         Document open file description locks
32439             As provided by the fcntl() operations F_OFD_SETLK,
32440             F_OFD_SETLKW, and F_OFD_GETLK
32441
32442
32443 Changes to individual pages
32444 ---------------------------
32445
32446 locale.1
32447     Marko Myllynen
32448         Add FILES section, add charmap(5) reference
32449     Marko Myllynen
32450         Align with recent charmap(5) / repertoiremap(5) changes
32451
32452 execve.2
32453     Michael Kerrisk  [NeilBrown]
32454         Before kernel 2.6.0, RLIMIT_NPROC had no effect for set*uid()
32455     Michael Kerrisk  [Vasiliy Kulikov]
32456         RLIMIT_NPROC is checked only if preceded by set*uid()
32457     Michael Kerrisk  [Vasiliy Kulikov, NeilBrown, KOSAKI Motohiro]
32458         Document EAGAIN error
32459             See also https://bugzilla.kernel.org/show_bug.cgi?id=42704
32460
32461 fcntl.2
32462     Michael Kerrisk
32463         Detail the limitations of traditional (process-associated) locks
32464     Michael Kerrisk  [Jeff Layton]
32465         Describe how to check whether the kernel supports a particular command
32466     Michael Kerrisk
32467         ERRORS: add EINVAL for invalid 'cmd'
32468     Michael Kerrisk
32469         Add para introducing advisory locks and noting existence of OFD locks
32470     Michael Kerrisk  [Jeff Layton]
32471         Add notes on F_SETLKW deadlock detection and its limitations
32472     Michael Kerrisk
32473         Add an explicit note that mandatory locking is not in POSIX
32474     Michael Kerrisk
32475         Rewrite introductory paragraphs on mandatory locking
32476             Make the structure more logical, and also explicitly mention
32477             OFD locks.
32478     Michael Kerrisk  [Jeff Layton]
32479         Reword discussion of mandatory lock bug a little
32480             Jeff Layton confirmed that the bug remains even in modern kernels.
32481     Michael Kerrisk
32482         Explain POSIX background to EACCES/EAGAIN error for F_GETLK
32483     Michael Kerrisk
32484         Add NOTES subhead for record locking and NFS
32485     Michael Kerrisk  [NeilBrown]
32486         Note treatment of locks when an NFS client loses contact with the server
32487     Michael Kerrisk  [Jeff Layton]
32488         nfsv4leasetime controls the "contact lost" interval for NFSv4
32489
32490 flock.2
32491     Michael Kerrisk
32492         In some modern BSDs, fcntl() and flock() locks do interact
32493             So, reword and extend the discussion of this topic in NOTES.
32494     Michael Kerrisk
32495         Move NOTES text describing implementation of flock()
32496     Michael Kerrisk  [NeilBrown]
32497         Add more details on NFS, including Linux 2.6.37 changes
32498             Also: move NOTES text describing interaction of fcntl()
32499             and flock() locks.
32500
32501 fork.2
32502     Michael Kerrisk
32503         Add notes on inheritance of flock() and OFD locks across fork()
32504
32505 lseek.2
32506     Michael Kerrisk
32507         Add reference to open(2) for discussion of file descriptors and OFDs
32508
32509 open.2
32510     Michael Kerrisk
32511         Rework and extend the discussion of open file descriptions
32512
32513 open_by_handle_at.2
32514     Rasmus Villemoes
32515         Add reference to feature_test_macros(7)
32516
32517 recvmmsg.2
32518     Rasmus Villemoes
32519         Add reference to feature_test_macros(7)
32520
32521 remap_file_pages.2
32522     Michael Kerrisk  [Kirill A. Shutemov]
32523         Note that remap_file_pages() is deprecated
32524
32525 sendmmsg.2
32526     Rasmus Villemoes
32527         Add reference to feature_test_macros(7)
32528
32529 seteuid.2
32530     Michael Kerrisk
32531         seteuid() and setegid() are implemented as library functions
32532     Michael Kerrisk
32533         Error checking should always be performed, even when caller is UID 0
32534
32535 setresuid.2
32536     Michael Kerrisk
32537         Document EAGAIN error that can occur after kernel alloc_uid() failure
32538     Michael Kerrisk
32539         Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
32540     Michael Kerrisk
32541         Correct the description of the EAGAIN error
32542     Michael Kerrisk
32543         Error checking should always be performed, even when caller is UID 0
32544
32545 setreuid.2
32546     Michael Kerrisk
32547         Document EAGAIN error that can occur after kernel alloc_uid() failure
32548     Michael Kerrisk
32549         Error checking should always be performed, even when caller is UID 0
32550     Michael Kerrisk
32551         Add EAGAIN error for hitting RLIMIT_NPROC limit
32552     Michael Kerrisk
32553         Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
32554
32555 setuid.2
32556     Michael Kerrisk
32557         Document EAGAIN error that can occur after kernel alloc_uid() failure
32558     Michael Kerrisk
32559         Correct the description of the EAGAIN error
32560     Michael Kerrisk
32561         Error checking should always be performed, even when caller is UID 0
32562     Michael Kerrisk
32563         Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
32564
32565 statfs.2
32566     Cyril Hrubis
32567         Update MAGIC constants
32568             Most of the updates are taken from /usr/include/linux/magic.h,
32569             some were found by grepping the Linux source code.
32570     Cyril Hrubis  [Michael Kerrisk]
32571         fstatfs(2) was broken on file descriptors from pipe(2)
32572
32573 syscalls.2
32574     Michael Kerrisk
32575         Note that remap_file_pages() is deprecated
32576
32577 basename.3
32578     Peng Haitao
32579         ATTRIBUTES: Note functions that are thread-safe
32580             The functions basename() and dirname() are thread safe.
32581
32582 catgets.3
32583     Peng Haitao
32584         ATTRIBUTES: Note function that is thread-safe
32585             The function catgets() is thread safe.
32586
32587 getdate.3
32588     Rasmus Villemoes
32589         Use blank definition of _GNU_SOURCE in example program
32590
32591 getdirentries.3
32592     Peng Haitao
32593         ATTRIBUTES: Note function that is thread-safe
32594             The function getdirentries() is thread safe.
32595
32596 getdtablesize.3
32597     Peng Haitao
32598         ATTRIBUTES: Note function that is thread-safe
32599             The function getdtablesize() is thread safe.
32600
32601 iconv.3
32602     Qian Lei  [Peng Haitao]
32603         ATTRIBUTES: Note function that is thread-safe
32604             The function iconv() is thread safe.
32605     Michael Kerrisk
32606         SEE ALSO: add iconvconfig(8)
32607
32608 lockf.3
32609     Qian Lei  [Peng Haitao]
32610         ATTRIBUTES: Note function that is thread-safe
32611             The function lockf() is thread safe.
32612
32613 malloc_get_state.3
32614     Rasmus Villemoes
32615         SYNOPSIS: use correct header
32616             The nonstandard functions malloc_set_state() and
32617             malloc_get_state() are provided by <malloc.h> not <stdlib.h>.
32618
32619 malloc_usable_size.3
32620     Qian Lei
32621         ATTRIBUTES: Note function that is thread-safe
32622             The function malloc_usable_size() is thread safe.
32623
32624 matherr.3
32625     Qian Lei  [Peng Haitao]
32626         ATTRIBUTES: Note function that is thread-safe
32627             The function matherr() is thread safe.
32628
32629 mkdtemp.3
32630     Peng Haitao
32631         ATTRIBUTES: Note function that is thread-safe
32632             The function mkdtemp() is thread safe.
32633
32634 mkstemp.3
32635     Peng Haitao
32636         ATTRIBUTES: Note functions that are thread-safe
32637             The functions mkstemp(), mkostemp(), mkstemps() and mkostemps()
32638             are thread safe.
32639
32640 mq_close.3
32641     Qian Lei
32642         ATTRIBUTES: Note function that is thread-safe
32643             The function mq_close() is thread safe.
32644
32645 mq_getattr.3
32646     Qian Lei
32647         ATTRIBUTES: Note function that is thread-safe
32648             The functions mq_getattr() and mq_setattr() are thread safe.
32649
32650 mq_open.3
32651     Peng Haitao
32652         ATTRIBUTES: Note function that is thread-safe
32653             The function mq_open() is thread safe.
32654
32655 mq_receive.3
32656     Peng Haitao
32657         ATTRIBUTES: Note functions that are thread-safe
32658             The functions mq_receive() and mq_timedreceive() are thread safe.
32659
32660 mq_send.3
32661     Peng Haitao
32662         ATTRIBUTES: Note functions that are thread-safe
32663             The functions mq_send() and mq_timedsend() are thread safe.
32664
32665 mq_unlink.3
32666     Qian Lei
32667         ATTRIBUTES: Note function that is thread-safe
32668             The function mq_unlink() is thread safe.
32669
32670 posix_fallocate.3
32671     Peng Haitao
32672         ATTRIBUTES: Note function that is thread-safe
32673             The function posix_fallocate() is thread safe.
32674
32675 posix_openpt.3
32676     Peng Haitao
32677         ATTRIBUTES: Note function that is thread-safe
32678             The function posix_openpt() is thread safe.
32679
32680 siginterrupt.3
32681     Peng Haitao
32682         ATTRIBUTES: Note function that is not thread-safe
32683             The function siginterrupt() is not thread safe.
32684
32685 system.3
32686     Peng Haitao
32687         ATTRIBUTES: Note function that is thread-safe
32688             The function system() is thread safe.
32689
32690 charmap.5
32691     Marko Myllynen
32692         Update to match current glibc
32693             charmap(5) was outdated, bring it to closer to reality by fixing
32694             syntax descriptions to match current glibc code and practices,
32695             adding missing options, removing obsolete comments and references,
32696             and removing now incorrect examples.
32697
32698 locale.5
32699     Marko Myllynen
32700         Clarify AM/PM settings a bit
32701             localedef(1) complains if really undefined, should be empty instead.
32702             Also: add some SEE ALSO references.
32703     Marko Myllynen
32704         Document glibc conventions regarding days and week
32705             Based on existing practice and glibc community wiki page at
32706             https://sourceware.org/glibc/wiki/Locales
32707
32708 proc.5
32709     Michael Kerrisk  [Jan Chaloupka, Walter Harms]
32710         Add a brief description of /proc/fs
32711
32712 repertoiremap.5
32713     Marko Myllynen
32714         New page for repertoiremap(5)
32715             Rather obsolete feature but localedef(1) refers to repertoiremaps.
32716
32717 bootparam.7
32718     Petr Gajdos
32719         Describe 'rootflags' and 'rootdelay' kernel parameters
32720             Patch based on text from Documentation/kernel-parameters.txt
32721
32722 charsets.7
32723     Marko Myllynen
32724         Update to reflect past developments
32725             Rewrite the introduction to make Unicode's prominence more obvious.
32726             Reformulate parts of the text to reflect current Unicode world.
32727             Minor clarification for ASCII/ISO sections, some other minor fixes.
32728     Marko Myllynen
32729         List CJK encodings in the order of C, J, K
32730
32731 environ.7
32732     Michael Kerrisk
32733         SEE ALSO: add env(1), printenv(1), ld.so(8)
32734
32735 locale.7
32736     Marko Myllynen
32737         Add some SEE ALSO references
32738
32739 man-pages.7
32740     Michael Kerrisk
32741         Note that .TH 'date' field is nowadays automatically updated by scripts
32742
32743 signal.7
32744     Michael Kerrisk
32745         Describe EINTR semantics for recvmmsg(2)
32746     Michael Kerrisk
32747         Clarify text describing EINTR semantics for socket interfaces
32748
32749 unicode.7
32750     Marko Myllynen
32751         Update to reflect past developments
32752             The unicode(7) page will look more modern with few small changes:
32753
32754             - drop old BUGS section, editors cope with UTF-8 ok these days,
32755               and perhaps the state-of-the-art is better described elsewhere
32756               anyway than in a man page
32757             - drop old suggestion about avoiding combined characters
32758             - refer to LANANA for Linux zone, add registry file reference
32759             - drop a reference to an inactive/dead mailing list
32760             - update some reference URLs
32761
32762 utf-8.7
32763     Marko Myllynen
32764         Drop an old comment about UTF-8 replacing ISO 8859
32765             And add locale(1) under SEE ALSO.
32766
32767
32768 ==================== Changes in man-pages-3.70 ====================
32769
32770 Released: 2014-07-08, Munich
32771
32772
32773 Contributors
32774 ------------
32775
32776 The following people contributed patches/fixes or (noted in brackets
32777 in the changelog below) reports, notes, and ideas that have been
32778 incorporated in changes in this release:
32779
32780 Carlos O'Donell <carlos@redhat.com>
32781 Elie De Brauwer <eliedebrauwer@gmail.com>
32782 Florian Weimer <fweimer@redhat.com>
32783 Heinrich Schuchardt <xypron.glpk@gmx.de>
32784 Marko Myllynen <myllynen@redhat.com>
32785 Michael Kerrisk <mtk.manpages@gmail.com>
32786 Nadav Har'El <nyh@math.technion.ac.il>
32787 NeilBrown <neilb@suse.de>
32788 Rich Felker <dalias@libc.org>
32789 Robert P. J. Day <rpjday@crashcourse.ca>
32790 Simon Paillard <spaillard@debian.org>
32791 Tomi Salminen <tlsalmin@gmail.com>
32792 Walter Harms <wharms@bfs.de>
32793 Yuri Kozlov <yuray@komyakino.ru>
32794 Кирилл <kirillnow@gmail.com>
32795
32796 Apologies if I missed anyone!
32797
32798
32799 New and rewritten pages
32800 -----------------------
32801
32802 sprof.1
32803     Michael Kerrisk [Marko Myllynen]
32804         New page for the glibc sprof(1) command
32805
32806
32807 Newly documented interfaces in existing pages
32808 ---------------------------------------------
32809
32810 epoll_ctl.2
32811     NeilBrown
32812         Document EPOLLWAKEUP
32813
32814 epoll.7
32815     NeilBrown
32816         Document EPOLLWAKEUP
32817
32818
32819 Changes to individual pages
32820 ---------------------------
32821
32822 iconv.1
32823 iconvconfig.8
32824     Marko Myllynen
32825         Clarify gconv file terminology a bit
32826
32827 ldd.1
32828     Michael Kerrisk
32829         SEE ALSO: add sprof(1)
32830
32831 connect.2
32832     Michael Kerrisk
32833         ERRORS: add EPROTOTYPE
32834             See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=708394
32835
32836 dup.2
32837     Michael Kerrisk  [Rich Felker]
32838         Fix erroneous discussion regarding closing 'newfd' before calling dup2()
32839             And propose a workaround if the caller cares about catching
32840             close() time errors.
32841
32842             See http://stackoverflow.com/questions/23440216/race-condition-when-using-dup2#comment36888604_23444465
32843             and http://austingroupbugs.net/view.php?id=411
32844     Michael Kerrisk
32845         Rework and enhance discussion of dup2()
32846             In particular, note that dup2() performs the steps of closing
32847             and reusing 'newfd' atomically.
32848     Michael Kerrisk
32849         Add subhead for dup3()
32850
32851 epoll_ctl.2
32852     Michael Kerrisk
32853         BUGS: EPOLLWAKEUP is silently ignored without CAP_BLOCK_SUSPEND
32854             If the caller does not have CAP_BLOCK_SUSPEND, then EPOLLWAKEUP
32855             is silently ignored.
32856
32857 fcntl.2
32858     Michael Kerrisk  [Tomi Salminen]
32859         The return value for F_SETPIPE_SZ is the pipe capacity
32860     Michael Kerrisk
32861         ERRORS: Document ENOTDIR error for F_NOTIFY
32862     Michael Kerrisk
32863         Use proper page cross-references in F_NOTIFY discussion
32864     Michael Kerrisk
32865         Suggest the use of real-time signals with F_NOTIFY
32866
32867 getitimer.2
32868     Michael Kerrisk
32869         Rewrite a few pieces to clarify some details
32870
32871 inotify_add_watch.2
32872     Michael Kerrisk
32873         Clarify that the target of a watch is an i-node
32874             The target of a watch is an i-node, not a pathname. Clarify
32875             the text to prevent the reader possibly misunderstanding
32876             that establishing watches by two different links to the same
32877             file might create different watch descriptors.
32878
32879 open.2
32880     Michael Kerrisk  [Кирилл]
32881         O_CLOEXEC is also one the flags not ignored when O_PATH is specified
32882
32883 pipe.2
32884     Elie De Brauwer
32885         PIPE_BUF is defined in limits.h
32886             To make use of PIPE_BUF in an application one should include
32887             <limits.h>.  Adding a reference to this inclusion.
32888
32889 poll.2
32890     Michael Kerrisk  [Nadav Har'El]
32891         The negate-fd-to-ignore technique does not work for file descriptor 0
32892             See https://bugzilla.kernel.org/show_bug.cgi?id=79411
32893
32894 set_tid_address.2
32895     Michael Kerrisk  [Rich Felker]
32896         Use "thread" rather than "process" in DESCRIPTION
32897     Michael Kerrisk
32898         SEE ALSO: add gettid(2)
32899
32900 shmop.2
32901     Michael Kerrisk
32902         Explain SHMLBA in much more detail
32903
32904 splice.2
32905     Michael Kerrisk
32906         Document EAGAIN error
32907             See https://bugzilla.kernel.org/show_bug.cgi?id=48641
32908
32909 syscalls.2
32910     Carlos O'Donell
32911         Add prlimit64(2)
32912             While trying to reconcile the new features in glibc with the
32913             documented entries in the linux kernel man pages I noticed that
32914             glibc exports prlimit64 for use by 32-bit applications (as does
32915             the linux kernel), but that prlimit64 was not defined in the
32916             syscalls list or in the prlimit-related page.
32917
32918             This is not the complete fix for this, but I don't have the time
32919             to explain why and when prlimit64 should be used (or how it should
32920             be used safely). Therefore I'm just patching the syscalls.2 list
32921             to show that prlimit64 exists and was added in 2.6.36 (verified
32922             with git by checking out the tags before and after).
32923
32924 syslog.2
32925     Michael Kerrisk
32926         Rework introductory paragraph
32927     Michael Kerrisk  [Robert P. J. Day]
32928         Rework text describing loglevels
32929             The kernel header file mentioned in the discussion of the KERN_*
32930             constants has morphed and is no longer exported inside glibc.
32931             And the definitions of the constants themselves changed subtly
32932             with kernel commit 04d2c8c83d0e3ac5f78aeede51babb3236200112.
32933             So, rewrite the description of the constants to be a bit more
32934             abstract.
32935     Michael Kerrisk
32936         Rewrite parts of the page, and import /proc/sys/kernel/printk
32937             * Move /proc/sys/kernel/printk from proc(5) to this page,
32938               and correct various details in the discussion of that file.
32939             * Rewrite and correct various other details on the page.
32940             * Clean out some crufty text.
32941             * Miscellaneous minor fixes.
32942     Michael Kerrisk
32943         Update SYSLOG_ACTION_CONSOLE_OFF + SYSLOG_ACTION_CONSOLE_ON description
32944             Details changed in Linux 2.6.32
32945
32946 tee.2
32947     Michael Kerrisk
32948         Document EAGAIN error
32949             See https://bugzilla.kernel.org/show_bug.cgi?id=48641
32950
32951 vmsplice.2
32952     Michael Kerrisk
32953         Document EAGAIN error
32954             See https://bugzilla.kernel.org/show_bug.cgi?id=48641
32955
32956 ether_aton.3
32957     Michael Kerrisk
32958         Make description of ether_line() bug a little more informative
32959
32960 mallopt.3
32961     Michael Kerrisk  [Florian Weimer]
32962         MALLOC_MMAP_THRESHOLD_ and MALLOC_MMAP_MAX_ *do* work in setgid programs
32963             My testing on this point was bogus, overlooking details of
32964             strace(1)'s behavior with setuid programs.
32965
32966             See https://sourceware.org/bugzilla/show_bug.cgi?id=12155
32967
32968 printf.3
32969     Michael Kerrisk  [Rich Felker]
32970         Remove libc4 and libc5 details
32971             Rich Felker noted that "scare text" in the man page warned about
32972             the use of snprintf() on libc, and that some people had cited
32973             this as a reason not to use snprintf().  Linux libc is now
32974             ancient history, so there is no real need to keep that text.
32975             But, while we're at it, we may as well clear out all of the
32976             other ancient libc4 and libc5 pieces in the page. They are
32977             nowadays more clutter than help.
32978     Michael Kerrisk
32979         SUSv3 and later agree with C99 for the snprintf() return value
32980             Determined by inspection of the SUSv3 and SUSv4 specifications.
32981     Michael Kerrisk
32982         Remove some old text about glibc 2.0 changes
32983             We probably don't now need such ancient info.
32984     Michael Kerrisk
32985         Update references to standards for C and S conversion specifiers
32986
32987 profil.3
32988     Michael Kerrisk
32989         SEE ALSO: add sprof(1)
32990
32991 charmap.5
32992     Marko Myllynen
32993         Various minor updates and improvements
32994             - more precise title
32995             - extend description a bit
32996             - document previously omitted WIDTH_DEFAULT
32997     Marko Myllynen
32998         Remove accidental ISO C compliance reference
32999             glibc refers in locale/programs/charmap.c to ISO C 99 section
33000             7.17.(2) and ISO C 99 section 5.2.1.(3) that if a character map
33001             is not ASCII compatible then the locale using it is not ISO C
33002             compliant. This does not state anything about the character set
33003             itself.
33004
33005 proc.5
33006     Michael Kerrisk
33007         Replace /proc/sys/kernel/printk discussion with reference to syslog(2)
33008             It makes more sense to have the /proc/sys/kernel/printk with
33009             the related material in syslog(2).
33010     Michael Kerrisk
33011         Rewrite /proc/sys/kernel/printk description
33012
33013 inotify.7
33014     Michael Kerrisk
33015         Clarify which events are generated for watched directories
33016             Really, with respect to watched directories, events fall into
33017             three classes (not two, as was shown):
33018
33019             * Events that can be generated only for the watched directory.
33020             * Events that can be generated only for objects that are inside
33021               the watched directory.
33022             * Events that can be generated both for the watched directory
33023               and for objects inside the directory.
33024
33025             So, mark these three classes more clearly in the list of inotify
33026             events.
33027     Heinrich Schuchardt  [Michael Kerrisk]
33028         BUGS: Note possible bug triggered by watch descriptor reuse
33029             Watch descriptor IDs are returned by inotify_add_watch().
33030             When calling inotify_rm_watch() an IN_IGNORED is placed on the
33031             inotify queue pointing to the ID of the removed watch.
33032
33033             inotify_add_watch() should not return a watch descriptor ID for
33034             which events are still on the queue but should return an
33035             unused ID.
33036
33037             Unfortunately, the existing Kernel code does not provide such a
33038             guarantee.
33039
33040             Actually, in rare cases watch descriptor IDs are returned by
33041             inotify_add_watch() for which events are still on the inotify
33042             queue.
33043
33044             See https://bugzilla.kernel.org/show_bug.cgi?id=77111
33045     Michael Kerrisk
33046         Add further detail to the watch descriptor reuse bug
33047             As well as inotify_rm_watch(), file deletion and unmounting a
33048             filesystem can also cause a watch descriptor to be deleted.
33049     Michael Kerrisk
33050         The watch descriptor reuse bug may be hard to hit in practice
33051             Explain the circumstances in detail, indicating that the
33052             bug may be very unlikely to occur in practice.
33053     Michael Kerrisk
33054         Clarify description of IN_EXCL_UNLINK
33055             Clarify the text a little, in particular making it clearer
33056             that the target of a watch is an i-node (not a pathname).
33057     Michael Kerrisk
33058         Clarify IN_ONESHOT explanation
33059             Make it clearer that the target of monitoring is an i-node,
33060             not a pathname.
33061     Michael Kerrisk
33062         Make comment on 'mask' field more accurate
33063
33064 libc.7
33065     Michael Kerrisk
33066         Clarify man-pages policy on documenting C libraries other tahn glibc
33067     Michael Kerrisk
33068         Use absolute dates in discussion of libc vs glibc
33069
33070 pipe.7
33071     Elie De Brauwer
33072         Add reference that the pipe capacity can be changed
33073             In fcntl(2) F_SETPIPE_SZ, F_GETPIPE_SZ and
33074             /proc/sys/fs/pipe-max-size are defined, however
33075             pipe(7) still defines the pipe capacity as being
33076             a static entity. Adding a reference to fcntl(2).
33077     Michael Kerrisk  [Walter Harms]
33078         Clarify that since 2.6.35, 65535 bytes is the default pipe capacity
33079
33080 ld.so.8
33081     Michael Kerrisk
33082         Clarify that LD_PROFILE can specify just a single shared object
33083     Michael Kerrisk
33084         Clarify that LD_PROFILE output is appended to target file
33085             The LD_PROFILE output is appended to any existing
33086             contents of the target file.
33087     Michael Kerrisk
33088         SEE ALSO: add sprof(1)
33089
33090
33091 ==================== Changes in man-pages-3.71 ====================
33092
33093 Released: 2014-08-17, Chicago
33094
33095
33096 Contributors
33097 ------------
33098
33099 The following people contributed patches/fixes or (noted in brackets
33100 in the changelog below) reports, notes, and ideas that have been
33101 incorporated in changes in this release:
33102
33103 Adrian Bunk <bunk@kernel.org>
33104 Damir Nedzibovic <d.nedzibovic@anoxtech.com>
33105 David Prévot <taffit@debian.org>
33106 D. Barbier <bouzim@gmail.com>
33107 Jakub Wilk <jwilk@debian.org>
33108 Jan Chaloupka <jchaloup@redhat.com>
33109 Marko Myllynen <myllynen@redhat.com>
33110 Michael Kerrisk <mtk.manpages@gmail.com>
33111 Mike Frysinger <vapier@gentoo.org>
33112 NeilBrown <neilb@suse.de>
33113 Paul Jackson <pj@usa.net>
33114 Peng Haitao <penght@cn.fujitsu.com>
33115 Rahul Bedarkar <rahulbedarkar89@gmail.com>
33116 Rob Landley <rob@landley.net>
33117 Ryan Hammonds <rhammonds@unicoi.com>
33118 Simon Paillard <spaillard@debian.org>
33119 Ville Ylenius <ville@ylenius.net>
33120 Vince Weaver <vincent.weaver@maine.edu>
33121 Yuri Kozlov <yuray@komyakino.ru>
33122
33123 Apologies if I missed anyone!
33124
33125
33126 New and rewritten pages
33127 -----------------------
33128
33129 group_member.3
33130     Michael Kerrisk
33131         New page documenting group_member(3)
33132
33133 isfdtype.3
33134     Michael Kerrisk
33135         New page documenting isfdtype(3)
33136
33137
33138 Newly documented interfaces in existing pages
33139 ---------------------------------------------
33140
33141 perf_event_open.2
33142     Vince Weaver
33143         Document new comm_exec flag
33144             Linux 3.16 (more specifically, commit 82b897782d10fcc4 )
33145             added support for differentiating between process renames
33146             caused by exec versus those caused by other methods.
33147     Vince Weaver
33148         Document new mmap2 record type
33149             Linux 3.16 (more specifically, commit a5a5ba72843dd05f9 )
33150             enabled the enhanced mmap2 record support.
33151             The interface was added in Linux 3.12 but disabled until
33152             Linux 3.16.
33153     Vince Weaver
33154         Document PERF_SAMPLE_BRANCH_COND
33155             Linux 3.16 (more specifically, commit bac52139f0b7ab31330 )
33156             adds support for gathering PERF_SAMPLE_BRANCH_COND
33157             conditional branch values when doing PERF_SAMPLE_BRANCH_STACK
33158             sampling.
33159
33160 proc.5
33161     Michael Kerrisk
33162         Document /proc/PID/comm
33163     Michael Kerrisk
33164         Document /proc/PID/pagemap
33165     Michael Kerrisk
33166         Document /proc/PID/personality
33167     Michael Kerrisk
33168         Document /proc/PID/syscall
33169     Michael Kerrisk
33170         Document /proc/kpagecount
33171     Michael Kerrisk
33172         Document /proc/kpageflags
33173     Michael Kerrisk
33174         Document /proc/sys/vm/overcommit_kbytes
33175
33176 capabilities.7
33177     Michael Kerrisk
33178         Add CAP_AUDIT_READ
33179             CAP_AUDIT_READ is new in Linux 3.16.
33180
33181
33182 Global changes
33183 --------------
33184
33185 ldd.1
33186 clone.2
33187 execve.2
33188 getpagesize.2
33189 ioperm.2
33190 msgop.2
33191 readv.2
33192 recv.2
33193 select.2
33194 send.2
33195 seteuid.2
33196 shmop.2
33197 signal.2
33198 sync.2
33199 sysinfo.2
33200 utime.2
33201 abs.3
33202 atoi.3
33203 catopen.3
33204 clearenv.3
33205 ctime.3
33206 des_crypt.3
33207 ecvt.3
33208 flockfile.3
33209 fseeko.3
33210 ftime.3
33211 ftok.3
33212 ftw.3
33213 getcwd.3
33214 getdtablesize.3
33215 getline.3
33216 getpass.3
33217 getpass.3
33218 getutent.3
33219 glob.3
33220 insque.3
33221 lseek64.3
33222 memmem.3
33223 mkstemp.3
33224 mktemp.3
33225 on_exit.3
33226 openpty.3
33227 putenv.3
33228 putenv.3
33229 qecvt.3
33230 realpath.3
33231 realpath.3
33232 remove.3
33233 setbuf.3
33234 sigpause.3
33235 strftime.3
33236 strptime.3
33237 tzset.3
33238 xcrypt.3
33239 utmp.5
33240 environ.7
33241 ipv6.7
33242 packet.7
33243     Michael Kerrisk
33244         Remove ancient Linux libc details
33245
33246 access.2
33247 brk.2
33248 chmod.2
33249 eventfd.2
33250 gethostname.2
33251 getpriority.2
33252 mmap.2
33253 poll.2
33254 ptrace.2
33255 readv.2
33256 sched_setaffinity.2
33257 select.2
33258 seteuid.2
33259 signalfd.2
33260 sync_file_range.2
33261 timer_create.2
33262 uname.2
33263 wait.2
33264     Michael Kerrisk
33265         NOTES: add "C library/kernel ABI differences" subheading
33266
33267
33268 Changes to individual pages
33269 ---------------------------
33270
33271 access.2
33272     Michael Kerrisk
33273         Glibc falls back to using access() on kernels that lack faccessat()
33274
33275 bdflush.2
33276 fsync.2
33277 sync.2
33278 proc.5
33279     Adrian Bunk
33280         Change "sync(1)" to "sync(8)"
33281
33282 bind.2
33283     Michael Kerrisk  [Ryan Hammonds]
33284         Correct EINVAL error description
33285             As pointed out by Ryan:
33286
33287                 My application is trying to bind an IPv4 UDP socket to an
33288                 address. I've found that passing an invalid address length
33289                 to bind() causes bind to return EINVAL. According to the
33290                 bind(2) manpage, this should only occur when using unix
33291                 domain sockets (which I am not).
33292
33293 chmod.2
33294     Michael Kerrisk
33295         Glibc falls back to chmod() on kernels that don't support fchmodat()
33296     Michael Kerrisk
33297         Glibc falls back to chown()/lchown() on kernels that lack fchownat()
33298
33299 epoll_wait.2
33300     Michael Kerrisk
33301         NOTES: describe raw epoll_pwait() system call differences
33302
33303 getgroups.2
33304     Michael Kerrisk
33305         SEE ALSO: add group_member(3)
33306
33307 getpriority.2
33308     Michael Kerrisk
33309         Enhance discussion of kernel nice range versus user-space nice range
33310     Michael Kerrisk
33311         Move text describing nice range on other systems
33312
33313 getrlimit.2
33314     Michael Kerrisk
33315         Add cross reference to core(5) in discussion of RLIMIT_CORE
33316     Michael Kerrisk
33317         Describe the "large" resource limit bug on 32-bit platforms
33318             See https://bugzilla.kernel.org/show_bug.cgi?id=5042.
33319     Michael Kerrisk
33320         Glibc's setrlimit() and getrlimit() are implemented using prlimit()
33321
33322 kexec_load.2
33323     Michael Kerrisk
33324         Note limit of 16 for 'nr_segments'
33325     Michael Kerrisk
33326         Clarify the 'flags' bits that contain the architecture
33327     Michael Kerrisk
33328         Add KEXEC_ARCH_68K to list of architectures for 'flags'
33329     Michael Kerrisk
33330         Reword description of 'flags' a little
33331
33332 link.2
33333     Michael Kerrisk
33334         Glibc falls back to link() on kernels that lack linkat()
33335             Unless 'flags' contains AT_SYMLINK_FOLLOW.
33336
33337 mkdir.2
33338     Michael Kerrisk
33339         Glibc falls back to mkdir() on kernels that don't support mkdirat()
33340
33341 perf_event_open.2
33342     Vince Weaver
33343         Clarify PERF_SAMPLE_STACK_USER usage
33344             This clarifies the PERF_SAMPLE_STACK_USER section.
33345             I found these issue while implementing some code that uses
33346             the option.  The important change is fixing the name of the
33347             sample_stack_user parameter, the rest is just some wording
33348             fixes and minor clarifications.
33349     Vince Weaver
33350         Clarify PERF_SAMPLE_DATA_SRC usage
33351             When checking the fields in the PERF_SAMPLE_DATA_SRC type samples
33352             you need to shift the masks before doing the compare.
33353
33354             Although the value you are checking (perf_mem_data_src) is
33355             specified as a bitfield so this might all fall apart if trying
33356             to access the field in a cross-endian way.  The Power people
33357             were working on this issue, not sure if they resolved it.
33358
33359 poll.2
33360     Michael Kerrisk
33361         Describe fifth argument (sigsetsize) of raw ppoll() system call
33362
33363 process_vm_readv.2
33364     Michael Kerrisk  [Ville Ylenius]
33365         Fix typo in example program
33366
33367 readlink.2
33368     Michael Kerrisk
33369         Glibc falls back to readlink() on kernels that lack readlinkat()
33370
33371 recv.2
33372     Michael Kerrisk
33373         'addrlen' should be NULL (not 0) if we don't need sender address
33374
33375 rename.2
33376     Michael Kerrisk
33377         Glibc falls back to rename() when the kernel doesn't have renameat()
33378
33379 sigwaitinfo.2
33380     Michael Kerrisk
33381         The raw sigtimedwait() system call has a fifth argument
33382
33383 symlink.2
33384     Michael Kerrisk
33385         Glibc falls back to symlink() on kernels that lack symlinkat()
33386
33387 sysinfo.2
33388     Michael Kerrisk
33389         Add VERSIONS section
33390
33391 unlink.2
33392     Michael Kerrisk
33393         Glibc falls back to unlink() or rmdir() on kernels that lack unlinkat()
33394
33395 atoi.3
33396     Michael Kerrisk
33397         Downgrade discussion of atoq()
33398             Remove most references to atoq() in this page, since this function
33399             was present only in Linux libc (not glibc).
33400
33401 cerf.3
33402 cexp2.3
33403 clog2.3
33404     Michael Kerrisk
33405         Update version number on "Not yet in glibc" sentence
33406
33407 fgetgrent.3
33408 getgrent.3
33409 getgrent_r.3
33410 getgrnam.3
33411     Michael Kerrisk  [Rob Landley]
33412         Clarify that 'gr_mem' is a NULL-terminated array of pointers
33413
33414 fseeko.3
33415     Michael Kerrisk
33416         Add VERSIONS section
33417
33418 ftw.3
33419     Michael Kerrisk
33420         Add VERSIONS section
33421
33422 getauxval.3
33423     Michael Kerrisk
33424         Document ENOENT error
33425             And add an entry to BUGS explaining the ambiguity that was
33426             present before the addition of this error.
33427
33428 getgrouplist.3
33429     Michael Kerrisk
33430         SEE ALSO: add group_member(3)
33431
33432 getline.3
33433     Rahul Bedarkar
33434         Close opened file at end of example program
33435
33436 memmem.3
33437     Michael Kerrisk
33438         Rewrite text of glibc 2.0 bug
33439
33440 printf.3
33441     Michael Kerrisk  [Jakub Wilk]
33442         Clarify details of the %n conversion specifier
33443             See http://bugs.debian.org/756602
33444     Michael Kerrisk  [Jakub Wilk]
33445         Note use of 'j', 'z', and 't' length modifiers for '%n'
33446             See http://bugs.debian.org/756602
33447     Michael Kerrisk
33448         Update with some SUSv3 details
33449
33450 setbuf.3
33451     Michael Kerrisk
33452         Remove ancient Linux libc and 4.x BSD details
33453
33454 strstr.3
33455     Michael Kerrisk
33456         Remove discussion of Linux libc bugs
33457             Linux libc is old enough that we needn't care any longer.
33458
33459 strtod.3
33460     Michael Kerrisk
33461         Explain NAN(n-char-sequence)
33462
33463 strtod.3
33464     Michael Kerrisk
33465         SEE ALSO: add nan(3), nanf(3), NANL(3)
33466
33467 updwtmp.3
33468     Michael Kerrisk
33469         Replace AVAILABILITY section with note to link logwtmp() using -lutil
33470             Linux libc details are no longer needed these days.
33471
33472 core.5
33473     Rahul Bedarkar
33474         Close opened file in example program
33475
33476 proc.5
33477     Michael Kerrisk
33478         Fix kernel version numbers for /proc/PID/stat fields
33479
33480 proc.5
33481     Jan Chaloupka
33482         Add missing proc stats fields
33483             Adding missing proc stats fields from
33484             https://www.kernel.org/doc/Documentation/filesystems/proc.txt
33485     Michael Kerrisk  [Simon Paillard]
33486         Remove crufty text under 'timer_stats'
33487     Michael Kerrisk
33488         Update /proc/PID/stat 'state' field documentation
33489     Michael Kerrisk
33490         Improve description of /proc/PID/stat fields added in Linux 3.3 and 3.5
33491     Michael Kerrisk
33492         Refer to getauxval(3) in discussion of /proc/PID/auxv
33493     Michael Kerrisk
33494         Rework formatting of /proc/PID/stat list
33495             Make the field numbers more prominent.
33496     Michael Kerrisk
33497         Note that /proc/PID/cmdline is read-only
33498     Michael Kerrisk
33499         Rework discussion of CommitLimit and /proc/sys/vm/overcommit_memory
33500     Michael Kerrisk
33501         Improve discussion of /proc/sys/vm/overcommit_ratio
33502
33503 charsets.7
33504     David Prévot  [Marko Myllynen]
33505         Tidy up list
33506             Remove German from main list, to be consistent with earlier
33507             removal of Dutch and French (in commit a8ed5f7430e0d1).
33508
33509 inotify.7
33510     Michael Kerrisk
33511         Note that IN_ONLY_DIR can be used to avoid races
33512     Michael Kerrisk
33513         Note that insertion of IN_MOVED_FROM+IN_MOVED_TO pair is not atomic
33514     Michael Kerrisk
33515         Mention use of timeout when reading IN_MOVED_TO after IN_MOVED_FROM
33516
33517 man-pages.7
33518     Michael Kerrisk
33519         Add description of "C library/kernel ABI differences" subsection
33520     Michael Kerrisk
33521         Rework text describing sections (stylistic improvements)
33522
33523 vdso.7
33524     Mike Frysinger
33525         Add new i386 vdso symbols in Linux 3.15
33526     Michael Kerrisk
33527         Note kernel version that exports new i386 symbols (Linux 3.15)
33528
33529
33530 ==================== Changes in man-pages-3.72 ====================
33531
33532 Released: 2014-09-07, Mountain View
33533
33534
33535 Contributors
33536 ------------
33537
33538 The following people contributed patches/fixes or (noted in brackets
33539 in the changelog below) reports, notes, and ideas that have been
33540 incorporated in changes in this release:
33541
33542 Christian von Roques <roques@mti.ag>
33543 Holger Hans Peter Freyther <holger@moiji-mobile.com>
33544 Michael Haardt <michael@moria.de>
33545 Michael Kerrisk <mtk.manpages@gmail.com>
33546 Mike Frysinger <vapier@gentoo.org>
33547 Peter Schiffer <pschiffe@redhat.com>
33548 Rusty Russell <rusty@rustcorp.com.au>
33549 Sorin Dumitru <sdumitru@ixiacom.com>
33550
33551 Apologies if I missed anyone!
33552
33553
33554 New and rewritten pages
33555 -----------------------
33556
33557 memusage.1
33558     Peter Schiffer, Michael Kerrisk  [Jan Chaloupka]
33559         New page for glibc memusage(1) command
33560
33561 memusagestat.1
33562     Peter Schiffer  [Jan Chaloupka, Michael Kerrisk]
33563         New page for glibc memusagestat(1) command
33564
33565 mtrace.1
33566     Peter Schiffer  [Jan Chaloupka]
33567         New page describing the glibc mtrace(1) command
33568
33569
33570 Changes to individual pages
33571 ---------------------------
33572
33573 connect.2
33574     Michael Haardt
33575         Note that a new socket should be used if connect() fails
33576
33577 fcntl.2
33578     Michael Kerrisk
33579         One must define _GNU_SOURCE to get the F_OFD_* definitions
33580
33581 poll.2, select.2
33582     Rusty Russell
33583         Fix erroneous description of "available for write".
33584             POSIX says: "POLLOUT Normal data may be written without
33585             blocking.".  This "may" is misleading, see the POSIX
33586             write page:
33587
33588                 Write requests to a pipe or FIFO shall be handled in the
33589                 same way as a regular file with the following exceptions:
33590                 ...
33591                 If the O_NONBLOCK flag is clear, a write request may cause
33592                 the thread to block, but on normal completion it shall
33593                 return nbyte.
33594                 ...
33595                 When attempting to write to a file descriptor (other than a
33596                 pipe or FIFO) that supports non-blocking writes and cannot
33597                 accept the data immediately:
33598
33599                 If the O_NONBLOCK flag is clear, write() shall block the
33600                 calling thread until the data can be accepted.
33601
33602                 If the O_NONBLOCK flag is set, write() shall not block the
33603                 thread. If some data can be written without blocking the
33604                 thread, write() shall write what it can and return the
33605                 number of bytes written. Otherwise, it shall return -1 and
33606                 set errno to [EAGAIN].
33607
33608             The net result is that write() of more than 1 byte on a
33609             socket, pipe or FIFO which is "ready" may block: write()
33610             (unlike read!) will attempt to write the entire buffer and
33611             only return a short write under exceptional circumstances.
33612
33613             Indeed, this is the behaviour we see in Linux:
33614
33615             https://github.com/rustyrussell/ccan/commit/897626152d12d7fd13a8feb36989eb5c8c1f3485
33616             https://plus.google.com/103188246877163594460/posts/BkTGTMHDFgZ
33617
33618 errno.3
33619     Michael Kerrisk
33620         SEE ALSO: add errno(1)
33621
33622 rtnetlink.3
33623     Holger Hans Peter Freyther
33624         Fix parameters for the send() call in the example
33625
33626 inotify.7
33627     Michael Kerrisk
33628         IN_OPEN and IN_CLOSE_NOWRITE can also occur for directories
33629     Michael Kerrisk
33630         IN_CLOSE_WRITE occurs only for files (not monitored directory)
33631     Michael Kerrisk
33632         IN_MODIFY is generated for files only (not monitored directories)
33633     Michael Kerrisk
33634         IN_ACCESS occurs only for files inside directories
33635             IN_ACCESS does not occur for monitored directory.
33636
33637 packet.7
33638     Sorin Dumitru
33639         Fix include file
33640             It looks like most of the socket options from this man pages
33641             are not defined in <netpacket/packet.h>. They are defined in
33642             <linux/if_packet.h> so we should include that one.
33643
33644
33645 ==================== Changes in man-pages-3.73 ====================
33646
33647 Released: 2014-09-21, Munich
33648
33649
33650 Contributors
33651 ------------
33652
33653 The following people contributed patches/fixes or (noted in brackets
33654 in the changelog below) reports, notes, and ideas that have been
33655 incorporated in changes in this release:
33656
33657 David Prévot <taffit@debian.org>
33658 Eric W. Biederman <ebiederm@xmission.com>
33659 J. Bruce Fields <bfields@fieldses.org>
33660 Justin Cormack <justin@street-vision.com>
33661 Lorenzo Beretta <lory.fulgi@infinito.it>
33662 Michael Kerrisk <mtk.manpages@gmail.com>
33663 Rob Landley <rob@landley.net>
33664 Serge E. Hallyn <serge@hallyn.com>
33665 Serge Hallyn <serge.hallyn@ubuntu.com>
33666 Vasily Kulikov <segoon@openwall.com>
33667 Vincent Lefevre <vincent@vinc17.net>
33668 Vitaly Rybnikov <frodox@zoho.com>
33669 Yuri Kozlov <yuray@komyakino.ru>
33670
33671 Apologies if I missed anyone!
33672
33673
33674 New and rewritten pages
33675 -----------------------
33676
33677 namespaces.7
33678     Michael Kerrisk  [Eric W. Biederman]
33679         New page providing overview of Linux namespaces
33680
33681 pid_namespaces.7
33682     Michael Kerrisk  [Eric W. Biederman, Vasily Kulikov, Rob Landley,
33683                       Serge Hallyn]
33684         New page describing PID namespaces
33685
33686 user_namespaces.7
33687     Michael Kerrisk  [Eric W. Biederman, Andy Lutomirski, Serge Hallyn]
33688         New page describing user namespaces.
33689
33690
33691 Newly documented interfaces in existing pages
33692 ---------------------------------------------
33693
33694 clone.2
33695     Eric W. Biederman  [Michael Kerrisk]
33696         Document CLONE_NEWUSER for creating a new user namespace
33697
33698 setns.2
33699     Eric W. Biederman, Michael Kerrisk
33700         Document the PID, user, and mount namespace support
33701             Document CLONE_NEWPID, CLONE_NEWUSER, and CLONE_NEWNS flags.
33702
33703 unshare.2
33704     Michael Kerrisk  [Eric W. Biederman]
33705         Document CLONE_NEWPID
33706     Michael Kerrisk  [Eric W. Biederman]
33707         Document CLONE_NEWUSER
33708     Michael Kerrisk
33709         Document CLONE_THREAD, CLONE_SIGHAND, and CLONE_VM
33710
33711
33712 Changes to individual pages
33713 ---------------------------
33714
33715 clone.2
33716     Michael Kerrisk
33717         Move some CLONE_NEWNET text to namespaces.7
33718     Michael Kerrisk
33719         Move some CLONE_NEWUTS text 2 to namespaces.7
33720     Michael Kerrisk
33721         Move some CLONE_NEWIPC text to namespaces.7
33722     Michael Kerrisk
33723         Reword discussion of CLONE_NEWNS, removing text also in namespaces(7)
33724     Michael Kerrisk
33725         Standardize text on CLONE_NEW* flags and CAP_SYS_ADMIN
33726     Michael Kerrisk
33727         EINVAL if (CLONE_NEWUSER|CLONE_NEWPID) && (CLONE_THREAD|CLONE_PARENT)
33728     Michael Kerrisk
33729         Add more detail on the meaning of CLONE_SYSVSEM
33730
33731 flock.2
33732     Michael Kerrisk  [J. Bruce Fields]
33733         Don't mention "classical BSD" in discussion of fcntl()/flock interaction
33734             The noninteraction of flock(2) and fcntl(2) locks does
33735             not seem to be classical BSD semantics (at least, checking
33736             the 4.4BSD sources suggest that the lock types do interact,
33737             although there have been other systems also where fcntl()
33738             and flock() locks do not interact). So, fix the text
33739             discussing "classical BSD" lock semantics.
33740
33741 getunwind.2
33742     Michael Kerrisk  [Yuri Kozlov]
33743         Fix description of return value
33744             s/size of unwind table/size of the unwind data/
33745
33746 mount.2
33747     Eric W. Biederman
33748         Clarify use of 'mountflags' and 'data' for MS_REMOUNT
33749
33750 reboot.2
33751     Michael Kerrisk  [Justin Cormack, Eric W. Biederman]
33752         Document effect of reboot() inside PID namespaces
33753
33754 semop.2
33755     Michael Kerrisk
33756         Refer to clone(2) for semantics of CLONE_SYSVSEM and semadj lists
33757
33758 seteuid.2
33759 setgid.2
33760 setresuid.2
33761 setreuid.2
33762 setuid.2
33763     Michael Kerrisk
33764         EINVAL can occur if UID/GID is not valid in caller's user namespace
33765
33766 setns.2
33767     Michael Kerrisk  [Eric W. Biederman]
33768         Clarify capabilities required for reassociating with a mount namespace
33769     Michael Kerrisk
33770         Specify kernel version on each CLONE_NEW* flag
33771             And remove text on flags from VERSIONS.
33772
33773 unshare.2
33774     Michael Kerrisk
33775         Add an example program
33776     Michael Kerrisk
33777         Clarify semantics of CLONE_SYSVSEM
33778     Michael Kerrisk
33779         CLONE_SYSVSEM does not require CAP_SYS_ADMIN
33780     Michael Kerrisk
33781         Note flags implied by CLONE_THREAD and CLONE_VM
33782
33783 clock.3
33784     Michael Kerrisk  [Vincent Lefevre]
33785         The implementation uses clock_gettime() was to improve *accuracy*
33786             (The man page text mistakenly used the word "precision".)
33787
33788 drand48.3
33789     Michael Kerrisk  [Lorenzo Beretta]
33790         Remove crufty text about SVID 3 marking drand48() obsolete
33791             See http://bugs.debian.org/758293
33792
33793 proc.5
33794     Michael Kerrisk
33795         Move /proc/[pid]/mounts text to namespaces.7
33796     Michael Kerrisk
33797         Move /proc/[pid]/mountstats text to namespaces.7
33798
33799 capabilities.7
33800     Michael Kerrisk
33801         Refer reader to user_namespaces(7) for a discussion of capabilities
33802     Michael Kerrisk
33803         Document CAP_SETUID and CAP_SETGID for user namespace mappings
33804     Michael Kerrisk
33805         setns() needs CAP_SYS_ADMIN in the *target* namespace
33806     Michael Kerrisk
33807         Since Linux 3.8, user namespaces no longer require CAP_SYS_ADMIN
33808
33809 mq_overview.7
33810     Michael Kerrisk
33811         Refer to namespaces(7) for info on POSIX MQs and IPC namespaces
33812
33813 svipc.7
33814     Michael Kerrisk
33815         Refer to namespaces(7) for info on System V IPC and IPC namespaces
33816
33817
33818 ==================== Changes in man-pages-3.74 ====================
33819
33820 Released: 2014-10-03, Munich
33821
33822
33823 Contributors
33824 ------------
33825
33826 The following people contributed patches/fixes or (noted in brackets
33827 in the changelog below) reports, notes, and ideas that have been
33828 incorporated in changes in this release:
33829
33830 Arto Bendiken <arto@bendiken.net>
33831 Ben Hutchings <ben@decadent.org.uk>
33832 Benjamin Herr <ben@0x539.de>
33833 C. Alex North-Keys <erlkonig@talisman.org>
33834 Carlos O'Donell <carlos@redhat.com>
33835 Cyril Hrubis <chrubis@suse.cz>
33836 Davidlohr Bueso <dave@stgolabs.net>
33837 Doug Ledford <dledford@redhat.com>
33838 Elie De Brauwer <eliedebrauwer@gmail.com>
33839 Heinrich Schuchardt <xypron.glpk@gmx.de>
33840 Jonny Grant <jg@jguk.org>
33841 Lanchon <lanchon@gmail.com>
33842 Manfred Spraul <manfred@colorfullife.com>
33843 Marko Myllynen <myllynen@redhat.com>
33844 Michael Kerrisk <mtk.manpages@gmail.com>
33845 Shriramana Sharma <samjnaa@gmail.com>
33846 Thomas Mack <mack@ifis.cs.tu-bs.de>
33847 Wieland Hoffmann <themineo@gmail.com>
33848
33849 Apologies if I missed anyone!
33850
33851
33852 New and rewritten pages
33853 -----------------------
33854
33855 pldd.1
33856     Michael Kerrisk
33857         New page for pldd(1) command added to glibc in version 2.15
33858
33859 cp1252.7
33860     Marko Myllynen
33861         New page documenting CP 1252
33862             CP 1252 is probably one of the most used Windows Code Pages so
33863             let's add a page for it alongside with the already provided
33864             CP 1251 page.
33865
33866             Table generated from /usr/share/i18n/charmaps/CP1252.
33867
33868
33869 Newly documented interfaces in existing pages
33870 ---------------------------------------------
33871
33872 mq_overview.7
33873     Michael Kerrisk
33874         Document /proc/sys/fs/mqueue/msgsize_default
33875     Michael Kerrisk
33876         Document /proc/sys/fs/mqueue/msg_default
33877
33878
33879 Changes to individual pages
33880 ---------------------------
33881
33882 ldd.1
33883     Michael Kerrisk
33884         SEE ALSO: add pldd(1)
33885
33886 execve.2
33887     Michael Kerrisk  [C. Alex North-Keys]
33888         Remove unneeded ".sh" extension in interpreter script example
33889             See https://bugzilla.kernel.org/show_bug.cgi?id=84701
33890
33891 fanotify_init.2
33892     Heinrich Schuchardt
33893         BUGS: O_CLOEXEC is ignored
33894     Michael Kerrisk  [Heinrich Schuchardt]
33895         The 'event_f_flags' failure to check invalid flags was fixed in 3.15
33896
33897 fanotify_mark.2
33898     Michael Kerrisk
33899         Note that various bugs were fixed in Linux 3.16
33900
33901 getrlimit.2
33902     Michael Kerrisk  [Doug Ledford]
33903         Since Linux 3.5, the accounting formula for RLIMIT_MSGQUEUE has changed
33904
33905 open.2
33906     Michael Kerrisk  [Shriramana Sharma]
33907         Fix number and formula in description of EOVERFLOW error
33908
33909 readlink.2
33910     Michael Kerrisk  [Ben Hutchings]
33911         Fix description of readlinkat() with empty 'pathname'
33912     Michael Kerrisk
33913         SEE ALSO: add realpath(3)
33914
33915 sched_setattr.2
33916 sched_setscheduler.2
33917     Michael Kerrisk
33918         SEE ALSO: add chrt(1)
33919
33920 shmget.2
33921     Manfred Spraul  [Michael Kerrisk, Davidlohr Bueso]
33922         Update for increase of SHMALL and SHMMAX
33923             The default values of SHMALL and SHMMAX have been increased.
33924
33925 syscalls.2
33926     Michael Kerrisk
33927         Add 3 new system calls added in Linux 3.17
33928
33929 vmsplice.2
33930     Cyril Hrubis
33931         vmsplice() does not fail when nr_segs==0
33932             This nr_segs==0 case is no-op; the call succeeds and no
33933             EINVAL error is returned.
33934
33935 dlopen.3
33936     Michael Kerrisk
33937         SEE ALSO: add pldd(1)
33938
33939 fseeko.3
33940     Michael Kerrisk  [Thomas Mack]
33941         _FILE_OFFSET_BITS must be defined before including any header file
33942
33943 getgrent.3
33944     Carlos O'Donell
33945         Add ENOENT and EAGAIN to error list
33946
33947 mq_getattr.3
33948     Michael Kerrisk
33949         Add an example program
33950             The example program can be used to discover the default
33951             'mq_maxmsg' and 'mq_msgsize' values used to create a queue with
33952             a mq_open(3) call in which 'attr' is NULL.
33953
33954 mq_open.3
33955     Michael Kerrisk
33956         Two /proc files control the defaults for the attrp==NULL case
33957             Refer the reader to the discussion in mq_overview(7) for a
33958             discussion of these files, which exist since Linux 3.5.
33959
33960 realpath.3
33961     Michael Kerrisk
33962         SEE ALSO: add realpath(1)
33963
33964 proc.5
33965     Elie De Brauwer
33966         Document /proc/buddyinfo
33967             This patch adds a short description about the contents of
33968             /proc/buddyinfo and how this file can be used to assist
33969             in checking for memory fragmentation issues.
33970     Michael Kerrisk
33971         Mention pmap(1) in discussion of /proc/PID/smaps
33972
33973 armscii-8.7
33974     Marko Myllynen
33975         Charset pages unification, minor cleanups
33976
33977 ascii.7
33978     Marko Myllynen
33979         Charset pages unification, minor cleanups
33980             This and [the related *.7] patches will provide unification of
33981             charset pages, minor cleanups, and some unifying cosmetic
33982             changes. References are adjusted so that all pages include
33983             a reference to charsets(7), which contains a description of
33984             these sets, stray comments are removed, some obsolete
33985             statements (like ISO 8859-1 being the de-facto ASCII
33986             replacement) are removed, and some minor reformatting
33987             to minimize diff's between the pages are done.
33988
33989             The actual substance, the character tables, remain unchanged.
33990
33991             This series changes the following pages (under man7): ascii,
33992             armscii, cp1251, koi8-r, koi8-u, and all of iso_8859-*.
33993
33994 cp1251.7
33995     Marko Myllynen
33996         Charset pages unification, minor cleanups
33997
33998 iso_8859-10.7
33999     Marko Myllynen
34000         Charset pages unification, minor cleanups
34001
34002 iso_8859-11.7
34003     Marko Myllynen
34004         Charset pages unification, minor cleanups
34005
34006 iso_8859-13.7
34007     Marko Myllynen
34008         Charset pages unification, minor cleanups
34009
34010 iso_8859-14.7
34011     Marko Myllynen
34012         Charset pages unification, minor cleanups
34013
34014 iso_8859-15.7
34015     Marko Myllynen
34016         Charset pages unification, minor cleanups
34017
34018 iso_8859-16.7
34019     Marko Myllynen
34020         Charset pages unification, minor cleanups
34021
34022 iso_8859-1.7
34023     Marko Myllynen
34024         Charset pages unification, minor cleanups
34025
34026 iso_8859-2.7
34027     Marko Myllynen
34028         Charset pages unification, minor cleanups
34029
34030 iso_8859-3.7
34031     Marko Myllynen
34032         Charset pages unification, minor cleanups
34033
34034 iso_8859-4.7
34035     Marko Myllynen
34036         Charset pages unification, minor cleanups
34037
34038 iso_8859-5.7
34039     Marko Myllynen
34040         Charset pages unification, minor cleanups
34041
34042 iso_8859-6.7
34043     Marko Myllynen
34044         Charset pages unification, minor cleanups
34045
34046 iso_8859-7.7
34047     Marko Myllynen
34048         Charset pages unification, minor cleanups
34049
34050 iso_8859-8.7
34051     Marko Myllynen
34052         Charset pages unification, minor cleanups
34053
34054 iso_8859-9.7
34055     Marko Myllynen
34056         Charset pages unification, minor cleanups
34057
34058 koi8-r.7
34059     Marko Myllynen
34060         Charset pages unification, minor cleanups
34061             - remove stray comments, streamline description
34062               (charsets(7) and Wikipedia provide more detailed
34063                and up-to-date description)
34064             - list differences between koi8-r.7 vs koi8-u.7
34065
34066 koi8-u.7
34067     Marko Myllynen
34068         Charset pages unification, minor cleanups
34069             - remove stray comments, streamline description
34070               (charsets(7) and Wikipedia provide more detailed
34071                and up-to-date description)
34072             - list differences between koi8-r.7 vs koi8-u.7
34073
34074 mq_overview.7
34075     Michael Kerrisk
34076         Update queues_max details for Linux 3.14
34077             And in general rework the text a little.
34078     Michael Kerrisk
34079         Update discussion of HARD_MSGMAX
34080             The limit has changed in 2.6.33 and then again in 3.5.
34081     Michael Kerrisk  [Arto Bendiken]
34082         Update details for 'queues_max' limit
34083             Things changed in Linux 3.5.
34084             See https://bugs.launchpad.net/bugs/1155695
34085     Michael Kerrisk
34086         Update details on defaults and ceiling for 'msgsize_max' limit
34087     Michael Kerrisk
34088         Rework discussion of HARD_MSGMAX
34089     Michael Kerrisk  [Davidlohr Bueso]
34090         Various fixes after review from Davidlohr Bueso
34091
34092 sched.7
34093     Michael Kerrisk
34094         SEE ALSO: add taskset(1)
34095
34096 ld.so.8
34097     Michael Kerrisk
34098         SEE ALSO: add pldd(1)
34099     Michael Kerrisk
34100         SEE ALSO: add dlopen(3)
34101     Michael Kerrisk
34102         SEE ALSO: add ld(1)
34103
34104
34105
34106 ==================== Changes in man-pages-3.75 ====================
34107
34108 Released: 2014-10-15, Düsseldorf
34109
34110
34111 Contributors
34112 ------------
34113
34114 The following people contributed patches/fixes or (noted in brackets
34115 in the changelog below) reports, notes, and ideas that have been
34116 incorporated in changes in this release:
34117
34118 Jonny Grant <jg@jguk.org>
34119 Michael Kerrisk <mtk.manpages@gmail.com>
34120 Robert Schweikert <rjschwei@suse.com>
34121 Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
34122 Walter Harms <wharms@bfs.de>
34123
34124 Apologies if I missed anyone!
34125
34126
34127 New and rewritten pages
34128 -----------------------
34129
34130 pthread_rwlockattr_setkind_np.3
34131     Robert Schweikert  [Michael Kerrisk]
34132         New page documenting pthread_rwlockattr_[sg]etkind_np(3)
34133             Documents pthread_rwlockattr_setkind_np(3) and
34134             pthread_rwlockattr_getkind_np(3).
34135
34136
34137 New and changed links
34138 ---------------------
34139
34140 pthread_rwlockattr_getkind_np.3
34141     Robert Schweikert
34142         New link to pthread_rwlockattr_setkind_np(3)
34143
34144
34145 Changes to individual pages
34146 ---------------------------
34147
34148 readlink.2
34149     Michael Kerrisk  [Jonny Grant]
34150         Add free() call to example program
34151
34152 readv.2
34153     Michael Kerrisk
34154         The raw preadv() and pwritev() syscalls split 'offset' into 2 arguments
34155
34156 signal.7
34157     Michael Kerrisk
34158         pthread_mutex_lock() and pthread_cond_wait() are restartable
34159             pthread_mutex_lock(, pthread_cond_wait(), and related APIs are
34160             automatically restarted if interrupted by a signal handler.
34161
34162 unix.7
34163     Michael Kerrisk  [Carlos O'Donell, David Miller, Tetsuo Handa]
34164         Various additions and rewordings
34165             Notable changes:
34166             * Clarify some details for pathname sockets.
34167             * Add some advice on portably coding with pathname sockets.
34168             * Note the "buggy" behavior for pathname sockets when
34169               the supplied pathname is 108 bytes (after a report by
34170               Tetsuo Handa).
34171
34172
34173 ==================== Changes in man-pages-3.76 ====================
34174
34175 Released: 2014-12-31, Munich
34176
34177
34178 Contributors
34179 ------------
34180
34181 The following people contributed patches/fixes or (noted in brackets
34182 in the changelog below) reports, notes, and ideas that have been
34183 incorporated in changes in this release:
34184
34185 Adam Jiang <jiang.adam@gmail.com>
34186 Andrea Balboni <andrea.balboni@unimore.it>
34187 Andreas Schwab <schwab@suse.de>
34188 Bernhard Walle <bernhard@bwalle.de>
34189 Carlos O'Donell <carlos@redhat.com>
34190 David Wragg <david@wragg.org>
34191 Florian Westphal <fw@strlen.de>
34192 Heinrich Schuchardt <xypron.glpk@gmx.de>
34193 Huxiaoxiang <huxiaoxiang@huawei.com>
34194 Jan Chaloupka <jchaloup@redhat.com>
34195 Jonathan Wakely <jwakely@redhat.com>
34196 Jonny Grant <jg@jguk.org>
34197 Josh Triplett <josh@joshtriplett.org>
34198 Kamezawa Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
34199 Laurent Georget <laurent.georget@supelec.fr>
34200 Manuel López-Ibáñez <lopezibanez@gmail.com>
34201 Marko Myllynen <myllynen@redhat.com>
34202 Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
34203 Mel Gorman <mgorman@suse.de>
34204 Michael Gehring <mg@ebfe.org>
34205 Michael Haardt <michael@moria.de>
34206 Michael Kerrisk <mtk.manpages@gmail.com>
34207 Mike Frysinger <vapier@gentoo.org>
34208 Rasmus Villemoes <rv@rasmusvillemoes.dk>
34209 Richard Weinberger <richard@nod.at>
34210 Rich Felker <dalias@libc.org>
34211 Scott Harvey <scott.harvey@stonybrook.edu>
34212 Siddhesh Poyarekar <siddhesh.poyarekar@gmail.com>
34213 Simon Newton <nomis52@gmail.com>
34214 Simon Paillard <spaillard@debian.org>
34215 Sven Hoexter <sven@stormbind.net>
34216 Tobias Werth <werth@cs.fau.de>
34217 Weijie Yang <weijie.yang.kh@gmail.com>
34218 Will Newton <will.newton@linaro.org>
34219 Yuri Kozlov <yuray@komyakino.ru>
34220 刘湃 <liupai_work@163.com>
34221 尹杰 <writalnaie@gmail.com>
34222
34223 Apologies if I missed anyone!
34224
34225
34226 New and rewritten pages
34227 -----------------------
34228
34229 adjtimex.2
34230     Laurent Georget
34231         Add fields in struct timex description
34232             This patch updates the man page with the new fields added in
34233             struct timex since last edition of the man page.
34234     Laurent Georget [Michael Kerrisk]
34235         Document ADJ_TAI
34236     Michael Kerrisk
34237         Improve description of ADJ_OFFSET_SINGLESHOT
34238     Michael Kerrisk
34239         Add brief documentation of ADJ_MICRO and ADJ_NANO
34240     Michael Kerrisk
34241         Reformat return value list
34242             And remove numeric values, since they're not needed
34243     Michael Kerrisk
34244         Other 'modes' bits are ignored on ADJ_OFFSET_*
34245             Other bits in 'modes' are ignored if modes contains
34246             ADJ_OFFSET_SINGLESHOT or ADJ_OFFSET_SS_READ.
34247     Michael Kerrisk
34248         Add nanosecond details
34249             Fixes https://bugzilla.kernel.org/show_bug.cgi?id=61171.
34250     Michael Kerrisk
34251         Document ADJ_OFFSET_SS_READ
34252     Michael Kerrisk
34253         Reformat 'times' flags as list
34254             And remove numeric values, since they're not needed.
34255     Michael Kerrisk
34256         Note effect of ADJ_NANO for ADJ_SETOFFSET
34257     Michael Kerrisk
34258         Add comment noting that timex structure contains padding bytes
34259     Michael Kerrisk
34260         Add more details to description of 'tai' field
34261     Michael Kerrisk
34262         Note meaning of "PLL" abbreviation
34263     Michael Kerrisk
34264         Clarify which 'timex' field is used by each 'modes' bit
34265     Michael Kerrisk
34266         Document timex 'status' bits
34267     Michael Kerrisk
34268         Clarify treatment of other 'modes' bits for ADJ_OFFSET_*
34269     Michael Kerrisk
34270         Update RFC number: RFC 5905 obsoletes RFC 1305
34271     Michael Kerrisk
34272         Briefly document ADJ_SETOFFSET
34273     Michael Kerrisk
34274         Note PPS (pulse per second) fields in timex structure
34275
34276 sigreturn.2
34277     Michael Kerrisk
34278         Add (a lot) more detail on the signal trampoline
34279             And rewrite much of the page.
34280
34281
34282 Newly documented interfaces in existing pages
34283 ---------------------------------------------
34284
34285 proc.5
34286     Bernhard Walle
34287         Document /proc/thread-self
34288             /proc/thread-self has been introduced in Linux 3.17 with
34289             commit 0097875bd41528922fb3bb5f348c53f17e00e2fd.
34290     Sven Hoexter [Michael Kerrisk, Kamezawa Hiroyuki]
34291         Document "VmSwap" field of /proc/[pid]/status
34292     Florian Westphal
34293         Document /proc/net/netfilter/nfnetlink_queue
34294
34295
34296 Changes to individual pages
34297 ---------------------------
34298
34299 localedef.1
34300     Marko Myllynen
34301         Mention default path for compiled files
34302
34303 clock_nanosleep.2
34304     Michael Kerrisk
34305         Note that 'clock_id' can also be a CPU clock ID
34306
34307 epoll_ctl.2
34308     Michael Kerrisk
34309         Regular files and directories can't be monitored with epoll_ctl()
34310
34311 ioctl.2
34312     Heinrich Schuchardt
34313         Rename 'd' argument to 'fd' in text
34314             In most other manpages file descriptors are called 'fd'.
34315             This patches renames attribute 'd' to 'fd'.
34316
34317 madvise.2
34318     Michael Kerrisk
34319         VERSIONS: Support for madvise() is now configurable
34320             Support for this system call now depends on the
34321             CONFIG_ADVISE_SYSCALLS configuration option.
34322
34323 open.2
34324     Michael Kerrisk
34325         Enhance rationale discussion for openat() and friends
34326
34327 posix_fadvise.2
34328     Mel Gorman
34329         Document the behavior of partial page discard requests
34330             It is not obvious from the interface that "partial page discard"
34331             requests are ignored. It should be spelled out.
34332     Michael Kerrisk  [Weijie Yang]
34333         ERRORS: Since 2.6.16, the kernel correctly deals with the ESPIPE case
34334     Michael Kerrisk
34335         Support for fadvise64() is now configurable
34336             Support for this system call now depends on the
34337             CONFIG_ADVISE_SYSCALLS configuration option.
34338
34339 prctl.2
34340     Andreas Schwab
34341         Correct description of null-termination in PR_GET_NAME and PR_SET_NAME
34342             The size of the process name has always been at most 16 byte
34343             _including_ the null terminator.  This also means that the
34344             name returned by PR_GET_NAME is always null-terminated.
34345     Michael Kerrisk
34346         PR_SET_NAME silently truncates strings that exceed 16 bytes
34347
34348 restart_syscall.2
34349     Michael Kerrisk
34350         Add some text explaining why restart_syscall() exists
34351
34352 sched_setaffinity.2
34353     Michael Kerrisk
34354         NOTES: Add paragraph on how to discover set of CPUs available on system
34355     Michael Kerrisk
34356         SEE ALSO: add nproc(1) and lscpu(1)
34357
34358 select.2
34359     Michael Kerrisk
34360         SEE ALSO: add restart_syscall(2)
34361
34362 semop.2
34363     Michael Kerrisk
34364         Add note that interrupted semtimedop() returns 'timeout' unchanged
34365     Michael Kerrisk
34366         Remove information about semtimedop() EAGAIN that is repeated elsewhere
34367     Michael Kerrisk
34368         Add subsection head for semtimedop()
34369
34370 setsid.2
34371     Michael Kerrisk
34372         Rewrite some pieces and add some details
34373             Among other changes, add an explanation of why setsid() can't
34374             be called from a process group leader
34375
34376 sgetmask.2
34377     Michael Kerrisk
34378         Since 3.16, support for these system calls is configurable
34379             Support for these calls is now dependent on the setting of the
34380             CONFIG_SGETMASK_SYSCALL option.
34381
34382 sigaction.2
34383     Michael Kerrisk
34384         Document SA_RESTORER
34385     Michael Kerrisk
34386         Add some detail on the sa_restorer field
34387     Michael Kerrisk
34388         SEE ALSO: add sigreturn(2)
34389
34390 splice.2
34391     Michael Kerrisk
34392         Reformat description of 'fd_in' and 'off_in' to improve readability
34393
34394 syscall.2
34395     Michael Kerrisk
34396         SEE ALSO: add errno(3)
34397
34398 syscalls.2
34399     Michael Kerrisk
34400         SEE ALSO: add errno(3)
34401     Michael Kerrisk
34402         3.19 adds execveat()
34403     Michael Kerrisk
34404         Add bpf(2) to list
34405
34406 tee.2
34407     Michael Kerrisk
34408         Add shell session demonstrating use of the example program
34409
34410 tkill.2
34411     Michael Kerrisk  [Rich Felker]
34412         Remove bogus text saying tgid==-1 makes tgkill() equivalent to tkill()
34413
34414 abort.3
34415     Michael Kerrisk
34416         Note that SIGABRT is raised as though raise(3) is called
34417             Also note that abort() is POSIX.1-2008 compliant.
34418
34419 cmsg.3
34420     David Wragg
34421         Ensure buf is suitably aligned in sending example
34422             Inspection of the definition of CMSG_FIRSTHDR (both in glibc and
34423             the suggested definition in RFC3542) shows that it yields the
34424             msg_control field.  So when sending, the pointer placed in
34425             msg_control should be suitably aligned as a struct cmsghdr.
34426             In the sending example, buf was declared as a bare char array,
34427             and so is not necessarily suitably aligned.
34428
34429             The solution here involves placing buf inside a union, and is
34430             based on the sockets/scm_rights_send.c sample from The Linux
34431             Programming Interface "dist" source code collection.
34432
34433 exp10.3
34434     Michael Kerrisk
34435         Before glibc 2.19, exp() did not give ERANGE error on underflow
34436             http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787
34437
34438 ftw.3
34439     Michael Kerrisk
34440         FTW_CHDIR has no effect on the 'fpath' argument passed to fn()
34441
34442 getopt.3
34443     Michael Kerrisk  [Jonny Grant]
34444         Ensure that 'nsecs' is used
34445
34446 ilogb.3
34447     Michael Kerrisk  [Will Newton]
34448         Since glibc 2.16, ilogb() does correctly diagnose domain errors
34449
34450 memcmp.3
34451     Michael Haardt
34452         Document return value for n==0 case
34453     Michael Haardt
34454         Warn against use of memcmp() for comparing security-critical data
34455
34456 mq_open.3
34457     Michael Kerrisk
34458         Document the O_CLOEXEC flag
34459     Michael Kerrisk
34460         Place 'flags' constants in alphabetical order
34461
34462 pow.3
34463     Manuel López-Ibáñez
34464         Add note on performance characteristics of pow()
34465
34466 pthread_setschedparam.3
34467     Simon Newton
34468         Fix logic error in example program
34469             The example program will crash if -A is used, since 'attr'
34470             is uninitialized.
34471
34472                 $ ./a.out  -A
34473                 *** Error in `./a.out': free(): invalid pointer: 0xb779c3c4 ***
34474                 Aborted (core dumped)
34475     刘湃
34476         Small fixes to example program
34477
34478 sigvec.3
34479     Michael Kerrisk
34480         Starting with version 2.21, glibc no longer exports sigvec()
34481
34482 sysconf.3
34483     Josh Triplett
34484         Document _SC_NGROUPS_MAX
34485             Already documented in getgroups(2), but not in sysconf(3).
34486
34487 termios.3
34488     Michael Kerrisk
34489         SEE ALSO: add tset(1)
34490
34491 tgamma.3
34492     Michael Kerrisk
34493         Since glibc 2.18, errno is correctly set to EDOM when (x == -infinity))
34494
34495 wordexp.3
34496     Carlos O'Donell
34497         Make it clear that WRDE_NOCMD prevents command substitution
34498             The use of WRDE_NOCMD prevents command substitution. If the flag
34499             WRDE_NOCMD is set then no command substitution shall occur and
34500             the error WRDE_CMDSUB will be returned if such substitution is
34501             requested when processing the words.
34502
34503             The manual page as-is makes it seem like the command substitution
34504             occurs, and an error is returned *after* the substitution.
34505             This patch clarifies that.
34506
34507 locale.5
34508     Marko Myllynen
34509         Describe the formats of values
34510             locale(5) describes what a locale should define but doesn't
34511             spell out how (in what format). The patch attempts to address
34512             this, it also has few trivial additional enhancements.
34513
34514             * Reference to locale(7) for category descriptions.
34515             * Clarify first_workday in NOTES a bit.
34516             * Add upstream BZ reference for two missing LC_ADDRESS fields.
34517     Marko Myllynen
34518         Fix miscoded character
34519
34520 resolv.conf.5
34521     Jan Chaloupka
34522         Add missing no-tld-query option
34523             Based on commit [1], the no-tld-query option exists for
34524             resolv.conf configuration file.  Description of this option
34525             is provided in [2]. This patch just copies this option
34526             into resolv.conf.5 man page. Plus changes 'a' member
34527             into 'an' before 'unqualified name as if it ...'
34528             on the third line of [2]. Based on [3], this option
34529             was added in glibc 2.14 as solving [4] bug.
34530
34531             [1] https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
34532             [2] http://www.daemon-systems.org/man/resolv.conf.5.html man page.
34533             [3] https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;h=952f32af17e7fb49c4c1a305de673a13075bfaf5;hb=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
34534             [4] https://sourceware.org/bugzilla/show_bug.cgi?id=12734
34535
34536 credentials.7
34537     Josh Triplett
34538         Cross-reference getgroups(2)
34539             Since credentials.7 discusses supplementary GIDs, it should
34540             reference getgroups(2).
34541
34542 fanotify.7
34543     Heinrich Schuchardt
34544         Allow relative paths in example
34545             The current example code requires passing an absolute
34546             path to the mount to be watched.
34547
34548             By passing AT_FDCWD to fanotify_mark it can use both
34549             absolute and relative paths.
34550     Heinrich Schuchardt
34551         fallocate(2) creates no events
34552             fallocate(2) should create FAN_MODIFY events but does not.
34553     Heinrich Schuchardt [Michael Kerrisk]
34554         fanotify notifies only events generated on the same mount
34555             Unfortunately, fanotify does not inform listeners for all paths
34556             under which a touched filesystem object is visible, but only the
34557             listener using the same path as the process touching the
34558             filesystem object.
34559     Heinrich Schuchardt
34560         Update BUGS to note bugs still not fixed in 3.17
34561             I bumped the Linux version number in the BUGS section to 3.17.
34562
34563 inotify.7
34564     Heinrich Schuchardt
34565         fallocate(2) does not trigger inotify events
34566             Calling fallocate(2) does not result in inotify events.
34567
34568 locale.7
34569     Marko Myllynen
34570         Improve LOCPATH description
34571             LOCPATH is ignored by privileged programs.
34572
34573             Add locale archive references.
34574
34575             Add FILES section.
34576
34577 man-pages.7
34578     Michael Kerrisk  [Laurent Georget]
34579         Clarify that SEE ALSO entries may refer to pages from other projects
34580
34581 signal.7
34582     Michael Kerrisk
34583         Mention other "slow devices"
34584             Reads from eventfd(2), signalfd(2), timerfd(2), inotify(7),
34585             and fanotify(7) file descriptors are also slow operations
34586             that are restartable.
34587     Michael Kerrisk
34588         Fix SO_RECVTIMEO/ SO_SENDTIMEO confusion in text
34589     Michael Kerrisk
34590         Since Linux 3.8, reads on inotify(7) file descriptors are restartable
34591     Michael Kerrisk
34592         inotify(7) reads no longer show the odd EINTR error after SIGCONT
34593             Since kernel 3.7, reads from inotify(7) file descriptors no longer
34594             show the (Linux oddity) behavior of failing with EINTR when the
34595             process resumes after a stop signal + SIGCONT.
34596     Michael Kerrisk
34597         SEE ALSO: add sigreturn(2)
34598
34599 unix.7
34600     Michael Kerrisk  [Scott Harvey]
34601         Fix buglet in code snippet in BUGS section
34602
34603 ld.so.8
34604     Carlos O'Donell
34605         Add --inhibit-cache option
34606             The dynamic loader has 6 options, only 5 are documented.
34607             This patch documents the sixth option i.e. `--inhibit-cache`.
34608     Jonathan Wakely  [Siddhesh Poyarekar]
34609         Correct documentation of $ORIGIN
34610             As noted by Siddhesh:
34611
34612                 The ld.so man page says:
34613
34614                     $ORIGIN (or equivalently ${ORIGIN})
34615                         This expands to the directory containing the
34616                         application executable.  Thus, an application located
34617                         in somedir/app could be compiled with
34618
34619                 This is incorrect since it expands to the directory containing
34620                 the DSO and not the application executable.  This seems like
34621                 deliberate behaviour in dl-object.c, so it needs to be fixed in
34622                 the man page.
34623
34624             See http://stackoverflow.com/questions/26280738/what-is-the-equivalent-of-loader-path-for-rpath-specification-on-linux/26281226#26281226
34625
34626
34627
34628 ==================== Changes in man-pages-3.77 ====================
34629
34630 Released: 2015-01-10, Munich
34631
34632
34633 Contributors
34634 ------------
34635
34636 The following people contributed patches/fixes or (noted in brackets
34637 in the changelog below) reports, notes, and ideas that have been
34638 incorporated in changes in this release:
34639
34640 Akihiro Motoki <amotoki@gmail.com>
34641 Alexandre Bique <bique.alexandre@gmail.com>
34642 Andre Majorel <aym-xunil@teaser.fr>
34643 Andy Lutomirski <luto@amacapital.net>
34644 Daniel Borkmann <dborkman@redhat.com>
34645 Dave Hansen <dave.hansen@intel.com>
34646 Elie De Brauwer <eliedebrauwer@gmail.com>
34647 Heinrich Schuchardt <xypron.glpk@gmx.de>
34648 Ignat Loskutov <ignat.loskutov@gmail.com>
34649 Jeff Epler <jepler@unpythonic.net>
34650 Jérôme Pouiller <jezz@sysmic.org>
34651 Kees Cook <keescook@chromium.org>
34652 Laurent Georget <laurent.georget@supelec.fr>
34653 Masanari Iida <standby24x7@gmail.com>
34654 Michael Haardt <michael@moria.de>
34655 Michael Kerrisk <mtk.manpages@gmail.com>
34656 Mike Frysinger <vapier@gentoo.org>
34657 Richard Cochran <richardcochran@gmail.com>
34658 Stephan Mueller <stephan.mueller@atsec.com>
34659 Troy Davis <troy@yort.com>
34660 Vince Weaver <vincent.weaver@maine.edu>
34661 Will Drewry <wad@chromium.org>
34662
34663 Apologies if I missed anyone!
34664
34665
34666 New and rewritten pages
34667 -----------------------
34668
34669 seccomp.2
34670     Kees Cook, Michael Kerrisk, Will Drewry  [Andy Lutomirski]
34671         New page documenting seccomp(2)
34672             Combines documentation from prctl, in-kernel seccomp_filter.txt
34673             and dropper.c, along with details specific to the new system call.
34674
34675
34676 Newly documented interfaces in existing pages
34677 ---------------------------------------------
34678
34679 netlink.7
34680     Stephan Mueller  [Michael Kerrisk]
34681         Add NETLINK_CRYPTO
34682
34683
34684 Changes to individual pages
34685 ---------------------------
34686
34687 adjtimex.2
34688     Laurent Georget  [Richard Cochran, Jeff Epler]
34689         Clarify the 'ppm scaling' used in struct timex
34690             This patch makes explicit and clarifies the unit used for
34691             the fields "freq", "ppsfreq" and "stabil" in struct timex.
34692     Michael Kerrisk  [Masanari Iida]
34693         Note that TIME_ERROR is the modern synonym for TIME_BAD
34694
34695 perf_event_open.2
34696     Vince Weaver
34697         Clarify the PERF_FLAG_FD_* flags
34698             This change clarifies the behavior of the PERF_FLAG_FD_OUTPUT and
34699             PERF_FLAG_FD_NO_GROUP flags to perf_event_open(), and removes
34700             the related FIXME comments.
34701
34702             While writing tests to validate the behavior of these flags I
34703             discovered that PERF_FLAG_FD_OUTPUT has been broken since the
34704             2.6.35 kernel release.
34705
34706 prctl.2
34707     Dave Hansen [Michael Kerrisk]
34708         Add description of Intel MPX calls
34709             The 3.19 kernel will have support for Intel MPX, including
34710             a pair of new prctl() calls (PR_MPX_ENABLE_MANAGEMENT and
34711             PR_MPX_DISABLE_MANAGEMENT) for enabling and disabling the
34712             kernel's management of the "bounds tables".  Add a
34713             descriptions of the interface.
34714     Michael Kerrisk
34715         Add mention of seccomp(2) under PR_SET_SECCOMP
34716     Michael Kerrisk
34717         Suggest /proc/PID/status "Seccomp" as alternative to PRCTL_GET_SECCOMP
34718     Michael Kerrisk
34719         SIGKILL can also occur PRCTL_GET_SECCOMP in SECCOMP_MODE_FILTER mode
34720     Kees Cook  [Andy Lutomirski]
34721         Document SECCOMP_MODE_FILTER vs EFAULT
34722             This notes the distinction made between EINVAL and EFAULT when
34723             attempting to use SECCOMP_MODE_FILTER with PR_SET_SECCOMP.
34724
34725 setns.2
34726 pid_namespaces.7
34727     Mike Frysinger
34728         Elaborate discussion of the PID namespace descendant limitation
34729             The setns(2) man page already mentions that CLONE_NEWPID may only
34730             be used with descendant namespaces, but this nuance could be
34731             listed in a few more places so it is not missed.
34732
34733 shmget.2
34734     Michael Kerrisk  [Akihiro Motoki]
34735         Make wording of SHMALL description a little clearer
34736
34737 sigaction.2
34738     Michael Kerrisk
34739         Add siginfo_t fields for SECCOMP_RET_TRAP
34740
34741 memchr.3
34742 strstr.3
34743     Alexandre Bique
34744         Reference memmem(3) in SEE ALSO section
34745
34746 memcmp.3
34747     Michael Kerrisk  [Michael Haardt]
34748         NOTES: add some detail on avoiding memcmp() of cryptographic data
34749             Wording largely based on comments from Michael Haardt.
34750
34751 pthread_tryjoin_np.3
34752     Jérôme Pouiller  [Michael Kerrisk]
34753         Document EINVAL error for pthread_timedjoin_np()
34754
34755 mem.4
34756     Elie De Brauwer
34757         /dev/kmem depends on CONFIG_DEVKMEM
34758     Elie De Brauwer
34759         Correct /dev/port group in example
34760             mem.4 mentions that group for /dev/port should be set to 'mem'
34761             However, all other files (/dev/mem and /dev/kmem) use the kmem
34762             group in their examples and on my system /dev/port belongs to
34763             kmem. Hence the 'mem' group was probably a typo:
34764     Elie De Brauwer
34765         Add CONFIG_STRICT_DEVMEM
34766             Since 2.6.26 the CONFIG_NONPROMISC_DEVMEM options limits the
34767             physical addresses which can be accessed through /dev/mem.
34768
34769 random.4
34770     Heinrich Schuchardt
34771         Describe handling of O_NONBLOCK
34772             /dev/random and /dev/urandom treat O_NONBLOCK differently.
34773             This should be described in the manpage.
34774     Heinrich Schuchardt
34775         Mention PRNG used by urandom
34776             /dev/urandom uses a pseudo-random number generator to replace
34777             missing entropy.
34778
34779 proc.5
34780     Michael Kerrisk
34781         Document "Seccomp" field of /proc/PID/status
34782
34783 epoll.7
34784     Michael Kerrisk  [Ignat Loskutov]
34785         Use epoll_create1() rather than epoll_create() in the code example
34786             epoll_create1() is more or less the preferred API for new
34787             applications, since it allows for some flags and avoids the
34788             misdesigned epoll_create() argument, and so it seems sensible
34789             to use that in the example, rather than epoll_create().
34790
34791 tcp.7
34792     Troy Davis
34793         Clarify tcp_tw_recycle on Internet-facing hosts
34794             Clarify that tcp_tw_recycle will break communication with many
34795             general-purpose remote Internet hosts (namely, remote NAT devices)
34796             even when the Linux device itself is not behind NAT.