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!
39 Many math pages had their synopses compressed, as per suggestion
44 Many minor content and formatting bug fixes were made to the math
45 pages, following suggestions from Fabian Kreutz (who recently
46 translated many of the 1.70 math pages into German) and
51 For consistency, all instances of "super-user" were changed
52 to the more common "superuser".
56 After a note from Vasya Pupkin, I added <errno.h> to the SYNOPSIS
57 of several Section 2 pages using the _syscallN() macros.
60 -- erroneous semicolons at the end of _syscallN() were removed
63 -- types such as "uint" in syscallN() declarations were changed
64 to "unsigned int", etc.
66 -- various other minor breakages in the synopses were fixed.
68 The affected pages are:
82 Typographical or grammatical errors have been corrected in several
85 Changes to individual pages
86 ---------------------------
90 Added 'const' to declaration of 'my_addr' in prototype.
91 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239762.
95 Added O_NOATIME to list of flags that can be changed via F_SETFL.
97 Noted F_GETOWN bug after suggestion from aeb.
99 http://marc.theaimsgroup.com/?l=linux-kernel&m=108380640603164&w=2
103 Material on getrusage.2 has been separated out into its own page.
104 Rewrote discussion on RLIMIT_MEMLOCK to incorporate kernel
106 Added note on RLIMIT_CPU error in older kernels.
107 Added RLIMIT_SIGPENDING.
108 Also made a few other minor changes.
112 This page is new(ish) -- it was created by splitting
115 Repaired note on SIGCHLD behavior to note that the
116 POSIX non-conformance has been fixed in 2.6.9.
119 Modified after suggestion from Emmanuel Colbus
120 Changed wording of sentence under NOTES describing
121 when signals can be sent to init(1).
127 These have been consolidated into a single mlock.2 page.
128 In the process, much duplication was eliminated
129 and new information was added about RLIMIT_MEMLOCK
130 and the changes in memory locking in kernel 2.6.9,
134 Added cross-ref to setrlimit(2) concerning memory locking limits.
136 Note that MAP_FIXED replaces existing mappings
140 Substantial language and formatting clean-ups.
141 Added msqid_ds and ipc_perm structure definitions.
145 Substantial language and formatting clean-ups.
146 Added notes on /proc files.
150 Substantial language and formatting clean-ups.
151 Added notes on /proc files.
155 Added O_NOATIME (new in Linux 2.6.8)
157 Reordered list of 'flags' description alphabetically
160 2004-11-03 applied patch from Martin Schulze
164 Substantial language and formatting clean-ups.
166 Added semid_ds and ipc_perm structure definitions.
170 Substantial language and formatting clean-ups.
171 Added notes on /proc files.
172 Rewrote BUGS note about semget()'s failure to initialize
177 Substantial language and formatting clean-ups.
178 Added notes on /proc files.
182 Substantial language and formatting clean-ups.
183 Updated shmid_ds structure definitions.
184 Added information on SHM_DEST and SHM_LOCKED flags.
185 Noted that CAP_IPC_LOCK is not required for SHM_UNLOCK
187 Added notes on 2.6.9 RLIMIT_MEMLOCK changes.
188 Added RLIMIT_SIGPENDING (new in Linux 2.6.8)
192 Substantial language and formatting clean-ups.
193 Added notes on /proc files.
197 Substantial language and formatting clean-ups.
198 Changed wording and placement of sentence regarding attachment
199 of segments marked for destruction.
203 Added mention of SIGCONT under SA_NOCLDSTOP.
205 Updated discussion for POSIX.1-2001 and SIGCHLD and sa_flags.
206 Noted that CLD_CONTINUED is supported since Linux 2.6.9.
207 Added SI_TKILL (new in Linux 2.4.19).
212 Removed text on ignoring SIGCHLD; replaced with pointer
216 After bug report from Andrey Kiselev
217 Fixed prototype: "timeout" --> "*timeout"
218 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=222145
222 Added text to clarify that S_IS*() macros should be applied to
224 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=249698
227 After Debian bug report from Anand Kumria
228 Added "no swap space signature" to EINVAL error.
230 Added EINVAL error for swapoff() ("not currently a swap area").
231 Added EBUSY error for swapon().
232 A few formatting fixes.
236 In Linux 2.6, the return value of times changed; it is no
237 longer time since boot, but rather:
239 boot_time + 2^32 / HZ - 300
241 Repaired note on SIGCHLD behavior to note that the
242 POSIX non-conformance has been fixed in 2.6.9.
243 Some formatting fixes.
246 After bug report from Johannes Berg
251 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=220741
256 Added WCONTINUED and WIFCONTINUED (new in 2.6.10).
257 Added text on SA_NOCLDSTOP.
258 Updated discussion of SA_NOCLDWAIT to reflect 2.6 behavior.
259 Much other text rewritten.
263 Rewrote this page, removing much duplicated information,
264 and replacing with pointers to wait.2.
265 Luis Javier Merino Morán / mtk
266 CONFORMING TO said "SVr4, POSIX". Changed to "4.3BSD"
273 After bug report from Branden Robinson
274 The assert() failure message goes to stderr not stdout.
275 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=284814
279 Noted that 0 in tm_mday is interpreted to mean the last day
280 of the preceding month.
283 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=229618
284 getnameinfo() does not set errno, it returns a non-zero
285 value indicating the error.
287 added EAI_OVERFLOW error
291 Minor changes to SEE ALSO and CONFORMING TO.
295 New page by Andries Brouwer
299 Change "NULL" to "empty" when talking about the value of TZ.
300 http://sources.redhat.com/bugzilla/show_bug.cgi?id=601
303 After bug report from Jan Kuznik
304 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=205736
305 Fixed bad realloc() use in snprintf() example
309 Added discussion of resolved_path == NULL.
312 After bug report from John V. Belmonte
313 Updated init and quit scripts to reflect kernel 2.4/2.6 reality
314 (Scripts taken from drivers/char/random.c)
315 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=247779
319 Updated description of /proc/loadavg to include
320 nr_running(), nr_threads, last_pid.
322 rtsig-max and rtsig-nr went away in 2.6.8
324 updated statm, and fixed error in order of list
327 applied patch from Martin Schulze
331 Added O_NOATIME for CAP_FOWNER
334 Karel Kulhavy and AEB
335 Formatting fix after note from Karel Kulhavy and AEB, plus a
340 /proc/sys/kernel/rtsig-* were superseded by RLIMIT_SIGPENDING
345 Updated details of interaction of TCP_CORK and TCP_NODELAY.
347 ==================== Changes in man-pages-2.01 ====================
354 The following people contributed notes, ideas, or patches that have
355 been incorporated in changes in this release:
357 Carsten Hey <c.hey@web.de>
358 Johannes Berg <johannes@sipsolutions.de>
359 Joshua Kwan <joshk@triplehelix.org>
360 Marek Habersack <grendel@debian.org>
361 Martin Schulze <joey@infodrom.org>
362 Matthew Dempsky <jivera@flame.org>
363 Matthew Gregan <kinetik@orcon.net.nz>
364 Pedro Zorzenon Neto <pzn@terra.com.br>
365 Tony Crawford <tony@klosterdorf.de>
367 Apologies if I missed anyone!
384 triggered by http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=283179
385 The wording describing how errno is set was fixed up in these pages.
387 Typographical or grammatical errors have been corrected in several
390 Changes to individual pages
391 ---------------------------
395 Adjusted descriptions of argument file types to be closer to
397 Wording and formatting changes.
402 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=270817
403 Formulae on the pages should be T = S / C not T = C / S.
407 Removed errno declaration from prototype, added notes
408 on historical need for this declaration.
409 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=174175
412 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=224953
413 Changed erroneous "aio_return(2)" to "aio_return(3)".
421 Added description of ptsname_r().
426 New link to ptsname.3.
430 add <fcntl.h> to synopsis
431 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=271243
438 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=234443
442 Added _GNU_SOURCE to prototype
443 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=213538
447 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248
449 Changed range for "%S" from 0..61 to 0..60.
451 SUSv3 says 0..60. I think the manual page probably says
452 0..61, because that's what SUSv2 said.
453 (Some other implementations' man pages also say 0..61 --
454 e.g., Solaris 8 & 9, Tru64 5.1B; FreeBSD 5.1 says 0..60.)
456 The glibc manual currently says 0..60.
458 Given that SUSv3 says 0..60, I've changed the
459 manual page to also say this:
461 -The second as a decimal number (range 00 to 61).
462 +The second as a decimal number (range 00 to 60).
463 +(The range is up to 60 to allow for occasional leap seconds.)
467 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=226974
468 -.BR POSIX2_FORT_RUN " - " _SC_2_FORT_DEV
469 +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV
473 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638
474 Noted use of _XOPEN_SOURCE to get macros from <stdlib.h>
478 Changed name of argument from 'string' to 'command' (like POSIX).
480 Noted that glibc does nowadays explicitly check for the existence
481 of the shell if 'command' is NULL, rather than the older behavior
482 of assuming the shell exists and always returning 1 if
485 Other wording and formatting clean-ups.
488 Remove some functions names that *are* documented.
491 ==================== Changes in man-pages-2.02 ====================
498 The following people contributed notes, ideas, or patches that have
499 been incorporated in changes in this release:
501 Andries Brouwer <Andries.Brouwer@cwi.nl>
502 Branden Robinson <branden@debian.org>
503 Colin Watson <cjwatson@debian.org>
504 David Lloyd <dmlloyd@tds.net>
505 Gordon Jin <gordon.jin@intel.com>
506 Heikki Orsila <shd@modeemi.cs.tut.fi>
507 Jamie Lokier <jamie@shareable.org>
509 Kai Makisara <Kai.Makisara@kolumbus.fi>
510 Marko Kohtala <marko.kohtala@gmail.com>
511 Martin Pool <mbp@sourcefrog.net>
512 Martin (Joey) Schulze <joey@infodrom.org>
513 Matthias Lang <matthias@corelatus.se>
514 Michael Haardt <michael@moria.de>
515 Michael Mühlebach <michael@anduin.ch>
516 Mike Frysinger <vapier@gentoo.org>
517 Sasa Stevanovic <mg94c18@alas.matf.bg.ac.yu>
518 Serguei Leontiev <leo@sai.msu.ru>
520 Apologies if I missed anyone!
529 Martin (Joey) Schulze
530 Removed SEE ALSO reference to nonexistent newctime(3).
531 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=236884
533 Typographical or grammatical errors have been corrected in several
536 Changes to individual pages
537 ---------------------------
541 Noted the PID caching behavior of NPTL's getpid()
544 Added futex(2), set_thread_area(2), set_tid_address(2),
545 tkill(2) under SEE ALSO.
550 Improved various error descriptions.
553 David Lloyd / Mike Frysinger, Marko Kohtala
554 Added EINTR to errors.
558 Improved discussion of F_SETOWN and F_SETSIG with respect to
559 multi-threaded programs.
560 Generally cleaned up the discussion of F_SETOWN.
562 Updated CONFORMING TO to note that F_GETOWN and F_SETOWN are
567 Noted discrepancy between Linux and POSIX.1 when oldpath
569 See: http://bugs.linuxbase.org/show_bug.cgi?id=367
570 and: http://www.opengroup.org/austin/mailarchives/ag/msg08152.html
573 Clarified EXDEV error description: it isn't possible to link
574 across mount points, even if the mount points refer to the same
578 mtk, after note from Gordon Jin
582 As per message from Serguei Leontiev
583 Removed SVr2, AT&T, and BSD from CONFORMING TO, since
584 a pipe on those systems is actually bidirectional.
585 (Pipes are implemented as STREAMS on the former, and
586 sockets on the latter.)
590 Noted kernel version where posix_fadvise() appeared and
591 noted bug in handling of 'len' in kernels < 2.6.6.
595 Clarified EXDEV error description: it isn't possible to rename
596 a file across mount points, even if the mount points refer to
597 the same file system.
601 Noted kernel version numbers for semtimedop().
605 Noted MAX_SEC_IN_JIFFIES ceiling.
606 Added note about treatment of out-of-range tv_usec values.
609 Johan Walles, Martin (Joey) Schulze
610 Added sigqueue.2 to SEE ALSO.
614 Added notes on non-standard behavior: Linux allows 'buf' to
615 be NULL, but POSIX.1 doesn't specify this and it's non-portable.
619 Improved DESCRIPTION; clarified distinction between
624 bcopy() handles overlapping case, but memcpy() does not,
625 so for consistency memmove() should be also mentioned.
628 Martin (Joey) Schulze
629 New link to man3/getmntent.3.
632 Small wording change after suggestion from Sasa Stevanovic.
636 Created as link to strstr.3.
640 Noted that SUSv2 allowed a range of 00 to 61 for %S specifier.
644 Added description of strcasestr().
648 Improved description of read from /dev/urandom.
658 Mention the .URL macro more verbosely.
661 ==================== Changes in man-pages-2.03 ====================
668 The following people contributed notes, ideas, or patches that have
669 been incorporated in changes in this release:
671 Andries Brouwer <Andries.Brouwer@cwi.nl>
672 Joey (Martin) Schulze <joey@infodrom.org>
673 Johannes Nicolai <johannes.nicolai@hpi.uni-potsdam.de>
674 Justin Pryzby <justinpryzby@users.sourceforge.net>
675 Klaus Ethgen <Klaus@Ethgen.de>
676 Pavel Heimlich <tropikhajma@seznam.cz>
677 Ross Boylan <RossBoylan@stanfordalumni.org>
678 Vincent Fourmond <vincent.fourmond@9online.fr>
680 Apologies if I missed anyone!
691 Change `ttys(4)' to `ttyS(4)'.
693 Typographical or grammatical errors have been corrected in several
696 Changes to individual pages
697 ---------------------------
701 Substantially enhanced discussion of CLONE_THREAD.
703 Added CLONE_SYSVSEM, CLONE_UNTRACED, CLONE_STOPPED.
709 Noted effect of ptracing when execing a set-UID program.
712 Johannes Nicolai / mtk
713 Noted F_SETOWN bug for socket file descriptor in Linux 2.4
716 Added text on permissions required to send signal to owner.
720 Noted that lock conversions are not atomic.
724 ru_nswap has never contained useful information.
725 Kernel 2.6.6 clarified that with a patch
726 ("[PATCH] eliminate nswap and cnswap"). See also:
727 http://www.ussg.iu.edu/hypermail/linux/kernel/0404.1/0720.html
731 Clarified wording of the 'pid == -1' case.
735 Added MNT_EXPIRE, plus a few other tidy-ups.
739 Added text to note that sched_setaffinity() will migrate the
740 affected process to one of the specified CPUs if necessary.
742 Added a NOTE to point out that the affinity mask is actually a
743 per-thread attribute that can be adjusted independently for
744 each thread in a thread group.
748 Noted aberrant Linux behavior with respect to new attaches to a
749 segment that has already been marked for deletion.
751 Noted changes in permissions required for SHM_LOCK/SHM_UNLOCK.
755 Noted that the __W* flags can't be used with waitid().
759 Added _CS_GNU_LIBC_VERSION and _CS_GNU_LIBPTHREAD_VERSION.
762 Ross Boylan / Martin Schulze
763 various changes as per
764 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=304242
768 Minor changes to discussion of /proc/PID/stat signal fields.
769 Added 'rt_priority' and 'policy' to /proc/PID/stat.
773 1,$s/inherited/inheritable/g
776 Vincent Fourmond / Joey (Martin) Schulze
777 Removed discussion of `[[:<:]]' and `[[:>:]]' since they do
778 not seem to be in the glibc implementation.
779 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295666
782 Joey (Martin) Schulze / Klaus Ethgen
783 The default zoneinfo directory is now /usr/share/zoneinfo.
784 (was: /usr/local/etc/zoneinfo)
785 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=267471
788 ==================== Changes in man-pages-2.04 ====================
795 The following people contributed notes, ideas, or patches that have
796 been incorporated in changes in this release:
798 Andries Brouwer <Andries.Brouwer@cwi.nl>
799 Baurjan Ismagulov <ibr@ata.cs.hun.edu.tr>
800 Dave Love <d.love@dl.ac.uk>
801 Dieter Brueggemann <dieter.brueggemann@entitec.de>
802 Geoff Clare <gclare@gclare.org.uk>
803 Guido Trotter <ultrotter@debian.org>
804 kabloom <kabloom@ucdavis.edu>
805 Kevin Ryde <user42@zip.com.au>
806 Justin Pryzby <justinpryzby@users.sourceforge.net>
807 Mike Furr <mfurr@debian.org>
808 Olivier Croquette <ocroquette@free.fr>
809 Olivier Guilyardi <ylf@xung.org>
810 Peter Cordes <peter@llama.nslug.ns.ca>
811 Philipp Spitzer <philipp@toastfreeware.priv.at>
812 Tanaka Akira <akr@m17n.org>
813 Thierry Excoffier <exco@bat710.univ-lyon1.fr>
814 Thomas Hood <jdthood@yahoo.co.uk>
815 Vincent Lefevre <vincent@vinc17.org>
816 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
818 Apologies if I missed anyone!
825 For consistency across pages:
827 1,$s/nonzero/non-zero/g
829 Typographical or grammatical errors have been corrected in several
838 An overview of the Linux implementations of POSIX threads.
841 Changes to individual pages
842 ---------------------------
846 Various minor changes.
850 BUGS: In kernels < 2.6.9, EPOLL_CTL_DEL required a non-NULL
851 'event', even though this argument is ignored.
852 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306517
856 Clarified semantics of relationship between flock() locks
857 and open file entries and file descriptors.
858 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=291121
861 Olivier Croquette, Thierry Excoffier
862 Noted the existence of the short sleep bug (up to 1 jiffy).
866 RLIMIT_RSS only has affect "in 2.4.x", not "in 2.4 and later".
870 Since Linux 2.6, the ru_nvcsw and ru_nivcsw fields are used.
874 Rewrote description of return value.
875 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=296183
879 O_DIRECT needs _GNU_SOURCE.
881 O_ASYNC works for pipes and FIFOs in Linux 2.6.
886 Various minor changes.
890 Various minor changes.
893 mtk / Philipp Spitzer
894 Fix description of return value.
895 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308359
899 Changed (char *) to (void *) in example.
900 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313607
904 Make log(3) SEE ALSO log1p(3),
905 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=309578
909 Fix description of RETURN VALUE for makecontext(),
910 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311800
914 Various minor changes.
918 Small fix to a code example,
919 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=194842
923 When specifying resolved_path as NULL, realpath()
924 will (still) only allocate up to PATH_MAX bytes.
925 Plus other minor changes.
926 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239424
930 The required header file for these functions on Linux is <netdb.h>,
931 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311680
935 Arg for %p is a pointer to _a pointer to_ void,
936 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263109
940 freopen() can change the descriptors associated with
941 stdin/stdout/stderr, as per
942 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295859
946 strerror_r(3) requires #define _XOPEN_SOURCE 600,
947 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=290880
951 Fix typo: "_SC_2_DEV" should be "_SC_2_C_DEV".
955 Added pointers under /proc/sys/net to tcp.7 and ip.7.
959 Various wording and formatting fixes.
960 Reordered /proc/sys/net/ipv4/ip_* file descriptions alphabetically.
963 Dieter Brueggemann / mtk
964 Fixes to the discussion of SIOCATMARK and tcp_stdurg.
966 Various wording and formatting fixes.
967 Incorporated some new /proc/sys/net/ipv4/tcp_* file descriptions
968 from the 2.6.12 source file Documentation/networking/ip-sysctl.txt.
971 ==================== Changes in man-pages-2.05 ====================
978 The following people contributed notes, ideas, or patches that have
979 been incorporated in changes in this release:
981 A Costa <agcosta@gis.net>
982 Andries Brouwer <Andries.Brouwer@cwi.nl>
983 Bas Zoetekouw <bas@debian.org>
984 Dan Jacobson <jidanni@jidanni.org>
985 Delian Krustev <krustev@krustev.net>
986 Dora Anna Volgyesi <volgyesi@elte.hu>
987 Martin (Joey) Schulze <joey@infodrom.org>
988 Ove Kaaven <ovek@arcticnet.no>
990 Apologies if I missed anyone!
995 Typographical or grammatical errors have been corrected in several
996 places. (Special thanks to A Costa.)
999 Changes to individual pages
1000 ---------------------------
1004 Reversed 2.04 introduction of the term "process termination
1009 Clarified what type of lock close() affects.
1010 Minor formatting changes.
1014 Consistent use of terms "open file description",
1015 "file status flags", and "file descriptor flags".
1016 Removed mention of lock sharing -- it was not accurate.
1017 Minor formatting fixes.
1021 Consistent use of terms "open file description",
1022 "file status flags", and "file descriptor flags".
1023 Some rewriting of discussion of file descriptor flags
1024 Under F_DUPFD, replaced some text duplicated in dup.2
1025 with a cross ref to dup.2
1026 Minor wording and formatting fixes.
1029 mtk / Martin (Joey) Schulze / Bas Zoetekouw
1030 The return value of isinf() changed in glibc 2.02
1031 to differentiate positive and negative infinity.
1032 See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765
1037 Remove confusing text describing real and effective IDs.
1038 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285852
1042 The short sleep bug (up to 1 jiffy) that was newly noted in
1043 man-pages-2.04 has just been fixed in 2.6.12.
1047 Changed range documented in main text from -20..20 to -20..19.
1048 Noted that the range is -20..20 on some systems.
1052 Clarification of term "open file description" along with
1053 explanation of what information it maintains.
1054 Other wording improvements.
1055 Various minor wording changes.
1059 Reversed 2.04 introduction of the term "process termination
1062 Noted use of atexit() for establishing function to be invoked on
1063 shared library unload.
1064 Noted that atexit()-registered functions are not invoked on
1065 abnormal termination.
1070 Reversed 2.04 introduction of the term "process termination
1073 Minor rewording and formatting changes.
1077 Added #define _BSD_SOURCE to prototype.
1080 Martin (Joey) Schulze
1085 Added definition of Linux dirent structure.
1086 Some formatting cleanups.
1089 Dora Anna Volgyesi / mtk
1090 strtold() and strtof() need _ISOC99_SOURCE or _XOPEN_SOURCE=600
1091 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=246668
1095 New link to tsearch.3.
1099 Added tdestroy to .TH line.
1103 Change "chown root:mem /dev/mem" to "chown root:kmem /dev/mem".
1107 Change "chown root:mem /dev/null /dev/zero" to
1108 "chown root:root /dev/null /dev/zero".
1111 Dan Jacobson / Martin (Joey) Schulze
1112 Replaced "selection(1)" by "gpm(8)" under SEE ALSO
1113 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=253515
1117 SA_SIGACTION should be SA_SIGINFO
1118 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=305369
1125 ==================== Changes in man-pages-2.06 ====================
1127 Released: 2005-07-15
1132 The following people contributed notes, ideas, or patches that have
1133 been incorporated in changes in this release:
1135 Alain Portal <aportal@univ-montp2.fr>
1136 Andries Brouwer <Andries.Brouwer@cwi.nl>
1137 Bhavesh P Davda <bhavesh@avaya.com>
1138 Clau Weber <claus@jambit.com>
1139 Dov Murik <dov@dv-networks.com>
1140 David Lloyd <dlloyd@microbits.com.au>
1141 Frederik Deweerdt <frederik.deweerdt@gmail.com>
1142 Justin Pryzby <justinpryzby@users.sourceforge.net>
1143 Lars Wirzenius <liw@iki.fi>
1144 Martin Pool <mbp@sourcefrog.net>
1145 Mike Frysinger <vapier@gentoo.org>
1146 Petter Reinholdtsen <pere@hungry.com>
1147 Steven Murdoch <Steven.Murdoch@cl.cam.ac.uk>
1148 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1150 Apologies if I missed anyone!
1155 Typographical or grammatical errors have been corrected in several
1158 Many uses of hyphens and dashes were corrected.
1164 canonicalize_file_name.3
1172 AFAIK, this system call has never actually done anything (other
1173 than be a stub) on any Unix.
1175 Changes to individual pages
1176 ---------------------------
1180 Various wording and formatting fixes.
1184 Minor formatting changes
1188 Various minor wording improvements; some formatting fixes
1192 Various wording and formatting fixes.
1196 s/positive/non-negative/ [for file descriptor]
1200 Documented RLIMIT_MSGQUEUE limit.
1201 RLIMIT_RSS ceased to have any effect in 2.4 in kernel 2.4.30.
1202 (It already didn't have any effect in 2.2.x and 2.6.x.)
1203 s/MADVISE_WILLNEED/MADV_WILLNEED/
1207 Removed historic comment on BSD backlog ceiling.
1208 Minor wording and formatting changes.
1212 Added BUG: in some circumstances, a process that is
1213 waiting for a semaphore to become zero is not not woken
1214 up when the value does actually reach zero.
1215 http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2
1216 http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2
1220 Various minor wording improvements
1224 Added mkdir(2) to discussion, made term "file mode creation
1226 Various, mostly small, wording changes
1230 Change description for ESTALE
1231 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=237344
1237 Added SEE ALSO putgrent(3)
1238 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=211336
1244 Lars Wirzenius / mtk
1245 Replace mention of /etc/{passwd,group} by references to
1246 "passwd/group database", and LDAP and NIS.
1247 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
1249 Miscellaneous wording improvements
1250 Consistent DESCRIPTION and ERRORS wording across these pages.
1254 Relocate misplaced text describing gai_strerror().
1258 s/endservent/endnetent/
1259 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316517
1262 Lars Wirzenius / mtk
1263 Replace mention of /etc/shadow by references to
1264 "shadow password database", and LDAP and NIS.
1265 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
1267 Miscellaneous wording improvements
1268 Consistent DESCRIPTION wording vis-a-vis getpwnam.3 etc.
1272 Fix hsearch_r() prototype
1276 Fix description of RETURN VALUE
1277 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=317037
1279 various parts substantially rewritten; added description of
1280 %n$ form; various text incorporated from the GNU C library
1281 documentation ((C) The Free Software Foundation).
1285 Modified details of how user and group ownership of a new
1287 Various minor wording and formatting cleanups.
1291 tweaked the short description to include definition of 'ELF'
1292 add ELFOSABI_NONE to the ELFOSABI_ list
1293 tweak/add more machines to EM_ list for ehdr->e_machine
1294 fix indenting to be consistent
1295 tweak the display of the ELF_ST_* macros
1296 document the Elf_Dyn structure
1300 Updated discussion of /proc/stat.
1301 Added text on the /proc/sys/fs/mqueue/* files.
1305 Change protocol in UDP prototype.
1306 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182635
1310 The first sentence under NOTES about SO_KEEPALIVE and SIGPIPE
1311 makes no grammatical sense (and possibly also no technical sense).
1312 It has been removed.
1315 ==================== Changes in man-pages-2.07 ====================
1317 Released: 2005-07-19
1322 The following people contributed notes, ideas, or patches that have
1323 been incorporated in changes in this release:
1325 Andries Brouwer <Andries.Brouwer@cwi.nl>
1326 Mike Frysinger <vapier@gentoo.org>
1328 Apologies if I missed anyone!
1335 The terms "set-user-ID" and "set-group-ID" are now used
1336 consistently (no abbreviations) across all manual pages.
1340 Consistent use of "saved set-user-ID" and "saved set-group-ID"
1341 (no more "saved user ID", "saved effective UID",
1342 saved group ID", etc.)
1346 Global fixes in textual descriptions:
1355 Consistent use of st_atime, st_ctime, st_mtime, with
1356 explanatory text, instead of atime/ctime/mtime.
1360 Classical BSD versions are now always named x.yBSD (formerly
1361 there was a mix of x.yBSD and BSD x.y).
1363 Typographical or grammatical errors have been corrected in several
1367 Changes to individual pages
1368 ---------------------------
1376 Improve description of st_dev and st_rdev.
1378 Various wording and formatting improvements.
1382 Some formatting fixes
1385 ==================== Changes in man-pages-2.08 ====================
1387 Released: 2005-09-21
1392 The following people contributed notes, ideas, or patches that have
1393 been incorporated in changes in this release:
1395 Adrian Bunk <bunk@stusta.de>
1396 Alain PORTAL <aportal@univ-montp2.fr>
1397 Andrew Pimlott <andrew@pimlott.net>
1398 Andries Brouwer <Andries.Brouwer@cwi.nl>
1399 Baurzhan Ismagulov <ibr@radix50.net>
1400 Bernhard R. Link <brlink@debian.org>
1401 Bodo Stroesser <bstroesser@fujitsu-siemens.com>
1402 David N. Welton <davidw@eidetix.com>
1403 Dov Murik <dov@dv-networks.com>
1404 Heikki Orsila <shd@modeemi.cs.tut.fi>
1405 Hasso Tepper <hasso@estpak.ee>
1406 Hrvoje Niksic <hniksic@xemacs.org>
1407 Justin Pryzby <justinpryzby@users.sourceforge.net>
1408 Ludovic Courtes <ludovic.courtes@laas.fr>
1409 Mike Frysinger <vapier@gentoo.org>
1410 Nicolas François <nicolas.francois@centraliens.net>
1411 Norbert Buchmuller <norbi.spam@nix.hu>
1412 Paul Brook <paul@nowt.org>
1413 Ramiro Aceves <ea1abz@gmail.com>
1414 Tommy Pettersson <ptp@lysator.liu.se>
1415 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1417 Apologies if I missed anyone!
1424 RFC references are now always written as "RFC\ nnn"
1425 (not "RFC nnn" or "RFCnnn").
1427 Typographical or grammatical errors have been corrected in several
1431 Changes to individual pages
1432 ---------------------------
1436 To get an effect like "-h", BLOCKSIZE must start with "human",
1441 s/standard output/standard error/
1445 Fix small error in description of CLONE_PARENT_SETTID
1450 See http://lkml.org/lkml/2005/7/12/254
1454 Expanded discussion of relationship between user and kernel
1455 representations of the nice value.
1457 Added discussion of RLIMIT_NICE and a cross reference to
1458 getrlimit.2 under the description of the EACCES error.
1460 Noted 2.6.12 change in credentials checking for setpriority().
1464 Added description of RLIMIT_RTPRIO
1466 Added description of RLIMIT_NICE
1470 Noted bug in MAP_POPULATE for kernels before 2.6.7.
1474 Added _GNU_SOURCE to prototype.
1475 Rewrote description of MREMAP_MAYMOVE.
1476 Rewrote description of EAGAIN error.
1477 Added discussion of resizing of memory locks.
1478 Added entries to SEE ALSO.
1479 Some formatting fixes.
1483 Added IPC_INFO, MSG_INFO, MSG_STAT descriptions.
1487 Add to prototype: define _POSIX_C_SOURCE 199309
1488 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=314435
1492 Added sentence noting that range of the nice value is described
1494 Added cross-reference to setrlimit(2) for discussion on
1498 David N. Welton / Justin Pryzby / mtk
1499 Clarified the order of value and port arguments;
1500 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263756
1504 Added SEE ALSO for sigsuspend.2
1505 Some formatting fixes.
1509 nfds should be prototyped as nfds_t
1510 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=322934
1513 Some wording and formatting improvements.
1517 Since kernel 2.6.13 PR_SET_DUMPABLE can also have the value 2.
1521 Remove misleading text describing FreeBSD's sranddev() function.
1522 As per debian bug 328629
1526 Added LINUX NOTES on trickery performed by glibc when
1527 vector size exceeds IOV_MAX.
1529 Formatting clean-ups.
1533 Added text to note that start and size are both rounded downwards.
1537 Modified discussion of privileges; added pointer to
1538 sched_setscheduler.2 for a discussion of privileges and
1541 sched_setscheduler.2
1543 Modified discussion of privileges; added discussion of RLIMIT_RTPRIO.
1547 Added IPC_INFO, SEM_INFO, SEM_STAT descriptions.
1551 Added IPC_INFO, SHM_INFO, SHM_STAT descriptions.
1555 Split sigpending(), sigprocmask(), and sigsuspend() out
1556 into separate new pages.
1561 NOTES: described SA_NODEFER / sa_mask bug which was present in
1562 all kernels up to and including 2.6.13.
1563 See http://marc.theaimsgroup.com/?l=linux-kernel&m=112360948603171&w=2
1564 and http://marc.theaimsgroup.com/?l=linux-kernel&m=112362164911432&w=2
1566 Subject: Signal handling possibly wrong
1567 From: Bodo Stroesser
1568 Date: 2005-08-09 17:44:06
1572 Updated SEE ALSO to reflect splitting of sigaction.2 into
1573 sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2
1577 New page created by splitting out from sigaction.2
1578 Changed CONFORMING TO.
1582 New page created by splitting out from sigaction.2
1583 Added text on effect of NULL for 'set' argument.
1584 Added text noting effect of ignoring SIGBUS, SIGFPE, SIGILL,
1586 Noted that sigprocmask() can't be used in multithreaded process.
1587 Fixed EINVAL error diagnostic.
1588 Changed CONFORMING TO.
1592 New page created by splitting out from sigaction.2
1593 Added NOTES on usage.
1594 Added new text to DESCRIPTION.
1595 Changed CONFORMING TO.
1599 Improve st_blocks description.
1604 One has carg(z) = atan(creal(z) / cimag(z))
1606 One has tan(carg(z)) = cimag(z) / creal(z)
1608 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=326720
1612 s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name)
1616 s/-nostartupfiles/-nostartfiles/
1620 Nowadays (since 2.3.4) glibc only sets the first ai_canonname
1621 field if AI_CANONNAME was specified (the current behavior
1622 is all that SUSv3 requires).
1626 Added descriptions of AI_ALL, AI_ADDRCONFIG, AI_V4MAPPED,
1629 Some wording and formatting fixes.
1632 Bernhard R. Link / mtk
1633 Add NOTES text describing relationship of pw_dir and HOME and
1634 pointing out that applications should preferentially inspect HOME.
1638 Mention "little endian" and "big endian".
1639 Added note about octal and hex interpretation of
1640 numbers-and-dots notation.
1643 mtk / Ludovic Courtes
1644 Commented out references to rpc_secure(3) -- we don't currently
1645 have such a page in the man-pages set.
1646 In response to http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=325115
1650 glibc 2.3.4 fixed the "name contains '='" bug.
1654 Added "#define _GNU_SOURCE" to prototype.
1657 Norbert Buchmuller / mtk
1658 Added text noting that the use or real-root-dev for changing
1659 the root device is obsolete, in favor of pivot root.
1660 (However, the page still needs to be rewritten to actually
1661 describe the pivot_root method...)
1662 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=323621
1666 Improve text describing /proc/sys/fs/mqueue/* files.
1668 Describe /proc/sys/fs/suid_dumpable (new in 2.6.13).
1670 Added placeholder mention of /proc/zoneinfo (new in 2.6.13).
1671 More needs to be said about this file.
1673 Repaired earlier cut and paste mistake which resulted
1674 in part of the text of this page being duplicated.
1678 Added text on biarch details for ut_session and ut_tv.
1682 Added CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE.
1685 mtk / Andrew Pimlott
1686 Add a couple of words to make it clear that port is a 16-bit number.
1687 Reformat long source lines (no text changed).
1689 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1692 Fix discussion of IPC_RECVTTL / IP_TTL.
1696 Updated SEE ALSO to reflect splitting of sigaction.2 into
1697 sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2.
1701 Clarified details of use of SO_PEERCRED.
1705 s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name)
1706 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1710 Added description of UDP_CORK socket option.
1712 s/SOL_UDP/IPPROTO_UDP/ (POSIX standard name)
1713 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1716 ==================== Changes in man-pages-2.09 ====================
1718 Released: 2005-10-13
1723 The following people contributed notes, ideas, or patches that have
1724 been incorporated in changes in this release:
1726 Justin Pryzby <pryzbyj@justinpryzby.com>
1727 Peter Chubb <peterc@gelato.unsw.edu.au>
1728 Samuel Thibault <samuel.thibault@ens-lyon.org>
1729 Tomas Pospisek <tpo_deb@sourcepole.ch>
1730 Trond Myklebust <trond.myklebust@fys.uio.no>
1732 Apologies if I missed anyone!
1746 Added SEE ALSO for new pty.7 page.
1748 Typographical or grammatical errors have been corrected in several
1757 Overview of Unix 98 and BSD pseudo-terminals.
1760 Changes to individual pages
1761 ---------------------------
1765 Remove "-V" option (fix from Fedora man-pages-2.07-7).
1768 Peter Chubb / Trond Myklebust / mtk
1769 Since kernel 2.6.10, a read lease can only be placed on a
1770 file descriptor that is opened read-only.
1771 See the following LKML thread of Aug 2005
1772 ("fcntl(F GETLEASE) semantics??"):
1773 http://marc.theaimsgroup.com/?l=linux-kernel&m=112371777712197&w=2
1774 http://marc.theaimsgroup.com/?l=linux-kernel&m=112374818213000&w=2
1775 http://marc.theaimsgroup.com/?l=linux-kernel&m=112376335305284&w=2
1776 http://marc.theaimsgroup.com/?l=linux-kernel&m=112377294030092&w=2
1780 Add new text to ENOMEM error.
1784 Added description of MREMAP_FIXED and 'new_address' argument
1786 Revised text of EINVAL error.
1789 Samuel Thibault / mtk
1790 read() can fail with EINVAL when using O_DIRECT
1792 Added open(2) to SEE ALSO.
1796 s/int/size_t/ for type of 'size' argument (fix from
1797 Fedora man-pages-2.07-7).
1800 Samuel Thibault / mtk
1801 write() can fail with EINVAL when using O_DIRECT
1805 Fix: s/acosh/atanh/ (fix from Fedora man-pages-2.07-7).
1809 Improved "a+" description (fix from Fedora man-pages-2.07-7).
1813 s/getrpcent/setrpcent/ (fix from Fedora man-pages-2.07-7).
1817 Removed references to fropen() and fwopen(), which are
1818 BSDisms that don't appear in glibc.
1819 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=331174
1823 Typo fix: %Ry ==> %Ey [SUSv3 mentions...] (fix from
1824 Fedora man-pages-2.07-7).
1828 s/network/networks/ (fix from Fedora man-pages-2.07-7).
1832 Added description of /proc/sys/vm/legacy_va_layout.
1836 Update description of SO_RCVLOWAT and SO_SNDLOWAT.
1837 (fix derived from Fedora man-pages-2.07-7).
1840 ==================== Changes in man-pages-2.10 ====================
1842 Released: 2005-10-19
1847 The changes in this release consist *solely* of formatting fixes, with
1848 the aim bringing greater consistency to the manual pages according to
1849 the following rules:
1851 -- Function name references should *always* be followed by
1852 parentheses, "()" (possibly containing a manual page section
1855 -- The parentheses following a function name should *not* be
1856 formatted. Thus, for example, instead of:
1864 Much of the change was automated using two scripts:
1865 add_parens_for_own_funcs.sh and unformat_parens.sh.
1866 For the (possible) benefit of downstream manual page maintainers and
1867 translators, I have placed these scripts in a new subdirectory 'scripts'.
1869 NOTE THE FOLLOWING POINTS WELL:
1871 -- These scripts provide a computer-assisted solution to the above
1872 two goals. However, they are not perfect, and their output should
1873 be scanned by a human. (To see what changes the two scripts
1874 *would* make, without making them, use the "-n" command line option.)
1876 -- The scripts do not fix all instances that violate the above rules:
1877 some manual fixes are required. Two further scripts are provided
1878 to help find remaining instances of function names without
1879 following "()": find_dots_no_parens.sh and find_slashes_no_parens.sh.
1881 The following changes were made:
1883 -- add_parens_for_own_funcs.sh was applied to the pages in Sections
1886 -- unformat_parens.sh was applied to pages in Sections 2, 3, 4, and 7
1887 (the only sections where such changes were required).
1889 -- further changes (not so very many) were performed by hand.
1890 (found places to fix with the assistance of find_dots_no_parens.sh
1891 and find_slashes_no_parens.sh).
1894 ==================== Changes in man-pages-2.11 ====================
1896 Released: 2005-10-24
1901 The following people contributed notes, ideas, or patches that have
1902 been incorporated in changes in this release:
1904 Alain PORTAL <aportal@univ-montp2.fr>
1906 Apologies if I missed anyone!
1913 Most instances of the constant "NULL" are not formatted (bolded) in
1914 man pages, but a few are. For consistency, formatting on "NULL" has
1915 been removed where it occurred.
1917 Many minor formatting fixes were made.
1919 Typographical or grammatical errors have been corrected in several
1923 Changes to individual pages
1924 ---------------------------
1928 Added EINVAL error for rlim_cur > rlim_max when calling setrlimit().
1932 Repaired discussion of capabilities and file system UID, which
1933 mistakenly had involved exec() in the discussion.
1937 Removed text saying there is no library interface. There
1942 Minor change to RETURN VALUE text.
1953 ==================== Changes in man-pages-2.12 ====================
1955 Released: 2005-10-31
1960 The following people contributed notes, ideas, or patches that have
1961 been incorporated in changes in this release:
1963 Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
1964 Andries Brouwer <Andries.Brouwer@cwi.nl>
1965 Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
1966 herbert <herbert@gondor.apana.org.au>
1967 Martin Landers <martin.landers@treibgut.net>
1968 Michael Benedict <benedict@starbak.net>
1970 Apologies if I missed anyone!
1975 Typographical or grammatical errors have been corrected in several
1979 Changes to individual pages
1980 ---------------------------
1984 Reworded text around PAGESIZE, noting also that
1985 sysconf(_SC_PAGESIZE) can be used.
1989 Removed words "as well" (added in 2.11) from the phrase
1990 "and it gets these last five capabilities if its fsuid is 0 as well"
1991 since there are (unusual) situations in which fsuid can be 0 while
1992 the effective UID is not.
1994 Reworked (cut down) discussion of capabilities, moving part of
1995 it into capabilities.7
1999 Add text to note that setresuid() always modifies the file
2000 system UID, and setresgid() likewise always modifies the file
2005 Added (brief) description of SHM_HUGETLB.
2008 mtk / Martin Landers
2009 Noted that ss_sp is automatically aligned by the kernel.
2012 Brian M. Carlson / herbert
2013 Change <netinet/in.h> to <arpa/inet.h> in prototype; add text
2014 explaining that some systems need the former header.
2015 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=265244
2019 Reworked part of the discussion of exec() and capabilities.
2020 Added sub-section "Effect of User ID Changes on Capabilities".
2021 Reworked discussion of CAP_SYS_ADMIN and file-max.
2024 ==================== Changes in man-pages-2.13 ====================
2026 Released: 2005-11-03
2028 This release consists entirely of formatting and typographical fixes.
2033 Typographical or grammatical errors have been corrected in several
2038 Function and page cross references that were italicized were
2039 made bold (which is how the majority of function and page
2040 cross references were already done).
2044 Instances of things like "NULL-terminated string" were changed to
2045 "null-terminated string".
2049 Pathnames, structures, arguments, and <header-files> that were
2050 bold were changed to italics.
2054 Instances of the constant "NULL" that were bold-faced were made
2055 unformatted (which is how most instances of "NULL" were already
2059 ==================== Changes in man-pages-2.14 ====================
2061 Released: 2005-11-17
2066 The following people contributed notes, ideas, or patches that have
2067 been incorporated in changes in this release:
2069 Angelo <ang3l0@katamail.com>
2070 Avery Pennarun <apenwarr@nit.ca>
2071 Justin Pryzby <justinpryzby@users.sourceforge.net>
2072 Martin (Joey) Schulze <joey@infodrom.org>
2073 Stefan Brüns <stefan.bruens@rwth-aachen.de>
2074 Volker Reichelt <reichelt@igpm.rwth-aachen.de>
2076 Apologies if I missed anyone!
2081 Typographical or grammatical errors have been corrected in several
2089 This page is taken as is from the FreeBSD 5.4 distribution.
2090 (Not checked against Linux reality, but likely things are
2092 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=336875
2094 Changes to individual pages
2095 ---------------------------
2099 Updated discussion about lack of prototype in glibc.
2103 Improved description of E2BIG error: it relates to the sum
2104 of the bytes in both environment and argument list.
2108 Clarified parts of the discussion of file leases,
2109 noting effect of open(O_NONBLOCK), interruption
2110 by signal handler, or termination by signal in
2111 lease breaker. In response to
2112 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=339037
2116 Added LINUX NOTES describing nanosecond timestamps.
2119 Volker Reichelt / mtk
2120 Fixed to point out that that frexp() returns a number whose
2121 *absolute* value is >= 0.5 and < 1. Amended the example
2122 program to demonstrate this.
2125 mtk / Avery Pennarun
2126 Add EWOULDBLOCK error for file leases.
2128 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=339037
2132 Although the glibc implementation returns -1 on error (and some
2133 other man pages (e.g., the BSDs) also document that value for
2134 error returns), SUSv3 merely says "non-zero" (and this is
2135 what manual pages on many implementations also say).
2139 Formerly, the page said that all systems declare memalign() in
2140 <malloc.h>. In fact, many declare it in <stdlib.h>.
2144 Almost a complete rewrite after Angelo pointed out
2145 that the existing page was deficient.
2149 Remove SEE ALSO for nonexistent scsi.4.
2153 Updated discussion of /proc/sys/kernel/pid_max.
2157 Added pthreads.7 to SEE ALSO.
2161 Fix typo: s/LD_DEBUG_OUTPUT/LD_PROFILE_OUTPUT/
2164 ==================== Changes in man-pages-2.15 ====================
2166 Released: 2005-11-30
2171 The following people contributed notes, ideas, or patches that have
2172 been incorporated in changes in this release:
2174 Andries Brouwer <Andries.Brouwer@cwi.nl>
2175 James Vega <jamessan@debian.org>
2176 Malcolm Scott <mas90@io.malc.org.uk>
2177 Senthil Kumar <senthilkumar_sen@hotpop.com>
2179 Apologies if I missed anyone!
2184 Typographical or grammatical errors have been corrected in several
2190 sigvec.3 -- for details, see below.
2192 sigset.3 -- for details, see below.
2194 Changes to individual pages
2195 ---------------------------
2199 Added text describing the 2.6.[0-7] EPERM bug that occurred
2200 when sending signals to a process group.
2204 Noted that si_signo is unused on Linux.
2208 Added BUGS noting wrapper function problem that existed
2209 in glibc versions <= 2.2.1.
2213 Moved to section 3; see also sigpause.3 below.
2217 Added a GLIBC NOTES section describing sigisemptyset(),
2218 sigandset(), and sigorset().
2223 These pages have been deleted, and replaced by a new sigvec.3
2224 man page that more fully describes the BSD signal API.
2230 These links to the now-deleted sigblock.2 have been also been
2231 deleted. They are replaced by corresponding links in Section 3:
2232 sigmask.3, sigsetmask.3, siggetmask.3.
2236 This new page is provides a fuller description of the
2237 BSD signal API than was provided in the now-deleted sigvec.2
2245 Created as links to sigvec.3.
2249 Moved here from Section 2.
2251 Some minor wording fixes; clarified System V origins of
2252 X/Open flavor of this function.
2256 New page describing the System V signal API: sigset(), sighold(),
2257 sigrelse(), sigignore().
2261 Add further text clarifying that %+ specifier is not supported in
2264 Added GLIBC NOTES section describing optional 'flag' and 'width'
2265 components of conversion specifiers.
2266 Some wording changes to bring terminology closer to SUSv3.
2267 Added an example program.
2271 Add as new link to vm86.2.
2275 Added a few words to reflect the fact that several of the section
2276 7 pages provide overviews of various topics.
2280 Added some SEE ALSO entries.
2284 Added text noting that select()/poll() do not respect SO_RCVLOWAT.
2288 s/tcp_socket/udp_socket/ in example
2289 Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=340927
2292 ==================== Changes in man-pages-2.16 ====================
2294 Released: 2005-12-02
2299 The following people contributed notes, ideas, or patches that have
2300 been incorporated in changes in this release:
2302 Alan Stern <stern@rowland.harvard.edu>
2303 Andries Brouwer <Andries.Brouwer@cwi.nl>
2304 Urs Thuermann <urs@isnogud.escape.de>
2306 Apologies if I missed anyone!
2311 Typographical or grammatical errors have been corrected in several
2315 Changes to individual pages
2316 ---------------------------
2320 Added instructions for finding maintainer in Debian package.
2324 Added NOTES about INFTIM constant provided on some other
2329 The -1 error return of shmat() should be cast "(void *)".
2333 Remove junk text (actually intended as source code comment
2338 Fix a typo: s/SOCK_RAW/SOCK_PACKET/
2342 Clarification: s%SOCK_PACKET%PF_INET/SOCK_PACKET%
2345 ==================== Changes in man-pages-2.17 ====================
2347 Released: 2005-12-13
2352 The following people contributed notes, ideas, or patches that have
2353 been incorporated in changes in this release:
2355 Justin Pryzby <justinpryzby@users.sourceforge.net>
2356 Michael Haardt <michael@moria.de>
2357 Urs Thuermann <urs@isnogud.escape.de>
2358 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2360 Apologies if I missed anyone!
2366 Typographical or grammatical errors have been corrected in several
2375 New documentation for the glibc-specific fmemopen() and
2376 open_memstream(). Based on glibc info page.
2379 mtk (with prompting and suggestions for improvements by
2381 New page providing overview of pipes and FIFOs.
2384 Changes to individual pages
2385 ---------------------------
2389 Added notes on how to write example programs for manual pages.
2393 Added pointers to examples of fork() in wait.2 and pipe.2.
2397 Added an example program.
2398 Added SEE ALSO for new pipe.7 page.
2402 Added example program demonstrating use of fork() and waitpid().
2406 Delete line that should have been deleted when applying
2407 2.08 fix for this page.
2411 Rearranged EAI_* list alphabetically.
2415 Added GLIBC NOTES describing feature test macros required
2416 to expose declaration of inet_aton().
2420 New link to new fmemopen.3.
2424 Added SEE ALSO for new pipe.7 page.
2428 Removed BROWSER, since it seems not in fact to be common.
2432 Added documentation of SO_TIMESTAMP.
2436 Noted 200 millisecond ceiling imposed on TCP_CORK.
2440 Rearranged options into something approximating alphabetical order.
2443 ==================== Changes in man-pages-2.18 ====================
2445 Released: 2005-12-15
2450 The following people contributed notes, ideas, or patches that have
2451 been incorporated in changes in this release:
2453 Justin Pryzby <justinpryzby@users.sf.net>
2454 Karsten Sperling <karsten.sperling@stud.uni-karlsruhe.de>
2455 Martin (Joey) Schulze <joey@infodrom.org>
2456 Mike Frysinger <vapier@gentoo.org>
2457 Stefan Puiu <stefanpuiuro@yahoo.com>
2459 Apologies if I missed anyone!
2465 Typographical or grammatical errors have been corrected in several
2469 Changes to individual pages
2470 ---------------------------
2474 Added mention of AF_INET6 address family.
2475 Added discussion of sockaddr structure and an example in the
2480 Put 'flags' list in alphabetical order.
2484 Added cross-reference from discussion of MSG_MORE to UDP_CORK
2487 Put 'flags' list in alphabetical order.
2491 Added CONFORMING TO section noting that these are
2492 non-standard BSDisms.
2496 Added SEE ALSO for err.3.
2497 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
2500 Martin (Joey) Schulze / mtk
2501 Added references to nsswitch.conf(5); remove cross references
2503 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308397
2507 Added SEE ALSO for err.3 .
2508 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
2511 mtk / Martin (Joey) Schulze
2512 Remove cross references to resolv+(8); add cross references to
2514 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=214892
2516 Added SEE ALSO entry for resolver(5);
2517 see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=251122
2521 Rewrote and extended the discussion of the two flavors of
2522 strerror_r(), and added some additional information on
2525 Added SEE ALSO for err.3, as per
2526 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
2531 Fix three typos in identifier names.
2535 The + operator should be in the list of unary operators.
2539 Small wording changes around discussion of SO_BSDCOMPAT.
2540 Fixed a couple of wording errors elsewhere.
2541 Reformatted some long lines.
2544 mtk, after a note by Stefan Puiu
2545 Updated discussion of SO_BSDCOMPAT.
2547 Reformatted some long lines.
2549 Noted the Linux-specific feature whereby setsockopt() doubles
2550 the value given for SO_SNDBUF and SO_RCVBUF.
2552 Noted kernel-imposed minimum values for SO_SNDBUF and SO_RCVBUF.
2555 mtk, after a note by Stefan Puiu
2556 Updated discussion of SO_BSDCOMPAT.
2560 Added new (UN)SUPPORTED FEATURES section in which it is noted
2561 that Unix domain sockets do not support MSG_OOB or MSG_MORE.
2563 Noted details of SO_SNBUF and SO_RCVBUF support for
2564 Unix domain sockets.
2567 ==================== Changes in man-pages-2.19 ====================
2569 Released: 2005-12-23
2574 The following people contributed notes, ideas, or patches that have
2575 been incorporated in changes in this release:
2577 Andries Brouwer <Andries.Brouwer@cwi.nl>
2578 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2579 Stefan Puiu <stefanpuiuro@yahoo.com>
2581 Apologies if I missed anyone!
2587 Typographical or grammatical errors have been corrected in several
2591 Changes to individual pages
2592 ---------------------------
2600 Remove text under EINVAL error: "This may change in the future:
2601 see linux/unix/sock.c for details." This behavior has been
2602 unchanged for a long time, and seems unlikely to change.
2604 Add EADDRINUSE to errors.
2608 Add cmsg(3) to SEE ALSO.
2612 Added description of 'x' mode character (exclusive open).
2616 Some wording changes to description of pipes.
2619 ==================== Changes in man-pages-2.20 ====================
2621 Released: 2006-01-03
2626 Typographical or grammatical errors have been corrected in several
2630 Changes to individual pages
2631 ---------------------------
2635 Added some text to explain the usual scenario in which
2636 sigaltstack() is employed.
2640 Noted that this function is available since glibc 2.2.
2648 Noted that capability bounding set appeared with kernel 2.2.11.
2663 The only changes to these pages have been for formatting:
2664 -- Structure definitions were changed to K&R style
2665 -- Some long source lines were broken to fit into ~70
2667 No changes were made to the content of these pages (yet...).
2670 ==================== Changes in man-pages-2.21 ====================
2672 Released: 2006-01-16
2677 The following people contributed notes, ideas, or patches that have
2678 been incorporated in changes in this release:
2680 Andries Brouwer <Andries.Brouwer@cwi.nl>
2681 Falk Hueffner <falk@debian.org>
2682 Mike Frysinger <vapier@gentoo.org>
2683 Senthil Kumar <senthilkumar_sen@hotpop.com>
2684 Stefan Puiu <stefanpuiuro@yahoo.com>
2686 Apologies if I missed anyone!
2693 truncate.2 gethostname.2 lseek.2 listxattr.2 readlink.2
2694 sysfs.2 stat.2 ustat.2 uname.2 getdomainname.2
2695 argz_add.3 asprintf.3 confstr.3 bstring.3 bzero.3 dlopen.3 fwide.3
2696 gethostbyname.3 getline.3 getlogin.3 getnameinfo.3 getpass.3 hsearch.3
2697 perror.3 printf.3 readdir.3 scanf.3 stpcpy.3 strdup.3 strfmon.3
2698 strftime.3 string.3 strptime.3 sysconf.3 termios.3 ttyname.3
2699 dsp56k.4 tty_ioctl.4
2700 elf.5 proc.5 termcap.5
2703 Various pages use inconsistent terms for 'null byte' (which
2704 is the C99/SUSv3 term for the '\0' character).
2706 To rectify this the following changes were made in the above
2709 Replace 'zero byte' with 'null byte'.
2710 Replace 'null character' with 'null byte'.
2711 Replace 'nulls' with 'null bytes'.
2712 Replace 'NUL-terminated' by 'null-terminated'.
2713 Replace 'NUL' by 'null byte'.
2714 Replace 'terminating NUL' by 'terminating null byte'.
2715 Replace 'final NUL' by 'terminating null byte'.
2716 Replace 'NUL character' by 'null byte'.
2720 Replace "SysV"/"SYSV" by "System V".
2722 Typographical or grammatical errors have been corrected in several
2726 Changes to individual pages
2727 ---------------------------
2731 Noted bug that could wrongly cause EPERM in unprivileged
2732 capset() with 'pid' field == getpid().
2736 Noted that EPOLLONESHOT was added in 2.6.2.
2740 Added GLIBC NOTES describing operation of glibc's
2741 gethostname() wrapper function.
2744 mtk / Mike Frysinger
2745 Clarify relationship between mmap2(2) and mmap64(3).
2747 A few other small rewordings.
2755 Added BUG noting that O_ASYNC can't be enabled via
2756 open(): fcntl() must be used for this purpose.
2760 Relocate misplaced discussion of MSG_DONTWAIT.
2764 Rewrote discussion of dlopen() 'flag' argument;
2765 added descriptions of RTLD_NOLOAD, RTLD_DELETE,
2768 Noted use of atexit() to register a function that is
2769 automatically called when a library is unloaded.
2773 Rewrote substantial parts of the page, and relicensed under GPL.
2777 Add RETURN VALUE section.
2781 Noted historical use of <stdio.h> to declare getopt().
2785 Clarify how strcmp() should be used as the 'compar'
2786 function by providing an example.
2787 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=348072
2791 Noted that /proc/mounts is pollable since kernel 2.6.15.
2793 Documented /proc/PID/task.
2795 Noted that the contents of /proc/PID/{cwd,exe,fd,root,task}
2796 are not available if the main thread has terminated.
2799 Add pointer to random(4) for description of files under
2800 /proc/sys/kernel/random.
2804 Small rewording of discussion of SO_BSDCOMPAT
2805 (add cross-ref to socket(7)).
2808 ==================== Changes in man-pages-2.22 ====================
2810 Released: 2006-02-02
2815 The following people contributed notes, ideas, or patches that have
2816 been incorporated in changes in this release:
2818 Alain Portal <aportal@univ-montp2.fr>
2819 Andre Noll <maan@systemlinux.org>
2820 Andries Brouwer <Andries.Brouwer@cwi.nl>
2821 Colin Tuckley <colin@tuckley.org>
2822 Stefan Puiu <stefanpuiuro@yahoo.com>
2823 Thomas Hood <jdthood@yahoo.co.uk>
2824 Thorsten Kukuk <kukuk@suse.de>
2825 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2831 Typographical or grammatical errors have been corrected in several
2834 Changes to individual pages
2835 ---------------------------
2839 Noted that portable applications should specify fd as -1
2840 when using MAP_ANONYMOUS.
2841 Some rewriting of description of MAP_ANONYMOUS.
2845 New link to sigreturn.2.
2849 New link to sigsuspend.2.
2853 Noted that waitid() does not set infop->si_uid field on
2854 most other implementations.
2858 Make clear that when calling getopt_long() and there are no
2859 short options, then 'optstring' should be "", not NULL.
2863 In glibc 2.0.92, openpty() was modified to preferably open
2864 Unix 98 ptys instead of BSD ptys.
2868 Small rewording under EXAMPLES.
2873 s/string must begin/string may begin/
2877 Documented inotify files under /proc/sys/fs/inotify:
2878 max_queued_events, max_user_instances, and max_user_watches.
2881 ==================== Changes in man-pages-2.23 ====================
2883 Released: 2006-02-10
2888 The following people contributed notes, ideas, or patches that have
2889 been incorporated in changes in this release:
2891 Andi Kleen <ak@muc.de>
2892 Britton Leo Kerin <bkerin_rb@letterboxes.org>
2893 Dan Jacobson <jidanni@jidanni.org>
2894 Justin Pryzby <justinpryzby@users.sourceforge.net>
2895 Luc Van Oostenryck <lkml@looxix.net>
2896 Kurt Wall <kwall@kurtwerks.com>
2897 Martin (Joey) Schulze <joey@infodrom.org>
2898 Matthias Andree <matthias.andree@gmx.de>
2899 Robert Love <rlove@rlove.org>
2900 Samuel Thibault <samuel.thibault@ens-lyon.org>
2901 Urs Thuermann <urs@isnogud.escape.de>
2903 Apologies if I missed anyone!
2908 Typographical or grammatical errors have been corrected in several
2918 Robert Love, with some additions by mtk.
2919 New pages describing the inotify API.
2924 Andi Kleen, with additional work by mtk
2925 New pages describing the NUMA memory allocation policy API.
2926 Drawn from the set at ftp://ftp.suse.com/pub/people/ak/numa.
2929 Urs Thuermann, with additional work by mtk
2930 New page describing the real-time clock driver.
2934 Overview of the inotify API.
2936 Changes to individual pages
2937 ---------------------------
2941 On x86, clone() should not be called through vsyscall,
2942 but directly through "int $0x80".
2946 Small wording changes.
2948 Added cross-ref to inotify.7 under the description of dnotify.
2951 mtk / Britton Leo Kerin
2952 Small wording change under NOTES to clarify
2953 what happens when a process sends a signal to itself.
2954 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=350236
2957 mtk / Matthias Andree
2958 Added BUGS txt on interaction between MCL_FUTURE and
2960 See the following LKML thread:
2961 http://marc.theaimsgroup.com/?l=linux-kernel&m=113801392825023&w=2
2962 "Rationale for RLIMIT_MEMLOCK"
2965 mtk / Samuel Thibault
2966 Rewrote declaration of 'msgp' to be "void *" in response
2967 to http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=350884
2968 Various other wording fixes.
2972 Clarify distinction between "file creation flags" and
2973 "file status flags".
2977 Add SEE ALSO for pread(2).
2978 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351873
2986 Added return types to prototypes for FD_SET(), FD_CLR(),
2987 FD_ZERO, and FD_ISSET().
2988 Other minor wording changes.
2992 Add SEE ALSO for pwrite(2).
2993 (Analogous with read.2 change above.)
2997 Add Linux specific errors to this page.
3001 Added cross-ref to locale.7 for 'struct lconv' defn.
3002 Other minor wording changes.
3003 Martin (Joey) Schulze
3004 Added SEE ALSO refs for nl_langinfo.3
3005 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351831
3009 Minor formatting & wording fixes.
3012 Martin (Joey) Schulze
3013 Added SEE ALSO refs for nl_langinfo.3
3014 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351831
3018 Migrated description of inotify files to the new inotify.7 page.
3022 Add text describing characters 001 to 037.
3023 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=342173
3027 Minor wording and formatting changes.
3030 ==================== Changes in man-pages-2.24 ====================
3032 Released: 2006-02-17
3037 The following people contributed notes, ideas, or patches that have
3038 been incorporated in changes in this release:
3040 Joerg Habenicht <habenich@planetserver.com>
3041 Luc Van Oostenryck <lkml@looxix.net>
3042 Mike Frysinger <vapier@gentoo.org>
3043 Samuel Thibault <samuel.thibault@ens-lyon.org>
3045 Apologies if I missed anyone!
3056 FSF / mtk (with assistance of Luc Van Oostenryck)
3057 man-pages finally gets pages for these system calls, several
3058 of which are obsolete in Linux 2.6.
3059 Took the old GPLed pages dated 1996 and made a number of
3060 clean-ups and minor additions.
3068 Change "file name" to "filename"
3069 Change "path name" to "pathname"
3084 mtk after a suggestion from Samuel Thibault
3085 Added SEE ALSO pointers to wide character equivalent functions
3086 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351996
3088 Typographical or grammatical errors have been corrected in several
3092 Changes to individual pages
3093 ---------------------------
3097 Remove duplicate CLONE_STOPPED text.
3098 Commented out crufty text describing EINVAL error
3099 for the now obsolete CLONE_DETACHED flag.
3100 Under CLONE_SIGHAND, noted that 'flags' must also include
3101 CLONE_VM if CLONE_SIGHAND is specified.
3105 Under ERRORS: Separate out EAGAIN error for locking mmaped files.
3113 Documented the EAGAIN error for msgrcv().
3116 Mike Frysinger / mtk
3117 Expand explanation of FNM_PATHNAME.
3120 Joerg Habenicht / mtk
3121 Fix up discussion of EAGAIN/EACCESS errors.
3124 ==================== Changes in man-pages-2.25 ====================
3126 Released: 2006-03-02
3131 The following people contributed notes, ideas, or patches that have
3132 been incorporated in changes in this release:
3134 James Peach <jpeach@samba.org>
3135 Krzysztof Benedyczak <golbi@mat.uni.torun.pl>
3136 Marten von Gagern <Martin.vGagern@gmx.net>
3137 Michael Haardt <michael@moria.de>
3138 Michael Wronksi <michal.wronski@gmail.com>
3140 Apologies if I missed anyone!
3154 New pages describing POSIX message queue API.
3157 mtk, after a suggestion by James Peach
3158 New page describing posix_fallocate().
3162 New page giving overview of the POSIX message queue API.
3165 Changes to individual pages
3166 ---------------------------
3170 Add a case to the EINVAL error text.
3172 Various minor wording fixes
3173 Added SEE ALSO referring to new posix_fallocate.3.
3177 Added "#define _XOPEN_SOURCE 600" to prototype.
3178 Added SEE ALSO referring to new posix_fallocate.3.
3182 Migrated information on POSIX message queues to new mqueue.7 page.
3186 Fix thinko: s/assuming a non-blocking/assuming a blocking/
3189 ==================== Changes in man-pages-2.26 ====================
3191 Released: 2006-03-21
3196 The following people contributed notes, ideas, or patches that have
3197 been incorporated in changes in this release:
3199 Alain Portal <aportal@univ-montp2.fr>
3200 Andi Kleen <ak@muc.de>
3201 Andries Brouwer <Andries.Brouwer@cwi.nl>
3202 Christoph Lameter <clameter@engr.sgi.com>
3203 Hasso Tepper <hasso@estpak.ee>
3204 Justin Pryzby <justinpryzby@users.sourceforge.net>
3205 Martin (Joey) Schulze <joey@infodrom.org>
3206 Nicolas François <nicolas.francois@centraliens.net>
3207 Paul Brook <paul@nowt.org>
3208 Siward de Groot <siward@wanadoo.nl>
3209 Steve Beattie <sbeattie@suse.de>
3210 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
3212 Apologies if I missed anyone!
3229 mtk, aeb, Steve Beattie
3230 Added comment in SYNOPSIS to note that syscall(2) may be
3231 preferable over _syscallN (see intro(2)).
3233 Various minor formatting changes were done on a range of
3234 pages in Section 7. (No content was changed.)
3241 New page describing openat(2), added in kernel 2.6.16,
3242 and some notes on rationale for the at*(2) system calls.
3245 Andi Kleen, Christoph Lameter, mtk
3246 Added MPOL_MF_MOVE and MPOL_MF_MOVE_ALL descriptions,
3247 from numactl-0.9.2 man page.
3248 Plus a few other smaller fixes.
3252 New page describing fexecve(3).
3256 New page describing futimes(3).
3258 Changes to individual pages
3259 ---------------------------
3263 Added SEE ALSO pointing to new fexecve.3.
3266 mtk, aeb, Steve Beattie
3267 Added some notes on syscall(2) versus _syscall.
3273 Added SEE ALSO pointing to mq_overview.7.
3277 Added SEE ALSO pointing to new openat.2.
3279 Split out part of the RETURN VALUE text into separate
3282 Modified wording referring to raw(8) to
3283 indicate that this interface is deprecated.
3287 Added discussion of ppoll(2), which is new in 2.6.16.
3296 Added text to note that although POSIX says msg_controllen
3297 should be socklen_t, glibc actually uses size_t.
3298 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=356502
3299 and the associated glibc bug report.
3300 http://sourceware.org/bugzilla/show_bug.cgi?id=2448
3302 Various formatting fixes.
3306 Updated to reflect the fact that pselect() has been implemented
3307 in the kernel in 2.6.16; various other minor wording changes.
3309 pselect() prototype needs "#define _XOPEN_SOURCE 600".
3313 Clean up description of EEXIST error.
3314 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=357893
3318 Added a little extra text to clarify EISDIR vs EPERM.
3322 Added new SEE ALSO entry pointing to new futimes.3 page.
3326 Added SEE ALSO pointing to new fexecve.3.
3330 New link to shm_open.3 (should have been made when page
3331 was originally written).
3335 Add needed "#define _XOPEN_SOURCE".
3339 Updated to remove a few function names that are now documented.
3343 Various changes to bring this page closer to
3344 current kernel versions.
3348 Noted that glibc 2.4 is required to get glibc support
3353 Some rewording and added a few words about System V
3358 Substantial updates to various parts of this page.
3364 Updated to reflect that the NPTL limitation that only the main
3365 thread could call setsid() and setpgid() was removed in 2.6.16.
3369 Removed text implying that only in kernel 2.2 does IP_HDRINCL
3370 prevent datagrams from being fragmented.
3374 Documented SO_SNDBUFFORCE and SO_RCVBUFFORCE socket options,
3377 Placed socket options in alphabetical order.
3380 ==================== Changes in man-pages-2.27 ====================
3382 Released: 2006-03-24
3387 The following people contributed notes, ideas, or patches that have
3388 been incorporated in changes in this release:
3390 Andries Brouwer <Andries.Brouwer@cwi.nl>
3391 Charles P. Wright <cwright@cs.sunysb.edu>
3392 Christoph Lameter <clameter@sgi.com>
3393 Chuck Ebbert <76306.1226@compuserve.com>
3394 Daniel Jacobowitz <dan@debian.org>
3395 Ingo Molnar <mingo@elet.hu>
3396 Heiko Carstens <heiko.carstens@de.ibm.com>
3397 Janak Desai <janak@us.ibm.com>
3398 Paolo (Blaisorblade) Giarrusso <blaisorblade@yahoo.it>
3399 Stefan Puiu <stefanpuiuro@yahoo.com>
3401 Apologies if I missed anyone!
3409 Various minor formatting changes were done on a range of
3410 pages in Section 7. (No content was changed.)
3417 mtk, with reference to documentation by Janak Desai
3418 New page describing unshare(2), added in kernel 2.6.16.
3421 Changes to individual pages
3422 ---------------------------
3428 Added SEE ALSO pointing to new unshare.2.
3432 MPOL_MF_MOVE_ALL requires CAP_SYS_NICE not CAP_SYS_RESOURCE.
3436 Clarified the description of MREMAP_FIXED and restructured
3437 the text to reflect the fact that this flag is exposed
3438 by glibc since version 2.4.
3441 Chuck Ebbert, with assistance from Daniel Jacobowitz,
3442 Paolo (Blaisorblade) Giarrusso, and Charles P. Wright;
3443 after a suggestion from Heiko Carstens.
3444 Document the following ptrace requests:
3445 PTRACE_SETOPTIONS (2.4.6)
3446 plus associated flags:
3447 PTRACE_O_TRACESYSGOOD (2.4.6)
3448 PTRACE_O_TRACEFORK (2.5.46)
3449 PTRACE_O_TRACEVFORK (2.5.46)
3450 PTRACE_O_TRACECLONE (2.5.46)
3451 PTRACE_O_TRACEEXEC (2.5.46)
3452 PTRACE_O_TRACEVFORKDONE (2.5.60)
3453 PTRACE_O_TRACEEXIT (2.5.60)
3454 PTRACE_SETSIGINFO (2.3.99-pre6)
3455 PTRACE_GETSIGINFO (2.3.99-pre6)
3456 PTRACE_GETEVENTMSG (2.5.46)
3457 PTRACE_SYSEMU (since Linux 2.6.14)
3458 PTRACE_SYSEMU_SINGLESTEP (since Linux 2.6.14)
3460 sched_get_priority_max.2
3461 sched_setscheduler.2
3464 Modified to document SCHED_BATCH policy, new in kernel 2.6.16.
3466 Text describing SCHED_BATCH was added to sched_setscheduler.2,
3467 and was drawn in part from Ingo Molnar's description in the
3468 mail message containing the patch that implemented this policy.
3470 Various other minor rewordings and formatting fixes.
3473 mtk, using text from Documentation/filesystems/proc.txt
3474 Document /proc/sys/vm/drop_caches, new in kernel 2.6.16.
3475 mtk, using information from ChangeLog-2.6.14.
3476 Document /proc/PID/smaps, new in kernel 2.6.14.
3480 Noted affect of CAP_SYS_NICE for mbind(MPOL_MF_MOVE_ALL).
3484 Kernel 2.6.16 eliminated buggy behavior with respect to
3485 the alternate signal stack.
3488 ==================== Changes in man-pages-2.28 ====================
3490 Released: 2006-03-31
3495 The following people contributed notes, ideas, or patches that have
3496 been incorporated in changes in this release:
3498 Aleksandr Blokhin <sass@altlinux.ru>
3499 Greg Johnson <gjohnson@lanl.gov>
3501 Apologies if I missed anyone!
3517 New pages describing the POSIX semaphores API.
3519 These pages supersede and provide a superset of the information
3520 in the glibc (3thr) "semaphores(3)" manual page.
3523 Changes to individual pages
3524 ---------------------------
3532 Wrapped long lines (no content changes).
3538 Add SEE ALSO pointing to the new sem_overview.7 page.
3542 Removed SEE ALSO reference to nonexistent core(5).
3545 ==================== Changes in man-pages-2.29 ====================
3547 Released: 2006-04-06
3552 The following people contributed notes, ideas, or patches that have
3553 been incorporated in changes in this release:
3555 Michael Haardt <michael@moria.de>
3556 Roberto Jimenoca <robertojimenoca@terra.es>
3557 Stefan Puiu <stefanpuiuro@yahoo.com>
3559 Apologies if I missed anyone!
3571 Added SEE ALSO entry referring to new core.5 page.
3579 New page describing mkdirat(2), new in 2.6.16.
3583 New page describing mknodat(2), new in 2.6.16.
3587 New page describing core dump files.
3591 New page describing mkfifoat(3).
3594 Changes to individual pages
3595 ---------------------------
3600 Michael Haardt / mtk
3601 Document EINVAL error for 'len' argument < 0.
3605 Expanded discussion of mandatory locking.
3609 Added BUGS text on 2.6.x handling of RLIMIT_CPU limit
3610 of zero seconds. See
3611 http://marc.theaimsgroup.com/?l=linux-kernel&m=112256338703880&w=2
3615 Added SEE ALSO entry referring to new mkdirat.2.
3619 Added SEE ALSO entry referring to new mknodat.2.
3622 mtk / Roberto Jimenoca
3623 Clarified discussion of file types affected by O_NONBLOCK.
3624 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=360243
3628 Rewrote NOTES describing rationale for openat().
3629 Various other minor changes.
3633 Removed a misleading cross-ref to socket.2.
3637 Since 2.6.17-rc1, shmdt() gives the error EINVAL in a further
3638 circumstance: if shmaddr is not aligned on a page boundary.
3642 Remove text saying that specifying invalid flags "is likely
3643 to cause compatibility problems" since the kernel now
3644 (2.6.17-rc1) contains an explicit check for invalid bits
3645 with a consequent EINVAL error.
3649 Added SEE ALSO entry referring to new mkfifoat.3.
3653 Information on core_pattern and core_uses_pid has
3654 been migrated to the new core.5 page.
3658 Removed paragraph referring to obsolete ipchains / ipfw(4).
3662 Add SEE ALSO entry referring to pthreads.7.
3665 ==================== Changes in man-pages-2.30 ====================
3667 Released: 2006-04-17
3672 The following people contributed notes, ideas, or patches that have
3673 been incorporated in changes in this release:
3675 Andre Lehovich <andrel@yahoo.com>
3676 Andries Brouwer <Andries.Brouwer@cwi.nl>
3677 Karel Kulhavy <clock@twibright.com>
3678 Stefan Puiu <stefanpuiuro@yahoo.com>
3680 Apologies if I missed anyone!
3688 New page describing linkat(), new in kernel 2.6.16
3692 New page describing renameat(), new in kernel 2.6.16
3696 New page describing symlinkat(), new in kernel 2.6.16
3700 New page describing unlinkat(), new in kernel 2.6.16
3703 Changes to individual pages
3704 ---------------------------
3708 Added SEE ALSO entry pointing to new linkat.2 page.
3712 Added SEE ALSO entries pointing to new *at.2 pages.
3716 Added SEE ALSO entry pointing to new renameat.2 page.
3720 Added SEE ALSO entry pointing to new unlinkat.2 page.
3724 Added SEE ALSO entry pointing to new symlinkat.2 page.
3728 Added SEE ALSO entry pointing to new unlinkat.2 page.
3732 Document the feature test macros required to expose various flags.
3734 Clarify 'speed' argument for cfsetispeed() text.
3736 Note that LOBLK is not implemented on Linux.
3738 Clarify arguments for cfsetspeed().
3739 Various formatting changes.
3743 Add a sentence describing the purpose of full(4).
3747 Rework text describing circumstances in which
3748 core dump files are not produced.
3750 A core dump of a multithreaded process always includes the
3751 PID in the core filename.
3753 Eliminate some accidentally duplicated text.
3756 ==================== Changes in man-pages-2.31 ====================
3758 Released: 2006-05-02
3763 The following people contributed notes, ideas, or patches that have
3764 been incorporated in changes in this release:
3766 Joshua Kwan <joshk@triplehelix.org>
3767 Justin Pryzby <justinpryzby@users.sourceforge.net>
3768 Karel Kulhavy <clock@twibright.com>
3769 Mark Glines <mark@glines.org>
3770 Martin (Joey) Schulze <joey@infodrom.org>
3771 Nishanth Aravamudan <nacc@us.ibm.com>
3772 Reuben Thomas <rrt@sc3d.org>
3773 Ryan S. Arnold <rsa@us.ibm.com>
3774 Ulrich Drepper <drepper@redhat.com>
3776 Apologies if I missed anyone!
3782 The following pages have been relocated into section 7, since
3783 that is their more natural home. SEE ALSO references in various
3784 other pages have been adjusted.
3791 (many pages outside man-pages actually *expect*
3792 'environ' to be in Section 7.)
3797 ".so" link files have been created to link the old file locations to the
3798 new file locations. These links are added just to ensure that cross
3799 references from any other (non-man-pages) pages will remain valid;
3800 eventually these links will be removed.
3808 New page for fstatat(2), new in 2.6.16.
3812 New page for adjtime(3).
3816 New page describing error() and error_at_line()
3817 Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=186307
3819 program_invocation_name.3
3821 New page describing program_invocation_name and
3822 program_invocation_short_name variables.
3826 New page for sockatmark(3).
3830 New page describing feature test macros.
3834 New page giving an overview of "time" on Linux systems.
3848 Simplified wording around requirement for _BSD_SOURCE
3859 Added SEE ALSO referring to new time.7.
3866 Add SEE ALSO referring to new error.3.
3872 Added SEE ALSO entry referring to setlocale.3.
3875 Changes to individual pages
3876 ---------------------------
3880 Remove mention of SOCK_RDM from this page, since this socket
3881 type does not support accept()ing connections.
3885 Modified text referring to adjtime(); added SEE ALSO for new
3889 mtk, after a note by Karel Kulhavy
3890 Rewrote most of the DESCRIPTION, as well as some other parts
3891 the page, to clarify use and operation of, and rationale for,
3892 fsync(2) and fdatasync(2).
3896 Updated discussion of maximum timer value to reflect the fact
3897 that the default jiffy is now 4 milliseconds.
3899 Added text to note that current incorrect behavior of
3900 normalizing tv_usec >= 1000000 will be repaired in a future
3901 kernel; applications should be fixed now.
3905 Point out more explicitly that 'tz' argument should
3908 Various other minor edits and formatting fixes.
3912 Since kernel 2.6.16, MS_NOATIME and MS_NODIRATIME are settable
3913 on a per-mount basis.
3914 Detail exactly which mount flags can be changed on MS_REMOUNT.
3918 Clarify RETURN VALUE discussion.
3922 Add SEE ALSO reference pointing to new fstatat.2.
3924 program_invocation_short_name.3
3926 New link to new program_invocation_name.3.
3930 Added SEE ALSO for new sockatmark.3.
3933 Joshua Kwan / Martin (Joey) Schulze / mtk
3934 Correct wording of EBUSY case.
3936 Add ".." case to ENOTEMPTY error
3940 Note more clearly that fd_set arguments can be NULL.
3942 Improve opening paragraph describing purpose of select().
3944 Various other minor edits and formatting fixes.
3947 mtk / Nishanth Aravamudan
3948 Add text to noting that the initial values of semaphores
3949 in a new set are indeterminate.
3953 Add text noting that contents of newly created segment are zero
3958 Noted that all threads should block signal being waited for.
3961 Nishanth Aravamudan / mtk
3962 Added NOTE that st_size is always returned as zero for most
3965 Add SEE ALSO reference pointing to new fstatat.2.
3969 Remove bogus BUGS text.
3973 Various minor changes.
3977 Rewrote RETURN VALUE discussion.
3978 Updated CONFORMING TO.
3982 Martin (Joey) Schulze / mtk
3983 Fix errors in DESCRIPTION.
3987 The range of tm_sec is 0..60 (not 0..61).
3990 error_message_count.3
3992 error_print_progname.3
3994 New links to new error.3.
3997 mtk / Ryan S. Arnold
3998 Add text noting that explicitly controlling output buffering
3999 may be useful to catch errors on output operations on an
4004 Add SEE ALSO pointing to getline.3.
4005 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=364772
4010 Describe correct handling of errno in order to
4011 distinguish error from success after the call.
4013 Added EXAMPLE section which points to strtol.3 which provides
4014 an example of the use of the analogous strtol(3).
4018 Add an example program.
4020 Describe correct handling or errno in order to
4021 distinguish error from success after the call.
4025 DESCRIPTION does not need to say "temporary file name"
4026 just "temporary file", since the name is in any case
4027 unavailable to the user.
4028 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=363518
4031 Change /automatically deleted when the program terminates normally/
4032 to /automatically deleted when the program terminates/
4033 since deletion occurs on both normal and abnormal termination.
4037 Various wording improvements and clarifications.
4040 mtk / Ulrich Drepper
4041 Add text noting that a signal's disposition is process-wide,
4042 shared by all threads.
4044 Add text on changing signal dispositions.
4045 Add text on "signal mask and pending signals".
4050 Added SEE ALSO for new adjtime.3.
4054 Remove bogus duplicate line.
4057 ==================== Changes in man-pages-2.32 ====================
4059 Released: 2006-05-13
4064 The following people contributed notes, ideas, or patches that have
4065 been incorporated in changes in this release:
4067 Andries Brouwer <Andries.Brouwer@cwi.nl>
4068 Johannes Weiner <root@hnaz.ath.cx>
4069 Justin Pryzby <justinpryzby@users.sourceforge.net>
4070 Karel Kulhavy <clock@twibright.com>
4071 Paul Brook <paul@nowt.org>
4072 Pavel Heimlich <tropikhajma@seznam.cz>
4074 Apologies if I missed anyone!
4082 New page for faccessat(2), new in 2.6.16.
4086 New page for fchmodat(2), new in 2.6.16.
4090 New page for fchownat(2), new in 2.6.16.
4094 New page for futimesat(2), new in 2.6.16.
4097 Changes to individual pages
4098 ---------------------------
4102 Add SEE ALSO reference pointing to new faccessat.2 page.
4106 Reworded to reflect that capabilities are per-thread.
4110 Add SEE ALSO reference pointing to new fchmodat.2 page.
4114 Add SEE ALSO reference pointing to new fchownat.2 page.
4118 Updated discussion of MAP_NORESERVE since it is no longer
4119 restricted to MAP_PRIVATE mappings.
4120 Add reference to discussion of /proc/sys/vm/overcommit_memory
4125 Add SEE ALSO reference pointing to new faccessat.2, fchmodat.2,
4126 fchownat.2, futimesat.2 pages.
4130 Document SHM_NORESERVE flag, new in 2.6.15.
4134 Expand text noting that ftruncate()/truncate() may fail if
4135 asked to extend a file beyond its current length.
4140 Add SEE ALSO reference pointing to new futimesat.2 page.
4144 Document 'm' (mmap) flag.
4145 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=365754
4147 Document 'c' (notcancel) flag.
4151 Add SEE ALSO reference pointing to new futimesat.2 page.
4155 Add missing "const" qualifies to cast in EXAMPLE.
4157 Slight rewording of comments in EXAMPLE.
4161 Clarify meaning of IXANY.
4162 Clarify relationship of MIN with VMIN and TIME with VTIME.
4164 Noted that CIBAUD, OFDEL, and DELECHO are not implemented
4166 Added explanatory paragraph for phrases "not in POSIX" and
4171 Reworded to reflect that capabilities are per-thread.
4172 Add ioprio_set() to list of operations permitted by
4174 Add ioprio_set() IOPRIO_CLASS_RT and IOPRIO_CLASS_IDLE
4175 scheduling classes to list of operations permitted by
4177 Note effects of CAP_SYS_NICE for migrate_pages().
4180 ==================== Changes in man-pages-2.33 ====================
4182 Released: 2006-05-23
4187 The following people contributed notes, ideas, or patches that have
4188 been incorporated in changes in this release:
4190 Andries Brouwer <Andries.Brouwer@cwi.nl>
4191 Justin Pryzby <justinpryzby@users.sourceforge.net>
4192 Martin Osvald" <martin.osvald@gmail.com>
4193 Stefan Puiu <stefanpuiuro@yahoo.com>
4195 Apologies if I missed anyone!
4203 renamed to the more suggestive feature_test_macros.7
4211 New page briefly describing mq_getsetattr(2), the system
4212 call that underlies mq_setattr(3) and mq_getattr(3).
4216 New page for rpmatch(3).
4219 Changes to individual pages
4220 ---------------------------
4224 Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
4225 POSIX does now document ELOOP.
4229 Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
4233 Add mincore(2) to SEE ALSO.
4234 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367401
4238 Note that EINVAL can also be caused by
4239 flags == MS_SYNC | MS_ASYNC.
4243 Add CPU_ISSET, CPU_CLR, CPU_SET, CPU_ZERO to NAME section.
4247 Various minor changes.
4251 Removed much material that is redundant with select.2.
4252 Various other changes.
4256 Substantial rewrite of description of 'mask'.
4263 New links to sched_setaffinity.2
4270 New links to select.2.
4274 Add SEE also referring to ftw.3.
4278 Add SEE also referring to fts.3.
4282 Various minor clarifications.
4286 Clarify that O_EXCL is an open(2) flag.
4290 Fix prototype declaration for 'attr'.
4294 s/sigev_signal/sigev_signo/
4298 New link to mq_getattr.3.
4302 New link to mq_receive.3.
4306 New link to mq_send.3.
4310 Added SEE ALSO referring to rpmatch.3.
4316 New links to sigsetops.3.
4320 Added SEE ALSO referring to unlocked_stdio.3
4321 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367667
4325 Add description of strchrnul().
4329 New link to strchr.3.
4333 Updated to remove some functions that don't exist, and
4334 therefore don't need to be documented.
4335 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367671
4339 Added SEE ALSO referring to stdio.3
4340 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367667
4344 Added section describing relationship between library
4345 interfaces and system calls.
4346 Added SEE ALSO referring to new mq_getsetattr.2.
4348 feature_test_macros.7
4350 Fix typo: s/_POSIX_C_SOURCE/_POSIX_SOURCE/
4353 ==================== Changes in man-pages-2.34 ====================
4355 Released: 2006-06-20
4360 The following people contributed notes, ideas, or patches that have
4361 been incorporated in changes in this release:
4363 Aristeu Sergio Rozanski Filho <aris@cathedrallabs.org>
4364 bert hubert <bert.hubert@netherlabs.nl>
4365 Chris Curtis <chris.curtis@riptidesoftware.com>
4366 Eduardo Madeira Fleury <efleury@br.ibm.com>
4367 Joerg Scheurich <rusmufti@helpdesk.bera.rus.uni-stuttgart.de>
4368 Justin Pryzby <justinpryzby@users.sf.net>
4369 Kenichi Okuyama <okuyama.kenichi@oss.ntt.co.jp>
4370 Marc Lehmann <debian-reportbug@plan9.de>
4371 Martin (Joey) Schulze <joey@infodrom.org>
4372 Mats Wichmann <mats.d.wichmann@intel.com>
4373 Mike Frysinger <vapier@gentoo.org>
4374 Peter Eiserloh <eiserlohpp@yahoo.com>
4375 Stefan Puiu <stefanpuiuro@yahoo.com>
4376 Thomas Dickey <dickey@radix.net>
4377 Walter Harms <wharms@bfs.de>
4379 Apologies if I missed anyone!
4389 Added header comment noting that these pages are in the public
4399 Added following to top of these pages to clarify origin and
4401 .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
4407 Eduardo Madeira Fleury, with edits by mtk, and review by Jens Axboe
4408 New page for ioprio_get(2) and ioprio_set(2), new in 2.6.13.
4412 New page describing offsetof() macro.
4415 Changes to individual pages
4416 ---------------------------
4420 Add SEE ALSO referring to exit_group.2.
4424 Add SEE ALSO referring to acct.5.
4428 Explicitly mention term "dnotify" in discussion of F_NOTIFY.
4431 Aristeu Sergio Rozanski Filho / mtk
4432 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4433 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
4435 Renamed argument from 'path' to 'pathname'.
4436 Reword introductory paragraph to clarify that
4437 inotify_add_watch() may also modify an existing watch item.
4439 The EINVAL error can also occur if 'fd' is not an inotify
4442 Moved BUGS section from this page to inotify.7.
4445 Aristeu Sergio Rozanski Filho / mtk
4446 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4447 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
4450 Aristeu Sergio Rozanski Filho / mtk
4451 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4452 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
4454 The EINVAL error can also occur if 'fd' is not an inotify
4459 New link to new ioprio_set.2.
4463 Add SEE ALSO referring to remap_file_pages.2.
4467 s/MNT_FORCE/MNT_EXPIRE/ under EINVAL error.
4471 s/unsigned long flags/int flags/ in SYNOPSIS.
4475 Add SEE ALSO referring to popen.3.
4479 Add SEE ALSO referring to readahead.2.
4483 SEE ALSO for readv should refer to Section 2, not 3.
4487 Add SEE ALSO referring to posix_fadvise.2.
4491 Fix missing arguments in statement about equivalent send()
4496 Add SEE ALSO referring to tcgetsid.3.
4500 Minor wording change at start of DESCRIPTION.
4504 Add SEE ALSO referring to access.2.
4508 Relocated "Note" about f_fsid.
4512 SEE ALSO for writev should refer to Section 2, not 3.
4516 Added license statement (GPL) after consultation with
4521 Add #define _GNU_SOURCE to prototype
4525 Added note about time_t representation on other systems.
4526 Added CONFORMING TO.
4530 A fairly major revision...
4531 Document FTW_ACTIONRETVAL; include .SH "RETURN VALUE";
4532 Reorganized and rewrote much of the page
4533 Added an example program.
4537 Fixed typo in NOTES.
4538 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=370277
4542 Updated CONFORMING TO.
4546 Updated CONFORMING TO.
4550 Add documentation of %m.
4554 Added SEE ALSO referring to ftw.3.
4558 Note that these functions are obsolete in favor of regcomp(3).
4560 Add SEE ALSO referring to regcomp.3
4564 Reworded CONFORMING TO statement on scandir() and alphasort().
4568 Fix prototype for strchrnul().
4572 Add text clarifying treatment of strings starting with
4576 mtk, after comments by Justin Pryzby
4577 Add text noting the need to use open(O_EXCL).
4579 Clarify discussion of use of free(3).
4580 Various other minor changes to text and formatting.
4584 Updated CONFORMING TO.
4587 mtk, after comments by Justin Pryzby
4588 Add text noting the need to use open(O_EXCL).
4589 Updated CONFORMING TO.
4593 Remove offsetof(), which is now documented.
4597 Added SEE ALSO referring to full.4.
4601 Various improvements and corrections.
4605 Added CONFORMING TO section mentioning FreeBSD kqueue and
4608 feature_test_macros.7
4610 Added pointer to location of LFS specification.
4613 mtk, after suggestion by Joey.
4614 Added license statement to page, after discussion with
4615 original author, bert hubert.
4617 Reformat long lines; no content changes.
4621 'path' argument renamed to 'pathname'.
4622 A few minor rewordings.
4623 Added BUGS section describing a couple of bugs.
4627 Add SEE ALSO referring to byteorder.3.
4631 Add SEE ALSO referring to groff_man(7).
4632 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369253
4635 ==================== Changes in man-pages-2.35 ====================
4637 Released: 2006-07-06
4642 The following people contributed notes, ideas, or patches that have
4643 been incorporated in changes in this release:
4645 Alain Portal <aportal@univ-montp2.fr>
4646 Andi Kleen <ak@suse.de>
4647 Andrew Morton <akpm@osdl.org>
4648 Bauke Jan Douma <bjdouma@xs4all.nl>
4649 Davide Libenzi <davidel@xmailserver.org>
4650 Denis Barbier <barbier@linuxfr.org>
4651 Horacio Rodriguez Montero <Horacio.Rodriguez.Montero@galinter.com.ar>
4652 Johan Lithander <johan.lithander@teligent.se>
4653 Justin Pryzby <justinpryzby@users.sourceforge.net>
4654 Mike Frysinger <vapier@gentoo.org>
4655 Stefan Puiu <stefanpuiuro@yahoo.com>
4656 Thorsten Kukuk <kukuk@suse.de>
4658 Apologies if I missed anyone!
4664 Typographical or grammatical errors have been corrected in several
4672 New page for sync_file_range(2), new in kernel 2.6.17.
4674 Changes to individual pages
4675 ---------------------------
4679 Noted BUG that occurs if 'delta' is specified as NULL.
4680 See http://bugzilla.kernel.org/show_bug.cgi?id=6761
4684 Add EADDRNOTAVAIL error.
4686 Make example code more complete.
4689 mtk / Davide Libenzi
4690 Added EPOLLRDHUP description.
4692 Added SEE ALSO referring to poll.2.
4695 mtk / Davide Libenzi
4696 Added POLLRDHUP description.
4698 The correct header file is <poll.h>, not <sys/poll.h>.
4699 Rewrote and reformatted various other parts.
4703 Nowadays, readlink() returns 'ssize_t', as required in
4708 Added license statement.
4712 Add documentation for various new fields.
4715 Horacio Rodriguez Montero
4716 Add explanation of 'x' character in 'password' field.
4718 The proper name of "*" is "asterisk" not "star".
4722 Update RFC reference for ECN.
4724 Add sentence on "low memory" limit for tcp_mem on 32-bit systems.
4727 ==================== Changes in man-pages-2.36 ====================
4729 Released: 2006-07-11
4734 The following people contributed notes, ideas, or patches that have
4735 been incorporated in changes in this release:
4737 Alain Portal <aportal@univ-montp2.fr>
4738 Jens Axboe <jans@suse.de>
4739 Justin Pryzby <justinpryzby@users.sourceforge.net>
4740 Kyle McMartin <kyle@mcmartin.ca>
4742 Apologies if I missed anyone!
4747 Typographical or grammatical errors have been corrected in several
4755 How to maintain man-pages.
4759 Things that it would be nice to get done for man-pages one day.
4761 scripts/FIXME_list.sh
4763 This script, intended for use by manual page maintainers,
4764 displays the FIXMEs in the manual page source files.
4766 Changes to individual pages
4767 ---------------------------
4772 Added SEE ALSO referring to sync_file_range.2.
4776 Fix description of 'offset' argument to explain the case
4777 where 'offset' is NULL.
4781 Add SEE ALSO referring to fdopen.3.
4785 Removed information about Section 3 subsections -- it doesn't
4786 reflect current reality, and probably never has.
4788 Added SEE ALSO referring to intro.2.
4792 Correction: tcp_window_scaling is ENabled by default.
4795 ==================== Changes in man-pages-2.37 ====================
4797 Released: 2006-08-02
4802 The following people contributed notes, ideas, or patches that have
4803 been incorporated in changes in this release:
4805 Alain Portal <aportal@univ-montp2.fr>
4806 Dean Gaudet <dean@arctic.org>
4807 Frank van Viegen <F.C.vanViegen@UTwente.nl>
4808 Helmut Grohne <helmut@subdivi.de>
4809 Ivana Varekova <varekova@redhat.com>
4810 Thomas Huriaux <thomas.huriaux@gmail.com>
4811 Ville Skyttä <ville.skytta@iki.fi>
4813 Apologies if I missed anyone!
4818 Thomas Huriaux / mtk
4820 Various formatting problems found as a result of reviewing the
4821 following command were fixed.
4823 for a in $(wc man?/*.?| awk '$1 > 2 ' | grep -v total); do
4824 echo $a; groff -Tascii -wmac -mman $a > /dev/null;
4827 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=378544
4829 Typographical or grammatical errors have been corrected in several
4836 mtk (after prompting from Ivana Varekova)
4837 New page for readlinkat(2), new in kernel 2.6.16.
4839 Changes to individual pages
4840 ---------------------------
4844 Document "-u" option.
4848 Noted effect of fork() and execve() on current working directory.
4852 Noted effect of fork() and execve() on root directory.
4855 Frank van Viegen / mtk
4856 Fix description of EBADF error.
4860 Add text noting that effective IDs are copied to
4861 saved set-IDs during execve().
4862 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=379297
4866 Noted effect of fork() and execve() on interval timers.
4870 Noted effect of fork() and execve() on resource limits.
4874 Noted effect of fork() and execve().
4878 Some rewording; included text describing required file
4883 Revised description of standards under CONFORMING TO.
4887 Point out that args following 'argc' are int.
4889 Added an example program.
4890 Various minor wording fixes.
4894 Expand description of MAP_POPULATE.
4895 mtk, after prompting by Dean Gaudet
4896 Expand description MAP_NONBLOCK.
4898 Various minor formatting fixes.
4902 Added SEE ALSO linking to readlinkat.2.
4906 Noted buggy behavior in Linux 2.4 and earlier when
4907 nanosleep() is restarted after receiving stop+SIGCONT signals.
4911 Very minor rewording.
4915 Added SEE ALSO linking to readlinkat.2.
4917 sched_setscheduler.2
4919 Noted preservation of scheduling parameters across execve().
4923 Noted effect of fork() and execve() on process group ID.
4927 Noted effect of fork() and execve() on session ID.
4931 Noted effect of fork() and execve() on umask.
4935 Noted inheritance of registrations across fork().
4939 Added material on privileges required for move_pages().
4940 CLONE_NEWNS needs CAP_SYS_ADMIN.
4941 keyctl(KEYCTL_CHOWN) and keyctl(KEYCTL_SETPERM) require
4945 ==================== Changes in man-pages-2.38 ====================
4947 Released: 2006-08-03
4952 The following people contributed notes, ideas, or patches that have
4953 been incorporated in changes in this release:
4955 Alain Portal <aportal@univ-montp2.fr>
4957 Apologies if I missed anyone!
4964 There was a major reworking of the CONFORMING TO sections
4965 in most manual pages.
4967 * generally try to rationalize the names used for standards.
4968 The preferred names are now documented as the head words
4969 of the list in standards(7). For the future: there is
4970 probably no need to talk about anything more than
4971 C89, C99, POSIX.1-2001 (or later), xBSD, and SVr4.
4972 (In particular, I've eliminated most references to XPG
4973 and SVID, replacing them with references to SUS or SVr4.)
4975 * eliminate discussion of errors that can occur on other
4976 systems. This information exists only patchily in the
4977 manual pages, is probably of limited use, is hard to maintain,
4978 and was in some cases simply wrong (and probably always was).
4980 * Tried to ensure that those interfaces specified in C99 or
4981 POSIX.1-2001 are marked as such in their manual pages.
4989 feature_test_macros.7
4991 Added SEE ALSO referring to new standards.7.
4995 Changed instances of "HP UX" to "HP-UX".
4999 Changed instances of "DG-UX to "DG/UX"
5001 Typographical or grammatical errors have been corrected in several
5009 Based on material taken from intro.2, but expanded to
5010 include discussion of many additional standards.
5012 Changes to individual pages
5013 ---------------------------
5017 Minor wording change for ENOTSOCK error.
5021 Removed information on standards to new standards.7.
5024 ==================== Changes in man-pages-2.39 ====================
5026 Released: 2006-08-05
5031 The following people contributed notes, ideas, or patches that have
5032 been incorporated in changes in this release:
5034 Alain Portal <aportal@univ-montp2.fr>
5036 Apologies if I missed anyone!
5043 Updated CONFORMING TO and/or standards references
5044 in various pages that were missed for 2.38.
5046 Typographical or grammatical errors have been corrected in several
5049 Changes to individual pages
5050 ---------------------------
5055 _XOPEN_SOURCE=500 also gets fchdir() prototype.
5059 Added a few more standards, and expand some explanations.
5062 ==================== Changes in man-pages-2.40 ====================
5064 Released: 2006-09-04
5069 The following people contributed notes, ideas, or patches that have
5070 been incorporated in changes in this release:
5072 Alain Portal <aportal@univ-montp2.fr>
5073 Andi Kleen <ak@suse.de>
5074 Andries Brouwer <Andries.Brouwer@cwi.nl>
5075 Christoph Hellwig <hch@lst.de>
5076 Chuck Ebbert <76306.1226@compuserve.com>
5077 Samuel Thibault <samuel.thibault@ens-lyon.org>
5078 Toralf Förster <toralf.foerster@gmx.de>
5080 Apologies if I missed anyone!
5097 mtk (after a note by Alain Portal)
5098 Make naming of 'pathname' argument consistent; various
5101 Typographical or grammatical errors have been corrected in several
5104 Changes to individual pages
5105 ---------------------------
5109 Reinstate text on CLONE_DETACHED, and add a few words.
5113 Added list of process attributes that are not preserved on exec().
5116 mtk, after a suggestion by Christoph Hellwig
5117 Greatly expanded, to describe all attributes that differ
5118 in parent and child.
5122 Document AT_SYMLINK_FOLLOW (new in 2.6.18).
5126 Memory policy is preserved across execve().
5130 SEE ALSO for writev should refer to Section 2, not 3.
5131 (i.e., really make the change that was logged in 2.34)
5134 Samuel Thibault / mtk
5135 Fix SYNOPSIS and CONFORMING TO text for getwd() and
5137 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=381692
5141 Document /proc/PID/auxv.
5145 Restore text accidentally deleted in 2.39.
5149 Change references to "1003.2" to "POSIX.2".
5152 ==================== Changes in man-pages-2.41 ====================
5154 Released: 2006-10-12
5159 The following people contributed notes, ideas, or patches that have
5160 been incorporated in changes in this release:
5162 Andi Kleen <ak@suse.de>
5163 Andries Brouwer <Andries.Brouwer@cwi.nl>
5164 Andrew Morton <akpm@osdl.org>
5165 Britton Leo Kerin <bkerin_rb@letterboxes.org>
5166 Dan Jacobson <jidanni@jidanni.org>
5167 Guillem Jover <guillem@hadrons.org>
5168 Hrvoje Niksic <hniksic@xemacs.org>
5169 Jens Axboe <axboe@suse.de>
5170 Justin Pryzby <justinpryzby@users.sourceforge.net>
5171 Kevin Ryde <user42@zip.com.au>
5172 Marcel Holtmann <marcel@holtmann.org>
5173 Senthil Kumar <senthilkumar_sen@hotpop.com>
5174 Stefan Puiu <stefanpuiuro@yahoo.com>
5175 Stuart MacDonald <stuartm@connecttech.com>
5176 Trond Myklebust <trond.myklebust@fys.uio.no>
5178 Apologies if I missed anyone!
5184 Typographical or grammatical errors have been corrected in several
5194 Jens Axboe / Michael Kerrisk
5196 http://lwn.net/Articles/118760/
5197 http://lwn.net/Articles/178199/
5198 http://lwn.net/Articles/179492/
5199 http://kerneltrap.org/node/6505
5200 http://lwn.net/Articles/179434/
5202 Changes to individual pages
5203 ---------------------------
5207 Note glibc version where "ldd -u" appeared.
5211 The PR_SET_NAME setting is not preserved across an execve().
5215 Mappings marked with madvise(MADV_DONTFORK) are not inherited
5220 Noted that sysconf(_SC_OPEN_MAX) is preferred in portable
5225 Noted that sysconf(_SC_PAGE_SIZE) is preferred in portable
5227 _SC_PAGE_SIZE is available on most systems.
5231 Document MADV_REMOVE, new in 2.6.16.
5232 Document MADV_DONTFORK / MADV_DOFORK, new in 2.6.16.
5235 mtk / Trond Myklebust
5236 MNT_FORCE can cause data loss.
5240 Added note on Linux's old (pre-2.6.12) buggy treatment of
5243 Added some EINVAL errors.
5247 Remove superfluous "#include <unistd.h>" from SYNOPSIS.
5251 Added EBUSY error for case where MS_INVALIDATE is applied to
5256 Since 2.6.18, POSIX_FADV_NOREUSE is a no-op.
5259 Marcel Holtmann / mtk
5260 Since kernel 2.6.18, setting 2 for PR_SET_DUMPABLE is no longer
5263 Updated Linux versions where the options where introduced.
5264 Added PR_SET_TIMING, PR_GET_TIMING, PR_SET_NAME, PR_GET_NAME,
5265 PR_SET_UNALIGN, PR_GET_UNALIGN, PR_SET_FPEMU, PR_GET_FPEMU,
5266 PR_SET_FPEXC, PR_GET_FPEXC.
5268 Document PR_GET_ENDIAN and PR_SET_ENDIAN.
5272 Add "#define _GNU_SOURCE" to SYNOPSIS.
5276 Noted that sync_file_range() appeared in kernel 2.6.17.
5280 Noted interactions with fork handlers in multithreaded programs.
5284 Added feature test macros to SYNOPSIS.
5287 mtk / aeb / Kevin Ryde
5288 Fix broken text in description.
5289 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386214
5293 Fix broken text in description.
5294 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386214
5298 Fix return type in SYNOPSIS; should be "ssize_t" not "mqd_t".
5299 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=387551
5303 Fix wording referring to the use of strcmp() in 'compar'
5305 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=391402
5309 Added SEE ALSO referring to new splice.2 page.
5313 Documented IUTF8 (which was new in kernel 2.6.4).
5317 Added some TZ examples.
5318 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386087
5322 Added delayacct_blkio_ticks (new in 2.6.18) to /proc/PID/statm.
5325 Stuart MacDonald / Andi Kleen
5326 Fix discussion for TCP error queue /IP_RECVERR on TCP.
5330 Noted effect of RLIMIT_STACK resource limit for NPTL.
5334 Place socket options in alphabetical order.
5337 ==================== Changes in man-pages-2.42 ====================
5339 Released: 2006-11-24
5344 The following people contributed notes, ideas, or patches that have
5345 been incorporated in changes in this release:
5347 Andrew Morton <akpm@osdl.org>
5348 Chuck Ebbert <76306.1226@compuserve.com>
5349 Doug Goldstein <cardoe@gentoo.org>
5350 Eduard Bloch <blade@debian.org>
5351 Evan Teran <eteran@alum.rit.edu>
5352 Pavel Heimlich <tropikhajma@seznam.cz>
5353 Petr Baudis <pasky@ucw.cz>
5354 Randy Dunlap <rdunlap@xenotime.net>
5355 Ulrich Drepper <drepper@redhat.com>
5357 Apologies if I missed anyone!
5363 Typographical or grammatical errors have been corrected in several
5367 Changes to individual pages
5368 ---------------------------
5372 Add text describing behavior of the Linux brk() system call
5373 and point out that the glibc brk() wrapper provides different
5376 Note that sbrk() is implemented as a library function in glibc
5377 that calls the brk() system call.
5381 FUTEX_FD is scheduled for removal in June 2007.
5385 Ulrich Drepper, with edits by mtk
5386 Add text describing Internationalized Domain Name
5391 Fix description of O_LARGEFILE to mention required feature test
5396 Since Linux 2.6.18, the PID of the new process is also available
5397 for PTRACE_EVENT_VFORKDONE.
5401 Fix header file required for vsyslog() in SYNOPSIS.
5409 Linux 2.4.21 added core_pattern (which was already in 2.6).
5410 Noted a few more reasons why a core dump file might not
5414 ==================== Changes in man-pages-2.43 ====================
5416 Released: 2006-11-29
5421 The following people contributed notes, ideas, or patches that have
5422 been incorporated in changes in this release:
5424 Andi Kleen <ak@suse.de>
5425 David Brownell <david-b@pacbell.net>
5426 Eduard Bloch <blade@debian.org>
5427 Egmont Koblinger <egmont@uhulinux.hu>
5428 Reuben Thomas <rrt@sc3d.org>
5430 Apologies if I missed anyone!
5436 Typographical or grammatical errors have been corrected in several
5440 Changes to individual pages
5441 ---------------------------
5445 Clarify discussion of privilege requirements.
5446 Added ENOMEM to ERRORS.
5450 Clarify description of O_LARGEFILE.
5454 Make description of MD5 output string less ambiguous.
5458 Add C99 to CONFORMING TO; see
5459 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400634
5464 Update the RTC man page to reflect the new RTC class framework:
5466 - Generalize ... it's not just for PC/AT style RTCs, and there
5467 may be more than one RTC per system.
5469 - Not all RTCs expose the same feature set as PC/AT ones; most
5470 of these ioctls will be rejected by some RTCs.
5472 - Be explicit about when {A,P}IE_{ON,OFF} calls are needed.
5474 - Describe the parameter to the get/set epoch request; correct
5475 the description of the get/set frequency parameter.
5477 - Document RTC_WKALM_{RD,SET}, which don't need AIE_{ON,OFF} and
5478 which support longer alarm periods.
5480 - Hey, not all system clock implementations count timer irqs any
5481 more now that the new RT-derived clock support is merging.
5485 s/fseek(3)/lseek(2)/ under /proc/PID/mem entry.
5487 feature_test_macros.7
5489 The LFS spec is now at http://opengroup.org/platform/lfs.html
5494 Describe the correct default for UDP/RAW path MTU discovery.
5497 ==================== Changes in man-pages-2.44 ====================
5499 Released: 2007-04-04
5504 The following people contributed notes, ideas, or patches that have
5505 been incorporated in changes in this release:
5507 Andre Majorel <aym-naideb@teaser.fr>
5508 Benjamin Gilbert <bgilbert@cs.cmu.edu>
5509 Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
5510 Chuck Ebbert <76306.1226@compuserve.com>
5511 Ivana Varekova <varekova@redhat.com>
5512 Jakub Jelinek <jakub@redhat.com>
5513 John Ward <jward@idealcorp.com>
5514 Jorge Peixoto de Morais Neto <jorgepeixotomorais@gmail.com>
5515 Julien Blache <jblache@debian.org>
5516 Julien Cristau <jcristau@debian.org>
5517 Justin Pryzby <justinpryzby@users.sourceforge.net>
5518 Martín Ferrari <martin.ferrari@gmail.com>
5519 Mike Frysinger <vapier@gentoo.org>
5520 Nick Piggin <npiggin@suse.de>
5521 Nick Pollitt <npollitt@mvista.com>
5522 Nicolas François <nicolas.francois@centraliens.net>
5523 Pádraig Brady <P@draigBrady.com>
5524 Premysl Hruby <dfenze@gmail.com>
5525 Reuben Thomas <rrt@sc3d.org>
5526 Samuel Thibault <samuel.thibault@ens-lyon.org>
5527 Serge E. Hallyn <serge@hallyn.com>
5528 Thomas Huriaux <thomas.huriaux@gmail.com>
5529 Timo Sirainen <tss@iki.fi>
5530 Val Henson <val_henson@linux.intel.com>
5532 Apologies if I missed anyone!
5539 mtk, after a bit of prodding by Reuben Thomas
5540 A brief discussion of the old System V termio interface,
5541 with pointers to pages that will contain the information
5542 that the reader probably wants.
5544 scripts/find_repeated_words.sh
5546 Find consecutive duplicate words in a man page, some of
5547 which may be grammar errors.
5554 Add "#define _ATFILE_SOURCE" to SYNOPSIS in following pages:
5572 Various references to "getty" were changed to "mingetty", since
5573 that is the manual page more likely to be found on current systems.
5576 mtk, after a suggestion by Reuben Thomas <rrt@sc3d.org>
5577 Updated various header pages to accurately reflect which functions
5578 are and are not part of C89. Also fixed/improved a few other
5579 CONFORMING TO entries.
5583 s/Unices/Unix systems/ on the 5 pages where it appears.
5587 Wrapped long source lines in the following files
5632 Added a SEE ALSO reference for feature_test_macros(7) to all
5633 pages where a feature test macro appears in the SYNOPSIS.
5637 Added SEE ALSO entry pointing to time.7
5645 Fixed consecutive duplicate word typos on a number of pages.
5647 Typographical or grammatical errors have been corrected in several
5648 places. (Special thanks to Nicolas François!)
5651 Changes to individual pages
5652 ---------------------------
5656 Since 2.6.20, access() honors the MS_NOEXEC mount flag.
5657 Jorge Peixoto de Morais Neto / mtk
5658 Improve ENOENT description.
5662 Added some detail to the prototype.
5663 Added some notes on IA-64's clone2().
5667 Add text to note that EPOLLRDHUP appeared in kernel 2.6.17.
5671 Various fixes as per
5672 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411177
5673 * s/effective/real/ in description text.
5674 * added <fcntl.h> to synopsis.
5675 * various other changes.
5678 mtk / Fedora downstream patches; thanks to Ivana Varekova
5679 Added a few words to note that RLIMIT_NPROC is really a limit on
5687 Fedora downstream patches; thanks to Ivana Varekova
5688 s%linux/aio.h%libaio.h% in SYNOPSIS.
5689 Changed return type from "long" to "int".
5692 Samuel Thibault / mtk
5693 Fix EINVAL description.
5694 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411777
5698 Kernel 2.6.21 fixes several earlier bugs in mincore().
5700 Remove words "of a file" -- mincore() is describing
5701 memory residence information, not properties of a file.
5703 Rewrote various parts to make the page clearer.
5707 Rewrote and reorganized various parts to be clearer.
5708 Taken from Fedora downstream patches; thanks to Ivana Varekova
5709 Removed text stating that mmap() never returns 0; that's
5714 Document MS_RELATIME, new in Linux 2.6.20.
5718 On Linux, the error returned when opening a large file on a
5719 32-bit system is actually EFBIG, not EOVERFLOW.
5723 Fix RETURN VALUE description: returns error number of failure.
5727 Various improvements to DESCRIPTION.
5728 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=416012
5732 If sops contains multiple operations, then these are performed
5733 in array order. All Unix systems that I know of do this,
5734 and some Linux applications depend on this behavior. SUSv3
5735 made no explicit statement here, but SUSv4 will explicitly
5736 require this behavior.
5737 Small rewording of explanation of "atomically".
5741 Fix incorrect argument name in DESCRIPTION.
5743 Small wording improvement.
5747 Add reference to ipv6.7 page.
5755 Fix inconsistent argument names in SYNOPSIS and DESCRIPTION.
5759 Small wording clarification.
5762 mtk / Nicolas François
5763 Removed cryptic text under CONFORMING to referring to
5764 "open(2) and NFS". There is no relevant text in open.2 as
5765 far as I (mtk) can see.
5769 Remove sentence "gettimeofday() obsoleting time() on 4.3BSD".
5770 This information is old, and probably no longer relevant.
5771 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=403888
5774 mtk, after an idea from a downstream Fedora patch.
5775 Clarified discussion of /count == 0/ case.
5779 When the parent receives an event with PTRACE_EVENT_* set,
5780 the child is not in the normal signal delivery path. This
5781 means the parent cannot do ptrace(PTRACE_CONT) with a signal
5782 or ptrace(PTRACE_KILL). kill() with a SIGKILL signal can be
5783 used instead to kill the child process after receiving one
5788 Fix glibc version number in description of 'cpusetsize' argument.
5792 Stripped some excess/outdated text from the BUGS section.
5795 mtk / Jorge Peixoto de Morais Neto
5796 Add text to clarify that the pointer returned by these
5797 functions may be into some part of 'path'.
5800 Taken from Fedora downstream patches; thanks to Ivana Varekova
5801 + Carlo Marcelo Arenas Belon
5802 Add "#include <stdlib.h>" to example program.
5806 Complete rewrite. The existing page was hard to read,
5807 and the RETURN VALUE description seems to be wrong.
5811 Added getopt() example program.
5813 Add a few words to clarify the operation of the GNU-specific
5814 double-colon feature, which allows options to have optional
5816 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=352139
5823 mtk, after an idea from a downstream Fedora patch.
5824 Clarified description of inet_network().
5836 Small rewording to mention calloc().
5840 Fix return type in SYNOPSIS; as per
5841 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400971
5842 Needs _XOPEN_SOURCE == 600; as per
5843 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400975
5845 s/ptsname/posix_openpt/ in RETURN VALUE
5848 Taken from Fedora downstream patches; thanks to Ivana Varekova
5849 Add "#define _REGEX_RE_COMP" to SYNOPSIS.
5857 Added .SS headers to give some structure to this page; and a small
5858 amount of reordering.
5860 Added a section on canonical and non-canonical mode.
5862 Enhanced the discussion of "raw" mode for cfmakeraw().
5866 Make description of PARODD a little clearer.
5868 Add SEE ALSO link to tty_ioctl.4
5870 Add SEE ALSO link to console_ioctl.4
5874 Removed BSD prototype from synopsis.
5879 Removed BSD prototype from synopsis.
5883 Taken from Fedora downstream patches; thanks to Ivana Varekova
5884 s/curses/ncurses/ under SEE ALSO
5887 Taken from Fedora downstream patches; thanks to Ivana Varekova
5888 Documented "mem=nopentium".
5890 feature_test_macros.7
5892 The default treatment of _POSIX_C_SOURCE changed in glibc 2.4.
5893 mtk, after a suggestion by Justin Pryzby
5894 Added some text warning that the "__" macros that
5895 <features.h> defines internally should never be
5896 directly defined by programs.
5897 mtk, based on notes by Jakub Jelinek
5898 Document _FORTIFY_SOURCE
5899 (See http://gcc.gnu.org/ml/gcc-patches/2004-09/msg02055.html )
5901 Document _REENTRANT and _THREAD_SAFE.
5904 mtk / Nicolas François
5905 Remove CONFIGURATION section, since this does not seem to be
5910 Fix data types in associated data structures;
5911 remove nonexistent semzcnt and semncnt fields.
5915 Since kernel 2.6.20, the software clock can also be 300 HZ.
5918 ==================== Changes in man-pages-2.45 ====================
5920 Released: 2007-04-05
5925 This release consists mainly of formatting fixes (to a large
5926 number of pages) to achieve greater consistency across pages.
5927 With the exception of the few individual changes noted below,
5928 no changes were made to content.
5930 Changes to individual pages
5931 ---------------------------
5939 Clarified RETURN VALUE text
5943 Rewrote prototype using modern C syntax.
5946 ==================== Changes in man-pages-2.46 ====================
5948 Released: 2007-04-06
5953 This release consists mainly of formatting fixes (to a large
5954 number of pages) to achieve greater consistency across pages:
5956 * Most instances of two or more consecutive blank lines in man
5957 page output were shrunk to a single line.
5958 * A number of example programs were reformatted
5959 to more closely match K&R style.
5960 * In various places (mainly code examples), the use of tabs was
5963 With the exception of the few individual changes noted below,
5964 no changes were made to content.
5967 Changes to individual pages
5968 ---------------------------
5972 Add <sys/kdaemon.h> header file to SYNOPSIS.
5974 sched_rr_get_interval.2
5976 Moved timespec definition from SYNOPSIS into description.
5980 Make SYNOPSIS match select.2.
5983 ==================== Changes in man-pages-2.47 ====================
5985 Released: 2007-05-04
5990 The following people contributed notes, ideas, or patches that have
5991 been incorporated in changes in this release:
5993 Andi Kleen <andi@firstfloor.org>
5994 John Heffner <jheffner@psc.edu>
5996 Apologies if I missed anyone!
6002 This release consists mainly of changes to source file layout
6003 (wrapped long lines; stripped trailing white space; started new
6004 sentences on new lines).
6006 There is very little change to output formatting or content (see the
6010 Changes to individual pages
6011 ---------------------------
6013 sched_rr_get_interval.2
6015 Remove crufty statement that this system call is not implemented.
6016 The nice interval can be used to control the size of
6017 the round-robin quantum.
6022 Document IP_PMTUDISC_PROBE, which will be in 2.6.22.
6025 ==================== Changes in man-pages-2.48 ====================
6027 Released: 2007-05-04
6032 The following people contributed notes, ideas, or patches that have
6033 been incorporated in changes in this release:
6035 Colin Watson <cjwatson@debian.org>
6036 Justin Pryzby <justinpryzby@users.sourceforge.net>
6038 Apologies if I missed anyone!
6044 This release consists mainly of changes to source file layout
6045 (wrapped long lines; stripped trailing white space; started new
6046 sentences on new lines).
6048 There is very little change to output formatting or content (see the
6053 In various places where it occurred,
6054 s/nonnegative/non-negative/
6058 s/wide character/wide-character/ when used attributively.
6061 Changes to individual pages
6062 ---------------------------
6065 Justin Pryzby / Colin Watson / mtk
6066 .SH doesn't require quotes.
6067 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411303
6070 ==================== Changes in man-pages-2.49 ====================
6072 Released: 2007-05-20
6077 The following people contributed notes, ideas, or patches that have
6078 been incorporated in changes in this release:
6080 Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
6081 Bruno Haible <bruno@clisp.org>
6082 Justin Pryzby <justinpryzby@users.sourceforge.net>
6084 Apologies if I missed anyone!
6092 Documentation of bsd_signal().
6096 Manual page for euidaccess() and eaccess().
6100 Documentation of getsubopt().
6104 Documentation of sysv_signal().
6112 New link to epoll_wait.2.
6116 New link to new euidaccess.3,
6120 New link to sem_wait.3.
6124 New link to sem_wait.3.
6130 Typographical or grammatical errors have been corrected in several
6134 Changes to individual pages
6135 ---------------------------
6139 Added SEE ALSO ref to new euidaccess.3 page.
6143 Added description of epoll_pwait(), new in kernel 2.6.19.
6147 Add text noting that Linux allows 'argv' and 'envp' to be
6148 NULL, but warning that this is non-standard and non-portable,
6149 and should be avoided in portable programs.
6150 Bug filed (http://bugzilla.kernel.org/show_bug.cgi?id=8408)
6151 to get this changed, but maybe that won't be done because it
6154 Added an example program.
6156 Expanded the discussion of interpreter scripts and the
6157 'optional-arg' argument of an interpreter script.
6158 For further info, see
6159 http://homepages.cwi.nl/~aeb/std/hashexclam-1.html
6160 http://www.in-ulm.de/~mascheck/various/shebang/
6162 Added text noting that FD_CLOEXEC causes record locks to be
6165 Mention effect of MS_NOSUID mount(2) flag for set-user-ID
6168 Expanded description of handling of file descriptors during
6169 execve(), adding text to note that descriptors 0, 1, and 2
6170 may be treated specially.
6174 Added SEE ALSO ref to new euidaccess.3 page.
6178 Place MAP_* flags list in alphabetical order.
6182 A fairly substantial rewrite, which among other things
6183 fixes the problem reported by Kyle Sluder in
6184 http://bugzilla.kernel.org/show_bug.cgi?id=8399
6185 And added some example code.
6189 Added text referring to the discussion of async-signal-safe
6190 functions in signal(7).
6191 A few other minor formatting and wording changes.
6195 Moved the discussion of async-signal-safe functions to signal(7).
6196 Added text referring to the discussion of async-signal-safe
6197 functions in signal(7).
6198 Added SEE ALSO entries referring to new bsd_signal.3 and
6199 sysv_signal.3 pages.
6203 Clarify discussion of negative zero.
6207 Add SEE ALSO ref to new getsubopt.3.
6211 Describe the glibc/libiconv //TRANSLIT and //IGNORE extensions
6216 Update CONFORMING TO; iswblank() is in POSIX.1-2001.
6220 Definitions for IN_DONT_FOLLOW, IN_MASK_ADD, and IN_ONLYDIR
6221 were added to glibc in version 2.5.
6225 Incorporated (and slightly modified) the text on
6226 async-signal-safe functions that was formerly in signal(2).
6227 Added SEE ALSO entries referring to new bsd_signal.3 and
6228 sysv_signal.3 pages.
6231 ==================== Changes in man-pages-2.50 ====================
6233 Released: 2007-05-21
6238 The following people contributed notes, ideas, or patches that have
6239 been incorporated in changes in this release:
6241 Andreas Halter <halter@google.com>
6242 Laird Shaw <netocrat@dodo.com.au>
6243 Mike Frysinger <vapier@gentoo.org>
6245 Apologies if I missed anyone!
6250 Most Section 1 man pages are removed
6251 mtk (with help from Mike Frysinger, Laird Shaw, Andreas Halter)
6252 Once upon time Andries added a number of Section 1 manual pages
6253 to man-pages. However, since that time, those pages have not
6254 seen much maintenance, and are not in fact distributed in most
6255 distributions. Instead most distributions supply the
6256 coreutils versions of these pages, which are currently
6257 maintained. In addition, man-pages provides the 1p pages,
6258 which document the portable subset of functionality of these
6259 commands. Since the man1 pages are mostly unneeded, and
6260 out of date, I'm removing them. The following pages disappear:
6284 The following Section 1 pages will be kept:
6291 ==================== Changes in man-pages-2.51 ====================
6293 Released: 2007-05-28
6300 (Hopefully) all cross references outside a page now include a
6301 section number. This should permit better resulting output
6302 from a man2html-type conversion.
6306 Convert function formatting of the form "\fBname\fP()" to
6310 Changes to individual pages
6311 ---------------------------
6315 s/futimes/futimesat/ in .SH NAME line.
6319 Put "msgrcv" and "msgsnd" in .SH NAME line.
6323 Add "umount2" to .SH NAME line.
6327 Add "waitid" to .SH NAME line.
6331 Add "getopt_long" and "getopt_long_only" in .SH NAME line.
6335 Add "sem_timedwait" and "sem_trywait" to .SH NAME line.
6339 Add "va_start", "va_arg", "va_end", "va_copy" to .SH NAME line.
6342 ==================== Changes in man-pages-2.52 ====================
6344 Released: 2007-05-29
6346 "A foolish consistency is the hobgoblin of little minds, adored by
6347 little statesmen and philosophers and divines"
6349 Ralph Waldo Emerson (1803-1882)
6351 "But damn it, these man pages are a mess!"
6357 Most of the changes below are about bringing greater consistency
6358 to manual pages, including reducing the wide range of .SH
6361 Typographical or grammatical errors have been corrected in several
6366 Make 'manual' component of .TH line into the string
6367 "Linux Programmer's Manual".
6368 Reason: consistency.
6372 Changed date in .TH line into form YYYY-DD-MM.
6373 Reason: consistency.
6377 Some .SH header lines were made into .SS lines. (One of the aims
6378 here is to reduce the number of non-standard .SH lines.)
6382 Change title .SH sections named "NOTE" to "NOTES", in some cases
6383 also changing the location of the section within the page.
6384 Reason: consistency.
6388 Commented out .SH AUTHOR sections; the right place for
6389 documentation authorship sections is usually comments at the
6390 top of the page source.
6394 Changed .SH HISTORY to .SH VERSIONS.
6395 Reason: in many cases, HISTORY was being used to describe
6396 Linux/glibc version information, as was already done for
6397 VERSIONS sections in other pages.
6401 Removed HISTORY section, or moved it as a subsection or paragraphs
6402 under another section e.g., NOTES.
6403 Reason: there are too many arbitrary section (.SH) names, and
6404 a HISTORY section never was consistently used across Linux
6409 Moved SEE ALSO section to be last section on the page
6410 Reason: consistency -- and this is where SEE ALSO should be!
6414 Relocated GLIBC NOTES as subsection under NOTES
6415 Reason: reduce number of arbitrary section (.SH) names.
6419 Relocated LINUX NOTES as subsection under NOTES
6420 Reason: reduce number of arbitrary section (.SH) names.
6424 Renamed some "AVAILABILITY" sections to "VERSIONS".
6425 Reason: consistency.
6429 Renamed some "DIAGNOSTICS" sections to "RETURN VALUE".
6430 Reason: consistency.
6435 s/\.SH ENVIRONMENT VARIABLES/.SH ENVIRONMENT/
6436 Reason: consistency.
6456 s/return 0/exit(EXIT_FAILURE)/ in main() of function example
6458 Reason: consistency.
6470 Use symbolic constants (EXIT_SUCCESS, EXIT_FAILURE) in calls
6472 Reason: consistency.
6481 Renamed RESTRICTIONS section to NOTES, or moved text in a
6482 RESTRICTIONS section under existing NOTES section.
6483 Reason: consistency, and reduce number of arbitrary section (.SH)
6487 Changes to individual pages
6488 ---------------------------
6492 s/\.SH FURTHER INFORMATION/.SH NOTES/
6496 s/\.SH WARNING/.SH NOTES/
6499 Renamed LINUX HISTORY section to LINUX NOTES, and relocated
6504 Relocated example program and made its .SH title "EXAMPLE".
6508 Move code example into its own EXAMPLE section.
6512 s/\.SH WARNING/.SH NOTES/
6516 s/\.SH "LINUX-SPECIFIC REMARKS"/.SH LINUX NOTES/
6520 Remove section about effect of fork()/exec()/exit(); shmop.2
6521 contains the same text, and it only needs to be said once.
6525 Minor rewording under DESCRIPTION.
6529 Minor wording and formatting changes.
6533 Removed statement that glibc unconditionally exposes declarations
6534 of encrypt() and setkey(), since portable applications must
6535 use <unistd.h> and define _XOPEN_SOURCE to obtain the declarations
6536 of setkey() and encrypt(). Adjusted example program accordingly.
6544 Minor wording and formatting changes.
6548 Substantial rewrite, revising and extending the discussion
6549 about desired conventions for writing pages.
6550 There will be further updates to this page in the next few
6554 ==================== Changes in man-pages-2.53 ====================
6556 Released: 2007-05-30
6558 "A foolish consistency is the hobgoblin of little minds, adored by
6559 little statesmen and philosophers and divines"
6561 Ralph Waldo Emerson (1803-1882)
6563 "But damn it, these man pages are a mess!"
6571 Reordered sections to be more consistent, in some cases renaming
6572 sections or shifting paragraphs between sections.
6576 In various pages in this section, .SH headings were
6580 ==================== Changes in man-pages-2.54 ====================
6582 Released: 2007-06-07
6587 The following people contributed notes, ideas, or patches that have
6588 been incorporated in changes in this release:
6590 Emmanuel Mogenet <emogenet@google.com>
6591 Michael Berg <michaeljberg@gmail.com>
6593 Apologies if I missed anyone!
6601 Where there is an instruction in the SYNOPSIS about linking
6602 or compiling with a certain option, the option is now
6603 marked up in italics (e.g., "\fI-lm\fP").
6607 Added page numbers to page cross references.
6611 s/manpage/man page/, for consistency.
6613 Typographical or grammatical errors have been corrected in several
6622 A description of the conventions that should be followed
6623 when writing pages for the man-pages package.
6630 Already deleted most of the man1 pages previously, so
6631 this doesn't need to stay.
6635 Removed this page since it is out of date, and the proper place
6636 to go for up-to-date information is http://www.tldp.org/
6640 Reason: this was the only Section 9 page, and it is old
6641 (Linux 2.4). The man9 section never took off as an idea, and
6642 I see little point in keeping a Section 9 with just a single
6646 Changes to individual pages
6647 ---------------------------
6651 Moved some material out of here into new man-pages.7.
6655 Minor rewrites, eliminating some duplication, and removing
6660 Fix broken link path;
6661 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=425570
6665 Remove misleading text about setting O_ASYNC when calling
6666 open(); one must use fcntl() F_SETFL for this task.
6670 Converted outdated BUGS note about fdatasync() being
6671 equivalent to fsync() on Linux 2.2 into a NOTES note
6672 about this historical behavior.
6676 Small rewording to fix "fails with the error EWOULDBLOCK"
6677 rather than "returns EWOULDBLOCK".
6678 See Red Hat bug 172828.
6681 mtk, after an observation by Emmanuel Mogenet
6682 A much improved example program.
6684 Significant rewrites and additions to description.
6688 Remove text about the nonexistent BSD mremap() -- too
6689 much information, in my opinion.
6693 Added ERRORS section.
6697 Moved text for "Versions and Library Support".
6701 Small rewording in RETURN VALUE section.
6705 Add EXAMPLE section with a pointer to example in mprotect.2.
6709 Fix return type in SYNOPSIS. Add RETURN VALUE section.
6713 Small rearrangement of text under NOTES.
6717 Rewrite and substantial additional text.
6721 Minor clarifications for text on execlp() and execvp(). Removed
6722 FILES section, since it provides no useful additional info.
6726 Moved link instructions from NOTES to SYNOPSIS.
6727 Added feenableexcept, fedisableexcept, fegetexcept
6732 Added 'putwc' to .SH NAME list.
6736 s/int/socklen_t/ for type of gethostbyaddr() 'len' argument,
6737 and add a few more words in NOTES about the type used here.
6741 Removed remark from NOTES about linking with -lutil; add
6742 text on that point to SYNOPSIS.
6746 Removed redundant remark from NOTES about linking with -lutil
6747 since there is text on that point under SYNOPSIS.
6751 Added SEE ALSO referring to getconf(1).
6755 Revised .SH NAME section.
6759 Minor rearrangement of order of text.
6763 s/exec()/execve(2)/ in various places.
6767 Changed "atan(1)" to "atan(1.0)" to prevent some versions of
6768 man2html(1) from mistaking that string as a page cross reference.
6772 Small restructuring to avoid 'cannot adjust line' from man(1).
6776 Removed now very out-of-date sentence about need to link shared
6781 Various text was moved out of this page into the new man-pages.7.
6785 Added SEE ALSO referring to new man-pages.7.
6789 A few changes, hopefully done right, to eliminate some
6790 errors to stderr when rendering with man(1).
6794 Shorten a line in table so it fits in 80 columns.
6795 Minor rewording under BUGS.
6799 Moved EXIT STATUS section.
6802 ==================== Changes in man-pages-2.55 ====================
6804 Released: 2007-06-10
6809 The following people contributed notes, ideas, or patches that have
6810 been incorporated in changes in this release:
6812 Alexander Taboriskiy <alextab@math-solution.com>
6813 Joey Hess <joeyh@debian.org>
6814 John Reiser <jreiser@bitwagon.com>
6815 Julien Cristau <jcristau@debian.org>
6816 Justin Pryzby <justinpryzby@users.sourceforge.net>
6817 Martin (Joey) Schulze <joey@infodrom.org>
6818 Mike Frysinger <vapier@gentoo.org>
6819 Serge van den Boom <svdb@stack.nl>
6820 Ulrich Drepper <drepper@redhat.com>
6821 Xose Vazquez Perez <xose.vazquez@gmail.com>
6823 Apologies if I missed anyone!
6843 mtk, after a note by Mike Frysinger
6844 Updated to reflect the fact that the _syscallN() macros
6849 Change reference to path_resolution.2 to path_resolution.7.
6851 Typographical or grammatical errors have been corrected in several
6858 path_resolution.2 has been moved to section 7, thus path_resolution.7
6860 Reason: this is an overview page, not one describing as
6861 a specific system call.
6864 Changes to individual pages
6865 ---------------------------
6868 mtk, after a note from Xose Vazquez Perez
6869 Added pointer to Red Hat man-pages bugzilla.
6871 Added a release philosophy note on separating out big
6872 formatting changes into their own release that contains minimal
6877 Add new EXAMPLE section with pointer to example in bind.2.
6881 Added RETURN VALUE section.
6885 Expand example program, and move it to new EXAMPLE section.
6886 Added text pointing to example in getaddrinfo.3.
6890 Convert NOTES section to CONFORMING TO and note that
6891 this call is Linux-specific.
6892 Other minor rewordings.
6896 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6905 Small rewrite of SEE ALSO text pointing to Documentation/* in
6910 Added ERRORS heading
6915 Added an ERRORS section.
6919 Added a RETURN VALUE section.
6923 Added an ERRORS section (stating that the calls are
6928 Add SEE ALSO reference to ioctl.2.
6932 Add new EXAMPLE section with pointer to example in bind.2.
6935 Martin (Joey) Schulze
6940 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6942 sched_get_priority_max.2
6943 sched_rr_get_interval.2
6944 sched_setscheduler.2
6951 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6955 Added an ERRORS section (stating that the call is
6959 mtk, after a note from Alexander Taboriskiy
6960 Strengthen warning against the use of signal().
6961 Added siginterrupt(3) to SEE ALSO list.
6963 Rewrote various parts; added an ERRORS section.
6967 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6971 Added EXAMPLE program.
6975 Converted to -man format; some rewrites; added an EXAMPLE.
6979 Improved the example program.
6983 Add text pointing to example in getaddrinfo.3.
6987 Add example programs.
6988 Add getnameinfo() to SEE ALSO list.
6991 mtk / Serge van den Boom
6992 Clarify discussion of what happens if 'src' and 'dest' overlap.
6996 Add grep(1) to SEE ALSO list.
6999 mtk after a note from Ulrich Drepper
7000 Clarify discussion of feature test macros that are needed to
7001 expose System V and BSD versions of this function in glibc.
7005 Removed some functions that have been documented.
7008 Martin (Joey) Schulze
7009 Remove wscanf.3 from SEE ALSO list, since that page does not exist.
7013 Removed outdated note on xdm.
7014 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=418009
7015 Martin (Joey) Schulze
7016 Removed outdated note about Debian and libc5.
7019 Martin (Joey) Schulze
7020 Fix order of commands listed under 'init='.
7024 Add /media, remove /dos.
7025 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=418234
7029 Added text describing what happens when the buffer given to
7030 read(2) is too small to return information about the next event,
7031 and noting the behavior change in 2.6.21.
7035 Added text to note that ERRORS list should be in alphabetical order.
7040 Added SEE ALSO reference to groff_mdoc(7).
7044 Added EXAMPLE section with pointer to bind.2 EXAMPLE.
7048 Simplify text describing --inhibit-rpath.
7049 mtk, after a note by John Reiser
7050 Describe use of $ORIGIN in rpath.
7053 ==================== Changes in man-pages-2.56 ====================
7055 Released: 2007-06-11
7062 Removed version numbers in .TH lines.
7063 Reason: these were only arbitrarily updated, and so impart no
7064 useful information. Version information goes into a
7065 VERSIONS section nowadays, and the date in the .TH line should
7066 be updated to reflect the date of the last (significant)
7069 Typographical or grammatical errors have been corrected in several
7073 ==================== Changes in man-pages-2.57 ====================
7075 Released: 2007-06-17
7080 The following people contributed notes, ideas, or patches that have
7081 been incorporated in changes in this release:
7083 Samuel Thibault <samuel.thibault@ens-lyon.org>
7085 Apologies if I missed anyone!
7093 Fix section numbers in page cross references.
7096 Changes to individual pages
7097 ---------------------------
7101 Minor wording fixes.
7102 Small clarification of description of 'mode'.
7106 Small reworking of EXAMPLE program.
7110 Minor wording fixes.
7114 Added more detail on exit handlers.
7115 Minor wording fixes.
7119 Remove SEE ALSO reference to nonexistent mt.4.
7122 Samuel Thibault / mtk
7123 In Linux 2.6, the 'modify_ldt_ldt_s' structure was renamed
7125 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=378668
7127 Include definition of 'user_desc' structure.
7132 Small reworking of EXAMPLE program.
7136 Removed reference to nonexistent sigsend(2).
7140 Remove SEE ALSO reference to nonexistent itoa.3.
7144 Removed SEE ALSO reference to nonexistent time.3.
7148 Removed SEE ALSO reference to nonexistent fcrypt.3.
7152 Small reworking of EXAMPLE program.
7156 Remove SEE ALSO reference to nonexistent fclean.3.
7160 s/ttyname(0)/ttyname(STDIN_FILENO)/ in program example.
7164 s/exit(1)/exit(EXIT_FAILURE)/
7168 Correct some section numbers in page cross references.
7172 Modify requirements for example programs a little.
7176 Wrapped long source lines.
7179 ==================== Changes in man-pages-2.58 ====================
7181 Released: 2007-06-24
7186 The following people contributed notes, ideas, or patches that have
7187 been incorporated in changes in this release:
7189 Marc Boyer <marc.boyer@enseeiht.fr>
7190 Mike Frysinger <vapier@gentoo.org>
7192 Apologies if I missed anyone!
7198 Various pages, as detailed below
7200 Added or updated VERSIONS sections.
7224 Add SEE ALSO link to new credentials.7.
7232 An overview of Linux process identifiers (PIDs, PPIDs,
7233 PGIDS, SIDs, UIDs, GIDs).
7236 Changes to individual pages
7237 ---------------------------
7241 Added some comments to example program.
7245 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7249 Updated discussion of somaxconn limit.
7253 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7257 VERSIONS: Glibc support has been provided since version 2.2.
7261 Added VERSIONS section.
7265 Updated VERSIONS section with text on glibc support.
7269 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7273 Added VERSIONS section with info on semtimedop().
7277 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7281 VERSIONS: Supported since glibc 2.2.4.
7285 Added VERSIONS section.
7289 VERSIONS: Supported since glibc 2.2.1.
7292 mtk after a suggestion by Mike Frysinger
7293 Add text to the introductory part of DESCRIPTION, about the
7294 'size' argument of snprintf() and vsnprintf().
7298 Added VERSIONS section; rewrote info about linking with -lrt.
7302 Improve the discussion of strncat().
7306 Improve the discussion of strncpy().
7310 Added discussion of /proc/sys/net/core/somaxconn.
7313 ==================== Changes in man-pages-2.59 ====================
7315 Released: 2007-06-25
7320 Manual pages are now standardized on American spelling. See
7321 http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences
7322 for more information on the differences. Formerly, different pages (and
7323 sometimes even a single page!) employed American and British spelling
7324 conventions; best to standardize on one spelling, and American English
7325 is the standard in Computer Science.
7327 Changes to individual pages
7328 ---------------------------
7332 Note that man-pages has now standardized on American spelling
7353 Corrected minor spelling/wording mistakes (i.e., changes
7354 independent of fixes for American spelling).
7357 ==================== Changes in man-pages-2.60 ====================
7359 Released: 2007-06-25
7367 Wrapped lines in some files.
7371 Change "e.g. " to "e.g., ", or in some cases, "for example, ".
7375 Change "i.e. " to i.e., ", or in some cases, "that is, ".
7379 Removed AUTHORS section.
7381 Typographical or grammatical errors have been corrected in several
7385 Changes to individual pages
7386 ---------------------------
7390 s/w.r.t/with respect to/
7394 Strengthened warning against use of AUTHORS section.
7397 ==================== Changes in man-pages-2.61 ====================
7399 Released: 2007-07-01
7405 The following people contributed notes, ideas, or patches that have
7406 been incorporated in changes in this release:
7408 Alain Portal <aportal@univ-montp2.fr>
7409 Benno Schulenberg <bensberg@justemail.net>
7410 Florian Ernst <florian_ernst@gmx.net>
7411 Ivana Varekova <varekova@redhat.com>
7412 Jeff Schroeder <jeffschroeder@computer.org>
7413 Joey (Martin) Schulze <joey@infodrom.org>
7414 Justin Pryzby <justinpryzby@users.sourceforge.net>
7415 Loïc Minier <lool@dooz.org>
7416 Michael Gehring <mg@ebfe.org>
7417 Serge van den Boom <svdb@stack.nl>
7418 Stefan Puiu <stefanpuiuro@yahoo.com>
7419 Stepan Kasal <kasal@ucw.cz>
7421 Apologies if I missed anyone!
7429 substitute `\\0' by '\\0'.
7433 s/`/'/ when the thing being quoted is a character.
7442 mtk after a note by Martin (Joey) Schulze
7443 Add NOTES paragraph noting that <sys/types.h> isn't required by
7444 POSIX.1-2001 or Linux, but was required on some implementations.
7457 Replace form `...' with \fI...\fP where the enclosed string
7458 is a pathname, type name, or argument name.
7462 s/process' /process's/
7472 Add section number to page cross references.
7479 Reordered .SH sections.
7486 Made CONFIG/CONFIGURING heading ==> CONFIGURATION
7502 Reformatted headings
7509 mtk, with input from Justin Pryzby and Stefan Puiu
7510 Documents backtrace(), backtrace_symbols(), and
7511 backtrace_symbols_fd().
7518 backtrace_symbols_fd.3
7520 Links to backtrace.3.
7527 Changes to individual pages
7528 ---------------------------
7532 Fix setting of 'prefix' macro.
7536 Fix bad text (concatenated line).
7540 Fixed description of EACCES error.
7541 Added sentence defining "current working directory".
7542 Other minor wording changes.
7546 Added SEE ALSO section.
7554 Minor wording changes.
7558 Fix small wording error.
7562 Add NOTES on what happens if gethostid() can't open /etc/hostid.
7566 Made NOTES text into a VERSIONS section, since that's what it
7571 Minor wording changes.
7575 Rewrite to reflect the fact that the _syscallN
7576 macros are no longer available.
7580 Add "Link with -laio" to SYNOPSIS.
7584 Add "Link with -laio" to SYNOPSIS.
7588 Add "Link with -laio" to SYNOPSIS.
7592 Add "Link with -laio" to SYNOPSIS.
7596 Fix include in SYNOPSIS.
7598 Add "Link with -laio" to SYNOPSIS.
7602 Add semtimedop() to SEE ALSO.
7603 Note that some architectures don't have ipc(2); instead
7604 real system calls are provided for shmctl(), semctl(), etc.
7608 Minor wording changes.
7612 Added <sys/types.h> to SYNOPSIS.
7614 sched_setscheduler.2
7616 Add NOTES para about permissions required to call
7617 sched_setscheduler() on other systems.
7621 Noted that 'timeout' can also be changed if select() is
7622 interrupted by a signal.
7626 Remove reference to _syscall0() macro.
7630 Changed text for EINVAL error.
7634 Add recvmsg() and sendmsg() to SEE ALSO.
7635 Note that some architectures don't have socketcall(2); instead
7636 real system calls are provided for socket(), bind(), etc.
7639 Ivana Varekova / mtk
7640 Update text for EPERM error describing the maximum number of
7641 swap files. (From downstream Fedora patch.)
7645 Added details about seekable files and file offset.
7646 Noted that write() may write less than 'count' bytes, and
7647 gave some examples of why this might occur.
7648 Noted what happens if write() is interrupted by a signal.
7649 Minor wording changes.
7653 Added a CONFORMING TO section; other minor edits.
7657 Minor rewrites in code example.
7661 Make SEE ALSO refer to timegm.3
7665 Small wording change.
7669 Comment was missing closing "*/".
7673 Formatting changes, and minor rewordings.
7674 mtk, after a note by Serge van den Boom
7675 Add a comment explaining the need for the rather
7676 strange cast of the return value of dlsym().
7680 Add "isinf" to NAME section.
7688 Minor rewording, and note that '*n* is ignored
7689 if '*lineptr' is NULL.
7692 Ivana Varekova / mtk
7693 Update description of MALLOC_CHECK_ to include description
7694 for value 3. (From downstream Fedora patch.)
7698 Added a CONFORMING TO section; other minor edits.
7702 Minor changes to SYNOPSIS.
7704 program_invocation_name.3
7706 Shortened page title to INVOCATION_NAME.
7710 Added a CONFORMING TO section; other minor edits.
7714 Fix duplicated word "the".
7715 (Really fix http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=412467 !)
7719 Small wording change.
7723 Added a CONFORMING TO section.
7727 Added a CONFORMING TO section.
7733 Note use of "gcc -Wno-format-y2k" to avoid the "`%c' yields only
7734 last 2 digits of year in some locales" warning.
7738 Add "strcasestr" to NAME section.
7742 Small wording change.
7748 Added a CONFORMING TO section.
7752 Small wording changes.
7756 Remove erroneous text saying that glibc does not provide
7757 <ulimit.h>; it does.
7761 Various reformattings.
7765 Added a sentence noting why core dumps named "core.PID" were useful
7770 Fix capitalization in .SS headings.
7776 feature_test_macros.7
7778 Added SEE ALSO section.
7782 Reformatted headings; minor rewrites.
7786 Reformatted headings; minor rewrites.
7789 Loïc Minier <lool@dooz.org>
7790 Document argument type for SO_REUSEADDR.
7791 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=255881
7795 Wrap long line in SYNOPSIS.
7799 Added SEE ALSO section.
7802 ==================== Changes in man-pages-2.62 ====================
7804 Released: 2007-07-09
7806 This release consists solely of formatting fixes. There are no changes
7812 The following people contributed notes, ideas, or patches that have
7813 been incorporated in changes in this release:
7815 Stepan Kasal <kasal@ucw.cz>
7817 Apologies if I missed anyone!
7825 Many many formatting fixes.
7829 Add section number to .TH line for POSIX pages in man[013]p.
7832 ==================== Changes in man-pages-2.63 ====================
7834 Released: 2007-07-16
7840 The following people contributed notes, ideas, or patches that have
7841 been incorporated in changes in this release:
7843 Arnd Bergmann <arndb@de.ibm.com>
7844 Eduardo M. Fleury <efleury@br.ibm.com>
7845 Ivana Varekova <varekova@redhat.com>
7846 Justin Pryzby <justinpryzby@users.sourceforge.net>
7847 Marc Boyer <marc.boyer@enseeiht.fr>
7848 Martin (Joey) Schulze <joey@infodrom.org>
7849 Martin Röhricht <martin@roehricht.info>
7850 Patrick Mansfield <patmans@us.ibm.com>
7851 Pierre Habouzit <madcoder@debian.org>
7852 Stepan Kasal <kasal@ucw.cz>
7854 Apologies if I missed anyone!
7874 Minor wording changes.
7880 Added SEE ALSO reference to syscalls.2.
7888 A real man page for sgetmask(2) and ssetmask(2).
7889 (This page replaces a previous link of the same name, which
7890 linked to signal.2.)
7893 Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7894 Document the PowerPC SPU spu_create() system call.
7895 (Originally taken from the kernel source file
7896 Documentation/filesystems/spufs.txt.)
7899 Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7900 Document the PowerPC SPU spu_run() system call.
7901 (Originally taken from the kernel source file
7902 Documentation/filesystems/spufs.txt.)
7905 Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7906 Document the PowerPC SPU file system.
7907 (Originally taken from the kernel source file
7908 Documentation/filesystems/spufs.txt.)
7916 This file was created by accident in 2.61, as a copy of clone.2.
7917 (it should have been a link to clone.2.)
7921 Details on this page are covered in syscalls.2 and in
7922 respective syscall man pages (stat.2, uname.2).
7926 This page is very out of date, and in any case difficult
7927 to maintain. Information about undocumented system calls
7928 is maintained in the HOWTOHELP file, and probably in other
7933 This rather incomplete page seems unnecessary since there
7960 Added as link to corresponding page without "32".
7976 Added as link to corresponding page without "64".
7985 Link to getrlimit.2.
7993 Added as links to corresponding section 3 pages.
7998 Links to posix_fadvise.2.
8005 Added as link to corresponding page without "rt_" prefix.
8014 mtk / Ivana Varekova
8015 Link to unimplemented.2.
8018 Changes to individual pages
8019 ---------------------------
8023 Fairly substantial rewrites of various parts,
8024 and a few additions.
8028 Update SYNOPSIS to reflect the fact that fchmod(2) needs
8029 either "#define _XOPEN_SOURCE 500" or "#define _BSD_SOURCE".
8033 Update SYNOPSIS to reflect the fact that fchmod(2) and lchown(2)
8034 need either "#define _XOPEN_SOURCE 500" or "#define _BSD_SOURCE".
8035 Added an example program.
8039 Note that killpg() is actually a library function on Linux.
8043 Added note that glibc mmap() wrapper nowadays invokes mmap2().
8046 Ivana Varekova / mtk
8047 On most platforms the unit for 'offset' is 4096 bytes, not
8048 the system page size.
8050 Rewrote NOTES to note that glibc mmap() wrapper nowadays
8051 invokes this system call.
8053 Added an EXAMPLE program.
8059 Changed link to point to stat.2 (instead of obsolete.2).
8064 Changed link to point to uname.2 (instead of obsolete.2).
8068 Added _GNU_SOURCE to SYNOPSIS.
8072 Remove reference discussion of ipc(2), since none of the
8073 other System V IPC pages mention ipc(2).
8077 Add an example code segment.
8081 Add svipc(7) to SEE ALSO list.
8085 Reformatted tables as lists; other minor reformattings and
8090 Added info on rt_sigqueueinfo(2).
8094 Noted that sigwaitinfo() is a library function implemented on
8095 top of sigtimedwait().
8099 Make this link point to new sgetmask.2 instead of signal.2.
8103 Add notes on the different system call interfaces that
8104 have appeared over time.
8108 A fairly substantial rewrite of this page,
8109 bringing it up to date with the current
8110 kernel version, and listing all system calls
8115 Add notes on the different system call interfaces that
8116 have appeared over time.
8120 Add vserver, madvise1 to NAME line.
8121 Removed SEE ALSO reference to obsolete.2.
8123 Add tuxcall to NAME line.
8127 Fix description of return value.
8131 Minor fix to example program.
8135 Add section numbers to function names; remove some functions
8136 since they are documented.
8140 Update/correct text on /proc/malloc.
8141 mtk, after a note by Pierre Habouzit, and a few comments by Justin Pryzby
8142 Update description of /proc/PID/stat to match 2.6.21.
8143 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=417933
8147 IN_DONT_FOLLOW and IN_ONLYDIR are only available from 2.6.15.
8151 Note SIGRTMIN value depends on glibc.
8153 Various rewrites and additions to the text in real-time signals.
8154 Add SEE ALSO reference to sgetmask.2.
8158 Add ipc(2) to SEE ALSO.
8161 ==================== Changes in man-pages-2.64 ====================
8163 Released: 2007-07-27
8169 The following people contributed notes, ideas, or patches that have
8170 been incorporated in changes in this release:
8172 Aleksandr Koltsoff <czr@iki.fi>
8173 Andries Brouwer <Andries.Brouwer@cwi.nl>
8174 Justin Pryzby <justinpryzby@users.sourceforge.net>
8176 Apologies if I missed anyone!
8370 Added/updated feature test macro requirements for
8371 glibc; see feature_test_macros.7 for details.
8373 Changes to individual pages
8374 ---------------------------
8386 Fairly substantial changes and corrections, including adding
8387 coverage of all of the interfaces that get/set PGIDs.
8391 Various rewordings; clear up some imprecisions.
8395 Added 'signgam' to SYNOPSIS and NAME line.
8399 Note that the XPG version is provided since glibc 2.3.4.
8400 The page formerly said that the GNU-specific version
8401 is provided by default. That certainly isn't true
8402 nowadays, since _POSIX_C_SOURCE is set to 200112L by
8403 default, so that the XSI-compliant version is supplied
8408 Added note pointing to feature_test_macros.7 for a description
8409 of how feature test macro requirements should be specified in
8410 manual pages. Various other minor fixes and changes.
8412 feature_test_macros.7
8414 Added note about how feature test macros are specified
8416 Many other corrections, improvements, additions, and
8417 details about differences across glibc versions.
8420 ==================== Changes in man-pages-2.65 ====================
8422 Released: 2007-09-17
8428 The following people contributed notes, ideas, or patches that have
8429 been incorporated in changes in this release:
8431 Aleksandr Koltsoff <czr@iki.fi>
8432 Andi Kleen <ak@suse.de>
8433 Anton Blanchard <anton@samba.org>
8434 Ari Entlich <lmage11@twcny.rr.com>
8435 Carsten Emde <Carsten.Emde@osadl.org>
8436 François Diakhate <diakhate@enseirb.fr>
8437 Geoff Clare <gclare@gclare.org.uk>
8438 Jon Burgess <jburgess777@googlemail.com>
8439 Julien Cristau <jcristau@debian.org>
8440 Lee Schermerhorn <Lee.Schermerhorn@hp.com>
8441 Mats Wichmann <mats.d.wichmann@intel.com>
8442 Maxime Bizon <mbizon@freebox.fr>
8443 Maxime Vaudequin <maxime.vaudequin@gmail.com>
8444 Michael Prokop <mika@grml.org>
8445 Mike Frysinger <vapier@gentoo.org>
8446 Nicolas François <nicolas.francois@centraliens.net>
8447 Nicolas George <nicolas.george@ens.fr>
8448 Paul Brook <paul@nowt.org>
8449 Reuben Thomas <rrt@sc3d.org>
8450 Sam Varshavchik <mrsam@courier-mta.com>
8451 Samuel Thibault <samuel.thibault@ens-lyon.org>
8452 Thomas Huriaux <thomas.huriaux@gmail.com>
8453 Tolga Dalman <tdalman@project-psi.org>
8454 Ulrich Drepper <drepper@redhat.com>
8455 Vincent Lefevre <vincent@vinc17.org>
8457 Apologies if I missed anyone!
8463 Typographical or grammatical errors have been corrected in several
8468 Use 'glibc' consistently to refer to GNU C library.
8472 Order errors under ERRORS alphabetically.
8476 Spelling and formatting fixes, as per
8477 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=439560
8488 Add "#include <stdlib.h>" (to declare exit(3)) to example program.
8496 Description of timeradd(), timersub(), timerclear(),
8497 timerisset(), timercmp() macros for operating on
8506 Somehow, over time, material on fdatasync(2) crept into
8507 fsync.2, and fdatasync also got added to the NAME section
8508 of fsync.2. All of the material in fdatasync.2 that was
8509 not already in fsync.2 has now been moved there, and
8510 the former page has been removed.
8511 In place of the content there, is now a link to fsync.2.
8521 Link to man3/clock_getres.3.
8533 Link to gethostbyaddr.3.
8540 Links to new timeradd.3.
8543 Changes to individual pages
8544 ---------------------------
8548 Make the install target of man-pages respect the standard
8549 "DESTDIR" variable as well as check the exit status of the
8550 install command so errors aren't ignored.
8554 changed the "policy" parameter to "mode" through out the
8555 descriptions in an attempt to promote the concept that the memory
8556 policy is a tuple consisting of a mode and optional set of nodes.
8558 added requirement to link '-lnuma' to synopsis
8560 rewrite portions of description for clarification.
8562 added all errors currently returned by sys call.
8564 removed cautionary note that use of MPOL_F_NODE|MPOL_F_ADDR
8565 is not supported. This is no longer true.
8567 added mmap(2) to SEE ALSO list.
8571 Since kernel 2.6.22, Linux setitimer() now conforms to POSIX.1,
8572 giving an EINVAL error for a non-canonical tv_usec value.
8576 Replace discussion of timer* macros with a pointer
8577 to new page timeradd.3.
8581 Fixed argument type for BLKGETSIZE.
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 rewrite portions of description for clarification.
8592 clarify interaction of policy with mmap()'d files and shared
8593 memory regions, including SHM_HUGE regions.
8595 defined how "empty set of nodes" specified and what this
8596 means for MPOL_PREFERRED.
8598 mention what happens if local/target node contains no
8601 clarify semantics of multiple nodes to BIND policy.
8602 Note: subject to change. We'll fix the man pages when/if
8605 added all errors currently returned by sys call.
8607 added mmap(2), shmget(2), shmat(2) to SEE ALSO list.
8612 Add text noting that PROT_WRITE may (and on x86 does)
8614 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=441387
8628 Update arches/kernel versions for PR_SET_UNALAIGN / PR_GET_UNALIGN.
8632 Removed SEE ALSO reference to nonexistent fadvise.2.
8636 Place SYNOPSIS comments inside C comments (/* ... */).
8640 Note what thread is affected if 'pid' is specified
8641 as 0, or as the value returned by getpid().
8643 sched_setscheduler.2
8645 Add text on real-time features of mainline Linux kernel.
8649 sync SYNOPSIS with select.2
8654 changed the "policy" parameter to "mode" throughout the
8655 descriptions in an attempt to promote the concept that the memory
8656 policy is a tuple consisting of a mode and optional set of nodes.
8658 added requirement to link '-lnuma' to synopsis
8660 rewrite portions of description for clarification.
8662 clarify interaction of policy with mmap()'d files.
8664 defined how "empty set of nodes" specified and what this
8665 means for MPOL_PREFERRED.
8667 mention what happens if local/target node contains no
8670 clarify semantics of multiple nodes to BIND policy.
8671 Note: subject to change. We'll fix the man pages when/if
8674 added all errors currently returned by sys call.
8676 added mmap(2) to SEE ALSO list.
8680 s/si_sign/si_errno/ in statement about which field is unused.
8682 s/SIGILL/SIGCHLD/ for paragraph describing SIGCHLD.
8686 Improve text describing underlying system calls.
8690 EINVAL also occurs if target path is on tmpfs or similar.
8691 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435885
8695 Incorporated material from now deleted fdatasync.2.
8699 Small fix in example program.
8703 Improve text describing underlying system calls.
8706 Vincent Lefevre / mtk
8707 Clarify utimes() behaviour when 'times' is NULL.
8708 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=431480
8710 Other minor clarifications of description of utimes().
8714 s/sign/sign bit/ to remove ambiguity in description.
8715 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435415
8719 Changed NOTES to VERSIONS.
8723 Add ffsl and ffsll to NAME line.
8727 Removed statement that fts functions are expected to appear
8728 soon in POSIX; it's years old and has not yet come to pass.
8732 Fixes/improvements for example program.
8736 Add getdate_r to NAME section.
8740 Fixes/improvements for example program.
8744 Add documentation for gethostbyaddr_r().
8745 Plus a few other small fixes.
8749 Add gethostbyname2, gethostbyname2_r, gethostbyname_r,
8750 gethostent_r to NAME line.
8754 Fix misnamed function references.
8758 Fix small error in example program.
8762 Add setrpcent and endrpcent to NAME line.
8766 Fix gsignal() prototype.
8770 Add hcreate_r, hdestroy_r, hsearch_r to NAME line.
8774 Correct definition of "struct in_addr".
8782 Add islessequal to NAME line.
8786 Fix CONFORMING TO section.
8787 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=417592
8791 Add log1pf and log1pl to NAME line.
8795 After a call to longjmp(), the values of modified, non-volatile
8796 variables in the function that called setjmp() are unspecified.
8800 Fix makecontext() prototype.
8804 Explain what happens for malloc(0), or calloc() where one of the
8807 Added notes on malloc()'s use of sbrk() and mmap().
8809 Add mmap(2), alloca(3) to SEE ALSO.
8819 Add "Link with -lrt." to SYNOPSIS.
8822 Ulrich Drepper; some edits and additional text by mtk
8823 Document fdopendir().
8826 mtk, after a note by Andi Kleen
8827 Document DT_* constants for d_type.
8828 Ulrich Drepper / mtk
8829 Rework discussion of non-standard structure fields.
8833 Minor improvements to example program.
8837 Add vsyslog to NAME section.
8841 Fix XCASE feature test macro description.
8845 Add return type to prototype.
8849 Improve description of num_threads field under /proc/PID/stat.
8851 Fix path error (s%proc/sys%proc/sys/kernel%) in mentions of
8852 /proc/sys/ostype, /proc/sys/osrelease and proc/sys/version.
8854 I noticed things to correct and to clarify in subsection
8855 "/proc/filesystems" of proc.5:
8856 - clarify filesystems listing: not only FS compiled
8857 into the kernel, also FS kernel modules currently loaded
8858 - add a reference to fs(5)
8859 - add an explanation for FS marked with "nodev"
8860 - s/mount(1)/mount(8)/, also corrected in section "SEE ALSO"
8861 - clarify usage by mount: the current wording may lead to
8862 think /proc/filesystems is always used by mount when no FS
8863 is specified. So, usage of "may" which IMHO is more
8864 appropriate + additional explanations
8865 In mount(8) we can see:
8867 If no -t option is given, or if the auto type is
8868 specified, mount will try to guess the desired type.
8869 If mount was compiled with the blkid library, the
8870 guessing is done by this library. Otherwise, mount
8871 guesses itself by probing the superblock; if that
8872 does not turn up anything that looks familiar,
8873 mount will try to read the file /etc/filesystems,
8874 or, if that does not exist, /proc/filesystems.
8875 All of the filesystem types listed there will be
8876 tried, except for those that are labeled "nodev"
8877 (e.g., devpts, proc and nfs). If /etc/filesystems
8878 ends in a line with a single * only, mount will
8879 read /proc/filesystems afterwards.
8881 Since linux 2.6.11, /proc/stat has an eighth value for cpu
8882 lines: stolen time, which is the time spent in other operating
8883 systems when running in a virtualized environment.
8886 Updated BUGS text referring to jiffies; refer to time.7 instead.
8890 Add words to note that file system ID is Linux specific.
8894 This is some corrections for hier.7:
8895 - missing period for /media and /mnt
8896 - /mnt description is not totally correct, it is true for some
8897 distributions but in others /mnt is used as a temporary FS
8898 mount point, as it is specified by FHS:
8899 http://www.pathname.com/fhs/pub/fhs-2.3.html#
8900 MNTMOUNTPOINTFORATEMPORARILYMOUNT
8901 - s/X-Windows/X-Window/ (3 occurrences)
8902 - section "SEE ALSO": s/mount(1)/mount(8)/
8908 mtk / Nicolas François
8909 Nowadays tmac.XXX are called XXX.tmac.
8913 Update text about modern threading implementations
8914 (NPTL vs LinuxThreads).
8917 mtk, after a note by Andi Kleen
8918 Clarify that SO_SNDTIMEO and SO_RCVTIMEO only have effect for
8919 socket I/O calls; not for multiplexing system calls like
8920 select() and poll().
8924 Add SEE ALSO reference to new timeradd.3.
8927 ==================== Changes in man-pages-2.66 ====================
8929 Released: 2007-10-01
8935 The following people contributed notes, ideas, or patches that have
8936 been incorporated in changes in this release:
8938 Amit K. Arora <aarora@linux.vnet.ibm.com>
8939 David Chinner <dgc@sgi.com>
8940 Fredrik Noring <noring@nocrew.org>
8941 Mats Wichmann <mats.d.wichmann@intel.com>
8942 Maxime Vaudequin <maxime.vaudequin@gmail.com>
8943 Ollie Wild <aaw@google.com>
8944 Ulrich Drepper <drepper@redhat.com>
8946 Apologies if I missed anyone!
8952 Typographical or grammatical errors have been corrected in several
8960 David Chinner, with some input from Amit Amora and mtk
8961 Describes the fallocate() system call, new in 2.6.23.
8964 Changes to individual pages
8965 ---------------------------
8969 Add text cautioning about use of close() in
8970 multithreaded programs.
8974 Add text describing limit on total size of argv + envp,
8975 and changes that occurred with 2.6.23.
8977 Add getopt(3) to SEE ALSO list.
8980 mtk, Acked by Ulrich Drepper
8981 Added description of O_CLOEXEC (new in 2.6.23) + other
8982 minor fixes for O_DIRECT.
8986 Added description of MSG_CMSG_CLOEXEC (new in 2.6.23).
8990 Strengthened the warning against using this system call
8991 and note that it may disappear in a future kernel version.
8995 Fix type definition for 'protocol' in prototypes of pmap_set()
8999 ==================== Changes in man-pages-2.67 ====================
9001 Released: 2007-10-08
9007 The following people contributed notes, ideas, or patches that have
9008 been incorporated in changes in this release:
9010 Andi Kleen <andi@firstfloor.org>
9011 Andrew Josey <a.josey@opengroup.org>
9012 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9014 Apologies if I missed anyone!
9022 mtk, after a note by Andi Kleen and consultation with Andrew Josey.
9023 Add a PROLOG section:
9024 This manual page is part of the POSIX Programmer's Manual.
9025 The Linux implementation of this interface may differ
9026 (consult the corresponding Linux manual page for details
9027 of Linux behavior), or the interface may not be implemented
9034 Some formatting fixes, mostly to get rid of unwanted
9035 spaces before "," in formatted output.
9040 Change all occurrences of my email address in man-pages source
9041 to my new gmail address.
9045 I noticed useless use of macros with alternating formatting
9046 (".IR" instead ".I" which suffices, ".BR" instead ".B", etc.)
9047 because there is only one element. For example in ldconfig.8:
9052 This is not very important, it only makes the sources more tidy.
9053 To find these I used:
9055 egrep '^\.(B[RI]|R[IB]|I[RB]) ([^ ]+|\"[^\"]\+\")$'
9057 And if you want to make these changes, you can use:
9059 sed 's/^\(\.[BRI]\)[BRI]\( \([^ ]\+\|\"[^\"]\+\"\)\)$/\1\2/g'
9062 ==================== Changes in man-pages-2.68 ====================
9064 Released: 2007-11-19
9070 The following people contributed notes, ideas, or patches that have
9071 been incorporated in changes in this release:
9073 A. Costa <agcosta@gis.net>
9074 Andrew McDonald <andrew@mcdonald.org.uk>
9075 Geoff Clare <gclare@gclare.org.uk>
9076 Heikki Orsila <shd@modeemi.cs.tut.fi>
9077 Hyokyong Kim <hyokyong@ppj.kr>
9078 Ivana Varekova <varekova@redhat.com>
9079 Justin Pryzby <jpryzby+d@quoininc.com>
9080 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9081 Mike Frysinger <vapier@gentoo.org>
9082 Nicolas François <nicolas.francois@centraliens.net>
9083 Pádraig Brady <P@draigBrady.com>
9084 Sam Varshavchik <mrsam@courier-mta.com>
9085 Timo Juhani Lindfors <timo.lindfors@iki.fi>
9086 Ulrich Drepper <drepper@redhat.com>
9088 Apologies if I missed anyone!
9106 mtk, after http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445436
9107 by Timo Juhani Lindfors
9108 Added <fcntl.h> to SYNOPSIS.
9110 Typographical or grammatical errors have been corrected in several places.
9118 Created as a new page, by taking the content specific to
9119 the _syscall() macros from intro(2).
9122 Changes to individual pages
9123 ---------------------------
9129 man-pages-*-Announce
9131 Brought the info in here up to date.
9135 Added intro paragraph about section, plus a paragraph
9136 about exit status values.
9137 Move "user intro" text to NOTES.
9141 Reorder ERRORS sections alphabetically
9145 Pretty much a complete rewrite, covering some additional topics.
9146 Moved _syscallN() material to new _syscall(2) page.
9150 Reorder ERRORS sections alphabetically
9154 Fix syntax error in example program.
9158 Linux 2.6.22 added support on Alpha for PR_SET_UNALIGN.
9161 Nicolas François / mtk
9162 s/PTRACE_POKEUSR/PTRACE_POKEUSER/
9163 s/PTRACE_PEEKUSR/PTRACE_PEEKUSER/
9167 Add text describing timerfd EINVAL error for read(2).
9171 Reorder ERRORS sections alphabetically
9175 Added _syscall(2) and intro(2) to SEE ALSO section.
9179 Added fallocate(2); removed timerfd(2).
9183 Removed reference to example in intro(2).
9187 Added "Link with -ldl." to SYNOPSIS.
9190 Ulrich Drepper / mtk
9191 Remove references to getipnodebyname.3 and getipnodebyaddr.3.
9194 mtk / Ulrich Drepper
9195 Remove SEE ALSO references to getipnodebyname.3 and
9198 Pádraig Brady / mtk / Ulrich Drepper
9199 Point out that the functions described on this page
9200 are made obsolete by getaddrinfo(3) and getnameinfo(3).
9204 Clarify that glibc does not implement these functions.
9207 Ulrich Drepper / mtk
9208 Fix description of GLOB_ONLYDIR.
9210 Added description of GLOB_TILDE_NOMATCH.
9211 Expanded the description of various flags.
9212 Various wording fixes..
9216 Pretty much a complete rewrite, covering some additional topics.
9220 Add SEE ALSO referring to fallocate.2.
9224 Add some arg declarations to prototypes; fix typos.
9228 Fix text in BUGS section.
9232 The sigset() bugs were fixed in glibc 2.5.
9233 See http://sourceware.org/bugzilla/show_bug.cgi?id=1951
9241 Various small corrections, formattings and modifications.
9246 - new p_flag: PT_GNU_STACK
9247 - new sections: .gnu.version .gnu.version_d .gnu.version_r
9249 - new structures: ElfN_Verdef ElfN_Verdaux ElfN_Verneed
9257 Ivana Varekova / mtk
9258 Add text noting that since kernel 2.6.16, /proc/slabinfo is
9259 only available if CONFIG_SLAB is enabled.
9261 Update description of /proc/pci.
9263 Give italic formatting to file names in proc.5.
9265 The display type of the /proc/PID/stat fields changed
9266 %lu to %u in Linux 2.6.22:
9272 Ivana Varekova / mtk
9273 Add text noting that since kernel 2.6.16, /proc/slabinfo is
9274 only available if CONFIG_SLAB is enabled.
9282 Update references to files in kernel "Documentation" directory.
9290 Fix description of IPV6_ROUTER_ALERT option.
9294 Note online location of C99 standard.
9298 Some rewrites, plus new paragraph on exit status values.
9301 ==================== Changes in man-pages-2.69 ====================
9303 Released: 2007-12-03
9309 The following people contributed notes, ideas, or patches that have
9310 been incorporated in changes in this release:
9312 Adam Borowski <kilobyte@angband.pl>
9313 Alain Portal <aportal@univ-montp2.fr>
9314 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
9315 J. Bruce Fields <bfields@citi.umich.edu>
9316 David Härdeman <david@hardeman.nu>
9317 Jeremy Kerr <jk@ozlabs.org>
9318 Luke Browning <lukebr@linux.vnet.ibm.com>
9319 Mats Wichmann <mats.d.wichmann@intel.com>
9320 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9321 Mike Frysinger <vapier@gentoo.org>
9322 Reuben Thomas <rrt@sc3d.org>
9323 Sam Varshavchik <mrsam@courier-mta.com>
9325 Apologies if I missed anyone!
9333 Many whitespace clean-ups in formatted output.
9340 David Härdeman / mtk
9341 Rename error handling function in example program
9342 (s/die/handle_error/).
9344 Typographical or grammatical errors have been corrected in several places.
9353 The content of these files is now available in HTML format.
9363 Changes to individual pages
9364 ---------------------------
9368 Added "Linux User's Manual" to .TH line.
9372 Remove outdated text about pointer blocks for syscalls that have
9373 more than 5 arguments.
9377 Add warning that mandatory locking is unreliable.
9379 Clarify details in description of file leases.
9380 J. Bruce Fields / mtk
9381 Minor wording edits.
9383 Add F_GETLEASE under RETURN VALUE.
9387 Handle errors using a custom handle_error() macro.
9389 sched_setscheduler.2
9391 Add BUGS text noting that the return value from Linux
9392 sched_setschuler() does not conform to POSIX.
9396 Various updates and improvements.
9398 Refinement of text describing a "gang".
9404 Various updates and improvements.
9410 Remove HISTORY section.
9414 Document 'e' (close-on-exec) option, new in glibc 2.7.
9418 Remove HISTORY section.
9421 Andries E. Brouwer / mtk
9422 Fix the discussion of stdarg macros in the description of
9423 vprintf() description.
9427 Handle errors using a custom handle_error() macro.
9431 Note that sigset_t objects must be initialized
9432 with sigemptyset() or sigfillset() before the other
9433 macros are employed.
9436 mtk, after a note by Alain Portal
9437 Added cfsetspeed() to SYNOPSIS. Added text under CONFORMING TO
9438 noting that cfsetspeed() is BSD specific.
9442 Various references to "getty" were changed to "mingetty", since
9443 that is the manual page more likely to be found on current
9444 systems. (Completes changes that were made in man-pages-2.44.)
9447 mtk, after a note by Alain Portal
9448 Move "Configuration" section to top of page (like other
9449 section 4 pages) and make it a .SH section.
9453 Re-ordered CONFIGURATION section to go before DESCRIPTION.
9457 Fix reference to kernel Documentation file.
9461 Renamed HISTORY section to NOTES, and removed BSD specific info.
9465 Mention grub(8) in same sentence as lilo(8).
9467 Improve description of /proc/sys/abi and
9468 /proc/sys/kernel/modprobe.
9472 Various references to "getty" were changed to "mingetty", since
9473 that is the manual page more likely to be found on current
9474 systems. (Completes changes that were made in man-pages-2.44.)
9478 Reverse the 2.68 change applied by mtk in response to
9479 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445085
9480 that replaced "Sorbian" with "Serbian".
9481 (Sorbian is a language of 50000 people in Brandenburg.)
9485 Added CONFIGURATION to list of "standard" section names.
9489 Various updates and improvements.
9495 Fix reference to kernel Documentation file.
9498 ==================== Changes in man-pages-2.70 ====================
9500 Released: 2007-12-06
9508 Remove section numbers for page references where the
9509 reference refers to the page itself. (This stops man2html
9510 producing links from a page back to itself.)
9512 Typographical or grammatical errors have been corrected in several places.
9515 Changes to individual pages
9516 ---------------------------
9520 Add CONFORMING TO section.
9524 Remove redundant SEE ALSO entry.
9528 Add CONFORMING TO section.
9532 Remove redundant SEE ALSO entries.
9536 Remove redundant SEE ALSO entry.
9540 Remove redundant SEE ALSO entry.
9541 Add SEE ALSO referring to vmsplice(2).
9545 Remove redundant SEE ALSO entry.
9546 Add SEE ALSO referring to ccos(3).
9550 Add gethostbyaddr_r to NAME section.
9554 Remove redundant SEE ALSO entry.
9565 ==================== Changes in man-pages-2.71 ====================
9567 Released: 2007-12-14
9573 The following people contributed notes, ideas, or patches that have
9574 been incorporated in changes in this release:
9576 Alain Portal <aportal@univ-montp2.fr>
9577 John Sigler <linux.kernel@free.fr>
9578 Josh Triplett <josh@freedesktop.org>
9579 Mats Wichmann <mats.d.wichmann@intel.com>
9580 Pascal MALAISE <malaise@magic.fr>
9581 Sam Varshavchik <mrsam@courier-mta.com>
9583 Apologies if I missed anyone!
9599 Replaced the use of mdoc macros on these pages with man
9600 macros. The only pages in man-pages that still use
9601 mdoc macros are mdoc.7 and mdoc.samples.7.
9603 Typographical or grammatical errors have been corrected in several places.
9611 This information is now on the website.
9614 Changes to individual pages
9615 ---------------------------
9619 Reformat various change log entries to use a consistent format.
9620 Expand Debian bug report numbers to be URLs.
9621 Other minor tidy-ups.
9625 Document the F_DUPFD_CLOEXEC operation, which is
9626 new in kernel 2.6.24.
9630 Fix incorrect path for somaxconn.
9634 Add ENOENT error to ERRORS.
9638 Add documentation of _SC_NPROCESSORS_CONF and _SC_NPROCESSORS_ONLN.
9642 Add tty_ioctl(4) to SEE ALSO list.
9645 Pascal MALAISE <malaise@magic.fr>
9646 Separate text on back references from that describing basic regexps,
9647 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=379829.
9649 Remove crufty text about word boundaries.
9652 ==================== Changes in man-pages-2.72 ====================
9654 Released: 2007-12-14
9660 The following people contributed notes, ideas, or patches that have
9661 been incorporated in changes in this release:
9663 Alain Portal <aportal@univ-montp2.fr>
9664 Alex Tuninga <atuninga@google.com>
9665 Bert Wesarg <bert.wesarg@googlemail.com>
9666 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9667 Rob Weryk <rjweryk@uwo.ca>
9668 Sam Varshavchik <mrsam@courier-mta.com>
9670 Apologies if I missed anyone!
9678 Format include files consistently (".I <.*\.h>").
9682 Format pathname in italics (.I).
9688 Remove brackets ([]) around error names.
9696 mtk / Maxime Vaudequin
9697 Some systems have mingetty(8), others have agetty(8), so both
9698 should be mentioned when we are talking about getty-style programs.
9701 Typographical or grammatical errors have been corrected in several places.
9725 Link to filesystems.5.
9728 Changes to individual pages
9729 ---------------------------
9733 Fix declaration of 'offset' in SYNOPSIS.
9737 s/SETGUID/SETEUID/ in .TH line.
9741 Fixed include files references / formatting.
9744 mtk, after a note by Alex Tuninga
9745 A fairly significant rewrite to clarify operation of abort().
9749 s/envz/envz_add/ in SEE ALSO.
9753 s/DIRNAME/BASENAME/ in .TH line, and swap function names
9758 s/argz/argz_add/ in SEE ALSO.
9762 s/LOCKFILE/FLOCKFILE/ in .TH line.
9766 s/GETGRENT/GETGRENT_R/ in .TH line.
9770 Reformat function list at end of page as a proper table.
9774 Revert earlier s/getty/mingetty/. This page talks about
9775 historical behavior, and that means "getty(8)".
9779 Remove reference to "obstack stuff"; it's not clear what
9784 s/CONSOLE_IOCTLS/CONSOLE_IOCTL/ in .TH line.
9788 s/fs (5)/filesystems (5)/
9792 Improve discussion of formatting of file names.
9795 ==================== Changes in man-pages-2.73 ====================
9797 Released: 2007-12-14
9803 The following people contributed notes, ideas, or patches that have
9804 been incorporated in changes in this release:
9806 Alain Portal <aportal@univ-montp2.fr>
9807 Pádraig Brady <P@draigBrady.com>
9808 Reuben Thomas <rrt@sc3d.org>
9810 Apologies if I missed anyone!
9820 Typographical or grammatical errors have been corrected in several places.
9823 Changes to individual pages
9824 ---------------------------
9827 mtk, after a report by Reuben Thomas
9828 Clarify use of mkfifo() versus mknod().
9829 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=455825
9841 Noted feature test macro requirements.
9842 BUGS: noted that iruserok() is not declared in glibc headers.
9846 Added Reiserfs, XFS, JFS to list of file systems.
9849 ==================== Changes in man-pages-2.74 ====================
9851 Released: 2007-12-20
9857 The following people contributed notes, ideas, or patches that have
9858 been incorporated in changes in this release:
9860 Alain Portal <aportal@univ-montp2.fr>
9861 Andrew Morton <akpm@linux-foundation.org>
9862 David Brown <lkml@davidb.org>
9863 Jeremy Kerr <jk@ozlabs.org>
9864 Mats Wichmann <mats.d.wichmann@intel.com>
9865 Sam Morris <sam@robots.org.uk>
9866 Sam Varshavchik <mrsam@courier-mta.com>
9867 Samuel Thibault <samuel.thibault@ens-lyon.org>
9869 Apologies if I missed anyone!
9889 Make the standard indent for code samples, shell session
9890 logs, etc. to be ".in +4n".
9892 Typographical or grammatical errors have been corrected in several places.
9895 Changes to individual pages
9896 ---------------------------
9900 Nowadays there is _syscall6() also.
9904 Various minor formatting changes.
9908 Fix types in structs.
9912 mtk, after a note by Sam Morris
9913 Clarify that MS_NODIRATIME provides a subset of the
9914 functionality provided by MS_NOATIME.
9918 Minor rearrangement of text.
9922 Fix (my) typos in argument names.
9927 We can use context FDs for the dirfd argument to the *at() syscalls.
9930 mtk, after a note from David Brown and Andrew Morton
9931 http://marc.info/?l=linux-kernel&m=119447727031225&w=2
9932 Rework the text describing the return value to be closer
9933 to the requirements of POSIX.1; move Linux details
9934 to NOTES and add a warning not to rely on those details.
9935 Add a warning about the -1 to -4095 bug which results
9936 in a 41 second window where the glibc wrapper will wrongly
9937 return -1 indicating an error.
9939 Remove cruft HZ text.
9940 Clarify text describing return value of clock(3).
9944 CONFORMING TO: getw() and putw() were in SUSv2, but are not
9949 Minor rewordings + formatting fixes.
9953 Many formatting fixes.
9955 Place ERRORS in alphabetical order.
9959 Document VT_GETHIFONTMASK (new in 2.6.18) and add to example program;
9960 attribute/text characters are in the host byte order.
9961 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=456437
9971 Minor heading changes and reformattings.
9975 Note that code segments, structure definitions, shell session
9976 logs, should be indented by 4 spaces.
9980 Add a little information about the differences to mbox.
9983 ==================== Changes in man-pages-2.75 ====================
9985 Released: 2008-01-08
9991 The following people contributed notes, ideas, or patches that have
9992 been incorporated in changes in this release:
9994 Alain Portal <aportal@univ-montp2.fr>
9995 Andi Kleen <ak@suse.de>
9996 Andreas Henriksson <andreas@fatal.se>
9997 Jeremy Kerr <jk@ozlabs.org>
9998 Justin Pryzby <jpryzby+d@quoinic.com>
9999 Phil Endecott <spam_from_debian_bugs_4@chezphil.org>
10000 Sam Varshavchik <mrsam@courier-mta.com>
10001 Thomas Huriaux <thomas.huriaux@gmail.com>
10002 Timo Sirainen <tss@iki.fi>
10003 Trond Myklebust <trond.myklebust@fys.uio.no>
10005 Apologies if I missed anyone!
10013 (Grammatical) hyphenation was fixed in many places.
10028 Justin Pryzby / mtk
10029 Fix incorrect usage of "a" and "an" before following vowel /
10030 consonant, by reviewing the output of the following scripts:
10032 for a in $(wc */*.? | awk '$1 > 10 {print $4}' | gv total); do
10034 MANWIDTH=4000 man -l $a 2>/dev/null |
10035 egrep '(^| )an [^aeiou][a-z]'
10038 for a in $(wc */*.? | awk '$1 > 10 {print $4}' | gv total); do
10040 MANWIDTH=4000 man -l $a 2>/dev/null |
10041 egrep '(^| )a [aeiou][a-z]'
10051 mtk, after a note by Alain Portal
10052 Improve macros used in 2.71 to convert from "mdoc" to "man".
10068 sched_setscheduler.2
10088 s/current process/calling process/
10107 s/x86/i386/ since that is the name used in 'arch' directories
10108 in the kernel source, and previously both i386 and x86 were both
10109 used in man pages; also nowadays 'x86' is somewhat ambiguous,
10110 since it is the name of the 'arch' directory for i386 and x86-64.
10135 Various reformattings.
10146 Format SYNOPSIS in a manner consistent with other pages.
10150 Format casts so that there is a non-breaking space after the
10151 type, and remove unnecessary parentheses around the casted value.
10152 Thus, for example, the following:
10154 .IR "(size_t) (\-1)" .
10158 .IR "(size_t)\ \-1" .
10162 Replace "-" by "\-" where a real dash is required.
10166 Make the formatting of instances of '*varname' consistent, changing
10195 Format SYNOPSIS consistently.
10204 mtk, after a note by Alain Portal
10205 Standardize sentence used under "Feature Test Macro Requirements"
10206 when referring to all functions shown in the SYNOPSIS.
10222 Indent structure definitions by +4n.
10242 Use C99 standard types in declarations.
10243 s/u_long/unsigned long/
10244 s/ulong/unsigned long/
10245 s/u_char/unsigned char/
10246 s/u_short/unsigned short/
10247 s/ushort/unsigned short/
10248 s/u_int8_t/uint8_t/
10249 s/u_int16_t/uint16_t/
10250 s/u_int32_t/uint32_t/
10251 s/u_int/unsigned int/
10258 sched_setaffinity.2
10274 feature_test_macros.7
10279 Fix unbalanced .nf/.fi pairs.
10288 feature_test_macros.7
10293 Rename argument: s/file*des/fd/ , since that is the name most
10294 commonly used on man pages for a file descriptor argument.
10304 Removed .SM macros.
10311 Remove extraneous .br macro before/after .SH/.SS.
10321 canonicalize_file_name.3
10332 Remove extraneous .sp macros.
10344 Remove/replace extraneous .sp macros.
10346 Typographical or grammatical errors have been corrected in several places.
10349 Changes to individual pages
10350 ---------------------------
10354 Nowadays there are seven macros (see 2.74 change log also).
10357 mtk, Acked by Andi Kleen
10358 Clarify interpretation of 'addr'; plus a few other minor edits
10367 Clarify relationship between file descriptor and open file
10371 mtk, Acked by Andi Kleen
10372 Since kernel 2.2, AF_UNSPEC for unconnecting a connected
10373 socket *is* supported.
10381 Remove duplicate "#include <fcntl.h>" from SYNOPSIS.
10385 Add getresgid(2) and credentials(7) to SEE ALSO.
10393 Rewrote various parts.
10397 Add getresuid(2) and credentials(7) to SEE ALSO.
10401 Use proper tables for layout, and various formatting fixes.
10403 Various formatting fixes.
10407 Rewrote various parts.
10410 Andi Kleen / mtk / Alain Portal
10411 Modify explanation of EINVAL 'maxnode' error.
10415 Add comma to clarify meaning of a sentence.
10419 Clarify initial description of O_EXCL.
10420 Clarify description of behaviors of O_CREAT | O_EXCL
10421 for symbolic links.
10422 Clarify text describing use of lockfiles without O_EXCL.
10423 mtk, with input from Timo Sirainen and Trond Myklebust
10424 O_EXCL is supported on NFSv3 and later, with Linux 2.6 and later.
10428 Rename 'filedes' argument 'pipefd'.
10432 s/cwd/current working directory/
10440 Add credentials(7) to SEE ALSO, and updated copyright credits,
10441 to reflect my rewrite of a few months ago.
10445 Add getsid(2) and credentials(7) to SEE ALSO.
10448 Alain Portal / mtk; acked by Jeremy Kerr
10449 Minor formatting/wording changes.
10451 Put EPERM in right alphabetical position in ERRORS list.
10459 Minor changes to example program.
10463 These functions are still not present as at glibc 2.7.
10467 Various minor spelling and formatting fixes.
10475 Fix placement of feature test macro in SYNOPSIS.
10484 Minor changes to example program.
10489 Use modern C prototypes in SYNOPSIS.
10499 Use .IP tags to create properly formatted lists.
10503 Convert function declarations to use modern C prototypes.
10504 Add text and start of page describing header files
10505 and types required by functions.
10506 Reformat discussion of request under clnt_control().
10510 Convert function declarations to use modern C prototypes.
10511 Remove crufty "int empty" from xdrrec_eof() description.
10515 Relocate misplaced line:
10516 "and if LF/NL (new line mode) is set also a carriage return;"
10517 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=458338.
10524 mtk, after a note by Alan Portal
10525 Fix reference to kernel documentation source file in the
10526 "The Sound Driver" subsection.
10530 Move CONFIGURATION description after SYNOPSIS description.
10532 Note that header files should be surrounded by angle brackets (<>).
10536 Minor formatting and wording fixes.
10540 Fix description of RTM_F_EQUALIZE.
10541 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=458325.
10545 Minor formatting and wording fixes.
10549 Small rewording of discussion of O_ASYNC.
10552 mtk / Jeremy Kerr / Alain Portal
10556 ==================== Changes in man-pages-2.76 ====================
10558 Released: 2008-01-14
10564 The following people contributed notes, ideas, or patches that have
10565 been incorporated in changes in this release:
10567 Alain Portal <aportal@univ-montp2.fr>
10568 Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
10569 Jeremy Kerr <jk@ozlabs.org>
10570 Sam Varshavchik <mrsam@courier-mta.com>
10571 Trond Myklebust <trond.myklebust@fys.uio.no>
10573 Apologies if I missed anyone!
10587 Rework/remove use of ".ad" macros.
10600 Fix unbalanced quotes in formatting macros.
10604 s/i-node/inode/, for consistency with other pages and POSIX.1-2001.
10606 Typographical or grammatical errors have been corrected in several places.
10609 Changes to individual pages
10610 ---------------------------
10614 Minor wording change.
10618 Reordered text in DESCRIPTION and added some details for dup2().
10621 Trond Myklebust / mtk
10622 Minor fix to O_EXCL changes in previous release.
10626 Rewrote DESCRIPTION; noted that thread ID is not the same
10627 thing as a POSIX thread ID.
10631 Rewrote DESCRIPTION; minor additions to EXAMPLE text.
10635 A few rewrites and additions.
10638 Carlo Marcelo Arenas Belon / mtk
10639 Add "#define _XOPEN_SOURCE" to example program.
10643 Use quotes more consistently in formatting macros.
10646 mtk, after a report by Daniel Kahn Gilmor
10647 Add 2.6 details for /proc/sys/kernel/random/poolsize.
10648 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=459232.
10656 Define abbreviation "MSS".
10659 ==================== Changes in man-pages-2.77 ====================
10661 Released: 2008-01-31
10667 The following people contributed notes, ideas, or patches that have
10668 been incorporated in changes in this release:
10670 Pavel Heimlich <tropikhajma@seznam.cz>
10671 Phil Endecott <phil_vonar_endecott@chezphil.org>
10672 Thomas Huriaux <thomas.huriaux@gmail.com>
10673 Vincent Lefevre <vincent@vinc17.org>
10674 WANG Cong <xiyou.wangcong@gmail.com>
10676 Apologies if I missed anyone!
10685 Fix broken use of single quotes at start of line,
10686 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=462636
10688 Typographical or grammatical errors have been corrected in several places.
10695 Script to remove the COLOPHON section from the man pages provided
10696 as command-line arguments. This is useful to remove the COLOPHON
10697 sections from all of the man pages in two different release trees
10698 in order to do a "diff -ruN" to see the "real" differences
10702 Changes to individual pages
10703 ---------------------------
10707 Replace tables with .TP macros.
10711 Added discussion of directory streams.
10712 Removed "#include <sys/types>" from SYNOPSIS.
10713 Changed authorship notice.
10717 Add ENOSYS error to errors.
10719 Explicitly describe return value in the event of an error.
10721 inotify_add_watch.2
10723 Minor wording changes.
10727 Fix types for 2 and 4 arguments in splice prototype.
10731 Clarify description of return value for WNOHANG.
10735 Rewrote DESCRIPTION; emphasized that tkill() is obsoleted by
10740 Change description in NAME section.
10741 Various rewrites and additions (including notes on longjmp() and
10743 mtk / Vincent Lefevre
10744 Weaken warning against use of alloca(), and
10745 point out some cases where it can be useful;
10746 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=461100.
10754 Replace tables with .TP macros.
10755 s/MultiSource Synchronization/MultiSource Synchronization (MSS)/
10758 ==================== Changes in man-pages-2.78 ====================
10760 Released: 2008-02-15
10766 The following people contributed notes, ideas, or patches that have
10767 been incorporated in changes in this release:
10769 Davide Libenzi <davidel@xmailserver.org>
10770 Greg Banks <gnb@melbourne.sgi.com>
10771 Michael Tokarev <mjt@tls.msk.ru>
10772 Phil Endecott <phil_vonar_endecott@chezphil.org>
10774 Apologies if I missed anyone!
10785 Add SEE ALSO entry referring to new signalfd.2 page.
10787 Typographical or grammatical errors have been corrected in several places.
10794 mtk, with input and review from Davide Libenzi
10795 Documents the eventfd() system call, new in 2.6.22.
10798 mtk, with input and review from Davide Libenzi
10799 Documents the signalfd() system call, new in 2.6.22.
10801 Changes to individual pages
10802 ---------------------------
10805 mtk / Phil Endecott
10806 Improve wording describing error returns.
10810 Greatly expand the detail on O_DIRECT.
10813 mtk / Michael Tokarev
10814 Fix RETURN VALUE description: in some cases reboot() does not
10817 Rename the 'flag' argument to 'cmd', since that is more meaningful,
10818 and also what is used in the kernel source.
10819 Other minor wording changes.
10822 ==================== Changes in man-pages-2.79 ====================
10824 Released: 2008-03-07
10830 The following people contributed notes, ideas, or patches that have
10831 been incorporated in changes in this release:
10833 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
10834 Chris Heath <chris@heathens.co.nz>
10835 Davide Libenzi <davidel@xmailserver.org>
10836 Fernando Luis Vázquez Cao <fernando@oss.ntt.co.jp>
10837 Heikki Orsila <shdl@zakalwe.fi>
10838 Jeremy Kerr <jk@ozlabs.org>
10839 Justin Pryzby <justinpryzby@users.sourceforge.net>
10840 Lasse Kärkkäinen <tronic@trn.iki.fi>
10841 Michael Haardt <michael@moria.de>
10842 Mike Frysinger <vapier@gentoo.org>
10843 Ron Burk <ronburk@gmail.com>
10844 Sam Varshavchik <mrsam@courier-mta.com>
10845 Samuel Thibault <samuel.thibault@ens-lyon.org>
10846 Walter Harms <WHarms@bfs.de>
10848 Apologies if I missed anyone!
10854 Typographical or grammatical errors have been corrected in several places.
10861 mtk, with input and review from Davide Libenzi
10862 Documents the timerfd_create(), timerfd_settime(), and
10863 timerfd_gettime() system calls, which are new in 2.6.25.
10872 Links to new timerfd_create.2 page.
10877 Links to eventfd.2.
10880 Changes to individual pages
10881 ---------------------------
10885 Remove code relating to man1/README, which no longer exists.
10889 Clarify detail of RLIMIT_STACK/4 limit for argv+environ.
10893 Added SEE ALSO entry referring to timerfd_create.2.
10901 Move discussion of 'mode' argument under description of O_CREAT.
10905 Fix type for 'ssi_ptr' field.
10906 See http://sources.redhat.com/ml/libc-hacker/2008-01/msg00002.html.
10910 Add timerfd_create(), timerfd_settime(), and timerfd_gettime()
10915 Add info on command type 10.
10916 Add details on types 6, 7, 8, and 9.
10919 Update LOG_BUF_LEN details.
10920 Update RETURN VALUE section.
10921 Notes capability requirements under EPERM error.
10922 Minor fix to description of type==3 and type==4.
10927 Note that POSIX requires localtime() to act as though tzset()
10928 was called, but localtime_r() does not have the same requirement.
10929 See also http://thread.gmane.org/gmane.comp.time.tz/2034/
10933 Clarify discussion of NULL 'hints' argument; other minor rewrites.
10934 mtk / Sam Varshavchik
10935 Remove some duplicated text.
10938 Lasse Kärkkäinen / Mike Frysinger / mtk
10939 Clarify description of realloc() behavior for
10940 ((size == 0) && (ptr != NULL)).
10944 s/stdlib.h/fcntl.h/ in SYNOPSIS.
10947 Fernando Luis Vázquez Cao
10948 Update /proc/[number]/cmdline description.
10949 It used to be true that the command line arguments were
10950 not accessible when the process had been swapped out.
10951 In ancient kernels (circa 2.0.*) the problem was that the
10952 kernel relied on get_phys_addr to access the user space buffer,
10953 which stopped working as soon as the process was swapped out.
10954 Recent kernels use get_user_pages for the same purpose and thus
10955 they should not have that limitation.
10958 Davide Libenzi / mtk
10959 Clarify the somewhat unintuitive behavior that occurs if a file
10960 descriptor in an epoll set is closed while other file descriptors
10961 referring to the same underlying open file description remain
10963 See also http://thread.gmane.org/gmane.linux.kernel/596462/.
10965 Clarify error that occurs if we add an epoll fd to its own set.
10967 A few minor rewordings.
10968 mtk, after a note by Chris Heath
10969 Rework Q1/A1, describing what happens when adding the same
10970 file descriptor twice to an epoll set, and when adding duplicate
10971 file descriptors to the same epoll set.
10972 Heikki Orsila / mtk / Davide Libenzi
10973 Clarify Q9/A9 to discuss packet/token-oriented files.
10974 mtk, after comments by Devide Libenzi and Chris Heath
10975 Added Q0/A0, making explicit that the key for items in an epoll
10976 set is [file descriptor, open file description].
10977 mtk, after a note by Ron Burk
10978 Change A3, to note that when events are available,
10979 the epoll file descriptor will indicate as being readable.
10981 Add some further explanation to Q5/A5 about why an epoll file
10982 descriptor cannot be passed across a Unix domain socket.
10986 Add SEE ALSO entry for standards(7).
10990 Add grep(1) to SEE ALSO.
10991 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=348552.
10995 Add SEE ALSO entry for posixoptions(7).
10999 Added SEE ALSO entry referring to timerfd_create.2.
11002 ==================== Changes in man-pages-2.80 ====================
11004 Released: 2008-06-05
11010 The following people contributed notes, ideas, or patches that have
11011 been incorporated in changes in this release:
11013 Adrian Bunk <bunk@kernel.org>
11014 Alain Portal <aportal@univ-montp2.fr>
11015 Andreas Herrmann <andreas.herrmann3@amd.com>
11016 Andrew Morton <akpm@linux-foundation.org>
11017 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
11018 Anoop <acv@linux.vnet.ibm.com>
11019 Aurelien Gerome <ag@roxor.cx>
11020 Daniel Burr <dburr@topcon.com>
11021 Davide Libenzi <davidel@xmailserver.org>
11022 Felix Kater <fkater@googlemail.com>
11023 Folkert van Heusden <folkert@vanheusden.com>
11024 Hamaji Shinichiro <shinichiro.hamaji@gmail.com>
11025 Heikki Orsila <shd@modeemi.fi>
11026 Ingo Molnar <mingo@elte.hu>
11027 Justin Pryzby <justinpryzby@users.sourceforge.net>
11028 Karsten Weiss <K.Weiss@science-computing.de>
11029 Martin Pitt <mpitt@debian.org>
11030 Marty Leisner <leisner@rochester.rr.com>
11031 Nicolas François <nicolas.francois@trialog.com>
11032 Nick Piggin <npiggin@suse.de>
11033 Petter Reinholdtsen <pere@hungry.com>
11034 Reuben Thomas <rrt@sc3d.org>
11035 Sam Varshavchik <mrsam@courier-mta.com>
11036 Stuart Brady <sdbrady@ntlworld.com>
11037 Theodoros V. Kalamatianos <thkala@softlab.ece.ntua.gr>
11038 Thomas Huriaux <thomas.huriaux@gmail.com>
11039 Tim Stoakes <tim@stoakes.net>
11040 Timothy Baldwin <T.E.Baldwin99@members.leeds.ac.uk>
11041 Tolga Dalman <tdalman@project-psi.org>
11043 Apologies if I missed anyone!
11050 inotify_add_watch.2
11060 Replace "(il)legal" by "(not) permitted" or "(in)valid".
11067 s/time stamp/timestamp/, for consistency with majority use
11068 in other pages, and in POSIX.1.
11078 Change name of 'start' argument to 'addr' for consistency
11080 * other memory-related interfaces
11081 * POSIX specification (for those interfaces in POSIX)
11082 * Linux and glibc source code (in at least some cases)
11086 s/filesystem/file system/, for consistency with majority use
11087 in other pages, and in POSIX.1.
11091 s/zeroes/zeros/, for consistency with majority use
11092 in other pages, and in POSIX.1.
11097 s/builtin/built-in/, for consistency with majority use
11098 in other pages, and in POSIX.1.
11103 s/normal file/regular file/
11107 s/nonempty/non-empty/
11111 s/nonzero/non-zero/
11115 s/realtime/real-time/, for consistency with majority usage.
11119 s/command line/command-line/ when used attributively.
11123 Use "run time" when non-attributive, "run-time" when attributive.
11127 Various pages that I wrote carried a slightly modified version
11128 of the "verbatim" license. In the interests of minimizing
11129 license proliferation, I've reverted the modified form
11130 so that the license is exactly the same as on other pages
11131 carrying the verbatim license.
11138 s/since kernel x.y.z/since Linux x.y.z/
11143 Reformat kernel version information for flags.
11145 Typographical or grammatical errors have been corrected in several places.
11146 (Special thanks to Nicolas François.)
11153 mtk, after a suggestion by aeb
11154 Documents random_r(3), srandom_r(3), initstate_r(3), and
11155 setstate_r(3), which are the reentrant equivalents of
11156 random(3), srandom(3), initstate(3), and setstate(3).
11170 Links to random_r.3.
11186 Links to encrypt.3.
11189 Changes to individual pages
11190 ---------------------------
11194 Added note that CLONE_STOPPED (which no-one uses anyway) is
11199 Add NOTES section pointing out that 'size' argument is unused
11200 since kernel 2.6.8.
11204 Added portability note to BUGS text for EPOLL_CTL_DEL.
11208 If the 'sigmask' is NULL, then epoll_pwait() is equivalent
11213 NOTES: since glibc 2.3.3, the glibc NPTL fork() wrapper
11214 bypasses the fork() system call to invoke clone() with
11215 flags providing equivalent functionality.
11218 mtk, after a note from Adrian Bunk
11219 FUTEX_FD has been removed, as of kernel 2.6.26.
11223 Note that this system call is made obsolete by utimensat(2).
11226 Petter Reinholdtsen
11227 SEE ALSO: Add getgrouplist(3).
11228 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=479284.
11230 NGROUPS_MAX increased in kernel 2.6.4.
11231 SEE ALSO: Add credentials(7).
11233 Reformat DESCRIPTION and RETURN VALUE sections to be more
11234 consistent with man-pages style.
11235 Add some more detail to descriptions of system calls.
11236 Clarified what happens if caller of getgroups() is a member of
11237 more than 'size' supplementary groups.
11238 ERRORS: Add ENOMEM.
11241 mtk, after a note from Ingo Molnar
11242 Add text in NOTES about the punchier effect of nice values in
11243 kernel 2.6.23 and later.
11244 Add Documentation/scheduler/sched-nice-design.txt to SEE ALSO list.
11248 Added VERSIONS section noting that this system call first
11249 appeared in 2.4.11.
11252 Marty Leisner / mtk
11253 Add text explicitly noting that sig==0 can be used to check for
11254 the existence of a PID or PGID.
11256 A few minor rewordings.
11260 The location of the numactl package has changed.
11264 Added some .SS headings to make structure of page a little
11266 mtk, with input from Nick Piggin
11267 MAP_POPULATE supports both file and anonymous mappings.
11268 Since 2.6.23, MAP_POPULATE supports private mappings.
11269 Since 2.6.23, MAP_NONBLOCK causes MAP_POPULATE to be a no-op.
11271 NOTES: Added details on mapping address that is selected by
11272 kernel when MAP_FIXED is / isn't specified.
11276 The MS_REMOUNT changes in 2.4 were at 2.4.10 (not 2.4).
11278 Minor wording change.
11282 Clarify that "unused" fields in msginfo structure are
11283 "unused within the kernel".
11284 msginfo.msgpool is measured in kilobytes, not bytes.
11285 Minor rewordings in comments for msginfo structure.
11289 Various minor rewordings and restructurings for clarity.
11290 mtk, after a note from Reuben Thomas
11291 Remove "msgop" from NAME section.
11295 Clarify meaning of "BSD group semantics".
11296 SEE ALSO: add chown(2).
11300 SEE ALSO: add chown(2) and chmod(2).
11304 SEE ALSO: add mprotect(2) and shmat(2).
11308 SYNOPSIS: s/size_t \*len/size_t len/
11312 Note that O_CLOEXEC should be in the next POSIX.1 revision.
11314 More than just ext2 supports "mount -o bsdgroups" nowadays,
11315 so make the discussion about group ownership of new files a bit
11318 SEE ALSO: add chown(2) and chmod(2).
11322 If the 'sigmask' is NULL, then ppoll() is equivalent to poll()
11323 with respect to signal mask manipulations.
11327 s/posix_madvise (2)/posix_madvise (3)/;
11328 (The referred-to page still doesn't exist yet, but hopefully
11329 will do sometime soon.)
11332 Anoop, Acked by Roland McGrath.
11333 Re PTRACE_PEEKUSER: the offsets and data returned might not
11334 match with the definition of struct user.
11335 See also http://lkml.org/lkml/2008/5/8/375
11339 Improve wording for EAGAIN error in discussion of MSG_DONTWAIT.
11343 POSIX.1 also allows EEXIST for the ENOTEMPTY error condition.
11344 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=467552.
11346 sched_setscheduler.2
11347 mtk, with input from Ingo Molnar
11348 Add description of SCHED_IDLE policy (new in 2.6.23).
11349 Tweak description of SCHED_BATCH.
11354 Various wording clean-ups.
11358 Clarify that "unused" fields in seminfo structure are
11359 "unused within the kernel".
11360 Minor rewordings in comments for seminfo structure.
11364 Small fix in example code.
11367 mtk / Karsten Weiss
11368 Clarify description of setpgid() a little.
11372 Clarify that "unused" fields in shminfo structure are
11373 "unused within the kernel".
11374 Minor rewordings in comments for shminfo structure.
11377 mtk, after a note from Reuben Thomas
11378 Remove "shmop" from NAME section.
11382 Added BUGS text noting that before kernel 2.6.25, the ssi_int
11383 and ssi_ptr fields are not set.
11384 Added comments describing fields in signalfd_siginfo structure.
11385 Update field names in example program (s/signo/ssi_signo/).
11386 Various small fixes, and remove duplicated sentence.
11387 Minor edits to structure definition.
11391 Added some comments to code in NOTES.
11395 Minor wording change.
11399 SEE ALSO: add lchown(2).
11402 mtk / Andrew Morton
11403 Remove statement that (SYNC_FILE_RANGE_WAIT_BEFORE |
11404 SYNC_FILE_RANGE_WRITE | SYNC_FILE_RANGE_WAIT_AFTER) is
11405 a traditional fdatasync(2) operation.
11406 See https://bugzilla.mozilla.org/show_bug.cgi?id=421482
11407 comments 129 to 131.
11411 This page is now up to date as at kernel 2.6.25.
11415 Small tidy up of language relating to permissions/capabilities.
11419 Minor change to example program.
11420 Minor wording change.
11424 Remove unnecessary subheading for utimes().
11425 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=477402.
11427 Change description in NAME line ("or" is not correct: these calls
11428 always change *both* timestamps).
11429 CONFORMING TO: utimes() is in POSIX.1-2001.
11431 Rename 'buf' argument of utime() to 'times' (like utimes()).
11432 Clarify explanation of EACCES and EPERM errors.
11433 Remove BUGS section, since it doesn't seem to add useful
11435 Clarified discussion of capabilities, and noted that
11436 CAP_DAC_OVERRIDE also has a role.
11437 Other minor rewordings.
11440 mtk, after a note by Justin Pryzby
11441 Add a sentence clarifying that even though the default disposition
11442 of SIGCHLD is "ignore", explicitly setting the disposition to
11443 SIG_IGN results in different treatment of zombies.
11452 Kevin O'Gorman <kogorman@csc.calpoly.edu>
11453 Add "Link with -lrt" to SYNOPSIS.
11457 s/backtrace_symbols/backtrace_symbols_fd/ in one sentence.
11459 Fix bogus reference to variable 'strings': should be:
11460 "the array of pointers".
11464 Add warning under NOTES that asctime(), ctime(), gmtime(), and
11465 localtime() may each overwrite the static object returned by any
11466 of the other calls.
11471 Add more detail to the description of the fields in the
11472 structure returned by dladdr().
11476 Clean up SYNOPSIS after work by cut-and-paste-Pete:
11477 the necessary header file is <unistd.h> not <sys/time.h>!
11481 Add documentation of lutimes(), which appeared in glibc 2.6.
11483 Change description in NAME line ("or" is not correct: these calls
11484 always change *both* timestamps).
11485 CONFORMING TO: futimes() did not come from 4.2BSD. (It came from
11486 FreeBSD; see the FreeBSD man page.)
11490 Noted that caller must not modify returned value string.
11491 Noted that getenv() is not reentrant: the buffer may be statically
11492 allocated and overwritten by later calls to getenv(), putenv(),
11493 setenv(), or unsetenv().
11494 Other minor rewrites.
11497 Petter Reinholdtsen
11498 SEE ALSO: Add getgrouplist(3).
11499 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=479284.
11503 Add 'h_errno' to NAME list.
11507 Add 'optarg', 'optind', 'opterr', and 'optopt' to NAME section.
11508 Add subheading for getopt_long() and getopt_long_only()
11513 Point out that this function should be avoided in favor of
11515 Add ERRORS section referring to open(2).
11519 SYNOPSIS: Fix declaration of valuep.
11520 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=476672.
11524 RETURN VALUE: Note circumstances in which successful malloc() and
11525 calloc() can return NULL.
11528 mtk, after a note by Marty Leisner
11529 Note that <fcntl.h> is needed for O_* constants and <sys/stat.h>
11530 is needed for 'mode' constants.
11534 Describe treatment of close-on-exec flag by opendir() and
11539 SEE ALSO: add ttyname(3).
11542 mtk / Timothy Baldwin
11543 Clarify semantics of raise() when called from a multithreaded
11545 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=476484.
11547 Rewrites and additions to various parts of the page.
11550 Tolga Dalman / aeb / mtk
11551 Remove outdated warning in NOTES; encourage the use of
11553 Folkert van Heusden
11554 Clarify wording describing range of values returned by rand().
11557 aeb / mtk / Tolga Dalman
11558 Recommend use or random_r(3) for multithreaded applications
11559 that need independent, reproducible sequences of random numbers.
11561 Move references to "The Art of Computer Programming" and
11562 "Numerical Recipes", formerly in rand(3), to this page.
11564 Add drand48(93) to SEE ALSO list.
11568 Clarify description of 'rm_eo' field.
11571 mtk, after a note by Marty Leisner
11572 Note that <fcntl.h> is needed for O_* constants and <sys/stat.h> is
11573 needed for 'mode' constants.
11577 Added pointer to example in sem_wait(3).
11587 mtk, after a note from Marty Leisner
11588 Add text to SYNOPSIS noting the need to link with "-lrt" or
11593 setenv() copies 'name' and 'value' (contrast with putenv()).
11594 unsetenv() of a nonexistent variable does nothing and is
11595 considered successful.
11596 Noted that setenv() and unsetenv() need not be reentrant.
11599 mtk, after a note by Marty Leisner
11600 Note that <fcntl.h> is needed for O_* constants and <sys/stat.h> is
11601 needed for 'mode' constants.
11605 initstate_r(3), setkey_r(3), setstate_r(3) are now documented.
11613 gethostname() is in Section 2, not section 3.
11617 Fix rendering of ' (backtick) and apostrophe (') in tables
11621 s/unicode.com/unicode.org/
11625 NOTES: Pthreads requires that all threads share the same UIDs and
11626 GIDs. But the Linux kernel maintains separate UIDs and GIDs for
11627 every thread. NPTL does some work to ensure that credential
11628 changes by any thread are carried through to all POSIX threads in
11631 sysconf(_SC_NGROUPS_MAX) can be used to determine the number of
11632 supplementary groups that a process may belong to.
11633 Clarify that supplementary group IDs are specified in POSIX.1-2001.
11636 mtk, after a note from Sam Varshavchik
11637 For answer A2, change "not recommended" to "careful programming
11642 Document SIGIO feature (new in 2.6.25) for inotify file descriptors.
11644 Note that select()/poll()/epoll_wait() indicate a ready inotify
11645 file descriptor as readable.
11647 Document IN_ATTRIB in a little more detail.
11651 Grammar fix, plus fix typo in script.
11653 Add list of thread-safe functions.
11657 Add a section on the upcoming POSIX revision.
11660 Justin Pryzby / mtk
11661 Various wording improvements.
11664 ==================== Changes in man-pages-3.00 ====================
11666 Released: 2008-06-12, Konolfingen
11672 The following people contributed notes, ideas, or patches that have
11673 been incorporated in changes in this release:
11675 Andries Brouwer <Andries.Brouwer@cwi.nl>
11676 Stuart Brady <sdbrady@ntlworld.com>
11678 Apologies if I missed anyone!
11684 The POSIX.1 man pages (sections 0p, 1p, 3p) have been moved out
11685 of this package into the separate man-pages-posix package.
11686 This made sense because those pages are seldom changed (only formatting
11687 fixes, etc.) so that it was unnecessary to redistribute them with each
11697 s/`/\`/ for backquotes used in command substitution, for
11698 proper rendering in UTF-8.
11701 mtk, after a note from Stuart Brady
11702 Using /'x'/ to denote a character (string) renders poorly in
11703 UTF-8, where the two ' characters render as closing single
11704 quotes. On the other hand, using /`x'/ renders nicely on UTF-8,
11705 where proper opening and closing single quotes are produced by
11706 groff(1), but looks ugly when rendered in ASCII. Using the
11707 sequence /\\aqx\\aq/ produces a reasonable rendering ('\\aq'
11708 is a vertical "apostrophe quote") in both UTF-8 and ASCII.
11709 So that change is made in a number of pages.
11710 See also http://www.cl.cal.ac.uk/~mgk25/ucs/quotes.html.
11714 Replace form /`string'/ by /"string"/, since the former renders
11723 Control character names (^X) are written boldface, without
11732 Various edits to try and bring some consistency to the use of
11736 Changes to individual pages
11737 ---------------------------
11741 Small rewordings in description of packet mode.
11745 Minor formatting fixes.
11748 ==================== Changes in man-pages-3.01 ====================
11750 Released: 2008-06-25, Munich
11756 The following people contributed notes, ideas, or patches that have
11757 been incorporated in changes in this release:
11759 Alain Portal <aportal@univ-montp2.fr>
11760 Andreas Herrmann <andreas.herrmann3@amd.comm>
11761 Andrew P <ap@zip.com.au>
11762 Andrew Clayton <andrew@digital-domain.net>
11763 Bart Van Assche <bart.vanassche@gmail.com>
11764 Christian Borntraeger <borntraeger@de.ib.com>
11765 Christoph Hellwig <hch@infradead.org>
11766 Daniele Giacomini <appunti2@gmail.com>
11767 Dorin Lazar <dorin.lazar@gmail.com>
11768 George Spelvin <linux@horizon.com>
11769 Jason Englander <jason@englanders.cc>
11770 Jeff Moyer <jmoyer@redhat.com>
11771 Laurent Vivier <laurent.vivier@bull.net>
11772 Masatake YAMOTO <yamoto@redhat.com>
11773 Matt Mackall <mpm@selenic.com>
11774 Neil Horman <nhorman@tuxdriver.com>
11775 Pavel Machek <pavel@suse.cz>
11776 Peter Zijlstra <a.p.zijlstra@chello.nl>
11777 Petr Baudis <pasky@suse.cz>
11778 Petr Gajdos <pgajdos@suse.cz>
11779 Roman Zippel <zippel@linux-m68k.org>
11780 Sam Varshavchik <mrsam@courier-mta.com>
11781 Samuel Thibault <samuel.thibault@ens-lyon.org>
11782 Stephane Chazelas <stephane_chazelas@yahoo.fr>
11783 Stuart Cunningham <stuartc@rd.bbc.co.uk>
11784 Thomas Gleixner <tglx@linutronix.de>
11785 Tolga Dalman <tdalman@project-psi.org>
11786 Yao Zhao <dragonlinux@gmail.com>
11787 WANG Cong <wcong@critical-links.com>
11789 Apologies if I missed anyone!
11792 New and rewritten pages
11793 -----------------------
11797 A complete rewrite of this page, now with much more detail.
11801 A description of hostname resolution. Taken from FreeBSD 6.2,
11802 and lightly edited for man-pages style.
11806 A description of symbolic links. Taken from FreeBSD 6.2, but
11807 heavily edited for Linux details, improved readability, and
11811 Newly documented interfaces in existing pages
11812 ---------------------------------------------
11815 mtk / Peter Zijlstra
11816 Add description of RLIMIT_RTTIME limit, new in 2.6.25.
11820 Add description of mkostemp(), new in glibc 2.7.
11823 mtk, after a note by Petr Gajdos; review by Neil Horman
11824 Document core_pattern pipe syntax, which appeared in
11826 Add an example program demonstrating use of core_pattern
11829 Document /proc/PID/coredump_filter, new in kernel 2.6.23.
11830 Documentation was based on the text in
11831 Documentation/filesystems/proc.txt, plus testing, and
11832 checking the kernel source.
11836 Document /proc/PID/oom_score, which was new in kernel 2.6.11.
11837 This file displays the "badness" score of the process, which
11838 provides the basis for OOM-killer decisions.
11840 Document /proc/PID/oom_adj, which was new in kernel 2.6.11.
11841 This file influences the oom_score of a process.
11843 Document /proc/PID/limits, which was new in 2.6.24.
11844 This file displays a process's resource limits.
11846 Document /proc/PID/fdinfo/*, which was new in 2.6.22.
11847 These files display info about each descriptor opened by the
11848 process: the current file offset, and the file access mode +
11849 file status flags as set in open() or fcntl(F_SETFL).
11851 Document /proc/PID/mountinfo, which was new in 2.6.26.
11852 This file displays information about mount points.
11853 Closely based on text from Documentation/filesystems/proc.txt.
11855 Document /proc/PID/mountstats, which was new in 2.6.17.
11856 This file displays statistics about mount points.
11858 Document /proc/PID/status.
11859 Samuel Thibault / mtk, review by Laurent Vivier,
11860 Christian Borntraeger, and Andrew P
11861 Document guest (virtual CPU) time field in /proc/stat.
11862 Document guest (virtual CPU) time fields in /proc/PID/stat.
11874 Link to getcwd.3, which describes several interfaces, among
11875 them getcwd(), which is in fact a system call.
11877 sched_setaffinity.2
11878 sched_setscheduler.2
11882 SEE ALSO: Add cpuset(7).
11910 SEE ALSO: Add symlink(7).
11918 Wrap source lines so that new sentence starts on new line.
11933 Added VERSIONS section.
11948 For consistency, "fix" cases where argument of .B or .I was
11949 on the following source line.
11965 SEE ALSO: add time(7)
11967 Typographical or grammatical errors have been corrected in several places.
11968 (Special thanks to Nicolas François and Alain Portal.)
11971 Changes to individual pages
11972 ---------------------------
11976 Add a few more words to DESCRIPTION.
11977 NOTES: Add pointer to acct(5).
11981 s/process/calling process/ so as to say that the alarm signal is
11982 delivered to the calling process.
11986 Clarify discussion of return value of sbrk().
11988 DESCRIPTION: Add some sentences giving an overview of these
11990 Add note recommending use of malloc(3).
11991 Change name of brk() argument to the simpler 'addr'.
11992 Add "(void *)" cast to "-1" for error return of sbrk().
11993 Removed some incorrect text about "brk(0)".
11994 Note that SUSv2 specified the return value of sbrk().
11995 Added a detail on the glibc brk() wrapper.
11996 Remove discussions of old standards (C89 and POSIX.1-1990);
11997 CONFORMING TO already discusses the situation with respect
11998 to more recent standards.
12002 Clarify description of chmod() and fchmod().
12003 Add further detail on S_ISUID, S_ISGID, and S_ISVTX permissions.
12004 Reformat list of permissions bits.
12008 Describe rules governing ownership of new files (bsdgroups
12009 versus sysvgroups, and the effect of the parent directory's
12010 set-group-ID permission bit).
12014 Clarify description a little.
12015 s/changes the root directory/
12016 changes the root directory of the calling process/
12020 Fix text that warns against use of NULL argv and envp.
12021 Using a NULL envp does in fact seem to be portable (works
12022 on Solaris and FreeBSD), but the Linux semantics for a NULL
12023 argv certainly aren't consistent with other implementations.
12024 See http://bugzilla.kernel.org/show_bug.cgi?id=8408.
12027 mtk, after a note from George Spelvin
12028 Document d_type field, present since kernel 2.6.4.
12033 Noted that POSIX.1 leaves interactions with alarm(), sleep(),
12034 and usleep() unspecified.
12035 Linux 2.6.16 removed the MAX_SEC_IN_JIFFIES ceiling on timer
12037 Other minor changes.
12044 mtk, after a note by Masatake YAMOTO and input from Jeff Moyer
12045 Describe the unconventional error return provided by the
12046 wrapper function in libaio (and contrast with behavior if
12047 the system call is invoked via syscall(2)).
12048 See http://thread.gmane.org/gmane.linux.ltp/4445/
12050 Re-order ERRORS and SEE ALSO entries to be alphabetical.
12058 s/AIO request blocks/AIO control blocks/
12062 Note that EEXIST applies, even if the pathname is a
12063 (possibly dangling) symbolic link.
12066 mtk, after a report from Stephane Chazelas
12067 Remove crufty discussion of HZ, and replace with a pointer
12069 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=485636
12070 mtk, after some discussions with Bart Van Assche and Roman Zippel
12071 NOTES: describe CLOCK_REALTIME versus CLOCK_NANOSLEEP
12072 See also http://thread.gmane.org/gmane.linux.kernel/696854/
12073 "nanosleep() uses CLOCK_MONOTONIC, should be CLOCK_REALTIME?"
12075 Replace mentions of "process' by "thread".
12076 NOTES: describe case where clock_nanosleep() can be preferable.
12077 Some minor rewrites.
12080 mtk, after a note from Christoph Hellwig
12081 NOTES: Note that access mode flags are not single bits,
12082 and document the Linuxism "access mode 3".
12083 See also http://thread.gmane.org/gmane.linux.kernel/653123.
12087 Minor wording fixes.
12091 Add comment to 'ee_pad' field in structure definition.
12093 sched_setscheduler.2
12095 Add pointer to discussion of RLIMIT_RTTIME in getrlimit.2.
12096 mtk, after a note by Andrew Clayton
12097 Rewrote and restructured various parts of the page for greater
12100 Add more detail to the rules that are applied when an
12101 unprivileged process with a non-zero RLIMIT_RTPRIO limit
12102 changes policy and priority.
12103 SEE ALSO: Add Documentation/scheduler/sched-rt-group.txt
12107 SYNC_FILE_RANGE_WRITE can block on writes greater than request
12108 queue size. For some background, see
12109 http://thread.gmane.org/gmane.linux.kernel/687713/focus=688340
12113 Added system call history back to version 1.2.
12114 Fix typo on kernel version for pivot_root().
12118 Document ENOSYS error, which can occur if kernel was built without
12123 Clarify description of 'times' array for utimes().
12127 The longstanding bug that if delta was NULL, olddelta
12128 didn't return the outstanding clock adjustment, is now fixed
12129 (since glibc 2.8 + kernel 2.6.26).
12130 http://sourceware.org/bugzilla/show_bug?id=2449
12131 http://bugzilla.kernel.org/show_bug.cgi?id=6761
12135 Note that these functions are included in the next POSIX revision.
12136 Remove editorial discussion about what the functions should have
12141 Rewrote various pieces, and added some details.
12145 Improve description or 'hints' and 'res' arguments.
12146 Add details on numeric strings that can be specified for 'node'.
12147 Other fairly major restructurings and rewrites to improve
12148 logical structure and clarity of the page.
12149 SEE ALSO: Add hostname(7).
12153 DESCRIPTION: Add reference to inet_addr(3) for dotted notation.
12154 SEE ALSO: add inet(3).
12156 Added BUGS section noting that gethostbyname() does not
12157 recognize hexadecimal components in dotted address strings;
12158 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482973
12161 mtk, after Stuart Cunningham pointed out the typo
12162 Remove statement that LSB deprecates the functions
12163 "endmntent(), setmntent() [sic] and setmntent()".
12164 This doesn't seem to be true (I can't find mention of it
12165 being deprecated in any of the LSB specs). Rather, LSB simply
12166 doesn't specify these functions. (LSB 1.3 had a spec of
12167 setmntent(), but not getmntent() or endmntent(), and noted
12168 that having a spec of setmntent() was of little use without
12169 also having a spec of getmntent().)
12170 See also https://lists.linux-foundation.org/pipermail/\
12171 lsb-discuss/2006-October/003078.html
12175 Remove mention of sa_len field from example code.
12176 That field is a BSDism not present on Linux.
12178 Various minor changes.
12181 mtk / Stephane Chazelas
12182 inet_aton() is *not* in POSIX.1.
12183 Rewrote discussion of why inet_addr() is disfavored.
12184 SEE ALSO: Add getaddrinfo(3).
12185 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482979.
12186 mtk, after a note by Stephane Chazelas
12187 Describe the various address forms supported by inet_aton().
12189 Rewrite description of inet_network().
12190 Clarify discussion of inet_lnaof(), inet_netof(), and inet_makeaddr().
12191 Add discussion of Classful Addressing, noting that it is obsolete.
12192 Added an EXAMPLE program.
12194 Relocate discussion of i386 byte order to NOTES.
12195 Note that inet_aton() returns an address in network byte order.
12196 SEE ALSO: Add byteorder(3) and getnameinfo(3).
12200 Remove unneeded header files from SYNOPSIS.
12201 SEE ALSO: Add inet(3) and getnameinfo(3).
12202 Make NAME line more precise.
12203 Move errors to an ERRORS section.
12204 Add EXAMPLE section pointing to inet_pton(3).
12207 mtk / Stephane Chazelas
12208 Remove statement that inet_pton() extends inet_ntoa();
12209 that's not really true, since inet_pton() doesn't support
12210 all of the string forms that are supported by inet_ntoa().
12211 SEE ALSO: Add getaddrinfo(3).
12212 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482987.
12214 Describe IPv6 address formats.
12215 Describe dotted decimal format in more detail.
12216 Add an example program.
12218 Remove unneeded header files from SYNOPSIS.
12219 Make NAME line more precise.
12220 Make description of return value more precise.
12221 SEE ALSO: Add inet(3).
12225 Note that EEXIST applies, even if the pathname is a
12226 (possibly dangling) symbolic link.
12230 Fix discussion of O_EXCL flag.
12231 These functions may also fail for any of the errors described
12233 Various other rewordings.
12237 Document DT_LNK (symbolic link) for d_type field.
12238 Reorder DT_ entries alphabetically.
12242 Recommend against drem(), in favor of remainder().
12245 mtk, after a note from Stephane Chazelas
12246 Add an ERRORS section documenting at least some of the errors
12247 that may occur for scanf().
12248 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=487254.
12249 mtk, after a note from Stephane Chazelas; review by Stephane Chazelas
12250 Document the GNU 'a' modifier for dynamically allocating strings.
12251 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=487254.
12252 Document the GNU 'm' modifier for dynamically allocating strings.
12256 s/strcat/strncat/ (a typo that changed the semantics in
12260 mtk, after a note from Daniele Giacomini
12261 Modify SYNOPSIS to show protoypes of both versions of strerror_r(),
12262 and make other small clarifications of the description regarding
12266 George Spelvin (taking time out from his busy Broadway schedule),
12267 with some tweaks by Matt Mackall and mtk
12268 Add a Usage subsection that recommends most users to use
12269 /dev/urandom, and emphasizes parsimonious usage of
12273 Petr Baudis <pasky@suse.cz>
12274 LC_TIME: Describe first_weekday and first_workday.
12278 The vaious CPU time fields in /proc/stat and /proc/PID/stat
12279 return time in clock ticks (USER_HZ, cputime_to_clock_t(),
12280 sysconf(_SC_CLK_TCK)).
12281 Updated, clarified and expanded the description several
12282 fields in /proc/[number]/stat.
12284 Clarified and expanded the description of /proc/[number]/fd.
12286 Updated and clarified the description of /proc/[number]/statm.
12288 Updated and clarified the description of /proc/sys/fs/dentry-state.
12290 Many formatting, wording, and grammar fixes.
12294 Enhanced description of VERSIONS section.
12298 Note that Linux does not currently support ACLs for POSIX
12303 Note that Linux supports ACLs on POSIX named semaphores
12307 mtk, with some suggestions from Bart Van Assche and Thomas Gleixner
12308 Added some details about where jiffies come into play.
12309 Added section on high-resolution timers.
12310 Mentioned a few other time-related interfaces at various
12311 points in the page.
12312 See http://thread.gmane.org/gmane.linux.kernel/697378.
12315 mtk, after a note by Samuel Thibault
12316 Provide a clear description of the three types of address that
12317 can appear in the sockaddr_un structure: pathname, unnamed,
12321 ==================== Changes in man-pages-3.02 ====================
12323 Released: 2008-07-02, Konolfingen
12329 The following people contributed notes, ideas, or patches that have
12330 been incorporated in changes in this release:
12332 Alain Portal <aportal@univ-montp2.fr>
12333 Andries Brouwer <Andries.Brouwer@cwi.nl>
12334 Reuben Thomas <rrt@sc3d.org>
12335 Sam Varshavchik <mrsam@courier-mta.com>
12336 Stephane Chazelas <stephane_chazelas@yahoo.fr>
12337 WANG Cong <xiyou.wangcong@gmail.com>
12339 Apologies if I missed anyone!
12342 New and rewritten pages
12343 -----------------------
12347 A description of the clock_nanosleep() system call,
12348 which was added in kernel 2.6.
12352 A near complete rewrite, including additional information and
12353 a new example program.
12357 Documents getutmp(3) and getutmpx(3).
12359 gnu_get_libc_version.3
12361 Documents gnu_get_libc_version(3) and gnu_get_libc_release(3).
12365 Documents sigwait(3).
12369 An overview of the POSIX shared memory API.
12372 Newly documented interfaces in existing pages
12373 ---------------------------------------------
12377 Document updwtmpx(3).
12387 gnu_get_libc_release.3
12389 Link to gnu_get_libc_version.3
12397 Link to getutent.3.
12409 s/user name/username/
12413 s/host name/hostname/
12416 Changes to individual pages
12417 ---------------------------
12421 SEE ALSO: add symlink.7. (3.01 changelog wrongly said this
12426 Remove superfluous text from RETURN VALUE.
12430 SEE ALSO: Add mmap(2), shm_overview(7).
12435 SEE ALSO: add shm_overview(7).
12439 Added a bit more detail on what sigreturn() actually does.
12444 SEE ALSO: Add sigwait(3).
12448 Describe behavior when multiple threads are blocked in
12449 sigwaitinfo()/sigtimedwait().
12450 SEE ALSO: Add sigwait(3).
12454 RETURN VALUE: describe return value on success.
12455 Add an ERRORS section documenting POSIX.1-specified errors.
12458 mtk, after a note by Stephane Chazelas
12459 getaddrinfo() supports specifying IPv6 scope-IDs.
12463 ERRORS: add ENOTTY.
12464 SEE ALSO: add utmp(5).
12468 utmpname() does return a value.
12470 Add paragraph to start of DESCRIPTION recommending
12471 use of POSIX.1 "utmpx" functions.
12472 CONFORMING TO: mention utmpxname().
12473 Add an ERRORS section.
12474 There are no utmpx equivalents of the _r reentrant functions.
12475 Clarify discussion of return values.
12476 Add pointer to definition of utmp structure in utmp(5).
12477 Clarify discussion of utmpx file on other systems (versus
12482 SEE ALSO: add getutmp(3)
12486 Fix error in description of IPv6 presentation format:
12487 s/x.x.x.x.x.x.x.x/x:x:x:x:x:x:x:x/.
12490 Reuben Thomas / mtk
12491 Fix confused wording for return value of setvbuf().
12492 Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=488104.
12494 Other minor rewordings.
12498 SEE ALSO: add shm_overview(7).
12501 mtk, after a note by Alain Portal
12502 Slight rewording to make life easier for non-native English
12507 Add discussion of POSIX.1 utmpx specification.
12508 Provide a little more detail on fields of utmp structure.
12509 Added comments to macros for ut_type field.
12510 Correct the description of the ut_id field.
12512 Consolidate duplicated information about ut_tv and ut_session
12513 on biarch platforms.
12515 Move some text from CONFORMING TO to NOTES.
12516 Removed some crufty text.
12517 SEE ALSO: add login(3), logout(3), logwtmp(3).
12518 UT_LINESIZE is 32 (not 12).
12520 SEE ALSO: add getutmp(3)
12524 Enhanced the discussion of font conventions.
12528 Note that the delivery order of multiple pending standard
12529 signals is unspecified.
12530 SEE ALSO: Add sigwait(3).
12533 ==================== Changes in man-pages-3.03 ====================
12535 Released: 2008-07-08, Konolfingen
12541 The following people contributed notes, ideas, or patches that have
12542 been incorporated in changes in this release:
12544 Alain Portal <aportal@univ-montp2.fr>
12545 Andi Kleen <ak@muc.de>
12546 Hidetoshi Seto <seto.hidetoshi@jp.fujitsu.com>
12547 Li Zefan <lizf@cn.fujitsu.com>
12548 Paul Jackson <pj@sgi.com>
12549 Sam Varshavchik <mrsam@courier-mta.com>
12551 Apologies if I missed anyone!
12554 New and rewritten pages
12555 -----------------------
12558 Andi Kleen, with some text and edits by mtk
12559 Documents the getcpu(2) system call, introduced in Linux 2.6.19.
12563 Documents sched_getcpu(3), a wrapper for getcpu(2), provided
12567 Paul Jackson, with review and editing by mtk, and comments by
12568 Hidetoshi Seto and Li Zefan
12569 A description of the cpuset file system, the mechanism introduced
12570 kernel 2.6.12 for confining processes to designated processors
12571 and nodes. (Becomes the fourth largest page in man-pages!)
12574 Newly documented interfaces in existing pages
12575 ---------------------------------------------
12579 Add documentation of readdir_r().
12587 Link to updwtmp.3 (3.02 changelog wrongly said this had been done).
12599 sched_setaffinity.2
12602 SEE ALSO: Add getcpu(2).
12631 ERRORS: Added reference to signal(7) in discussion of EINTR.
12635 Wrapped very long source lines.
12638 Changes to individual pages
12639 ---------------------------
12643 Small wording change.
12647 ERRORS: Add EINTR error.
12651 ERRORS: Add EINTR error.
12655 Note circumstances in which each SA_* flag is meaningful.
12657 Describe POSIX specification, and Linux semantics for
12658 SA_NOCLDWAIT when establishing a handler for SIGCHLD.
12660 Add pointer under SA_RESTART to new text in signal(7)
12661 describing system call restarting.
12667 ERRORS: Added EINTR error.
12668 A few minor rewordings.
12672 Remove statement that WUNTRACED and WCONTINUED only have effect
12673 if SA_NOCLDSTOP has not been set for SIGCHLD. That's not true.
12677 Add a pointer to signal(7) for further explanation of EINTR.
12681 SEE ALSO: Add passwd(5).
12685 Remove <sys/types.h> from SYNOPSIS; POSIX.1-2001 does not
12687 Some minor rewordings.
12691 RETURN VALUE: explicitly mention interruption by signal handler.
12692 SEE ALSO: add signal(7).
12696 POSIX.1-2001 also only documents EINVAL.
12700 SEE ALSO: Add getgrent(3), getgrnam(3).
12704 SEE ALSO: Add getpwent(3), getpwnam(3).
12708 Add pointer to description of /proc/PID/cpuset in cpuset(7).
12712 Add a section describing system call restarting, and noting
12713 which system calls are affected by SA_RESTART, and which
12714 system calls are never restarted.
12716 Describe the aberrant Linux behavior whereby a stop signal
12717 plus SIGCONT can interrupt some system calls, even if no
12718 signal handler has been established, and note the system
12719 calls that behave this way.
12721 Note a few more architectures on which signal numbers are valid.
12722 SEE ALSO: added a number of pages.
12724 Update async-signal-safe function list for POSIX.1-2004 (which
12725 adds sockatmark()).
12728 ==================== Changes in man-pages-3.04 ====================
12730 Released: 2008-07-15, Konolfingen
12736 The following people contributed notes, ideas, or patches that have
12737 been incorporated in changes in this release:
12739 Alain Portal <aportal@univ-montp2.fr>
12740 Andrea Arcangeli <andrea@cpushare.com>
12741 Andreas Mohr <andi@lisas.de>
12742 Andrew Morgan <morgan@kernel.org>
12743 Erik Bosman <ejbosman@cs.vu.nl>
12744 John Brooks <aspecialj@gmail.com>
12745 Nikanth Karthikesan <knikanth@suse.de>
12746 Pavel Heimlich <tropikhajma@seznam.cz>
12747 Petr Gajdos <pgajdos@suse.cz>
12748 Sam Varshavchik <mrsam@courier-mta.com>
12749 Serge Hallyn <serue@us.ibm.com>
12750 Sripathi Kodi <sripathik@in.ibm.com>
12751 Vincent Lefevre <vincent@vinc17.org>
12753 Apologies if I missed anyone!
12761 A page describing the preferred licenses for new pages that
12762 are contributed to man-pages.
12765 New and rewritten pages
12766 -----------------------
12770 New page documenting the utimensat() system call, new in 2.6.22,
12771 and futimens() library function.
12775 Documents etext, edata, and end symbols.
12778 Newly documented interfaces in existing pages
12779 ---------------------------------------------
12783 Add description of rawmemchr().
12787 Document /proc/config.gz (new in kernel 2.6).
12788 mtk, based on text from Documentation/vm/sysctl.txt
12789 Document /proc/sys/vm/oom_kill_allocating_task
12790 (new in Linux 2.6.24).
12791 Document /proc/sys/vm/oom_dump_tasks
12792 (new in Linux 2.6.25).
12793 Document /proc/sys/vm/panic_on_oom
12794 (new in Linux 2.6.18).
12807 Link to new utimensat.2.
12815 Link to gethostbyname.3.
12839 s/parameter/argument/ when talking about the things given
12840 to a function call, for consistency with majority usage.
12844 s/UNIX/Unix/, when not used as part of a trademark,
12845 for consistency with majority usage in pages.
12848 mtk, after a note from Alain Portal
12849 Put SEE ALSO entries into alphabetical order.
12853 Remove period at end of SEE ALSO list.
12856 mtk, after a note by Alain Portal
12857 Even when the CONFORMING TO section is just a list of standards,
12858 they should be terminated by a period.
12873 Small wording fixes -- express <=, <, >=, > in words when in
12877 sched_setscheduler.2
12881 Minor rewording w.r.t. use of the term "parameter".
12883 Typographical or grammatical errors have been corrected in several
12884 other places. (Many, many thanks to Alain Portal!)
12887 Changes to individual pages
12888 ---------------------------
12892 Update in line with addition of file capabilities and
12893 64-bit capability sets in kernel 2.6.2[45].
12897 Add "Link with -lrt" to SYNOPSIS.
12901 Document RUSAGE_THREAD, new in 2.6.26.
12903 Improve description of RUSAGE_CHILDREN.
12904 Add pointer to /proc/PID/stat in proc(5).
12905 Other minor clean-ups.
12908 Nikanth Karthikesan
12909 Since Linux 2.6.25, CAP_SYS_ADMIN is longer required to set
12910 a low priority (IOPRIO_CLASS_IDLE).
12914 Since Linux 2.6.26, MS_RDONLY honors bind mounts.
12918 SEE ALSO: add utimensat(3).
12921 Serge Hallyn, with some edits/input from mtk
12922 Document PR_CAPBSET_READ and PR_CAPBSET_DROP.
12924 Document PR_GET_TSC and PR_SET_TSC.
12925 mtk, reviewed by Andrea Arcangeli
12926 Document PR_SET_SECCOMP and PR_GET_SECCOMP.
12928 PR_SET_KEEPCAPS and PR_GET_KEEPCAPS operate on a per-thread
12929 setting, not a per-process setting.
12931 Clarify fork(2) details for PR_SET_PDEATHSIG.
12933 Add description of PR_SET_SECUREBITS and PR_GET_SECUREBITS,
12934 as well as pointer to further info in capabilities(7).
12936 PR_GET_ENDIAN returns endianness info in location pointed to by
12937 arg2 (not as function result, as was implied by previous text).
12939 Expand description of PR_SET_NAME and PR_GET_NAME.
12941 RETURN VALUE: bring up to date for various options.
12943 Various improvements in ERRORS.
12945 Note that PR_SET_TIMING setting of PR_TIMING_TIMESTAMP is not
12946 currently implemented.
12949 * Clarify wording for PR_GET_UNALIGN, PR_GET_FPEMU, and
12951 * Some reformatting of kernel version information.
12952 * Reorder PR_GET_ENDIAN and PR_SET_ENDIAN entries.
12956 Fix and reword erroneous RETURN VALUE text.
12960 Noted which flags appeared in Linux 2.2.
12962 sched_setaffinity.2
12963 mtk, after a Fedora downstream patch
12964 Update type used for cpusetsize argument in SYNOPSIS.
12968 Clarify "zero timeout" case.
12969 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=490868.
12973 Noted which flags appeared in Linux 2.2.
12977 Document si_overrun and si_tid fields of siginfo structure.
12978 Add some text for si_trapno field.
12979 The si_errno field is *generally* unused.
12981 Put descriptions of SA_* constants in alphabetical order.
12985 Rewrote and expanded portability discussion.
12986 NOTES: Show the raw prototype of signal() (without use of
12991 Modify description of ssi_trapno field.
12995 Fix two version number typos for MAX_SWAPFILES discussion:
13000 SEE ALSO: add utimensat(2), futimens(3).
13004 SEE ALSO: Add elf(5).
13007 mtk, after a Fedora downstream patch
13008 Describe additional encryption algorithms.
13009 See also: https://bugzilla.redhat.com/show_bug.cgi?id=428280.
13013 Small rewrites in DESCRIPTION.
13016 mtk, after a note from Alain Portal
13021 SEE ALSO: Add log10(3).
13025 Add C99 to CONFORMING TO.
13029 Add references to group(5).
13032 SEE ALSO: add fopen(3).
13036 Add reference to passwd(5).
13039 SEE ALSO: add fopen(3).
13043 Add C99 to CONFORMING TO.
13047 SEE ALSO: remove futimesat(2); add utimensat(2).
13051 Add details on initial value of optind, and note that it can
13052 be reset (to 1) to restart scanning of an argument vector.
13053 Add a NOTES section describing the glibc-specific behavior
13054 when optind is reset to 0 (rather than 1).
13055 See http://groups.google.com/group/comp.unix.programmer/browse_thread/thread/be0d0b7a07a165fb
13057 Note glibc extensions under CONFORMING TO.
13061 Improve comments on struct spwd.
13065 RETURN VALUE: note that errno is set on error.
13075 Remove unnecessary sentence in ERRORS.
13079 SEE ALSO: Add exp10(3).
13083 Small wording improvement.
13087 Remove unnecessary sentence in ERRORS.
13091 Many small formatting fixes.
13095 Remove redundant summary list of files in description of
13097 Make kernel version for /proc/sys/kernel/panic_on_oops more precise.
13098 Make kernel version for /proc/sys/kernel/pid_max more precise.
13099 Add Documentation/sysctl/vm.txt to SEE ALSO.
13104 Small wording improvement.
13107 mtk, after a note by Alain Portal
13108 Clarify meaning of midnight on 1 Jan 1900/1970.
13110 Remove netdate(1) and rdate(1) from SEE ALSO, since these pages
13111 don't seem to exist on Linux systems.
13114 Vincent Lefevre / mtk
13115 Clarify treatment of initial white space by %% conversion
13117 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435648.
13119 Many small formatting fixes.
13123 Rename CONSIDERATIONS section to NOTES, and relocate
13124 to appropriate place on page.
13127 mtk, after a note by Alain Portal
13128 Prepend "POSIX.1-2001 specifies that: " to the sentence stating
13129 that tmpfile() may write to stdout. (AFAICS, glibc's tmpfile()
13134 Remove unnecessary sentence in ERRORS.
13138 Make wording more precise: the memory allocated by wcsdup(3)
13139 *should* be freed with free(3).
13143 Move example into proper EXAMPLE section.
13147 The features in the "Get and Set Window Size" subsection
13148 require the inclusion of <sys/ioctl.h>.
13151 Serge Hallyn, plus a bit of work by mtk
13152 Document file capabilities, per-process capability bounding set,
13153 changed semantics for CAP_SETPCAP, and other changes in 2.6.2[45].
13154 Add CAP_MAC_ADMIN, CAP_MAC_OVERRIDE, CAP_SETFCAP.
13155 Various smaller fixes.
13156 mtk, plus review by Serge Hallyn and Andrew Morgan
13157 Add text detailing how CAP_SETPCAP (theoretically) permits -- on
13158 pre-2.6.25 kernels, and 2.6.25 and later kernels with file
13159 capabilities disabled -- a thread to change the capability sets
13161 Add section describing rules for programmatically adjusting
13162 thread capability sets.
13163 Add some words describing purpose of inheritable set.
13164 Note existence of CONFIG_SECURITY_CAPABILITIES config option.
13165 Describe rationale for capability bounding set.
13166 Document securebits flags (new in 2.6.26).
13167 Remove obsolete BUGS section.
13168 SEE ALSO: Add getcap(8), setcap(8), and various libcap pages.
13170 Add text noting that if we set the effective flag for one
13171 file capability, then we must also set the effective flag for all
13172 other capabilities where the permitted or inheritable bit is set.
13174 Since Linux 2.6.25, CAP_SYS_ADMIN is no longer required for
13175 ioprio_set() to set IOPRIO_CLASS_IDLE class.
13177 Reword discussion of CAP_LINUX_IMMUTABLE to be file-system neutral.
13181 A list of standards in the CONFORMING TO list should be
13182 terminated by a period.
13183 The list of pages in a SEE ALSO list should not be
13184 terminated by a period.
13188 Correct a detail for sysctl_tcp_adv_win_scale.
13192 ==================== Changes in man-pages-3.05 ====================
13194 Released: 2008-07-23, Konolfingen
13200 The following people contributed notes, ideas, or patches that have
13201 been incorporated in changes in this release:
13203 Alain Portal <aportal@univ-montp2.fr>
13204 Andries Brouwer <Andries.Brouwer@cwi.nl>
13205 Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
13206 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13207 Franck Jousseaume <franck.jousseaume@gmail.com>
13208 Sam Varshavchik <mrsam@courier-mta.com>
13209 Uli Schlacter <psychon@znc.in>
13211 Apologies if I missed anyone!
13214 New and rewritten pages
13215 -----------------------
13218 mtk, with review by Andries Brouwer
13219 A description of the SVID-specified mechanism for reporting
13221 See http://thread.gmane.org/gmane.linux.man/266.
13224 mtk, with review and suggested input from Andries Brouwer
13225 A description of how math functions report errors.
13226 See http://thread.gmane.org/gmane.linux.man/249.
13234 s/floating point/floating-point/ when used attributively.
13238 For consistency with majority usage:
13239 s/plus infinity/positive infinity/
13240 s/minus infinity/negative infinity/
13242 Typographical or grammatical errors have been corrected in several
13246 Changes to individual pages
13247 ---------------------------
13251 SEE ALSO: add end(3).
13254 Brian M. Carlson / mtk
13255 Remove ambiguity in description of support for O_EXCL on NFS.
13256 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=491791.
13260 Place options in some semblance of alphabetical order.
13261 (No content or formatting changes were made.)
13265 Bump version number: these functions are still missing in
13270 SEE ALSO: Add math_error(7).
13274 SEE ALSO: Add math_error(7).
13278 Remove unneeded "Compile with" piece in SYNOPSIS.
13279 SEE ALSO: Add math_error(7).
13282 mtk / Franck Jousseaume
13283 Fix errors introduced into a few prototypes when converting
13284 function declarations to use modern C prototypes in man-pages-2.75.
13287 mtk, after a report from Uli Schlacter
13288 Document the IPV6_V6ONLY flag.
13291 ==================== Changes in man-pages-3.06 ====================
13293 Released: 2008-08-05, Konolfingen
13299 The following people contributed notes, ideas, or patches that have
13300 been incorporated in changes in this release:
13302 Andreas Jaeger <aj@novell.com>
13303 Andries Brouwer <Andries.Brouwer@cwi.nl>
13304 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13305 Gernot Tenchio <g.tenchio@telco-tech.de>
13306 Sam Varshavchik <mrsam@courier-mta.com>
13307 Tolga Dalman <tdalman@project-psi.org>
13309 Apologies if I missed anyone!
13312 New and rewritten pages
13313 -----------------------
13317 Created after removing the erfc() material from erf.3.
13318 Documents the complementary error function.
13322 Created after removing the y*() material from j0.3.
13323 Documents the Bessel functions of the second kind.
13324 Included ERRORS section; noted that an exception is not
13325 raised on underflow, see also
13326 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6806;
13327 and errno is not set on overflow, see also
13328 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808;
13329 Included BUGS section noting that errno is incorrectly
13330 set for pole error; see also
13331 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6807.
13335 Created after removing the scalbln*() and scalbn*() material
13336 from scalb.3. Documents scalbln() and scalbn() functions.
13337 Included ERRORS section; noted that errno is not set; see
13338 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803.
13341 New and changed links
13342 ---------------------
13347 Changed these links to point to new erfc.3 page.
13355 Changed these links to point to new scalbln.3 page.
13366 Changed these links to point to new y0.3 page.
13374 s/floating point/floating-point/ when used attributively.
13376 Typographical or grammatical errors have been corrected in several
13380 Changes to individual pages
13381 ---------------------------
13385 Tweak discuss text describing support for Blowfish.
13388 mtk / Gernot Tenchio
13389 Added some words to make clear that the string returned by
13390 ctime() and asctime() is null-terminated.
13394 Reverse order of SYNOPSIS and NAME sections.
13396 NOTES: Summarize the state of glibc support for exceptions
13397 and errno for error reporting.
13400 Changes to individual pages (math functions)
13401 --------------------------------------------
13403 Almost all of the changes in this release relate to math man pages.
13404 Very many changes were made to the math pages, including:
13406 * Fixed feature test macros (FTMs). Often, the FTM requirements
13407 for the "float" and "long double" versions of a math function are
13408 different from the requirements for the "double" version. Each math
13409 page now shows the correct FTM requirements for all three versions
13410 of the function(s) it describes. This may have required either
13411 a change to the existing FTM text (if the requirements for the
13412 "double" function were already described), or the addition of an FTM
13413 description to a SYNOPSIS where one was not previously present
13414 (typically because the "double" version of the function does not
13415 require any FTMs to be defined).
13416 * CONFORMING TO: in many cases, POSIX.1-2001 was not mentioned.
13417 Where a function is specified in POSIX.1-2001, this is now noted.
13418 Also, statements about what other standards a function conforms to
13419 were generally clarified. (The wording about which functions conformed
13420 to C99 was previously often done as an add on sentence; now it is made
13421 part of the first sentence of the CONFORMING TO section, along with
13423 * RETURN VALUE: in many cases, pages lacked descriptions of the return
13424 value when the function arguments are special values such as +0, -0,
13425 NaN (not-a-number), +infinity, -infinity, etc. This has been fixed.
13426 I carried out tests on glibc 2.8 to ensure that all of these
13427 functions match the RETURN VALUE descriptions (and the POSIX.1-2001
13429 * ERRORS: many pages lacked a clear (or indeed any) description of
13430 how errno is set on error and what exception is raised for each error.
13431 This has been fixed. The ERRORS sections are now generally headed up
13432 as per the POSIX.1 way of doing things, describing Pole / Range /
13433 Domain errors, as applicable.
13434 I carried out tests on glibc 2.8 to ensure that all of these
13435 functions match the ERRORS descriptions. Deviations from POSIX.1-2001
13436 requirements have been filed as glibc bug reports, and noted in the
13437 man pages. (The pages now describe the situation for ERRORS as at glibc
13438 2.8; I may eventually try and extend the text with descriptions of
13439 changes in older versions of glibc.)
13440 NOTE: one point that has not been covered in any page is the
13441 circumstances that generate inexact (FE_INEXACT) exceptions.
13442 (The details for these exceptions are not specified in POSIX.1-2001,
13443 and I haven't gone looking for the standards that describe the details.)
13447 SYNOPSIS: Added feature test macro requirements.
13448 RETURN VALUE: Added details for special argument cases.
13449 Rewrote ERRORS section.
13450 Updated CONFORMING TO.
13454 SYNOPSIS: Fixed feature test macro requirements.
13455 Added RETURN VALUE section.
13456 Rewrote ERRORS section.
13457 Updated CONFORMING TO.
13461 SYNOPSIS: Added feature test macro requirements.
13462 RETURN VALUE: Added details for special argument cases.
13463 Rewrote ERRORS section.
13464 Updated CONFORMING TO.
13468 SYNOPSIS: Added feature test macro requirements.
13469 DESCRIPTION: Some rewording.
13470 RETURN VALUE: Added details for special argument cases.
13471 Added (null) ERRORS section.
13472 Updated CONFORMING TO.
13476 SYNOPSIS: Added feature test macro requirements.
13477 DESCRIPTION: Some rewording.
13478 RETURN VALUE: Added details for special argument cases.
13479 Added (null) ERRORS section.
13480 Updated CONFORMING TO.
13484 SYNOPSIS: Added feature test macro requirements.
13485 DESCRIPTION: Some rewording.
13486 RETURN VALUE: Added details for special argument cases.
13487 Added (null) ERRORS section.
13488 Updated CONFORMING TO.
13492 SYNOPSIS: Fixed feature test macro requirements.
13493 Added RETURN VALUE section.
13494 Rewrote ERRORS section.
13495 Updated CONFORMING TO.
13496 Added BUGS section noting that pole error sets errno to EDOM,
13497 when it should be ERANGE instead; see also
13498 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6759.
13502 SYNOPSIS: Fixed feature test macro requirements.
13503 Added RETURN VALUE section.
13504 Added (null) ERRORS section.
13505 Updated CONFORMING TO.
13509 SYNOPSIS: Added feature test macro requirements.
13510 DESCRIPTION: Enhanced.
13511 RETURN VALUE: Added details for special argument cases.
13512 Rewrote ERRORS section.
13513 Updated CONFORMING TO.
13514 NOTES: Added some details.
13518 Added RETURN VALUE section.
13519 Updated CONFORMING TO.
13523 SYNOPSIS: Added feature test macro requirements.
13524 Rewrote RETURN VALUE section.
13525 Added ERRORS section; noted errno is not set:
13526 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780.
13527 Updated CONFORMING TO.
13531 SYNOPSIS: Added feature test macro requirements.
13532 Added RETURN VALUE section.
13533 Added ERRORS section.
13534 Updated CONFORMING TO.
13538 Removed the erfc() material (there is now a new erfc page).
13539 Reason: the functions are logically separate; also their
13540 return values differ, and it would have been confusing
13541 to document them on the same page.
13542 SYNOPSIS: Fixed feature test macro requirements.
13543 Added RETURN VALUE section.
13544 Added ERRORS section; noted that errno is not set; see
13545 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785.
13546 Updated CONFORMING TO.
13550 SYNOPSIS: Added feature test macro requirements.
13551 Added RETURN VALUE section.
13552 Added ERRORS section; noted that errno is not set; see
13553 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6786.
13554 Updated CONFORMING TO.
13558 SYNOPSIS: Added feature test macro requirements.
13559 Added RETURN VALUE section.
13560 Added ERRORS section; noted that errno is not set for underflow;
13561 see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787.
13565 Added RETURN VALUE and ERRORS sections.
13566 Updated CONFORMING TO.
13570 SYNOPSIS: Fixed feature test macro requirements.
13571 Added RETURN VALUE section.
13572 Added ERRORS section; noted that errno is not set for overflow;
13573 see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788.
13574 Updated CONFORMING TO.
13575 Added BUGS section, describing bogus underflow exception for -large,
13576 see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6778;
13577 and describing bogus invalid exception for certain +large,
13578 see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6814.
13582 SYNOPSIS: Added feature test macro requirements.
13583 Added RETURN VALUE section.
13584 Updated CONFORMING TO.
13588 SYNOPSIS: Added feature test macro requirements.
13589 DESCRIPTION: Some rewording.
13590 Added RETURN VALUE section.
13591 Added ERRORS section; noted that errno is not set; see
13592 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6796.
13593 Updated CONFORMING TO.
13597 Make style of writing exception names consistent with other
13598 pages and POSIX.1-2001.
13599 Updated CONFORMING TO.
13603 SYNOPSIS: Fixed feature test macro requirements.
13607 SYNOPSIS: Added feature test macro requirements.
13608 DESCRIPTION: Enhanced.
13609 RETURN VALUE: Added details for special argument cases.
13610 Rewrote ERRORS section.
13611 Updated CONFORMING TO.
13615 SYNOPSIS: Added feature test macro requirements.
13616 DESCRIPTION: Some rewording.
13617 Added RETURN VALUE section.
13618 Added ERRORS section; noted that errno is not set; see
13619 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801.
13620 Updated CONFORMING TO.
13625 NAME: Make description clearer
13626 SYNOPSIS: Added feature test macro requirements.
13627 SYNOPSIS: Remove unneeded "Compile with" piece.
13628 CONFORMING TO: Added POSIX.1-2001.
13629 Added RETURN VALUE and ERRORS sections.
13633 SYNOPSIS: Added feature test macro requirements.
13634 RETURN VALUE: Added details for special argument cases.
13635 Rewrote ERRORS section; noted that errno is not always set; see
13636 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
13637 Updated CONFORMING TO.
13641 Minor wording changes.
13642 CONFORMING TO: Added POSIX.1-2001.
13643 SEE ALSO: Add signbit(3).
13647 SYNOPSIS: Added feature test macro requirements.
13648 Added details to RETURN VALUE section.
13649 Added (null) ERRORS section.
13650 CONFORMING TO: Added POSIX.1-2001.
13654 SYNOPSIS: Fixed feature test macro requirements.
13655 Added (null) RETURN VALUE section referring to tgamma(3).
13656 Added (null) ERRORS section referring to tgamma(3).
13657 CONFORMING TO: Rewrote.
13661 SYNOPSIS: Fixed feature test macro requirements.
13662 DESCRIPTION: note that calculation is done without causing
13663 undue overflow or underflow.
13664 Added RETURN VALUE section.
13665 Added ERRORS section; noted that errno is not always set; see
13666 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6795.
13667 Updated CONFORMING TO.
13671 SYNOPSIS: Added feature test macro requirements.
13672 Rewrote RETURN VALUE section.
13673 Rewrote ERRORS section; noted that errno is not set, and in some
13674 cases an exception is not raised; see also
13675 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6794.
13676 CONFORMING TO: Added POSIX.1-2001.
13680 NAME: Make description clearer
13681 Improve the description of isunordered().
13682 Added RETURN VALUE and ERRORS sections.
13684 A few wording improvements.
13688 Removed material for the y*() functions to a separate y0.3 page.
13689 Reason: the return values and errors/exceptions differ, and it
13690 would have been confusing to document them on the same page.
13691 Added RETURN VALUE section.
13692 Added ERRORS section; noted that errno is not set; see
13693 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6805.
13697 SYNOPSIS: Added feature test macro requirements.
13698 Added RETURN VALUE and ERRORS sections.
13699 Updated CONFORMING TO.
13703 Note that these functions are deprecated.
13704 SYNOPSIS: Fixed feature test macro requirements.
13705 Added RETURN VALUE and ERRORS sections referring to lgamma(3).
13706 Added BUGS section noting that pole error sets errno to EDOM,
13707 when it should be ERANGE instead; see also
13708 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6777.
13712 SYNOPSIS: Added feature test macro requirements.
13713 Added RETURN VALUE section.
13714 Rewrote ERRORS section.
13715 Updated CONFORMING TO.
13719 SYNOPSIS: Added feature test macro requirements.
13720 Added RETURN VALUE section.
13721 Rewrote ERRORS section.
13722 Updated CONFORMING TO.
13726 SYNOPSIS: Fixed feature test macro requirements.
13727 Added RETURN VALUE section.
13728 Added ERRORS section; noted that errno is not set; see
13729 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6792.
13730 Updated CONFORMING TO.
13734 Added RETURN VALUE section.
13735 Rewrote ERRORS section.
13736 Updated CONFORMING TO.
13740 SYNOPSIS: Fixed feature test macro requirements.
13741 DESCRIPTION: added a little detail; some rewordings.
13742 RETURN VALUE: Added details for special argument cases.
13743 Rewrote ERRORS section; noted that errno is not set; see
13744 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6793.
13745 CONFORMING TO: Added POSIX.1-2001.
13749 DESCRIPTION: some rewording.
13750 RETURN VALUE: Added details for special argument cases.
13751 Added ERRORS section; noted that errno is not set; see
13752 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6798.
13753 CONFORMING TO: Added POSIX.1-2001.
13757 RETURN VALUE: Added details for special argument cases.
13758 Rewrote ERRORS section; noted that errno is not set; see
13759 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6797.
13760 CONFORMING TO: Added POSIX.1-2001.
13764 SYNOPSIS: Added feature test macro requirements.
13765 RETURN VALUE: Added details for special argument cases.
13766 Added (null) ERRORS section.
13767 CONFORMING TO: Added POSIX.1-2001.
13771 Small wording changes.
13772 CONFORMING TO: Added POSIX.1-2001.
13776 SYNOPSIS: Fixed feature test macro requirements.
13777 RETURN VALUE: Added details for special argument cases.
13778 Added ERRORS section; noted that errno is not set; see
13779 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6799.
13780 CONFORMING TO: Added POSIX.1-2001.
13784 SYNOPSIS: Added feature test macro requirements.
13785 Added RETURN VALUE section.
13786 Rewrote ERRORS section.
13787 Updated CONFORMING TO.
13788 Added BUGS section noting that pole error sets errno to EDOM,
13789 when it should be ERANGE instead; see also
13790 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776.
13794 SYNOPSIS: Fixed feature test macro requirements.
13795 DESCRIPTION: added some details.
13796 RETURN VALUE: Added details for special argument cases.
13797 Rewrote ERRORS section; noted that errno is not always set; see
13798 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
13799 Updated CONFORMING TO.
13800 Added BUGS section noting that remainder(nan(""), 0)
13801 wrongly causes a domain error; see
13802 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6779
13806 Added RETURN VALUE section.
13807 Added ERRORS section; noted that errno is not set; see
13808 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801.
13809 Updated CONFORMING TO.
13814 NAME: Make description clearer
13815 SYNOPSIS: Added feature test macro requirements.
13816 SYNOPSIS: Remove unneeded "Compile with" piece.
13817 CONFORMING TO: Added POSIX.1-2001.
13818 Added RETURN VALUE and ERRORS sections.
13822 SYNOPSIS: Added feature test macro requirements.
13823 RETURN VALUE: Added details for special argument cases.
13824 Rewrote ERRORS section; noted that errno is not always set; see
13825 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
13826 Updated CONFORMING TO.
13829 CONFORMING TO: Added POSIX.1-2001.
13833 SYNOPSIS: Fixed feature test macro requirements.
13834 DESCRIPTION: added some details.
13835 RETURN VALUE: Added details for special argument cases.
13836 ERRORS: no errors can occur (previous text was misleading).
13837 CONFORMING TO: Added POSIX.1-2001.
13838 NOTES: point out that lrint() may be preferred in some cases.
13842 DESCRIPTION: added some details.
13843 RETURN VALUE: Added details for special argument cases.
13844 ERRORS: no errors can occur (previous text was misleading).
13845 CONFORMING TO: Added POSIX.1-2001.
13846 NOTES: point out that lround() may be preferred in some cases.
13850 Removed the scalbn() and scalbln() material to a separate
13851 scalbln.3 page. Reason: scalb() is obsolete; also the
13852 exception/error conditions differ somewhat, so that it
13853 would have been confusing to document them on the same page.
13854 SYNOPSIS: Fixed feature test macro requirements.
13855 DESCRIPTION: some rewrites and added details.
13856 Added RETURN VALUE section.
13857 Added ERRORS section; noted that errno is not set; see
13858 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803
13859 and http://sources.redhat.com/bugzilla/show_bug.cgi?id=6804.
13860 CONFORMING TO: Rewrote.
13864 SYNOPSIS: Added feature test macro requirements.
13865 SYNOPSIS: Remove unneeded "Compile with" piece.
13866 Added RETURN VALUE section.
13867 Added (null) ERRORS section.
13868 CONFORMING TO: Added POSIX.1-2001.
13872 SYNOPSIS: Added feature test macro requirements.
13873 Added RETURN VALUE section.
13874 Added ERRORS section; noted errno is not set:
13875 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781.
13876 Updated CONFORMING TO.
13880 DESCRIPTION: Added details for special argument cases.
13881 Added (null) RETURN VALUE section.
13882 Added ERRORS section.
13886 SYNOPSIS: Added feature test macro requirements.
13887 Added RETURN VALUE section.
13888 Added ERRORS section.
13889 Updated CONFORMING TO.
13893 SYNOPSIS: Added feature test macro requirements.
13894 Added RETURN VALUE section.
13895 Rewrote ERRORS section.
13896 Updated CONFORMING TO.
13900 SYNOPSIS: Added feature test macro requirements.
13901 Added RETURN VALUE section.
13902 Added ERRORS section.
13903 Added ERRORS section; noted errno is not set:
13904 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782.
13905 Updated CONFORMING TO.
13909 SYNOPSIS: Added feature test macro requirements.
13910 Added RETURN VALUE section.
13911 Added (null) ERRORS section.
13912 Updated CONFORMING TO.
13916 Added RETURN VALUE section.
13917 Rewrote ERRORS section; noted that errno is not set /
13918 incorrectly set in some cases; see also
13919 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809
13920 and http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810.
13921 CONFORMING TO: Added POSIX.1-2001.
13922 Added NOTES section to hold text explaining origin of tgamma().
13926 RETURN VALUE: small rewording.
13927 CONFORMING TO: Added POSIX.1-2001.
13928 Added NOTES section explaining that result may be too large
13929 to store in an integer type.
13932 ==================== Changes in man-pages-3.07 ====================
13934 Released: 2008-08-12, Konolfingen
13940 The following people contributed notes, ideas, or patches that have
13941 been incorporated in changes in this release:
13943 Alain Portal <aportal@univ-montp2.fr>
13944 Andries Brouwer <Andries.Brouwer@cwi.nl>
13945 Christoph Lameter <cl@linux-foundation.org>
13946 Cliff Wickman <cpw@sgi.com>
13947 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13948 Filippo Santovito <filippo.santovito@email.it>
13949 Gerrit Renker <gerrit@erg.abdn.ac.uk>
13950 Heikki Orsila <shd@modeemi.cs.tut.fi>
13951 Khalil GHORBAL <khalil.ghorbal@cea.fr>
13952 Lee Schermerhorn <lee.schermerhorn@hp.com>
13953 Maxin John <maxin.john@gmail.com>
13954 Reuben Thomas <rrt@sc3d.org>
13955 Samuel Thibault <samuel.thibault@ens-lyon.org>
13956 Sam Varshavchik <mrsam@courier-mta.com>
13957 Soh Kam Yung <sohkamyung@gmail.com>
13958 Stephane Chazelas <stephane_chazelas@yahoo.fr>
13959 Pavel Heimlich <tropikhajma@seznam.cz>
13960 Reuben Thomas <rrt@sc3d.org>
13962 Apologies if I missed anyone!
13965 New and rewritten pages
13966 -----------------------
13969 Christoph Lameter, various edits and improvements by mtk
13970 Documentation of the move_pages() system call.
13971 This page was formerly part of the numactl package, but really
13972 belongs in man-pages (since it describes a kernel interface).
13974 clock_getcpuclockid.3
13976 New page documenting the clock_getcpuclockid() library function,
13977 available since glibc 2.2.
13981 Document the Linux implementation of the UDP-Lite protocol,
13982 new in Linux 2.6.20.
13985 Newly documented interfaces in existing pages
13986 ---------------------------------------------
13989 Christoph Lameter, minor edits and improvements by mtk
13990 Documentation of the /proc/PID/numa_maps file.
13991 This material was formerly the numa_maps.5 page in the numactl
13992 package, but really belongs in man-pages (since it describes
13993 a kernel interface).
14005 Fix mis-ordered (.SH) sections.
14024 s/PF_/AF_/ for socket family constants. Reasons: the AF_ and
14025 PF_ constants have always had the same values; there never has
14026 been a protocol family that had more than one address family,
14027 and POSIX.1-2001 only specifies the AF_* constants.
14029 Typographical or grammatical errors have been corrected in several
14033 Changes to individual pages
14034 ---------------------------
14038 The floating-point environment is reset to the default
14039 during an execve().
14043 Misc cleanup of get_mempolicy(2):
14044 + mention that any mode flags will be saved with mode.
14045 I don't bother to document mode flags here because we
14046 already have a pointer to set_mempolicy(2) for more info
14047 on memory policy. mode flags are discussed there.
14048 + remove some old, obsolete [IMO] NOTES and 'roff comments.
14050 Update the get_mempolicy(2) man page to add in the description of
14051 the MPOL_F_MEMS_ALLOWED flag, added in 2.6.23.
14053 Document additional EINVAL error that occurs is MPOL_F_MEMS_ALLOWED
14054 is specified with either MPOL_F_ADDR or MPOL_F_NODE.
14058 CONFORMING TO: POSIX.1-2008 marks getitimer() and setitimer()
14063 Fix error conditions, now that the kernel silently ignores
14064 nodes outside the task's cpuset, as long as one valid node
14067 Now that cpuset man page exists, we can refer to it. Remove
14068 stale comment regarding lack thereof.
14070 Add brief discussion of mode flags.
14072 Attempt to clarify discussion of MPOL_DEFAULT.
14074 Fix URI reference for libnuma.
14078 Remove EFAULT from errors. Under ENOMEM error, note that
14079 EFAULT was the error produced in some cases for kernels before
14083 mtk, after a note from Filippo Santovito
14084 In the ipc_perm structure definition, some fields were
14085 incorrectly named: s/key/__key/ and s/seq/__seq/.
14089 Fix up the error return for nodemask containing nodes disallowed by
14090 the process' current cpuset. Disallowed nodes are now silently ignored,
14091 as long as the nodemask contains at least one node that is on-line,
14092 allowed by the process' cpuset and has memory.
14094 Now that we have a cpuset man page, we can refer to cpusets directly
14095 in the man page text.
14098 Another attempt to rationalize description of MPOL_DEFAULT.
14100 Since ~2.6.25, the system default memory policy is "local allocation".
14101 MPOL_DEFAULT itself is a request to remove any non-default policy and
14102 "fall back" to the surrounding context. Try to say that without delving
14103 into implementation details.
14106 Add discussion of mempolicy mode flags to set_mempolicy(2).
14107 This adds another reason for EINVAL.
14111 CONFORMING TO: POSIX.1-2008 marks setpgrp() obsolete.
14114 mtk, after a note from Filippo Santovito
14115 In the ipc_perm structure definition, some fields were
14116 incorrectly named: s/key/__key/ and s/seq/__seq/.
14119 Filippo Santovito / mtk
14120 In the ipc_perm structure definition, some fields were
14121 incorrectly named: s/key/__key/ and s/seq/__seq/.
14125 CONFORMING TO: POSIX.1-2008 marks utime() obsolete.
14126 CONFORMING TO: POSIX.1-2008 removes the POSIX.1-2001 LEGACY
14127 marking of utimes(), so mention of this point has been
14128 removed from the page.
14132 CONFORMING TO: POSIX.1-2008 removes the specification of vfork().
14136 SEE ALSO Add carg(3).
14140 CONFORMING TO: POSIX.1-2008 removes the specification of bcmp().
14144 CONFORMING TO: POSIX.1-2008 removes the specification ofcw
14149 CONFORMING TO: POSIX.1-2008 removes the specification of bzero().
14153 AVAILABILITY: These functions are still not in glibc
14158 SEE ALSO: Add clock_getcpuclockid(3).
14162 AVAILABILITY: These functions are still not in glibc
14167 POSIX.1-2008 marks asctime(), asctime_r(), ctime(), and ctime_r()
14172 CONFORMING TO: These functions are nowadays in POSIX.1-2008.
14176 CONFORMING TO: POSIX.1-2008 removes the specifications of
14181 CONFORMING TO: POSIX.1-2008 removes the specification of ftime().
14185 CONFORMING TO: POSIX.1-2008 marks ftw() as obsolete.
14189 CONFORMING TO: POSIX.1-2008 removes the specification of gcvt().
14192 Reuben Thomas / mtk
14193 Clarify description of getcwd() for buf==NULL case;
14194 CONFORMING TO: According to POSIX.1, the behavior of getcwd()
14195 is unspecified for the buf==NULL case.
14197 Add an introductory paragraph giving an overview of what these
14199 Fix error in description of getwd(): it does not truncate the
14200 pathname; rather, it gives an error if the pathname exceeds
14202 Rewrote RETURN VALUE section.
14203 Add EINVAL ENAMETOOLONG errors for getwd().
14204 Various other clarifications and wording fixes.
14205 CONFORMING TO: POSIX.1-2001 does not define any errors for
14207 CONFORMING TO: POSIX.1-2008 removes the specification of getwd().
14211 CONFORMING TO: POSIX.1-2008 removes the specifications of
14212 gethostbyname(), gethostbyaddr(), and h_errno.
14216 CONFORMING TO: POSIX.1-2008 removes the specification of gets().
14222 VERSIONS: These functions are available in glibc since version 2.1.
14226 CONFORMING TO: POSIX.1-2008 removes the specifications of
14227 index() and rindex().
14231 CONFORMING TO: POSIX.1-2008 marks isalpha() as obsolete.
14235 CONFORMING TO: POSIX.1-2008 removes the specifications of
14236 makecontext() and swapcontext().
14240 VERSIONS: memrchr() since glibc 2.2; rawmemchr() since glibc 2.1.
14244 VERSIONS: mempcpy() since glibc 2.1.
14248 CONFORMING TO: POSIX.1-2008 removes the specification of mktemp().
14252 CONFORMING TO: POSIX.1-2008 specifies fdopendir().
14256 CONFORMING TO: POSIX.1-2008 marks rand_r() as obsolete.
14260 CONFORMING TO: POSIX.1-2008 marks siginterrupt() as obsolete.
14264 CONFORMING TO: POSIX.1-2008 marks sighold(), sigignore(),
14265 sigpause(), sigrelse(), and sigset() as obsolete.
14269 VERSIONS: strchrnul() since glibc 2.1.1.
14273 CONFORMING TO: POSIX.1-2008 marks tempnam() as obsolete.
14277 CONFORMING TO: POSIX.1-2008 marks tmpnam() as obsolete.
14281 CONFORMING TO: POSIX.1-2008 marks toascii() as obsolete.
14285 CONFORMING TO: POSIX.1-2008 removes the specification of ualarm().
14289 CONFORMING TO: POSIX.1-2008 marks ulimit() as obsolete.
14293 CONFORMING TO: POSIX.1-2008 removes the specification of usleep().
14297 Updated details for POSIX.1-2008, and noted that if
14298 POSIX.1-2001 is listed in the CONFORMING TO section of a man
14299 page, then the reader can assume that the interface is also
14300 specified in POSIX.1-2008, unless otherwise noted.
14304 SEE ALSO: Add clock_getcpuclockid(3).
14308 SEE ALSO: add udplite(7).
14311 Changes to individual pages (math functions)
14312 --------------------------------------------
14314 Various changes here following on from the big update to the
14315 math pages in the previous release. Test results going back
14316 glibc 2.3.2 (so far) allowed updates to various pages to note
14317 changes in historical behavior for error reporting by math
14318 functions. Thanks to the following people for providing me
14319 with test results on various distributions and glibc versions:
14320 Alain Portal, Andries Brouwer, Fabian Kreutz, Heikki Orsila,
14321 Khalil GHORBAL, Pavel Heimlich, Reuben Thomas, Samuel Thibault,
14322 Soh Kam Yung, and Stephane Chazelas
14366 Added VERSIONS section noting that these functions first
14367 appeared in glibc in version 2.1.
14371 BUGS: In glibc 2.3.4 and earlier, an FE_OVERFLOW exception is not
14372 raised when an overflow occurs.
14376 Provide more detail in the description of rounding modes.
14377 Add text describing FLT_ROUNDS (formerly in fma.3).
14378 Add BUGS section pointing out the FLT_ROUNDS does not reflect
14379 changes by fesetround().
14383 Remove text about FLT_ROUNDS, replacing with a cross-reference
14388 CONFORMING TO: Note that the standards provide a weaker guarantee
14389 for the return value of isinf().
14393 BUGS: In glibc 2.5 and earlier, log(nan("")) produces a bogus
14394 FE_INVALID exception.
14398 Add reference to fenv(3) for discussion of current rounding mode.
14402 BUGS: In glibc 2.5 and earlier these functions do not raise an
14403 FE_UNDERFLOW exception on underflow.
14407 BUGS: described buggy NaN return when x is negative and y is large.
14408 See also: http://sources.redhat.com/bugzilla/show_bug.cgi?id=3866.
14409 BUGS: Note the bogus FE_INVALID exception that occurred in glibc
14410 2.3.2 and earlier on overflow and underflow.
14414 Add reference to fenv(3) for discussion of current rounding mode.
14418 Add reference to fenv(3) for discussion of current rounding mode.
14422 CONFORMING TO: POSIX.1-2008 removes the specification of scalb().
14426 BUGS: In glibc 2.3.3, tgamma(+-0) produced a domain error
14427 instead of a pole error.
14431 In glibc 2.3.2 and earlier, these functions do not raise an
14432 FE_INVALID exception for a domain error.
14436 Rewrite introductory paragraph.
14437 Point out that a NaN is commonly returned by functions that report
14441 ==================== Changes in man-pages-3.08 ====================
14443 Released: 2008-08-27, Zurich
14449 The following people contributed notes, ideas, or patches that have
14450 been incorporated in changes in this release:
14452 Gerrit Renker <gerrit@erg.abdn.ac.uk>
14453 Li Zefan <lizf@cn.fujitsu.com>
14454 Mike Bianchi <MBianchi@foveal.com>
14455 Sam Varshavchik <mrsam@courier-mta.com>
14456 Venkatesh Srinivas <me@acm.jhu.edu>
14457 Vijay Kumar <vijaykumar@bravegnu.org>
14459 Apologies if I missed anyone!
14462 New and rewritten pages
14463 -----------------------
14467 Documents getnetent_r(), getnetbyname_r(),
14468 and getnetbyaddr_r(), the reentrant equivalents of
14469 getnetent(), getnetbyname(), and getnetbyaddr().
14473 Documents getprotoent_r(), getprotobyname_r(), and
14474 getprotobynumber_r(), the reentrant equivalents of
14475 getprotoent(), getprotobyname(), and getprotobynumber().
14479 Documents getrpcent_r(), getrpcbyname_r(), and
14480 getrpcbynumber_r(), the reentrant equivalents of
14481 getrpcent(), getrpcbyname(), and getrpcbynumber().
14485 Documents getservent_r(), getservbyname_r(), and
14486 getservbyport_r(), the reentrant equivalents of
14487 getservent(), getservbyname(), and getservbyport().
14491 A new page giving overview details for the Linux NUMA interfaces.
14492 Incorporates some material from mbind.2, and the description
14493 of /proc/PID/numa_maps from proc.5.
14496 Newly documented interfaces in existing pages
14497 ---------------------------------------------
14501 Add description of crypt_r().
14504 New and changed links
14505 ---------------------
14509 New link to crypt.3.
14514 New links to new getnetent_r.3.
14517 getprotobynumber_r.3
14519 New links to new getprotoent_r.3.
14524 New links to new getrpcent_r.3.
14529 New links to new getservent_r.3.
14533 Link to new numa(7) page, which incorporates the
14534 /proc/PID/numa_maps description.
14535 As part of the numactl() package, the /proc/PID/numa_maps
14536 documentation was in a numa_maps.5 page; this link
14537 ensures that "man 5 numa_maps" still works.
14538 (Eventually, we may want to remove this link.)
14549 Add reference to numa(7) for information on library support.
14550 Added a VERSIONS section.
14551 SEE ALSO: Add numa(7).
14569 These interfaces are specified in POSIX.1-2008.
14572 Changes to individual pages
14573 ---------------------------
14577 When an eventfd overflows, select() indicates the file as both
14578 readable and writable (not as having an exceptional condition).
14582 F_DUPFD_CLOEXEC is specified in POSIX.1-2008.
14586 NOTES: Add text mentioning the shell 'ulimit' (or 'limit')
14587 built-in command for setting resource limits.
14591 CONFORMING TO: POSIX.1-2008 marks gettimeofday() as obsolete.
14595 Note kernel version where Linux stopped following symbolic
14596 links in 'oldpath'; see also http://lwn.net/Articles/294667.
14597 POSIX.1-2008 makes it implementation-dependent whether or not
14598 'oldpath' is dereferenced if it is a symbolic link.
14599 Add a reference to linkat(2) for an interface that allows
14600 precise control of the treatment of symbolic links.
14604 Remove material on library support and numactl; that material
14605 is now in numactl.7.
14609 Add kernel version numbers for MAP_32BIT.
14610 Add some details on MAP_32BIT (see http://lwn.net/Articles/294642).
14614 Added VERSIONS (from kernel 2.6.18) and CONFORMING TO sections.
14618 O_CLOEXEC is specified in POSIX.1-2008.
14622 s/d/domain/ for name of argument.
14623 Add reference to socket(2) for further information on
14624 domain, type, and protocol arguments.
14628 CONFORMING TO: POSIX.1-2008 specifies utimensat() and futimens().
14632 CONFORMING TO: Add POSIX.1-2008; other minor changes.
14636 Small rewording: "s/returned/failed with/ [an error]".
14640 Since glibc 2.7, it is possible to seek past the end of
14641 a stream created by open_memstream(). Add a BUGS section
14642 describing the bug in earlier glibc versions.
14646 Clarify exactly which functions are obsoleted by getnameinfo()
14651 Rephrase description in terms of a database, rather than a file.
14652 Note that each of the get*() functions opens a connection to
14653 the database if necessary.
14654 The database connection is held open between get*() calls if
14655 'stayopen' is non-zero (not necessarily 1).
14656 s/zero terminated list/NULL-terminated list/
14658 In glibc 2.2, the type of the 'net' argument for getnetbyaddr()
14659 changed from 'long' to 'uint32_t'.
14661 Note that the gethostbyaddr() 'net' argument is in host byte order.
14663 RETURN VALUE: emphasize that returned pointer points to a
14664 statically allocated structure.
14665 SEE ALSO: add getnetent_r.3.
14669 Rephrase description in terms of a database, rather than a file.
14670 Note that each of the get*() functions opens a connection to
14671 the database if necessary.
14672 The database connection is held open between get*() calls if
14673 'stayopen' is non-zero (not necessarily 1).
14674 s/zero terminated list/NULL-terminated list/
14676 RETURN VALUE: emphasize that returned pointer points to a
14677 statically allocated structure.
14678 SEE ALSO: add getprotoent_r.3.
14683 Rephrase description in terms of a database, rather than a file.
14684 Note that each of the get*() functions opens a connection to
14685 the database if necessary.
14686 s/zero terminated list/NULL-terminated list/
14688 RETURN VALUE: emphasize that returned pointer points to a
14689 statically allocated structure.
14690 SEE ALSO: add getrpcent_r.3.
14694 Rephrase description in terms of a database, rather than a file.
14695 Note that each of the get*() functions opens a connection to
14696 the database if necessary.
14697 The database connection is held open between get*() calls if
14698 'stayopen' is non-zero (not necessarily 1).
14699 s/zero terminated list/NULL-terminated list/
14701 RETURN VALUE: emphasize that returned pointer points to a
14702 statically allocated structure.
14703 SEE ALSO: add getservent_r.3.
14707 CONFORMING TO: this function is specified in POSIX.1-2008.
14711 s/sigev_notify_function/sigev_thread_function/
14712 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=494956.
14716 Relocate text for resolved_path==NULL case to DESCRIPTION.
14717 POSIX.1-2001 leaves the resolved_path==NULL case as
14718 implementation-defined; POSIX.1-2008 specifies the behavior
14719 described in this man page.
14723 POSIX.1-2008 rectifies the POSIX.1-2001 omission, specifying
14724 that zero is returned by a successful sem_init() call.
14728 Make the page more helpful to non-programmers by referencing
14729 the documentation of the shell's 'ulimit' command in the
14730 discussion of RLIMIT_CORE and RLIMIT_FSIZE.
14731 SEE ALSO: Add bash(1).
14733 Note that a core dump file can be used in a debugger.
14737 Remove /proc/PID/numa_maps material (it is now in numa(7)).
14741 SEE ALSO: Add numa(7).
14745 Explain bug that occurred in coalescing identical events in
14746 kernels before 2.6.25.
14747 (See commit 1c17d18e3775485bf1e0ce79575eb637a94494a2
14748 "A potential bug in inotify_user.c" in the 2.6.25 Changelog.)
14752 Update thread-safe functions list with changes in POSIX.1-2008.
14753 SEE ALSO: add proc(5).
14757 Update list of async-sygnal-safe functions for POSIX.1-2008.