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 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 realpath.3 mtk Added discussion of resolved_path == NULL. 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.