mirror of https://github.com/mkerrisk/man-pages
Ready for 2.33 release.
This commit is contained in:
parent
a319f32dd2
commit
6c0aabc576
211
Changes
211
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
|
Contributors
|
||||||
------------
|
------------
|
||||||
|
@ -9,113 +9,162 @@ The following people contributed notes, ideas, or patches that have
|
||||||
been incorporated in changes in this release:
|
been incorporated in changes in this release:
|
||||||
|
|
||||||
Andries Brouwer <Andries.Brouwer@cwi.nl>
|
Andries Brouwer <Andries.Brouwer@cwi.nl>
|
||||||
Johannes Weiner <root@hnaz.ath.cx>
|
|
||||||
Justin Pryzby <justinpryzby@users.sourceforge.net>
|
Justin Pryzby <justinpryzby@users.sourceforge.net>
|
||||||
Karel Kulhavy <clock@twibright.com>
|
Martin Osvald" <martin.osvald@gmail.com>
|
||||||
Paul Brook <paul@nowt.org>
|
Stefan Puiu <stefanpuiuro@yahoo.com>
|
||||||
Pavel Heimlich <tropikhajma@seznam.cz>
|
|
||||||
|
|
||||||
Apologies if I missed anyone!
|
Apologies if I missed anyone!
|
||||||
|
|
||||||
|
|
||||||
|
Page renamings
|
||||||
|
--------------
|
||||||
|
|
||||||
|
ftm.7 renamed to the more suggestive feature_test_macros.7
|
||||||
|
mtk / Stefan Puiu
|
||||||
|
|
||||||
|
|
||||||
New pages
|
New pages
|
||||||
---------
|
---------
|
||||||
|
|
||||||
faccessat.2
|
mq_getsetattr.2
|
||||||
mtk
|
mtk
|
||||||
New page for faccessat(2), new in 2.6.16.
|
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
|
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
|
mtk
|
||||||
New page for fchownat(2), new in 2.6.16.
|
New links to select.2.
|
||||||
|
|
||||||
futimesat.2
|
mq_setattr.3
|
||||||
mtk
|
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
|
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
|
chmod.2
|
||||||
mtk
|
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
|
mtk
|
||||||
Add SEE ALSO reference pointing to new fchownat.2 page.
|
Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
|
||||||
|
|
||||||
mmap.2
|
mmap.2
|
||||||
mtk
|
Justin Pryzby
|
||||||
Updated discussion of MAP_NORESERVE since it is no longer
|
Add mincore(2) to SEE ALSO.
|
||||||
restricted to MAP_PRIVATE mappings.
|
See Debian bug 367401.
|
||||||
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
|
msync.2
|
||||||
|
Justin Pryzby
|
||||||
|
Note that EINVAL can also be caused by
|
||||||
|
flags == MS_SYNC | MS_ASYNC.
|
||||||
|
|
||||||
|
sched_setaffinity.2
|
||||||
mtk
|
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
|
Justin Pryzby / mtk
|
||||||
Document 'm' (mmap) flag.
|
Updated to remove some functions that don't exist, and
|
||||||
Debian bug 365754.
|
therefore don't need to be documented.
|
||||||
mtk
|
See Debian bug 367671.
|
||||||
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
|
unlocked_stdio.3
|
||||||
|
Justin Pryzby
|
||||||
|
Added SEE ALSO referring to stdio.3
|
||||||
|
See Debian bug 367667.
|
||||||
|
|
||||||
|
mq_overview.7
|
||||||
mtk
|
mtk
|
||||||
Reworded to reflect that capabilities are per-thread.
|
Added section describing relationship between library
|
||||||
Add ioprio_set() to list of operations permitted by
|
interfaces and system calls.
|
||||||
CAP_SYS_NICE.
|
Added SEE ALSO referring to new mq_getsetattr.2.
|
||||||
Add ioprio_set() IOPRIO_CLASS_RT and IOPRIO_CLASS_IDLE
|
|
||||||
scheduling classes to list op operations permitted by
|
feature_test_macros.7
|
||||||
CAP_SYS_ADMIN.
|
Stefan Puiu
|
||||||
Note effects of CAP_SYS_NICE for migrate_pages().
|
Fix typo: s/_POSIX_C_SOURCE/_POSIX_SOURCE/
|
||||||
|
|
123
Changes.old
123
Changes.old
|
@ -4016,3 +4016,126 @@ time.7
|
||||||
ld.so.8
|
ld.so.8
|
||||||
Justin Pryzby
|
Justin Pryzby
|
||||||
Remove bogus duplicate line.
|
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 <Andries.Brouwer@cwi.nl>
|
||||||
|
Johannes Weiner <root@hnaz.ath.cx>
|
||||||
|
Justin Pryzby <justinpryzby@users.sourceforge.net>
|
||||||
|
Karel Kulhavy <clock@twibright.com>
|
||||||
|
Paul Brook <paul@nowt.org>
|
||||||
|
Pavel Heimlich <tropikhajma@seznam.cz>
|
||||||
|
|
||||||
|
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().
|
||||||
|
|
29
HOWTOHELP
29
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
|
-- 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,
|
topic, or be prepared to invest the time (e.g., reading source code,
|
||||||
writing test programs) to gain that understanding. Writing test
|
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
|
uncovered while writing test programs during the preparation of
|
||||||
manual pages.
|
manual pages.
|
||||||
|
|
||||||
|
@ -270,7 +270,7 @@ request_key(2) (new in kernel 2.6.10)
|
||||||
See:
|
See:
|
||||||
Documentation/keys.txt
|
Documentation/keys.txt
|
||||||
Documentation/keys-request-key.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"
|
under "Security options"
|
||||||
|
|
||||||
restart_syscall(2) (new in kernel 2.6)
|
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
|
preadv(2), pwritev(2) (new in ?? -- see
|
||||||
http://www.lwn.net/Articles/164887/ )
|
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.
|
splice(2) Likely to be in 2.6.17.
|
||||||
See http://lwn.net/Articles/178199/
|
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
|
set_robust_list(2) Likely to be in 2.6.17
|
||||||
get_robust_list(2)
|
get_robust_list(2)
|
||||||
|
|
||||||
|
epoll_pwait(2) (probably will arrive in 2.6.18?)
|
||||||
|
|
||||||
|
|
||||||
/sys file system
|
/sys file system
|
||||||
----------------
|
----------------
|
||||||
|
@ -357,9 +357,11 @@ strptime_l(3) (since glibc 2.3.2)
|
||||||
sysv_signal(3)
|
sysv_signal(3)
|
||||||
updwtmpx(3)
|
updwtmpx(3)
|
||||||
|
|
||||||
sigandset(3), sigorset(3), sigisemptyset(3)
|
backtrace(3)
|
||||||
(perhaps on same page as sigemptyset(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_error(3)
|
||||||
argp_failure(3)
|
argp_failure(3)
|
||||||
|
@ -409,10 +411,11 @@ http://people.redhat.com/~drepper/asynchnl.pdf)
|
||||||
Various wide character functions (with their traditional equivalents
|
Various wide character functions (with their traditional equivalents
|
||||||
mentioned in parentheses):
|
mentioned in parentheses):
|
||||||
|
|
||||||
wcscoll(3) (strcoll(3))
|
wscanf(3) (scanf(3))
|
||||||
wcsxfrm(3) (strxfrm(3))
|
and fwscanf(3), swscanf(3), vfwscanf(3), vswscanf(3)
|
||||||
wcschrnul(3) (strchrnul(3))
|
wcschrnul(3) (strchrnul(3))
|
||||||
wcswcs(3) (strstr(3))
|
wcscoll(3) (strcoll(3))
|
||||||
|
wcsftime(3) (strftime(3))
|
||||||
wcstod(3) (strtod(3))
|
wcstod(3) (strtod(3))
|
||||||
wcstof(3) (strtof(3))
|
wcstof(3) (strtof(3))
|
||||||
wcstold(3) (strtold(3))
|
wcstold(3) (strtold(3))
|
||||||
|
@ -424,10 +427,8 @@ wcstoull(3) (strtoull(3))
|
||||||
wcstoq(3) (atoq(3))
|
wcstoq(3) (atoq(3))
|
||||||
wcstoq(3) (strtoq(3))
|
wcstoq(3) (strtoq(3))
|
||||||
wcstouq(3) (strtouq(3))
|
wcstouq(3) (strtouq(3))
|
||||||
wscanf(3) (scanf(3))
|
wcswcs(3) (strstr(3))
|
||||||
and fwscanf(3), swscanf(3), vfwscanf(3), vswscanf(3)
|
wcsxfrm(3) (strxfrm(3))
|
||||||
wcsftime(3) (strftime(3))
|
|
||||||
|
|
||||||
After these manual pages are written, add SEE ALSO entries
|
After these manual pages are written, add SEE ALSO entries
|
||||||
from the pages for the traditional functions to the pages
|
from the pages for the traditional functions to the pages
|
||||||
describing their wide-character equivalents.
|
describing their wide-character equivalents.
|
||||||
|
|
Loading…
Reference in New Issue