LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

Start of 3.05

This commit is contained in:
Michael Kerrisk 2008-07-16 14:00:18 +00:00
parent 0c70adfac5
commit cf2aa9dd33
2 changed files with 465 additions and 425 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

427
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.04 ====================
==================== Changes in man-pages-3.05 ====================
Released: 2008-07-16, Konolfingen
Released: 2008-??-??, Konolfingen
Contributors
@ -9,453 +9,30 @@ Contributors
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Alain Portal <aportal@univ-montp2.fr>
Andrea Arcangeli <andrea@cpushare.com>
Andreas Mohr <andi@lisas.de>
Andrew Morgan <morgan@kernel.org>
Erik Bosman <ejbosman@cs.vu.nl>
John Brooks <aspecialj@gmail.com>
Nikanth Karthikesan <knikanth@suse.de>
Pavel Heimlich <tropikhajma@seznam.cz>
Petr Gajdos <pgajdos@suse.cz>
Sam Varshavchik <mrsam@courier-mta.com>
Serge Hallyn <serue@us.ibm.com>
Sripathi Kodi <sripathik@in.ibm.com>
Vincent Lefevre <vincent@vinc17.org>
Apologies if I missed anyone!
Web site
--------
licenses.html
mtk
A page describing the preferred licenses for new pages that
are contributed to man-pages.
New and rewritten pages
-----------------------
utimensat.2
mtk
New page documenting the utimensat() system call, new in 2.6.22,
and futimens() library function.
end.3
mtk
Documents etext, edata, and end symbols.
Newly documented interfaces in existing pages
---------------------------------------------
memchr.3
mtk
Add description of rawmemchr().
proc.5
mtk
Document /proc/config.gz (new in kernel 2.6).
mtk, based on text from Documentation/vm/sysctl.txt
Document /proc/sys/vm/oom_kill_allocating_task
(new in Linux 2.6.24).
Document /proc/sys/vm/oom_dump_tasks
(new in Linux 2.6.25).
Document /proc/sys/vm/panic_on_oom
(new in Linux 2.6.18).
New links
---------
edata.3
etext.3
mtk
Links to end.3.
futimens.3
mtk
Link to new utimensat.2.
getdate_err.3
mtk
Link to getdate.3.
h_errno.3
mtk
Link to gethostbyname.3.
optarg.3
opterr.3
optind.3
optopt.3
mtk
Links to getopt.3.
rawmemchr.3
mtk
Link to memchr.3.
sys_errlist.3
sys_nerr.3
mtk
Links to perror.3.
Global changes
--------------
Various pages
mtk
s/parameter/argument/ when talking about the things given
to a function call, for consistency with majority usage.
Various pages
mtk
s/UNIX/Unix/, when not used as part of a trademark,
for consistency with majority usage in pages.
Various pages
mtk, after a note from Alain Portal
Put SEE ALSO entries into alphabetical order.
Various pages
mtk
Remove period at end of SEE ALSO list.
Various pages
mtk, after a note by Alain Portal
Even when the CONFORMING TO section is just a list of standards,
they should be terminated by a period.
getpriority.2
MB_LEN_MAX.3
MB_CUR_MAX.3
fwide.3
mblen.3
rtime.3
st.4
proc.5
bootparam.7
man-pages.7
utf-8.7
tcp.5
mtk / Alain Portal
Small wording fixes -- express <=, <, >=, > in words when in
running text.
sched_setparam.2
sched_setscheduler.2
getgrent_r.3
hash.3
mtk
Minor rewording w.r.t. use of the term "parameter".
Typographical or grammatical errors have been corrected in several
other places. (Many, many thanks to Alain Portal!)
Changes to individual pages
---------------------------
capget.2
Andrew Morgan
Update in line with addition of file capabilities and
64-bit capability sets in kernel 2.6.2[45].
clock_nanosleep.2
mtk
Add "Link with -lrt" to SYNOPSIS.
getrusage.2
Sripathi Kodi
Document RUSAGE_THREAD, new in 2.6.26.
mtk
Improve description of RUSAGE_CHILDREN.
Add pointer to /proc/PID/stat in proc(5).
Other minor clean-ups.
ioprio_set.2
Nikanth Karthikesan
Since Linux 2.6.25, CAP_SYS_ADMIN is longer required to set
a low priority (IOPRIO_CLASS_IDLE).
mount.2
mtk
Since Linux 2.6.26, MS_RDONLY honors bind mounts.
openat.2
mtk
SEE ALSO: add utimensat(3).
prctl.2
Serge Hallyn, with some edits/input from mtk
Document PR_CAPBSET_READ and PR_CAPBSET_DROP.
Erik Bosman
Document PR_GET_TSC and PR_SET_TSC.
mtk, reviewed by Andrea Arcangeli
Document PR_SET_SECCOMP and PR_GET_SECCOMP.
mtk
PR_SET_KEEPCAPS and PR_GET_KEEPCAPS operate on a per-thread
setting, not a per-process setting.
mtk
Clarify fork(2) details for PR_SET_PDEATHSIG.
mtk
Add description of PR_SET_SECUREBITS and PR_GET_SECUREBITS,
as well as pointer to further info in capabilities(7).
mtk
PR_GET_ENDIAN returns endianness info in location pointed to by
arg2 (not as function result, as was implied by previous text).
mtk
Expand description of PR_SET_NAME and PR_GET_NAME.
mtk
RETURN VALUE: bring up to date for various options.
mtk
Various improvements in ERRORS.
mtk
Note that PR_SET_TIMING setting of PR_TIMING_TIMESTAMP is not
currently implemented.
mtk
Minor changes:
* Clarify wording for PR_GET_UNALIGN, PR_GET_FPEMU, and
PR_GET_FPEXC.
* Some reformatting of kernel version information.
* Reorder PR_GET_ENDIAN and PR_SET_ENDIAN entries.
readlinkat.2
John Brooks / mtk
Fix and reword erroneous RETURN VALUE text.
recv.2
mtk
Noted which flags appeared in Linux 2.2.
sched_setaffinity.2
mtk, after a Fedora downstream patch
Update type used for cpusetsize argument in SYNOPSIS.
select.2
Andreas Mohr / mtk
Clarify "zero timeout" case.
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=490868.
send.2
mtk
Noted which flags appeared in Linux 2.2.
sigaction.2
mtk
Document si_overrun and si_tid fields of siginfo structure.
Add some text for si_trapno field.
The si_errno field is *generally* unused.
mtk
Put descriptions of SA_* constants in alphabetical order.
signal.2
mtk
Rewrote and expanded portability discussion.
NOTES: Show the raw prototype of signal() (without use of
sighandler_t).
signalfd.2
mtk
Modify description of ssi_trapno field.
swapon.2
mtk
Fix two version number typos for MAX_SWAPFILES discussion:
s/2.6.10/2.4.10/
utime.2
mtk
SEE ALSO: add utimensat(2), futimens(3).
dl_iterate_phdr.3
Alain Portal
SEE ALSO: Add elf(5).
crypt.3
mtk, after a Fedora downstream patch
Describe additional encryption algorithms.
errno.3
mtk
Small rewrites in DESCRIPTION.
exec.3
mtk, after a note from Alain Portal
Small rewording.
exp10.3
Alain Portal
SEE ALSO: Add log10(3).
exp2.3
Alain Portal
Add C99 to CONFORMING TO.
fgetgrent.3
Alain Portal
Add references to group(5).
mtk
Minor rewordings.
SEE ALSO: add fopen(3).
fgetpwent.3
Alain Portal
Add reference to passwd(5).
mtk
Minor rewordings.
SEE ALSO: add fopen(3).
frexp.3
Alain Portal
Add C99 to CONFORMING TO.
futimes.3
mtk
SEE ALSO: remove futimesat(2); add utimensat(2).
getopt.3
mtk
Add details on initial value of optind, and note that it can
be reset (to 1) to restart scanning of an argument vector.
Add a NOTES section describing the glibc-specific behavior
when optind is reset to 0 (rather than 1).
See http://groups.google.com/group/comp.unix.programmer/browse_thread/thread/be0d0b7a07a165fb
mtk
Note glibc extensions under CONFORMING TO.
getspnam.3
mtk
Improve comments on struct spwd.
getpw.3
Alain Portal
RETURN VALUE: note that errno is set on error.
mtk
Add EINVAL error.
insque.3
mtk / Alain Portal
Minor rewordings.
log.3
Alain Portal
Remove unnecessary sentence in ERRORS.
log10.3
mtk
SEE ALSO: Add exp10(3).
offsetof.3
Alain Portal
Small wording improvement.
pow.3
Alain Portal
Remove unnecessary sentence in ERRORS.
printf.3
mtk / Alain Portal
Many small formatting fixes.
proc.5
mtk
Remove redundant summary list of files in description of
/proc/sys/kernel.
Make kernel version for /proc/sys/kernel/panic_on_oops more precise.
Make kernel version for /proc/sys/kernel/pid_max more precise.
Add Documentation/sysctl/vm.txt to SEE ALSO.
Other minor edits.
profil.3
mtk / Alain Portal
Small wording improvement.
rtime.3
mtk, after a note by Alain Portal
Clarify meaning of midnight on 1 Jan 1900/1970.
mtk
Remove netdate(1) and rdate(1) from SEE ALSO, since these pages
don't seem to exist on Linux systems.
scanf.3
Vincent Lefevre / mtk
Clarify treatment of initial white space by %% conversion
specification.
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435648.
mtk
Many small formatting fixes.
stdin.3
Alain Portal
Rename CONSIDERATIONS section to NOTES, and relocate
to appropriate place on page.
tmpfile.3
mtk, after a note by Alain Portal
Prepend "POSIX.1-2001 specifies that: " to the sentence stating
that tmpfile() may write to stdout. (AFAICS, glibc's tmpfile()
does not do this.)
ttyname.3
Alain Portal
Remove unnecessary sentence in ERRORS.
wcsdup.3
Alain Portal
Make wording more precise: the memory allocated by wcsdup(3)
*should* be freed with free(3).
wordexp.3
Alain Portal / mtk
Move example into proper EXAMPLE section.
tty_ioctl.4
mtk / Petr Gajdos
The features in the "Get and Set Window Size" subsection
require the inclusion of <sys/ioctl.h>.
capabilities.7
Serge Hallyn, plus a bit of work by mtk
Document file capabilities, per-process capability bounding set,
changed semantics for CAP_SETPCAP, and other changes in 2.6.2[45].
Add CAP_MAC_ADMIN, CAP_MAC_OVERRIDE, CAP_SETFCAP.
Various smaller fixes.
mtk, plus review by Serge Hallyn and Andrew Morgan
Add text detailing how CAP_SETPCAP (theoretically) permits -- on
pre-2.6.25 kernels, and 2.6.25 and later kernels with file
capabilities disabled -- a thread to change the capability sets
of another thread.
Add section describing rules for programmatically adjusting
thread capability sets.
Add some words describing purpose of inheritable set.
Note existence of CONFIG_SECURITY_CAPABILITIES config option.
Describe rationale for capability bounding set.
Document securebits flags (new in 2.6.26).
Remove obsolete BUGS section.
SEE ALSO: Add getcap(8), setcap(8), and various libcap pages.
mtk
Add text noting that if we set the effective flag for one
file capability, then we must also set the effective flag for all
other capabilities where the permitted or inheritable bit is set.
mtk
Since Linux 2.6.25, CAP_SYS_ADMIN is no longer required for
ioprio_set() to set IOPRIO_CLASS_IDLE class.
mtk
Reword discussion of CAP_LINUX_IMMUTABLE to be file-system neutral.
man-pages.7
mtk
A list of standards in the CONFORMING TO list should be
terminated by a period.
The list of pages in a SEE ALSO list should not be
terminated by a period.
tcp.7
mtk
Correct a detail for sysctl_tcp_adv_win_scale.
Formatting fixes.

