From 6c0aabc576020f92fb0bde239e92c2e0c4a0c703 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 23 May 2006 03:57:44 +0000 Subject: [PATCH] Ready for 2.33 release. --- Changes | 211 ++++++++++++++++++++++++++++++++-------------------- Changes.old | 123 ++++++++++++++++++++++++++++++ HOWTOHELP | 29 ++++---- 3 files changed, 268 insertions(+), 95 deletions(-) diff --git a/Changes b/Changes index dd6468150..e4b8fb5cd 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-2.32 ==================== +==================== Changes in man-pages-2.33 ==================== -Released: 2006-05-13 +Released: 2006-05-23 Contributors ------------ @@ -9,113 +9,162 @@ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Andries Brouwer -Johannes Weiner Justin Pryzby -Karel Kulhavy -Paul Brook -Pavel Heimlich +Martin Osvald" +Stefan Puiu Apologies if I missed anyone! +Page renamings +-------------- + +ftm.7 renamed to the more suggestive feature_test_macros.7 + mtk / Stefan Puiu + + New pages --------- -faccessat.2 - mtk - New page for faccessat(2), new in 2.6.16. +mq_getsetattr.2 + mtk + New page briefly describing mq_getsetattr(2), the system + call that underlies mq_setattr(3) and mq_getattr(3). -fchmodat.2 +CPU_ISSET.3 +CPU_CLR.3 +CPU_SET.3 +CPU_ZERO.3 mtk - New page for fchmodat(2), new in 2.6.16. + New links to sched_setaffinity.2 -fchownat.2 +FD_CLR.3 +FD_ISSET.3 +FD_SET.3 +FD_ZERO.3 mtk - New page for fchownat(2), new in 2.6.16. + New links to select.2. -futimesat.2 +mq_setattr.3 mtk - New page for futimesat(2), new in 2.6.16. + 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 --------------------------- -access.2 - mtk - Add SEE ALSO reference pointing to new faccessat.2 page. - -capget.2 - mtk - Reworded to reflect that capabilities are per-thread. - chmod.2 mtk - Add SEE ALSO reference pointing to new fchmodat.2 page. + Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC. + POSIX does now document ELOOP. -chown.2 +open.2 mtk - Add SEE ALSO reference pointing to new fchownat.2 page. + Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC. mmap.2 - mtk - 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. - -openat.2 - mtk - Add SEE ALSO reference pointing to new faccessat.2, fchmodat.2, - fchownat.2, futimesat.2 pages. - -shmget.2 - mtk - Document SHM_NORESERVE flag, new in 2.6.15. - -truncate.2 - Paul Brook / mtk - Expand text noting that ftruncate()/truncate() may fail if - asked to extend a file beyond its current length. - Add EPERM error. + Justin Pryzby + Add mincore(2) to SEE ALSO. + See Debian bug 367401. -utime.2 +msync.2 + Justin Pryzby + Note that EINVAL can also be caused by + flags == MS_SYNC | MS_ASYNC. + +sched_setaffinity.2 mtk - Add SEE ALSO reference pointing to new futimesat.2 page. + Add CPU_ISSET, CPU_CLR, CPU_SET, CPU_ZERO to NAME section. -fopen.3 +select.2 + mtk + Various minor changes. + +select_tut.2 + mtk + Removed much material that is redundant with select.2. + Various other changes. + +umask.2 + mtk + Substantial rewrite of description of 'mask'. + +fts.3 + Justin Pryzby + Add SEE also referring to ftw.3. + +ftw.3 + Justin Pryzby + Add SEE also referring to fts.3. + +getline.3 + Justin Pryzby + Various minor clarifications. + +mkstemp.3 + mtk + Clarify that O_EXCL is an open(2) flag. + +mq_open.3 + Martin Osvald + Fix prototype declaration for 'attr'. + +mq_notify.3 + Martin Osvald + s/sigev_signal/sigev_signo/ + +setlocale.3 + Justin Pryzby + Added SEE ALSO referring to rpmatch.3. + +stdio.3 + Justin Pryzby + Added SEE ALSO referring to unlocked_stdio.3 + See Debian bug 367667. + +strchr.3 + Justin Pryzby + Add description of strchrnul(). + +undocumented.3 Justin Pryzby / mtk - Document 'm' (mmap) flag. - Debian bug 365754. - mtk - Document 'c' (notcancel) flag. - -futimes.3 - mtk - Add SEE ALSO reference pointing to new futimesat.2 page. - -qsort.3 - Johannes Weiner - Add missing "const" qualifies to cast in EXAMPLE. - mtk - Slight rewording of comments in EXAMPLE. - -termios.3 - Karel Kulhavy - Clarify meaning of IXANY. - Clarify relationship of MIN with VMIN and TIME with VTIME. - mtk - Noted that CIBAUD, OFDEL, and DELECHO are not implemented - on Linux. - Added explanatory paragraph for phrases "not in POSIX" and - "XSI". + Updated to remove some functions that don't exist, and + therefore don't need to be documented. + See Debian bug 367671. -capabilities.7 +unlocked_stdio.3 + Justin Pryzby + Added SEE ALSO referring to stdio.3 + See Debian bug 367667. + +mq_overview.7 mtk - Reworded to reflect that capabilities are per-thread. - 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 op operations permitted by - CAP_SYS_ADMIN. - Note effects of CAP_SYS_NICE for migrate_pages(). + Added section describing relationship between library + interfaces and system calls. + Added SEE ALSO referring to new mq_getsetattr.2. + +feature_test_macros.7 + Stefan Puiu + Fix typo: s/_POSIX_C_SOURCE/_POSIX_SOURCE/ diff --git a/Changes.old b/Changes.old index 96535c349..09b11de71 100644 --- a/Changes.old +++ b/Changes.old @@ -4016,3 +4016,126 @@ time.7 ld.so.8 Justin Pryzby Remove bogus duplicate line. + + +==================== Changes in man-pages-2.32 ==================== + +Released: 2006-05-13 + +Contributors +------------ + +The following people contributed notes, ideas, or patches that have +been incorporated in changes in this release: + +Andries Brouwer +Johannes Weiner +Justin Pryzby +Karel Kulhavy +Paul Brook +Pavel Heimlich + +Apologies if I missed anyone! + + +New pages +--------- + +faccessat.2 + mtk + New page for faccessat(2), new in 2.6.16. + +fchmodat.2 + mtk + New page for fchmodat(2), new in 2.6.16. + +fchownat.2 + mtk + New page for fchownat(2), new in 2.6.16. + +futimesat.2 + mtk + New page for futimesat(2), new in 2.6.16. + + +Changes to individual pages +--------------------------- + +access.2 + mtk + Add SEE ALSO reference pointing to new faccessat.2 page. + +capget.2 + mtk + Reworded to reflect that capabilities are per-thread. + +chmod.2 + mtk + Add SEE ALSO reference pointing to new fchmodat.2 page. + +chown.2 + mtk + Add SEE ALSO reference pointing to new fchownat.2 page. + +mmap.2 + mtk + 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. + +openat.2 + mtk + Add SEE ALSO reference pointing to new faccessat.2, fchmodat.2, + fchownat.2, futimesat.2 pages. + +shmget.2 + mtk + Document SHM_NORESERVE flag, new in 2.6.15. + +truncate.2 + Paul Brook / mtk + 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. + +fopen.3 + Justin Pryzby / mtk + Document 'm' (mmap) flag. + Debian bug 365754. + mtk + Document 'c' (notcancel) flag. + +futimes.3 + mtk + Add SEE ALSO reference pointing to new futimesat.2 page. + +qsort.3 + Johannes Weiner + Add missing "const" qualifies to cast in EXAMPLE. + mtk + Slight rewording of comments in EXAMPLE. + +termios.3 + Karel Kulhavy + Clarify meaning of IXANY. + Clarify relationship of MIN with VMIN and TIME with VTIME. + mtk + Noted that CIBAUD, OFDEL, and DELECHO are not implemented + on Linux. + 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 + CAP_SYS_NICE. + 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(). diff --git a/HOWTOHELP b/HOWTOHELP index 570760ee9..a5b1fbbe2 100644 --- a/HOWTOHELP +++ b/HOWTOHELP @@ -227,7 +227,7 @@ If you are thinking of writing one or more of these pages, then: -- You need to have a reasonably high degree of understanding of the topic, or be prepared to invest the time (e.g., reading source code, writing test programs) to gain that understanding. Writing test - programs is important; quite a few kernel and glibs bugs have been + programs is important; quite a few kernel and glibc bugs have been uncovered while writing test programs during the preparation of manual pages. @@ -270,7 +270,7 @@ request_key(2) (new in kernel 2.6.10) See: Documentation/keys.txt Documentation/keys-request-key.txt - Requires CONFIG_KEYS (and optionally COFIG_KEYS_DEBUG_PROC_KEYS) + Requires CONFIG_KEYS (and optionally CONFIG_KEYS_DEBUG_PROC_KEYS) under "Security options" restart_syscall(2) (new in kernel 2.6) @@ -283,8 +283,6 @@ migrate_pages(2) (new in kernel 2.6.16) preadv(2), pwritev(2) (new in ?? -- see http://www.lwn.net/Articles/164887/ ) -epoll_pwait(2) (probably will arrive in 2.6.17) - splice(2) Likely to be in 2.6.17. See http://lwn.net/Articles/178199/ @@ -296,6 +294,8 @@ sync_file_range(2) Likely to be in 2.6.17. set_robust_list(2) Likely to be in 2.6.17 get_robust_list(2) +epoll_pwait(2) (probably will arrive in 2.6.18?) + /sys file system ---------------- @@ -357,9 +357,11 @@ strptime_l(3) (since glibc 2.3.2) sysv_signal(3) updwtmpx(3) -sigandset(3), sigorset(3), sigisemptyset(3) - (perhaps on same page as sigemptyset(3)) - +backtrace(3) +backtrace_symbols(3) +backtrace_fd(3) + (There are info pages for these functions. See also + page 48 of http://people.redhat.com/~drepper/tut1.ps) argp_error(3) argp_failure(3) @@ -409,10 +411,11 @@ http://people.redhat.com/~drepper/asynchnl.pdf) Various wide character functions (with their traditional equivalents mentioned in parentheses): -wcscoll(3) (strcoll(3)) -wcsxfrm(3) (strxfrm(3)) +wscanf(3) (scanf(3)) + and fwscanf(3), swscanf(3), vfwscanf(3), vswscanf(3) wcschrnul(3) (strchrnul(3)) -wcswcs(3) (strstr(3)) +wcscoll(3) (strcoll(3)) +wcsftime(3) (strftime(3)) wcstod(3) (strtod(3)) wcstof(3) (strtof(3)) wcstold(3) (strtold(3)) @@ -424,10 +427,8 @@ wcstoull(3) (strtoull(3)) wcstoq(3) (atoq(3)) wcstoq(3) (strtoq(3)) wcstouq(3) (strtouq(3)) -wscanf(3) (scanf(3)) - and fwscanf(3), swscanf(3), vfwscanf(3), vswscanf(3) -wcsftime(3) (strftime(3)) - +wcswcs(3) (strstr(3)) +wcsxfrm(3) (strxfrm(3)) After these manual pages are written, add SEE ALSO entries from the pages for the traditional functions to the pages describing their wide-character equivalents.