From 0fbca429ca0ed9bc7e2e00563d431ecd3e8d3694 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 5 Mar 2013 17:59:42 +0100 Subject: [PATCH] Ready for 3.48 Signed-off-by: Michael Kerrisk --- Changes | 240 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 240 insertions(+) diff --git a/Changes b/Changes index 3602abb78..f4da74d41 100644 --- a/Changes +++ b/Changes @@ -10,6 +10,31 @@ 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 +Aristeu Rozanski +Colin Walters +Cyril Hrubis +Cyrill Gorcunov +Daniel P. Berrange +David Prévot +D. Barbier +Denys Vlasenko +Flavio Leitner +Graham Gower +Ivana Varekova +Kai Kunschke +Marcela Maslanova +Marc Lehmann +Marshel Abraham +Michael Kerrisk +Nathan Stratton Treadway +Pavel Emelyanov +Peter Schiffer +Simon Heimberg +Simon Paillard +Török Edwin +Ulrich Drepper +Zack Weinberg Apologies if I missed anyone! @@ -17,19 +42,234 @@ 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.