463
Changes.old
View File

@ -12723,3 +12723,466 @@ signal.7
mtk
Update async-signal-safe function list for POSIX.1-2004 (which
adds sockatmark()).
==================== Changes in man-pages-3.04 ====================
Released: 2008-07-15, Konolfingen
Contributors
------------
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Alain Portal <aportal@univ-montp2.fr>
Andrea Arcangeli <andrea@cpushare.com>
Andreas Mohr <andi@lisas.de>
Andrew Morgan <morgan@kernel.org>
Erik Bosman <ejbosman@cs.vu.nl>
John Brooks <aspecialj@gmail.com>
Nikanth Karthikesan <knikanth@suse.de>
Pavel Heimlich <tropikhajma@seznam.cz>
Petr Gajdos <pgajdos@suse.cz>
Sam Varshavchik <mrsam@courier-mta.com>
Serge Hallyn <serue@us.ibm.com>
Sripathi Kodi <sripathik@in.ibm.com>
Vincent Lefevre <vincent@vinc17.org>
Apologies if I missed anyone!
Web site
--------
licenses.html
mtk
A page describing the preferred licenses for new pages that
are contributed to man-pages.
New and rewritten pages
-----------------------
utimensat.2
mtk
New page documenting the utimensat() system call, new in 2.6.22,
and futimens() library function.
end.3
mtk
Documents etext, edata, and end symbols.
Newly documented interfaces in existing pages
---------------------------------------------
memchr.3
mtk
Add description of rawmemchr().
proc.5
mtk
Document /proc/config.gz (new in kernel 2.6).
mtk, based on text from Documentation/vm/sysctl.txt
Document /proc/sys/vm/oom_kill_allocating_task
(new in Linux 2.6.24).
Document /proc/sys/vm/oom_dump_tasks
(new in Linux 2.6.25).
Document /proc/sys/vm/panic_on_oom
(new in Linux 2.6.18).
New links
---------
edata.3
etext.3
mtk
Links to end.3.
futimens.3
mtk
Link to new utimensat.2.
getdate_err.3
mtk
Link to getdate.3.
h_errno.3
mtk
Link to gethostbyname.3.
optarg.3
opterr.3
optind.3
optopt.3
mtk
Links to getopt.3.
rawmemchr.3
mtk
Link to memchr.3.
sys_errlist.3
sys_nerr.3
mtk
Links to perror.3.
Global changes
--------------
Various pages
mtk
s/parameter/argument/ when talking about the things given
to a function call, for consistency with majority usage.
Various pages
mtk
s/UNIX/Unix/, when not used as part of a trademark,
for consistency with majority usage in pages.
Various pages
mtk, after a note from Alain Portal
Put SEE ALSO entries into alphabetical order.
Various pages
mtk
Remove period at end of SEE ALSO list.
Various pages
mtk, after a note by Alain Portal
Even when the CONFORMING TO section is just a list of standards,
they should be terminated by a period.
getpriority.2
MB_LEN_MAX.3
MB_CUR_MAX.3
fwide.3
mblen.3
rtime.3
st.4
proc.5
bootparam.7
man-pages.7
utf-8.7
tcp.5
mtk / Alain Portal
Small wording fixes -- express <=, <, >=, > in words when in
running text.
sched_setparam.2
sched_setscheduler.2
getgrent_r.3
hash.3
mtk
Minor rewording w.r.t. use of the term "parameter".
Typographical or grammatical errors have been corrected in several
other places. (Many, many thanks to Alain Portal!)
Changes to individual pages
---------------------------
capget.2
Andrew Morgan
Update in line with addition of file capabilities and
64-bit capability sets in kernel 2.6.2[45].
clock_nanosleep.2
mtk
Add "Link with -lrt" to SYNOPSIS.
getrusage.2
Sripathi Kodi
Document RUSAGE_THREAD, new in 2.6.26.
mtk
Improve description of RUSAGE_CHILDREN.
Add pointer to /proc/PID/stat in proc(5).
Other minor clean-ups.
ioprio_set.2
Nikanth Karthikesan
Since Linux 2.6.25, CAP_SYS_ADMIN is longer required to set
a low priority (IOPRIO_CLASS_IDLE).
mount.2
mtk
Since Linux 2.6.26, MS_RDONLY honors bind mounts.
openat.2
mtk
SEE ALSO: add utimensat(3).
prctl.2
Serge Hallyn, with some edits/input from mtk
Document PR_CAPBSET_READ and PR_CAPBSET_DROP.
Erik Bosman
Document PR_GET_TSC and PR_SET_TSC.
mtk, reviewed by Andrea Arcangeli
Document PR_SET_SECCOMP and PR_GET_SECCOMP.
mtk
PR_SET_KEEPCAPS and PR_GET_KEEPCAPS operate on a per-thread
setting, not a per-process setting.
mtk
Clarify fork(2) details for PR_SET_PDEATHSIG.
mtk
Add description of PR_SET_SECUREBITS and PR_GET_SECUREBITS,
as well as pointer to further info in capabilities(7).
mtk
PR_GET_ENDIAN returns endianness info in location pointed to by
arg2 (not as function result, as was implied by previous text).
mtk
Expand description of PR_SET_NAME and PR_GET_NAME.
mtk
RETURN VALUE: bring up to date for various options.
mtk
Various improvements in ERRORS.
mtk
Note that PR_SET_TIMING setting of PR_TIMING_TIMESTAMP is not
currently implemented.
mtk
Minor changes:
* Clarify wording for PR_GET_UNALIGN, PR_GET_FPEMU, and
PR_GET_FPEXC.
* Some reformatting of kernel version information.
* Reorder PR_GET_ENDIAN and PR_SET_ENDIAN entries.
readlinkat.2
John Brooks / mtk
Fix and reword erroneous RETURN VALUE text.
recv.2
mtk
Noted which flags appeared in Linux 2.2.
sched_setaffinity.2
mtk, after a Fedora downstream patch
Update type used for cpusetsize argument in SYNOPSIS.
select.2
Andreas Mohr / mtk
Clarify "zero timeout" case.
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=490868.
send.2
mtk
Noted which flags appeared in Linux 2.2.
sigaction.2
mtk
Document si_overrun and si_tid fields of siginfo structure.
Add some text for si_trapno field.
The si_errno field is *generally* unused.
mtk
Put descriptions of SA_* constants in alphabetical order.
signal.2
mtk
Rewrote and expanded portability discussion.
NOTES: Show the raw prototype of signal() (without use of
sighandler_t).
signalfd.2
mtk
Modify description of ssi_trapno field.
swapon.2
mtk
Fix two version number typos for MAX_SWAPFILES discussion:
s/2.6.10/2.4.10/
utime.2
mtk
SEE ALSO: add utimensat(2), futimens(3).
dl_iterate_phdr.3
Alain Portal
SEE ALSO: Add elf(5).
crypt.3
mtk, after a Fedora downstream patch
Describe additional encryption algorithms.
errno.3
mtk
Small rewrites in DESCRIPTION.
exec.3
mtk, after a note from Alain Portal
Small rewording.
exp10.3
Alain Portal
SEE ALSO: Add log10(3).
exp2.3
Alain Portal
Add C99 to CONFORMING TO.
fgetgrent.3
Alain Portal
Add references to group(5).
mtk
Minor rewordings.
SEE ALSO: add fopen(3).
fgetpwent.3
Alain Portal
Add reference to passwd(5).
mtk
Minor rewordings.
SEE ALSO: add fopen(3).
frexp.3
Alain Portal
Add C99 to CONFORMING TO.
futimes.3
mtk
SEE ALSO: remove futimesat(2); add utimensat(2).
getopt.3
mtk
Add details on initial value of optind, and note that it can
be reset (to 1) to restart scanning of an argument vector.
Add a NOTES section describing the glibc-specific behavior
when optind is reset to 0 (rather than 1).
See http://groups.google.com/group/comp.unix.programmer/browse_thread/thread/be0d0b7a07a165fb
mtk
Note glibc extensions under CONFORMING TO.
getspnam.3
mtk
Improve comments on struct spwd.
getpw.3
Alain Portal
RETURN VALUE: note that errno is set on error.
mtk
Add EINVAL error.
insque.3
mtk / Alain Portal
Minor rewordings.
log.3
Alain Portal
Remove unnecessary sentence in ERRORS.
log10.3
mtk
SEE ALSO: Add exp10(3).
offsetof.3
Alain Portal
Small wording improvement.
pow.3
Alain Portal
Remove unnecessary sentence in ERRORS.
printf.3
mtk / Alain Portal
Many small formatting fixes.
proc.5
mtk
Remove redundant summary list of files in description of
/proc/sys/kernel.
Make kernel version for /proc/sys/kernel/panic_on_oops more precise.
Make kernel version for /proc/sys/kernel/pid_max more precise.
Add Documentation/sysctl/vm.txt to SEE ALSO.
Other minor edits.
profil.3
mtk / Alain Portal
Small wording improvement.
rtime.3
mtk, after a note by Alain Portal
Clarify meaning of midnight on 1 Jan 1900/1970.
mtk
Remove netdate(1) and rdate(1) from SEE ALSO, since these pages
don't seem to exist on Linux systems.
scanf.3
Vincent Lefevre / mtk
Clarify treatment of initial white space by %% conversion
specification.
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435648.
mtk
Many small formatting fixes.
stdin.3
Alain Portal
Rename CONSIDERATIONS section to NOTES, and relocate
to appropriate place on page.
tmpfile.3
mtk, after a note by Alain Portal
Prepend "POSIX.1-2001 specifies that: " to the sentence stating
that tmpfile() may write to stdout. (AFAICS, glibc's tmpfile()
does not do this.)
ttyname.3
Alain Portal
Remove unnecessary sentence in ERRORS.
wcsdup.3
Alain Portal
Make wording more precise: the memory allocated by wcsdup(3)
*should* be freed with free(3).
wordexp.3
Alain Portal / mtk
Move example into proper EXAMPLE section.
tty_ioctl.4
mtk / Petr Gajdos
The features in the "Get and Set Window Size" subsection
require the inclusion of <sys/ioctl.h>.
capabilities.7
Serge Hallyn, plus a bit of work by mtk
Document file capabilities, per-process capability bounding set,
changed semantics for CAP_SETPCAP, and other changes in 2.6.2[45].
Add CAP_MAC_ADMIN, CAP_MAC_OVERRIDE, CAP_SETFCAP.
Various smaller fixes.
mtk, plus review by Serge Hallyn and Andrew Morgan
Add text detailing how CAP_SETPCAP (theoretically) permits -- on
pre-2.6.25 kernels, and 2.6.25 and later kernels with file
capabilities disabled -- a thread to change the capability sets
of another thread.
Add section describing rules for programmatically adjusting
thread capability sets.
Add some words describing purpose of inheritable set.
Note existence of CONFIG_SECURITY_CAPABILITIES config option.
Describe rationale for capability bounding set.
Document securebits flags (new in 2.6.26).
Remove obsolete BUGS section.
SEE ALSO: Add getcap(8), setcap(8), and various libcap pages.
mtk
Add text noting that if we set the effective flag for one
file capability, then we must also set the effective flag for all
other capabilities where the permitted or inheritable bit is set.
mtk
Since Linux 2.6.25, CAP_SYS_ADMIN is no longer required for
ioprio_set() to set IOPRIO_CLASS_IDLE class.
mtk
Reword discussion of CAP_LINUX_IMMUTABLE to be file-system neutral.
man-pages.7
mtk
A list of standards in the CONFORMING TO list should be
terminated by a period.
The list of pages in a SEE ALSO list should not be
terminated by a period.
tcp.7
mtk
Correct a detail for sysctl_tcp_adv_win_scale.
Formatting fixes.