Start of man-pages-3.51: updating Changes and Changes.old

This commit is contained in:
Michael Kerrisk 2013-03-15 08:43:33 +01:00
parent 59c7c8500d
commit ac9074cb9b
2 changed files with 182 additions and 145 deletions

154
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.50 ====================
==================== Changes in man-pages-3.51 ====================
Released: 2013-03-15, Munich
Released: ????-??-??, Munich
Contributors
@ -10,18 +10,6 @@ The following people contributed patches/fixes or (noted in brackets
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
Andrey Vagin <avagin@openvz.org>
Bernhard Kuemel <bernhard@bksys.at>
Elie De Brauwer <eliedebrauwer@gmail.com>
Erik Saule <erik.saule@bmi.osu.edu>
Florian Weimer <fweimer@bfk.de>
Friedrich Delgado Friedrichs <friedel@nomaden.org>
Jonathan Nieder <jrnieder@gmail.com>
Jose Luis Domingo Lopez <debian@24x7linux.com>
Mark R Bannister <mark@proseconsulting.co.uk>
Michael Kerrisk <mtk.manpages@gmail.com>
Sam Varshavchik <mrsam@courier-mta.com>
Simon Paillard <spaillard@debian.org>
Apologies if I missed anyone!
@ -29,143 +17,19 @@ Apologies if I missed anyone!
New and rewritten pages
-----------------------
canonicalize_file_name.3
Michael Kerrisk
Rewrite page, adding much more detail
Newly documented interfaces in existing pages
---------------------------------------------
New and changed links
---------------------
Global changes
--------------
Various pages
Michael Kerrisk
Global fix: s/END_LICENSE/LICENSE_END/
Various pages
Michael Kerrisk
Global fix: s/bitmask/bit mask/
Changes to individual pages
---------------------------
getent.1
Mark R Bannister
netgroup description incorrectly refers to initgroups
capget.2
Michael Kerrisk
Update URL for libcap
fork.2
Michael Kerrisk
Port access permission bits (ioperm()) are turned off in the child
futex.2
Michael Kerrisk
'timeout' is a minimum duration that the call will wait, not a maximum
ioperm.2
Michael Kerrisk
Note that iopl() level of 3 is needed to access ports
Michael Kerrisk
'num' is *bits* not bytes!
Michael Kerrisk
Linux 2.6.8 lifted the port limit to 65,536
See http://article.gmane.org/gmane.linux.kernel/202624/
From: Stas Sergeev <stsp <at> aknet.ru>
Subject: [patch][rfc] Larger IO bitmap
Date: 2004-05-07 19:55:03 GMT
Michael Kerrisk
ioperm() operates on the calling *thread* (not process)
Michael Kerrisk
Clarify meaning of 'turn_on' argument
Plus form formatting fixes.
Michael Kerrisk
Clarify that default state of permission bits in child is off
Michael Kerrisk
NOTES: add mention of /proc/ioports
Michael Kerrisk
SEE ALSO: add outb(2)
iopl.2
Michael Kerrisk
CAP_SYS_RAWIO is required to *raise* the I/O privilege level
Michael Kerrisk
Clarify that the two least significant bits of 'level' are what matter
Michael Kerrisk
SEE ALSO: add outb(2)
syscalls.2
Michael Kerrisk
Add version information for all (other) syscalls
Michael Kerrisk
Add perfmonctl(2)
futimes.3
Michael Kerrisk [Jonathan Nieder]
ERRORS: Add ENOSYS for lutimes()
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=620746
getpass.3
Michael Kerrisk [Erik Saule]
Suggest use of the ECHO flag as an alternative
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=644261
realpath.3
Michael Kerrisk
Document GNU extensions for EACCES and ENOENT errors
stdarg.3
Michael Kerrisk [Friedrich Delgado Friedrichs]
Describe va_copy()
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=575077
termios.3
Michael Kerrisk [Bernhard Kuemel]
Mention that noncanonical mode does not do input processing
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=643854
random.4
Elie De Brauwer
Document write and document the ioctl interface of /dev/random
The update consists out of two parts:
- a minor thing which just documents what happens if a write to
/dev/(u)random is performed, which is used in the example
script but not explicitly mentioned.
- the other (biggest) part is the documentation of the ioctl()
interface which /dev/(u)random exposes. This ioctl() lives in
drivers/char/random.c and the primitives can be found in
include/linux/random.h
One comment remains, there used to be an RNDGETPOOL ioctl() which
disappeared in v2.6.9. I found two patches on the net:
- http://www.kernel.org/pub/linux/kernel/people/akpm/patches/2.6/2.6.8.1/2.6.8.1-mm4/broken-out/dev-random-remove-rndgetpool-ioctl.patch
- https://lkml.org/lkml/2004/3/25/168
But as far as I can tell the first one got applied but the 2nd
one seems more correct. The result is that even today one can
still find traces of the RNDGETPOOL ioctl() in the header files.
Is this there for historical reasons or because it might break
userspace, even though using it will just give an EINVAL.
bootparam.7
Jose Luis Domingo Lopez
Document 'rootfstype' option
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182014
capabilities.7
Michael Kerrisk
Add various pieces under CAP_SYS_RAWIO
Info obtained by grepping the kernel source.
Michael Kerrisk
Add CAP_SYS_RESOURCE /proc/PID/oom_score_adj case
netlink.7
Andrey Vagin
Add a note about broadcast messages to multiple groups
socket.7
Michael Kerrisk [Florian Weimer]
Define _GNU_SOURCE to obtain the definition of 'struct ucred'
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572210

View File

@ -26149,3 +26149,176 @@ Various pages
remove it from all pages
Michael Kerrisk
Remove "-*- nroff -*-" comment at top of source
==================== Changes in man-pages-3.50 ====================
Released: 2013-03-15, Munich
Contributors
------------
The following people contributed patches/fixes or (noted in brackets
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
Andrey Vagin <avagin@openvz.org>
Bernhard Kuemel <bernhard@bksys.at>
Elie De Brauwer <eliedebrauwer@gmail.com>
Erik Saule <erik.saule@bmi.osu.edu>
Florian Weimer <fweimer@bfk.de>
Friedrich Delgado Friedrichs <friedel@nomaden.org>
Jonathan Nieder <jrnieder@gmail.com>
Jose Luis Domingo Lopez <debian@24x7linux.com>
Mark R Bannister <mark@proseconsulting.co.uk>
Michael Kerrisk <mtk.manpages@gmail.com>
Sam Varshavchik <mrsam@courier-mta.com>
Simon Paillard <spaillard@debian.org>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
canonicalize_file_name.3
Michael Kerrisk
Rewrite page, adding much more detail
Global changes
--------------
Various pages
Michael Kerrisk
Global fix: s/END_LICENSE/LICENSE_END/
Various pages
Michael Kerrisk
Global fix: s/bitmask/bit mask/
Changes to individual pages
---------------------------
getent.1
Mark R Bannister
netgroup description incorrectly refers to initgroups
capget.2
Michael Kerrisk
Update URL for libcap
fork.2
Michael Kerrisk
Port access permission bits (ioperm()) are turned off in the child
futex.2
Michael Kerrisk
'timeout' is a minimum duration that the call will wait, not a maximum
ioperm.2
Michael Kerrisk
Note that iopl() level of 3 is needed to access ports
Michael Kerrisk
'num' is *bits* not bytes!
Michael Kerrisk
Linux 2.6.8 lifted the port limit to 65,536
See http://article.gmane.org/gmane.linux.kernel/202624/
From: Stas Sergeev <stsp <at> aknet.ru>
Subject: [patch][rfc] Larger IO bitmap
Date: 2004-05-07 19:55:03 GMT
Michael Kerrisk
ioperm() operates on the calling *thread* (not process)
Michael Kerrisk
Clarify meaning of 'turn_on' argument
Plus form formatting fixes.
Michael Kerrisk
Clarify that default state of permission bits in child is off
Michael Kerrisk
NOTES: add mention of /proc/ioports
Michael Kerrisk
SEE ALSO: add outb(2)
iopl.2
Michael Kerrisk
CAP_SYS_RAWIO is required to *raise* the I/O privilege level
Michael Kerrisk
Clarify that the two least significant bits of 'level' are what matter
Michael Kerrisk
SEE ALSO: add outb(2)
syscalls.2
Michael Kerrisk
Add version information for all (other) syscalls
Michael Kerrisk
Add perfmonctl(2)
futimes.3
Michael Kerrisk [Jonathan Nieder]
ERRORS: Add ENOSYS for lutimes()
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=620746
getpass.3
Michael Kerrisk [Erik Saule]
Suggest use of the ECHO flag as an alternative
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=644261
realpath.3
Michael Kerrisk
Document GNU extensions for EACCES and ENOENT errors
stdarg.3
Michael Kerrisk [Friedrich Delgado Friedrichs]
Describe va_copy()
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=575077
termios.3
Michael Kerrisk [Bernhard Kuemel]
Mention that noncanonical mode does not do input processing
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=643854
random.4
Elie De Brauwer
Document write and document the ioctl interface of /dev/random
The update consists out of two parts:
- a minor thing which just documents what happens if a write to
/dev/(u)random is performed, which is used in the example
script but not explicitly mentioned.
- the other (biggest) part is the documentation of the ioctl()
interface which /dev/(u)random exposes. This ioctl() lives in
drivers/char/random.c and the primitives can be found in
include/linux/random.h
One comment remains, there used to be an RNDGETPOOL ioctl() which
disappeared in v2.6.9. I found two patches on the net:
- http://www.kernel.org/pub/linux/kernel/people/akpm/patches/2.6/2.6.8.1/2.6.8.1-mm4/broken-out/dev-random-remove-rndgetpool-ioctl.patch
- https://lkml.org/lkml/2004/3/25/168
But as far as I can tell the first one got applied but the 2nd
one seems more correct. The result is that even today one can
still find traces of the RNDGETPOOL ioctl() in the header files.
Is this there for historical reasons or because it might break
userspace, even though using it will just give an EINVAL.
bootparam.7
Jose Luis Domingo Lopez
Document 'rootfstype' option
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182014
capabilities.7
Michael Kerrisk
Add various pieces under CAP_SYS_RAWIO
Info obtained by grepping the kernel source.
Michael Kerrisk
Add CAP_SYS_RESOURCE /proc/PID/oom_score_adj case
netlink.7
Andrey Vagin
Add a note about broadcast messages to multiple groups
socket.7
Michael Kerrisk [Florian Weimer]
Define _GNU_SOURCE to obtain the definition of 'struct ucred'
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572210