mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-3.49: updating Changes and Changes.old
This commit is contained in:
Michael Kerrisk
parent
11ea62f306
commit
f82bd24e46
244
Changes
244
Changes
|
|
@ -1,6 +1,6 @@
|
|||
==================== Changes in man-pages-3.48 ====================
|
||||
==================== Changes in man-pages-3.49 ====================
|
||||
|
||||
Released: 2013-03-05, Munich
|
||||
Released: ????-??-??, Munich
|
||||
|
||||
|
||||
Contributors
|
||||
|
|
@ -10,31 +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>
|
||||
Aristeu Rozanski <aris@ruivo.org>
|
||||
Colin Walters <walters@verbum.org>
|
||||
Cyril Hrubis <chrubis@suse.cz>
|
||||
Cyrill Gorcunov <gorcunov@openvz.org>
|
||||
Daniel P. Berrange <berrange@redhat.com>
|
||||
David Prévot <taffit@debian.org>
|
||||
D. Barbier <bouzim@gmail.com>
|
||||
Denys Vlasenko <vda.linux@googlemail.com>
|
||||
Flavio Leitner <fbl@redhat.com>
|
||||
Graham Gower <graham.gower@gmail.com>
|
||||
Ivana Varekova <varekova@redhat.com>
|
||||
Kai Kunschke <kai@kunfoo.org>
|
||||
Marcela Maslanova <mmaslano@redhat.com>
|
||||
Marc Lehmann <debian-reportbug@plan9.de>
|
||||
Marshel Abraham <Marshel.Abraham@in.bosch.com>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Nathan Stratton Treadway <kernelbugs@nathanst.com>
|
||||
Pavel Emelyanov <xemul@parallels.com>
|
||||
Peter Schiffer <pschiffe@redhat.com>
|
||||
Simon Heimberg <simohe@besonet.ch>
|
||||
Simon Paillard <spaillard@debian.org>
|
||||
Török Edwin <edwintorok@gmail.com>
|
||||
Ulrich Drepper <drepper@redhat.com>
|
||||
Zack Weinberg <zackw@panix.com>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
|
@ -42,234 +17,19 @@ Apologies if I missed anyone!
|
|||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
getunwind.2
|
||||
Marcela Maslanova
|
||||
New page documenting getunwind(2)
|
||||
Taken from Red Hat downstream man pages set
|
||||
Michael Kerrisk
|
||||
Much rewriting
|
||||
Some text taken from arch/ia64/kernel/unwind.c.
|
||||
|
||||
perfmonctl.2
|
||||
Ivana Varekova
|
||||
New page documenting IA-64-specific perfmonctl(2)
|
||||
Taken from Red Hat downstream man pages
|
||||
Michael Kerrisk
|
||||
Rework discussion of PFM_CREATE_CONTEXT
|
||||
Add VERSIONS and CONFORMING TO
|
||||
Note that there is no glibc wrapper
|
||||
Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
|
||||
These don't exist, and it appears they never have.
|
||||
Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
|
||||
The types that were being used don't exist!
|
||||
Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL
|
||||
|
||||
gai.conf.5
|
||||
Ulrich Drepper
|
||||
New page documenting gai.conf
|
||||
Taken from Red Hat downstream pages
|
||||
|
||||
nss.conf.5
|
||||
Ulrich Drepper
|
||||
New page describing nss.conf
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
clock_getres.2
|
||||
Cyril Hrubis
|
||||
Document CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE
|
||||
Cyril Hrubis
|
||||
Document CLOCK_BOOTTIME
|
||||
Michael Kerrisk
|
||||
Some improvements to CLOCK_BOOTTIME description
|
||||
|
||||
ptrace.2
|
||||
Denys Vlasenko
|
||||
Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends
|
||||
Document PTRACE_GETREGSET, PTRACE_SETREGSET,
|
||||
PTRACE_SEIZE, PTRACE_INTERRUPT, and PTRACE_LISTEN.
|
||||
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
fattach.2
|
||||
fdetach.2
|
||||
getmsg.2
|
||||
isastream.2
|
||||
putmsg.2
|
||||
Michael Kerrisk [Peter Schiffer]
|
||||
New link to unimplemented.2
|
||||
Taken from Red Hat downstream.
|
||||
|
||||
See https://bugzilla.redhat.com/show_bug.cgi?id=436407
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
Many pages
|
||||
Michael Kerrisk
|
||||
Global fix: remove unneeded double quotes in .SH headings
|
||||
|
||||
Many pages
|
||||
Michael Kerrisk
|
||||
Global fix: remove unneeded double quotes in .SS headings
|
||||
|
||||
Many pages
|
||||
Michael Kerrisk
|
||||
Global fix: use consistent capitalization in .SS headings
|
||||
Capitalization in .SS sections across pages (and sometimes even
|
||||
within a single page) is wildly inconsistent. Make it consistent.
|
||||
Capitalize first word in heading, but otherwise use lower case,
|
||||
except where English usage (e.g., proper nouns) or programming
|
||||
language requirements (e.g., identifier names) dictate otherwise.
|
||||
Many pages
|
||||
Michael Kerrisk [Denys Vlasenko]
|
||||
Remove double blank lines in output
|
||||
|
||||
Various pages
|
||||
Michael Kerrisk
|
||||
Fix order of SH sections
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
accept.2
|
||||
Michael Kerrisk
|
||||
NAME: Add "accept4"
|
||||
|
||||
access.2
|
||||
Colin Walters
|
||||
Note that access() may also fail for FUSE
|
||||
Since in some cases (e.g. libguestfs's guestmount) it also has the
|
||||
semantics where files can appear owned by root, but are actually
|
||||
mutable by the user, despite what one might infer from the Unix
|
||||
permissions.
|
||||
|
||||
getpeername.2
|
||||
Michael Kerrisk [Kai Kunschke]
|
||||
Clarify semantics of getpeername() for datagram sockets
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674034
|
||||
|
||||
getuid.2
|
||||
Michael Kerrisk
|
||||
Remove duplicate section heading
|
||||
|
||||
mmap.2
|
||||
Cyril Hrubis
|
||||
Add note about partial page in BUGS section
|
||||
This adds a note about Linux behavior with partial page at the end
|
||||
of the object. The problem here is that a page that contains only
|
||||
part of a file (because the file size is not multiple of PAGE_SIZE)
|
||||
stays in page cache even after the mapping is unmapped and the file
|
||||
is closed. So if some process dirties such page, other mappings
|
||||
will see the changes rather than zeroes.
|
||||
Michael Kerrisk [Török Edwin]
|
||||
Some 'flags' values require a feature test macro to be defined
|
||||
Add text to NOTES noting that some MAP_* constants are
|
||||
defined only if a suitable feature test macro is defined.
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=542601
|
||||
Cyril Hrubis
|
||||
Document EOVERFLOW error
|
||||
|
||||
open.2
|
||||
Michael Kerrisk
|
||||
Clarify list of file creation flags
|
||||
POSIX.1-2008 TC1 clarified this, so that O_CLOEXEC,
|
||||
O_DIRECTORY, and O_NOFOLLOW are also in this list.
|
||||
|
||||
prctl.2
|
||||
Cyrill Gorcunov
|
||||
Add some details for PR_GET_TID_ADDRESS
|
||||
|
||||
read.2
|
||||
Michael Kerrisk [Zack Weinberg]
|
||||
Clarify interaction of count==0 and error checking
|
||||
POSIX deliberately leaves this case open, so the man
|
||||
page should be less specific about what happens.
|
||||
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533232
|
||||
Michael Kerrisk [Marc Lehmann]
|
||||
Remove crufty text about O_NONBLOCK on files
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700529
|
||||
Michael Kerrisk
|
||||
Clarify details for seekable files
|
||||
|
||||
unimplemented.2
|
||||
Michael Kerrisk [Peter Schiffer]
|
||||
Add various STREAMS interfaces to NAME
|
||||
Taken from Red Hat downstream.
|
||||
|
||||
See https://bugzilla.redhat.com/show_bug.cgi?id=436407
|
||||
|
||||
cexp2.3
|
||||
Michael Kerrisk
|
||||
Still does not exist in glibc 2.17
|
||||
|
||||
exit.3
|
||||
Michael Kerrisk
|
||||
Note that a call to execve() clears exit handler registrations
|
||||
|
||||
getaddrinfo.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: Add gai.conf(5)
|
||||
|
||||
malloc_trim.3
|
||||
Michael Kerrisk
|
||||
Remove duplicate section title
|
||||
|
||||
printf.3
|
||||
Marshel Abraham [Graham Gower, Graham Gower]
|
||||
Fix error handling in example code
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=23282
|
||||
|
||||
pthread_yield.3
|
||||
Michael Kerrisk [Aristeu Rozanski]
|
||||
Add _GNU_SOURCE feature test macro to SYNOPSIS
|
||||
|
||||
resolver.3
|
||||
resolv.conf.5
|
||||
Michael Kerrisk [Nathan Stratton Treadway, Simon Heimberg]
|
||||
RES_DEBUG is only available if glibc is compiled with debug support
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=692136
|
||||
and https://bugzilla.kernel.org/show_bug.cgi?id=43061
|
||||
|
||||
strtol.3
|
||||
Michael Kerrisk [Peter Schiffer]
|
||||
Remove crufty text from previous fix
|
||||
|
||||
core.5
|
||||
Michael Kerrisk
|
||||
Document CONFIG_COREDUMP
|
||||
|
||||
capabilities.7
|
||||
Andrey Vagin
|
||||
Nonexistent bits are no longer shown as set in /proc/PID/status Cap*
|
||||
|
||||
inotify.7
|
||||
Michael Kerrisk
|
||||
A monitoring process can't easily distinguish events triggered by itself
|
||||
|
||||
ip.7
|
||||
Flavio Leitner [Peter Schiffer]
|
||||
Improve explanation about calling listen() or connect()
|
||||
|
||||
man-pages.7
|
||||
Michael Kerrisk
|
||||
Describe rules for capitalization in .SS headings
|
||||
|
||||
rtnetlink.7
|
||||
Pavel Emelyanov
|
||||
Add info about ability to create links with given index
|
||||
Since kernel v3.7 the RTM_NEWLINK message now accepts nonzero
|
||||
values in ifi_index field. Mention this fact in the respective
|
||||
rtnetlink.7 section.
|
||||
|
||||
socket.7
|
||||
Pavel Emelyanov
|
||||
SO_BINDTODEVICE is now readable
|
||||
SO_BINDTODEVICE is readable since since kernel 3.8.
|
||||
|
|
|
|||
277
Changes.old
277
Changes.old
|
|
@ -25814,3 +25814,280 @@ zdump.8
|
|||
Michael Kerrisk [Peter Schiffer]
|
||||
Bring up to date with zdump --help
|
||||
Patch taken from Red Hat downstream.
|
||||
|
||||
|
||||
==================== Changes in man-pages-3.48 ====================
|
||||
|
||||
Released: 2013-03-05, 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>
|
||||
Aristeu Rozanski <aris@ruivo.org>
|
||||
Colin Walters <walters@verbum.org>
|
||||
Cyril Hrubis <chrubis@suse.cz>
|
||||
Cyrill Gorcunov <gorcunov@openvz.org>
|
||||
Daniel P. Berrange <berrange@redhat.com>
|
||||
David Prévot <taffit@debian.org>
|
||||
D. Barbier <bouzim@gmail.com>
|
||||
Denys Vlasenko <vda.linux@googlemail.com>
|
||||
Flavio Leitner <fbl@redhat.com>
|
||||
Graham Gower <graham.gower@gmail.com>
|
||||
Ivana Varekova <varekova@redhat.com>
|
||||
Kai Kunschke <kai@kunfoo.org>
|
||||
Marcela Maslanova <mmaslano@redhat.com>
|
||||
Marc Lehmann <debian-reportbug@plan9.de>
|
||||
Marshel Abraham <Marshel.Abraham@in.bosch.com>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Nathan Stratton Treadway <kernelbugs@nathanst.com>
|
||||
Pavel Emelyanov <xemul@parallels.com>
|
||||
Peter Schiffer <pschiffe@redhat.com>
|
||||
Simon Heimberg <simohe@besonet.ch>
|
||||
Simon Paillard <spaillard@debian.org>
|
||||
Török Edwin <edwintorok@gmail.com>
|
||||
Ulrich Drepper <drepper@redhat.com>
|
||||
Zack Weinberg <zackw@panix.com>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
||||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
getunwind.2
|
||||
Marcela Maslanova
|
||||
New page documenting getunwind(2)
|
||||
Taken from Red Hat downstream man pages set
|
||||
Michael Kerrisk
|
||||
Much rewriting
|
||||
Some text taken from arch/ia64/kernel/unwind.c.
|
||||
|
||||
perfmonctl.2
|
||||
Ivana Varekova
|
||||
New page documenting IA-64-specific perfmonctl(2)
|
||||
Taken from Red Hat downstream man pages
|
||||
Michael Kerrisk
|
||||
Rework discussion of PFM_CREATE_CONTEXT
|
||||
Add VERSIONS and CONFORMING TO
|
||||
Note that there is no glibc wrapper
|
||||
Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
|
||||
These don't exist, and it appears they never have.
|
||||
Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
|
||||
The types that were being used don't exist!
|
||||
Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL
|
||||
|
||||
gai.conf.5
|
||||
Ulrich Drepper
|
||||
New page documenting gai.conf
|
||||
Taken from Red Hat downstream pages
|
||||
|
||||
nss.conf.5
|
||||
Ulrich Drepper
|
||||
New page describing nss.conf
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
clock_getres.2
|
||||
Cyril Hrubis
|
||||
Document CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE
|
||||
Cyril Hrubis
|
||||
Document CLOCK_BOOTTIME
|
||||
Michael Kerrisk
|
||||
Some improvements to CLOCK_BOOTTIME description
|
||||
|
||||
ptrace.2
|
||||
Denys Vlasenko
|
||||
Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends
|
||||
Document PTRACE_GETREGSET, PTRACE_SETREGSET,
|
||||
PTRACE_SEIZE, PTRACE_INTERRUPT, and PTRACE_LISTEN.
|
||||
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
fattach.2
|
||||
fdetach.2
|
||||
getmsg.2
|
||||
isastream.2
|
||||
putmsg.2
|
||||
Michael Kerrisk [Peter Schiffer]
|
||||
New link to unimplemented.2
|
||||
Taken from Red Hat downstream.
|
||||
|
||||
See https://bugzilla.redhat.com/show_bug.cgi?id=436407
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
Many pages
|
||||
Michael Kerrisk
|
||||
Global fix: remove unneeded double quotes in .SH headings
|
||||
|
||||
Many pages
|
||||
Michael Kerrisk
|
||||
Global fix: remove unneeded double quotes in .SS headings
|
||||
|
||||
Many pages
|
||||
Michael Kerrisk
|
||||
Global fix: use consistent capitalization in .SS headings
|
||||
Capitalization in .SS sections across pages (and sometimes even
|
||||
within a single page) is wildly inconsistent. Make it consistent.
|
||||
Capitalize first word in heading, but otherwise use lower case,
|
||||
except where English usage (e.g., proper nouns) or programming
|
||||
language requirements (e.g., identifier names) dictate otherwise.
|
||||
Many pages
|
||||
Michael Kerrisk [Denys Vlasenko]
|
||||
Remove double blank lines in output
|
||||
|
||||
Various pages
|
||||
Michael Kerrisk
|
||||
Fix order of SH sections
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
accept.2
|
||||
Michael Kerrisk
|
||||
NAME: Add "accept4"
|
||||
|
||||
access.2
|
||||
Colin Walters
|
||||
Note that access() may also fail for FUSE
|
||||
Since in some cases (e.g. libguestfs's guestmount) it also has the
|
||||
semantics where files can appear owned by root, but are actually
|
||||
mutable by the user, despite what one might infer from the Unix
|
||||
permissions.
|
||||
|
||||
getpeername.2
|
||||
Michael Kerrisk [Kai Kunschke]
|
||||
Clarify semantics of getpeername() for datagram sockets
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674034
|
||||
|
||||
getuid.2
|
||||
Michael Kerrisk
|
||||
Remove duplicate section heading
|
||||
|
||||
mmap.2
|
||||
Cyril Hrubis
|
||||
Add note about partial page in BUGS section
|
||||
This adds a note about Linux behavior with partial page at the end
|
||||
of the object. The problem here is that a page that contains only
|
||||
part of a file (because the file size is not multiple of PAGE_SIZE)
|
||||
stays in page cache even after the mapping is unmapped and the file
|
||||
is closed. So if some process dirties such page, other mappings
|
||||
will see the changes rather than zeroes.
|
||||
Michael Kerrisk [Török Edwin]
|
||||
Some 'flags' values require a feature test macro to be defined
|
||||
Add text to NOTES noting that some MAP_* constants are
|
||||
defined only if a suitable feature test macro is defined.
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=542601
|
||||
Cyril Hrubis
|
||||
Document EOVERFLOW error
|
||||
|
||||
open.2
|
||||
Michael Kerrisk
|
||||
Clarify list of file creation flags
|
||||
POSIX.1-2008 TC1 clarified this, so that O_CLOEXEC,
|
||||
O_DIRECTORY, and O_NOFOLLOW are also in this list.
|
||||
|
||||
prctl.2
|
||||
Cyrill Gorcunov
|
||||
Add some details for PR_GET_TID_ADDRESS
|
||||
|
||||
read.2
|
||||
Michael Kerrisk [Zack Weinberg]
|
||||
Clarify interaction of count==0 and error checking
|
||||
POSIX deliberately leaves this case open, so the man
|
||||
page should be less specific about what happens.
|
||||
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533232
|
||||
Michael Kerrisk [Marc Lehmann]
|
||||
Remove crufty text about O_NONBLOCK on files
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700529
|
||||
Michael Kerrisk
|
||||
Clarify details for seekable files
|
||||
|
||||
unimplemented.2
|
||||
Michael Kerrisk [Peter Schiffer]
|
||||
Add various STREAMS interfaces to NAME
|
||||
Taken from Red Hat downstream.
|
||||
|
||||
See https://bugzilla.redhat.com/show_bug.cgi?id=436407
|
||||
|
||||
cexp2.3
|
||||
Michael Kerrisk
|
||||
Still does not exist in glibc 2.17
|
||||
|
||||
exit.3
|
||||
Michael Kerrisk
|
||||
Note that a call to execve() clears exit handler registrations
|
||||
|
||||
getaddrinfo.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: Add gai.conf(5)
|
||||
|
||||
malloc_trim.3
|
||||
Michael Kerrisk
|
||||
Remove duplicate section title
|
||||
|
||||
printf.3
|
||||
Marshel Abraham [Graham Gower, Graham Gower]
|
||||
Fix error handling in example code
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=23282
|
||||
|
||||
pthread_yield.3
|
||||
Michael Kerrisk [Aristeu Rozanski]
|
||||
Add _GNU_SOURCE feature test macro to SYNOPSIS
|
||||
|
||||
resolver.3
|
||||
resolv.conf.5
|
||||
Michael Kerrisk [Nathan Stratton Treadway, Simon Heimberg]
|
||||
RES_DEBUG is only available if glibc is compiled with debug support
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=692136
|
||||
and https://bugzilla.kernel.org/show_bug.cgi?id=43061
|
||||
|
||||
strtol.3
|
||||
Michael Kerrisk [Peter Schiffer]
|
||||
Remove crufty text from previous fix
|
||||
|
||||
core.5
|
||||
Michael Kerrisk
|
||||
Document CONFIG_COREDUMP
|
||||
|
||||
capabilities.7
|
||||
Andrey Vagin
|
||||
Nonexistent bits are no longer shown as set in /proc/PID/status Cap*
|
||||
|
||||
inotify.7
|
||||
Michael Kerrisk
|
||||
A monitoring process can't easily distinguish events triggered by itself
|
||||
|
||||
ip.7
|
||||
Flavio Leitner [Peter Schiffer]
|
||||
Improve explanation about calling listen() or connect()
|
||||
|
||||
man-pages.7
|
||||
Michael Kerrisk
|
||||
Describe rules for capitalization in .SS headings
|
||||
|
||||
rtnetlink.7
|
||||
Pavel Emelyanov
|
||||
Add info about ability to create links with given index
|
||||
Since kernel v3.7 the RTM_NEWLINK message now accepts nonzero
|
||||
values in ifi_index field. Mention this fact in the respective
|
||||
rtnetlink.7 section.
|
||||
|
||||
socket.7
|
||||
Pavel Emelyanov
|
||||
SO_BINDTODEVICE is now readable
|
||||
SO_BINDTODEVICE is readable since since kernel 3.8.
|
||||
|
|
|
|||
Loading…
Reference in New Issue