The following are changes in previous 2.xx man page releases. ==================== Changes in man-pages-2.00 ==================== Released: 2004-12-16 (why wait for the kernel?) Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Alberto Bertogli Anand Kumria Andrey Kiselev Andries Brouwer Chris Green Branden Robinson Emmanuel Colbus Enrico Zini Eric Estievenart Fabian Kreutz Florian Weimer Jan Kuznik Joey (Martin) Schulze Johannes Berg John V. Belmonte Karel Kulhavy Luis Javier Merino Morán Martin Pool Richard Kreckel Vasya Pupkin Apologies if I missed anyone! Global changes -------------- Many math pages had their synopses compressed, as per suggestion from Fabian Kreutz. Many minor content and formatting bug fixes were made to the math pages, following suggestions from Fabian Kreutz (who recently translated many of the 1.70 math pages into German) and Andries Brouwer. For consistency, all instances "super-user" were changed to the more common "superuser". After a note from Vasya Pupkin, I added to the SYNOPSIS of several Section 2 pages using the _syscallN() macros. In addition: -- erroneous semicolons at the end of _syscallN() were removed on various pages. -- types such as "uint" in syscalN() declarations were changed to "unsigned int", etc. -- various other minor breakages in the synopses were fixed. The affected pages are: getdents.2 gettid.2 llseek.2 mmap2.2 modify_ldt.2 pivot_root.2 quotactl.2 readdir.2 sysctl.2 syslog.2 tkill.2 Typographical or grammatical errors have been corrected in several other places. Individual pages ---------------- bind.2 Florian Weimer Added 'const' to declaration of 'my_addr' in prototype. as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239762 fcntl.2 Martin Pool Added O_NOATIME to list of flags that can be changed via F_SETFL. mtk/aeb Noted F_GETOWN bug after suggestion from aeb. See also: http://marc.theaimsgroup.com/?l=linux-kernel&m=108380640603164&w=2 getrlimit.2 mtk Material on getrusage.2 has been separated out into its own page. Rewrote discussion on RLIMIT_MEMLOCK to incorporate kernel 2.6.9 changes. Added note on RLIMIT_CPU error in older kernels. Added RLIMIT_SIGPENDING Also made a few other minor changes. getrusage.2 mtk This page is new(ish) -- it was created by splitting getrlimit.2. Repaired note on SIGCHLD behaviour to note that the POSIX non-conformance has been fixed in 2.6.9. kill.2 Modified after suggestion from Emmanuel Colbus Changed wording of sentence under NOTES describing when signals can be sent to init. mlock.2, munlock.2, mlockall.2, munlockall.2 These have been consolidated into a single mlock.2 page. In the process, much duplication was eliminated and new information was added about RLIMIT_MEMLOCK and the changes in memory locking in kernel 2.6.9, mmap.2 mtk Added cross-ref to setrlimit(2) concerning memory locking limits. Eric Estievenart Note that MAP_FIXED replaces existing mappings msgctl.2 mtk Substantial language and formatting clean-ups. Added msqid_ds and ipc_perm structure definitions. msgget.2 mtk Substantial language and formatting clean-ups. Added notes on /proc files. msgop.2 mtk Substantial language and formatting clean-ups. Added notes on /proc files. open.2 Martin Pool Added O_NOATIME (new in Linux 2.6.8) mtk Reordered list of 'flags' description alphabetically personality.2 2004-11-03 applied patch from Martin Schulze semctl.2 mtk Substantial language and formatting clean-ups. Rewrote semun text. Added semid_ds and ipc_perm structure definitions. semget.2 mtk Substantial language and formatting clean-ups. Added notes on /proc files. Rewrote BUGS note about semget()'s failure to initialise semaphore values. semop.2 mtk Substantial language and formatting clean-ups. Added notes on /proc files. shmctl.2 mtk Substantial language and formatting clean-ups. Updated shmid_ds structure definitions. Added information on SHM_DEST and SHM_LOCKED flags. Noted that CAP_IPC_LOCK is not required for SHM_UNLOCK since kernel 2.6.9. Added notes on 2.6.9 RLIMIT_MEMLOCK changes. Added RLIMIT_SIGPENDING (new in Linux 2.6.8) shmget.2 mtk Substantial language and formatting clean-ups. Added notes on /proc files. shmop.2 mtk Substantial language and formatting clean-ups. Changed wording and placement of sentence regarding attachment of segments marked for destruction. sigaction.2 mtk Added mention of SIGCONT under SA_NOCLDSTOP. Added SA_NOCLDWAIT. Updated discussion for POSIX.1-2001 and SIGCHLD and sa_flags. Noted that CLD_CONTINUED is supported since Linux 2.6.9. Added SI_TKILL (new in Linux 2.4.19). Other minor changes. signal.2 mtk Removed text on ignoring SIGCHLD; replaced with pointer to sigaction.2. sigwaitinfo.2 After bug report from Andrey Kiselev Fixed prototype: "timeout" --> "*timeout" as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=222145 stat.2 Enrico Zini Added text to clarify that S_IS*() macros should be applied to st_mode field. as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=249698 swapon.2 After bug report from Anand Kumria Added "no swap space signature" to EINVAL error as per http://bugs.debian.org/cgi-bin/bugreport.cgi mtk Added EINVAL error for swapoff() ("not currently a swap area"). Added EBUSY error for swapon(). A few formatting fixes. times.2 mtk In Linux 2.6, the return value of times changed; it is no longer time since boot, but rather: boot_time + 2^32 / HZ - 300 Repaired note on SIGCHLD behaviour to note that the POSIX non-conformance has been fixed in 2.6.9. Some formatting fixes. undocumented.2 After bug report from Johannes Berg Changed .TH UNIMPLEMENTED to: .TH UNDOCUMENTED as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=220741 wait.2 mtk Added waitid(2). Added WCONTINUED and WIFCONTINUED (new in 2.6.10). Added text on SA_NOCLDSTOP. Updated discussion of SA_NOCLDWAIT to reflect 2.6 behaviour. Much other text rewritten. wait4.2 mtk Rewrote this page, removing much duplicated information, and replacing with pointers to wait.2. Luis Javier Merino Morán / mtk CONFORMING TO said "SVr4, POSIX". Changed to "4.3BSD" waitid.2 mtk New link to wait.2 assert.3 After bug report from Branden Robinson The assert() failure message goes to stderr not stdout. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=284814 ctime.3 mtk Noted that 0 in tm_mday is interpreted to mean the last day of the preceding month. getnameinfo.3 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=229618 getnameinfo() does not set errno, it returns a non-zero value indicating the error. mtk added EAI_OVERFLOW error killpg.3 mtk Minor changes to SEE ALSO and CONFORMING TO. lseek64.3 aeb New page by Andries Brouwer tzset.3 Richard Kreckel Change "NULL" to "empty" when talking about the value of TZ. http://sources.redhat.com/bugzilla/show_bug.cgi?id=601 printf.3 After bug report from Jan Kuznik http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=205736 Fixed bad realloc() use in snprintf() example realpath.3 mtk Added discussion of resolved_path == NULL. random.4 After bug report from John V. Belmonte Updated init and quit scripts to reflect kernel 2.4/2.6 reality (Scripts taken from drivers/char/random.c) as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=247779 proc.5 mtk Updated description of /proc/loadavg to include nr_running(), nr_threads, last_pid. rtsig-max and rtsig-nr went away in 2.6.8 updated statm, and fixed error in order of list boot.7 applied patch from Martin Schulze capabilities.7 mtk Added O_NOATIME for CAP_FOWNER netdevice.7 Karel Kulhavy and AEB formatting fix after note from Karel Kulhavy and AEB, plus a few wording fixes. signal.7 mtk /proc/sys/kernel/rtsig-* were superceded by RLIMIT_SIGPENDING in kernel 2.6.8. tcp.7 mtk/aeb Updated details of interaction of TCP_CORK and TCP_NODELAY. ==================== Changes in man-pages-2.01 ==================== Released: 2004-12-20 (a quick one before Christmas) Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Carsten Hey Johannes Berg Joshua Kwan Marek Habersack Martin Schulze Matthew Dempsky Matthew Gregan Pedro Zorzenon Neto Tony Crawford Apologies if I missed anyone! Global changes -------------- Matthew Dempsky, mtk triggered by http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=283179 The wording describing how errno is set was fixed up in the following pages: accept.2 close.2 send.2 setsid.2 socket.2 closedir.3 initgroups.3 mkstemp.3 opendir.3 readdir.3 telldir.3 Typographical or grammatical errors have been corrected in several other places. Individual pages ---------------- sendfile.2 mtk Adjusted descriptions of argument file types to be closer to 2.6 reality. Wording and formatting changes ctan.3 ctanh.3 Tony Crawford As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=270817 Formulae on the pages should be T = S / C not T = C / S. errno.3 Martin Schulze, mtk Removed errno declaration from prototype, added notes on historical need for this declaration. http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=174175 aio_return.3 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=224953 Changed erroneous "aio_return(2)" to "aio_return(3)" posix_openpt.3 mtk New by mtk ptsname.3 mtk Added description of ptsname_r(). Added ERRORS. ptsname_r.3 mtk New link to ptsname.3. shm_open.3 Matthew Gregan add to synopsis as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=271243 strcasecmp.3 Marek Habersack .SH "CONFORMING TO" -BSD 4.4 +BSD 4.4, SUSv3 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=234443 strfry.3 Joshua Kwan Added _GNU_SOURCE to prototype as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=213538 strftime.3 Cartsen Hey as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248 Changed range for "%S" from 0..61 to 0..0. SUSv3 says 0..60. I think the manual page probably says 0..61, because that's what SUSv2 said. (Some other implementations' man pages also say 0..61 -- e.g., Solaris 8 & 9, Tru64 5.1B; FreeBSD 5.1 says 0..60.) The glibc manual currently says 0..60. Given that SUSv3 says 0..60, I've changed the manual page to also say this: -The second as a decimal number (range 00 to 61). +The second as a decimal number (range 00 to 60). +(The range is up to 60 to allow for occasional leap seconds.) sysconf.3 Johannes Berg / http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=226974 -.BR POSIX2_FORT_RUN " - " _SC_2_FORT_DEV +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV system.3 Pedro Zorzenon as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638 Noted use of _XOPEN_SOURCE to get macros as for wait(2). mtk Changed name of argument from 'string' to 'command' (like POSIX). Noted that glibc does nowadays explicitly check for the existence of the shell if 'command' is NULL, rather than the older behaviour of assuming the shell exists and always returning 1 if 'command' is NULL. Other wording and formatting clean-ups. undocumented.3 Remove some functions names that *are* documented. ==================== Changes in man-pages-2.02 ==================== Released: 2005-04-14 Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Andries Brouwer Branden Robinson Colin Watson David Lloyd Gordon Jin Heikki Orsila Jamie Lokier Johan Walles Kai Makisara Marko Kohtala Martin Pool Martin (Joey) Schulze Matthias Lang Michael Haardt Michael Mühlebach Mike Frysinger Sasa Stevanovic Serguei Leontiev Apologies if I missed anyone! Global changes -------------- Martin (Joey) Schulze Removed SEE ALSO reference to non-existent newctime(3) from: ctime.3 tzselect.8 zdump.8 zic.8 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=236884 Typographical or grammatical errors have been corrected in several other places. Individual pages ---------------- clone.2 mtk Noted the PID caching behaviour of NPTL's getpid() wrapper under BUGS. Added futex(2), set_thread_area(2), set_tid_address(2), tkill(2) under SEE ALSO. epoll_ctl.2 epoll_create.2 Marko Kohtala / mtk Improved various error descriptions. epoll_wait.2 David Lloyd / Mike Frysinger, Marko Kohtala Added EINTR to errors. fcntl.2 Jamie Lokier / mtk Improved discussion of F_SETOWN and F_SETSIG with respect to multi-threaded programs. Generally cleaned up the discussion of F_SETOWN. Updated CONFORMING TO to note that F_GETOWN and F_SETOWN are now in POSIX. link.2 mtk Noted discrepancy between Linux and POSIX.1 when oldpath is a symbolic link. See: http://bugs.linuxbase.org/show_bug.cgi?id=367 and: http://www.opengroup.org/austin/mailarchives/ag/msg08152.html Michael Haardt / mtk Clarified EXDEV error description: it isn't possible to link across mount points, even if the mount points refer to the same file system. mincore.2 mtk, after note from Gordon Jin Updated ERRORS pipe.2 As per message from Serguei Leontiev Removed SVr2, AT&T, and BSD from CONFORMING TO, since a pipe on those systems is actually bidirectional. (Pipes are implemented as STREAMS on the former, and sockets on the latter.) posix_fadvise.2 mtk Noted kernel version where posix_fadvise() appeared and noted bug in handling of 'len' in kernels < 2.6.6. rename.2 Michael Haardt Clarified EXDEV error description: it isn't possible to rename a file across mount points, even if the mount points refer to the same file system. semop.2 mtk Noted kernel version numbers for semtimedop(). setitimer.2 Matthias Lang, mtk Noted MAX_SEC_IN_JIFFIES ceiling. Added note about treatment of out-of-range tv_usec values. sigqueue.2 Johan Walles, Martin (Joey) Schulze Added sigqueue.2 to SEE ALSO times.2 mtk Added notes on non-standard behaviour: Linux allows 'buf' to be NULL, but POSIX.1 doesn't specify this and it's non-portable. uselib.2 Andries Brouwer Improved DESCRIPTION; clarified distinction between EACCES and ENOEXEC. bcopy.3 Heikki Orsila bcopy() handles overlapping case, but memcpy() does not, so for consistency memmove() should be also mentioned. getmntent_r.3 Martin (Joey) Schulze New link to man3/getmntent.3. memcpy.3 Small wording change after suggestion from Sasa Stevanovic. strcasestr.3 mtk Created as link to strstr.3. strftime.3 mtk Noted that SUSv2 allowed a range of 00 to 61 for %S specifier. strstr.3 mtk Added description of strcasestr(). random.4 aeb Improved description of read from /dev/urandom. st.4 Kai Makisara Substantial updates. man.7 Martin Schulze Branden Robinson Colin Watson Mention the .URL macro more verbosely. ==================== Changes in man-pages-2.03 ==================== Released: 2005-06-02 Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Andries Brouwer Joey (Martin) Schulze Johannes Nicolai Justin Pryzby Klaus Ethgen Pavel Heimlich Ross Boylan Vincent Fourmond Apologies if I missed anyone! Global changes -------------- Pavel Heimlich Change `ttys(4)' to `ttyS(4)' in: tty.4 mouse.4 vcs.4 console_ioctl.4 console.4 Typographical or grammatical errors have been corrected in several places. Individual pages ---------------- clone.2 mtk Substantially enhanced discussion of CLONE_THREAD. Added CLONE_SYSVSEM, CLONE_UNTRACED, CLONE_STOPPED. Other minor fixes. execve.2 aeb Noted effect of ptracing when execing a set-UID program. fcntl.2 Johannes Nicolai / mtk Noted F_SETOWN bug for socket file descriptor in Linux 2.4 and earlier. Added text on permissions required to send signal to owner. flock.2 mtk Noted that lock conversions are not atomic. getrusage.2 mtk ru_nswap has never contained useful information. Kernel 2.6.6 clarified that with a patch ("[PATCH] eliminate nswap and cnswap"). See also: http://www.ussg.iu.edu/hypermail/linux/kernel/0404.1/0720.html kill.2 mtk Clarified wording of the 'pid == -1' case. mount.2 mtk Added MNT_EXPIRE, plus a few other tidy-ups. sched_setaffinity.2 mtk Added text to note that sched_setaffinity() will migrate the affected process to one of the specified CPUs if necessary. Added a NOTE to point out that the affinity mask is actually a per-thread attribute that can be adjusted independently for each thread in a thread group. shmctl.2 mtk Noted aberrant Linux behaviour with respect to new attaches to a segment that has already been marked for deletion. Noted changes in permissions required for SHM_LOCK/SHM_UNLOCK. wait.2 mtk Noted that the __W* flags can't be used with waitid(). getconf.3 mtk Added_CS_GNU_LIBC_VERSION and_CS_GNU_LIBPTHREAD_VERSION. hosts.5 Ross Boylan / Martin Schulze various changes as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=304242 proc.5 mtk Minor changes to discussion of /proc/PID/stat signal fields. Added 'rt_priority' and 'policy' to /proc/PID/stat. capabilities.7 mtk 1,$s/inherited/inheritable/g regex.7 Vincent Fourmond / Joey (Martin) Schulze Removed discussion of `[[:<:]]' and `[[:>:]]' since they do not seem to be in the glibc implementation. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295666 tzselect.8 Joey (Martin) Schulze / Klaus Ethgen The default zoneinfo directory is now /usr/share/zoneinfo. (was: /usr/local/etc/zoneinfo) As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=267471 ==================== Changes in man-pages-2.04 ==================== Released: 2005-06-21 Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Andries Brouwer Baurjan Ismagulov Dave Love Dieter Brueggemann Geoff Clare Guido Trotter kabloom Kevin Ryde Justin Pryzby Mike Furr Olivier Croquette Olivier Guilyardi Peter Cordes Philipp Spitzer Tanaka Akira Thierry Excoffier Thomas Hood Vincent Lefevre Walter Harms Apologies if I missed anyone! Global changes -------------- For consistency across pages: 1,$s/nonzero/non-zero/g Typographical or grammatical errors have been corrected in several places. New pages --------- pthreads.7 mtk An overview of the Linux implementations of POSIX threads. Changes to individual pages --------------------------- _exit.2 mtk Various minor changes epoll_ctl.2 Mike Furr BUGS: In kernels < 2.6.9, EPOLL_CTL_DEL required a non-NULL 'event', even though this argument is ignored. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306517. flock.2 mtk / Kevin Ryde Clarified semantics of relationship between flock() locks and open file entries and file descriptors. See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=291121 getitimer.2 Olivier Croquette, Thierry Excoffier Noted the existence of the short sleep bug (up to 1 jiffy). getrlimit.2 mtk RLIMIT_RSS only has affect "in 2.4.x", not "in 2.4 and later". getrusage.2 Geoff Clare Since Linux 2.6, the ru_nvcsw and ru_nivcsw fields are used. nice.2 mtk / Guido Trotter Rewrote description of return value. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=296183 open.2 Walter Harms O_DIRECT needs _GNU_SOURCE. mtk O_ASYNC works for pipes and FIFOs in Linux 2.6 Various minor fixes atexit.3 mtk Various minor changes exit.3 mtk Various minor changes getopt.3 mtk / Philipp Spitzer Fix description of return value. See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308359 hsearch.3 mtk Changed (char *) to (void *) in example. See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313607 log1p.3 Justin Pryzby make log(3) SEE ALSO log1p(3) As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=309578 makecontext.3 Tanaka Akira Fix description of RETURN VAUE for makecontext() As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311800 on_exit.3 mtk Various minor changes rand.3 kabloom@ucdavis.edu Small fix to a code example As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=194842. realpath.3 mtk / Thomas Hood When specifying resolved_path as NULL, realpath() will (still) only allocate up to PATH_MAX bytes. Plus other minor changes. See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239424 rcmd.3 Dave Love The required header file for these funtions on Linux is As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311680 scanf.3 Olivier Guilyardi Arg for %p is a pointer to _a pointer to_ void. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263109 stdin.3 Vincent Lefevre freopen() can change the descriptors associated with stdin/stdout/stderr. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295859. strerror.3 Baurjan Ismagulov strerror_r(3) requires #define _XOPEN_SOURCE 600 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=290880 sysconf.3 Peter Cordes / mtk Fix typo: "_SC_2_DEV" should be "_SC_2_C_DEV" proc.5 mtk Added pointers under /proc/sys/net to tcp.7 and ip.7 ip.7 mtk Various wording and formatting fixes. Reordered /proc/sys/net/ipv4/ip_* file descriptions alphabetically. tcp.7 Dieter Brueggemann / mtk Fixes to the discussion of SIOCATMARK and tcp_stdurg mtk Various wording and formatting fixes. Incorporated some new /proc/sys/net/ipv4/tcp_* file descriptions from the 2.6.12 source file Documentation/networking/ip-sysctl.txt. ==================== Changes in man-pages-2.05 ==================== Released: 2005-06-27 Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: A Costa Andries Brouwer Bas Zoetekouw Dan Jacobson Delian Krustev Dora Anna Volgyesi Martin (Joey) Schulze Ove Kaaven Apologies if I missed anyone! Global changes -------------- Typographical or grammatical errors have been corrected in several places. (Special thanks to A Costa.) New pages --------- Changes to individual pages --------------------------- _exit.2 mtk / aeb Reversed 2.04 introduction of the term "process termination function". close.2 mtk Clarified what type of lock close() affects. Minor formatting changes. dup.2 mtk Consistent use of terms "open file description", "file status flags", and "file decriptor flags" Removed mention of lock sharing -- it was not accurate. Minor formatting fixes fcntl.2 mtk Consistent use of terms "open file description", "file status flags", and "file decriptor flags" Some rewriting of discussion of file descriptor flags Under F_DUPFD, replaced some text duplicated in dup.2 with a cross ref to dup.2 Minor wording and formatting fixes fpclassify.3 mtk / Martin (Joey) Schulze / Bas Zoetekouw The return value of isinf() changed in glibc 2.02 to differentiate positive and neagtive infinity. See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765 getgid.2 getuid.2 Delian Krustev Remove confusing text describing real and effective IDs. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285852 getitimer.2 mtk The short sleep bug (up to 1 jiffy) that was newly noted in man-pages-2.04 has just been fixed in 2.6.12. getpriority.2 mtk Changed range documented in main text from -20..20 to -20..19. Noted that the range is -20..20 on some systems. open.2 mtk / aeb Clarification of term "open file description" along with explanation of what information it maintains. Other wording improvements Various minor wording changes atexit.3 mtk / aeb Reversed 2.04 introduction of the term "process termination function". mtk Noted use of atexit() for establishing function to be invoked on shared library unload. Noted that atexit()-registered functions are not invoked on abnormal termination. Formatting fixes. exit.3 mtk / aeb Reversed 2.04 introduction of the term "process termination function". mtk Minor rewording and formatting changes. getloadavg.3 mtk Added #define _BSD_SOURCE to prototype log2.3 Martin (Joey) Schulze Add ERANGE error. readdir.3 mtk Added definition of Linux dirent structure. Some formatting cleanups. strtod.3 Dora Anna Volgyesi/ mtk strtold() and strtof() need _ISOC99_SOURCE or _XOPEN_SOURCE=600 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=246668 tdestroy.3 mtk New link to tsearch.3 tsearch.3 mtk Added tdestroy to .TH line mem.4 mtk Change "chown root:mem /dev/mem" to "chown root:kmem /dev/mem" null.4 mtk Change "chown root:mem /dev/null /dev/zero" to "chown root:root /dev/null /dev/zero" vcs.4 Dan Jacobson / Martin (Joey) Schulze Replaced "selection(1)" by "gpm(8)" under SEE ALSO See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=253515 signal.7 Ove Kaaven SA_SIGACTION should be SA_SIGINFO As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=305369 urn.7 mtk New link to uri.7 ==================== Changes in man-pages-2.06 ==================== Released: 2005-07-15 Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Alain Portal Andries Brouwer Bhavesh P Davda Clau Weber Dov Murik David Lloyd Frederik Deweerdt Justin Pryzby Lars Wirzenius Martin Pool Mike Frysinger Petter Reinholdtsen Steven Murdoch Walter Harms Apologies if I missed anyone! Global changes -------------- Typographical or grammatical errors have been corrected in several places. Many uses of hyphens and dashes were corrected. New pages --------- canonicalize_file_name.3 Walter Harms / mtk Removed Pages ------------- sstk.2 mtk AFAIK, this sytem call has never actually done anything (other than be a stub) on any Unix. Changes to individual pages --------------------------- accept.2 mtk Various wording and formatting fixes. bind.2 mtk Minor formatting changes clone.2 mtk Various minor wording improvements; some formatting fixes connect.2 mtk Various wording and formatting fixes. epoll_create.2 Bhavesh P Davda s/positive/non-negative/ [for file descriptor] getrlimit.2 mtk Documented RLIMIT_MSGQUEUE limit. RLIMIT_RSS ceased to have any effect in 2.4 in kernel 2.4.30. (It already didn't have any effect in 2.2.x and 2.6.x.) s/MADVISE_WILLNEED/MADV_WILLNEED/ listen.2 mtk Removed historic comment on BSD backlog ceiling. Minor wording and formatting changes. semop.2 mtk Added BUG: in some circumstances, a process that is waiting for a semaphore to become zero is not not woken up when the value does actually reach zero. http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2 http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2 socket.2 mtk Various minor wording improvements umask.2 mtk Added mkdir(2) to discussion, made term "file mode creation mask" clearer. Various, mostly small, wording changes errno.3 Martin Pool Change description for ESTALE As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=237344 fgetgrent.3 getgrent.3 getgrent_r.3 David Lloyd Added SEE ALSO putgrent(3) See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=211336 getgrent.3 getgrnam.3 getpwent.3 getpwnam.3 Lars Wirzenius / mtk Replace mention of /etc/{passwd,group} by refernces to "passwd/group database", and LDAP and NIS. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117 mtk Miscellaneous wording improvements Consistent DESCRIPTION and ERRORS wording across these pages. getnameinfo.3 mtk Relocate misplaced text describing gai_strerror(). getnetent.3 Petter Reinholdtsen s/endservent/endnetent/ As per Debian Bug#316517 getspnam.3 Lars Wirzenius / mtk Replace mention of /etc/shadow by refernces to "shadow password database", and LDAP and NIS. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117 mtk, Claus Weber Miscellaneous wording improvements Consistent DESCRIPTION wording vis-a-vis getpwnam.3 etc. hsearch.3 Frederik Deweerdt Fix hsearch_r() prototype scanf.3 Justin Pryzby / mtk Fix description of RETURN VALUE As per Debian Bug#317037 mtk various parts substantially rewritten; added description of %n$ form; various text incorporated from the GNU C library documentation ((C) The Free Software Foundation). shm_open.3 mtk Modified details of how user and group ownership of a new object are set. Various minor wording and formatting cleanups. elf.5 Mike Frysinger tweaked the short description to include definition of 'ELF' add ELFOSABI_NONE to the ELFOSABI_ list tweak/add more machines to EM_ list for ehdr->e_machine fix indenting to be consistent tweak the display of the ELF_ST_* macros document the Elf_Dyn structure proc.5 mtk Updated discussion of /proc/stat. Added text on the /proc/sys/fs/mqueue/* files. ip.7 Steven Murdoch Change protocol in UDP prototype. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182635 tcp.7 Dov Murik The first sentence under NOTES about SO_KEEPALIVE and SIGPIPE makes no grammatical sense (and possibly also no technical sense). It has been removed. ==================== Changes in man-pages-2.07 ==================== Released: 2005-07-19 Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Andries Brouwer Mike Frysinger Apologies if I missed anyone! Global changes -------------- The terms "set-user-ID" and "set-group-ID" are now used consistently (no abbreviations) across all manual pages. Consistent use of "saved set-user-ID" and "saved set-group-ID" (no more "saved user ID", "saved effective UID", saved group ID", etc.) Global fixes in textual descriptions: uid --> UID gid --> GID pid --> PID id --> ID Consistent use of st_atime, st_ctime, st_mtime, with explanatory text, instead of atime/ctime/mtime. Classical BSD versions are now always named x.yBSD (formerly there was a mix of x.yBSD and BSD x.y). Typographical or grammatical errors have been corrected in several places. Changes to individual pages --------------------------- setresuid.2 mtk Some rewording. stat.2 Mike Frysinger Improve description of st_dev and st_rdev. mtk Various wording and formatting improvements. truncate.2 mtk Some formatting fixes ==================== Changes in man-pages-2.08 ==================== Released: 2005-09-21 Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Adrian Bunk Alain PORTAL Andrew Pimlott Andries Brouwer Baurzhan Ismagulov Bernhard R. Link Bodo Stroesser David N. Welton Dov Murik Heikki Orsila Hasso Tepper Hrvoje Niksic Justin Pryzby Ludovic Courtes Mike Frysinger Nicolas Francois Norbert Buchmuller Paul Brook Ramiro Aceves Tommy Pettersson Walter Harms Apologies if I missed anyone! Global changes -------------- RFC references are now always written as "RFC\ nnn" (not "RFC nnn" or "RFCnnn"). Typographical or grammatical errors have been corrected in several places. Changes to individual pages --------------------------- du.1 Mike Frysinger To get an effect like "-h", BLOCKSIZE must start with "human", not "HUMAN". time.1 Mike Frysinger s/standard output/standard error/ clone.2 Paul Brook / mtk Fix small error in description of CLONE_PARENT_SETTID connect.2 Heikki Orsila Add EINTR error See http://lkml.org/lkml/2005/7/12/254 getpriority.2 mtk Expanded discussion of relationship between user and kernel representations of the nice value. Added discussion of RLIMIT_NICE and a cross reference to getrlimit.2 under the description of the EACCES error. Noted 2.6.12 change in credentials checking for setpriority(). getrlimit.2 mtk Added description of RLIMIT_RTPRIO Added description of RLIMIT_NICE mmap.2 mtk Noted bug in MAP_POPULATE for kernels before 2.6.7. mremap.2 mtk Added _GNU_SOURCE to prototype. Rewrote description of MREMAP_MAYMOVE. Rewrote description of EAGAIN error. Added discussion of resizing of memory locks. Added entries to SEE ALSO. Some formatting fixes. msgctl.2 mtk Added IPC_INFO, MSG_INFO, MSG_STAT descriptions. nanosleep.2 Baurzhan Ismagulov Add to prototype: define _POSIX_C_SOURCE 199309 As per Debian bug 314435 nice.2 mtk Added sentence noting that range of the nice value is described in getpriority.2. Added cross-reference to setrlimit(2) for discussion on RLIMIT_NICE. outb.2 David N. Welton / Justin Pryzby / mtk Clarified the order of value and port arguments; As per Debian bug 263756 pause.2 mtk Added SEE ALSO for sigsuspend.2 Some formatting fixes. poll.2 Tommy Pettersson nfds should be prototyped as nfds_t As per Debian bug 322934 mtk Some wording and formatting improvements. prctl.2 mtk Since kernel 2.6.13 PR_SET_DUMPABLE can also have the value 2. rand.3 Hrvoje Niksic / mtk Remove misleading text describing FreeBSD's sranddev() function. As per debian bug 328629 readv.2 mtk / Walter harms Added LINUX NOTES on trickery performed by glibc when vector size exceeds IOV_MAX. Formatting clean-ups. remap_file_pages.2 mtk Added text to note that start and size are both rounded downwards. sched_setparam.2 mtk Modified discussion of privileges; added pointer to sched_setscheduler.2 for a discussion of privileges and resource limits. sched_setscheduler.2 mtk Modified discussion of privileges; added discussion of RLIMIT_RTPRIO. semctl.2 mtk Added IPC_INFO, SEM_INFO, SEM_STAT descriptions. shmctl.2 mtk Added IPC_INFO, SHM_INFO, SHM_STAT descriptions. sigaction.2 mtk Split sigpending(), sigprocmask(), and sigsuspend() out into separate new pages. Other minor changes mtk NOTES: described SA_NODEFER / sa_mask bug which was present in all kernels up to and including 2.6.13. See http://marc.theaimsgroup.com/?l=linux-kernel&m=112360948603171&w=2 and http://marc.theaimsgroup.com/?l=linux-kernel&m=112362164911432&w=2 List: linux-kernel Subject: Signal handling possibly wrong From: Bodo Stroesser Date: 2005-08-09 17:44:06 signal.2 mtk Updated SEE ALSO to reflect splitting of sigaction.2 into sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2 sigpending.2 mtk New page created by splitting out from sigaction.2 Changed CONFORMING TO. sigprocmask.2 mtk New page created by splitting out from sigaction.2 Added text on effect of NULL for 'set' argument. Added text noting effect of ignoring SIGBUS, SIGFPE, SIGILL, and SIGSEGV. Noted that sigprocmask() can't be used in multithreaded process. Fixed EINVAL error diagnostic. Changed CONFORMING TO. sigsuspend.2 mtk New page created by splitting out from sigaction.2 Added NOTES on usage. Added new text to DESCRIPTION. Changed CONFORMING TO. stat.2 Mike Frysinger Improve st_blocks description. carg.3 Ramiro Aceves / aeb Change: One has carg(z) = atan(creal(z) / cimag(z)) to: One has tan(carg(z)) = cimag(z) / creal(z) As per Debian bug 326720 cmsg.3 mtk s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name) dlopen.3 Alain Portal s/-nostartupfiles/-nostartfiles/ getaddrinfo.3 mtk Nowadays (since 2.3.4) glibc only sets the first ai_canonname field if AI_CANONNAME was specified (the current behavior is all that SUSv3 requires). 1,$s/PF_/AF_/g Added descriptions of AI_ALL, AI_ADDRCONFIG, AI_V4MAPPED, and AI_NUMERICSERV. Some wording and formatting fixes. getpwnam.3 Bernhard R. Link / mtk Add NOTES text describing relationship of pw_dir and HOME and pointing out that applications should preferentially inspect HOME inet.3 Mike Frysinger Mention "little endian" and "big endian". Added note about octal and hex interpretation of numbers-and-dots notation. rpc.3 mtk / Ludovic Courtes Commented out references to rpc_secure(3) -- we don't currently have such a page in the man-pages set. In response to Debian bug report 325115 setenv.3 mtk glibc 2.3.4 fixed the "name contains '='" bug strnlen.3 Mike Frysinger Added "#define _GNU_SOURCE" to prototype. initrd.4 Norbert Buchmuller / mtk Added text noting that the use or real-root-dev for changing the root device is obsolete, in favour of pivot root. (However, the page still needs to be rewritten to actually describe the pivot_root method...) As per Debian bug 323621. proc.5 mtk Improve text describing /proc/sys/fs/mqueue/* files Describe /proc/sys/fs/suid_dumpable (new in 2.6.13) Added placeholder mention of /proc/zoneinfo (new in 2.6.13) More needs to be said about this file Repaired earlier cut and paste mistake which resulted in part of the text of this page being duplicated. utmp.5 Mike Frysinger Added text on biarch details for ut_session and ut_tv. capabilities.7 mtk Added CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE. ip.7 mtk / Andrew Pimlott Add a couple of words to make it clear that port is a 16-bit number. Reformat long source lines (no text changed). s/SOL_IP/IPPROTO_IP/ (POSIX standard name) Hasso Tepper Fix discussion of IPC_RECVTTL / IP_TTL signal.7 mtk Updated SEE ALSO to reflect splitting of sigaction.2 into sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2 socket.7 mtk Clarified details of use of SO_PEERCRED. tcp.7 mtk s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name) s/SOL_IP/IPPROTO_IP/ (POSIX standard name) udp.7 mtk Added description of UDP_CORK socket option s/SOL_UDP/IPPROTO_UDP/ (POSIX standard name) s/SOL_IP/IPPROTO_IP/ (POSIX standard name) ==================== Changes in man-pages-2.09 ==================== Released: 2005-10-13 Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Justin Pryzby Peter Chubb Samuel Thibault Tomas Pospisek Trond Myklebust Apologies if I missed anyone! Global changes -------------- ptsname.3 getpt.3 unlockpt.3 openpty.3 posix_openpt.3 grantpt.3 pts.4 tty_ioctl.4 mtk Added SEE ALSO for new pty.7 page Typographical or grammatical errors have been corrected in several places. New pages --------- pty.7 mtk Overview of Unix 98 and BSD pseudo-terminals. Changes to individual pages --------------------------- ldd.1 mtk Remove "-V" option (fix from Fedora man-pages-2.07-7). fcntl.2 Peter Chubb / Trond Myklebust / mtk Since kernel 2.6.10, a read lease can only be placed on a file descriptor that is opened read-only. See the following LKML thread of Aug 2005 ("fcntl(F GETLEASE) semantics??"): http://marc.theaimsgroup.com/?l=linux-kernel&m=112371777712197&w=2 http://marc.theaimsgroup.com/?l=linux-kernel&m=112374818213000&w=2 http://marc.theaimsgroup.com/?l=linux-kernel&m=112376335305284&w=2 http://marc.theaimsgroup.com/?l=linux-kernel&m=112377294030092&w=2 mprotect.2 mtk Add new text to ENOMEM error mremap.2 mtk Added description of MREMAP_FIXED and 'new_address' argument under NOTES. Revised text of EINVAL error. read.2 Samuel Thibault / mtk read() can fail with EINVAL when using O_DIRECT mtk Added open(2) to SEE ALSO shmget.2 mtk s/int/size_t/ for type of 'size' argument (fix from Fedora man-pages-2.07-7). write.2 Samuel Thibault / mtk write() can fail with EINVAL when using O_DIRECT atanh.3 mtk Fix: s/acosh/atanh/ (fix from Fedora man-pages-2.07-7) fopen.3 mtk Improved "a+" description (fix from Fedora man-pages-2.07-7). getrpcent.3 mtk s/getrpcent/setrpcent/ (fix from Fedora man-pages-2.07-7). stdio.3 mtk / Justin Pryzby Removed references to fropen() and fwopen(), which are BSDisms that don't appear in glibc. As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=331174 strftime.3 mtk Typo fix: %Ry ==> %Ey [SUSv3 mentions...] (fix from Fedora man-pages-2.07-7). nsswitch.conf.5 mtk s/network/networks/ (fix from Fedora man-pages-2.07-7). proc.5 mtk Added description of /proc/sys/vm/legacy_va_layout. socket.7 mtk Update description of SO_RCVLOWAT and SO_SNDLOWAT. (fix derived from Fedora man-pages-2.07-7).