1 ==================== Changes in man-pages-2.00 ====================
8 The following people contributed notes, ideas, or patches that have
9 been incorporated in changes in this release:
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>
32 Apologies if I missed anyone!
37 Many math pages had their synopses compressed, as per suggestion
40 Many minor content and formatting bug fixes were made to the math
41 pages, following suggestions from Fabian Kreutz (who recently
42 translated many of the 1.70 math pages into German) and
45 For consistency, all instances of "super-user" were changed to the more
48 After a note from Vasya Pupkin, I added <errno.h> to the SYNOPSIS
49 of several Section 2 pages using the _syscallN() macros.
52 -- erroneous semicolons at the end of _syscallN() were removed
55 -- types such as "uint" in syscallN() declarations were changed
56 to "unsigned int", etc.
58 -- various other minor breakages in the synopses were fixed.
60 The affected pages are:
74 Typographical or grammatical errors have been corrected in several
77 Changes to individual pages
78 ---------------------------
82 Added 'const' to declaration of 'my_addr' in prototype.
83 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239762
87 Added O_NOATIME to list of flags that can be changed via F_SETFL.
89 Noted F_GETOWN bug after suggestion from aeb.
91 http://marc.theaimsgroup.com/?l=linux-kernel&m=108380640603164&w=2
95 Material on getrusage.2 has been separated out into its own page.
96 Rewrote discussion on RLIMIT_MEMLOCK to incorporate kernel
98 Added note on RLIMIT_CPU error in older kernels.
99 Added RLIMIT_SIGPENDING
100 Also made a few other minor changes.
104 This page is new(ish) -- it was created by splitting
107 Repaired note on SIGCHLD behavior to note that the
108 POSIX non-conformance has been fixed in 2.6.9.
111 Modified after suggestion from Emmanuel Colbus
112 Changed wording of sentence under NOTES describing
113 when signals can be sent to init.
115 mlock.2, munlock.2, mlockall.2, munlockall.2
116 These have been consolidated into a single mlock.2 page.
117 In the process, much duplication was eliminated
118 and new information was added about RLIMIT_MEMLOCK
119 and the changes in memory locking in kernel 2.6.9,
123 Added cross-ref to setrlimit(2) concerning memory locking limits.
125 Note that MAP_FIXED replaces existing mappings
129 Substantial language and formatting clean-ups.
130 Added msqid_ds and ipc_perm structure definitions.
134 Substantial language and formatting clean-ups.
135 Added notes on /proc files.
139 Substantial language and formatting clean-ups.
140 Added notes on /proc files.
144 Added O_NOATIME (new in Linux 2.6.8)
146 Reordered list of 'flags' description alphabetically
149 2004-11-03 applied patch from Martin Schulze
153 Substantial language and formatting clean-ups.
155 Added semid_ds and ipc_perm structure definitions.
159 Substantial language and formatting clean-ups.
160 Added notes on /proc files.
161 Rewrote BUGS note about semget()'s failure to initialize
166 Substantial language and formatting clean-ups.
167 Added notes on /proc files.
171 Substantial language and formatting clean-ups.
172 Updated shmid_ds structure definitions.
173 Added information on SHM_DEST and SHM_LOCKED flags.
174 Noted that CAP_IPC_LOCK is not required for SHM_UNLOCK
176 Added notes on 2.6.9 RLIMIT_MEMLOCK changes.
177 Added RLIMIT_SIGPENDING (new in Linux 2.6.8)
181 Substantial language and formatting clean-ups.
182 Added notes on /proc files.
186 Substantial language and formatting clean-ups.
187 Changed wording and placement of sentence regarding attachment
188 of segments marked for destruction.
192 Added mention of SIGCONT under SA_NOCLDSTOP.
194 Updated discussion for POSIX.1-2001 and SIGCHLD and sa_flags.
195 Noted that CLD_CONTINUED is supported since Linux 2.6.9.
196 Added SI_TKILL (new in Linux 2.4.19).
201 Removed text on ignoring SIGCHLD; replaced with pointer
205 After bug report from Andrey Kiselev
206 Fixed prototype: "timeout" --> "*timeout"
207 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=222145
211 Added text to clarify that S_IS*() macros should be applied to
213 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=249698
216 After bug report from Anand Kumria
217 Added "no swap space signature" to EINVAL error
218 as per http://bugs.debian.org/cgi-bin/bugreport.cgi
220 Added EINVAL error for swapoff() ("not currently a swap area").
221 Added EBUSY error for swapon().
222 A few formatting fixes.
226 In Linux 2.6, the return value of times changed; it is no
227 longer time since boot, but rather:
229 boot_time + 2^32 / HZ - 300
231 Repaired note on SIGCHLD behavior to note that the
232 POSIX non-conformance has been fixed in 2.6.9.
233 Some formatting fixes.
236 After bug report from Johannes Berg
241 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=220741
246 Added WCONTINUED and WIFCONTINUED (new in 2.6.10).
247 Added text on SA_NOCLDSTOP.
248 Updated discussion of SA_NOCLDWAIT to reflect 2.6 behavior.
249 Much other text rewritten.
253 Rewrote this page, removing much duplicated information,
254 and replacing with pointers to wait.2.
255 Luis Javier Merino Morán / mtk
256 CONFORMING TO said "SVr4, POSIX". Changed to "4.3BSD"
263 After bug report from Branden Robinson
264 The assert() failure message goes to stderr not stdout.
265 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=284814
269 Noted that 0 in tm_mday is interpreted to mean the last day
270 of the preceding month.
273 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=229618
274 getnameinfo() does not set errno, it returns a non-zero
275 value indicating the error.
277 added EAI_OVERFLOW error
281 Minor changes to SEE ALSO and CONFORMING TO.
285 New page by Andries Brouwer
289 Change "NULL" to "empty" when talking about the value of TZ.
290 http://sources.redhat.com/bugzilla/show_bug.cgi?id=601
293 After bug report from Jan Kuznik
294 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=205736
295 Fixed bad realloc() use in snprintf() example
299 Added discussion of resolved_path == NULL.
302 After bug report from John V. Belmonte
303 Updated init and quit scripts to reflect kernel 2.4/2.6 reality
304 (Scripts taken from drivers/char/random.c)
305 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=247779
309 Updated description of /proc/loadavg to include
310 nr_running(), nr_threads, last_pid.
312 rtsig-max and rtsig-nr went away in 2.6.8
314 updated statm, and fixed error in order of list
317 applied patch from Martin Schulze
321 Added O_NOATIME for CAP_FOWNER
324 Karel Kulhavy and AEB
325 formatting fix after note from Karel Kulhavy and AEB, plus a
330 /proc/sys/kernel/rtsig-* were superseded by RLIMIT_SIGPENDING
335 Updated details of interaction of TCP_CORK and TCP_NODELAY.
337 ==================== Changes in man-pages-2.01 ====================
344 The following people contributed notes, ideas, or patches that have
345 been incorporated in changes in this release:
347 Carsten Hey <c.hey@web.de>
348 Johannes Berg <johannes@sipsolutions.de>
349 Joshua Kwan <joshk@triplehelix.org>
350 Marek Habersack <grendel@debian.org>
351 Martin Schulze <joey@infodrom.org>
352 Matthew Dempsky <jivera@flame.org>
353 Matthew Gregan <kinetik@orcon.net.nz>
354 Pedro Zorzenon Neto <pzn@terra.com.br>
355 Tony Crawford <tony@klosterdorf.de>
357 Apologies if I missed anyone!
363 triggered by http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=283179
364 The wording describing how errno is set was fixed up in the
379 Typographical or grammatical errors have been corrected in several
382 Changes to individual pages
383 ---------------------------
387 Adjusted descriptions of argument file types to be closer to
389 Wording and formatting changes
394 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=270817
395 Formulae on the pages should be T = S / C not T = C / S.
399 Removed errno declaration from prototype, added notes
400 on historical need for this declaration.
401 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=174175
404 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=224953
405 Changed erroneous "aio_return(2)" to "aio_return(3)"
413 Added description of ptsname_r().
418 New link to ptsname.3.
422 add <fcntl.h> to synopsis
423 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=271243
430 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=234443
434 Added _GNU_SOURCE to prototype
435 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=213538
439 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248
441 Changed range for "%S" from 0..61 to 0..60.
443 SUSv3 says 0..60. I think the manual page probably says
444 0..61, because that's what SUSv2 said.
445 (Some other implementations' man pages also say 0..61 --
446 e.g., Solaris 8 & 9, Tru64 5.1B; FreeBSD 5.1 says 0..60.)
448 The glibc manual currently says 0..60.
450 Given that SUSv3 says 0..60, I've changed the
451 manual page to also say this:
453 -The second as a decimal number (range 00 to 61).
454 +The second as a decimal number (range 00 to 60).
455 +(The range is up to 60 to allow for occasional leap seconds.)
458 Johannes Berg / http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=226974
459 -.BR POSIX2_FORT_RUN " - " _SC_2_FORT_DEV
460 +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV
464 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638
465 Noted use of _XOPEN_SOURCE to get macros <sytdlib.h>
469 Changed name of argument from 'string' to 'command' (like POSIX).
471 Noted that glibc does nowadays explicitly check for the existence
472 of the shell if 'command' is NULL, rather than the older behavior
473 of assuming the shell exists and always returning 1 if
476 Other wording and formatting clean-ups.
479 Remove some functions names that *are* documented.
482 ==================== Changes in man-pages-2.02 ====================
489 The following people contributed notes, ideas, or patches that have
490 been incorporated in changes in this release:
492 Andries Brouwer <Andries.Brouwer@cwi.nl>
493 Branden Robinson <branden@debian.org>
494 Colin Watson <cjwatson@debian.org>
495 David Lloyd <dmlloyd@tds.net>
496 Gordon Jin <gordon.jin@intel.com>
497 Heikki Orsila <shd@modeemi.cs.tut.fi>
498 Jamie Lokier <jamie@shareable.org>
500 Kai Makisara <Kai.Makisara@kolumbus.fi>
501 Marko Kohtala <marko.kohtala@gmail.com>
502 Martin Pool <mbp@sourcefrog.net>
503 Martin (Joey) Schulze <joey@infodrom.org>
504 Matthias Lang <matthias@corelatus.se>
505 Michael Haardt <michael@moria.de>
506 Michael Mühlebach <michael@anduin.ch>
507 Mike Frysinger <vapier@gentoo.org>
508 Sasa Stevanovic <mg94c18@alas.matf.bg.ac.yu>
509 Serguei Leontiev <leo@sai.msu.ru>
511 Apologies if I missed anyone!
516 Martin (Joey) Schulze
517 Removed SEE ALSO reference to non-existent newctime(3) from:
524 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=236884
526 Typographical or grammatical errors have been corrected in several
529 Changes to individual pages
530 ---------------------------
534 Noted the PID caching behavior of NPTL's getpid()
537 Added futex(2), set_thread_area(2), set_tid_address(2),
538 tkill(2) under SEE ALSO.
543 Improved various error descriptions.
546 David Lloyd / Mike Frysinger, Marko Kohtala
547 Added EINTR to errors.
551 Improved discussion of F_SETOWN and F_SETSIG with respect to
552 multi-threaded programs.
553 Generally cleaned up the discussion of F_SETOWN.
555 Updated CONFORMING TO to note that F_GETOWN and F_SETOWN are
560 Noted discrepancy between Linux and POSIX.1 when oldpath
562 See: http://bugs.linuxbase.org/show_bug.cgi?id=367
563 and: http://www.opengroup.org/austin/mailarchives/ag/msg08152.html
566 Clarified EXDEV error description: it isn't possible to link
567 across mount points, even if the mount points refer to the same
571 mtk, after note from Gordon Jin
575 As per message from Serguei Leontiev
576 Removed SVr2, AT&T, and BSD from CONFORMING TO, since
577 a pipe on those systems is actually bidirectional.
578 (Pipes are implemented as STREAMS on the former, and
579 sockets on the latter.)
583 Noted kernel version where posix_fadvise() appeared and
584 noted bug in handling of 'len' in kernels < 2.6.6.
588 Clarified EXDEV error description: it isn't possible to rename
589 a file across mount points, even if the mount points refer to
590 the same file system.
594 Noted kernel version numbers for semtimedop().
598 Noted MAX_SEC_IN_JIFFIES ceiling.
599 Added note about treatment of out-of-range tv_usec values.
602 Johan Walles, Martin (Joey) Schulze
603 Added sigqueue.2 to SEE ALSO
607 Added notes on non-standard behavior: Linux allows 'buf' to
608 be NULL, but POSIX.1 doesn't specify this and it's non-portable.
612 Improved DESCRIPTION; clarified distinction between
617 bcopy() handles overlapping case, but memcpy() does not,
618 so for consistency memmove() should be also mentioned.
621 Martin (Joey) Schulze
622 New link to man3/getmntent.3.
625 Small wording change after suggestion from Sasa Stevanovic.
629 Created as link to strstr.3.
633 Noted that SUSv2 allowed a range of 00 to 61 for %S specifier.
637 Added description of strcasestr().
641 Improved description of read from /dev/urandom.
651 Mention the .URL macro more verbosely.
654 ==================== Changes in man-pages-2.03 ====================
661 The following people contributed notes, ideas, or patches that have
662 been incorporated in changes in this release:
664 Andries Brouwer <Andries.Brouwer@cwi.nl>
665 Joey (Martin) Schulze <joey@infodrom.org>
666 Johannes Nicolai <johannes.nicolai@hpi.uni-potsdam.de>
667 Justin Pryzby <justinpryzby@users.sourceforge.net>
668 Klaus Ethgen <Klaus@Ethgen.de>
669 Pavel Heimlich <tropikhajma@seznam.cz>
670 Ross Boylan <RossBoylan@stanfordalumni.org>
671 Vincent Fourmond <vincent.fourmond@9online.fr>
673 Apologies if I missed anyone!
679 Change `ttys(4)' to `ttyS(4)' in:
680 tty.4 mouse.4 vcs.4 console_ioctl.4 console.4
682 Typographical or grammatical errors have been corrected in several
685 Changes to individual pages
686 ---------------------------
690 Substantially enhanced discussion of CLONE_THREAD.
692 Added CLONE_SYSVSEM, CLONE_UNTRACED, CLONE_STOPPED.
698 Noted effect of ptracing when execing a set-UID program.
701 Johannes Nicolai / mtk
702 Noted F_SETOWN bug for socket file descriptor in Linux 2.4
705 Added text on permissions required to send signal to owner.
709 Noted that lock conversions are not atomic.
713 ru_nswap has never contained useful information.
714 Kernel 2.6.6 clarified that with a patch
715 ("[PATCH] eliminate nswap and cnswap"). See also:
716 http://www.ussg.iu.edu/hypermail/linux/kernel/0404.1/0720.html
720 Clarified wording of the 'pid == -1' case.
724 Added MNT_EXPIRE, plus a few other tidy-ups.
728 Added text to note that sched_setaffinity() will migrate the
729 affected process to one of the specified CPUs if necessary.
731 Added a NOTE to point out that the affinity mask is actually a
732 per-thread attribute that can be adjusted independently for
733 each thread in a thread group.
737 Noted aberrant Linux behavior with respect to new attaches to a
738 segment that has already been marked for deletion.
740 Noted changes in permissions required for SHM_LOCK/SHM_UNLOCK.
744 Noted that the __W* flags can't be used with waitid().
748 Added _CS_GNU_LIBC_VERSION and _CS_GNU_LIBPTHREAD_VERSION.
751 Ross Boylan / Martin Schulze
752 various changes as per
753 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=304242
757 Minor changes to discussion of /proc/PID/stat signal fields.
758 Added 'rt_priority' and 'policy' to /proc/PID/stat.
762 1,$s/inherited/inheritable/g
765 Vincent Fourmond / Joey (Martin) Schulze
766 Removed discussion of `[[:<:]]' and `[[:>:]]' since they do
767 not seem to be in the glibc implementation.
768 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295666
771 Joey (Martin) Schulze / Klaus Ethgen
772 The default zoneinfo directory is now /usr/share/zoneinfo.
773 (was: /usr/local/etc/zoneinfo)
774 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=267471
777 ==================== Changes in man-pages-2.04 ====================
784 The following people contributed notes, ideas, or patches that have
785 been incorporated in changes in this release:
787 Andries Brouwer <Andries.Brouwer@cwi.nl>
788 Baurjan Ismagulov <ibr@ata.cs.hun.edu.tr>
789 Dave Love <d.love@dl.ac.uk>
790 Dieter Brueggemann <dieter.brueggemann@entitec.de>
791 Geoff Clare <gclare@gclare.org.uk>
792 Guido Trotter <ultrotter@debian.org>
793 kabloom <kabloom@ucdavis.edu>
794 Kevin Ryde <user42@zip.com.au>
795 Justin Pryzby <justinpryzby@users.sourceforge.net>
796 Mike Furr <mfurr@debian.org>
797 Olivier Croquette <ocroquette@free.fr>
798 Olivier Guilyardi <ylf@xung.org>
799 Peter Cordes <peter@llama.nslug.ns.ca>
800 Philipp Spitzer <philipp@toastfreeware.priv.at>
801 Tanaka Akira <akr@m17n.org>
802 Thierry Excoffier <exco@bat710.univ-lyon1.fr>
803 Thomas Hood <jdthood@yahoo.co.uk>
804 Vincent Lefevre <vincent@vinc17.org>
805 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
807 Apologies if I missed anyone!
812 For consistency across pages:
814 1,$s/nonzero/non-zero/g
816 Typographical or grammatical errors have been corrected in several
825 An overview of the Linux implementations of POSIX threads.
828 Changes to individual pages
829 ---------------------------
833 Various minor changes
837 BUGS: In kernels < 2.6.9, EPOLL_CTL_DEL required a non-NULL
838 'event', even though this argument is ignored.
839 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306517.
843 Clarified semantics of relationship between flock() locks
844 and open file entries and file descriptors.
845 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=291121
848 Olivier Croquette, Thierry Excoffier
849 Noted the existence of the short sleep bug (up to 1 jiffy).
853 RLIMIT_RSS only has affect "in 2.4.x", not "in 2.4 and later".
857 Since Linux 2.6, the ru_nvcsw and ru_nivcsw fields are used.
861 Rewrote description of return value.
862 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=296183
866 O_DIRECT needs _GNU_SOURCE.
868 O_ASYNC works for pipes and FIFOs in Linux 2.6
873 Various minor changes
877 Various minor changes
880 mtk / Philipp Spitzer
881 Fix description of return value.
882 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308359
886 Changed (char *) to (void *) in example.
887 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313607
891 make log(3) SEE ALSO log1p(3)
892 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=309578
896 Fix description of RETURN VALUE for makecontext()
897 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311800
901 Various minor changes
905 Small fix to a code example
906 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=194842.
910 When specifying resolved_path as NULL, realpath()
911 will (still) only allocate up to PATH_MAX bytes.
912 Plus other minor changes.
913 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239424
917 The required header file for these functions on Linux is <netdb.h>
918 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311680
922 Arg for %p is a pointer to _a pointer to_ void.
923 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263109
927 freopen() can change the descriptors associated with
929 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295859.
933 strerror_r(3) requires #define _XOPEN_SOURCE 600
934 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=290880
938 Fix typo: "_SC_2_DEV" should be "_SC_2_C_DEV"
942 Added pointers under /proc/sys/net to tcp.7 and ip.7
946 Various wording and formatting fixes.
947 Reordered /proc/sys/net/ipv4/ip_* file descriptions alphabetically.
950 Dieter Brueggemann / mtk
951 Fixes to the discussion of SIOCATMARK and tcp_stdurg
953 Various wording and formatting fixes.
954 Incorporated some new /proc/sys/net/ipv4/tcp_* file descriptions
955 from the 2.6.12 source file Documentation/networking/ip-sysctl.txt.
958 ==================== Changes in man-pages-2.05 ====================
965 The following people contributed notes, ideas, or patches that have
966 been incorporated in changes in this release:
968 A Costa <agcosta@gis.net>
969 Andries Brouwer <Andries.Brouwer@cwi.nl>
970 Bas Zoetekouw <bas@debian.org>
971 Dan Jacobson <jidanni@jidanni.org>
972 Delian Krustev <krustev@krustev.net>
973 Dora Anna Volgyesi <volgyesi@elte.hu>
974 Martin (Joey) Schulze <joey@infodrom.org>
975 Ove Kaaven <ovek@arcticnet.no>
977 Apologies if I missed anyone!
982 Typographical or grammatical errors have been corrected in several
983 places. (Special thanks to A Costa.)
986 Changes to individual pages
987 ---------------------------
991 Reversed 2.04 introduction of the term "process termination
996 Clarified what type of lock close() affects.
997 Minor formatting changes.
1001 Consistent use of terms "open file description",
1002 "file status flags", and "file descriptor flags"
1003 Removed mention of lock sharing -- it was not
1005 Minor formatting fixes
1009 Consistent use of terms "open file description",
1010 "file status flags", and "file descriptor flags"
1011 Some rewriting of discussion of file descriptor flags
1012 Under F_DUPFD, replaced some text duplicated in dup.2
1013 with a cross ref to dup.2
1014 Minor wording and formatting fixes
1017 mtk / Martin (Joey) Schulze / Bas Zoetekouw
1018 The return value of isinf() changed in glibc 2.02
1019 to differentiate positive and negative infinity.
1020 See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765
1025 Remove confusing text describing real and effective IDs.
1026 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285852
1030 The short sleep bug (up to 1 jiffy) that was newly noted in
1031 man-pages-2.04 has just been fixed in 2.6.12.
1035 Changed range documented in main text from -20..20 to -20..19.
1036 Noted that the range is -20..20 on some systems.
1040 Clarification of term "open file description" along with
1041 explanation of what information it maintains.
1042 Other wording improvements
1043 Various minor wording changes
1047 Reversed 2.04 introduction of the term "process termination
1050 Noted use of atexit() for establishing function to be invoked on
1051 shared library unload.
1052 Noted that atexit()-registered functions are not invoked on
1053 abnormal termination.
1058 Reversed 2.04 introduction of the term "process termination
1061 Minor rewording and formatting changes.
1065 Added #define _BSD_SOURCE to prototype
1068 Martin (Joey) Schulze
1073 Added definition of Linux dirent structure.
1074 Some formatting cleanups.
1077 Dora Anna Volgyesi/ mtk
1078 strtold() and strtof() need _ISOC99_SOURCE or _XOPEN_SOURCE=600
1079 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=246668
1083 New link to tsearch.3
1087 Added tdestroy to .TH line
1091 Change "chown root:mem /dev/mem" to "chown root:kmem /dev/mem"
1095 Change "chown root:mem /dev/null /dev/zero" to
1096 "chown root:root /dev/null /dev/zero"
1099 Dan Jacobson / Martin (Joey) Schulze
1100 Replaced "selection(1)" by "gpm(8)" under SEE ALSO
1101 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=253515
1105 SA_SIGACTION should be SA_SIGINFO
1106 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=305369
1113 ==================== Changes in man-pages-2.06 ====================
1115 Released: 2005-07-15
1120 The following people contributed notes, ideas, or patches that have
1121 been incorporated in changes in this release:
1123 Alain Portal <aportal@univ-montp2.fr>
1124 Andries Brouwer <Andries.Brouwer@cwi.nl>
1125 Bhavesh P Davda <bhavesh@avaya.com>
1126 Clau Weber <claus@jambit.com>
1127 Dov Murik <dov@dv-networks.com>
1128 David Lloyd <dlloyd@microbits.com.au>
1129 Frederik Deweerdt <frederik.deweerdt@gmail.com>
1130 Justin Pryzby <justinpryzby@users.sourceforge.net>
1131 Lars Wirzenius <liw@iki.fi>
1132 Martin Pool <mbp@sourcefrog.net>
1133 Mike Frysinger <vapier@gentoo.org>
1134 Petter Reinholdtsen <pere@hungry.com>
1135 Steven Murdoch <Steven.Murdoch@cl.cam.ac.uk>
1136 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1138 Apologies if I missed anyone!
1143 Typographical or grammatical errors have been corrected in several
1146 Many uses of hyphens and dashes were corrected.
1152 canonicalize_file_name.3
1160 AFAIK, this system call has never actually done anything (other
1161 than be a stub) on any Unix.
1163 Changes to individual pages
1164 ---------------------------
1168 Various wording and formatting fixes.
1172 Minor formatting changes
1176 Various minor wording improvements; some formatting fixes
1180 Various wording and formatting fixes.
1184 s/positive/non-negative/ [for file descriptor]
1188 Documented RLIMIT_MSGQUEUE limit.
1189 RLIMIT_RSS ceased to have any effect in 2.4 in kernel 2.4.30.
1190 (It already didn't have any effect in 2.2.x and 2.6.x.)
1191 s/MADVISE_WILLNEED/MADV_WILLNEED/
1195 Removed historic comment on BSD backlog ceiling.
1196 Minor wording and formatting changes.
1200 Added BUG: in some circumstances, a process that is
1201 waiting for a semaphore to become zero is not not woken
1202 up when the value does actually reach zero.
1203 http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2
1204 http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2
1208 Various minor wording improvements
1212 Added mkdir(2) to discussion, made term "file mode creation
1214 Various, mostly small, wording changes
1218 Change description for ESTALE
1219 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=237344
1225 Added SEE ALSO putgrent(3)
1226 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=211336
1232 Lars Wirzenius / mtk
1233 Replace mention of /etc/{passwd,group} by references to
1234 "passwd/group database", and LDAP and NIS.
1235 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
1237 Miscellaneous wording improvements
1238 Consistent DESCRIPTION and ERRORS wording across these pages.
1242 Relocate misplaced text describing gai_strerror().
1246 s/endservent/endnetent/
1247 As per Debian Bug#316517
1250 Lars Wirzenius / mtk
1251 Replace mention of /etc/shadow by references to
1252 "shadow password database", and LDAP and NIS.
1253 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
1255 Miscellaneous wording improvements
1256 Consistent DESCRIPTION wording vis-a-vis getpwnam.3 etc.
1260 Fix hsearch_r() prototype
1264 Fix description of RETURN VALUE
1265 As per Debian Bug#317037
1267 various parts substantially rewritten; added description of
1268 %n$ form; various text incorporated from the GNU C library
1269 documentation ((C) The Free Software Foundation).
1273 Modified details of how user and group ownership of a new
1275 Various minor wording and formatting cleanups.
1279 tweaked the short description to include definition of 'ELF'
1280 add ELFOSABI_NONE to the ELFOSABI_ list
1281 tweak/add more machines to EM_ list for ehdr->e_machine
1282 fix indenting to be consistent
1283 tweak the display of the ELF_ST_* macros
1284 document the Elf_Dyn structure
1288 Updated discussion of /proc/stat.
1289 Added text on the /proc/sys/fs/mqueue/* files.
1293 Change protocol in UDP prototype.
1294 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182635
1298 The first sentence under NOTES about SO_KEEPALIVE and SIGPIPE
1299 makes no grammatical sense (and possibly also no technical sense).
1300 It has been removed.
1303 ==================== Changes in man-pages-2.07 ====================
1305 Released: 2005-07-19
1310 The following people contributed notes, ideas, or patches that have
1311 been incorporated in changes in this release:
1313 Andries Brouwer <Andries.Brouwer@cwi.nl>
1314 Mike Frysinger <vapier@gentoo.org>
1316 Apologies if I missed anyone!
1321 The terms "set-user-ID" and "set-group-ID" are now used consistently
1322 (no abbreviations) across all manual pages.
1324 Consistent use of "saved set-user-ID" and "saved set-group-ID"
1325 (no more "saved user ID", "saved effective UID", saved group ID", etc.)
1327 Global fixes in textual descriptions:
1334 Consistent use of st_atime, st_ctime, st_mtime, with explanatory text,
1335 instead of atime/ctime/mtime.
1337 Classical BSD versions are now always named x.yBSD (formerly
1338 there was a mix of x.yBSD and BSD x.y).
1340 Typographical or grammatical errors have been corrected in several
1344 Changes to individual pages
1345 ---------------------------
1353 Improve description of st_dev and st_rdev.
1355 Various wording and formatting improvements.
1359 Some formatting fixes
1362 ==================== Changes in man-pages-2.08 ====================
1364 Released: 2005-09-21
1369 The following people contributed notes, ideas, or patches that have
1370 been incorporated in changes in this release:
1372 Adrian Bunk <bunk@stusta.de>
1373 Alain PORTAL <aportal@univ-montp2.fr>
1374 Andrew Pimlott <andrew@pimlott.net>
1375 Andries Brouwer <Andries.Brouwer@cwi.nl>
1376 Baurzhan Ismagulov <ibr@radix50.net>
1377 Bernhard R. Link <brlink@debian.org>
1378 Bodo Stroesser <bstroesser@fujitsu-siemens.com>
1379 David N. Welton <davidw@eidetix.com>
1380 Dov Murik <dov@dv-networks.com>
1381 Heikki Orsila <shd@modeemi.cs.tut.fi>
1382 Hasso Tepper <hasso@estpak.ee>
1383 Hrvoje Niksic <hniksic@xemacs.org>
1384 Justin Pryzby <justinpryzby@users.sourceforge.net>
1385 Ludovic Courtes <ludovic.courtes@laas.fr>
1386 Mike Frysinger <vapier@gentoo.org>
1387 Nicolas Francois <nicolas.francois@centraliens.net>
1388 Norbert Buchmuller <norbi.spam@nix.hu>
1389 Paul Brook <paul@nowt.org>
1390 Ramiro Aceves <ea1abz@gmail.com>
1391 Tommy Pettersson <ptp@lysator.liu.se>
1392 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1394 Apologies if I missed anyone!
1399 RFC references are now always written as "RFC\ nnn" (not "RFC nnn" or
1402 Typographical or grammatical errors have been corrected in several
1406 Changes to individual pages
1407 ---------------------------
1411 To get an effect like "-h", BLOCKSIZE must start with "human",
1416 s/standard output/standard error/
1420 Fix small error in description of CLONE_PARENT_SETTID
1425 See http://lkml.org/lkml/2005/7/12/254
1429 Expanded discussion of relationship between user and kernel
1430 representations of the nice value.
1432 Added discussion of RLIMIT_NICE and a cross reference to
1433 getrlimit.2 under the description of the EACCES error.
1435 Noted 2.6.12 change in credentials checking for setpriority().
1439 Added description of RLIMIT_RTPRIO
1441 Added description of RLIMIT_NICE
1445 Noted bug in MAP_POPULATE for kernels before 2.6.7.
1449 Added _GNU_SOURCE to prototype.
1450 Rewrote description of MREMAP_MAYMOVE.
1451 Rewrote description of EAGAIN error.
1452 Added discussion of resizing of memory locks.
1453 Added entries to SEE ALSO.
1454 Some formatting fixes.
1458 Added IPC_INFO, MSG_INFO, MSG_STAT descriptions.
1462 Add to prototype: define _POSIX_C_SOURCE 199309
1463 As per Debian bug 314435
1467 Added sentence noting that range of the nice value is described
1469 Added cross-reference to setrlimit(2) for discussion on
1473 David N. Welton / Justin Pryzby / mtk
1474 Clarified the order of value and port arguments;
1475 As per Debian bug 263756
1479 Added SEE ALSO for sigsuspend.2
1480 Some formatting fixes.
1484 nfds should be prototyped as nfds_t
1485 As per Debian bug 322934
1488 Some wording and formatting improvements.
1492 Since kernel 2.6.13 PR_SET_DUMPABLE can also have the value 2.
1496 Remove misleading text describing FreeBSD's sranddev() function.
1497 As per debian bug 328629
1501 Added LINUX NOTES on trickery performed by glibc when
1502 vector size exceeds IOV_MAX.
1504 Formatting clean-ups.
1508 Added text to note that start and size are both rounded downwards.
1512 Modified discussion of privileges; added pointer to
1513 sched_setscheduler.2 for a discussion of privileges and
1516 sched_setscheduler.2
1518 Modified discussion of privileges; added discussion of RLIMIT_RTPRIO.
1522 Added IPC_INFO, SEM_INFO, SEM_STAT descriptions.
1526 Added IPC_INFO, SHM_INFO, SHM_STAT descriptions.
1530 Split sigpending(), sigprocmask(), and sigsuspend() out
1531 into separate new pages.
1536 NOTES: described SA_NODEFER / sa_mask bug which was present in
1537 all kernels up to and including 2.6.13.
1538 See http://marc.theaimsgroup.com/?l=linux-kernel&m=112360948603171&w=2
1539 and http://marc.theaimsgroup.com/?l=linux-kernel&m=112362164911432&w=2
1541 Subject: Signal handling possibly wrong
1542 From: Bodo Stroesser
1543 Date: 2005-08-09 17:44:06
1547 Updated SEE ALSO to reflect splitting of sigaction.2 into
1548 sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2
1552 New page created by splitting out from sigaction.2
1553 Changed CONFORMING TO.
1557 New page created by splitting out from sigaction.2
1558 Added text on effect of NULL for 'set' argument.
1559 Added text noting effect of ignoring SIGBUS, SIGFPE, SIGILL,
1561 Noted that sigprocmask() can't be used in multithreaded process.
1562 Fixed EINVAL error diagnostic.
1563 Changed CONFORMING TO.
1567 New page created by splitting out from sigaction.2
1568 Added NOTES on usage.
1569 Added new text to DESCRIPTION.
1570 Changed CONFORMING TO.
1574 Improve st_blocks description.
1579 One has carg(z) = atan(creal(z) / cimag(z))
1581 One has tan(carg(z)) = cimag(z) / creal(z)
1583 As per Debian bug 326720
1587 s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name)
1591 s/-nostartupfiles/-nostartfiles/
1595 Nowadays (since 2.3.4) glibc only sets the first ai_canonname
1596 field if AI_CANONNAME was specified (the current behavior
1597 is all that SUSv3 requires).
1601 Added descriptions of AI_ALL, AI_ADDRCONFIG, AI_V4MAPPED,
1604 Some wording and formatting fixes.
1607 Bernhard R. Link / mtk
1608 Add NOTES text describing relationship of pw_dir and HOME and
1609 pointing out that applications should preferentially
1614 Mention "little endian" and "big endian".
1615 Added note about octal and hex interpretation of
1616 numbers-and-dots notation.
1619 mtk / Ludovic Courtes
1620 Commented out references to rpc_secure(3) -- we don't currently
1621 have such a page in the man-pages set.
1622 In response to Debian bug report 325115
1626 glibc 2.3.4 fixed the "name contains '='" bug
1630 Added "#define _GNU_SOURCE" to prototype.
1633 Norbert Buchmuller / mtk
1634 Added text noting that the use or real-root-dev for changing
1635 the root device is obsolete, in favor of pivot root.
1636 (However, the page still needs to be rewritten to actually
1637 describe the pivot_root method...)
1638 As per Debian bug 323621.
1642 Improve text describing /proc/sys/fs/mqueue/* files
1644 Describe /proc/sys/fs/suid_dumpable (new in 2.6.13)
1646 Added placeholder mention of /proc/zoneinfo (new in 2.6.13)
1647 More needs to be said about this file
1649 Repaired earlier cut and paste mistake which resulted
1650 in part of the text of this page being duplicated.
1654 Added text on biarch details for ut_session and ut_tv.
1658 Added CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE.
1661 mtk / Andrew Pimlott
1662 Add a couple of words to make it clear that port is a 16-bit number.
1663 Reformat long source lines (no text changed).
1665 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1668 Fix discussion of IPC_RECVTTL / IP_TTL
1672 Updated SEE ALSO to reflect splitting of sigaction.2 into
1673 sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2
1677 Clarified details of use of SO_PEERCRED.
1681 s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name)
1682 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1686 Added description of UDP_CORK socket option
1688 s/SOL_UDP/IPPROTO_UDP/ (POSIX standard name)
1689 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1692 ==================== Changes in man-pages-2.09 ====================
1694 Released: 2005-10-13
1699 The following people contributed notes, ideas, or patches that have
1700 been incorporated in changes in this release:
1702 Justin Pryzby <pryzbyj@justinpryzby.com>
1703 Peter Chubb <peterc@gelato.unsw.edu.au>
1704 Samuel Thibault <samuel.thibault@ens-lyon.org>
1705 Tomas Pospisek <tpo_deb@sourcepole.ch>
1706 Trond Myklebust <trond.myklebust@fys.uio.no>
1708 Apologies if I missed anyone!
1722 Added SEE ALSO for new pty.7 page
1724 Typographical or grammatical errors have been corrected in several
1733 Overview of Unix 98 and BSD pseudo-terminals.
1736 Changes to individual pages
1737 ---------------------------
1741 Remove "-V" option (fix from Fedora man-pages-2.07-7).
1744 Peter Chubb / Trond Myklebust / mtk
1745 Since kernel 2.6.10, a read lease can only be placed on a
1746 file descriptor that is opened read-only.
1747 See the following LKML thread of Aug 2005
1748 ("fcntl(F GETLEASE) semantics??"):
1749 http://marc.theaimsgroup.com/?l=linux-kernel&m=112371777712197&w=2
1750 http://marc.theaimsgroup.com/?l=linux-kernel&m=112374818213000&w=2
1751 http://marc.theaimsgroup.com/?l=linux-kernel&m=112376335305284&w=2
1752 http://marc.theaimsgroup.com/?l=linux-kernel&m=112377294030092&w=2
1756 Add new text to ENOMEM error
1760 Added description of MREMAP_FIXED and 'new_address' argument
1762 Revised text of EINVAL error.
1765 Samuel Thibault / mtk
1766 read() can fail with EINVAL when using O_DIRECT
1768 Added open(2) to SEE ALSO
1772 s/int/size_t/ for type of 'size' argument (fix from
1773 Fedora man-pages-2.07-7).
1776 Samuel Thibault / mtk
1777 write() can fail with EINVAL when using O_DIRECT
1781 Fix: s/acosh/atanh/ (fix from Fedora man-pages-2.07-7)
1785 Improved "a+" description (fix from Fedora man-pages-2.07-7).
1789 s/getrpcent/setrpcent/ (fix from Fedora man-pages-2.07-7).
1793 Removed references to fropen() and fwopen(), which are
1794 BSDisms that don't appear in glibc.
1795 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=331174
1799 Typo fix: %Ry ==> %Ey [SUSv3 mentions...] (fix from
1800 Fedora man-pages-2.07-7).
1804 s/network/networks/ (fix from Fedora man-pages-2.07-7).
1808 Added description of /proc/sys/vm/legacy_va_layout.
1812 Update description of SO_RCVLOWAT and SO_SNDLOWAT.
1813 (fix derived from Fedora man-pages-2.07-7).
1816 ==================== Changes in man-pages-2.10 ====================
1818 Released: 2005-10-19
1823 The changes in this release consist *solely* of formatting fixes, with
1824 the aim bringing greater consistency to the manual pages according to
1825 the following rules:
1827 -- Function name references should *always* be followed by
1828 parentheses, "()" (possibly containing a manual page section
1831 -- The parentheses following a function name should *not* be
1832 formatted. Thus, for example, instead of:
1840 Much of the change was automated using two scripts:
1841 add_parens_for_own_funcs.sh and unformat_parens.sh.
1842 For the (possible) benefit of downstream manual page maintainers and
1843 translators, I have placed these scripts in a new subdirectory 'scripts'.
1845 NOTE THE FOLLOWING POINTS WELL:
1847 -- These scripts provide a computer-assisted solution to the above
1848 two goals. However, they are not perfect, and their output should
1849 be scanned by a human. (To see what changes the two scripts
1850 *would* make, without making them, use the "-n" command line option.)
1852 -- The scripts do not fix all instances that violate the above rules:
1853 some manual fixes are required. Two further scripts are provided
1854 to help find remaining instances of function names without
1855 following "()": find_dots_no_parens.sh and find_slashes_no_parens.sh.
1857 The following changes were made:
1859 -- add_parens_for_own_funcs.sh was applied to the pages in Sections
1862 -- unformat_parens.sh was applied to pages in Sections 2, 3, 4, and 7
1863 (the only sections where such changes were required).
1865 -- further changes (not so very many) were performed by hand.
1866 (found places to fix with the assistance of find_dots_no_parens.sh
1867 and find_slashes_no_parens.sh).
1870 ==================== Changes in man-pages-2.11 ====================
1872 Released: 2005-10-24
1877 The following people contributed notes, ideas, or patches that have
1878 been incorporated in changes in this release:
1880 Alain PORTAL <aportal@univ-montp2.fr>
1882 Apologies if I missed anyone!
1887 Most instances of the constant "NULL" are not formatted (bolded) in
1888 man pages, but a few are. For consistency, formatting on "NULL" has
1889 been removed where it occurred.
1891 Many minor formatting fixes were made.
1893 Typographical or grammatical errors have been corrected in several
1897 Changes to individual pages
1898 ---------------------------
1902 Added EINVAL error for rlim_cur > rlim_max when calling setrlimit().
1906 Repaired discussion of capabilities and file system UID, which
1907 mistakenly had involved exec() in the discussion.
1911 Removed text saying there is no library interface. There
1916 Minor change to RETURN VALUE text.
1927 ==================== Changes in man-pages-2.12 ====================
1929 Released: 2005-10-31
1934 The following people contributed notes, ideas, or patches that have
1935 been incorporated in changes in this release:
1937 Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
1938 Andries Brouwer <Andries.Brouwer@cwi.nl>
1939 Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
1940 herbert <herbert@gondor.apana.org.au>
1941 Martin Landers <martin.landers@treibgut.net>
1942 Michael Benedict <benedict@starbak.net>
1944 Apologies if I missed anyone!
1949 Typographical or grammatical errors have been corrected in several
1953 Changes to individual pages
1954 ---------------------------
1958 Reworded text around PAGESIZE, noting also that
1959 sysconf(_SC_PAGESIZE) can be used.
1963 Removed words "as well" (added in 2.11) from the phrase
1964 "and it gets these last five capabilities if its fsuid is 0 as well"
1965 since there are (unusual) situations in which fsuid can be 0 while
1966 the effective UID is not.
1968 Reworked (cut down) discussion of capabilities, moving part of
1969 it into capabilities.7
1973 Add text to note that setresuid() always modifies the file
1974 system UID, and setresgid() likewise always modifies the file
1979 Added (brief) description of SHM_HUGETLB.
1982 mtk / Martin Landers
1983 Noted that ss_sp is automatically aligned by the kernel.
1986 Brian M. Carlson / herbert
1987 Change <netinet/in.h> to <arpa/inet.h> in prototype; add text
1988 explaining that some systems need the former header.
1989 As per Debian bug 265244
1993 Reworked part of the discussion of exec() and capabilities.
1994 Added sub-section "Effect of User ID Changes on Capabilities".
1995 Reworked discussion of CAP_SYS_ADMIN and file-max.
1998 ==================== Changes in man-pages-2.13 ====================
2000 Released: 2005-11-03
2002 This release consists entirely of formatting and typographical fixes.
2007 Typographical or grammatical errors have been corrected in several
2010 Function and page cross references that were italicized were made bold
2011 (which is how the majority of function and page cross references
2014 Instances of things like "NULL-terminated string" were changed to
2015 "null-terminated string".
2017 Pathnames, structures, arguments, and <header-files> that were bold
2018 were changed to italics.
2020 Instances of the constant "NULL" that were bold-faced were made
2021 unformatted (which is how most instances of "NULL" were already
2025 ==================== Changes in man-pages-2.14 ====================
2027 Released: 2005-11-17
2032 The following people contributed notes, ideas, or patches that have
2033 been incorporated in changes in this release:
2035 Angelo <ang3l0@katamail.com>
2036 Avery Pennarun <apenwarr@nit.ca>
2037 Justin Pryzby <justinpryzby@users.sourceforge.net>
2038 Martin (Joey) Schulze <joey@infodrom.org>
2039 Stefan Brüns <stefan.bruens@rwth-aachen.de>
2040 Volker Reichelt <reichelt@igpm.rwth-aachen.de>
2042 Apologies if I missed anyone!
2047 Typographical or grammatical errors have been corrected in several
2055 This page is taken as is from the FreeBSD 5.4 distribution.
2056 (Not checked against Linux reality, but likely things are
2058 See also Debian bug 336875.
2060 Changes to individual pages
2061 ---------------------------
2065 Updated discussion about lack of prototype in glibc.
2069 Improved description of E2BIG error: it relates to the sum
2070 of the bytes in both environment and argument list.
2074 Clarified parts of the discussion of file leases,
2075 noting effect of open(O_NONBLOCK), interruption
2076 by signal handler, or termination by signal in
2078 In response to Debian bug 339037.
2082 Added LINUX NOTES describing nanosecond timestamps.
2085 Volker Reichelt / mtk
2086 Fixed to point out that that frexp() returns a number whose
2087 *absolute* value is >= 0.5 and < 1. Amended the example
2088 program to demonstrate this.
2091 mtk / Avery Pennarun
2092 Add EWOULDBLOCK error for file leases.
2093 In response to Debian bug 339037.
2097 Although the glibc implementation returns -1 on error (and some
2098 other man pages (e.g., the BSDs) also document that value for
2099 error returns), SUSv3 merely says "non-zero" (and this is
2100 what manual pages on many implementations also say).
2104 Formerly, the page said that all systems declare memalign() in
2105 <malloc.h>. In fact, many declare it in <stdlib.h>.
2109 Almost a complete rewrite after Angelo pointed out
2110 that the existing page was deficient.
2114 Remove SEE ALSO for non-existent scsi.4.
2118 Updated discussion of /proc/sys/kernel/pid_max.
2122 Added pthreads.7 to SEE ALSO.
2126 Fix typo: s/LD_DEBUG_OUTPUT/LD_PROFILE_OUTPUT/
2129 ==================== Changes in man-pages-2.15 ====================
2131 Released: 2005-11-30
2136 The following people contributed notes, ideas, or patches that have
2137 been incorporated in changes in this release:
2139 Andries Brouwer <Andries.Brouwer@cwi.nl>
2140 James Vega <jamessan@debian.org>
2141 Malcolm Scott <mas90@io.malc.org.uk>
2142 Senthil Kumar <senthilkumar_sen@hotpop.com>
2144 Apologies if I missed anyone!
2149 Typographical or grammatical errors have been corrected in several
2155 sigvec.3 -- for details, see below.
2157 sigset.3 -- for details, see below.
2159 Changes to individual pages
2160 ---------------------------
2164 Added text describing the 2.6.[0-7] EPERM bug that occurred
2165 when sending signals to a process group.
2169 Noted that si_signo is unused on Linux.
2173 Added BUGS noting wrapper function problem that existed
2174 in glibc versions <= 2.2.1.
2178 Moved to section 3; see also sigpause.3 below.
2182 Added a GLIBC NOTES section describing sigisemptyset(),
2183 sigandset(), and sigorset().
2188 These pages have been deleted, and replaced by a new sigvec.3
2189 man page that more fully describes the BSD signal API.
2195 These links to the now-deleted sigblock.2 have been also been
2196 deleted. They are replaced by corresponding links in Section 3:
2197 sigmask.3, sigsetmask.3, siggetmask.3.
2201 This new page is provides a fuller description of the
2202 BSD signal API than was provided in the now-deleted sigvec.2
2210 Created as links to sigvec.3.
2214 Moved here from Section 2.
2216 Some minor wording fixes; clarified System V origins of
2217 X/Open flavor of this function.
2221 New page describing the System V signal API: sigset(), sighold(),
2222 sigrelse(), sigignore().
2226 Add further text clarifying that %+ specifier is not supported in
2229 Added GLIBC NOTES section describing optional 'flag' and 'width'
2230 components of conversion specifiers.
2231 Some wording changes to bring terminology closer to SUSv3.
2232 Added an example program.
2236 Add as new linik to vm86.2.
2240 Added a few words to reflect the fact that several of the section
2241 7 pages provide overviews of various topics.
2245 Added some SEE ALSO entries.
2249 Added text noting that select()/poll() do not respect SO_RCVLOWAT.
2253 s/tcp_socket/udp_socket/ in example
2254 Fixes Debian bug 340927
2257 ==================== Changes in man-pages-2.16 ====================
2259 Released: 2005-12-02
2264 The following people contributed notes, ideas, or patches that have
2265 been incorporated in changes in this release:
2267 Alan Stern <stern@rowland.harvard.edu>
2268 Andries Brouwer <Andries.Brouwer@cwi.nl>
2269 Urs Thuermann <urs@isnogud.escape.de>
2271 Apologies if I missed anyone!
2276 Typographical or grammatical errors have been corrected in several
2280 Changes to individual pages
2281 ---------------------------
2285 Added instructions for finding maintainer in Debian package.
2289 Added NOTES about INFTIM constant provided on some other
2294 The -1 error return of shmat() should be cast "(void *)".
2298 Remove junk text (actually intended as source code comment
2303 Fix a typo: s/SOCK_RAW/SOCK_PACKET/
2307 Clarification: s%SOCK_PACKET%PF_INET/SOCK_PACKET%
2310 ==================== Changes in man-pages-2.17 ====================
2312 Released: 2005-12-13
2317 The following people contributed notes, ideas, or patches that have
2318 been incorporated in changes in this release:
2320 Justin Pryzby <justinpryzby@users.sourceforge.net>
2321 Michael Haardt <michael@moria.de>
2322 Urs Thuermann <urs@isnogud.escape.de>
2323 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2325 Apologies if I missed anyone!
2331 Typographical or grammatical errors have been corrected in several
2340 New documentation for the glibc-specific fmemopen() and
2341 open_memstream(). Based on glibc info page.
2344 mtk (with prompting and suggestions for improvements by
2346 New page providing overview of pipes and FIFOs.
2349 Changes to individual pages
2350 ---------------------------
2354 Added notes on how to write example programs for manual pages.
2358 Added pointers to examples of fork() in wait.2 and pipe.2.
2362 Added an example program.
2363 Added SEE ALSO for new pipe.7 page.
2367 Added example program demonstrating use of fork() and waitpid().
2371 Delete line that should have been deleted when applying
2372 2.08 fix for this page.
2376 Rearranged EAI_* list alphabetically.
2380 Added GLIBC NOTES describing feature test macros required
2381 to expose declaration of inet_aton().
2385 New link to new fmemopen.3
2389 Added SEE ALSO for new pipe.7 page.
2393 Removed BROWSER, since it seems not in fact to be common.
2397 Added documentation of SO_TIMESTAMP.
2401 Noted 200 millisecond ceiling imposed on TCP_CORK.
2405 Rearranged options into something approximating alphabetical order.
2408 ==================== Changes in man-pages-2.18 ====================
2410 Released: 2005-12-15
2415 The following people contributed notes, ideas, or patches that have
2416 been incorporated in changes in this release:
2418 Justin Pryzby <justinpryzby@users.sf.net>
2419 Karsten Sperling <karsten.sperling@stud.uni-karlsruhe.de>
2420 Martin (Joey) Schulze <joey@infodrom.org>
2421 Mike Frysinger <vapier@gentoo.org>
2422 Stefan Puiu <stefanpuiuro@yahoo.com>
2424 Apologies if I missed anyone!
2430 Typographical or grammatical errors have been corrected in several
2434 Changes to individual pages
2435 ---------------------------
2439 Added mention of AF_INET6 address family.
2440 Added discussion of sockaddr structure and an example in the
2445 Put 'flags' list in alphabetical order.
2449 Added cross-reference from discussion of MSG_MORE to UDP_CORK
2452 Put 'flags' list in alphabetical order.
2456 Added CONFORMING TO section noting that these are
2457 non-standard BSDisms.
2461 Added SEE ALSO for err.3 (Debian bug 306867)
2464 Martin (Joey) Schulze / mtk
2465 Added references to nsswitch.conf(5); remove cross references
2466 to resolv+(8). (See also Debian Bug#308397.)
2470 Added SEE ALSO for err.3 (Debian bug 306867)
2473 mtk / Martin (Joey) Schulze
2474 Remove cross references to resolv+(8); add cross references to
2475 resolv.conf(5). (See also Debian Bug#214892)
2477 Added SEE ALSO entry for resolver(5) (See Debian Bug#251122.)
2481 Rewrote and extended the discussion of the two flavors of
2482 strerror_r(), and added some additional information on
2485 Added SEE ALSO for err.3 (Debian bug 306867)
2490 Fix three typos in identifier names.
2494 The + operator should be in the list of unary operators.
2498 Small wording changes around discussion of SO_BSDCOMPAT.
2499 Fixed a couple of wording errors elsewhere.
2500 Reformatted some long lines.
2503 mtk, after a note by Stefan Puiu
2504 Updated discussion of SO_BSDCOMPAT.
2506 Reformatted some long lines.
2508 Noted the Linux-specific feature whereby setsockopt() doubles
2509 the value given for SO_SNDBUF and SO_RCVBUF.
2511 Noted kernel-imposed minimum values for SO_SNDBUF and SO_RCVBUF.
2514 mtk, after a note by Stefan Puiu
2515 Updated discussion of SO_BSDCOMPAT.
2519 Added new (UN)SUPPORTED FEATURES section in which it is noted
2520 that Unix domain sockets do not support MSG_OOB or MSG_MORE.
2522 Noted details of SO_SNBUF and SO_RCVBUF support for
2523 Unix domain sockets.
2526 ==================== Changes in man-pages-2.19 ====================
2528 Released: 2005-12-23
2533 The following people contributed notes, ideas, or patches that have
2534 been incorporated in changes in this release:
2536 Andries Brouwer <Andries.Brouwer@cwi.nl>
2537 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2538 Stefan Puiu <stefanpuiuro@yahoo.com>
2540 Apologies if I missed anyone!
2546 Typographical or grammatical errors have been corrected in several
2550 Changes to individual pages
2551 ---------------------------
2559 Remove text under EINVAL error: "This may change in the future:
2560 see linux/unix/sock.c for details." This behavior has been
2561 unchanged for a long time, and seems unlikely to change.
2563 Add EADDRINUSE to errors.
2567 Add cmsg(3) to SEE ALSO.
2571 Added description of 'x' mode character (exclusive open).
2575 Some wording changes to description of pipes.
2578 ==================== Changes in man-pages-2.20 ====================
2580 Released: 2006-01-03
2585 Typographical or grammatical errors have been corrected in several
2589 Changes to individual pages
2590 ---------------------------
2594 Added some text to explain the usual scenario in which
2595 sigaltstack() is employed.
2599 Noted that this function is available since glibc 2.2.
2607 Noted that capability bounding set appeared with kernel 2.2.11.
2622 The only changes to these pages have been for formatting:
2623 -- Structure definitions were changed to K&R style
2624 -- Some long source lines were broken to fit into ~70
2626 No changes were made to the content of these pages (yet...).
2629 ==================== Changes in man-pages-2.21 ====================
2631 Released: 2006-01-16
2636 The following people contributed notes, ideas, or patches that have
2637 been incorporated in changes in this release:
2639 Andries Brouwer <Andries.Brouwer@cwi.nl>
2640 Falk Hueffner <falk@debian.org>
2641 Mike Frysinger <vapier@gentoo.org>
2642 Senthil Kumar <senthilkumar_sen@hotpop.com>
2643 Stefan Puiu <stefanpuiuro@yahoo.com>
2645 Apologies if I missed anyone!
2652 truncate.2 gethostname.2 lseek.2 listxattr.2 readlink.2
2653 sysfs.2 stat.2 ustat.2 uname.2 getdomainname.2
2654 argz_add.3 asprintf.3 confstr.3 bstring.3 bzero.3 dlopen.3 fwide.3
2655 gethostbyname.3 getline.3 getlogin.3 getnameinfo.3 getpass.3 hsearch.3
2656 perror.3 printf.3 readdir.3 scanf.3 stpcpy.3 strdup.3 strfmon.3
2657 strftime.3 string.3 strptime.3 sysconf.3 termios.3 ttyname.3
2658 dsp56k.4 tty_ioctl.4
2659 elf.5 proc.5 termcap.5
2662 Various pages use inconsistent terms for 'null byte' (which
2663 is the C99/SUSv3 term for the '\0' character).
2665 To rectify this the following changes were made in the above
2668 Replace 'zero byte' with 'null byte'.
2669 Replace 'null character' with 'null byte'.
2670 Replace 'nulls' with 'null bytes'.
2671 Replace 'NUL-terminated' by 'null-terminated'.
2672 Replace 'NUL' by 'null byte'.
2673 Replace 'terminating NUL' by 'terminating null byte'.
2674 Replace 'final NUL' by 'terminating null byte'.
2675 Replace 'NUL character' by 'null byte'.
2679 Replace "SysV"/"SYSV" by "System V".
2681 Typographical or grammatical errors have been corrected in several
2685 Changes to individual pages
2686 ---------------------------
2690 Noted bug that could wrongly cause EPERM in unprivileged
2691 capset() with 'pid' field == getpid().
2695 Noted that EPOLLONESHOT was added in 2.6.2.
2699 Added GLIBC NOTES describing operation of glibc's
2700 gethostname() wrapper function.
2703 mtk / Mike Frysinger
2704 Clarify relationship between mmap2(2) and mmap64(3)
2706 A few other small rewordings.
2714 Added BUG noting that O_ASYNC can't be enabled via
2715 open(): fcntl() must be used for this purpose.
2719 Relocate misplaced discussion of MSG_DONTWAIT.
2723 Rewrote discussion of dlopen() 'flag' argument;
2724 added descriptions of RTLD_NOLOAD, RTLD_DELETE,
2727 Noted use of atexit() to register a function that is
2728 automatically called when a library is unloaded.
2732 Rewrote substantial parts of the page, and relicensed under GPL.
2736 Add RETURN VALUE section.
2740 Noted historical use of <stdio.h> to declare getopt().
2744 Clarify how strcmp() should be used as the 'compar'
2745 function by providing an example.
2746 As per Debian bug 348072.
2750 Noted that /proc/mounts is pollable since kernel 2.6.15.
2752 Documented /proc/PID/task.
2754 Noted that the contents of /proc/PID/{cwd,exe,fd,root,task}
2755 are not available if the main thread has terminated.
2758 Add pointer to random(4) for description of files under
2759 /proc/sys/kernel/random.
2763 Small rewording of discussion of SO_BSDCOMPAT
2764 (add cross-ref to socket(7)).
2767 ==================== Changes in man-pages-2.22 ====================
2769 Released: 2006-02-02
2774 The following people contributed notes, ideas, or patches that have
2775 been incorporated in changes in this release:
2777 Alain Portal <aportal@univ-montp2.fr>
2778 Andre Noll <maan@systemlinux.org>
2779 Andries Brouwer <Andries.Brouwer@cwi.nl>
2780 Colin Tuckley <colin@tuckley.org>
2781 Stefan Puiu <stefanpuiuro@yahoo.com>
2782 Thomas Hood <jdthood@yahoo.co.uk>
2783 Thorsten Kukuk <kukuk@suse.de>
2784 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2790 Typographical or grammatical errors have been corrected in several
2793 Changes to individual pages
2794 ---------------------------
2798 Noted that portable applications should specify fd as -1
2799 when using MAP_ANONYMOUS.
2800 Some rewriting of description of MAP_ANONYMOUS.
2804 New link to sigreturn.2
2808 New link to sigsuspend.2
2812 Noted that waitid() does not set infop->si_uid field on
2813 most other implementations.
2817 Make clear that when calling getopt_long() and there are no
2818 short options, then 'optstring' should be "", not NULL.
2822 In glibc 2.0.92, openpty() was modified to preferably open
2823 Unix 98 ptys instead of BSD ptys.
2827 Small rewording under EXAMPLES
2832 s/string must begin/string may begin/
2836 Documented inotify files under /proc/sys/fs/inotify:
2837 max_queued_events, max_user_instances, and max_user_watches.
2840 ==================== Changes in man-pages-2.23 ====================
2842 Released: 2006-02-10
2847 The following people contributed notes, ideas, or patches that have
2848 been incorporated in changes in this release:
2850 Andi Kleen <ak@muc.de>
2851 Britton Leo Kerin <bkerin_rb@letterboxes.org>
2852 Dan Jacobson <jidanni@jidanni.org>
2853 Justin Pryzby <justinpryzby@users.sourceforge.net>
2854 Luc Van Oostenryck <lkml@looxix.net>
2855 Kurt Wall <kwall@kurtwerks.com>
2856 Martin (Joey) Schulze <joey@infodrom.org>
2857 Matthias Andree <matthias.andree@gmx.de>
2858 Robert Love <rlove@rlove.org>
2859 Samuel Thibault <samuel.thibault@ens-lyon.org>
2860 Urs Thuermann <urs@isnogud.escape.de>
2862 Apologies if I missed anyone!
2867 Typographical or grammatical errors have been corrected in several
2877 Robert Love, with some additions by mtk.
2878 New pages describing the inotify API.
2883 Andi Kleen, with additional work by mtk
2884 New pages describing the NUMA memory allocation policy API.
2885 Drawn from the set at ftp://ftp.suse.com/pub/people/ak/numa.
2888 Urs Thuermann, with additional work by mtk
2889 New page describing the real-time clock driver.
2893 Overview of the inotify API.
2895 Changes to individual pages
2896 ---------------------------
2900 On x86, clone() should not be called through vsyscall,
2901 but directly through "int $0x80".
2905 Small wording changes.
2907 Added cross-ref to inotify.7 under the description of dnotify.
2910 mtk / Britton Leo Kerin
2911 Small wording change under NOTES to clarify
2912 what happens when a process sends a signal to itself.
2913 See Debian bug 350236.
2916 mtk / Matthias Andree
2917 Added BUGS txt on interaction between MCL_FUTURE and
2919 See the following LKML thread:
2920 http://marc.theaimsgroup.com/?l=linux-kernel&m=113801392825023&w=2
2921 "Rationale for RLIMIT_MEMLOCK"
2924 mtk / Samuel Thibault
2925 Rewrote declaration of 'msgp' to be "void *" in response
2926 to Debian bug report 350884.
2927 Various other wording fixes.
2931 Clarify distinction between "file creation flags" and
2932 "file status flags".
2936 Add SEE ALSO for pread(2).
2937 As per Debian bug 351873.
2945 Added return types to prototypes for FD_SET(), FD_CLR(),
2946 FD_ZERO, and FD_ISSET().
2947 Other minor wording changes.
2951 Add SEE ALSO for pwrite(2).
2952 (Analogous with read.2 change above.)
2956 Add Linux specific errors to this page.
2960 Added cross-ref to locale.7 for 'struct lconv' defn.
2961 Other minor wording changes.
2962 Martin (Joey) Schulze
2963 Added SEE ALSO refs for nl_langinfo.3
2964 As per Debian bug 351831.
2968 Minor formatting & wording fixes.
2971 Martin (Joey) Schulze
2972 Added SEE ALSO refs for nl_langinfo.3
2973 As per Debian bug 351831.
2977 Migrated description of inotify files to the new inotify.7 page.
2981 Add text describing characters 001 to 037.
2982 See Debian bug 342173.
2986 Minor wording and formatting changes.
2989 ==================== Changes in man-pages-2.24 ====================
2991 Released: 2006-02-17
2996 The following people contributed notes, ideas, or patches that have
2997 been incorporated in changes in this release:
2999 Joerg Habenicht <habenich@planetserver.com>
3000 Luc Van Oostenryck <lkml@looxix.net>
3001 Mike Frysinger <vapier@gentoo.org>
3002 Samuel Thibault <samuel.thibault@ens-lyon.org>
3004 Apologies if I missed anyone!
3015 FSF / mtk (with assistance of Luc Van Oostenryck)
3016 man-pages finally gets pages for these system calls, several
3017 of which are obsolete in Linux 2.6.
3018 Took the old GPLed pages dated 1996 and made a number of
3019 clean-ups and minor additions.
3027 Change "file name" to "filename"
3028 Change "path name" to "pathname"
3043 mtk after a suggestion from Samuel Thibault
3044 Added SEE ALSO pointers to wide character equivalent functions
3045 See Debian bug 351996.
3047 Typographical or grammatical errors have been corrected in several
3051 Changes to individual pages
3052 ---------------------------
3056 Remove duplicate CLONE_STOPPED text.
3057 Commented out crufty text describing EINVAL error
3058 for the now obsolete CLONE_DETACHED flag.
3059 Under CLONE_SIGHAND, noted that 'flags' must also include
3060 CLONE_VM if CLONE_SIGHAND is specified.
3064 Under ERRORS: Separate out EAGAIN error for locking mmaped files.
3072 Documented the EAGAIN error for msgrcv().
3075 Mike Frysinger / mtk
3076 Expand explanation of FNM_PATHNAME.
3079 Joerg Habenicht / mtk
3080 Fix up discussion of EAGAIN/EACCESS errors.
3083 ==================== Changes in man-pages-2.25 ====================
3085 Released: 2006-03-02
3090 The following people contributed notes, ideas, or patches that have
3091 been incorporated in changes in this release:
3093 James Peach <jpeach@samba.org>
3094 Krzysztof Benedyczak <golbi@mat.uni.torun.pl>
3095 Marten von Gagern <Martin.vGagern@gmx.net>
3096 Michael Haardt <michael@moria.de>
3097 Michael Wronksi <michal.wronski@gmail.com>
3099 Apologies if I missed anyone!
3113 New pages describing POSIX message queue API.
3116 mtk, after a suggestion by James Peach
3117 New page describing posix_fallocate().
3121 New page giving overview of the POSIX message queue API.
3124 Changes to individual pages
3125 ---------------------------
3129 Add a case to the EINVAL error text.
3131 Various minor wording fixes
3132 Added SEE ALSO referring to new posix_fallocate.3.
3136 Added "#define _XOPEN_SOURCE 600" to prototype.
3137 Added SEE ALSO referring to new posix_fallocate.3.
3141 Migrated information on POSIX message queues to new mqueue.7 page.
3145 Fix thinko: s/assuming a non-blocking/assuming a blocking/
3148 ==================== Changes in man-pages-2.26 ====================
3150 Released: 2006-03-21
3155 The following people contributed notes, ideas, or patches that have
3156 been incorporated in changes in this release:
3158 Alain Portal <aportal@univ-montp2.fr>
3159 Andi Kleen <ak@muc.de>
3160 Andries Brouwer <Andries.Brouwer@cwi.nl>
3161 Christoph Lameter <clameter@engr.sgi.com>
3162 Hasso Tepper <hasso@estpak.ee>
3163 Justin Pryzby <justinpryzby@users.sourceforge.net>
3164 Martin (Joey) Schulze <joey@infodrom.org>
3165 Nicolas Francois <nicolas.francois@centraliens.net>
3166 Paul Brook <paul@nowt.org>
3167 Siward de Groot <siward@wanadoo.nl>
3168 Steve Beattie <sbeattie@suse.de>
3169 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
3171 Apologies if I missed anyone!
3188 mtk, aeb, Steve Beattie
3189 Added comment in SYNOPSIS to note that syscall(2) may be
3190 preferable over _syscallN (see intro(2)).
3192 Various minor formatting changes were done on a range of
3193 pages in Section 7. (No content was changed.)
3200 New page describing openat(2), added in kernel 2.6.16,
3201 and some notes on rationale for the at*(2) system calls.
3204 Andi Kleen, Christoph Lameter, mtk
3205 Added MPOL_MF_MOVE and MPOL_MF_MOVE_ALL descriptions,
3206 from numactl-0.9.2 man page.
3207 Plus a few other smaller fixes.
3211 New page describing fexecve(3).
3215 New page describing futimes(3).
3217 Changes to individual pages
3218 ---------------------------
3222 Added SEE ALSO pointing to new fexecve.3.
3225 mtk, aeb, Steve Beattie
3226 Added some notes on syscall(2) versus _syscall.
3232 Added SEE ALSO pointing to mq_overview.7.
3236 Added SEE ALSO pointing to new openat.2.
3238 Split out part of the RETURN VALUE text into separate
3241 Modified wording referring to raw(8) to
3242 indicate that this interface is deprecated.
3246 Added discussion of ppoll(2), which is new in 2.6.16.
3255 Added text to note that although POSIX says msg_controllen
3256 should be socklen_t, glibc actually uses size_t.
3257 See Debian bug 356502 and the associated glibc bug report.
3258 http://sourceware.org/bugzilla/show_bug.cgi?id=2448.
3260 Various formatting fixes.
3264 Updated to reflect the fact that pselect() has been implemented
3265 in the kernel in 2.6.16; various other minor wording changes.
3267 pselect() prototype needs "#define _XOPEN_SOURCE 600".
3271 Clean up description of EEXIST error.
3276 Added a little extra text to clarify EISDIR vs EPERM.
3280 Added new SEE ALSO entry pointing to new futimes.3 page.
3284 Added SEE ALSO pointing to new fexecve.3.
3288 New link to shm_open.3 (should have been made when page
3289 was originally written).
3293 Add needed "#define _XOPEN_SOURCE".
3297 Updated to remove a few function names that are now documented.
3301 Various changes to bring this page closer to
3302 current kernel versions.
3306 Noted that glibc 2.4 is required to get glibc support
3311 Some rewording and added a few words about System V
3316 Substantial updates to various parts of this page.
3322 Updated to reflect that the NPTL limitation that only the main
3323 thread could call setsid() and setpgid() was removed in 2.6.16.
3327 Removed text implying that only in kernel 2.2 does IP_HDRINCL
3328 prevent datagrams from being fragmented.
3332 Documented SO_SNDBUFFORCE and SO_RCVBUFFORCE socket options,
3335 Placed socket options in alphabetical order.
3338 ==================== Changes in man-pages-2.27 ====================
3340 Released: 2006-03-24
3345 The following people contributed notes, ideas, or patches that have
3346 been incorporated in changes in this release:
3348 Andries Brouwer <Andries.Brouwer@cwi.nl>
3349 Charles P. Wright <cwright@cs.sunysb.edu>
3350 Christoph Lameter <clameter@sgi.com>
3351 Chuck Ebbert <76306.1226@compuserve.com>
3352 Daniel Jacobowitz <dan@debian.org>
3353 Ingo Molnar <mingo@elet.hu>
3354 Heiko Carstens <heiko.carstens@de.ibm.com>
3355 Janak Desai <janak@us.ibm.com>
3356 Paolo (Blaisorblade) Giarrusso <blaisorblade@yahoo.it>
3357 Stefan Puiu <stefanpuiuro@yahoo.com>
3359 Apologies if I missed anyone!
3365 Various minor formatting changes were done on a range of
3366 pages in Section 7. (No content was changed.)
3373 mtk, with reference to documentation by Janak Desai
3374 New page describing unshare(2), added in kernel 2.6.16.
3377 Changes to individual pages
3378 ---------------------------
3384 Added SEE ALSO pointing to new unshare.2.
3388 MPOL_MF_MOVE_ALL requires CAP_SYS_NICE not CAP_SYS_RESOURCE.
3392 Clarified the description of MREMAP_FIXED and restructured
3393 the text to reflect the fact that this flag is exposed
3394 by glibc since version 2.4.
3397 Chuck Ebbert, with assistance from Daniel Jacobowitz,
3398 Paolo (Blaisorblade) Giarrusso, and Charles P. Wright;
3399 after a suggestion from Heiko Carstens.
3400 Document the following ptrace requests:
3401 PTRACE_SETOPTIONS (2.4.6)
3402 plus associated flags:
3403 PTRACE_O_TRACESYSGOOD (2.4.6)
3404 PTRACE_O_TRACEFORK (2.5.46)
3405 PTRACE_O_TRACEVFORK (2.5.46)
3406 PTRACE_O_TRACECLONE (2.5.46)
3407 PTRACE_O_TRACEEXEC (2.5.46)
3408 PTRACE_O_TRACEVFORKDONE (2.5.60)
3409 PTRACE_O_TRACEEXIT (2.5.60)
3410 PTRACE_SETSIGINFO (2.3.99-pre6)
3411 PTRACE_GETSIGINFO (2.3.99-pre6)
3412 PTRACE_GETEVENTMSG (2.5.46)
3413 PTRACE_SYSEMU (since Linux 2.6.14)
3414 PTRACE_SYSEMU_SINGLESTEP (since Linux 2.6.14)
3416 sched_get_priority_max.2
3417 sched_setscheduler.2
3420 Modified to document SCHED_BATCH policy, new in kernel 2.6.16.
3422 Text describing SCHED_BATCH was added to sched_setscheduler.2,
3423 and was drawn in part from Ingo Molnar's description in the
3424 mail message containing the patch that implemented this policy.
3426 Various other minor rewordings and formatting fixes.
3429 mtk, using text from Documentation/filesystems/proc.txt
3430 Document /proc/sys/vm/drop_caches, new in kernel 2.6.16.
3431 mtk, using information from ChangeLog-2.6.14.
3432 Document /proc/PID/smaps, new in kernel 2.6.14.
3436 Noted affect of CAP_SYS_NICE for mbind(MPOL_MF_MOVE_ALL).
3440 Kernel 2.6.16 eliminated buggy behavior with respect to
3441 the alternate signal stack.
3444 ==================== Changes in man-pages-2.28 ====================
3446 Released: 2006-03-31
3451 The following people contributed notes, ideas, or patches that have
3452 been incorporated in changes in this release:
3454 Aleksandr Blokhin <sass@altlinux.ru>
3455 Greg Johnson <gjohnson@lanl.gov>
3457 Apologies if I missed anyone!
3473 New pages describing the POSIX semaphores API.
3475 These pages supersede and provide a superset of the information
3476 in the glibc (3thr) "semaphores(3)" manual page.
3479 Changes to individual pages
3480 ---------------------------
3488 Wrapped long lines (no content changes).
3494 Add SEE ALSO pointing to the new sem_overview.7 page.
3498 Removed SEE ALSO reference to non-existent core(5).
3501 ==================== Changes in man-pages-2.29 ====================
3503 Released: 2006-04-06
3508 The following people contributed notes, ideas, or patches that have
3509 been incorporated in changes in this release:
3511 Michael Haardt <michael@moria.de>
3512 Roberto Jimenoca <robertojimenoca@terra.es>
3513 Stefan Puiu <stefanpuiuro@yahoo.com>
3515 Apologies if I missed anyone!
3527 Added SEE ALSO entry referring to new core.5 page.
3535 New page describing mkdirat(2), new in 2.6.16.
3539 New page describing mknodat(2), new in 2.6.16.
3543 New page describing core dump files.
3547 New page describing mkfifoat(3).
3550 Changes to individual pages
3551 ---------------------------
3556 Michael Haardt / mtk
3557 Document EINVAL error for 'len' argument < 0.
3561 Expanded discussion of mandatory locking.
3565 Added BUGS text on 2.6.x handling of RLIMIT_CPU limit
3566 of zero seconds. See
3567 http://marc.theaimsgroup.com/?l=linux-kernel&m=112256338703880&w=2
3571 Added SEE ALSO entry referring to new mkdirat.2.
3575 Added SEE ALSO entry referring to new mknodat.2.
3578 mtk / Roberto Jimenoca
3579 Clarified discussion of file types affected by O_NONBLOCK.
3580 See Debian bug 360243.
3584 Rewrote NOTES describing rationale for openat().
3585 Various other minor changes.
3589 Removed a misleading cross-ref to socket.2.
3593 Since 2.6.17-rc1, shmdt() gives the error EINVAL in a further
3594 circumstance: if shmaddr is not aligned on a page boundary.
3598 Remove text saying that specifying invalid flags "is likely
3599 to cause compatibility problems" since the kernel now
3600 (2.6.17-rc1) contains an explicit check for invalid bits
3601 with a consequent EINVAL error.
3605 Added SEE ALSO entry referring to new mkfifoat.3.
3609 Information on core_pattern and core_uses_pid has
3610 been migrated to the new core.5 page.
3614 Removed paragraph referring to obsolete ipchains / ipfw(4).
3618 Add SEE ALSO entry referring to pthreads.7.
3621 ==================== Changes in man-pages-2.30 ====================
3623 Released: 2006-04-17
3628 The following people contributed notes, ideas, or patches that have
3629 been incorporated in changes in this release:
3631 Andre Lehovich <andrel@yahoo.com>
3632 Andries Brouwer <Andries.Brouwer@cwi.nl>
3633 Karel Kulhavy <clock@twibright.com>
3634 Stefan Puiu <stefanpuiuro@yahoo.com>
3636 Apologies if I missed anyone!
3644 New page describing linkat(), new in kernel 2.6.16
3648 New page describing renameat(), new in kernel 2.6.16
3652 New page describing symlinkat(), new in kernel 2.6.16
3656 New page describing unlinkat(), new in kernel 2.6.16
3659 Changes to individual pages
3660 ---------------------------
3664 Added SEE ALSO entry pointing to new linkat.2 page.
3668 Added SEE ALSO entries pointing to new *at.2 pages.
3672 Added SEE ALSO entry pointing to new renameat.2 page.
3676 Added SEE ALSO entry pointing to new unlinkat.2 page.
3680 Added SEE ALSO entry pointing to new symlinkat.2 page.
3684 Added SEE ALSO entry pointing to new unlinkat.2 page.
3688 Document the feature test macros required to expose various flags.
3690 Clarify 'speed' argument for cfsetispeed() text.
3692 Note that LOBLK is not implemented on Linux.
3694 Clarify arguments for cfsetspeed().
3695 Various formatting changes.
3699 Add a sentence describing the purpose of full(4).
3703 Rework text describing circumstances in which
3704 core dump files are not produced.
3706 A core dump of a multithreaded process always includes the
3707 PID in the core filename.
3709 Eliminate some accidentally duplicated text.
3712 ==================== Changes in man-pages-2.31 ====================
3714 Released: 2006-05-02
3719 The following people contributed notes, ideas, or patches that have
3720 been incorporated in changes in this release:
3722 Joshua Kwan <joshk@triplehelix.org>
3723 Justin Pryzby <justinpryzby@users.sourceforge.net>
3724 Karel Kulhavy <clock@twibright.com>
3725 Mark Glines <mark@glines.org>
3726 Martin (Joey) Schulze <joey@infodrom.org>
3727 Nishanth Aravamudan <nacc@us.ibm.com>
3728 Reuben Thomas <rrt@sc3d.org>
3729 Ryan S. Arnold <rsa@us.ibm.com>
3730 Ulrich Drepper <drepper@redhat.com>
3732 Apologies if I missed anyone!
3738 The following pages have been relocated into section 7, since
3739 that is their more natural home. SEE ALSO references in various
3740 other pages have been adjusted.
3746 environ.5 (many pages outside man-pages actually *expect*
3747 'environ' to be in Section 7.)
3748 ipc.5 renamed to svipc.7
3750 ".so" link files have been created to link the old file locations to the
3751 new file locations. These links are added just to ensure that cross
3752 references from any other (non-man-pages) pages will remain valid;
3753 eventually these links will be removed.
3761 New page for fstatat(2), new in 2.6.16.
3765 New page for adjtime(3).
3769 New page describing error() and error_at_line()
3770 Fixes Debian bug 186307.
3772 program_invocation_name.3
3774 New page describing program_invocation_name and
3775 program_invocation_short_name variables.
3779 New page for sockatmark(3).
3783 New page describing feature test macros.
3787 New page giving an overview of "time" on Linux systems.
3801 Simplified wording around requirement for _BSD_SOURCE
3812 Added SEE ALSO referring to new time.7.
3819 Add SEE ALSO referring to new error.3.
3825 Added SEE ALSO entry referring to setlocale.3.
3828 Changes to individual pages
3829 ---------------------------
3833 Remove mention of SOCK_RDM from this page, since this socket
3834 type does not support accept()ing connections.
3838 Modified text referring to adjtime(); added SEE ALSO for new
3842 mtk, after a note by Karel Kulhavy
3843 Rewrote most of the DESCRIPTION, as well as some other parts
3844 the page, to clarify use and operation of, and rationale for,
3845 fsync(2) and fdatasync(2).
3849 Updated discussion of maximum timer value to reflect the fact
3850 that the default jiffy is now 4 milliseconds.
3852 Added text to note that current incorrect behavior of
3853 normalizing tv_usec >= 1000000 will be repaired in a future
3854 kernel; applications should be fixed now.
3858 Point out more explicitly that 'tz' argument should
3861 Various other minor edits and formatting fixes.
3865 Since kernel 2.6.16, MS_NOATIME and MS_NODIRATIME are settable
3866 on a per-mount basis.
3867 Detail exactly which mount flags can be changed on MS_REMOUNT.
3871 Clarify RETURN VALUE discussion.
3875 Add SEE ALSO reference pointing to new fstatat.2.
3877 program_invocation_short_name.3
3879 New link to new program_invocation_name.3.
3883 Added SEE ALSO for new sockatmark.3.
3886 Joshua Kwan / Martin (Joey) Schulze / mtk
3887 Correct wording of EBUSY case.
3889 Add ".." case to ENOTEMPTY error
3893 Note more clearly that fd_set arguments can be NULL.
3895 Improve opening paragraph describing purpose of select().
3897 Various other minor edits and formatting fixes.
3900 mtk / Nishanth Aravamudan
3901 Add text to noting that the initial values of semaphores
3902 in a new set are indeterminate.
3906 Add text noting that contents of newly created segment are zero
3911 Noted that all threads should block signal being waited for.
3914 Nishanth Aravamudan / mtk
3915 Added NOTE that st_size is always returned as zero for most
3918 Add SEE ALSO reference pointing to new fstatat.2.
3922 Remove bogus BUGS text.
3926 Various minor changes.
3930 Rewrote RETURN VALUE discussion.
3931 Updated CONFORMING TO.
3935 Martin (Joey) Schulze / mtk
3936 Fix errors in DESCRIPTION.
3940 The range of tm_sec is 0..60 (not 0..61).
3943 error_message_count.3
3945 error_print_progname.3
3947 New links to new error.3.
3950 mtk / Ryan S. Arnold
3951 Add text noting that explicitly controlling output buffering
3952 may be useful to catch errors on output operations on an
3957 Add SEE ALSO pointing to getline.3.
3958 See Debian bug 364772.
3963 Describe correct handling of errno in order to
3964 distinguish error from success after the call.
3966 Added EXAMPLE section which points to strtol.3 which provides
3967 an example of the use of the analogous strtol(3).
3971 Add an example program.
3973 Describe correct handling or errno in order to
3974 distinguish error from success after the call.
3978 DESCRIPTION does not need to say "temporary file name"
3979 just "temporary file", since the name is in any case
3980 unavailable to the user.
3981 See Debian bug 363518.
3984 Change /automatically deleted when the program terminates normally/
3985 to /automatically deleted when the program terminates/
3986 since deletion occurs on both normal and abnormal termination.
3990 Various wording improvements and clarifications.
3993 mtk / Ulrich Drepper
3994 Add text noting that a signal's disposition is process-wide,
3995 shared by all threads.
3997 Add text on changing signal dispositions.
3998 Add text on "signal mask and pending signals".
4003 Added SEE ALSO for new adjtime.3.
4007 Remove bogus duplicate line.
4010 ==================== Changes in man-pages-2.32 ====================
4012 Released: 2006-05-13
4017 The following people contributed notes, ideas, or patches that have
4018 been incorporated in changes in this release:
4020 Andries Brouwer <Andries.Brouwer@cwi.nl>
4021 Johannes Weiner <root@hnaz.ath.cx>
4022 Justin Pryzby <justinpryzby@users.sourceforge.net>
4023 Karel Kulhavy <clock@twibright.com>
4024 Paul Brook <paul@nowt.org>
4025 Pavel Heimlich <tropikhajma@seznam.cz>
4027 Apologies if I missed anyone!
4035 New page for faccessat(2), new in 2.6.16.
4039 New page for fchmodat(2), new in 2.6.16.
4043 New page for fchownat(2), new in 2.6.16.
4047 New page for futimesat(2), new in 2.6.16.
4050 Changes to individual pages
4051 ---------------------------
4055 Add SEE ALSO reference pointing to new faccessat.2 page.
4059 Reworded to reflect that capabilities are per-thread.
4063 Add SEE ALSO reference pointing to new fchmodat.2 page.
4067 Add SEE ALSO reference pointing to new fchownat.2 page.
4071 Updated discussion of MAP_NORESERVE since it is no longer
4072 restricted to MAP_PRIVATE mappings.
4073 Add reference to discussion of /proc/sys/vm/overcommit_memory
4078 Add SEE ALSO reference pointing to new faccessat.2, fchmodat.2,
4079 fchownat.2, futimesat.2 pages.
4083 Document SHM_NORESERVE flag, new in 2.6.15.
4087 Expand text noting that ftruncate()/truncate() may fail if
4088 asked to extend a file beyond its current length.
4093 Add SEE ALSO reference pointing to new futimesat.2 page.
4097 Document 'm' (mmap) flag.
4100 Document 'c' (notcancel) flag.
4104 Add SEE ALSO reference pointing to new futimesat.2 page.
4108 Add missing "const" qualifies to cast in EXAMPLE.
4110 Slight rewording of comments in EXAMPLE.
4114 Clarify meaning of IXANY.
4115 Clarify relationship of MIN with VMIN and TIME with VTIME.
4117 Noted that CIBAUD, OFDEL, and DELECHO are not implemented
4119 Added explanatory paragraph for phrases "not in POSIX" and
4124 Reworded to reflect that capabilities are per-thread.
4125 Add ioprio_set() to list of operations permitted by
4127 Add ioprio_set() IOPRIO_CLASS_RT and IOPRIO_CLASS_IDLE
4128 scheduling classes to list of operations permitted by
4130 Note effects of CAP_SYS_NICE for migrate_pages().
4133 ==================== Changes in man-pages-2.33 ====================
4135 Released: 2006-05-23
4140 The following people contributed notes, ideas, or patches that have
4141 been incorporated in changes in this release:
4143 Andries Brouwer <Andries.Brouwer@cwi.nl>
4144 Justin Pryzby <justinpryzby@users.sourceforge.net>
4145 Martin Osvald" <martin.osvald@gmail.com>
4146 Stefan Puiu <stefanpuiuro@yahoo.com>
4148 Apologies if I missed anyone!
4154 ftm.7 renamed to the more suggestive feature_test_macros.7
4163 New page briefly describing mq_getsetattr(2), the system
4164 call that underlies mq_setattr(3) and mq_getattr(3).
4168 New page for rpmatch(3).
4171 Changes to individual pages
4172 ---------------------------
4176 Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
4177 POSIX does now document ELOOP.
4181 Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
4185 Add mincore(2) to SEE ALSO.
4186 See Debian bug 367401.
4190 Note that EINVAL can also be caused by
4191 flags == MS_SYNC | MS_ASYNC.
4195 Add CPU_ISSET, CPU_CLR, CPU_SET, CPU_ZERO to NAME section.
4199 Various minor changes.
4203 Removed much material that is redundant with select.2.
4204 Various other changes.
4208 Substantial rewrite of description of 'mask'.
4215 New links to sched_setaffinity.2
4222 New links to select.2.
4226 Add SEE also referring to ftw.3.
4230 Add SEE also referring to fts.3.
4234 Various minor clarifications.
4238 Clarify that O_EXCL is an open(2) flag.
4242 Fix prototype declaration for 'attr'.
4246 s/sigev_signal/sigev_signo/
4250 New link to mq_getattr.3.
4254 New link to mq_receive.3.
4258 New link to mq_send.3.
4262 Added SEE ALSO referring to rpmatch.3.
4268 New links to sigsetops.3.
4272 Added SEE ALSO referring to unlocked_stdio.3
4273 See Debian bug 367667.
4277 Add description of strchrnul().
4281 New link to strchr.3.
4285 Updated to remove some functions that don't exist, and
4286 therefore don't need to be documented.
4287 See Debian bug 367671.
4291 Added SEE ALSO referring to stdio.3
4292 See Debian bug 367667.
4296 Added section describing relationship between library
4297 interfaces and system calls.
4298 Added SEE ALSO referring to new mq_getsetattr.2.
4300 feature_test_macros.7
4302 Fix typo: s/_POSIX_C_SOURCE/_POSIX_SOURCE/
4305 ==================== Changes in man-pages-2.34 ====================
4307 Released: 2006-06-20
4312 The following people contributed notes, ideas, or patches that have
4313 been incorporated in changes in this release:
4315 Aristeu Sergio Rozanski Filho <aris@cathedrallabs.org>
4316 bert hubert <bert.hubert@netherlabs.nl>
4317 Chris Curtis <chris.curtis@riptidesoftware.com>
4318 Eduardo Madeira Fleury <efleury@br.ibm.com>
4319 Joerg Scheurich <rusmufti@helpdesk.bera.rus.uni-stuttgart.de>
4320 Justin Pryzby <justinpryzby@users.sf.net>
4321 Kenichi Okuyama <okuyama.kenichi@oss.ntt.co.jp>
4322 Marc Lehmann <debian-reportbug@plan9.de>
4323 Martin (Joey) Schulze <joey@infodrom.org>
4324 Mats Wichmann <mats.d.wichmann@intel.com>
4325 Mike Frysinger <vapier@gentoo.org>
4326 Peter Eiserloh <eiserlohpp@yahoo.com>
4327 Stefan Puiu <stefanpuiuro@yahoo.com>
4328 Thomas Dickey <dickey@radix.net>
4329 Walter Harms <wharms@bfs.de>
4331 Apologies if I missed anyone!
4341 Added header comment noting that these pages are in the public
4351 Added following to top of these pages to clarify origin and
4353 .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
4359 Eduardo Madeira Fleury, with edits by mtk, and review by Jens Axboe
4360 New page for ioprio_get(2) and ioprio_set(2), new in 2.6.13.
4364 New page describing offsetof() macro.
4367 Changes to individual pages
4368 ---------------------------
4372 Add SEE ALSO referring to exit_group.2.
4376 Add SEE ALSO referring to acct.5.
4380 Explicitly mention term "dnotify" in discussion of F_NOTIFY.
4383 Aristeu Sergio Rozanski Filho / mtk
4384 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4385 See Debian bug 369960.
4387 Renamed argument from 'path' to 'pathname'.
4388 Reword introductory paragraph to clarify that
4389 inotify_add_watch() may also modify an existing watch item.
4391 The EINVAL error can also occur if 'fd' is not an inotify
4394 Moved BUGS section from this page to inotify.7.
4397 Aristeu Sergio Rozanski Filho / mtk
4398 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4399 See Debian bug 369960.
4402 Aristeu Sergio Rozanski Filho / mtk
4403 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4404 See Debian bug 369960.
4406 The EINVAL error can also occur if 'fd' is not an inotify
4411 New link to new ioprio_set.2.
4415 Add SEE ALSO referring to remap_file_pages.2.
4419 s/MNT_FORCE/MNT_EXPIRE/ under EINVAL error.
4423 s/unsigned long flags/int flags/ in SYNOPSIS.
4427 Add SEE ALSO referring to popen.3.
4431 Add SEE ALSO referring to readahead.2.
4435 SEE ALSO for readv should refer to Section 2, not 3.
4439 Add SEE ALSO referring to posix_fadvise.2.
4443 Fix missing arguments in statement about equivalent send()
4448 Add SEE ALSO referring to tcgetsid.3.
4452 Minor wording change at start of DESCRIPTION.
4456 Add SEE ALSO referring to access.2.
4460 Relocated "Note" about f_fsid.
4464 SEE ALSO for writev should refer to Section 2, not 3.
4468 Added license statement (GPL) after consultation with
4473 Add #define _GNU_SOURCE to prototype
4477 Added note about time_t representation on other systems.
4478 Added CONFORMING TO.
4482 A fairly major revision...
4483 Document FTW_ACTIONRETVAL; include .SH "RETURN VALUE";
4484 Reorganized and rewrote much of the page
4485 Added an example program.
4489 Fixed typo in NOTES.
4494 Updated CONFORMING TO.
4498 Updated CONFORMING TO.
4502 Add documentation of %m.
4506 Added SEE ALSO referring to ftw.3.
4510 Note that these functions are obsolete in favor of regcomp(3).
4512 Add SEE ALSO referring to regcomp.3
4516 Reworded CONFORMING TO statement on scandir() and alphasort().
4520 Fix prototype for strchrnul().
4524 Add text clarifying treatment of strings starting with
4528 mtk, after comments by Justin Pryzby
4529 Add text noting the need to use open(O_EXCL).
4531 Clarify discussion of use of free(3).
4532 Various other minor changes to text and formatting.
4536 Updated CONFORMING TO.
4539 mtk, after comments by Justin Pryzby
4540 Add text noting the need to use open(O_EXCL).
4541 Updated CONFORMING TO.
4545 Remove offsetof(), which is now documented.
4549 Added SEE ALSO referring to full.4.
4553 Various improvements and corrections.
4557 Added CONFORMING TO section mentioning FreeBSD kqueue and
4560 feature_test_macros.7
4562 Added pointer to location of LFS specification.
4565 mtk, after suggestion by Joey.
4566 Added license statement to page, after discussion with
4567 original author, bert hubert.
4569 Reformat long lines; no content changes.
4573 'path' argument renamed to 'pathname'.
4574 A few minor rewordings.
4575 Added BUGS section describing a couple of bugs.
4579 Add SEE ALSO referring to byteorder.3.
4583 Add SEE ALSO referring to groff_man(7).
4587 ==================== Changes in man-pages-2.35 ====================
4589 Released: 2006-07-06
4594 The following people contributed notes, ideas, or patches that have
4595 been incorporated in changes in this release:
4597 Alain Portal <aportal@univ-montp2.fr>
4598 Andi Kleen <ak@suse.de>
4599 Andrew Morton <akpm@osdl.org>
4600 Bauke Jan Douma <bjdouma@xs4all.nl>
4601 Davide Libenzi <davidel@xmailserver.org>
4602 Denis Barbier <barbier@linuxfr.org>
4603 Horacio Rodriguez Montero <Horacio.Rodriguez.Montero@galinter.com.ar>
4604 Johan Lithander <johan.lithander@teligent.se>
4605 Justin Pryzby <justinpryzby@users.sourceforge.net>
4606 Mike Frysinger <vapier@gentoo.org>
4607 Stefan Puiu <stefanpuiuro@yahoo.com>
4608 Thorsten Kukuk <kukuk@suse.de>
4610 Apologies if I missed anyone!
4616 Typographical or grammatical errors have been corrected in several
4624 New page for sync_file_range(2), new in kernel 2.6.17.
4626 Changes to individual pages
4627 ---------------------------
4631 Noted BUG that occurs if 'delta' is specified as NULL.
4632 See http://bugzilla.kernel.org/show_bug.cgi?id=6761
4636 Add EADDRNOTAVAIL error.
4638 Make example code more complete.
4641 mtk / Davide Libenzi
4642 Added EPOLLRDHUP description.
4644 Added SEE ALSO referring to poll.2.
4647 mtk / Davide Libenzi
4648 Added POLLRDHUP description.
4650 The correct header file is <poll.h>, not <sys/poll.h>.
4651 Rewrote and reformatted various other parts.
4655 Nowadays, readlink() returns 'ssize_t', as required in
4660 Added license statement.
4664 Add documentation for various new fields.
4667 Horacio Rodriguez Montero
4668 Add explanation of 'x' character in 'password' field.
4670 The proper name of "*" is "asterisk" not "star".
4674 Update RFC reference for ECN.
4676 Add sentence on "low memory" limit for tcp_mem on 32-bit systems.
4679 ==================== Changes in man-pages-2.36 ====================
4681 Released: 2006-07-11
4686 The following people contributed notes, ideas, or patches that have
4687 been incorporated in changes in this release:
4689 Alain Portal <aportal@univ-montp2.fr>
4690 Jens Axboe <jans@suse.de>
4691 Justin Pryzby <justinpryzby@users.sourceforge.net>
4692 Kyle McMartin <kyle@mcmartin.ca>
4694 Apologies if I missed anyone!
4699 Typographical or grammatical errors have been corrected in several
4707 How to maintain man-pages.
4711 Things that it would be nice to get done for man-pages one day.
4713 scripts/FIXME_list.sh
4715 This script, intended for use by manual page maintainers,
4716 displays the FIXMEs in the manual page source files.
4718 Changes to individual pages
4719 ---------------------------
4724 Added SEE ALSO referring to sync_file_range.2.
4728 Fix description of 'offset' argument to explain the case
4729 where 'offset' is NULL.
4733 Add SEE ALSO referring to fdopen.3.
4737 Removed information about Section 3 subsections -- it doesn't
4738 reflect current reality, and probably never has.
4740 Added SEE ALSO referring to intro.2.
4744 Correction: tcp_window_scaling is ENabled by default.
4747 ==================== Changes in man-pages-2.37 ====================
4749 Released: 2006-08-02
4754 The following people contributed notes, ideas, or patches that have
4755 been incorporated in changes in this release:
4757 Alain Portal <aportal@univ-montp2.fr>
4758 Dean Gaudet <dean@arctic.org>
4759 Frank van Viegen <F.C.vanViegen@UTwente.nl>
4760 Helmut Grohne <helmut@subdivi.de>
4761 Ivana Varekova <varekova@redhat.com>
4762 Thomas Huriaux <thomas.huriaux@gmail.com>
4763 Ville Skyttä <ville.skytta@iki.fi>
4765 Apologies if I missed anyone!
4770 Thomas Huriaux / mtk
4772 Various formatting problems found as a result of reviewing the
4773 following command were fixed.
4775 for a in $(wc man?/*.?| awk '$1 > 2 ' | grep -v total); do
4776 echo $a; groff -Tascii -wmac -mman $a > /dev/null;
4779 See Debian Bug# 378544.
4781 Typographical or grammatical errors have been corrected in several
4788 mtk (after prompting from Ivana Varekova)
4789 New page for readlinkat(2), new in kernel 2.6.16.
4791 Changes to individual pages
4792 ---------------------------
4796 Document "-u" option.
4800 Noted effect of fork() and execve() on current working directory.
4804 Noted effect of fork() and execve() on root directory.
4807 Frank van Viegen / mtk
4808 Fix description of EBADF error.
4812 Add text noting that effective IDs are copied to
4813 saved set-IDs during execve().
4814 See Debian bug 379297.
4818 Noted effect of fork() and execve() on interval timers.
4822 Noted effect of fork() and execve() on resource limits.
4826 Noted effect of fork() and execve().
4830 Some rewording; included text describing required file
4835 Revised description of standards under CONFORMING TO.
4839 Point out that args following 'argc' are int.
4841 Added an example program.
4842 Various minor wording fixes.
4846 Expand description of MAP_POPULATE.
4847 mtk, after prompting by Dean Gaudet
4848 Expand description MAP_NONBLOCK.
4850 Various minor formatting fixes.
4854 Added SEE ALSO linking to readlinkat.2.
4858 Noted buggy behavior in Linux 2.4 and earlier when
4859 nanosleep() is restarted after receiving stop+SIGCONT signals.
4863 Very minor rewording.
4867 Added SEE ALSO linking to readlinkat.2.
4869 sched_setscheduler.2
4871 Noted preservation of scheduling parameters across execve().
4875 Noted effect of fork() and execve() on process group ID.
4879 Noted effect of fork() and execve() on session ID.
4883 Noted effect of fork() and execve() on umask.
4887 Noted inheritance of registrations across fork().
4891 Added material on privileges required for move_pages().
4892 CLONE_NEWNS needs CAP_SYS_ADMIN.
4893 keyctl(KEYCTL_CHOWN) and keyctl(KEYCTL_SETPERM) require
4897 ==================== Changes in man-pages-2.38 ====================
4899 Released: 2006-08-03
4904 The following people contributed notes, ideas, or patches that have
4905 been incorporated in changes in this release:
4907 Alain Portal <aportal@univ-montp2.fr>
4909 Apologies if I missed anyone!
4914 There was a major reworking of the CONFORMING TO sections
4915 in most manual pages.
4918 * generally try to rationalize the names used for standards.
4919 The preferred names are now documented as the head words
4920 of the list in standards(7). For the future: there is
4921 probably no need to talk about anything more than
4922 C89, C99, POSIX.1-2001 (or later), xBSD, and SVr4.
4923 (In particular, I've eliminated most references to XPG
4924 and SVID, replacing them with references to SUS or SVr4.)
4926 * eliminate discussion of errors that can occur on other
4927 systems. This information exists only patchily in the
4928 manual pages, is probably of limited use, is hard to maintain,
4929 and was in some cases simply wrong (and probably always was).
4931 * Tried to ensure that those interfaces specified in C99 or
4932 POSIX.1-2001 are marked as such in their manual pages.
4940 feature_test_macros.7
4942 Added SEE ALSO referring to new standards.7.
4944 Changed instances of "HP UX" to "HP-UX".
4947 Changed instances of "DG-UX to "DG/UX"
4950 Typographical or grammatical errors have been corrected in several
4958 Based on material taken from intro.2, but expanded to
4959 include discussion of many additional standards.
4961 Changes to individual pages
4962 ---------------------------
4966 Minor wording change for ENOTSOCK error.
4970 Removed information on standards to new standards.7.
4973 ==================== Changes in man-pages-2.39 ====================
4975 Released: 2006-08-05
4980 The following people contributed notes, ideas, or patches that have
4981 been incorporated in changes in this release:
4983 Alain Portal <aportal@univ-montp2.fr>
4985 Apologies if I missed anyone!
4990 Updated CONFORMING TO and/or standards references
4992 In various pages that were missed for 2.38.
4994 Typographical or grammatical errors have been corrected in several
4997 Changes to individual pages
4998 ---------------------------
5003 _XOPEN_SOURCE=500 also gets fchdir() prototype.
5007 Added a few more standards, and expand some explanations.
5010 ==================== Changes in man-pages-2.40 ====================
5012 Released: 2006-09-04
5017 The following people contributed notes, ideas, or patches that have
5018 been incorporated in changes in this release:
5020 Alain Portal <aportal@univ-montp2.fr>
5021 Andi Kleen <ak@suse.de>
5022 Andries Brouwer <Andries.Brouwer@cwi.nl>
5023 Christoph Hellwig <hch@lst.de>
5024 Chuck Ebbert <76306.1226@compuserve.com>
5025 Samuel Thibault <samuel.thibault@ens-lyon.org>
5026 Toralf Förster <toralf.foerster@gmx.de>
5028 Apologies if I missed anyone!
5045 mtk (after a note by Alain Portal)
5046 Make naming of 'pathname' argument consistent; various
5049 Typographical or grammatical errors have been corrected in several
5052 Changes to individual pages
5053 ---------------------------
5057 Reinstate text on CLONE_DETACHED, and add a few words.
5061 Added list of process attributes that are not preserved on exec().
5064 mtk, after a suggestion by Christoph Hellwig
5065 Greatly expanded, to describe all attributes that differ
5066 in parent and child.
5070 Document AT_SYMLINK_FOLLOW (new in 2.6.18).
5074 Memory policy is preserved across execve().
5078 SEE ALSO for writev should refer to Section 2, not 3.
5079 (i.e., really make the change that was logged in 2.34)
5082 Samuel Thibault / mtk
5083 Fix SYNOPSIS and CONFORMING TO text for getwd() and
5085 See Debian bug: 381692
5089 Document /proc/PID/auxv.
5093 Restore text accidentally deleted in 2.39.
5097 Change references to "1003.2" to "POSIX.2".
5100 ==================== Changes in man-pages-2.41 ====================
5102 Released: 2006-10-12
5107 The following people contributed notes, ideas, or patches that have
5108 been incorporated in changes in this release:
5110 Andi Kleen <ak@suse.de>
5111 Andries Brouwer <Andries.Brouwer@cwi.nl>
5112 Andrew Morton <akpm@osdl.org>
5113 Britton Leo Kerin <bkerin_rb@letterboxes.org>
5114 Dan Jacobson <jidanni@jidanni.org>
5115 Guillem Jover <guillem@hadrons.org>
5116 Hrvoje Niksic <hniksic@xemacs.org>
5117 Jens Axboe <axboe@suse.de>
5118 Justin Pryzby <justinpryzby@users.sourceforge.net>
5119 Kevin Ryde <user42@zip.com.au>
5120 Marcel Holtmann <marcel@holtmann.org>
5121 Senthil Kumar <senthilkumar_sen@hotpop.com>
5122 Stefan Puiu <stefanpuiuro@yahoo.com>
5123 Stuart MacDonald <stuartm@connecttech.com>
5124 Trond Myklebust <trond.myklebust@fys.uio.no>
5126 Apologies if I missed anyone!
5132 Typographical or grammatical errors have been corrected in several
5142 Jens Axboe / Michael Kerrisk
5144 http://lwn.net/Articles/118760/
5145 http://lwn.net/Articles/178199/
5146 http://lwn.net/Articles/179492/
5147 http://kerneltrap.org/node/6505
5148 http://lwn.net/Articles/179434/
5150 Changes to individual pages
5151 ---------------------------
5155 Note glibc version where "ldd -u" appeared.
5159 The PR_SET_NAME setting is not preserved across an execve().
5163 Mappings marked with madvise(MADV_DONTFORK) are not inherited
5168 Noted that sysconf(_SC_OPEN_MAX) is preferred in portable
5173 Noted that sysconf(_SC_PAGE_SIZE) is preferred in portable
5175 _SC_PAGE_SIZE is available on most systems.
5179 Document MADV_REMOVE, new in 2.6.16.
5180 Document MADV_DONTFORK / MADV_DOFORK, new in 2.6.16.
5183 mtk / Trond Myklebust
5184 MNT_FORCE can cause data loss.
5188 Added note on Linux's old (pre-2.6.12) buggy treatment of
5191 Added some EINVAL errors.
5195 Remove superfluous "#include <unistd.h>" from SYNOPSIS.
5199 Added EBUSY error for case where MS_INVALIDATE is applied to
5204 Since 2.6.18, POSIX_FADV_NOREUSE is a no-op.
5207 Marcel Holtmann / mtk
5208 Since kernel 2.6.18, setting 2 for PR_SET_DUMPABLE is no longer
5211 Updated Linux versions where the options where introduced.
5212 Added PR_SET_TIMING, PR_GET_TIMING, PR_SET_NAME, PR_GET_NAME,
5213 PR_SET_UNALIGN, PR_GET_UNALIGN, PR_SET_FPEMU, PR_GET_FPEMU,
5214 PR_SET_FPEXC, PR_GET_FPEXC.
5216 Document PR_GET_ENDIAN and PR_SET_ENDIAN.
5220 Add "#define _GNU_SOURCE" to SYNOPSIS.
5224 Noted that sync_file_range() appeared in kernel 2.6.17.
5228 Noted interactions with fork handlers in multithreaded programs.
5232 Added feature test macros to SYNOPSIS.
5235 mtk / aeb / Kevin Ryde
5236 Fix broken text in description.
5237 See Debian bug 386214.
5241 Fix broken text in description.
5242 See Debian bug 386214.
5246 Fix return type in SYNOPSIS; should be "ssize_t" not "mqd_t".
5247 See Debian bug 387551.
5251 Fix wording referring to the use of strcmp() in 'compar'
5253 See Debian bug 391402.
5257 Added SEE ALSO referring to new splice.2 page.
5261 Documented IUTF8 (which was new in kernel 2.6.4).
5265 Added some TZ examples.
5266 See Debian bug 386087.
5270 Added delayacct_blkio_ticks (new in 2.6.18) to /proc/PID/statm.
5273 Stuart MacDonald / Andi Kleen
5274 Fix discussion for TCP error queue /IP_RECVERR on TCP.
5278 Noted effect of RLIMIT_STACK resource limit for NPTL.
5282 Place socket options in alphabetical order.
5285 ==================== Changes in man-pages-2.42 ====================
5287 Released: 2006-11-24
5292 The following people contributed notes, ideas, or patches that have
5293 been incorporated in changes in this release:
5295 Andrew Morton <akpm@osdl.org>
5296 Chuck Ebbert <76306.1226@compuserve.com>
5297 Doug Goldstein <cardoe@gentoo.org>
5298 Eduard Bloch <blade@debian.org>
5299 Evan Teran <eteran@alum.rit.edu>
5300 Pavel Heimlich <tropikhajma@seznam.cz>
5301 Petr Baudis <pasky@ucw.cz>
5302 Randy Dunlap <rdunlap@xenotime.net>
5303 Ulrich Drepper <drepper@redhat.com>
5305 Apologies if I missed anyone!
5311 Typographical or grammatical errors have been corrected in several
5315 Changes to individual pages
5316 ---------------------------
5320 Add text describing behavior of the Linux brk() system call
5321 and point out that the glibc brk() wrapper provides different
5324 Note that sbrk() is implemented as a library function in glibc
5325 that calls the brk() system call.
5329 FUTEX_FD is scheduled for removal in June 2007.
5333 Ulrich Drepper, with edits by mtk
5334 Add text describing Internationalized Domain Name
5339 Fix description of O_LARGEFILE to mention required feature test
5344 Since Linux 2.6.18, the PID of the new process is also available
5345 for PTRACE_EVENT_VFORKDONE.
5349 Fix header file required for vsyslog() in SYNOPSIS.
5357 Linux 2.4.21 added core_pattern (which was already in 2.6).
5358 Noted a few more reasons why a core dump file might not
5362 ==================== Changes in man-pages-2.43 ====================
5364 Released: 2006-11-29
5369 The following people contributed notes, ideas, or patches that have
5370 been incorporated in changes in this release:
5372 Andi Kleen <ak@suse.de>
5373 David Brownell <david-b@pacbell.net>
5374 Eduard Bloch <blade@debian.org>
5375 Egmont Koblinger <egmont@uhulinux.hu>
5376 Reuben Thomas <rrt@sc3d.org>
5378 Apologies if I missed anyone!
5384 Typographical or grammatical errors have been corrected in several
5388 Changes to individual pages
5389 ---------------------------
5393 Clarify discussion of privilege requirements.
5394 Added ENOMEM to ERRORS.
5398 Clarify description of O_LARGEFILE.
5402 Make description of MD5 output string less ambiguous.
5406 Add C99 to CONFORMING TO; see Debian bug 400634.
5411 Update the RTC man page to reflect the new RTC class framework:
5413 - Generalize ... it's not just for PC/AT style RTCs, and there
5414 may be more than one RTC per system.
5416 - Not all RTCs expose the same feature set as PC/AT ones; most
5417 of these ioctls will be rejected by some RTCs.
5419 - Be explicit about when {A,P}IE_{ON,OFF} calls are needed.
5421 - Describe the parameter to the get/set epoch request; correct
5422 the description of the get/set frequency parameter.
5424 - Document RTC_WKALM_{RD,SET}, which don't need AIE_{ON,OFF} and
5425 which support longer alarm periods.
5427 - Hey, not all system clock implementations count timer irqs any
5428 more now that the new RT-derived clock support is merging.
5432 s/fseek(3)/lseek(2)/ under /proc/PID/mem entry.
5434 feature_test_macros.7
5436 The LFS spec is now at http://opengroup.org/platform/lfs.html.
5441 Describe the correct default for UDP/RAW path MTU discovery.
5444 ==================== Changes in man-pages-2.44 ====================
5446 Released: 2007-04-04
5451 The following people contributed notes, ideas, or patches that have
5452 been incorporated in changes in this release:
5454 Andre Majorel <aym-naideb@teaser.fr>
5455 Benjamin Gilbert <bgilbert@cs.cmu.edu>
5456 Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
5457 Chuck Ebbert <76306.1226@compuserve.com>
5458 Ivana Varekova <varekova@redhat.com>
5459 Jakub Jelinek <jakub@redhat.com>
5460 John Ward <jward@idealcorp.com>
5461 Jorge Peixoto de Morais Neto <jorgepeixotomorais@gmail.com>
5462 Julien Blache <jblache@debian.org>
5463 Julien Cristau <jcristau@debian.org>
5464 Justin Pryzby <justinpryzby@users.sourceforge.net>
5465 Martín Ferrari <martin.ferrari@gmail.com>
5466 Mike Frysinger <vapier@gentoo.org>
5467 Nick Piggin <npiggin@suse.de>
5468 Nick Pollitt <npollitt@mvista.com>
5469 Nicolas François <nicolas.francois@centraliens.ne>
5470 Pádraig Brady <P@draigBrady.com>
5471 Premysl Hruby <dfenze@gmail.com>
5472 Reuben Thomas <rrt@sc3d.org>
5473 Samuel Thibault <samuel.thibault@ens-lyon.org>
5474 Serge E. Hallyn <serge@hallyn.com>
5475 Thomas Huriaux <thomas.huriaux@gmail.com>
5476 Timo Sirainen <tss@iki.fi>
5477 Val Henson <val_henson@linux.intel.com>
5479 Apologies if I missed anyone!
5486 mtk, after a bit of prodding by Reuben Thomas
5487 A brief discussion of the old System V termio interface,
5488 with pointers to pages that will contain the information
5489 that the reader probably wants.
5491 scripts/find_repeated_words.sh
5493 Find consecutive duplicate words in a man page, some of
5494 which may be grammar errors.
5501 Add "#define _ATFILE_SOURCE" to SYNOPSIS in following pages:
5518 Various references to "getty" were changed to "mingetty", since
5519 that is the manual page more likely to be found on current systems.
5521 mtk, after a suggestion by Reuben Thomas <rrt@sc3d.org>
5522 Updated various header pages to accurately reflect which functions
5523 are and are not part of C89. Also fixed/improved a few other
5524 CONFORMING TO entries.
5527 s/Unices/Unix systems/ on the 5 pages where it appears.
5530 Wrapped long source lines in the following files
5540 man3/getipnodebyname.3
5567 man4/console_ioctl.4
5574 Added a SEE ALSO reference for feature_test_macros(7) to all
5575 pages where a feature test macro appears in the SYNOPSIS.
5578 Added SEE ALSO entry pointing to time.7
5585 Fixed consecutive duplicate word typos on a number of pages.
5587 Typographical or grammatical errors have been corrected in several
5588 places. (Special thanks to Nicolas François!)
5591 Changes to individual pages
5592 ---------------------------
5596 Since 2.6.20, access() honors the MS_NOEXEC mount flag.
5597 Jorge Peixoto de Morais Neto / mtk
5598 Improve ENOENT description.
5602 Added some detail to the prototype.
5603 Added some notes on IA-64's clone2().
5607 Add text to note that EPOLLRDHUP appeared in kernel 2.6.17.
5611 Various fixes as per Debian bug 411177.
5612 * s/effective/real/ in description text.
5613 * added <fcntl.h> to synopsis.
5614 * various other changes.
5617 mtk / Fedora downstream patches; thanks to Ivana Varekova
5618 Added a few words to note that RLIMIT_NPROC is really a limit on
5626 Fedora downstream patches; thanks to Ivana Varekova
5627 s%linux/aio.h%libaio.h% in SYNOPSIS.
5628 Changed return type from "long" to "int".
5631 Samuel Thibault / mtk
5632 Fix EINVAL description.
5633 See Debian bug 411777.
5637 Kernel 2.6.21 fixes several earlier bugs in mincore().
5639 Remove words "of a file" -- mincore() is describing
5640 memory residence information, not properties of a file.
5642 Rewrote various parts to make the page clearer.
5646 Rewrote and reorganized various parts to be clearer.
5647 Taken from Fedora downstream patches; thanks to Ivana Varekova
5648 Removed text stating that mmap() never returns 0; that's
5653 Document MS_RELATIME, new in Linux 2.6.20.
5657 On Linux, the error returned when opening a large file on a
5658 32-bit system is actually EFBIG, not EOVERFLOW.
5662 Fix RETURN VALUE description: returns error number of failure.
5666 Various improvements to DESCRIPTION.
5667 See Debian bug 416012.
5671 If sops contains multiple operations, then these are performed
5672 in array order. All Unix systems that I know of do this,
5673 and some Linux applications depend on this behavior. SUSv3
5674 made no explicit statement here, but SUSv4 will explicitly
5675 require this behavior.
5676 Small rewording of explanation of "atomically".
5680 Fix incorrect argument name in DESCRIPTION.
5682 Small wording improvement.
5686 Add reference to ipv6.7 page.
5694 Fix inconsistent argument names in SYNOPSIS and DESCRIPTION.
5698 Small wording clarification.
5701 mtk / Nicolas François
5702 Removed cryptic text under CONFORMING to referring to
5703 "open(2) and NFS". There is no relevant text in open.2 as
5704 far as I (mtk) can see.
5708 Remove sentence "gettimeofday() obsoleting time() on 4.3BSD".
5709 This information is old, and probably no longer relevant.
5710 See Debian bug 403888.
5713 mtk, after an idea from a downstream Fedora patch.
5714 Clarified discussion of /count == 0/ case.
5718 When the parent receives an event with PTRACE_EVENT_* set,
5719 the child is not in the normal signal delivery path. This
5720 means the parent cannot do ptrace(PTRACE_CONT) with a signal
5721 or ptrace(PTRACE_KILL). kill() with a SIGKILL signal can be
5722 used instead to kill the child process after receiving one
5727 Fix glibc version number in description of 'cpusetsize' argument.
5731 Stripped some excess/outdated text from the BUGS section.
5734 mtk / Jorge Peixoto de Morais Neto
5735 Add text to clarify that the pointer returned by these
5736 functions may be into some part of 'path'.
5739 Taken from Fedora downstream patches; thanks to Ivana Varekova
5740 + Carlo Marcelo Arenas Belon
5741 Add "#include <stdlib.h>" to example program.
5745 Complete rewrite. The existing page was hard to read,
5746 and the RETURN VALUE description seems to be wrong.
5750 Added getopt() example program.
5752 Add a few words to clarify the operation of the GNU-specific
5753 double-colon feature, which allows options to have optional
5755 See Debian bug352139.
5762 mtk, after an idea from a downstream Fedora patch.
5763 Clarified description of inet_network().
5775 Small rewording to mention calloc().
5779 Fix return type in SYNOPSIS; as per Debian bug 400971.
5780 Needs _XOPEN_SOURCE == 600; as per Debian bug 400975.
5782 s/ptsname/posix_openpt/ in RETURN VALUE
5785 Taken from Fedora downstream patches; thanks to Ivana Varekova
5786 Add "#define _REGEX_RE_COMP" to SYNOPSIS.
5794 Added .SS headers to give some structure to this page; and a small
5795 amount of reordering.
5797 Added a section on canonical and non-canonical mode.
5799 Enhanced the discussion of "raw" mode for cfmakeraw().
5803 Make description of PARODD a little clearer.
5805 Add SEE ALSO link to tty_ioctl.4
5807 Add SEE ALSO link to console_ioctl.4
5811 Removed BSD prototype from synopsis.
5816 Removed BSD prototype from synopsis.
5820 Taken from Fedora downstream patches; thanks to Ivana Varekova
5821 s/curses/ncurses/ under SEE ALSO
5824 Taken from Fedora downstream patches; thanks to Ivana Varekova
5825 Documented "mem=nopentium".
5827 feature_test_macros.7
5829 The default treatment of _POSIX_C_SOURCE changed in glibc 2.4.
5830 mtk, after a suggestion by Justin Pryzby
5831 Added some text warning that the "__" macros that
5832 <features.h> defines internally should never be
5833 directly defined by programs.
5834 mtk, based on notes by Jakub Jelinek
5835 Document _FORTIFY_SOURCE
5836 (See http://gcc.gnu.org/ml/gcc-patches/2004-09/msg02055.html )
5838 Document _REENTRANT and _THREAD_SAFE.
5841 mtk / Nicolas François
5842 Remove CONFIGURATION section, since this does not seem to be
5847 Fix data types in associated data structures;
5848 remove non-existent semzcnt and semncnt fields.
5852 Since kernel 2.6.20, the software clock can also be 300 HZ.
5855 ==================== Changes in man-pages-2.45 ====================
5857 Released: 2007-04-05
5862 This release consists mainly of formatting fixes (to a large
5863 number of pages) to achieve greater consistency across pages.
5864 With the exception of the few individual changes noted below,
5865 no changes were made to content.
5867 Changes to individual pages
5868 ---------------------------
5876 Clarified RETURN VALUE text
5880 Rewrote prototype using modern C syntax.
5883 ==================== Changes in man-pages-2.46 ====================
5885 Released: 2007-04-06
5890 This release consists mainly of formatting fixes (to a large
5891 number of pages) to achieve greater consistency across pages:
5893 * Most instances of two or more consecutive blank lines in man
5894 page output were shrunk to a single line.
5895 * A number of example programs were reformatted
5896 to more closely match K&R style.
5897 * In various places (mainly code examples), the use of tabs was
5900 With the exception of the few individual changes noted below,
5901 no changes were made to content.
5904 Changes to individual pages
5905 ---------------------------
5909 Add <sys/kdaemon.h> header file to SYNOPSIS.
5911 sched_rr_get_interval.2
5913 Moved timespec definition from SYNOPSIS into description.
5917 Make SYNOPSIS match select.2.
5920 ==================== Changes in man-pages-2.47 ====================
5922 Released: 2007-05-04
5927 The following people contributed notes, ideas, or patches that have
5928 been incorporated in changes in this release:
5930 Andi Kleen <andi@firstfloor.org>
5931 John Heffner <jheffner@psc.edu>
5933 Apologies if I missed anyone!
5939 This release consists mainly of changes to source file layout
5940 (wrapped long lines; stripped trailing white space; started new
5941 sentences on new lines).
5943 There is very little change to output formatting or content (see the
5947 Changes to individual pages
5948 ---------------------------
5950 sched_rr_get_interval.2
5952 Remove crufty statement that this system call is not implemented.
5953 The nice interval can be used to control the size of
5954 the round-robin quantum.
5959 Document IP_PMTUDISC_PROBE, which will be in 2.6.22.
5962 ==================== Changes in man-pages-2.48 ====================
5964 Released: 2007-05-04
5969 The following people contributed notes, ideas, or patches that have
5970 been incorporated in changes in this release:
5972 Colin Watson <cjwatson@debian.org>
5973 Justin Pryzby <justinpryzby@users.sourceforge.net>
5975 Apologies if I missed anyone!
5981 This release consists mainly of changes to source file layout
5982 (wrapped long lines; stripped trailing white space; started new
5983 sentences on new lines).
5985 There is very little change to output formatting or content (see the
5989 In various places where it occurred,
5990 s/nonnegative/non-negative/
5993 s/wide character/wide-character/ when used attributively.
5996 Changes to individual pages
5997 ---------------------------
6000 Justin Pryzby / Colin Watson / mtk
6001 .SH doesn't require quotes.
6002 See Debian bug 411303.
6005 ==================== Changes in man-pages-2.49 ====================
6007 Released: 2007-05-20
6012 The following people contributed notes, ideas, or patches that have
6013 been incorporated in changes in this release:
6015 Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
6016 Bruno Haible <bruno@clisp.org>
6017 Justin Pryzby <justinpryzby@users.sourceforge.net>
6019 Apologies if I missed anyone!
6027 Documentation of bsd_signal().
6031 Manual page for euidaccess() and eaccess().
6035 Documentation of getsubopt().
6039 Documentation of sysv_signal().
6047 New link to epoll_wait.2.
6051 New link to new euidaccess.3,
6055 New link to sem_wait.3.
6059 New link to sem_wait.3.
6065 Typographical or grammatical errors have been corrected in several
6069 Changes to individual pages
6070 ---------------------------
6074 Added SEE ALSO ref to new euidaccess.3 page.
6078 Added description of epoll_pwait(), new in kernel 2.6.19.
6082 Add text noting that Linux allows 'argv' and 'envp' to be
6083 NULL, but warning that this is non-standard and non-portable,
6084 and should be avoided in portable programs.
6085 Bug filed (http://bugzilla.kernel.org/show_bug.cgi?id=8408)
6086 to get this changed, but maybe that won't be done because it
6089 Added an example program.
6091 Expanded the discussion of interpreter scripts and the
6092 'optional-arg' argument of an interpreter script.
6093 For further info, see
6094 http://homepages.cwi.nl/~aeb/std/hashexclam-1.html
6095 http://www.in-ulm.de/~mascheck/various/shebang/
6097 Added text noting that FD_CLOEXEC causes record locks to be
6100 Mention effect of MS_NOSUID mount(2) flag for set-user-ID
6103 Expanded description of handling of file descriptors during
6104 execve(), adding text to note that descriptors 0, 1, and 2
6105 may be treated specially.
6109 Added SEE ALSO ref to new euidaccess.3 page.
6113 Place MAP_* flags list in alphabetical order.
6117 A fairly substantial rewrite, which among other things
6118 fixes the problem reported by Kyle Sluder in
6119 http://bugzilla.kernel.org/show_bug.cgi?id=8399
6120 And added some example code.
6124 Added text referring to the discussion of async-signal-safe
6125 functions in signal(7).
6126 A few other minor formatting and wording changes.
6130 Moved the discussion of async-signal-safe functions to signal(7).
6131 Added text referring to the discussion of async-signal-safe
6132 functions in signal(7).
6133 Added SEE ALSO entries referring to new bsd_signal.3 and
6134 sysv_signal.3 pages.
6138 Clarify discussion of negative zero.
6142 Add SEE ALSO ref to new getsubopt.3.
6146 Describe the glibc/libiconv //TRANSLIT and //IGNORE extensions
6151 Update CONFORMING TO; iswblank() is in POSIX.1-2001.
6155 Definitions for IN_DONT_FOLLOW, IN_MASK_ADD, and IN_ONLYDIR
6156 were added to glibc in version 2.5.
6160 Incorporated (and slightly modified) the text on
6161 async-signal-safe functions that was formerly in signal(2).
6162 Added SEE ALSO entries referring to new bsd_signal.3 and
6163 sysv_signal.3 pages.
6166 ==================== Changes in man-pages-2.50 ====================
6168 Released: 2007-05-21
6173 The following people contributed notes, ideas, or patches that have
6174 been incorporated in changes in this release:
6176 Andreas Halter <halter@google.com>
6177 Laird Shaw <netocrat@dodo.com.au>
6178 Mike Frysinger <vapier@gentoo.org>
6180 Apologies if I missed anyone!
6185 Most Section 1 man pages are removed
6186 mtk (with help from Mike Frysinger, Laird Shaw, Andreas Halter)
6187 Once upon time Andries added a number of Section 1 manual pages
6188 to man-pages. However, since that time, those pages have not
6189 seen much maintenance, and are not in fact distributed in most
6190 distributions. Instead most distributions supply the
6191 coreutils versions of these pages, which are currently
6192 maintained. In addition, man-pages provides the 1p pages,
6193 which document the portable subset of functionality of these
6194 commands. Since the man1 pages are mostly unneeded, and
6195 out of date, I'm removing them. The following pages disappear:
6219 The following Section 1 pages will be kept:
6226 ==================== Changes in man-pages-2.51 ====================
6228 Released: 2007-05-28
6234 (Hopefully) all cross references outside a page now include a
6235 section number. This should permit better resulting output from a
6236 man2html-type conversion.
6239 Convert function formatting of the form "\fBname\fP()" to
6243 Changes to individual pages
6244 ---------------------------
6248 s/futimes/futimesat/ in .SH NAME line.
6252 Put "msgrcv" and "msgsnd" in .SH NAME line.
6256 Add "umount2" to .SH NAME line.
6260 Add "waitid" to .SH NAME line.
6264 Add "getopt_long" and "getopt_long_only" in .SH NAME line.
6268 Add "sem_timedwait" and "sem_trywait" to .SH NAME line.
6272 Add "va_start", "va_arg", "va_end", "va_copy" to .SH NAME line.
6275 ==================== Changes in man-pages-2.52 ====================
6277 Released: 2007-05-29
6279 "A foolish consistency is the hobgoblin of little minds, adored by
6280 little statesmen and philosophers and divines"
6282 Ralph Waldo Emerson (1803-1882)
6284 "But damn it, these man pages are a mess!"
6290 Most of the changes below are about bringing greater consistency
6291 to manual pages, including reducing the wide range of .SH
6294 Typographical or grammatical errors have been corrected in several
6299 Make 'manual' component of .TH line "Linux Programmer's Manual"
6300 Reason: consistency.
6304 Changed date in .TH line into form YYYY-DD-MM.
6305 Reason: consistency.
6309 Some .SH header lines were made into .SS lines. (One of the aims
6310 here is to reduce the number of non-standard .SH lines.)
6314 Change title .SH sections named "NOTE" to "NOTES", in some cases
6315 also changing the location of the section within the page.
6316 Reason: consistency.
6320 Commented out .SH AUTHOR sections; the right place for
6321 documentation authorship sections is usually comments at the
6322 top of the page source.
6326 Changed .SH HISTORY to .SH VERSIONS.
6327 Reason: in many cases, HISTORY was being used to describe
6328 Linux/glibc version information, as was already done for
6329 VERSIONS sections in other pages.
6333 Removed HISTORY section, or moved it as a subsection or paragraphs
6334 under another section e.g., NOTES.
6335 Reason: there are too many arbitrary section (.SH) names, and
6336 a HISTORY section never was consistently used across Linux
6341 Moved SEE ALSO section to be last section on the page
6342 Reason: consistency -- and this is where SEE ALSO should be!
6346 Relocated GLIBC NOTES as subsection under NOTES
6347 Reason: reduce number of arbitrary section (.SH) names.
6351 Relocated LINUX NOTES as subsection under NOTES
6352 Reason: reduce number of arbitrary section (.SH) names.
6356 Renamed some "AVAILABILITY" sections to "VERSIONS".
6357 Reason: consistency.
6361 Renamed some "DIAGNOSTICS" sections to "RETURN VALUE".
6362 Reason: consistency.
6367 s/\.SH ENVIRONMENT VARIABLES/.SH ENVIRONMENT/
6368 Reason: consistency.
6388 s/return 0/exit(EXIT_FAILURE)/ in main() of function example
6390 Reason: consistency.
6402 Use symbolic constants (EXIT_SUCCESS, EXIT_FAILURE) in calls
6404 Reason: consistency.
6413 Renamed RESTRICTIONS section to NOTES, or moved text in a
6414 RESTRICTIONS section under existing NOTES section.
6415 Reason: consistency, and reduce number of arbitrary section (.SH)
6419 Changes to individual pages
6420 ---------------------------
6424 s/\.SH FURTHER INFORMATION/.SH NOTES/
6428 s/\.SH WARNING/.SH NOTES/
6431 Renamed LINUX HISTORY section to LINUX NOTES, and relocated
6436 Relocated example program and made its .SH title "EXAMPLE".
6440 Move code example into its own EXAMPLE secton.
6444 s/\.SH WARNING/.SH NOTES/
6448 s/\.SH "LINUX-SPECIFIC REMARKS"/.SH LINUX NOTES/
6452 Remove section about effect of fork()/exec()/exit(); shmop.2
6453 contains the same text, and it only needs to be said once.
6457 Minor rewording under DESCRIPTION.
6461 Minor wording and formatting changes.
6465 Removed statement that glibc unconditionally exposes declarations
6466 of encrypt() and setkey(), since portable applications must
6467 use <unistd.h> and define _XOPEN_SOURCE to obtain the declarations
6468 of setkey() and encrypt(). Adjusted example program accordingly.
6476 Minor wording and formatting changes.
6480 Substantial rewrite, revising and extending the discussion
6481 about desired conventions for writing pages.
6482 There will be further updates to this page in the next few
6486 ==================== Changes in man-pages-2.53 ====================
6488 Released: 2007-05-30
6490 "A foolish consistency is the hobgoblin of little minds, adored by
6491 little statesmen and philosophers and divines"
6493 Ralph Waldo Emerson (1803-1882)
6495 "But damn it, these man pages are a mess!"
6503 Reordered sections to be more consistent, in some cases renaming
6504 sections or shifting paragraphs between sections.
6508 In various pages in this section, .SH headings were
6512 ==================== Changes in man-pages-2.54 ====================
6514 Released: 2007-06-07
6519 The following people contributed notes, ideas, or patches that have
6520 been incorporated in changes in this release:
6522 Emmanuel Mogenet <emogenet@google.com>
6523 Michael Berg <michaeljberg@gmail.com>
6525 Apologies if I missed anyone!
6533 Where there is an instruction in the SYNOPSIS about linking
6534 or compiling with a certain option, the option is now
6535 marked up in italics (e.g., "\fI-lm\fP").
6539 Added page numbers to page cross references.
6543 s/manpage/man page/, for consistency.
6545 Typographical or grammatical errors have been corrected in several
6554 A description of the conventions that should be followed
6555 when writing pages for the man-pages package.
6562 Already deleted most of the man1 pages previously, so
6563 this doesn't need to stay.
6567 Removed this page since it is out of date, and the proper place
6568 to go for up-to-date information is http://www.tldp.org/.
6572 Reason: this was the only Section 9 page, and it is old
6573 (Linux 2.4). The man9 section never took off as an idea, and
6574 I see little point in keeping a Section 9 with just a single
6578 Changes to individual pages
6579 ---------------------------
6583 Moved some material out of here into new man-pages.7.
6587 Minor rewrites, eliminating some duplication, and removing
6592 Fix broken link path; Debian bug 425570.
6596 Remove misleading text about setting O_ASYNC when calling
6597 open(); one must use fcntl() F_SETFL for this task.
6601 Converted outdated BUGS note about fdatasync() being
6602 equivalent to fsync() on Linux 2.2 into a NOTES note
6603 about this historical behavior.
6607 Small rewording to fix "fails with the error EWOULDBLOCK"
6608 rather than "returns EWOULDBLOCK".
6609 See Red Hat bug 172828.
6612 mtk, after an observation by Emmanuel Mogenet
6613 A much improved example program.
6615 Significant rewrites and additions to description.
6619 Remove text about the non-existent BSD mremap() -- too
6620 much information, in my opinion.
6624 Added ERRORS section.
6628 Moved text for "Versions and Library Support".
6632 Small rewording in RETURN VALUE section.
6636 Add EXAMPLE section with a pointer to example in mprotect.2.
6640 Fix return type in SYNOPSIS. Add RETURN VALUE section.
6644 Small rearrangement of text under NOTES.
6648 Rewrite and substantial additional text.
6652 Minor clarifications for text on execlp() and execvp(). Removed
6653 FILES section, since it provides no useful additional info.
6657 Moved link instructions from NOTES to SYNOPSIS.
6658 Added feenableexcept, fedisableexcept, fegetexcept
6663 Added 'putwc' to .SH NAME list.
6667 s/int/socklen_t/ for type of gethostbyaddr() 'len' argument,
6668 and add a few more words in NOTES about the type used here.
6672 Removed remark from NOTES about linking with -lutil; add
6673 text on that point to SYNOPSIS.
6677 Removed redundant remark from NOTES about linking with -lutil
6678 since there is text on that point under SYNOPSIS.
6682 Added SEE ALSO referring to getconf(1).
6686 Revised .SH NAME section.
6690 Minor rearrangement of order of text.
6694 s/exec()/execve(2)/ in various places.
6698 Changed "atan(1)" to "atan(1.0)" to prevent some versions of
6699 man2html(1) from mistaking that string as a page cross reference.
6703 Small restructuring to avoid 'cannot adjust line' from man(1).
6707 Removed now very out-of-date sentence about need to link shared
6712 Various text was moved out of this page into the new man-pages.7.
6716 Added SEE ALSO referring to new man-pages.7.
6720 A few changes, hopefully done right, to eliminate some
6721 errors to stderr when rendering with man(1).
6725 Shorten a line in table so it fits in 80 columns.
6726 Minor rewording under BUGS.
6730 Moved EXIT STATUS section.
6733 ==================== Changes in man-pages-2.55 ====================
6735 Released: 2007-06-10
6740 The following people contributed notes, ideas, or patches that have
6741 been incorporated in changes in this release:
6743 Alexander Taboriskiy <alextab@math-solution.com>
6744 Joey Hess <joeyh@debian.org>
6745 John Reiser <jreiser@bitwagon.com>
6746 Julien Cristau <jcristau@debian.org>
6747 Justin Pryzby <justinpryzby@users.sourceforge.net>
6748 Martin (Joey) Schulze <joey@infodrom.org>
6749 Mike Frysinger <vapier@gentoo.org>
6750 Serge van den Boom <svdb@stack.nl>
6751 Ulrich Drepper <drepper@redhat.com>
6752 Xose Vazquez Perez <xose.vazquez@gmail.com>
6754 Apologies if I missed anyone!
6774 mtk, after a note by Mike Frysinger
6775 Updated to reflect the fact that the _syscallN() macros
6780 Change reference to path_resolution.2 to path_resolution.7.
6782 Typographical or grammatical errors have been corrected in several
6789 path_resolution.2 has been moved to section 7, thus path_resolution.7
6791 Reason: this is an overview page, not one describing as
6792 a specific system call.
6795 Changes to individual pages
6796 ---------------------------
6799 mtk, after a note from Xose Vazquez Perez
6800 Added pointer to Red Hat man-pages bugzilla.
6802 Added a release philosophy note on separating out big
6803 formatting changes into their own release that contains minimal
6808 Add new EXAMPLE section with pointer to example in bind.2.
6812 Added RETURN VALUE section.
6816 Expand example program, and move it to new EXAMPLE section.
6817 Added text pointing to example in getaddrinfo.3.
6821 Convert NOTES section to CONFORMING TO and note that
6822 this call is Linux-specific.
6823 Other minor rewordings.
6827 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6836 Small rewrite of SEE ALSO text pointing to Documentation/* in
6841 Added ERRORS heading
6846 Added an ERRORS section.
6850 Added a RETURN VALUE section.
6854 Added an ERRORS section (stating that the calls are
6859 Add SEE ALSO reference to ioctl.2.
6863 Add new EXAMPLE section with pointer to example in bind.2.
6866 Martin (Joey) Schulze
6871 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6873 sched_get_priority_max.2
6874 sched_rr_get_interval.2
6875 sched_setscheduler.2
6882 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6886 Added an ERRORS section (stating that the call is
6890 mtk, after a note from Alexander Taboriskiy
6891 Strengthen warning against the use of signal().
6892 Added siginterrupt(3) to SEE ALSO list.
6894 Rewrote various parts; added an ERRORS section.
6898 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6902 Added EXAMPLE program.
6906 Converted to -man format; some rewrites; added an EXAMPLE.
6910 Improved the example program.
6914 Add text pointing to example in getaddrinfo.3.
6918 Add example programs.
6919 Add getnameinfo() to SEE ALSO list.
6922 mtk / Serge van den Boom
6923 Clarify discussion of what happens if 'src' and 'dest' overlap.
6927 Add grep(1) to SEE ALSO list.
6930 mtk after a note from Ulrich Drepper
6931 Clarify discussion of feature test macros that are needed to
6932 expose System V and BSD versions of this function in glibc.
6936 Removed some functions that have been documented.
6939 Martin (Joey) Schulze
6940 Remove wscanf.3 from SEE ALSO list, since that page does not exist.
6944 Removed outdated note on xdm.
6945 See Debian bug 418009.
6946 Martin (Joey) Schulze
6947 Removed outdated note about Debian and libc5.
6950 Martin (Joey) Schulze
6951 Fix order of commands listed under 'init='.
6955 Add /media, remove /dos.
6956 See Debian bug 418234.
6960 Added text describing what happens when the buffer given to
6961 read(2) is too small to return information about the next event,
6962 and noting the behavior change in 2.6.21.
6966 Added text to note that ERRORS list should be in alphabetical order.
6971 Added SEE ALSO reference to groff_mdoc(7).
6975 Added EXAMPLE section with pointer to bind.2 EXAMPLE.
6979 Simplify text describing --inhibit-rpath.
6980 mtk, after a note by John Reiser
6981 Describe use of $ORIGIN in rpath.
6984 ==================== Changes in man-pages-2.56 ====================
6986 Released: 2007-06-11
6993 Removed version numbers in .TH lines.
6994 Reason: these were only arbitrarily updated, and so impart no
6995 useful information. Version information goes into a
6996 VERSIONS section nowadays, and the date in the .TH line should
6997 be updated to reflect the date of the last (significant)
7000 Typographical or grammatical errors have been corrected in several
7004 ==================== Changes in man-pages-2.57 ====================
7006 Released: 2007-06-17
7011 The following people contributed notes, ideas, or patches that have
7012 been incorporated in changes in this release:
7014 Samuel Thibault <samuel.thibault@ens-lyon.org>
7016 Apologies if I missed anyone!
7024 Fix section numbers in page cross references.
7027 Changes to individual pages
7028 ---------------------------
7032 Minor wording fixes.
7033 Small clarification of description of 'mode'.
7037 Small reworking of EXAMPLE program.
7041 Minor wording fixes.
7045 Added more detail on exit handlers.
7046 Minor wording fixes.
7050 Remove SEE ALSO reference to non-existent mt.4.
7053 Samuel Thibault / mtk
7054 In Linux 2.6, the 'modify_ldt_ldt_s' structure was renamed
7055 'user_desc'. See Debian bug 378668.
7057 Include definition of 'user_desc' structure.
7062 Small reworking of EXAMPLE program.
7066 Removed reference to non-existent sigsend(2).
7070 Remove SEE ALSO reference to non-existent itoa.3.
7074 Removed SEE ALSO reference to non-existent time.3.
7078 Removed SEE ALSO reference to nonexistent fcrypt.3.
7082 Small reworking of EXAMPLE program.
7086 Remove SEE ALSO reference to non-existent fclean.3.
7090 s/ttyname(0)/ttyname(STDIN_FILENO)/ in program example.
7094 s/exit(1)/exit(EXIT_FAILURE)/
7098 Correct some section numbers in page cross references.
7102 Modify requirements for example programs a little.
7106 Wrapped long source lines.
7109 ==================== Changes in man-pages-2.58 ====================
7111 Released: 2007-06-24
7116 The following people contributed notes, ideas, or patches that have
7117 been incorporated in changes in this release:
7119 Marc Boyer <marc.boyer@enseeiht.fr>
7120 Mike Frysinger <vapier@gentoo.org>
7122 Apologies if I missed anyone!
7128 Various pages, as detailed below
7130 Added or updated VERSIONS sections.
7154 Add SEE ALSO link to new credentials.7.
7162 An overview of Linux process identifiers (PIDs, PPIDs,
7163 PGIDS, SIDs, UIDs, GIDs).
7166 Changes to individual pages
7167 ---------------------------
7171 Added some comments to example program.
7175 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7179 Updated discussion of somaxconn limit.
7183 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7187 VERSIONS: Glibc support has been provided since version 2.2.
7191 Added VERSIONS section.
7195 Updated VERSIONS section with text on glibc support.
7199 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7203 Added VERSIONS section with info on semtimedop().
7207 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7211 VERSIONS: Supported since glibc 2.2.4.
7215 Added VERSIONS section.
7219 VERSIONS: Supported since glibc 2.2.1.
7222 mtk after a suggestion by Mike Frysinger
7223 Add text to the introductory part of DESCRIPTION, about the
7224 'size' argument of snprintf() and vsnprintf().
7228 Added VERSIONS section; rewrote info about linking with -lrt.
7232 Improve the discussion of strncat().
7236 Improve the discussion of strncpy().
7240 Added discussion of /proc/sys/net/core/somaxconn.
7243 ==================== Changes in man-pages-2.59 ====================
7245 Released: 2007-06-25
7250 Manual pages are now standardized on American spelling. See
7251 http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences
7252 for more information on the differences. Formerly, different pages (and
7253 sometimes even a single page!) employed American and British spelling
7254 conventions; best to standardize on one spelling, and American English
7255 is the standard in Computer Science.
7257 Changes to individual pages
7258 ---------------------------
7262 Note that man-pages has now standardized on American spelling
7283 Corrected minor spelling/wording mistakes (i.e., changes
7284 independent of fixes for American spelling).
7287 ==================== Changes in man-pages-2.60 ====================
7289 Released: 2007-06-25
7296 Wrapped lines in some files.
7300 Change "e.g. " to "e.g., ", or in some cases, "for example, ".
7304 Change "i.e. " to i.e., ", or in some cases, "that is, ".
7308 Removed AUTHORS section.
7310 Typographical or grammatical errors have been corrected in several
7314 Changes to individual pages
7315 ---------------------------
7319 s/w.r.t/with respect to/
7323 Strengthened warning against use of AUTHORS section.
7326 ==================== Changes in man-pages-2.61 ====================
7328 Released: 2007-07-01
7334 The following people contributed notes, ideas, or patches that have
7335 been incorporated in changes in this release:
7337 Alain Portal <aportal@univ-montp2.fr>
7338 Benno Schulenberg <bensberg@justemail.net>
7339 Florian Ernst <florian_ernst@gmx.net>
7340 Ivana Varekova <varekova@redhat.com>
7341 Jeff Schroeder <jeffschroeder@computer.org>
7342 Joey (Martin) Schulze <joey@infodrom.org>
7343 Justin Pryzby <justinpryzby@users.sourceforge.net>
7344 Loïc Minier <lool@dooz.org>
7345 Michael Gehring <mg@ebfe.org>
7346 Serge van den Boom <svdb@stack.nl>
7347 Stefan Puiu <stefanpuiuro@yahoo.com>
7348 Stepan Kasal <kasal@ucw.cz>
7350 Apologies if I missed anyone!
7358 substitute `\\0' by '\\0'.
7362 s/`/'/ when the thing being quoted is a character.
7371 mtk after a note by Martin (Joey) Schulze
7372 Add NOTES paragraph noting that <sys/types.h> isn't required by
7373 POSIX.1-2001 or Linux, but was required on some implementations.
7386 Replace form `...' with \fI...\fP where the enclosed string
7387 is a pathname, type name, or argument name.
7391 s/process' /process's/
7401 Add section number to page cross references.
7408 Reordered .SH sections.
7415 Made CONFIG/CONFIGURING heading ==> CONFIGURATION
7431 Reformatted headings
7438 mtk, with input from Justin Pryzby and Stefan Puiu
7439 Documents backtrace(), backtrace_symbols(), and
7440 backtrace_symbols_fd().
7447 backtrace_symbols_fd.3
7449 Links to backtrace.3.
7456 Changes to individual pages
7457 ---------------------------
7461 Fix setting of 'prefix' macro.
7465 Fix bad text (concatenated line).
7469 Fixed description of EACCES error.
7470 Added sentence defining "current working directory".
7471 Other minor wording changes.
7475 Added SEE ALSO section.
7483 Minor wording changes.
7487 Fix small wording error.
7491 Add NOTES on what happens if gethostid() can't open /etc/hostid.
7495 Made NOTES text into a VERSIONS section, since that's what it
7500 Minor wording changes.
7504 Add semtimedop() to SEE ALSO.
7508 Minor wording changes.
7512 Rewrite to reflect the fact that the _syscallN
7513 macros are no longer available.
7517 Add "Link with -laio" to SYNOPSIS.
7521 Add "Link with -laio" to SYNOPSIS.
7525 Add "Link with -laio" to SYNOPSIS.
7529 Add "Link with -laio" to SYNOPSIS.
7533 Fix include in SYNOPSIS.
7535 Add "Link with -laio" to SYNOPSIS.
7539 Add recvmsg() and sendmsg() to SEE ALSO.
7541 Note that some architectures don't have ipc(2); instead
7542 real system calls are provided for shmctl(), semctl(), etc.
7546 Added <sys/types.h> to SYNOPSIS.
7548 sched_setscheduler.2
7550 Add NOTES para about permissions required to call
7551 sched_setscheduler() on other systems.
7555 Noted that 'timeout' can also be changed if select() is
7556 interrupted by a signal.
7560 Remove reference to _syscall0() macro.
7564 Changed text for EINVAL error.
7568 Note that some architectures don't have socketcall(2); instead
7569 real system calls are provided for socket(), bind(), etc.
7572 Ivana Varekova / mtk
7573 Update text for EPERM error describing the maximum number of
7574 swap files. (From downstream Fedora patch.)
7578 Added details about seekable files and file offset.
7579 Noted that write() may write less than 'count' bytes, and
7580 gave some examples of why this might occur.
7581 Noted what happens if write() is interrupted by a signal.
7582 Minor wording changes.
7586 Added a CONFORMING TO section; other minor edits.
7590 Minor rewrites in code example.
7594 Make SEE ALSO refer to timegm.3
7598 Small wording change.
7602 Comment was missing closing "*/".
7606 Formatting changes, and minor rewordings.
7607 mtk, after a note by Serge van den Boom
7608 Add a comment explaining the need for the rather
7609 strange cast of the return value of dlsym().
7613 Add "isinf" to NAME section.
7621 Minor rewording, and note taht '*n* is ignored
7622 if '*lineptr' is NULL.
7625 Ivana Varekova / mtk
7626 Update description of MALLOC_CHECK_ to include description
7627 for value 3. (From downstream Fedora patch.)
7631 Added a CONFORMING TO section; other minor edits.
7635 Minor changes to SYNOPSIS.
7637 program_invocation_name.3
7639 Shortened page title to INVOCATION_NAME.
7643 Added a CONFORMING TO section; other minor edits.
7647 Fix duplicated word "the".
7648 (Really fix Debian bug 412467!)
7652 Small wording change.
7656 Added a CONFORMING TO section.
7660 Added a CONFORMING TO section.
7666 Note use of "gcc -Wno-format-y2k" to avoid the "`%c' yields only
7667 last 2 digits of year in some locales" warning.
7671 Add "strcasestr" to NAME section.
7675 Small wording change.
7681 Added a CONFORMING TO section.
7685 Small wording changes.
7689 Remove erroneous text saying that glibc does not provide
7690 <ulimit.h>; it does.
7694 Various reformattings.
7698 Added a sentence noting why core dumps named "core.PID" were useful
7703 Fix capitalization in .SS headings.
7709 feature_test_macros.7
7711 Added SEE ALSO section.
7715 Reformatted headings; minor rewrites.
7719 Reformatted headings; minor rewrites.
7722 Loïc Minier <lool@dooz.org>
7723 Document argument type for SO_REUSEADDR.
7724 See Debian bug 255881.
7728 Wrap long line in SYNOPSIS.
7732 Added SEE ALSO section.
7735 ==================== Changes in man-pages-2.62 ====================
7737 Released: 2007-07-09
7739 This release consists solely of formatting fixes. There are no changes
7745 The following people contributed notes, ideas, or patches that have
7746 been incorporated in changes in this release:
7748 Stepan Kasal <kasal@ucw.cz>
7750 Apologies if I missed anyone!
7758 Many many formatting fixes.
7761 Add section number to .TH line for POSIX pages in man[013]p.
7764 ==================== Changes in man-pages-2.63 ====================
7766 Released: 2007-07-16
7772 The following people contributed notes, ideas, or patches that have
7773 been incorporated in changes in this release:
7775 Arnd Bergmann <arndb@de.ibm.com>
7776 Eduardo M. Fleury <efleury@br.ibm.com>
7777 Ivana Varekova <varekova@redhat.com>
7778 Justin Pryzby <justinpryzby@users.sourceforge.net>
7779 Marc Boyer <marc.boyer@enseeiht.fr>
7780 Martin (Joey) Schulze <joey@infodrom.org>
7781 Martin Röhricht <martin@roehricht.info>
7782 Patrick Mansfield <patmans@us.ibm.com>
7783 Pierre Habouzit <madcoder@debian.org>
7784 Stepan Kasal <kasal@ucw.cz>
7786 Apologies if I missed anyone!
7806 Minor wording changes.
7812 Added SEE ALSO reference to syscalls.2.
7820 A real man page for sgetmask(2) and ssetmask(2).
7821 (This page replaces a previous link of the same name, which
7822 linked to signal.2.)
7825 Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7826 Document the PowerPC SPU spu_create() system call.
7827 (Originally taken from the kernel source file
7828 Documentation/filesystems/spufs.txt.)
7831 Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7832 Document the PowerPC SPU spu_run() system call.
7833 (Originally taken from the kernel source file
7834 Documentation/filesystems/spufs.txt.)
7837 Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7838 Document the PowerPC SPU file system.
7839 (Originally taken from the kernel source file
7840 Documentation/filesystems/spufs.txt.)
7848 This file was created by accident in 2.61, as a copy of clone.2.
7849 (it should have been a link to clone.2.)
7853 Details on this page are covered in syscalls.2 and in
7854 respective syscall man pages (stat.2, uname.2).
7858 This page is very out of date, and in any case difficult
7859 to maintain. Information about undocumented system calls
7860 is maintained in the HOWTOHELP file, and probably in other
7865 This rather incomplete page seems unnecessary since there
7892 Added as link to corresponding page without "32".
7908 Added as link to corresponding page without "64".
7917 Link to getrlimit.2.
7925 Added as links to corresponding section 3 pages.
7930 Links to posix_fadvise.2.
7937 Added as link to corresponding page without "rt_" prefix.
7946 mtk / Ivana Varekova
7947 Link to unimplemented.2.
7950 Changes to individual pages
7951 ---------------------------
7955 Fairly substantial rewrites of various parts,
7956 and a few additions.
7960 Update SYNOPSIS to reflect the fact that fchmod(2) needs
7961 either "#define _XOPEN_SOURCE 500" or "#define _BSD_SOURCE".
7965 Update SYNOPSIS to reflect the fact that fchmod(2) and lchown(2)
7966 need either "#define _XOPEN_SOURCE 500" or "#define _BSD_SOURCE".
7967 Added an example program.
7971 Note that killpg() is actually a library function on Linux.
7975 Added note that glibc mmap() wrapper nowadays invokes mmap2().
7978 Ivana Varekova / mtk
7979 On most platforms the unit for 'offset' is 4096 bytes, not
7980 the system page size.
7982 Rewrote NOTES to note that glibc mmap() wrapper nowadays
7983 invokes this system call.
7985 Added an EXAMPLE program.
7991 Changed link to point to stat.2 (instead of obsolete.2).
7996 Changed link to point to uname.2 (instead of obsolete.2).
8000 Added _GNU_SOURCE to SYNOPSIS.
8004 Remove reference discussion of ipc(2), since none of the
8005 other System V IPC pages mention ipc(2).
8009 Add an example code segment.
8013 Add svipc(7) to SEE ALSO list.
8017 Reformatted tables as lists; other minor reformattings and
8022 Added info on rt_sigqueueinfo(2).
8026 Noted that sigwaitinfo() is a library function implemented on
8027 top of sigtimedwait().
8031 Make this link point to new sgetmask.2 instead of signal.2.
8035 Add notes on the different system call interfaces that
8036 have appeared over time.
8040 A fairly substantial rewrite of this page,
8041 bringining it up to date with the current
8042 kernel version, and listing all system calls
8047 Add notes on the different system call interfaces that
8048 have appeared over time.
8052 Add vserver, madvise1 to NAME line.
8053 Removed SEE ALSO reference to obsolete.2.
8055 Add tuxcall to NAME line.
8059 Fix description of return value.
8063 Minor fix to example program.
8067 Add section numbers to function names; remove some functions
8068 since they are documented.
8072 Update/correct text on /proc/malloc.
8073 mtk, after a note by Pierre Habouzit, and a few comments
8075 Update description of /proc/PID/stat to match 2.6.21.
8076 See Debian bug 417933.
8080 IN_DONT_FOLLOW and IN_ONLYDIR are only available from 2.6.15.
8084 Note SIGRTMIN value depends on glibc.
8086 Various rewrites and additions to the text in real-time signals.
8087 Add SEE ALSO reference to sgetmask.2.
8091 Add ipc(2) to SEE ALSO.
8094 ==================== Changes in man-pages-2.64 ====================
8096 Released: 2007-07-27
8102 The following people contributed notes, ideas, or patches that have
8103 been incorporated in changes in this release:
8105 Aleksandr Koltsoff <czr@iki.fi>
8106 Andries Brouwer <Andries.Brouwer@cwi.nl>
8107 Justin Pryzby <justinpryzby@users.sourceforge.net>
8109 Apologies if I missed anyone!
8303 Added/updated feature test macro requirements for
8304 glibc; see feature_test_macros.7 for details.
8306 Changes to individual pages
8307 ---------------------------
8319 Fairly substantial changes and corrections, including adding
8320 coverage of all of the interfaces that get/set PGIDs.
8324 Various rewordings; clear up some imprecisions.
8328 Added 'signgam' to SYNOPSIS and NAME line.
8332 Note that the XPG version is provided since glibc 2.3.4.
8333 The page formerly said that the GNU-specific version
8334 is provided by default. That certainly isn't true
8335 nowadays, since _POSIX_C_SOURCE is set to 200112L by
8336 default, so that the XSI-compliant version is supplied
8341 Added note pointing to feature_test_macros.7 for a description
8342 of how feature test macro requirements should be specified in
8343 manual pages. Various other minor fixes and changes.
8345 feature_test_macros.7
8347 Added note about how feature test macros are specified
8349 Many other corrections, improvements, additions, and
8350 details about differences across glibc versions.
8353 ==================== Changes in man-pages-2.65 ====================
8355 Released: 2007-09-17
8361 The following people contributed notes, ideas, or patches that have
8362 been incorporated in changes in this release:
8364 Aleksandr Koltsoff <czr@iki.fi>
8365 Andi Kleen <ak@suse.de>
8366 Anton Blanchard <anton@samba.org>
8367 Ari Entlich <lmage11@twcny.rr.com>
8368 Carsten Emde <Carsten.Emde@osadl.org>
8369 François Diakhate <diakhate@enseirb.fr>
8370 Geoff Clare <gclare@gclare.org.uk>
8371 Jon Burgess <jburgess777@googlemail.com>
8372 Julien Cristau <jcristau@debian.org>
8373 Lee Schermerhorn <Lee.Schermerhorn@hp.com>
8374 Mats Wichmann <mats.d.wichmann@intel.com>
8375 Maxime Bizon <mbizon@freebox.fr>
8376 Maxime Vaudequin <maxime.vaudequin@gmail.com>
8377 Michael Prokop <mika@grml.org>
8378 Mike Frysinger <vapier@gentoo.org>
8379 Nicolas François <nicolas.francois@centraliens.net>
8380 Nicolas George <nicolas.george@ens.fr>
8381 Paul Brook <paul@nowt.org>
8382 Reuben Thomas <rrt@sc3d.org>
8383 Sam Varshavchik <mrsam@courier-mta.com>
8384 Samuel Thibault <samuel.thibault@ens-lyon.org>
8385 Thomas Huriaux <thomas.huriaux@gmail.com>
8386 Tolga Dalman <tdalman@project-psi.org>
8387 Ulrich Drepper <drepper@redhat.com>
8388 Vincent Lefevre <vincent@vinc17.org>
8390 Apologies if I missed anyone!
8396 Typographical or grammatical errors have been corrected in several
8401 Use 'glibc' consistently to refer to GNU C library.
8405 Order errors under ERRORS alphabetically.
8409 Spelling and formatting fixes, as per Debian bug 439560.
8420 Add "#include <stdlib.h>" (to declare exit(3)) to example program.
8428 Description of timeradd(), timersub(), timerclear(),
8429 timerisset(), timercmp() macros for operating on
8438 Somehow, over time, material on fdatasync(2) crept into
8439 fsync.2, and fdatasync also got added to the NAME section
8440 of fsync.2. All of the material in fdatasync.2 that was
8441 not already in fsync.2 has now been moved there, and
8442 the former page has been removed.
8443 In place of the content there, is now a link to fsync.2.
8453 Link to man3/clock_getres.3.
8465 Link to gethostbyaddr.3.
8472 Links to new timeradd.3.
8475 Changes to individual pages
8476 ---------------------------
8480 Make the install target of man-pages respect the standard
8481 "DESTDIR" variable as well as check the exit status of the
8482 install command so errors aren't ignored.
8486 changed the "policy" parameter to "mode" through out the
8487 descriptions in an attempt to promote the concept that the memory
8488 policy is a tuple consisting of a mode and optional set of nodes.
8490 added requirement to link '-lnuma' to synopsis
8492 rewrite portions of description for clarification.
8494 added all errors currently returned by sys call.
8496 removed cautionary note that use of MPOL_F_NODE|MPOL_F_ADDR
8497 is not supported. This is no longer true.
8499 added mmap(2) to See Also list.
8503 Since kernel 2.6.22, Linux setitimer() now conforms to POSIX.1,
8504 giving an EINVAL error for a non-canonical tv_usec value.
8508 Replace discussion of timer* macros with a pointer
8509 to new page timeradd.3.
8513 Fixed argument type for BLKGETSIZE.
8518 changed the "policy" parameter to "mode" throughout the
8519 descriptions in an attempt to promote the concept that the memory
8520 policy is a tuple consisting of a mode and optional set of nodes.
8522 rewrite portions of description for clarification.
8524 clarify interaction of policy with mmap()'d files and shared
8525 memory regions, including SHM_HUGE regions.
8527 defined how "empty set of nodes" specified and what this
8528 means for MPOL_PREFERRED.
8530 mention what happens if local/target node contains no
8533 clarify semantics of multiple nodes to BIND policy.
8534 Note: subject to change. We'll fix the man pages when/if
8537 added all errors currently returned by sys call.
8539 added mmap(2), shmget(2), shmat(2) to See Also list.
8544 Add text noting that PROT_WRITE may (and on x86 does)
8546 See Debian bug 441387.
8560 Update arches/kernel versions for PR_SET_UNALAIGN / PR_GET_UNALIGN.
8564 Removed SEE ALSO reference to nonexistent fadvise.2.
8568 Place SYNOPSIS comments inside C comments (/* ... */).
8572 Note what thread is affected if 'pid' is specified
8573 as 0, or as the value returned by getpid().
8575 sched_setscheduler.2
8577 Add text on real-time features of mainline Linux kernel.
8581 sync SYNOPSIS with select.2
8586 changed the "policy" parameter to "mode" throughout the
8587 descriptions in an attempt to promote the concept that the memory
8588 policy is a tuple consisting of a mode and optional set of nodes.
8590 added requirement to link '-lnuma' to synopsis
8592 rewrite portions of description for clarification.
8594 clarify interaction of policy with mmap()'d files.
8596 defined how "empty set of nodes" specified and what this
8597 means for MPOL_PREFERRED.
8599 mention what happens if local/target node contains no
8602 clarify semantics of multiple nodes to BIND policy.
8603 Note: subject to change. We'll fix the man pages when/if
8606 added all errors currently returned by sys call.
8608 added mmap(2) to See Also list.
8612 s/si_sign/si_errno/ in statement about which field is unused.
8614 s/SIGILL/SIGCHLD/ for paragraph describing SIGCHLD.
8618 Improve text describing underlying system calls.
8622 EINVAL also occurs if target path is on tmpfs or similar.
8623 See Debian bug 435885.
8627 Incorporated material from now deleted fdatasync.2.
8631 Small fix in example program.
8635 Improve text describing underlying system calls.
8638 Vincent Lefevre / mtk
8639 Clarify utimes() behaviour when 'times' is NULL.
8640 See Debian bug 431480.
8642 Other minor clarifications of description of utimes().
8646 s/sign/sign bit/ to remove ambiguity in description.
8647 See Debian bug 435415.
8651 Changed NOTES to VERSIONS.
8655 Add ffsl and ffsll to NAME line.
8659 Removed statement that fts functions are expected to appear
8660 soon in POSIX; it's years old and has not yet come to pass.
8664 Fixes/improvements for example program.
8668 Add getdate_r to NAME section.
8672 Fixes/improvements for example program.
8676 Add documentation for gethostbyaddr_r().
8677 Plus a few other small fixes.
8681 Add gethostbyname2, gethostbyname2_r, gethostbyname_r,
8682 gethostent_r to NAME line.
8686 Fix misnamed function references.
8690 Fix small error in example program.
8694 Add setrpcent and endrpcent to NAME line.
8698 Fix gsignal() prototype.
8702 Add hcreate_r, hdestroy_r, hsearch_r to NAME line.
8706 Correct definition of "struct in_addr".
8714 Add islessequal to NAME line.
8718 Fix CONFORMING TO section.
8719 See Debian bug 417592.
8723 Add log1pf and log1pl to NAME line.
8727 After a call to longjmp(), the values of modified, non-volatile
8728 variables in the function that called setjmp() are unspecified.
8732 Fix makecontext() prototype.
8736 Explain what happens for malloc(0), or calloc() where one of the
8739 Added notes on malloc()'s use of sbrk() and mmap().
8741 Add mmap(2), alloca(3) to SEE ALSO.
8751 Add "Link with -lrt." to SYNOPSIS.
8754 Ulrich Drepper; some edits and additional text by mtk
8755 Document fdopendir().
8758 mtk, after a note by Andi Kleen
8759 Document DT_* constants for d_type.
8760 Ulrich Drepper / mtk
8761 Rework discussion of non-standard structure fields.
8765 Minor improvements to example program.
8769 Add vsyslog to NAME section.
8773 Fix XCASE feature test macro description.
8777 Add return type to prototype.
8781 Improve description of num_threads field under /proc/PID/stat.
8783 Fix path error (s%proc/sys%proc/sys/kernel%) in mentions of
8784 /proc/sys/ostype, /proc/sys/osrelease and proc/sys/version.
8786 I noticed things to correct and to clarify in subsection
8787 "/proc/filesystems" of proc.5:
8788 - clarify filesystems listing: not only FS compiled
8789 into the kernel, also FS kernel modules currently loaded
8790 - add a reference to fs(5)
8791 - add an explanation for FS marked with "nodev"
8792 - s/mount(1)/mount(8)/, also corrected in section "SEE ALSO"
8793 - clarify usage by mount: the current wording may lead to
8794 think /proc/filesystems is always used by mount when no FS
8795 is specified. So, usage of "may" which IMHO is more
8796 appropriate + additional explanations
8797 In mount(8) we can see:
8799 If no -t option is given, or if the auto type is
8800 specified, mount will try to guess the desired type.
8801 If mount was compiled with the blkid library, the
8802 guessing is done by this library. Otherwise, mount
8803 guesses itself by probing the superblock; if that
8804 does not turn up anything that looks familiar,
8805 mount will try to read the file /etc/filesystems,
8806 or, if that does not exist, /proc/filesystems.
8807 All of the filesystem types listed there will be
8808 tried, except for those that are labeled "nodev"
8809 (e.g., devpts, proc and nfs). If /etc/filesystems
8810 ends in a line with a single * only, mount will
8811 read /proc/filesystems afterwards.
8813 Since linux 2.6.11, /proc/stat has an eighth value for cpu
8814 lines: stolen time, which is the time spent in other operating
8815 systems when running in a virtualized environment.
8818 Updated BUGS text referring to jiffies; refer to time.7 instead.
8822 Add words to note that file system ID is Linux specific.
8826 This is some corrections for hier.7:
8827 - missing period for /media and /mnt
8828 - /mnt description is not totally correct, it is true for some
8829 distributions but in others /mnt is used as a temporary FS
8830 mount point, as it is specified by FHS:
8831 http://www.pathname.com/fhs/pub/fhs-2.3.html#
8832 MNTMOUNTPOINTFORATEMPORARILYMOUNT
8833 - s/X-Windows/X-Window/ (3 occurrences)
8834 - section "SEE ALSO": s/mount(1)/mount(8)/
8840 mtk / Nicolas François
8841 Nowadays tmac.XXX are called XXX.tmac.
8845 Update text about modern threading implementations
8846 (NPTL vs LinuxThreads).
8849 mtk, after a note by Andi Kleen
8850 Clarify that SO_SNDTIMEO and SO_RCVTIMEO only have effect for
8851 socket I/O calls; not for multiplexing system calls like
8852 select() and poll().
8856 Add SEE ALSO reference to new timeradd.3.
8859 ==================== Changes in man-pages-2.66 ====================
8861 Released: 2007-10-01
8867 The following people contributed notes, ideas, or patches that have
8868 been incorporated in changes in this release:
8870 Amit K. Arora <aarora@linux.vnet.ibm.com>
8871 David Chinner <dgc@sgi.com>
8872 Fredrik Noring <noring@nocrew.org>
8873 Mats Wichmann <mats.d.wichmann@intel.com>
8874 Maxime Vaudequin <maxime.vaudequin@gmail.com>
8875 Ollie Wild <aaw@google.com>
8876 Ulrich Drepper <drepper@redhat.com>
8878 Apologies if I missed anyone!
8884 Typographical or grammatical errors have been corrected in several
8892 David Chinner, with some input from Amit Amora and mtk
8893 Describes the fallocate() system call, new in 2.6.23.
8896 Changes to individual pages
8897 ---------------------------
8901 Add text cautioning about use of close() in
8902 multithreaded programs.
8906 Add text describing limit on total size of argv + envp,
8907 and changes that occurred with 2.6.23.
8909 Add getopt(3) to SEE ALSO list.
8912 mtk, Acked by Ulrich Drepper
8913 Added description of O_CLOEXEC (new in 2.6.23) + other
8914 minor fixes for O_DIRECT.
8918 Added description of MSG_CMSG_CLOEXEC (new in 2.6.23).
8922 Strengthened the warning against using this system call
8923 and note that it may disappear in a future kernel version.
8927 Fix type definition for 'protocol' in prototypes of pmap_set()
8931 ==================== Changes in man-pages-2.67 ====================
8933 Released: 2007-10-08
8939 The following people contributed notes, ideas, or patches that have
8940 been incorporated in changes in this release:
8942 Andi Kleen <andi@firstfloor.org>
8943 Andrew Josey <a.josey@opengroup.org>
8944 Maxime Vaudequin <maxime.vaudequin@gmail.com>
8946 Apologies if I missed anyone!
8954 mtk, after a note by Andi Kleen and consultation with Andrew Josey.
8955 Add a PROLOG section:
8956 This manual page is part of the POSIX Programmer's Manual.
8957 The Linux implementation of this interface may differ
8958 (consult the corresponding Linux manual page for details
8959 of Linux behavior), or the interface may not be implemented
8966 Some formatting fixes, mostly to get rid of unwanted
8967 spaces before "," in formatted output.
8972 Change all occurrences of my email address in man-pages source
8973 to my new gmail address.
8978 I noticed useless use of macros with alternating formatting
8979 (".IR" instead ".I" which suffices, ".BR" instead ".B", etc.)
8980 because there is only one element. For example in ldconfig.8:
8985 This is not very important, it only makes the sources more tidy.
8986 To find these I used:
8988 egrep '^\.(B[RI]|R[IB]|I[RB]) ([^ ]+|\"[^\"]\+\")$'
8990 And if you want to make these changes, you can use:
8992 sed 's/^\(\.[BRI]\)[BRI]\( \([^ ]\+\|\"[^\"]\+\"\)\)$/\1\2/g'
8995 ==================== Changes in man-pages-2.68 ====================
8997 Released: 2007-11-19
9003 The following people contributed notes, ideas, or patches that have
9004 been incorporated in changes in this release:
9006 A. Costa <agcosta@gis.net>
9007 Andrew McDonald <andrew@mcdonald.org.uk>
9008 Geoff Clare <gclare@gclare.org.uk>
9009 Heikki Orsila <shd@modeemi.cs.tut.fi>
9010 Hyokyong Kim <hyokyong@ppj.kr>
9011 Ivana Varekova <varekova@redhat.com>
9012 Justin Pryzby <jpryzby+d@quoininc.com>
9013 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9014 Mike Frysinger <vapier@gentoo.org>
9015 Nicolas François <nicolas.francois@centraliens.net>
9016 Pádraig Brady <P@draigBrady.com>
9017 Sam Varshavchik <mrsam@courier-mta.com>
9018 Timo Juhani Lindfors <timo.lindfors@iki.fi>
9019 Ulrich Drepper <drepper@redhat.com>
9021 Apologies if I missed anyone!
9039 mtk, after Debian bug 445436 by Timo Juhani Lindfors
9040 Added <fcntl.h> to SYNOPSIS.
9042 Typographical or grammatical errors have been corrected in several places.
9050 Created as a new page, by taking the content specific to
9051 the _syscall() macros from intro(2).
9054 Changes to individual pages
9055 ---------------------------
9061 man-pages-*-Announce
9063 Brought the info in here up to date.
9067 Added intro paragraph about section, plus a paragraph
9068 about exit status values.
9069 Move "user intro" text to NOTES.
9073 Reorder ERRORS sections alphabetically
9077 Pretty much a complete rewrite, covering some additional topics.
9078 Moved _syscallN() material to new _syscall(2) page.
9082 Reorder ERRORS sctions alphabetically
9086 Fix syntax error in example program.
9090 Linux 2.6.22 added support on Alpha for PR_SET_UNALIGN.
9093 Nicolas François / mtk
9094 s/PTRACE_POKEUSR/PTRACE_POKEUSER/
9095 s/PTRACE_PEEKUSR/PTRACE_PEEKUSER/
9099 Add text describing timerfd EINVAL error for read(2).
9103 Reorder ERRORS sctions alphabetically
9107 Added _syscall(2) and intro(2) to SEE ALSO section.
9111 Added fallocate(2); removed timerfd(2).
9115 Removed reference to example in intro(2).
9119 Added "Link with -ldl." to SYNOPSIS.
9123 Remove references to getipnodebyname.3 and getipnodebyaddr.3.
9126 mtk / Ulrich Drepper
9127 Remove SEE ALSO references to getipnodebyname.3 and
9130 Pádraig Brady / mtk / Ulrich Drepper
9131 Point out that the functions described on this page
9132 are made obsolete by getadrinfo(3) and getnameinfo(3).
9136 Clarify that glibc does not implement these functions.
9139 Ulrich Drepper / mtk
9140 Fix description of GLOB_ONLYDIR.
9142 Added description of GLOB_TILDE_NOMATCH.
9143 Expanded the description of various flags.
9144 Various wording fixes..
9148 Pretty much a complete rewrite, covering some additional topics.
9152 Add SEE ALSO referring to fallocate.2.
9156 Add some arg declarations to prototypes; fixe typos.
9160 Fix text in BUGS section.
9164 The sigset() bugs were fixed in glibc 2.5.
9165 See http://sourceware.org/bugzilla/show_bug.cgi?id=1951.
9173 Various small corrections, formattings and modifications.
9178 - new p_flag: PT_GNU_STACK
9179 - new sections: .gnu.version .gnu.version_d .gnu.version_r
9181 - new structures: ElfN_Verdef ElfN_Verdaux ElfN_Verneed
9189 Ivana Varekova / mtk
9190 Add text noting that since kernel 2.6.16, /proc/slabinfo is
9191 only available if CONFIG_SLAB is enabled.
9193 Update description of /proc/pci.
9195 Give italic formatting to file names in proc.5.
9197 The display type of the /proc/PID/stat fields changed
9198 %lu to %u in Linux 2.6.22:
9204 Ivana Varekova / mtk
9205 Add text noting that since kernel 2.6.16, /proc/slabinfo is
9206 only available if CONFIG_SLAB is enabled.
9214 Update references to files in kernel "Documentation" directory.
9222 Fix description of IPV6_ROUTER_ALERT option.
9226 Note online location of C99 standard.
9230 Some rewrites, plus new paragraph on exit status values.