diff options
author | Michael Kerrisk <mtk.manpages@gmail.com> | 2006-08-02 11:01:14 +0000 |
---|---|---|
committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2006-08-02 11:01:14 +0000 |
commit | 258755b25e8567e47e7c17c1bdaf62c7e3d25de1 (patch) | |
tree | ee9093e099250189d707bebb9a5ebce7fb67e9fd /Changes.old | |
parent | 2b5cefe85218b04a590c7cec08c85b61b44df8dc (diff) |
Ready to release 2.37
Diffstat (limited to 'Changes.old')
-rw-r--r-- | Changes.old | 697 |
1 files changed, 344 insertions, 353 deletions
diff --git a/Changes.old b/Changes.old index 71f152f35..4bcf589a1 100644 --- a/Changes.old +++ b/Changes.old @@ -40,15 +40,15 @@ 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 +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 +For consistency, all instances "super-user" were changed to the more common "superuser". After a note from Vasya Pupkin, I added <errno.h> to the SYNOPSIS -of several Section 2 pages using the _syscallN() macros. +of several Section 2 pages using the _syscallN() macros. In addition: -- erroneous semicolons at the end of _syscallN() were removed @@ -76,8 +76,8 @@ of several Section 2 pages using the _syscallN() macros. Typographical or grammatical errors have been corrected in several other places. -Individual pages ----------------- +Changes to individual pages +--------------------------- bind.2 Florian Weimer @@ -200,7 +200,7 @@ sigaction.2 signal.2 mtk - Removed text on ignoring SIGCHLD; replaced with pointer + Removed text on ignoring SIGCHLD; replaced with pointer to sigaction.2. sigwaitinfo.2 @@ -210,7 +210,7 @@ sigwaitinfo.2 stat.2 Enrico Zini - Added text to clarify that S_IS*() macros should be applied to + 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 @@ -225,7 +225,7 @@ swapon.2 times.2 mtk - In Linux 2.6, the return value of times changed; it is no + 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 @@ -265,10 +265,10 @@ 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 + Noted that 0 in tm_mday is interpreted to mean the last day of the preceding month. getnameinfo.3 @@ -292,7 +292,7 @@ tzset.3 http://sources.redhat.com/bugzilla/show_bug.cgi?id=601 printf.3 - After bug report from Jan Kuznik + After bug report from Jan Kuznik http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=205736 Fixed bad realloc() use in snprintf() example @@ -322,16 +322,16 @@ capabilities.7 mtk Added O_NOATIME for CAP_FOWNER -netdevice.7 +netdevice.7 Karel Kulhavy and AEB - formatting fix after note from Karel Kulhavy and AEB, plus a + formatting fix after note from Karel Kulhavy and AEB, plus a few wording fixes. - + signal.7 mtk /proc/sys/kernel/rtsig-* were superseded by RLIMIT_SIGPENDING in kernel 2.6.8. - + tcp.7 mtk/aeb Updated details of interaction of TCP_CORK and TCP_NODELAY. @@ -381,12 +381,12 @@ Matthew Dempsky, mtk Typographical or grammatical errors have been corrected in several other places. -Individual pages ----------------- +Changes to individual pages +--------------------------- sendfile.2 mtk - Adjusted descriptions of argument file types to be closer to + Adjusted descriptions of argument file types to be closer to 2.6 reality. Wording and formatting changes @@ -430,26 +430,26 @@ strcasecmp.3 -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..60. - SUSv3 says 0..60. I think the manual page probably says + 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 -- + (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 + 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). @@ -462,9 +462,9 @@ sysconf.3 +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV system.3 - Pedro Zorzenon + Pedro Zorzenon as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638 - Noted use of _XOPEN_SOURCE to get macros <sytdlib.h> + Noted use of _XOPEN_SOURCE to get macros <sytdlib.h> as for wait(2). mtk @@ -495,7 +495,7 @@ Andries Brouwer <Andries.Brouwer@cwi.nl> Branden Robinson <branden@debian.org> Colin Watson <cjwatson@debian.org> David Lloyd <dmlloyd@tds.net> -Gordon Jin <gordon.jin@intel.com> +Gordon Jin <gordon.jin@intel.com> Heikki Orsila <shd@modeemi.cs.tut.fi> Jamie Lokier <jamie@shareable.org> Johan Walles @@ -528,15 +528,15 @@ Martin (Joey) Schulze Typographical or grammatical errors have been corrected in several other places. -Individual pages ----------------- +Changes to 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), + Added futex(2), set_thread_area(2), set_tid_address(2), tkill(2) under SEE ALSO. epoll_ctl.2 @@ -577,7 +577,7 @@ 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 + (Pipes are implemented as STREAMS on the former, and sockets on the latter.) posix_fadvise.2 @@ -588,7 +588,7 @@ posix_fadvise.2 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 + a file across mount points, even if the mount points refer to the same file system. semop.2 @@ -684,8 +684,8 @@ Pavel Heimlich Typographical or grammatical errors have been corrected in several places. -Individual pages ----------------- +Changes to individual pages +--------------------------- clone.2 mtk @@ -698,7 +698,7 @@ clone.2 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 @@ -713,7 +713,7 @@ flock.2 getrusage.2 mtk ru_nswap has never contained useful information. - Kernel 2.6.6 clarified that with a patch + 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 @@ -727,16 +727,16 @@ mount.2 sched_setaffinity.2 mtk - Added text to note that sched_setaffinity() will migrate the + 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 + 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 + 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. @@ -749,9 +749,9 @@ getconf.3 mtk Added _CS_GNU_LIBC_VERSION and _CS_GNU_LIBPTHREAD_VERSION. -hosts.5 +hosts.5 Ross Boylan / Martin Schulze - various changes as per + various changes as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=304242 proc.5 @@ -845,7 +845,7 @@ flock.2 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). @@ -882,7 +882,7 @@ 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. @@ -1287,7 +1287,7 @@ elf.5 proc.5 mtk - Updated discussion of /proc/stat. + Updated discussion of /proc/stat. Added text on the /proc/sys/fs/mqueue/* files. ip.7 @@ -1333,7 +1333,7 @@ Global fixes in textual descriptions: pid --> PID id --> ID -Consistent use of st_atime, st_ctime, st_mtime, with explanatory text, +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 @@ -1398,7 +1398,7 @@ Apologies if I missed anyone! Global changes -------------- -RFC references are now always written as "RFC\ nnn" (not "RFC nnn" or +RFC references are now always written as "RFC\ nnn" (not "RFC nnn" or "RFCnnn"). Typographical or grammatical errors have been corrected in several @@ -1410,13 +1410,13 @@ Changes to individual pages du.1 Mike Frysinger - To get an effect like "-h", BLOCKSIZE must start with "human", + 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 @@ -1428,10 +1428,10 @@ connect.2 getpriority.2 mtk - Expanded discussion of relationship between user and kernel + Expanded discussion of relationship between user and kernel representations of the nice value. - Added discussion of RLIMIT_NICE and a cross reference to + 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(). @@ -1445,7 +1445,7 @@ getrlimit.2 mmap.2 mtk Noted bug in MAP_POPULATE for kernels before 2.6.7. - + mremap.2 mtk Added _GNU_SOURCE to prototype. @@ -1466,11 +1466,11 @@ nanosleep.2 nice.2 mtk - Added sentence noting that range of the nice value is described + Added sentence noting that range of the nice value is described in getpriority.2. - Added cross-reference to setrlimit(2) for discussion on + 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; @@ -1497,22 +1497,22 @@ 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 + Modified discussion of privileges; added pointer to + sched_setscheduler.2 for a discussion of privileges and resource limits. sched_setscheduler.2 @@ -1535,7 +1535,7 @@ sigaction.2 Other minor changes mtk - NOTES: described SA_NODEFER / sa_mask bug which was present in + 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 @@ -1558,7 +1558,7 @@ 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, + 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. @@ -1575,7 +1575,7 @@ stat.2 Mike Frysinger Improve st_blocks description. -carg.3 +carg.3 Ramiro Aceves / aeb Change: One has carg(z) = atan(creal(z) / cimag(z)) @@ -1583,7 +1583,7 @@ carg.3 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) @@ -1594,32 +1594,32 @@ dlopen.3 getaddrinfo.3 mtk - Nowadays (since 2.3.4) glibc only sets the first ai_canonname + 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, + 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 + 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 + 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 + 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 @@ -1630,25 +1630,25 @@ setenv.3 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 + 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 - + 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 + Repaired earlier cut and paste mistake which resulted in part of the text of this page being duplicated. utmp.5 @@ -1663,7 +1663,7 @@ 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 @@ -1744,9 +1744,9 @@ ldd.1 fcntl.2 Peter Chubb / Trond Myklebust / mtk - Since kernel 2.6.10, a read lease can only be placed on a + 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 + 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 @@ -1768,16 +1768,16 @@ read.2 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 + 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) @@ -1789,16 +1789,16 @@ fopen.3 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 + 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 + Typo fix: %Ry ==> %Ey [SUSv3 mentions...] (fix from Fedora man-pages-2.07-7). nsswitch.conf.5 @@ -1810,7 +1810,7 @@ proc.5 Added description of /proc/sys/vm/legacy_va_layout. socket.7 - mtk + mtk Update description of SO_RCVLOWAT and SO_SNDLOWAT. (fix derived from Fedora man-pages-2.07-7). @@ -1822,15 +1822,15 @@ Released: 2005-10-19 Global changes -------------- -The changes in this release consist *solely* of formatting fixes, with -the aim bringing greater consistency to the manual pages according to +The changes in this release consist *solely* of formatting fixes, with +the aim bringing greater consistency to the manual pages according to the following rules: --- Function name references should *always* be followed by +-- Function name references should *always* be followed by parentheses, "()" (possibly containing a manual page section number). --- The parentheses following a function name should *not* be +-- The parentheses following a function name should *not* be formatted. Thus, for example, instead of: .B name() @@ -1839,33 +1839,33 @@ the following rules: .BR name () -Much of the change was automated using two scripts: +Much of the change was automated using two scripts: add_parens_for_own_funcs.sh and unformat_parens.sh. -For the (possible) benefit of downstream manual page maintainers and +For the (possible) benefit of downstream manual page maintainers and translators, I have placed these scripts in a new subdirectory 'scripts'. NOTE THE FOLLOWING POINTS WELL: -- These scripts provide a computer-assisted solution to the above two goals. However, they are not perfect, and their output should - be scanned by a human. (To see what changes the two scripts + be scanned by a human. (To see what changes the two scripts *would* make, without making them, use the "-n" command line option.) -- The scripts do not fix all instances that violate the above rules: some manual fixes are required. Two further scripts are provided - to help find remaining instances of function names without + to help find remaining instances of function names without following "()": find_dots_no_parens.sh and find_slashes_no_parens.sh. The following changes were made: --- add_parens_for_own_funcs.sh was applied to the pages in Sections +-- add_parens_for_own_funcs.sh was applied to the pages in Sections 2 and 3. --- unformat_parens.sh was applied to pages in Sections 2, 3, 4, and 7 +-- unformat_parens.sh was applied to pages in Sections 2, 3, 4, and 7 (the only sections where such changes were required). -- further changes (not so very many) were performed by hand. - (found places to fix with the assistance of find_dots_no_parens.sh + (found places to fix with the assistance of find_dots_no_parens.sh and find_slashes_no_parens.sh). @@ -1886,8 +1886,8 @@ Apologies if I missed anyone! Global changes -------------- -Most instances of the constant "NULL" are not formatted (bolded) in -man pages, but a few are. For consistency, formatting on "NULL" has +Most instances of the constant "NULL" are not formatted (bolded) in +man pages, but a few are. For consistency, formatting on "NULL" has been removed where it occurred. Many minor formatting fixes were made. @@ -1907,10 +1907,10 @@ path_resolution.2 mtk Repaired discussion of capabilities and file system UID, which mistakenly had involved exec() in the discussion. - + prctl.2 mtk - Removed text saying there is no library interface. There + Removed text saying there is no library interface. There is nowadays. mkfifo.3 @@ -1957,7 +1957,7 @@ Changes to individual pages mlock.2 mtk - Reworded text around PAGESIZE, noting also that + Reworded text around PAGESIZE, noting also that sysconf(_SC_PAGESIZE) can be used. path_resolution.2 @@ -1967,13 +1967,13 @@ path_resolution.2 since there are (unusual) situations in which fsuid can be 0 while the effective UID is not. - Reworked (cut down) discussion of capabilities, moving part of + Reworked (cut down) discussion of capabilities, moving part of it into capabilities.7 setresuid.2 mtk - Add text to note that setresuid() always modifies the file - system UID, and setresgid() likewise always modifies the file + Add text to note that setresuid() always modifies the file + system UID, and setresgid() likewise always modifies the file system GID. shmget.2 @@ -1986,7 +1986,7 @@ sigaltstack.2 byteorder.3 Brian M. Carlson / herbert@gondor.apana.org.au - Change <netinet/in.h> to <arpa/inet.h> in prototype; add text + Change <netinet/in.h> to <arpa/inet.h> in prototype; add text explaining that some systems need the former header. As per Debian bug 265244 @@ -2010,16 +2010,16 @@ Typographical or grammatical errors have been corrected in several places. Function and page cross references that were italicised were made bold -(which is how the majority of function and page cross references +(which is how the majority of function and page cross references were already done). Instances of things like "NULL-terminated string" were changed to "null-terminated string". -Pathnames, structures, arguments, and <header-files> that were bold +Pathnames, structures, arguments, and <header-files> that were bold were changed to italics. -Instances of the constant "NULL" that were bold-faced were made +Instances of the constant "NULL" that were bold-faced were made unformatted (which is how most instances of "NULL" were already formatted.) @@ -2055,10 +2055,10 @@ New pages rexec.3 mtk / Justin Pryzby This page is taken as is from the FreeBSD 5.4 distribution. - (Not checked against Linux reality, but likely things are + (Not checked against Linux reality, but likely things are the same.) See also Debian bug 336875. - + Changes to individual pages --------------------------- @@ -2085,34 +2085,34 @@ stat.2 frexp.3 Volker Reichelt / mtk - Fixed to point out that that frexp() returns a number whose - *absolute* value is >= 0.5 and < 1. Amended the example + Fixed to point out that that frexp() returns a number whose + *absolute* value is >= 0.5 and < 1. Amended the example program to demonstrate this. -open.2 +open.2 mtk / Avery Pennarun Add EWOULDBLOCK error for file leases. In response to Debian bug 339037. putenv.3 mtk - Although the glibc implementation returns -1 on error (and some - other man pages (e.g., the BSDs) also document that value for + Although the glibc implementation returns -1 on error (and some + other man pages (e.g., the BSDs) also document that value for error returns), SUSv3 merely says "non-zero" (and this is what manual pages on many implementations also say). posix_memalign.3 mtk - Formerly, the page said that all systems declare memalign() in + Formerly, the page said that all systems declare memalign() in <malloc.h>. In fact, many declare it in <stdlib.h>. strtok.3 mtk - Almost a complete rewrite after Angelo pointed out + Almost a complete rewrite after Angelo pointed out that the existing page was deficient. sd.4 - Martin Schulze + Martin Schulze Remove SEE ALSO for non-existent scsi.4. proc.5 @@ -2122,7 +2122,7 @@ proc.5 signal.7 mtk Added pthreads.7 to SEE ALSO. - + ld.so.8 mtk Fix typo: s/LD_DEBUG_OUTPUT/LD_PROFILE_OUTPUT/ @@ -2163,7 +2163,7 @@ Changes to individual pages kill.2 mtk - Added text describing the 2.6.[0-7] EPERM bug that occurred + Added text describing the 2.6.[0-7] EPERM bug that occurred when sending signals to a process group. sigaction.2 @@ -2181,20 +2181,20 @@ sigpause.2 sigsetops.3 mtk - Added a GLIBC NOTES section describing sigisemptyset(), + Added a GLIBC NOTES section describing sigisemptyset(), sigandset(), and sigorset(). sigvec.2 sigblock.2 mtk - These pages have been deleted, and replaced by a new sigvec.3 + These pages have been deleted, and replaced by a new sigvec.3 man page that more fully describes the BSD signal API. siggetmask.2 sigmask.2 sigsetmask.2 mtk - These links to the now-deleted sigblock.2 have been also been + These links to the now-deleted sigblock.2 have been also been deleted. They are replaced by corresponding links in Section 3: sigmask.3, sigsetmask.3, siggetmask.3. @@ -2203,7 +2203,7 @@ sigvec.3 This new page is provides a fuller description of the BSD signal API than was provided in the now-deleted sigvec.2 and sigblock.2. - + sigblock.3 siggetmask.3 sigmask.3 @@ -2215,20 +2215,20 @@ sigpause.3 mtk Moved here from Section 2. - Some minor wording fixes; clarified System V origins of + Some minor wording fixes; clarified System V origins of X/Open flavour of this function. sigset.3 mtk - New page describing the System V signal API: sigset(), sighold(), + New page describing the System V signal API: sigset(), sighold(), sigrelse(), sigignore(). strftime.3 James Vega - Add further text clarifying that %+ specifier is not supported in + Add further text clarifying that %+ specifier is not supported in glibc2. mtk - Added GLIBC NOTES section describing optional 'flag' and 'width' + Added GLIBC NOTES section describing optional 'flag' and 'width' components of conversion specifiers. Some wording changes to bring terminology closer to SUSv3. Added an example program. @@ -2245,7 +2245,7 @@ intro.7 signal.7 mtk Added some SEE ALSO entries. - + socket.7 Senthil Kumar / mtk Added text noting that select()/poll() do not respect SO_RCVLOWAT. @@ -2288,16 +2288,16 @@ HOWTOHELP poll.2 mtk - Added NOTES about INFTIM constant provided on some other + Added NOTES about INFTIM constant provided on some other implementations. - + shmop.2 Alan Stern The -1 error return of shmat() should be cast "(void *)". - + strftime.r aeb - Remove junk text (actually intended as source code comment + Remove junk text (actually intended as source code comment in page). ip.7 @@ -2342,15 +2342,11 @@ fmemopen.3 New documentation for the glibc-specific fmemopen() and open_memstream(). Based on glibc info page. -open_memstream.3 - mtk - New link to new fmemopen.3 - pipe.7 - mtk (with prompting and suggestions for improvements by + mtk (with prompting and suggestions for improvements by Michael Haardt) New page providing overview of pipes and FIFOs. - + Changes to individual pages --------------------------- @@ -2374,8 +2370,8 @@ wait.2 carg.3 Justin Pryzby - Delete line that should have been deleted when applying - 2.08 fix for this page. + Delete line that should have been deleted when applying + 2.08 fix for this page. getaddrinfo.3 mtk @@ -2386,6 +2382,10 @@ inet.3 Added GLIBC NOTES describing feature test macros required to expose declaration of inet_aton(). +open_memstream.3 + mtk + New link to new fmemopen.3 + fifo.4 mtk Added SEE ALSO for new pipe.7 page. @@ -2439,49 +2439,49 @@ Changes to individual pages bind.2 mtk Added mention of AF_INET6 address family. - Added discussion of sockaddr structure and an example in the + Added discussion of sockaddr structure and an example in the Unix domain. recv.2 mtk Put 'flags' list in alphabetical order. - + send.2 mtk - Added cross-reference from discussion of MSG_MORE to UDP_CORK + Added cross-reference from discussion of MSG_MORE to UDP_CORK in udp(7). Put 'flags' list in alphabetical order. err.3 mtk - Added CONFORMING TO section noting that these are + Added CONFORMING TO section noting that these are non-standard BSDisms. - + errno.3 Justin Pryzby Added SEE ALSO for err.3 (Debian bug 306867) gethostbyname.3 Martin (Joey) Schulze / mtk - Added references to nsswitch.conf(5); remove cross references + Added references to nsswitch.conf(5); remove cross references to resolv+(8). (See also Debian Bug#308397.) - + perror.3 Justin Pryzby Added SEE ALSO for err.3 (Debian bug 306867) resolver.3 - mtk / Martin (Joey) Schulze - Remove cross references to resolv+(8); add cross references to + mtk / Martin (Joey) Schulze + Remove cross references to resolv+(8); add cross references to resolv.conf(5). (See also Debian Bug#214892) Added SEE ALSO entry for resolver(5) (See Debian Bug#251122.) - + strerror.3 mtk / Stefan Puiu Rewrote and extended the discussion of the two flavours of - strerror_r(), and added some additional information on + strerror_r(), and added some additional information on strerror(). Justin Pryzby Added SEE ALSO for err.3 (Debian bug 306867) @@ -2515,14 +2515,13 @@ socket.7 udp.7 mtk, after a note by Stefan Puiu Updated discussion of SO_BSDCOMPAT. - Added unix.7 and ipv6.7 to SEE ALSO. unix.7 mtk Added new (UN)SUPPORTED FEATURES section in which it is noted that Unix domain sockets do not support MSG_OOB or MSG_MORE. - Noted details of SO_SNBUF and SO_RCVBUF support for + Noted details of SO_SNBUF and SO_RCVBUF support for Unix domain sockets. @@ -2559,7 +2558,7 @@ HOWTOHELP bind.2 Stefan Puiu / mtk - Remove text under EINVAL error: "This may change in the future: + Remove text under EINVAL error: "This may change in the future: see linux/unix/sock.c for details." This behaviour has been unchanged for a long time, and seems unlikely to change. @@ -2594,7 +2593,7 @@ Changes to individual pages sigaltstack.2 mtk - Added some text to explain the usual scenario in which + Added some text to explain the usual scenario in which sigaltstack() is employed. getloadavg.3 @@ -2624,7 +2623,7 @@ udp.7 mtk The only changes to these pages have been for formatting: -- Structure definitions were changed to K&R style - -- Some long source lines were broken to fit into ~70 + -- Some long source lines were broken to fit into ~70 character lines. No changes were made to the content of these pages (yet...). @@ -2651,12 +2650,12 @@ Apologies if I missed anyone! Global changes -------------- -dd.1 cp.1 +dd.1 cp.1 truncate.2 gethostname.2 lseek.2 listxattr.2 readlink.2 sysfs.2 stat.2 ustat.2 uname.2 getdomainname.2 argz_add.3 asprintf.3 confstr.3 bstring.3 bzero.3 dlopen.3 fwide.3 -gethostbyname.3 getline.3 getlogin.3 getnameinfo.3 getpass.3 hsearch.3 -perror.3 printf.3 readdir.3 scanf.3 stpcpy.3 strdup.3 strfmon.3 +gethostbyname.3 getline.3 getlogin.3 getnameinfo.3 getpass.3 hsearch.3 +perror.3 printf.3 readdir.3 scanf.3 stpcpy.3 strdup.3 strfmon.3 strftime.3 string.3 strptime.3 sysconf.3 termios.3 ttyname.3 dsp56k.4 tty_ioctl.4 elf.5 proc.5 termcap.5 @@ -2665,9 +2664,9 @@ charsets.7 unix.7 Various pages use inconsistent terms for 'null byte' (which is the C99/SUSv3 term for the '\0' character). - To rectify this the following changes were made in the above + To rectify this the following changes were made in the above pages: - + Replace 'zero byte' with 'null byte'. Replace 'null character' with 'null byte'. Replace 'nulls' with 'null bytes'. @@ -2679,20 +2678,12 @@ charsets.7 unix.7 Various pages mtk - Replace "SysV"/"SYSV" by "System V". - + Replace "SysV"/"SYSV" by "System V". + Typographical or grammatical errors have been corrected in several places. -New pages ---------- - -mmap64.3 - Mike Frysinger - New link to mmap.2 - - Changes to individual pages --------------------------- @@ -2700,11 +2691,11 @@ capget.2 mtk Noted bug that could wrongly cause EPERM in unprivileged capset() with 'pid' field == getpid(). - + epoll_ctl.2 mtk Noted that EPOLLONESHOT was added in 2.6.2. - + gethostname.2 mtk Added GLIBC NOTES describing operation of glibc's @@ -2716,6 +2707,10 @@ mmap.2 mtk A few other small rewordings. +mmap64.3 + Mike Frysinger + New link to mmap.2 + open.2 mtk Added BUG noting that O_ASYNC can't be enabled via @@ -2724,14 +2719,14 @@ open.2 recv.2 Stefan Puiu Relocate misplaced discussion of MSG_DONTWAIT. - + dlopen.3 mtk Rewrote discussion of dlopen() 'flag' argument; - added descriptions of RTLD_NOLOAD, RTLD_DELETE, + added descriptions of RTLD_NOLOAD, RTLD_DELETE, and RTLD_DEEPBIND. - Noted use of atexit() to register a function that is + Noted use of atexit() to register a function that is automatically called when a library is unloaded. fmemopen.3 @@ -2758,16 +2753,16 @@ proc.5 Documented /proc/PID/task. - Noted that the contents of /proc/PID/{cwd,exe,fd,root,task} + Noted that the contents of /proc/PID/{cwd,exe,fd,root,task} are not available if the main thread has terminated. - - Senthil Kumar + + Senthil Kumar Add pointer to random(4) for description of files under /proc/sys/kernel/random. udp.7 Stefan Puiu / mtk - Small rewording of discussion of SO_BSDCOMPAT + Small rewording of discussion of SO_BSDCOMPAT (add cross-ref to socket(7)). @@ -2797,9 +2792,14 @@ Global changes Typographical or grammatical errors have been corrected in several places. +Changes to individual pages +--------------------------- -New pages ---------- +mmap.2 + aeb/mtk + Noted that portable applications should specify fd as -1 + when using MAP_ANONYMOUS. + Some rewriting of description of MAP_ANONYMOUS. rt_sigreturn.2 Thorsten Kukuk @@ -2809,28 +2809,19 @@ rt_sigsuspend.2 mtk New link to sigsuspend.2 -Changes to individual pages ---------------------------- - -mmap.2 - aeb/mtk - Noted that portable applications should specify fd as -1 - when using MAP_ANONYMOUS. - Some rewriting of description of MAP_ANONYMOUS. - waitid.2 mtk Noted that waitid() does not set infop->si_uid field on most other implementations. - + getopt.3 Walter harms / mtk - Make clear that when calling getopt_long() and there are no + Make clear that when calling getopt_long() and there are no short options, then 'optstring' should be "", not NULL. openpty.3 Thomas Hood / mtk - In glibc 2.0.92, openpty() was modified to preferably open + In glibc 2.0.92, openpty() was modified to preferably open Unix 98 ptys instead of BSD ptys. qsort.3 @@ -2887,7 +2878,7 @@ inotify_add_watch.2 inotify_rm_watch.2 Robert Love, with some additions by mtk. New pages describing the inotify API. - + mbind.2 get_mempolicy.2 set_mempolicy.2 @@ -2908,7 +2899,7 @@ Changes to individual pages clone.2 Andi Kleen - On x86, clone() should not be called through vsyscall, + On x86, clone() should not be called through vsyscall, but directly through "int $0x80". fcntl.2 @@ -2922,7 +2913,7 @@ kill.2 Small wording change under NOTES to clarify what happens when a process sends a signal to itself. See Debian bug 350236. - + mlock.2 mtk / Matthias Andree Added BUGS txt on interaction between MCL_FUTURE and @@ -2930,7 +2921,7 @@ mlock.2 See the following LKML thread: http://marc.theaimsgroup.com/?l=linux-kernel&m=113801392825023&w=2 "Rationale for RLIMIT_MEMLOCK" - + msgop.2 mtk / Samuel Thibault Rewrote declaration of 'msgp' to be "void *" in response @@ -2939,21 +2930,21 @@ msgop.2 open.2 mtk - Clarify distinction between "file creation flags" and + Clarify distinction between "file creation flags" and "file status flags". read.2 Justin Pryzby Add SEE ALSO for pread(2). As per Debian bug 351873. - + sched_setaffinity.2 mtk Major rewrite. select.2 mtk - Added return types to prototypes for FD_SET(), FD_CLR(), + Added return types to prototypes for FD_SET(), FD_CLR(), FD_ZERO, and FD_ISSET(). Other minor wording changes. @@ -2961,7 +2952,7 @@ read.2 mtk Add SEE ALSO for pwrite(2). (Analogous with read.2 change above.) - + errno.3 Kurt Wall / mtk Add Linux specific errors to this page. @@ -2982,7 +2973,7 @@ setlocale.3 Martin (Joey) Schulze Added SEE ALSO refs for nl_langinfo.3 As per Debian bug 351831. - + proc.5 mtk Migrated description of inotify files to the new inotify.7 page. @@ -3018,17 +3009,17 @@ Apologies if I missed anyone! New pages --------- -get_kernel_syms.2 -create_module.2 -delete_module.2 -init_module.2 +get_kernel_syms.2 +create_module.2 +delete_module.2 +init_module.2 query_module.2 FSF / mtk (with assistance of Luc Van Oostenryck) man-pages finally gets pages for these system calls, several of which are obsolete in Linux 2.6. Took the old GPLed pages dated 1996 and made a number of clean-ups and minor additions. - + Global changes -------------- @@ -3073,15 +3064,15 @@ clone.2 fcntl.2 mtk Under ERRORS: Separate out EAGAIN error for locking mmaped files. - + inotify_add_watch.2 mtk Minor wording fix. - + msgop.2 mtk Documented the EAGAIN error for msgrcv(). - + fnmatch.3 Mike Frysinger / mtk Expand explanation of FNM_PATHNAME. @@ -3126,7 +3117,7 @@ mq_unlink.3 posix_fallocate.3 mtk, after a suggestion by James Peach New page describing posix_fallocate(). - + mq_overview.7 mtk New page giving overview of the POSIX message queue API. @@ -3197,10 +3188,10 @@ sysctl.2 syslog.2 tkill.2 mtk, aeb, Steve Beattie - Added comment in SYNOPSIS to note that syscall(2) may be + Added comment in SYNOPSIS to note that syscall(2) may be preferable over _syscallN (see intro(2)). -Various minor formatting changes were done on a range of +Various minor formatting changes were done on a range of pages in Section 7. (No content was changed.) New pages @@ -3235,7 +3226,7 @@ execve.2 intro.2 mtk, aeb, Steve Beattie Added some notes on syscall(2) versus _syscall. - + msgctl.2 msgget.2 msgop.2 @@ -3245,8 +3236,8 @@ msgop.2 open.2 mtk Added SEE ALSO pointing to new openat.2. - - Split out part of the RETURN VALUE text into separate + + Split out part of the RETURN VALUE text into separate NOTES section. Modified wording referring to raw(8) to @@ -3255,7 +3246,7 @@ open.2 poll.2 mtk Added discussion of ppoll(2), which is new in 2.6.16. - + ppoll.2 mtk New link to poll.2. @@ -3263,7 +3254,7 @@ ppoll.2 recvmsg.2 sendmsg.2 mtk / Paul Brook - Added text to note that although POSIX says msg_controllen + Added text to note that although POSIX says msg_controllen should be socklen_t, glibc actually uses size_t. See Debian bug 356502 and the associated glibc bug report. http://sourceware.org/bugzilla/show_bug.cgi?id=2448. @@ -3302,7 +3293,7 @@ shm_unlink.3 swab.3 Walter Harms Add needed "#define _XOPEN_SOURCE". - + undocumented.3 mtk Updated to remove a few function names that are now documented. @@ -3319,7 +3310,7 @@ inotify.7 mq_overview.7 mtk - Some rewording and added a few words about System V + Some rewording and added a few words about System V message queues. netlink.7 @@ -3330,12 +3321,12 @@ netlink.7 pthreads.7 mtk - Updated to reflect that the NPTL limitation that only the main + Updated to reflect that the NPTL limitation that only the main thread could call setsid() and setpgid() was removed in 2.6.16. raw.7 Hasso Tepper - Removed text implying that only in kernel 2.2 does IP_HDRINCL + Removed text implying that only in kernel 2.2 does IP_HDRINCL prevent datagrams from being fragmented. socket.7 @@ -3373,7 +3364,7 @@ Apologies if I missed anyone! Global changes -------------- -Various minor formatting changes were done on a range of +Various minor formatting changes were done on a range of pages in Section 7. (No content was changed.) @@ -3405,10 +3396,10 @@ mremap.2 by glibc since version 2.4. ptrace.2 - Chuck Ebbert, with assistance from Daniel Jacobowitz, + Chuck Ebbert, with assistance from Daniel Jacobowitz, Paolo (Blaisorblade) Giarrusso, and Charles P. Wright; after a suggestion from Heiko Carstens. - Document the following ptrace requests: + Document the following ptrace requests: PTRACE_SETOPTIONS (2.4.6) plus associated flags: PTRACE_O_TRACESYSGOOD (2.4.6) @@ -3423,7 +3414,7 @@ ptrace.2 PTRACE_GETEVENTMSG (2.5.46) PTRACE_SYSEMU (since Linux 2.6.14) PTRACE_SYSEMU_SINGLESTEP (since Linux 2.6.14) - + sched_get_priority_max.2 sched_setscheduler.2 sched_setparam.2 @@ -3483,7 +3474,7 @@ sem_overview.7 mtk New pages describing the POSIX semaphores API. - These pages supercede and provide a superset of the information + These pages supercede and provide a superset of the information in the glibc (3thr) "semaphores(3)" manual page. @@ -3589,7 +3580,7 @@ open.2 mtk / Roberto Jimenoca Clarified discussion of file types affected by O_NONBLOCK. See Debian bug 360243. - + openat.2 mtk Rewrote NOTES describing rationale for openat(). @@ -3598,17 +3589,17 @@ openat.2 recv.2 Stefan Puiu Removed a misleading cross-ref to socket.2. - + shmop.2 mtk - Since 2.6.17-rc1, shmdt() gives the error EINVAL in a further + Since 2.6.17-rc1, shmdt() gives the error EINVAL in a further circumstance: if shmaddr is not aligned on a page boundary. unshare.2 mtk - Remove text saying that specifying invalid flags "is likely - to cause compatibility problems" since the kernel now - (2.6.17-rc1) contains an explicit check for invalid bits + Remove text saying that specifying invalid flags "is likely + to cause compatibility problems" since the kernel now + (2.6.17-rc1) contains an explicit check for invalid bits with a consequent EINVAL error. mkfifo.3 @@ -3704,7 +3695,7 @@ termios.3 mtk Clarify arguments for cfsetspeed(). Various formatting changes. - + full.4 Andre Lehovich Add a sentence describing the purpose of full(4). @@ -3758,10 +3749,10 @@ environ.5 (many pages outside man-pages actually *expect* 'environ' to be in Section 7.) ipc.5 renamed to svipc.7 -".so" link files have been created to link the old file locations to the -new file locations. These links are added just to ensure that cross +".so" link files have been created to link the old file locations to the +new file locations. These links are added just to ensure that cross references from any other (non-man-pages) pages will remain valid; -eventually these links will be removed. +eventually these links will be removed. New pages @@ -3774,27 +3765,16 @@ fstatat.2 adjtime.3 mtk New page for adjtime(3). - + error.3 Justin Pryzby / mtk New page describing error() and error_at_line() Fixes Debian bug 186307. -error_at_line.3 -error_message_count.3 -error_on_per_line.3 -error_print_progname.3 - mtk - New links to new error.3. - program_invocation_name.3 mtk - New page describing program_invocation_name and + New page describing program_invocation_name and program_invocation_short_name variables. - -program_invocation_short_name.3 - mtk - New link to new program_invocation_name.3. sockatmark.3 mtk @@ -3820,9 +3800,9 @@ gettimeofday.2 initgroups.3 dirfd.3 mtk - Simplified wording around requirement for _BSD_SOURCE + Simplified wording around requirement for _BSD_SOURCE feature test macro. - + times.2 time.2 gettimeofday.2 @@ -3833,7 +3813,7 @@ rtc.4 mtk Added SEE ALSO referring to new time.7. -err.3 +err.3 errno.3 perror.3 strerror.3 @@ -3852,17 +3832,17 @@ Changes to individual pages accept.2 Mark Glines - Remove mention of SOCK_RDM from this page, since this socket + Remove mention of SOCK_RDM from this page, since this socket type does not support accept()ing connections. adjtimex.2 mtk Modified text referring to adjtime(); added SEE ALSO for new adjtime.3 page. - + fsync.2 mtk, after a note by Karel Kulhavy - Rewrote most of the DESCRIPTION, as well as some other parts + Rewrote most of the DESCRIPTION, as well as some other parts the page, to clarify use and operation of, and rationale for, fsync(2) and fdatasync(2). @@ -3874,20 +3854,20 @@ getitimer.2 Added text to note that current incorrect behaviour of normalising tv_usec >= 1000000 will be repaired in a future kernel; applications should be fixed now. - + gettimeofday.2 Karel Kulhavy - Point out more explicitly that 'tz' argument should + Point out more explicitly that 'tz' argument should normally be NULL. mtk Various other minor edits and formatting fixes. mount.2 mtk - Since kernel 2.6.16, MS_NOATIME and MS_NODIRATIME are settable + Since kernel 2.6.16, MS_NOATIME and MS_NODIRATIME are settable on a per-mount basis. Detail exactly which mount flags can be changed on MS_REMOUNT. - + nanosleep.2 mtk / Karel Kulhavy Clarify RETURN VALUE discussion. @@ -3896,16 +3876,20 @@ openat.2 mtk Add SEE ALSO reference pointing to new fstatat.2. +program_invocation_short_name.3 + mtk + New link to new program_invocation_name.3. + recv.2 mtk Added SEE ALSO for new sockatmark.3. - + rmdir.2 Joshua Kwan / Martin (Joey) Schulze / mtk Correct wording of EBUSY case. mtk Add ".." case to ENOTEMPTY error - + select.2 Karel Kulhavy Note more clearly that fd_set arguments can be NULL. @@ -3913,24 +3897,24 @@ select.2 Improve opening paragraph describing purpose of select(). mtk Various other minor edits and formatting fixes. - + semget.2 mtk / Nishanth Aravamudan Add text to noting that the initial values of semaphores in a new set are indeterminate. - + shmget.2 mtk - Add text noting that contents of newly created segment are zero + Add text noting that contents of newly created segment are zero values. - + sigwaitinfo.2 mtk Noted that all threads should block signal being waited for. stat.2 Nishanth Aravamudan / mtk - Added NOTE that st_size is always returned as zero for most + Added NOTE that st_size is always returned as zero for most /proc files. mtk Add SEE ALSO reference pointing to new fstatat.2. @@ -3948,19 +3932,26 @@ confstr.3 Rewrote RETURN VALUE discussion. Updated CONFORMING TO. Removed BUGS. - + ctanh.3 Martin (Joey) Schulze / mtk Fix errors in DESCRIPTION. - + ctime.3 mtk The range of tm_sec is 0..60 (not 0..61). +error_at_line.3 +error_message_count.3 +error_on_per_line.3 +error_print_progname.3 + mtk + New links to new error.3. + fmemopen.3 mtk / Ryan S. Arnold - Add text noting that explicitly controlling output buffering - may be useful to catch errors on output operations on an + Add text noting that explicitly controlling output buffering + may be useful to catch errors on output operations on an fmemopen() stream. getline.3 @@ -3971,23 +3962,23 @@ getline.3 strtod.3 strtoul.3 mtk - Describe correct handling of errno in order to + Describe correct handling of errno in order to distinguish error from success after the call. - Added EXAMPLE section which points to strtol.3 which provides + Added EXAMPLE section which points to strtol.3 which provides an example of the use of the analogous strtol(3). strtol.3 mtk / Justin Pryzby Add an example program. mtk - Describe correct handling or errno in order to + Describe correct handling or errno in order to distinguish error from success after the call. tmpfile.3 - Reuben Thomas <rrt@sc3d.org> + Reuben Thomas <rrt@sc3d.org> DESCRIPTION does not need to say "temporary file name" - just "temporary file", since the name is in any case + just "temporary file", since the name is in any case unavailable to the user. See Debian bug 363518. mtk @@ -4068,7 +4059,7 @@ access.2 capget.2 mtk Reworded to reflect that capabilities are per-thread. - + chmod.2 mtk Add SEE ALSO reference pointing to new fchmodat.2 page. @@ -4079,7 +4070,7 @@ chown.2 mmap.2 mtk - Updated discussion of MAP_NORESERVE since it is no longer + Updated discussion of MAP_NORESERVE since it is no longer restricted to MAP_PRIVATE mappings. Add reference to discussion of /proc/sys/vm/overcommit_memory in proc.5. @@ -4095,10 +4086,10 @@ shmget.2 truncate.2 Paul Brook / mtk - Expand text noting that ftruncate()/truncate() may fail if + Expand text noting that ftruncate()/truncate() may fail if asked to extend a file beyond its current length. Add EPERM error. - + utime.2 mtk Add SEE ALSO reference pointing to new futimesat.2 page. @@ -4125,18 +4116,18 @@ termios.3 Clarify meaning of IXANY. Clarify relationship of MIN with VMIN and TIME with VTIME. mtk - Noted that CIBAUD, OFDEL, and DELECHO are not implemented + Noted that CIBAUD, OFDEL, and DELECHO are not implemented on Linux. - Added explanatory paragraph for phrases "not in POSIX" and + Added explanatory paragraph for phrases "not in POSIX" and "XSI". - + capabilities.7 mtk Reworded to reflect that capabilities are per-thread. - Add ioprio_set() to list of operations permitted by + Add ioprio_set() to list of operations permitted by CAP_SYS_NICE. - Add ioprio_set() IOPRIO_CLASS_RT and IOPRIO_CLASS_IDLE - scheduling classes to list of operations permitted by + Add ioprio_set() IOPRIO_CLASS_RT and IOPRIO_CLASS_IDLE + scheduling classes to list of operations permitted by CAP_SYS_ADMIN. Note effects of CAP_SYS_NICE for migrate_pages(). @@ -4174,46 +4165,10 @@ mq_getsetattr.2 New page briefly describing mq_getsetattr(2), the system call that underlies mq_setattr(3) and mq_getattr(3). -CPU_ISSET.3 -CPU_CLR.3 -CPU_SET.3 -CPU_ZERO.3 - mtk - New links to sched_setaffinity.2 - -FD_CLR.3 -FD_ISSET.3 -FD_SET.3 -FD_ZERO.3 - mtk - New links to select.2. - -mq_setattr.3 - mtk - New link to mq_getattr.3. - -mq_timedreceive.3 - mtk - New link to mq_receive.3. - -mq_timedsend.3 - mtk - New link to mq_send.3. - rpmatch.3 Justin Pryzby / mtk New page for rpmatch(3). -sigandset.3 -sigisemptyset.3 -sigorset.3 - mtk - New links to sigsetops.3. - -strchrnul.3 - mtk - New link to strchr.3. - Changes to individual pages --------------------------- @@ -4231,12 +4186,12 @@ mmap.2 Justin Pryzby Add mincore(2) to SEE ALSO. See Debian bug 367401. - + msync.2 Justin Pryzby - Note that EINVAL can also be caused by + Note that EINVAL can also be caused by flags == MS_SYNC | MS_ASYNC. - + sched_setaffinity.2 mtk Add CPU_ISSET, CPU_CLR, CPU_SET, CPU_ZERO to NAME section. @@ -4254,6 +4209,20 @@ umask.2 mtk Substantial rewrite of description of 'mask'. +CPU_ISSET.3 +CPU_CLR.3 +CPU_SET.3 +CPU_ZERO.3 + mtk + New links to sched_setaffinity.2 + +FD_CLR.3 +FD_ISSET.3 +FD_SET.3 +FD_ZERO.3 + mtk + New links to select.2. + fts.3 Justin Pryzby Add SEE also referring to ftw.3. @@ -4273,15 +4242,33 @@ mkstemp.3 mq_open.3 Martin Osvald Fix prototype declaration for 'attr'. - + mq_notify.3 Martin Osvald s/sigev_signal/sigev_signo/ - + +mq_setattr.3 + mtk + New link to mq_getattr.3. + +mq_timedreceive.3 + mtk + New link to mq_receive.3. + +mq_timedsend.3 + mtk + New link to mq_send.3. + setlocale.3 Justin Pryzby Added SEE ALSO referring to rpmatch.3. +sigandset.3 +sigisemptyset.3 +sigorset.3 + mtk + New links to sigsetops.3. + stdio.3 Justin Pryzby Added SEE ALSO referring to unlocked_stdio.3 @@ -4291,12 +4278,16 @@ strchr.3 Justin Pryzby Add description of strchrnul(). +strchrnul.3 + mtk + New link to strchr.3. + undocumented.3 Justin Pryzby / mtk - Updated to remove some functions that don't exist, and + Updated to remove some functions that don't exist, and therefore don't need to be documented. See Debian bug 367671. - + unlocked_stdio.3 Justin Pryzby Added SEE ALSO referring to stdio.3 @@ -4304,7 +4295,7 @@ unlocked_stdio.3 mq_overview.7 mtk - Added section describing relationship between library + Added section describing relationship between library interfaces and system calls. Added SEE ALSO referring to new mq_getsetattr.2. @@ -4349,7 +4340,7 @@ tzselect.8 zdump.8 zic.8 mtk, Joey - Added header comment noting that these pages are in the public + Added header comment noting that these pages are in the public domain. bindresvport.3 @@ -4366,10 +4357,6 @@ rpc.5 New pages --------- -ioprio_get.2 - mtk - New link to new ioprio_set.2. - ioprio_set.2 Eduardo Madeira Fleury, with edits by mtk, and review by Jens Axboe New page for ioprio_get(2) and ioprio_set(2), new in 2.6.13. @@ -4400,10 +4387,10 @@ inotify_add_watch.2 See Debian bug 369960. mtk Renamed argument from 'path' to 'pathname'. - Reword introductory paragraph to clarify that + Reword introductory paragraph to clarify that inotify_add_watch() may also modify an existing watch item. mtk - The EINVAL error can also occur if 'fd' is not an inotify + The EINVAL error can also occur if 'fd' is not an inotify file descriptor. mtk Moved BUGS section from this page to inotify.7. @@ -4418,9 +4405,13 @@ inotify_rm_watch.2 s/<inotify.h>/<sys/inotify.h>/ in prototypes. See Debian bug 369960. mtk - The EINVAL error can also occur if 'fd' is not an inotify + The EINVAL error can also occur if 'fd' is not an inotify file descriptor. +ioprio_get.2 + mtk + New link to new ioprio_set.2. + mmap.2 mtk Add SEE ALSO referring to remap_file_pages.2. @@ -4432,7 +4423,7 @@ mount.2 mremap.2 Mike Frysinger s/unsigned long flags/int flags/ in SYNOPSIS. - + pipe.2 mtk Add SEE ALSO referring to popen.3. @@ -4451,7 +4442,7 @@ readahead.2 send.2 Peter Eiserloh - Fix missing arguments in statement about equivalent send() + Fix missing arguments in statement about equivalent send() and sendto() calls. setsid.2 @@ -4461,7 +4452,7 @@ setsid.2 shmctl.2 mtk Minor wording change at start of DESCRIPTION. - + stat.2 mtk Add SEE ALSO referring to access.2. @@ -4499,7 +4490,7 @@ inet.3 Marc Lehmann Fixed typo in NOTES. Debian bug 370277. - + isalpha.3 Joey Updated CONFORMING TO. @@ -4519,7 +4510,7 @@ readdir.3 re_comp.3 mtk Note that these functions are obsolete in favour of regcomp(3). - Justin Pryzby + Justin Pryzby Add SEE ALSO referring to regcomp.3 scandir.3 @@ -4541,7 +4532,7 @@ tmpnam.3 mtk Clarify discussion of use of free(3). Various other minor changes to text and formatting. - + tmpfile.3 mtk Updated CONFORMING TO. @@ -4571,7 +4562,7 @@ epoll.7 feature_test_macros.7 mtk Added pointer to location of LFS specification. - + futex.7 mtk, after suggestion by Joey. Added license statement to page, after discussion with @@ -4593,7 +4584,7 @@ man.7 Justin Pryzby Add SEE ALSO referring to groff_man(7). Debian bug 369253. - + ==================== Changes in man-pages-2.35 ==================== @@ -4663,9 +4654,9 @@ poll.2 readlink.2 mtk - Nowadays, readlink() returns 'ssize_t', as required in + Nowadays, readlink() returns 'ssize_t', as required in POSIX.1-2001. - + wavelan.4 mtk Added license statement. |