Gidday, The Linux man-pages maintainer proudly announces: man-pages-3.48 - man pages for Linux Tarball download: http://www.kernel.org/doc/man-pages/download.html Git repository: http://git.kernel.org/pub/scm/docs/man-pages/man-pages.git Online changelog: http://man7.org/linux/man-pages/changelog.html#release_3.48 A short summary of the release is blogged at: http://linux-man-pages.blogspot.de/2013/03/man-pages-348-is-released_12.html The current version of the pages is browsable at: http://man7.org/linux/man-pages/ You are receiving this message either because: a) You contributed to the content of this release. b) You are subscribed to linux-man@xxxxxxxxxxxxxxx. c) I have information (possibly inaccurate) that you are the maintainer of a translation of the manual pages, or are the maintainer of the manual pages set in a particular distribution, or have expressed interest in helping with man-pages maintenance, or have otherwise expressed interest in being notified about man-pages releases. If you don't want to receive such messages from me, or you know of some other translator or maintainer who may want to receive such notifications, send me a message. Cheers, Michael ==================== 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@xxxxxxxxxx> Aristeu Rozanski <aris@xxxxxxxxx> Colin Walters <walters@xxxxxxxxxx> Cyril Hrubis <chrubis@xxxxxxx> Cyrill Gorcunov <gorcunov@xxxxxxxxxx> Daniel P. Berrange <berrange@xxxxxxxxxx> David Prévot <taffit@xxxxxxxxxx> D. Barbier <bouzim@xxxxxxxxx> Denys Vlasenko <vda.linux@xxxxxxxxxxxxxx> Flavio Leitner <fbl@xxxxxxxxxx> Graham Gower <graham.gower@xxxxxxxxx> Ivana Varekova <varekova@xxxxxxxxxx> Kai Kunschke <kai@xxxxxxxxxx> Marcela Maslanova <mmaslano@xxxxxxxxxx> Marc Lehmann <debian-reportbug@xxxxxxxx> Marshel Abraham <Marshel.Abraham@xxxxxxxxxxxx> Michael Kerrisk <mtk.manpages@xxxxxxxxx> Nathan Stratton Treadway <kernelbugs@xxxxxxxxxxxx> Pavel Emelyanov <xemul@xxxxxxxxxxxxx> Peter Schiffer <pschiffe@xxxxxxxxxx> Simon Heimberg <simohe@xxxxxxxxxx> Simon Paillard <spaillard@xxxxxxxxxx> Török Edwin <edwintorok@xxxxxxxxx> Ulrich Drepper <drepper@xxxxxxxxxx> Zack Weinberg <zackw@xxxxxxxxx> 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. -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Author of "The Linux Programming Interface"; http://man7.org/tlpi/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html