Justin Pryzby <justinpryzby@users.sourceforge.net>
Ludovic Courtes <ludovic.courtes@laas.fr>
Mike Frysinger <vapier@gentoo.org>
-Nicolas François <nicolas.francois@centraliens.net>
+Nicolas François <nicolas.francois@centraliens.net>
Norbert Buchmuller <norbi.spam@nix.hu>
Paul Brook <paul@nowt.org>
Ramiro Aceves <ea1abz@gmail.com>
Hasso Tepper <hasso@estpak.ee>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Martin (Joey) Schulze <joey@infodrom.org>
-Nicolas François <nicolas.francois@centraliens.net>
+Nicolas François <nicolas.francois@centraliens.net>
Paul Brook <paul@nowt.org>
Siward de Groot <siward@wanadoo.nl>
Steve Beattie <sbeattie@suse.de>
Helmut Grohne <helmut@subdivi.de>
Ivana Varekova <varekova@redhat.com>
Thomas Huriaux <thomas.huriaux@gmail.com>
-Ville Skyttä <ville.skytta@iki.fi>
+Ville Skyttä <ville.skytta@iki.fi>
Apologies if I missed anyone!
Various formatting problems found as a result of reviewing the
following command were fixed.
- for a in $(wc man?/*.?| awk '$1 > 2 ' | grep -v total); do
+ for a in $(wc -l man?/*.?| awk '$1 > 2 {print $2}' | grep -v total); do
echo $a; groff -Tascii -wmac -mman $a > /dev/null;
done 2>&1 | less
---------------------------
ldd.1
- Ville Skyttä
+ Ville Skyttä
Document "-u" option.
chdir.2
Christoph Hellwig <hch@lst.de>
Chuck Ebbert <76306.1226@compuserve.com>
Samuel Thibault <samuel.thibault@ens-lyon.org>
-Toralf Förster <toralf.foerster@gmx.de>
+Toralf Förster <toralf.foerster@gmx.de>
Apologies if I missed anyone!
Julien Blache <jblache@debian.org>
Julien Cristau <jcristau@debian.org>
Justin Pryzby <justinpryzby@users.sourceforge.net>
-Martín Ferrari <martin.ferrari@gmail.com>
+Martín Ferrari <martin.ferrari@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Nick Piggin <npiggin@suse.de>
Nick Pollitt <npollitt@mvista.com>
-Nicolas François <nicolas.francois@centraliens.net>
-P
ádraig Brady <P@draigBrady.com>
+Nicolas François <nicolas.francois@centraliens.net>
+P
ádraig Brady <P@draigBrady.com>
Premysl Hruby <dfenze@gmail.com>
Reuben Thomas <rrt@sc3d.org>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Fixed consecutive duplicate word typos on a number of pages.
Typographical or grammatical errors have been corrected in several
-places. (Special thanks to Nicolas François!)
+places. (Special thanks to Nicolas François!)
Changes to individual pages
32-bit system is actually EFBIG, not EOVERFLOW.
posix_fadvise.2
- Pádraig Brady
+ Pádraig Brady
Fix RETURN VALUE description: returns error number of failure.
rename.2
Small rewording of explanation of "atomically".
signal.2
- Nicolas François
+ Nicolas François
Fix incorrect argument name in DESCRIPTION.
mtk
Small wording improvement.
socket.2
- Nicolas François
+ Nicolas François
Add reference to ipv6.7 page.
socketcall.2
- Nicolas François
+ Nicolas François
Fix .TH line.
splice.2
Small wording clarification.
symlink.2
- mtk / Nicolas François
+ mtk / Nicolas François
Removed cryptic text under CONFORMING to referring to
"open(2) and NFS". There is no relevant text in open.2 as
far as I (mtk) can see.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=352139
glob.3
- Nicolas François
+ Nicolas François
Fix PROTOTYPE.
inet_network.3
Clarified description of inet_network().
log.3
- Nicolas François
+ Nicolas François
Fix .TH line.
log10.3
- Nicolas François
+ Nicolas François
Fix .TH line.
malloc.3
- Nicolas François
+ Nicolas François
Small rewording to mention calloc().
posix_openpt.3
- Martín Ferrari
+ Martín Ferrari
Fix return type in SYNOPSIS; as per
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400971
Needs _XOPEN_SOURCE == 600; as per
Add "#define _REGEX_RE_COMP" to SYNOPSIS.
regex.3
- Nicolas François
+ Nicolas François
Fix .TH line.
termios.3
Document _REENTRANT and _THREAD_SAFE.
mdoc.7
- mtk / Nicolas François
+ mtk / Nicolas François
Remove CONFIGURATION section, since this does not seem to be
true for Linux.
svipc.7
- Nicolas François
+ Nicolas François
Fix data types in associated data structures;
remove nonexistent semzcnt and semncnt fields.
Jeff Schroeder <jeffschroeder@computer.org>
Joey (Martin) Schulze <joey@infodrom.org>
Justin Pryzby <justinpryzby@users.sourceforge.net>
-Loïc Minier <lool@dooz.org>
+Loïc Minier <lool@dooz.org>
Michael Gehring <mg@ebfe.org>
Serge van den Boom <svdb@stack.nl>
Stefan Puiu <stefanpuiuro@yahoo.com>
Reformatted headings; minor rewrites.
socket.7
- Loïc Minier <lool@dooz.org>
+ Loïc Minier <lool@dooz.org>
Document argument type for SO_REUSEADDR.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=255881
Justin Pryzby <justinpryzby@users.sourceforge.net>
Marc Boyer <marc.boyer@enseeiht.fr>
Martin (Joey) Schulze <joey@infodrom.org>
-Martin Röhricht <martin@roehricht.info>
+Martin Röhricht <martin@roehricht.info>
Patrick Mansfield <patmans@us.ibm.com>
Pierre Habouzit <madcoder@debian.org>
Stepan Kasal <kasal@ucw.cz>
Changed link to point to uname.2 (instead of obsolete.2).
sched_setaffinity.2
- Martin Röhricht
+ Martin Röhricht
Added _GNU_SOURCE to SYNOPSIS.
semctl.2
Anton Blanchard <anton@samba.org>
Ari Entlich <lmage11@twcny.rr.com>
Carsten Emde <Carsten.Emde@osadl.org>
-François Diakhate <diakhate@enseirb.fr>
+François Diakhate <diakhate@enseirb.fr>
Geoff Clare <gclare@gclare.org.uk>
Jon Burgess <jburgess777@googlemail.com>
Julien Cristau <jcristau@debian.org>
Maxime Vaudequin <maxime.vaudequin@gmail.com>
Michael Prokop <mika@grml.org>
Mike Frysinger <vapier@gentoo.org>
-Nicolas François <nicolas.francois@centraliens.net>
+Nicolas François <nicolas.francois@centraliens.net>
Nicolas George <nicolas.george@ens.fr>
Paul Brook <paul@nowt.org>
Reuben Thomas <rrt@sc3d.org>
Order errors under ERRORS alphabetically.
Various pages
- Nicolas François
+ Nicolas François
Spelling and formatting fixes, as per
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=439560
mmap.2
mprotect.2
- François Diakhate
+ François Diakhate
Add text noting that PROT_WRITE may (and on x86 does)
imply PROT_READ.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=441387
Add vsyslog to NAME section.
termios.3
- Nicolas François
+ Nicolas François
Fix XCASE feature test macro description.
wcsspn.3
man.7
mdoc.7
mdoc.samples.7
- mtk / Nicolas François
+ mtk / Nicolas François
Nowadays tmac.XXX are called XXX.tmac.
pthreads.7
Justin Pryzby <jpryzby+d@quoininc.com>
Maxime Vaudequin <maxime.vaudequin@gmail.com>
Mike Frysinger <vapier@gentoo.org>
-Nicolas François <nicolas.francois@centraliens.net>
-P
ádraig Brady <P@draigBrady.com>
+Nicolas François <nicolas.francois@centraliens.net>
+P
ádraig Brady <P@draigBrady.com>
Sam Varshavchik <mrsam@courier-mta.com>
Timo Juhani Lindfors <timo.lindfors@iki.fi>
Ulrich Drepper <drepper@redhat.com>
Linux 2.6.22 added support on Alpha for PR_SET_UNALIGN.
ptrace.2
- Nicolas François / mtk
+ Nicolas François / mtk
s/PTRACE_POKEUSR/PTRACE_POKEUSER/
s/PTRACE_PEEKUSR/PTRACE_PEEKUSER/
Remove SEE ALSO references to getipnodebyname.3 and
getipnodebyaddr.3.
- Pádraig Brady / mtk / Ulrich Drepper
+ Pádraig Brady / mtk / Ulrich Drepper
Point out that the functions described on this page
are made obsolete by getaddrinfo(3) and getnameinfo(3).
Alain Portal <aportal@univ-montp2.fr>
Andries E. Brouwer <Andries.Brouwer@cwi.nl>
J. Bruce Fields <bfields@citi.umich.edu>
-David Härdeman <david@hardeman.nu>
+David Härdeman <david@hardeman.nu>
Jeremy Kerr <jk@ozlabs.org>
Luke Browning <lukebr@linux.vnet.ibm.com>
Mats Wichmann <mats.d.wichmann@intel.com>
mq_notify.3
makecontext.3
fmemopen.3
- David Härdeman / mtk
+ David Härdeman / mtk
Rename error handling function in example program
(s/die/handle_error/).
been incorporated in changes in this release:
Alain Portal <aportal@univ-montp2.fr>
-P
ádraig Brady <P@draigBrady.com>
+P
ádraig Brady <P@draigBrady.com>
Reuben Thomas <rrt@sc3d.org>
Apologies if I missed anyone!
Andries E. Brouwer <Andries.Brouwer@cwi.nl>
Chris Heath <chris@heathens.co.nz>
Davide Libenzi <davidel@xmailserver.org>
-Fernando Luis Vázquez Cao <fernando@oss.ntt.co.jp>
+Fernando Luis Vázquez Cao <fernando@oss.ntt.co.jp>
Heikki Orsila <shdl@zakalwe.fi>
Jeremy Kerr <jk@ozlabs.org>
Justin Pryzby <justinpryzby@users.sourceforge.net>
-Lasse Kärkkäinen <tronic@trn.iki.fi>
+Lasse Kärkkäinen <tronic@trn.iki.fi>
Michael Haardt <michael@moria.de>
Mike Frysinger <vapier@gentoo.org>
Ron Burk <ronburk@gmail.com>
Remove some duplicated text.
malloc.3
- Lasse Kärkkäinen / Mike Frysinger / mtk
+ Lasse Kärkkäinen / Mike Frysinger / mtk
Clarify description of realloc() behavior for
((size == 0) && (ptr != NULL)).
s/stdlib.h/fcntl.h/ in SYNOPSIS.
proc.5
- Fernando Luis Vázquez Cao
+ Fernando Luis Vázquez Cao
Update /proc/[number]/cmdline description.
It used to be true that the command line arguments were
not accessible when the process had been swapped out.
Karsten Weiss <K.Weiss@science-computing.de>
Martin Pitt <mpitt@debian.org>
Marty Leisner <leisner@rochester.rr.com>
-Nicolas François <nicolas.francois@trialog.com>
+Nicolas François <nicolas.francois@trialog.com>
Nick Piggin <npiggin@suse.de>
Petter Reinholdtsen <pere@hungry.com>
Reuben Thomas <rrt@sc3d.org>
Reformat kernel version information for flags.
Typographical or grammatical errors have been corrected in several places.
-(Special thanks to Nicolas François.)
+(Special thanks to Nicolas François.)
New pages
Add "Link with -lrt" to SYNOPSIS.
backtrace.3
- Nicolas François
+ Nicolas François
s/backtrace_symbols/backtrace_symbols_fd/ in one sentence.
mtk
Fix bogus reference to variable 'strings': should be:
initstate_r(3), setkey_r(3), setstate_r(3) are now documented.
utmp.5
- Nicolas François
+ Nicolas François
Small rewording.
resolv.conf.5
- Nicolas François
+ Nicolas François
gethostname() is in Section 2, not section 3.
ascii.7
Fix rendering of ' (backtick) and apostrophe (') in tables
charsets.7
- Nicolas François
+ Nicolas François
s/unicode.com/unicode.org/
credentials.7
SEE ALSO: add time(7)
Typographical or grammatical errors have been corrected in several places.
-(Special thanks to Nicolas François and Alain Portal.)
+(Special thanks to Nicolas François and Alain Portal.)
Changes to individual pages
CONFIG_PRINTK.
utime.2
- Nicolas François
+ Nicolas François
Clarify description of 'times' array for utimes().
adjtime.3
Suka <sukadev@us.ibm.com>
Timothy S. Nelson <wayland@wayland.id.au>
Tolga Dalman <tdalman@project-psi.org>
-Török Edwin <edwintorok@gmail.com>
+Török Edwin <edwintorok@gmail.com>
Apologies if I missed anyone!
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
-Andr
é Goddard Rosa <andre.goddard@gmail.com>
+Andr
é Goddard Rosa <andre.goddard@gmail.com>
George Spelvin <linux@horizon.com>
Pavel Heimlich <tropikhajma@seznam.cz>
Sam Varshavchik <mrsam@courier-mta.com>
Clarify closedir()'s treatment of underlying file descriptor.
tsearch.3
- André Goddard Rosa
+ André Goddard Rosa
Fix memory leak in example program.
Add use of tdestroy to example program.
mtk
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
-Andr
é Goddard Rosa <andre.goddard@gmail.com>
+Andr
é Goddard Rosa <andre.goddard@gmail.com>
Eugene V. Lyubimkin <jackyf.devel@gmail.com>
Gergely Soos <sogerc1@gmail.com>
Kirill A. Shutemov <kirill@shutemov.name>
Maxin B. John <maxin.john@ap.sony.com>
Maxin John <maxin.john@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
-Nicolas François <nicolas.francois@centraliens.net>
+Nicolas François <nicolas.francois@centraliens.net>
Pavel Heimlich <tropikhajma@seznam.cz>
-Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
+Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
Sam Varshavchik <mrsam@courier-mta.com>
Apologies if I missed anyone!
Add EAGAIN error.
move_pages.2
- Nicolas François
+ Nicolas François
Make a detail of EPERM error more precise
mount.2
that glibc does provide the required pieces).
recv.2
- Nicolas François
+ Nicolas François
Move kernel version number to first mention to MSG_ERRQUEUE.
semop.2
Make it clear that the POSIX.1 revision that is likely
to affect the feature test macro requirements for futimens()
is POSIX.1-2008.
- Nicolas François
+ Nicolas François
Make various wordings a little more precise.
The times argument point to *an array of* structures, and the
man-page should say that consistently.
for example.)
atan2.3
- Nicolas François
+ Nicolas François
Fix error in description of range or return value
In recent changes to the man page, mtk accidentally changed
the description of the return value range to -pi/2..pi/2;
the correct range is -pi..pi.
cmsg.3
- Nicolas François
+ Nicolas François
Add parentheses after macro names.
ctime.3
Minor rewording of mktime() description.
floor.3
- Nicolas François
+ Nicolas François
floor.3: Fix error in description: s/smallest/largest/
hsearch.3
- André Goddard Rosa
+ André Goddard Rosa
Call hdestroy() after using hash table created by hcreate(),
for the sake of completeness
This info is useful for users of strace(1).
nextafter.3
- Nicolas François
+ Nicolas François
Make description more precise: s/next/largest/
readdir.3
Lefteris Dimitroulakis <edimitro@tee.gr>
Olaf van der Spek <olafvdspek@gmail.com>
Sam Varshavchik <mrsam@courier-mta.com>
-Török Edwin <edwintorok@gmail.com>
+Török Edwin <edwintorok@gmail.com>
Ulrich Mueller <ulm@gentoo.org>
Valdis Kletnieks <Valdis.Kletnieks@vt.edu>
Ivana Varekova <varekova@redhat.com>
Jen Axboe <jens.axboe@oracle.com>
Jens Axboe <jens.axboe@oracle.com>
-Loïc Domaigne <tech@domaigne.com>
+Loïc Domaigne <tech@domaigne.com>
Masanari Iida <masanari.iida@hp.com>
Paul Evans <leonerd@leonerd.org.uk>
Pavel Emelyanov <xemul@openvz.org>
sched_setaffinity.2
Michael Kerrisk
Add note on system-imposed restrictions on CPUs actually used
- After Loic Domaigne's suggestion for pthread_setaffinity_np(3), add
+ After Loïc Domaigne's suggestion for pthread_setaffinity_np(3), add
similar text to this page noting that the system silently
limits the set of CPUs on which the process actually runs to
the set of CPUs physically present and the limits imposed by
Fix description of range of function value return
The range is not [-pi/2, pi/2], but [-pi, pi].
- (mtk: This error was reported by Nicolas Francois, and
+ (mtk: This error was reported by Nicolas François, and
should have been fixed in 3.11, but somewhere along the way,
the fix got lost.)
pthread_attr_setaffinity_np.3
Michael Kerrisk
- Various fixes after review by Loic Domaigne
- Reviewed-by: Loic Domaigne
+ Various fixes after review by Loïc Domaigne
+ Reviewed-by: Loïc Domaigne
pthread_attr_setaffinity_np.3
pthread_setaffinity_np.3
pthread_setschedparam.3
Michael Kerrisk
Remove text saying that only sched_priority is required by POSIX.1
- Loic Domaigne points out that if a system implements
+ Loïc Domaigne points out that if a system implements
SCHED_SPORADIC (which Linux does not), then other
fields are also specified in sched_param. The simple
solution is just to remove that phrase from the man
Michael Kerrisk
Add text to EINVAL error mentioning cpuset(7)
Michael Kerrisk
- Various improvements after review by Loïc Domaigne
- Various fix-ups after Loïc's review.
+ Various improvements after review by Loïc Domaigne
+ Various fix-ups after Loïc's review.
- Reviewed-by: Loïc Domaigne
+ Reviewed-by: Loïc Domaigne
pthread_setschedparam.3
Michael Kerrisk
Fix return value description
The correct range for the return value is [-pi/2,pi/2].
(mtk's fix in the last change to the return value text was
- a botch-up of a (correct) suggestion by Nicolas Francois.)
+ a botch-up of a (correct) suggestion by Nicolas François.)
atexit.3
Michael Kerrisk
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
-Adeodato Simó <dato@net.com.org.es>
+Adeodato Simó <dato@net.com.org.es>
Bastien ROUCARIES <roucaries.bastien@gmail.com>
Davide Libenzi <davidel@xmailserver.org>
Lefteris Dimitroulakis <edimitro@tee.gr>
been incorporated in changes in this release:
Alan Curry <pacman@kosh.dhis.org>
-Américo Wang <xiyou.wangcong@gmail.com>
+Américo Wang <xiyou.wangcong@gmail.com>
Andi Kleen <andi@firstfloor.org>
Carlos O'Donell <carlos@systemhalted.org>
Chunming Chang <cchang@aerohive.com>
---------------------------------------------
proc.5
- Américo Wang
+ Américo Wang
Document /proc/sys/vm/swappiness
Michael Kerrisk
Document /proc/sysrq-trigger
Adrian Dewhurst <sailor@sailorfrag.net>
Alexander Lamaison <awl03@doc.ic.ac.uk>
-Bryan Østergaard <kloeri@exherbo.org>
+Bryan Østergaard <kloeri@exherbo.org>
Christopher Head <chead@telus.net>
Doug Goldstein <cardoe@gentoo.org>
Florentin Duneau <fduneau@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Petr Baudis <pasky@suse.cz>
-Reimar Döffinger <Reimar.Doeffinger@gmx.de>
+Reimar Döffinger <Reimar.Doeffinger@gmx.de>
Ricardo Garcia <rg3.zeluan@gmail.com>
Rui Rlex <rui.rlex@gmail.com>
Shachar Shemesh <shachar@debian.org>
complex.7
Michael Kerrisk
Add missing header file for example program
- Reimar Döffinger
+ Reimar Döffinger
Fix type used in example code
man complex (from release 3.18) contains the following code:
complex z = cexp(I * pi);
Mark Hills <mark@pogo.org.uk>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
-Nicolas François <nicolas.francois@centraliens.net>
+Nicolas François <nicolas.francois@centraliens.net>
Serge Hallyn <serue@us.ibm.com>
Siward de Groot <siward@ziggo.nl>
rui rlex <rui.rlex@gmail.com>
reported by: rui rlex <rui.rlex@gmail.com>
semctl.2
- Nicolas François
+ Nicolas François
Remove some redundant words
setpgid.2
is ssize_t (formerly it was long).
stat.2
- Nicolas François
+ Nicolas François
Fix small bug in example program
Since it is a failure, EXIT_FAILURE looks more appropriate
than EXIT_SUCCESS.
argument name.
posix_fallocate.3
- Nicolas François
+ Nicolas François
Fix reference to POSIX.1-2008
The sentence mentions twice POSIX.1-2001.
I guess the second one should be POSIX.1-2008.
of errno.
strftime.3
- Nicolas François
+ Nicolas François
Fix error in description: s/Monday/Thursday/
proc.5
- Nicolas François
+ Nicolas François
Fix page cross reference
max_user_watches is better explained in epoll(7) than inotify(7).
been "since 2.6.30".
capabilities.7
- Nicolas François
+ Nicolas François
Reword a bad sentence in description of capability bounding set.
mq_overview.7
tcp.7
udp.7
- Nicolas François
+ Nicolas François
Replace references to syctl interfaces with /proc
Doug Manley <doug.manley@gmail.com>
Edward Welbourne <eddy@opera.com>
Fang Wenqi <anton.fang@gmail.com>
-Frédéric Brière <fbriere@fbriere.net>
+Frédéric Brière <fbriere@fbriere.net>
Garrett Cooper <yaneurabeya@yahoo.com>
Ihar Hrachyshka <ihar.hrachyshka@gmail.com>
Jann Poppinga <jann.poppinga@gmx.de>
Alexander E. Patrakov <patrakov@gmail.com>
Andi Kleen <andi@firstfloor.org>
Andrew Klossner <andrew@cesa.opbu.xerox.com>
-Andr
é Goddard Rosa <andre.goddard@gmail.com>
+Andr
é Goddard Rosa <andre.goddard@gmail.com>
Bo Borgerson <gigabo@gmail.com>
Christian Franke <nobody@nowhere.ws>
Daisuke HATAYAMA <d.hatayama@jp.fujitsu.com>
Jianhua Li <jhlicc@gmail.com>
Linus Nilsson <lajnold@gmail.com>
Lenaic Huard <lenaic.huard@laposte.net>
-mac@mcrowe.com
+Mac <mac@mcrowe.com>
Martin Schulze <joey@infodrom.org>
Maxin John <maxin.john@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
-caishuxian@gmail.com
+caishuxian <caishuxian@gmail.com>
Denis Barbier <bouzim@gmail.com>
Denis Silakov <silakov@ispras.ru>
der Mouse <mouse@rodents-montreal.org>
readdir.3
Michael Kerrisk
Clarify that "positive error numbers" are listed in ERRORS
- Reported-by fkater@googlemail.com
rexec.3
Michael Kerrisk
Michael Kerrisk <mtk.manpages@gmail.com>
Petr Uzel <petr.uzel@suse.cz>
Roger Pate <roger@qxxy.com>
-Török Edwin <edwintorok@gmail.com>
+Török Edwin <edwintorok@gmail.com>
Yuri Kozlov <yuray@komyakino.ru>
Apologies if I missed anyone!
Salvo Tomaselli <tiposchi@tiscali.it>
Simone Piccardi <piccardi@truelite.it>
Slaven Rezic <srezic@iconmobile.com>
-starlight@binnacle.cx
+starlight <starlight@binnacle.cx>
Stephan Mueller <stephan.mueller@atsec.com>
Vijay Rao <vijay@portuosus.com>
Walter Haidinger <walter.haidinger@gmx.at>
dup.2
Michael Kerrisk
- SYNOPSIS: Add "#include <fntl.h>" for O_* constants
+ SYNOPSIS: Add "#include <fcntl.h>" for O_* constants
fallocate.2
Michael Kerrisk
pipe.2
Michael Kerrisk [Salvo Tomaselli]
- SYNOPSIS: Add "#include <fntl.h>" for O_* constants
+ SYNOPSIS: Add "#include <fcntl.h>" for O_* constants
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750
sched_rr_get_interval.2
PROTOTYPE: Fix return type of syncfs()
vfork.2
- Michael Kerrisk [starlight@binnacle.cx]
+ Michael Kerrisk [starlight]
Clarify what is duplicated in the child
Add some words to make it clear to the reader that vfork(),
like fork(), creates duplicates of process attributes
in the child.
Michael Kerrisk
Note clone() flags equivalent to vfork()
- Michael Kerrisk [starlight@binnacle.cx, Mike Frysinger]
+ Michael Kerrisk [starlight, Mike Frysinger]
Add some notes on reasons why vfork() still exists
- Michael Kerrisk [starlight@binnacle.cx]
+ Michael Kerrisk [starlight]
Clarify that calling *thread* is suspended during vfork()
Michael Kerrisk
CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete
tcp.7
Michael Kerrisk [Artyom Pervukhin]
Correct RFC for TIME_WAIT assassination hazards
+
+
+==================== Changes in man-pages-3.39 ====================
+
+Released: 2012-04-17, Christchurch
+
+
+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:
+
+Abhijith Das <adas@redhat.com>
+Alexander Kruppa <akruppa@gmail.com>
+Andreas Jaeger <aj@suse.com>
+Armin Rigo <arigo@tunes.org>
+Cyrill Gorcunov <gorcunov@openvz.org>
+Denys Vlasenko <vda.linux@googlemail.com>
+Eric Blake <ebb9@byu.net>
+Felix <fkater@googlemail.com>
+Jak <jak@gmx.ca>
+Jeff Mahoney <jeffm@suse.com>
+Jesus Otero <jesus.otero@rysg.es>
+Jonathan Nieder <jrnieder@gmail.com>
+Kevin O'Gorman <kevinogorman4@gmail.com>
+Mark R Bannister <mark@proseconsulting.co.uk>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Welsh Duggan <mwd@cert.org>
+Mike Frysinger <vapier@gentoo.org>
+Petr Gajdos <pgajdos@suse.cz>
+Regid Ichira <regid23@yahoo.com>
+Reuben Thomas <rrt@sc3d.org>
+Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
+Simone Piccardi <piccardi@truelite.it>
+Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
+<who@connect.carleton.ca>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+malloc_trim.3
+ Michael Kerrisk
+ New man page for malloc_trim(3)
+
+malloc_usable_size.3
+ Michael Kerrisk
+ New man page for malloc_usable_size(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+prctl.2
+ Cyrill Gorcunov
+ Document PR_SET_MM (new in Linux 3.3)
+ Michael Kerrisk
+ Various edits and improvements to Cyrill's patch
+
+
+Changes to individual pages
+---------------------------
+
+epoll_create.2
+ Michael Kerrisk
+ Rework discussion of 'size' argument
+ Michael Kerrisk
+ Add .SS for description of epoll_create1()
+
+epoll_wait.2
+ Michael Kerrisk [Armin Rigo]
+ Another thread can add to epoll instance while epoll_wait is blocked
+ See https://bugzilla.kernel.org/show_bug.cgi?id=43072
+ Michael Kerrisk
+ Clarify that epoll_pwait() blocks calling *thread*
+ A few wording improvements
+
+fchmodat.2
+ Michael Kerrisk [Mike Frysinger]
+ Note difference between glibc wrapper and underlying system call
+ The wrapper function has a 'flags' argument (which currently
+ serves no purpose), while the underlying system call does not.
+
+fcntl.2
+ Abhijith Das
+ Explain behaviour of F_GETLEASE during lease break
+ Michael Kerrisk [Eric Blake]
+ Change type of arg from "long" to "int"
+ Various fcntl(2) commands require an integral 'arg'.
+ The man page said it must be "long" in all such cases.
+ However, for the cases covered by POSIX, there is an
+ explicit requirement that these arguments be "int".
+ Update the man page to reflect. Probably, all of the
+ other "long" cases (not specified in POSIX) should
+ be "int", and this patch makes them so. Based on a
+ note fromEric Blake, relating to F_DUPFD_CLOEXEC.
+
+gettimeofday.2
+ Michael Kerrisk
+ Reorganize content
+ The main change is to move the historical information about
+ the 'tz_dsttime' to NOTES.
+ Michael Kerrisk [Felix]
+ Note that compiler issues warnings if 'tv' is NULL
+
+mmap.2
+ Michael Kerrisk [Kevin O'Gorman]
+ Clarify that this system call should not be invoked directly
+ See https://bugzilla.kernel.org/show_bug.cgi?id=42892
+ Michael Kerrisk
+ Clarify NOTES discussion of mmap() versus mmap2()
+
+poll.2
+ Michael Kerrisk [Michael Welsh Duggan]
+ Document negative value in 'fd' field
+ Michael Kerrisk
+ Document semantics of passing zero in 'events' field
+
+ptrace.2
+ Denys Vlasenko
+ Various fixes
+ For some reason, the PTRACE_TRACEME paragraph talks about some
+ general aspects of ptraced process behavior. It repeats the
+ "tracee stops on every signal" information even though that was
+ already explained just a few paragraphs before. Then it describes
+ legacy SIGTRAP on execve().
+
+ This patch deletes the first part, and moves the second part up,
+ into the general ptrace description. It also adds
+ "If PTRACE_O_TRACEEXEC option is not in effect" to the description
+ of the legacy SIGTRAP on execve().
+
+ The patch also amends the part which says "For requests other
+ than PTRACE_KILL, the tracee must be stopped." - PTRACE_ATTACH
+ also doesn't require that.
+
+sigaction.2
+ Michael Kerrisk [Andreas Jaeger, ]
+ Clarify that the use of SI_SIGIO is for Linux 2.2 only
+ See also http://sourceware.org/bugzilla/show_bug.cgi?id=6745
+
+sigprocmask.2
+ Mike Frysinger
+ ERRORS: add EFAULT
+
+times.2
+ Michael Kerrisk [Simone Piccardi]
+ ERRORS: Add EFAULT
+
+div.3
+ Michael Kerrisk [Reuben Thomas]
+ CONFORMING TO: Add C99
+
+fread.3
+ Regid Ichira
+ Clarify further that return value is number of items, not bytes
+ See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=665780
+
+getaddrinfo.3
+ Michael Kerrisk [Jak]
+ Correct type of ai_addrlen field
+
+malloc.3
+ Michael Kerrisk
+ SEE ALSO: add malloc_usable_size(3)
+ SEE ALSO: Add malloc_trim(3)
+
+mallopt.3
+ Michael Kerrisk
+ Fix text describing M_PERTURB and free()
+ SEE ALSO: Add malloc_trim(3)
+
+memchr.3
+ Michael Kerrisk [Reuben Thomas]
+ Remove mention of terminating null in description of rawmemchr()
+
+perror.3
+ Michael Kerrisk [Jesus Otero]
+ Note that use of 'sys_errlist' is deprecated
+
+rcmd.3
+ Michael Kerrisk
+ glibc eventually added a declaration of iruserok() in version 2.12
+
+sysconf.3
+ Michael Kerrisk [Ricardo Catalinas Jiménez]
+ Add mention of _SC_SYMLOOP_MAX
+
+nologin.5
+ Michael Kerrisk [Tetsuo Handa]
+ nologin must not only exist, but *be readable* to be effective
+
+nsswitch.conf.5
+ Mark R Bannister
+ Significant rewrites and improvements
+ This patch applies to nsswitch.conf.5 in man-pages-3.36.
+
+ My changes almost completely rewrite large sections of the
+ man page. They are needed to add clarity, correct grammar,
+ reduce confusion, and bring up-to-date with the latest glibc.
+ I have checked the man page against the nss source code in
+ glibc 2.14.90.
+
+ Historical notes are demoted to the footer.
+
+ The rewrite makes the man page much clearer to
+ understand, more authoratitive, and easier to read.
+ Michael Kerrisk
+ Light edits to Mark Bannister's changes
+
+capabilities.7
+ Michael Kerrisk
+ Add prctl(PR_SET_MM) to CAP_SYS_RESOURCE
+
+epoll.7
+ Michael Kerrisk
+ Some minor clarifications at start of DESCRIPTION
+
+netlink.7
+ Jeff Mahoney [Petr Gajdos]
+ Note cases where nonprivileged users can use netlink multicast groups
+ See also https://bugzilla.novell.com/show_bug.cgi?id=754611
+
+unix.7
+ Michael Kerrisk [Tetsuo Handa]
+ Add a detail on autobind feature
+
+ld.so.8
+ Jonathan Nieder [Reuben Thomas]
+ Document effect of hwcaps on search path
+ Wording by Aurelien Jarno from Debian glibc's r4701 (2011-06-04).
+
+ Addresses http://bugs.debian.org/622385
+
+
+==================== Changes in man-pages-3.40 ====================
+
+Released: 2012-04-27, Christchurch
+
+
+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:
+
+Alexey Toptygin <alexeyt@freeshell.org>
+Bernhard Walle <bernhard@bwalle.de>
+Brian F. G. Bidulock <bidulock@openss7.org>
+Brian M. Carlson <sandals@crustytoothpaste.net>
+Christopher Yeoh <cyeoh@au1.ibm.com>
+Daniel J Blueman <daniel@quora.org>
+Eric Blake <eblake@redhat.com>
+Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
+James Hunt <james.hunt@ubuntu.com>
+John Sullivan <jsrhbz@kanargh.force9.co.uk>
+Jon Grant <jg@jguk.org>
+lepton <ytht.net@gmail.com>
+Marcel Holtmann <marcel@holtmann.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Petr Baudis <pasky@ucw.cz>
+Simon Paillard <spaillard@debian.org>
+Stefan Puiu <stefan.puiu@gmail.com>
+Ulrich Drepper <drepper@gmail.com>
+Vadim Mikhailov <vadim.mikhailov@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+process_vm_readv.2
+ Mike Frysinger, Christopher Yeoh, Michael Kerrisk
+ New page for process_vm_readv(2) and process_vm_writev(2)
+
+mcheck.3
+ Michael Kerrisk
+ New man page for mcheck(3) and related functions
+ Also describes mcheck_check_all(3), mcheck_pedantic(3),
+ and mprobe(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+rcmd.3
+ Michael Kerrisk
+ Document "_af" variants of these functions
+ Document rcmd_af(), rresvport_af(), iruserok_af(), ruserok_af().
+ Also some restructuring and other clarifications.
+
+rexec.3
+ Michael Kerrisk
+ Document rexec_af()
+
+
+New and changed links
+---------------------
+
+iruserok_af.3
+rcmd_af.3
+rresvport_af.3
+ruserok_af.3
+ Michael Kerrisk
+ New links to rcmd.3
+
+rexec_af.3
+ Michael Kerrisk
+ New link to rexec.3
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Michael Kerrisk
+ Clarify difference between CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW
+ Note interactions of these two clocks with discontinuous
+ adjustments to the system time and NTP/adjtime(2).
+
+fallocate.2
+ Michael Kerrisk [John Sullivan]
+ Fix description of ENOSYS and EOPNOTSUP errors
+ As reported in https://bugzilla.redhat.com/show_bug.cgi?id=680214
+
+fchmodat.2
+ Michael Kerrisk [Mike Frysinger]
+ Improve discussion of difference between wrapper and underlying syscall
+
+gettimeofday.2
+ Michael Kerrisk
+ gettimeofday() is affected by discontinuous jumps in the system time
+ Advise reader to use clock_gettime(2), if they need a
+ monotonically increasing time source.
+ Michael Kerrisk
+ SEE ALSO: Add clock_gettime(2)
+
+prctl.2
+ Michael Kerrisk
+ Add PR_TASK_PERF_EVENTS_DISABLE and PR_TASK_PERF_EVENTS_ENABLE
+ Add some basic documentation of these operations, with a pointer to
+ tools/perf/design.txt for more information.
+ Michael Kerrisk [Marcel Holtmann]
+ Amend details of PR_SET_PDEATHSIG
+
+ptrace.2
+ Michael Kerrisk [Mike Frysinger]
+ Note SPARC deviation with respect to get/set regs
+ SPARC reverses the use of 'addr' and 'data' for
+ PTRACE_GETREGS, PTRACE_GETFPREGS, PTRACE_SETREGS,
+ and PTRACE_SETFPREGS.
+
+send.2
+ Stefan Puiu
+ Document EACCES error case for UDP
+
+sigaction.2
+ Michael Kerrisk
+ Remove mention of raise(3) for SI_USER
+ For a long time now, glibc's raise(3) didn't yield SI_USER
+ for the signal receiver, so remove mention of raise(3)
+ here. The user can deduce the details, if needed, by looking
+ at the recently updated raise(3) page.
+
+aio_cancel.3
+ Michael Kerrisk [Jon Grant]
+ Rewrite RETURN VALUE section to be clearer
+
+aio_init.3
+ Michael Kerrisk [Jon Grant]
+ Remove extraneous "POSIX" from NAME section
+
+btree.3
+dbopen.3
+hash.3
+mpool.3
+recno.3
+ Michael Kerrisk [Brian M. Carlson]
+ Note that glibc no longer provides these interfaces
+ glibc stopped providing these interfaces with v2.2.
+ Nowadays, the user that finds these pages probably wants
+ the libdb API, so note this in the page.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=337581
+
+fopen.3
+ Michael Kerrisk
+ BUGS: Note limitation on number of flag characters parsed in 'mode'
+ Michael Kerrisk
+ Note that 'c' and 'e' flags are ignored for fdopen()
+ Determined from reading libio/iofdopen.c.
+ Michael Kerrisk
+ Document ",ccs=string" feature of 'mode' for fopen()/freopen()
+
+getgrnam.3
+ Michael Kerrisk [Ulrich Drepper]
+ Fix discussion of _SC_GETGR_R_SIZE_MAX
+ The value is not meant to be a maximum (as was specified in
+ SUSv3) but an initial guess at the required size
+ (as specified in SUSv4).
+
+getpwnam.3
+ Michael Kerrisk [Ulrich Drepper]
+ Fix discussion of _SC_GETPW_R_SIZE_MAX
+ The value is not meant to be a maximum (as was specified in
+ SUSv3) but an initial guess at the required size
+ (as specified in SUSv4).
+
+malloc.3
+mallopt.3
+mtrace.3
+ Michael Kerrisk
+ SEE ALSO: add mcheck(3)
+
+memchr.3
+ Michael Kerrisk
+ Clarify description, omitting mention of "strings" and "characters"
+ The existing text slipped into talking about characters and
+ strings, which could mislead readers into thing that, for
+ example, searches for the byte '\0' are treated specially.
+ Therefore, rewrite in terms of "bytes" and "memory areas".
+
+ At the same time, make a few source file clean-ups.
+
+mkstemp.3
+ Michael Kerrisk
+ Add "mkstemps" and "mkostemps" to NAME line
+
+posix_openpt.3
+ Michael Kerrisk [Vadim Mikhailov]
+ Add some details on use of the slave pathname
+ An explicit pointer to ptsname(3) is useful, as is a note
+ of the fact that the slave device pathname exists only as
+ long as the master device is held open.
+
+raise.3
+ Michael Kerrisk
+ Add some notes on underlying system call that is used
+
+rcmd.3
+ Michael Kerrisk
+ Add some details of the rresvport() 'port' argument
+
+resolver.3
+ Petr Baudis
+ Note that many options are documented in resolv.conf(5)
+
+scandir.3
+ Michael Kerrisk [Daniel J Blueman]
+ Improve EXAMPLE source code: s/0/NULL/ in scandir() call
+
+strchr.3
+ James Hunt
+ Explain behavior when searching for '\0'
+
+strerror.3
+ Eric Blake [Stefan Puiu]
+ Improve strerror_r() description
+ POSIX requires that perror() not modify the static storage
+ returned by strerror(). POSIX 2008 and C99 both require that
+ strerror() never return NULL (a strerror() that always
+ returns "" for all inputs is valid for C99, but not for POSIX).
+
+ http://sourceware.org/bugzilla/show_bug.cgi?id=12204
+ documents glibc's change to come into compliance with POSIX
+ regarding strerror_r() return value. The GNU strerror_r() use
+ of 'buf' was confusing - I ended up writing a test program that
+ proves that 'buf' is unused for valid 'errnum', but contains
+ truncated "unknown message" for out-of-range 'errnum'.
+
+ See also http://austingroupbugs.net/view.php?id=382
+ Bernhard Walle
+ Correct description of error return for XSI strerror_r()
+ Michael Kerrisk [Eric Blake]
+ Note how to use 'errno' to detect errors when calling strerror()
+ Michael Kerrisk [Jon Grant]
+ Add an example of the kind of string returned by strerror()
+
+resolv.conf.5
+ Petr Baudis
+ Document "single-request" option
+
+inotify.7
+ Michael Kerrisk
+ Note buffer size that guarantees being able to read at least one event
+ James Hunt
+ Correct description of size of inotify_event structure
+
+iso_8859-1.7
+ Eugen Dedu
+ Add "-" for SOFT HYPHEN
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=156154
+
+netdevice.7
+ Brian F. G. Bidulock
+ Document some SIOC configuration ioctls
+ This patch adds common but missing SIOC configuration ioctls to
+ the netdevice.7 manual pages that are not documented anywhere
+ else. SIOCSIFPFLAGS and SIOCGIFPFLAGS are linux-specific. Flag
+ values come from Linux 2.6.25 kernel headers for sockios. The
+ others are standard BSD ioctls that have always been implemented
+ by Linux and were verified from inspecting netdevice.c kernel
+ code.
+
+socket.7
+ Michael Kerrisk [Alexey Toptygin]
+ Correct description of SO_BROADCAST
+
+tcp.7
+ lepton
+ Correct description for TCP_MAXSEG on modern kernel
+
+
+==================== Changes in man-pages-3.41 ====================
+
+Released: 2012-05-11, Christchurch
+
+
+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:
+
+Akihiro MOTOKI <amotoki@gmail.com>
+Andries E. Brouwer <Andries.Brouwer@cwi.nl>
+Angelo Borsotti <angelo.borsotti@gmail.com>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
+Casper.Dik@oracle.com
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Eric Blake <eblake@redhat.com>
+Hugh Dickins <hughd@google.com>
+Ivana Varekova <varekova@redhat.com>
+Jakub Jelinek <jakub@redhat.com>
+Jan Kara <jack@suse.cz>
+Jason Baron <jbaron@redhat.com>
+Jean-Michel Vourgère <jmv_deb@nirgal.com>
+Jeff Moyer <jmoyer@redhat.com>
+Josh Triplett <josh@joshtriplett.org>
+Kasper Dupont <kasperd@gmail.com>
+KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Lauri Kasanen <curaga@operamail.com>
+Mel Gorman <mgorman@suse.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Nick Piggin <npiggin@gmail.com>
+Paul Pluzhnikov <ppluzhnikov@google.com>
+Petr Baudis <pasky@ucw.cz>
+Ralph Corderoy <ralph@inputplus.co.uk>
+Rich Felker <bugdal@aerifal.cx>
+Simone Piccardi <piccardi@truelite.it>
+Simon Paillard <spaillard@debian.org>
+Stefan Puiu <stefan.puiu@gmail.com>
+Stephen Hemminger <shemminger@vyatta.com>
+Vincent Lefevre <vincent@vinc17.net>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+get_robust_list.2
+ Ivana Varekova [Michael Kerrisk]
+ New page documenting get_robust_list(2) and set_robust_list(2)
+
+mallinfo.3
+ Michael Kerrisk [KOSAKI Motohiro, Paul Pluzhnikov]
+ New page for mallinfo(3)
+
+malloc_info.3
+ Michael Kerrisk [Jakub Jelinek]
+ New page for malloc_info(3)
+
+malloc_stats.3
+ Michael Kerrisk [KOSAKI Motohiro]
+ New man page for malloc_stats(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+madvise.2
+ Jason Baron
+ Document MADV_DONTDUMP and MADV_DODUMP
+
+
+New and changed links
+---------------------
+
+set_robust_list.2
+ Michael Kerrisk
+ New link to new get_robust_list.2 page
+
+LIST_ENTRY.3
+LIST_HEAD.3
+LIST_INIT.3
+LIST_INSERT_AFTER.3
+LIST_INSERT_HEAD.3
+LIST_REMOVE.3
+TAILQ_ENTRY.3
+TAILQ_HEAD.3
+TAILQ_INIT.3
+TAILQ_INSERT_AFTER.3
+TAILQ_INSERT_HEAD.3
+TAILQ_INSERT_TAIL.3
+TAILQ_REMOVE.3
+CIRCLEQ_ENTRY.3
+CIRCLEQ_HEAD.3
+CIRCLEQ_INIT.3
+CIRCLEQ_INSERT_AFTER.3
+CIRCLEQ_INSERT_BEFORE.3
+CIRCLEQ_INSERT_HEAD.3
+CIRCLEQ_INSERT_TAIL.3
+CIRCLEQ_REMOVE.3
+ Michael Kerrisk
+ New link to queue.3
+ The queue(3) page documents these macros, so it makes sense to
+ have links for the names.
+
+DES_FAILED.3
+ Michael Kerrisk
+ New link to des_crypt.3
+ The des_crypt(3) page documents this macro, so it makes sense
+ to have a link for the name.
+
+qsort_r.3
+ Michael Kerrisk
+ New link to qsort.3
+ Overlooked to add this link in 3.38, when documentation of
+ qsort_r() was added to the qsort.3 page.
+
+
+Global changes
+--------------
+
+faccessat.2
+fchmodat.2
+fchownat.2
+fstatat.2
+futimesat.2
+inotify_init.2
+linkat.2
+mkdirat.2
+mknodat.2
+openat.2
+readlinkat.2
+renameat.2
+setns.2
+splice.2
+symlinkat.2
+sync.2
+tee.2
+unlinkat.2
+vmsplice.2
+ Michael Kerrisk [Lauri Kasanen]
+ Global fix: note glibc version that added library support
+
+confstr.3
+strcasecmp.3
+strcat.3
+strcmp.3
+strcpy.3
+strdup.3
+strftime.3
+strlen.3
+strnlen.3
+strpbrk.3
+strspn.3
+strtok.3
+strxfrm.3
+ Michael Kerrisk [Andries E. Brouwer]
+ Clarify that these functions operate on bytes, not (wide) characters
+ Change 'character(s)' to 'byte(s)' to make clear that these
+ functions operate on bytes, not wide / UTF8 characters.
+ (POSIX uses 'byte(s)' similarly, to make this point.)
+
+icmp.7
+ipv6.7
+packet.7
+raw.7
+rtnetlink.7
+unix.7
+x25.7
+ Michael Kerrisk
+ Remove names of constants from NAME line
+ Some of the sockets/network protocol pages included names of
+ the corresponding address family constants in the NAME line,
+ but this wasn't done consistently across all pages, and probably
+ it adds little value in those pages that did do this. So, remove
+ these constants from those pages that have them in the NAME
+ section.
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Michael Kerrisk [Josh Triplett]
+ Expand description of CLOCK_REALTIME
+ Make it clear that this clock may be discontinuous, and is
+ affected my incremental NTP and clock-adjtime(2) adjustments.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=540872
+
+epoll_wait.2
+ Michael Kerrisk
+ Clarify that 'timeout' is a *minimum* interval
+ Make it clear that 'timeout' is a minimum interval; the actual
+ interval will be rounded up to the system clock granularity,
+ and may overrun because of kernel scheduling delays.
+
+execve.2
+ Michael Kerrisk
+ Rewording to deemphasize libc5 details
+
+fork.2
+ Mike Frysinger
+ ERRORS: add ENOSYS
+ Can occur on, for example, non-MMU hardware.
+
+getcpu.2
+ Mike Frysinger
+ Add RETURN VALUE and ERRORS sections
+ Michael Kerrisk
+ Refer reader to NOTES for more info about 'tcache'
+ Michael Kerrisk
+ DESCRIPTION: reword a sentence to be clearer
+
+io_cancel.2
+io_destroy.2
+io_getevents.2
+io_setup.2
+io_submit.2
+ Michael Kerrisk
+ Rewrite to focus on system call API
+ Rewrite to focus on the system call interface, adding
+ some notes on the libaio wrapper differences.
+ See the following mail:
+ 2012-05-07 "aio manuals", linux-man@vger
+ http://thread.gmane.org/gmane.linux.man/1935/focus=2910
+
+ Other minor rewrites.
+
+mount.2
+ Michael Kerrisk
+ Comment out an old Linux libc detail
+
+open.2
+ Nick Piggin [KOSAKI Motohiro, Jan Kara, Hugh Dickins]
+ Describe race of direct I/O and fork()
+ Rework 04cd7f64, which didn't capture the details correctly.
+ See the April/May 2012 linux-man@ mail thread "[PATCH]
+ Describe race of direct read and fork for unaligned buffers"
+ http://thread.gmane.org/gmane.linux.kernel.mm/77571
+
+poll.2
+ Michael Kerrisk
+ Clarify that 'timeout' is a *minimum* interval
+ Make it clear that 'timeout' is a minimum interval; the actual
+ interval will be rounded up to the system clock granularity,
+ and may overrun because of kernel scheduling delays.
+ Michael Kerrisk
+ Clarify discussion of wrapper function emulation
+ Clarify that glibc (as well as old libc) provides emulation
+ using select(2) on older kernels that don't have a poll()
+ system call.
+ Michael Kerrisk
+ Make the meaning of a zero timeout explicit
+ Clarify that timeout==0 causes an immediate return, even if
+ no file descriptors are ready.
+
+pread.2
+ Michael Kerrisk [Kasper Dupont]
+ BUGS: Note O_APPEND + pwrite() does the wrong thing
+ See https://bugzilla.kernel.org/show_bug.cgi?id=43178
+
+recvmmsg.2
+ Michael Kerrisk
+ Clarify that 'timeout' is a *minimum* interval
+ Make it clear that 'timeout' interval will be rounded up to the
+ system clock granularity, and may overrun because of kernel
+ scheduling delays.
+
+select.2
+ Michael Kerrisk
+ Clarify that 'timeout' is a *minimum* interval
+ Make it clear that 'timeout' is a minimum interval; the actual
+ interval will be rounded up to the system clock granularity,
+ and may overrun because of kernel scheduling delays.
+ Michael Kerrisk
+ Expand description of the self-pipe trick
+ Michael Kerrisk
+ Add further details on pselect6() system call that underlies pselect()
+
+semop.2
+ Michael Kerrisk
+ Clarify that 'timeout' of semtimedop() is a *minimum* interval
+ Make it clear that 'timeout' interval will be rounded up to the
+ system clock granularity, and may overrun because of kernel
+ scheduling delays.
+
+signal.2
+ Michael Kerrisk
+ Note that 'sig_t' requires _BSD_SOURCE
+ Also remove some old Linux libc details
+
+sigwaitinfo.2
+ Michael Kerrisk
+ Clarify that 'timeout' of sigtimedwait() is a *minimum* interval
+ Make it clear that 'timeout' is a minimum interval; the actual
+ interval will be rounded up to the system clock granularity,
+ and may overrun because of kernel scheduling delays.
+
+stat.2
+ Bjarni Ingi Gislason
+ Formatting fixes
+ From "groff -ww" (or "man --warnings=w ..."):
+
+ warning: around line 442: table wider than line width
+
+ GNU man uses line length of 78.
+
+ Use text blocks. Two spaces between sentences or better: start
+ each sentence in a new line.
+
+syscalls.2
+ Bjarni Ingi Gislason
+ Formatting fixes
+ From "groff -ww ..." (or "man --warnings=w ..."):
+
+ warning: around line 157: table wider than line width
+
+ Have to use text blocks. Move some text to its correct column.
+ Split text to two columns to avoid hyphenation.
+
+sysinfo.2
+ Michael Kerrisk
+ Remove reference to obsolete libc5
+
+syslog.2
+ Michael Kerrisk
+ Remove some details about obsolete Linux libc
+
+aio_cancel.3
+aio_error.3
+aio_fsync.3
+aio_read.3
+aio_return.3
+aio_suspend.3
+aio_write.3
+ Michael Kerrisk
+ ERRORS: Add/update ENOSYS error
+
+aio_cancel.3
+ Michael Kerrisk
+ Clarify what happens when a request isn't successfully canceled
+ Michael Kerrisk
+ Add pointers to aio(7) and sigevent(7)
+
+dbopen.3
+ Michael Kerrisk
+ SYNOPSIS: Add header file <fcntl.h>
+ Upstreamed from Debian, and consistent with FreeBSD
+ dbopen(3) man page.
+
+fmemopen.3
+ Michael Kerrisk
+ Note details of POSIX.1-2008 specification of 'b' in 'mode'
+ Michael Kerrisk [Rich Felker]
+ BUGS: fmemopen() doesn't correctly set file position in some cases
+ If 'mode' is append, but 'size' does not cover a null byte
+ in 'buf', then fmemopen() incorrectly sets the initial file
+ position to -1, rather than the next byte after the end of
+ the buffer.
+
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=13151
+ Michael Kerrisk
+ BUGS: fmemopen() incorrectly handles size==0 case
+ If size is zero, fmemopen() fails, This is surprising behavior,
+ and not specified in POSIX.1-2008.
+
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=11216
+
+ Reported-by; Alex Shinn <alexshinn@gmail.com>
+ Michael Kerrisk
+ BUGS: Note silent ABI change for fmemopen() in glibc 2.9
+ Michael Kerrisk [Rich Felker]
+ BUGS: Append mode does not force writes to append
+ Append mode correctly sets the initial offset but does
+ not force subsequent writes to append at end of stream.
+
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=13152
+ Michael Kerrisk [Eric Blake]
+ BUGS: Note inconsistent treatment of 'b' in 'mode'
+ fopen() permits, for example, both "w+b" and "wb+",
+ but only the latter is meaningful to fmemopen().
+
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=12836
+
+fopencookie.3
+ Michael Kerrisk [Petr Baudis]
+ Correct description of return for user-supplied 'write' function
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=2074
+
+getaddrinfo.3
+ Jean-Michel Vourgère
+ Note that AI_ADDRCONFIG is not affected by loopback addresses
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=660479
+
+iconv.3
+ Michael Kerrisk
+ Upstream useful NOTE from Debian
+ Warn the reader that the pointer arguments can't be
+ interpreted as C style strings. Also, note possible
+ alignment requirements for the referenced bytes sequences,
+ Michael Kerrisk
+ Write a better paragraph introducing iconv() and its arguments
+
+isgreater.3
+ Michael Kerrisk [Vincent Lefevre]
+ Clarify that the arguments to these macros must be real-floating
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=609033
+
+lio_listio.3
+ Michael Kerrisk
+ Clarify that async notification occurs when *all* I/Os complete
+
+makedev.3
+ Michael Kerrisk
+ SYNOPSIS: Correct return types of major() and minor()
+ See https://bugzilla.redhat.com/show_bug.cgi?id=754188
+
+ Reported-by; Zdenek Kabelac <zkabelac@redhat.com>
+
+malloc.3
+ Michael Kerrisk
+ SEE ALSO: Add malloc_info(3)
+
+malloc_get_state.3
+ Michael Kerrisk
+ Fix wordos in function names in NAME line
+
+mallopt.3
+ Michael Kerrisk
+ Fix example program
+ The example code was a version that was not consistent with
+ the shell output shown on the page.
+
+ Reported-bY: Simon Paillard <spaillard@debian.org>
+ Michael Kerrisk
+ Restore accidentally omitted line in shell session
+ Michael Kerrisk
+ SEE ALSO: Add malloc_stats(3)
+
+mmap64.3
+ Michael Kerrisk
+ Change target of link to mmap.2 (was mmap2.2)
+ Upstreamed from Red Hat / Fedora
+
+realpath.3
+ Michael Kerrisk [Casper Dik]
+ Remove note about Solaris possibly returning a relative path
+
+syslog.3
+ Michael Kerrisk [Ralph Corderoy]
+ Document behavior when 'ident' argument to openlog() is NULL
+ See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/382096
+ Michael Kerrisk
+ Update CONFORMING TO for POSIX.1-2008
+ POSIX.1-2008 doesn't change any details, but make
+ that more explicit.
+
+undocumented.3
+ Michael Kerrisk
+ Remove some functions that have been documented
+
+sd.4
+ Michael Kerrisk
+ Remove reference to nonexistent scsi(4) page
+ Upstreamed from RedHat / Fedora
+
+sk98lin.4
+ Michael Kerrisk [Stephen Hemminger]
+ Note that this driver was removed in 2.6.28
+ See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/528020
+
+passwd.5
+ Michael Kerrisk
+ Upstream pieces from Red Hat/Fedora
+ Note mention of empty password field.
+ Add description of "*NP*" in password field.
+ Michael Kerrisk
+ Various minor fixes and improvements
+
+proc.5
+ Michael Kerrisk
+ Note that CAP_SYS_ADMIN processes can override file-max
+ Upstreamed from red Hat / Fedora
+ Michael Kerrisk
+ Document /proc/[pid]/cgroup
+ Upstreamed from Red Hat / Fedora
+
+resolv.conf.5
+ Michael Kerrisk
+ Take a Debian improvement into upstream
+
+tzfile.5
+ Michael Kerrisk
+ Mention timezone directories in DESCRIPTION
+ Note that timezone files are usually in /usr/lib/zoneinfo
+ or /usr/share/zoneinfo.
+ Michael Kerrisk
+ Drop SYNOPSIS
+ The SYNOPSIS doesn't correspond to a user-visible file.
+ Michael Kerrisk
+ SEE ALSO: Add pointer to glibc source file timezone/tzfile.h
+ Michael Kerrisk
+ SEE ALSO: add tzset(3) and tzselect(8)
+
+ascii.7
+ Bjarni Ingi Gislason
+ Indent for "troff" makes table too wide
+ Fix following from "groff -t -ww ...":
+
+ warning: around line 53: table wider than line width
+
+ Extra indent for "troff" makes the table look misplaced
+ (default "ps" output).
+
+cp1251.7
+ Bjarni Ingi Gislason
+ table too wide
+ From "nroff -ww -t ...":
+
+ warning: around line 44: table wider than line width
+
+ Columns are made narrower (column gutter decreased).
+
+ipv6.7
+ Stefan Puiu
+ Add ENODEV error for bind() to link-local IPv6 address
+
+signal.7
+ Michael Kerrisk [Simone Piccardi]
+ Clarify that SIGLOST is unused
+ Michael Kerrisk
+ Comment out crufty BUGS text on SIGLOST
+ It must be a very long time since the statement there
+ about SIGLOST was true. (The text seems to date back to
+ 1996.)
+ Michael Kerrisk
+ Update architectures for tables of signal numbers
+
+utf-8.7
+ Brian M. Carlson
+ Two clarifications
+ This patch clarifies that 0xc0 and 0xc1 are not valid in any UTF-8
+ encoding[0], and it also references RFC 3629 instead of RFC 2279.
+
+ [0] In order to have 0xc0, you'd have to have a two-byte encoding
+ with all the data bits zero in the first byte (and thus only six
+ bits of data), which would be an ASCII character encoded in the
+ non-shortest form. Similarly with 0xc1.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=538641
+
+ldconfig.8
+nscd.8
+ Michael Kerrisk
+ Remove path prefix from NAME line
+ Command names shown in NAME are normally just the basename,
+ not the full pathname of the command.
+
+
+==================== Changes in man-pages-3.42 ====================
+
+Released: 2012-08-14, Konolfingen
+
+
+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:
+
+Aaron Peschel <aaron.peschel@gmail.com>
+Adrian Dabrowski <atrox@seclab.tuwien.ac.at>
+Akihiro MOTOKI <amotoki@gmail.com>
+Alan Curry <pacman@kosh.dhis.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Christoph Lameter <cl@linux.com>
+Colin McCabe <cmccabe@alumni.cmu.edu>
+Daniel Zingaro <daniel.zingaro@utoronto.ca>
+David Prévot <taffit@debian.org>
+Denys Vlasenko <vda.linux@gmail.com>
+Henry Hu <henry.hu.sh@gmail.com>
+Herbert Xu <herbert@gondor.apana.org.au>
+Jan Engelhardt <jengelh@medozas.de>
+Jim Hill <gjthill@gmail.com>
+JoonSoo Kim <js1304@gmail.com>
+Kalle Olavi Niemitalo <kon@iki.fi>
+Martin H <textshell-tSIEzQ@neutronstar.dyndns.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael S. Tsirkin <mst@redhat.com>
+Rasmus Villemoes <Rasmus.Villemoes@decode.is>
+Sami Kerola <kerolasa@iki.fi>
+Sam Varshavchik <mrsam@courier-mta.com>
+Shawn Landden <shawnlandden@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Tolga Dalman <tolga.dalman@googlemail.com>
+Ulrich Drepper <drepper@gmail.com>
+Марк Коренберг <socketpair@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Global changes
+--------------
+
+Various pages
+ Sami Kerola
+ Global fix: use UR macro where applicable
+ The syntax .UR http://example.com paired with .UE will create
+ links which one can interact, if the pager allows that. One
+ way to see the effect is ask the man(1) command to use browser
+ display, e.g.:
+
+ man -H man7/uri.7
+
+ ("\:" is optional groff syntax to permit hyphenless line breaks.)
+
+
+Changes to individual pages
+---------------------------
+
+ldd.1
+ Michael Kerrisk
+ Add security note on untrusted executables
+ See also http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
+ and
+ http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html
+
+clone.2
+ Michael Kerrisk
+ Rewrite discussion of sys_clone
+
+futex.2
+ Марк Коренберг
+ Consolidate error descriptions to ERRORS
+ Michael Kerrisk
+ Various wording fix-ups
+ Michael Kerrisk
+ Fix description of EINVAL error
+ The current text seems incorrect. Replace with a more general
+ description.
+
+getdents.2
+select_tut.2
+atof.3
+atoi.3
+pthread_create.3
+pthread_sigmask.3
+rtime.3
+setbuf.3
+tsearch.3
+netlink.7
+ Michael Kerrisk [Jan Engelhardt]
+ Remove unneeded casts
+
+get_robust_list.2
+get_thread_area.2
+getcpu.2
+getdents.2
+gettid.2
+io_cancel.2
+io_destroy.2
+io_getevents.2
+io_setup.2
+io_submit.2
+ioprio_set.2
+kexec_load.2
+llseek.2
+modify_ldt.2
+mq_getsetattr.2
+pivot_root.2
+readdir.2
+rt_sigqueueinfo.2
+set_thread_area.2
+sgetmask.2
+spu_create.2
+spu_run.2
+subpage_prot.2
+sysctl.2
+tkill.2
+ Michael Kerrisk
+ Add note to SYNOPSIS that there is no glibc wrapper for system call
+ Reduce the chance that the reader may be misled into thinking
+ that there is a wrapper function for this system call by noting
+ explicitly in the SYNOPSIS that there is no glibc wrapper and
+ pointing the reader to NOTES for further details.
+
+ioprio_set.2
+ Colin McCabe
+ Clarify the multithreaded behavior of ioprio_set(2)
+ Michael Kerrisk [Марк Коренберг, Kalle Olavi Niemitalo]
+ Document who==0 for IOPRIO_WHO_PROCESS and IOPRIO_WHO_PGRP
+ For IOPRIO_WHO_PROCESS, who==0 means operate on the caller.
+ For IOPRIO_WHO_PGRP, who==0 means operate on the caller's
+ process group.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=652443
+
+migrate_pages.2
+ Michael Kerrisk [Christoph Lameter, JoonSoo Kim]
+ Fix description of return value
+
+mount.2
+ Michael Kerrisk
+ For MS_REMOUNT, source is ignored
+
+mprotect.2
+ Michael Kerrisk [Rasmus Villemoes]
+ 'addr' argument is not const
+ As reported by Rasmus:
+
+ Both my system's man-pages (3.22) and the latest online
+ (3.41) show:
+
+ int mprotect(const void *addr, size_t len, int prot);
+
+ as the prototype for mprotect(2). However, POSIX [1] and the
+ actual sys/mman.h (on all the systems I checked) do not have
+ the const qualifier on the first argument.
+
+msgctl.2
+semctl.2
+shmctl.2
+svipc.7
+ Michael Kerrisk
+ Don't mention that ipc_perm is defined in <sys/ipc.h>
+ There's no need to mention that the 'ipc_perm' structure
+ is defined in <sys/ipc.h>. That's an implementation detail,
+ and furthermore <sys/ipc.h> is itself included by the other
+ System V IPC header files. The current text might lead the
+ reader to conclude that they must include <sys/ipc.h>, which
+ is not the case (it is required neither on Linux, nor by the
+ standards).
+
+msgctl.2
+msgget.2
+msgop.2
+semctl.2
+semget.2
+semop.2
+shmctl.2
+shmget.2
+ Michael Kerrisk
+ NOTES: <sys/types.h> and <sys/ipc.h> aren't strictly needed
+ Add text to NOTES to say that the <sys/types.h> and <sys/ipc.h>
+ header files aren't required by Linux or the standards, but may
+ be needed for portability to old systems.
+
+ptrace.2
+ Denys Vlasenko
+ Explain WNOHANG behavior and EINTR bug
+ I didn't like the "SIGKILL operates similarly, with exceptions"
+ phrase (if it's different, then it's not "similar", right?),
+ and now I got around to changing it. Now it says simply:
+ "SIGKILL does not generate signal-delivery-stop and therefore
+ the tracer can't suppress it."
+
+ Replaced "why WNOHANG is not reliable" example with a more
+ realistic one (the one which actually inspired to add this
+ information to man page in the first place): we got
+ ESRCH - process is gone! - but waitpid(WNOHANG) can still
+ confusingly return 0 "no processes to wait for".
+
+ Replaced "This means that unneeded trailing arguments may
+ be omitted" part with a much better recommendation
+ to never do that and to supply zero arguments instead.
+ (The part about "undocumentedness" of gcc behavior was bogus,
+ btw - deleted).
+
+ Expanded BUGS section with the explanation and an example
+ of visible strace behavior on the buggy syscalls which
+ exit with EINTR on ptrace attach. I hope this will lead
+ to people submitting better bug reports to lkml about
+ such syscalls.
+
+seteuid.2
+ Michael Kerrisk
+ Note glibc version where setegid() implementation changed
+ In glibc 2.2/2.3, setegid() switched from setregid() to setresgid().
+
+set_tid_address.2
+ Michael Kerrisk
+ Rename 'ctid' argument for consistency with clone(2) page
+ Michael Kerrisk
+ Some rewordings and minor clarifications
+
+sigwaitinfo.2
+ Michael Kerrisk [Daniel Zingaro]
+ Some wording clarifications
+ Mainly rewording things like "is delivered" to "becomes pending",
+ which is more accurate terminology.
+
+syscall.2
+ Michael Kerrisk
+ Add some more details to the description of syscall(2)
+ And add another example of using syscall() to the program example.
+
+syscalls.2
+ Michael Kerrisk
+ Add kcmp(2)
+ Michael Kerrisk
+ Move discussion of set_zone_reclaim(2) out of main table
+ This system call was never visible to user space, so it makes
+ sense to move it out of the main table of system calls into
+ the notes below the table.
+
+getifaddrs.3
+ Michael Kerrisk [Adrian Dabrowski]
+ Note that ifa_addr and ifa_netmask can be NULL
+
+readdir.3
+ Michael Kerrisk [Jan Engelhardt]
+ Handle -1 error from pathconf() in example code snippet
+ Improve the example demonstrating allocation of a buffer
+ for readdir_r() to handle -1 error return from pathconf().
+ Otherwise, naive readers may think that pathconf() return
+ value can be used without checking.
+
+realpath.3
+ Shawn Landden
+ Use past tense with ancient history (libc4, libc5)
+
+regex.3
+ Michael Kerrisk
+ Correct SEE ALSO reference to glibc manual "regex" section
+
+rtime.3
+ Michael Kerrisk [Jan Engelhardt]
+ Fix broken pointer cast in example code
+
+sem_close.3
+sem_destroy.3
+sem_getvalue.3
+sem_init.3
+sem_open.3
+sem_post.3
+sem_unlink.3
+sem_wait.3
+sem_overview.7
+ Michael Kerrisk
+ Note that "cc -pthread" is required; "-lrt" no longer works
+ See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/874418
+
+sigwait.3
+ Michael Kerrisk
+ Reword "is delivered" to "becomes pending"
+
+strcat.3
+ Michael Kerrisk
+ Add some text to emphasize the dangers of buffer overruns
+ Michael Kerrisk
+ NOTES: Add discussion of strlcat()
+
+strcpy.3
+ Michael Kerrisk
+ Note that info is lost when strncpy() doesn't null terminate
+ Michael Kerrisk
+ Add some text to emphasize possibility of buffer runs with strcpy()
+ Michael Kerrisk
+ NOTES: Add a discussion of strlcpy()
+ Inspired by https://lwn.net/Articles/506530/
+ Michael Kerrisk
+ Fix description of the null-byte padding performed by strncpy()
+
+tsearch.3
+ Michael Kerrisk
+ NOTES: remove redundant discussion of unorthodox use of term "postorder"
+ This point is already covered at greater length in the main
+ text of the page (See the piece "More commonly, ...").
+ Michael Kerrisk
+ Clarify use for first argument to the twalk() 'action' function
+ There's a number of details in POSIX that are omitted in
+ the current version of this page.
+ Michael Kerrisk
+ Some wording fixes
+
+core.5
+ Michael Kerrisk
+ Note effect of madvise(2) MADV_DONTDUMP flag
+
+capabilities.7
+ Michael Kerrisk
+ Document CAP_BLOCK_SUSPEND
+
+glob.7
+ Bjarni Ingi Gislason
+ Change 8 bit characters to 7 bit representation
+ Fixes rendering errors for accented 'a' characters.
+ Michael Kerrisk [Aaron Peschel]
+ Update bash(1) command used to obtain classical globbing behavior
+ The man page formerly noted the bash(1) v1 command to do this.
+
+iso_8859-1.7
+ Bjarni Ingi Gislason
+ Explanation of SOFT HYPHEN and the code for it
+ <groff: iso_8859-2.7>:89: warning: can't find special character `shc'
+
+ This is the only "iso_8859-*.7" file that has this (now)
+ undefined character. The code in column four in "iso_8859-1.7" is
+ "0x2D" ("HYPHEN, MINUS SIGN" or "HYPHEN-MINUS") instead of "0xAD".
+ See Debian bug 156154 (or package "manpages").
+
+ There should be an explanation for this graphic character and the
+ code should be 0xAD in iso_8859-1.7 (as in all others), even
+ though "[gn]roff" does not display a "HYPHEN" in that position of
+ the table.
+
+ The line with "SOFT HYPHEN" gets a footnote and a short
+ explanation.
+
+mdoc.7
+ Bjarni Ingi Gislason
+ Fixing a warning and a table
+ Fis warning from "groff -ww ..." (or "man --warnings=w ..."):
+
+ <groff: mdoc.7>:294: warning:
+ tab character in unquoted macro argument
+
+ In one table the distance between columns is too small in the
+ "ps" output. (Bug in the groff "doc.tmac" macro?)
+
+mdoc.samples.7
+ Bjarni Ingi Gislason
+ Fix warnings from [ng]roff, corrections
+ From "man -ww ..." (groff -ww ...):
+
+ <standard input>:541: warning:
+ tab character in unquoted macro argument
+ [+3 similar warnings]
+ <standard input>:813: warning: macro `Pu' not defined
+ Usage: .Rv -std in sections 2 and 3 only (#1669)
+ mdoc warning: A .Bl directive has no matching .El (#1821)
+
+ String "Pu" defined as a row of punctuation characters.
+ ".Bl" and ".El" fixed.
+ Some arguments, that start with a period or are the name of a
+ macro, protected with "\&".
+ Variable name for macro ".Rv" corrected.
+
+netdevice.7
+ Bjarni Ingi Gislason
+ Line in table too long
+ Fix warning from "man ..." ("nroff -ww ..."):
+
+ nroff: netdevice.7: warning: around line 98:
+ table wider than line width
+
+ Fix: No right adjustment in text blocks in tables.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673873
+
+netlink.7
+ Bjarni Ingi Gislason
+ Line in table is too long
+ Fix warning from "man ..." ("nroff -ww ..."):
+
+ nroff: netlink.7: warning: around line 195:
+ table wider than line width
+
+ Horizontal line incorporated into table.
+ No right adjustment of text blocks in tables.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673875
+ Simon Paillard [Herbert Xu]
+ Change description of "*_pid" fields to "Port ID"
+ As reported by Herbert Xu, these should not be considered as PIDs.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=383296
+
+rtnetlink.7
+ Bjarni Ingi Gislason
+ Line in table too long
+ Fix warning from "man ..." ("nroff -ww ..."):
+
+ nroff: rtnetlink.7: warning: around line 415:
+ table wider than line width
+
+ Column gutter reduced to fit line length.
+ Right adjustment in text blocks removed in tables.
+ Some header made centered in tables.
+ One table put on same page.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674051
+
+socket.7
+ Martin H
+ Document SO_MARK socket option
+ Commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0 in Jan 2008 added
+ the new SO_MARK socket option.
+
+ This patch is based on text from the commit message.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=16461.
+
+svipc.7
+ Michael Kerrisk
+ SYNOPSIS: Remove include of <sys/types.h> and <sys/ipc.h>
+ Including <sys/types.h> and <sys/ipc.h> isn't needed on Linux
+ and isn't really relevant for the explanation on this page.
+
+
+==================== Changes in man-pages-3.43 ====================
+
+Released: 2012-10-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:
+
+Adrian Bunk <bunk@kernel.org>
+Anatoli Klassen <anatoli@aksoft.net>
+Andreas Schwab <schwab@linux-m68k.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+David Prévot <taffit@debian.org>
+Eric Dumazet <edumazet@google.com>
+Florian Weimer <fweimer@redhat.com>
+Frédéric Brière <fbriere@fbriere.net>
+Fredrik Arnerup <arnerup@kth.se>
+Guillem Jover <guillem@hadrons.org>
+Jan Engelhardt <jengelh@inai.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Simon Josefsson <simon@josefsson.org>
+Stephane Fillod <fillods@users.sf.net>
+Trevor Woerner <twoerner@gmail.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+getenv.3
+ Michael Kerrisk [Florian Weimer, Andreas Schwab]
+ Document secure_getenv(3)
+
+
+New and changed links
+---------------------
+
+phys.2
+ Michael Kerrisk
+ New link to unimplemented.2
+
+secure_getenv.3
+ Michael Kerrisk
+ New link to getenv.3
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/-/\\-/ when real hyphen is required (e.g., in code)
+
+Various pages
+ David Prévot [Michael Kerrisk]
+ Global fix: Various consistency fixes for SEE ALSO
+
+Various pages
+ Michael Kerrisk
+ Global fix: use "Linux kernel source" consistently
+ Rather than "kernel source".
+
+Various pages
+ Michael Kerrisk
+ Global fix: disable justification and hyphenation in SEE ALSO
+ For a better visual result, disable justification and hyphenation
+ in SEE ALSO where page names are long.
+
+syscalls.2
+uname.2
+boot.7
+ Michael Kerrisk
+ Global fix: s/OS/operating system/
+
+
+Changes to individual pages
+---------------------------
+
+epoll_wait.2
+ Michael Kerrisk [Fredrik Arnerup]
+ Describe timeout limitation in kernels < 2.6.37
+ As reported by Fredrik (and as far as I can tell the problem
+ went back to 2.6.0):
+
+ The timeout argument has an upper limit. Any values above that
+ limit are treated the same as -1, i.e. to wait indefinitely.
+ The limit is given by:
+
+ #define EP_MAX_MSTIMEO min(1000ULL * MAX_SCHEDULE_TIMEOUT / HZ, \
+ (LONG_MAX - 999ULL) / HZ)
+
+ That is, the limit depends on the size of a long and the timer
+ frequency. Assuming the a long is never smaller than 32 bits
+ and HZ never larger than 1000, the worst case is 35 minutes.
+ I think this should be mentioned under "BUGS".
+
+ Although this is likely to be fixed in the future
+ (http://lkml.org/lkml/2010/8/8/144), the problem exists in
+ at least 2.6.14 - 2.6.35. I don't know if select(2) and poll(2)
+ are affected.
+
+ https://bugzilla.kernel.org/show_bug.cgi?id=20762
+ Michael Kerrisk
+ Add pointer to select(2) for discussion of close in another thread
+
+getitimer.2
+ Michael Kerrisk [Trevor Woerner]
+ Note Linux's odd handling of the new_value==NULL case
+ Michael Kerrisk [Trevor Woerner]
+ Fix types used to declare fields in timeval struct
+
+keyctl.2
+ David Prévot
+ Reorder SEE ALSO, without .br
+
+poll.2
+ Michael Kerrisk
+ Add pointer to select(2) for discussion of close in another thread
+
+select.2
+ Michael Kerrisk [Stephane Fillod]
+ Note behavior if monitored file descriptor is closed in another thread
+ Executive summary: a sane application can't rely on any
+ particular behavior if another thread closes a file descriptor
+ being monitored by select().
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=40852
+ Michael Kerrisk
+ Clarify equivalent pselect() code in terms of threads
+ s/sigprogmask/pthread_sigmask/
+
+semop.2
+ Michael Kerrisk
+ Recast discussion of blocking behavior in terms of threads
+ semop() blocks the calling thread, not the process.
+ Michael Kerrisk
+ SEE ALSO: Add clone(2)
+ Give reader a clue about CLONE_SYSVSEM.
+
+shutdown.2
+ Michael Kerrisk [Eric Dumazet]
+ Document EINVAL error (and associated bug)
+ Eric Dumazet noted that EINVAL was not documented. Some further
+ digging shows that it's also not diagnosed consistently.
+ See https://bugzilla.kernel.org/show_bug.cgi?id=47111.
+
+sigaction.2
+ Michael Kerrisk
+ Tweak SA_RESETHAND description
+
+timer_settime.2
+ Michael Kerrisk
+ Small rewording around discussion of pointer arguments
+
+wait4.2
+ Adrian Bunk
+ Note that these functions are nonstandard and recommend alternatives
+ Some edits to Adrian's patch by mtk.
+ Michael Kerrisk
+ CONFORMING TO: Note SUS details for wait3()
+
+gnu_get_libc_version.3
+ Michael Kerrisk
+ Remove unneeded "#define _GNU_SOURCE" from SYNOPSIS
+
+pthread_kill.3
+pthread_sigqueue.3
+ Michael Kerrisk
+ Remove wording "another"
+ Writing "another thread" in these pages implies that these
+ functions can't be used to send a signal to the calling thread
+ itself, which is of course untrue.
+
+sigvec.3
+ Michael Kerrisk
+ Add "int" arg to sv_handler definition in sigvec structure
+ Michael Kerrisk
+ Fix small error in discussion of blocking of signals
+ The signal that causes the handler to be invoked is blocked,
+ but saying "by default" implies that this can be changed via
+ the API. It cannot. (One needs sigaction(2) for that.)
+
+syslog.3
+ Simon Josefsson
+ Remove (apparently bogus) text claiming LOG_AUTH is deprecated
+ LOG_AUTH is in POSIX, and widely available. There
+ seems to be no basis to the claim it is deprecated.
+
+ Quoting Simon:
+ I cannot find any other source that claim LOG_AUTH is
+ deprecated in any way. LOG_AUTH is distinct from
+ LOG_AUTHPRIV. The GNU C Library manual only documents
+ LOG_AUTH. The header files contains both without any
+ comment. Common systems like Debian appear to refer to
+ both auth and authpriv facilities in syslog configurations.
+ Popular daemons appear to use both facilities.
+ Both facilities are discussed in several RFCs.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=46091
+
+ttyname.3
+ Michael Kerrisk
+ SEE ALSO: Add ctermid(3)
+
+proc.5
+ Michael Kerrisk
+ Clarify header file related to 'flags' field of /proc/PID/stat
+ Michael Kerrisk [Frédéric Brière]
+ Update description of 'starttime' field of /proc/PID/stat
+ The unit of measurement changed from jiffies to clock ticks in
+ Linux 2.6.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=675891
+ Michael Kerrisk
+ Document /proc/sys/kernel/kptr_restrict
+ Michael Kerrisk [Kees Cook]
+ Document /proc/sys/fs/protected_symlinks
+ Based on text in Documentation/sysctl/fs.txt by Kees Cook
+ Michael Kerrisk [Kees Cook]
+ Document /proc/sys/fs/protected_hardlinks
+ Based on text in Documentation/sysctl/fs.txt by Kees Cook
+
+capabilities.7
+ Michael Kerrisk
+ Document interaction of CAP_SYSLOG and /proc/sys/kernel/kptr_restrict
+
+ip.7
+ Michael Kerrisk
+ SEE ALSO: Add ipv6(7)
+ SEE ALSO: Add icmp(7)
+
+man-pages.7
+ Michael Kerrisk
+ Add some advice about disabling hyphenation in SEE ALSO
+
+ld.so.8
+ Michael Kerrisk
+ Describe interpretation of slashes in dependency strings
+ Michael Kerrisk
+ Repeat note that LD_LIBRARY_PATH is ignored in privileged programs
+ This point is already noted when discussing search order for
+ libraries, but it's worth repeating under the specific discussion
+ of LD_LIBRARY_PATH further down the page.
+ Michael Kerrisk
+ Add some details for LD_PRELOAD
+ Note that LD_PRELOAD list separator can be space or colon
+
+
+==================== Changes in man-pages-3.44 ====================
+
+Released: 2012-11-07, Barcelona
+
+
+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:
+
+Bert Hubert <bert.hubert@netherlabs.nl>
+David Prévot <taffit@debian.org>
+James Youngman <jay@gnu.org>
+Kees Cook <keescook@chromium.org>
+Lars Wirzenius <liw@iki.fi>
+Lucas De Marchi <lucas.de.marchi@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Rusty Russell <rusty@rustcorp.com.au>
+Simon Paillard <spaillard@debian.org>
+Thomas Habets <thomas@habets.se>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+delete_module.2
+ Michael Kerrisk
+ Rewrite to Linux 2.6+ reality
+ Michael Kerrisk
+ Change license and copyright
+ There is now nothing left of the original FSF-copyrighted
+ page. So, change the copyright and license.
+ Michael Kerrisk [Lucas De Marchi, Rusty Russell]
+ Substantial reorganization after comments from Rusty Russell
+ Rusty notes that O_NONBLOCK is almost always used in
+ practice. Therefore, it would be better to reorganize
+ the page to consider that "the default".
+
+init_module.2
+ Michael Kerrisk
+ Rewrite to Linux 2.6+ reality
+ Michael Kerrisk
+ Change copyright and license
+ Little of the original page now remains. Change
+ copyright and license
+ Michael Kerrisk [Rusty Russell]
+ Changes after review comments from Rusty Russell
+ Kees Cook
+ Add various pieces describing Linux 2.6+ behavior
+ Pieces take from, or inspired by, a patch sent by Kees.
+
+getauxval.3
+ Michael Kerrisk
+ Document getauxval() function added in glibc 2.16
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: Use consistent capitalization in NAME section
+ The line(s) in the NAME section should only use capitals
+ where English usage dictates that. Otherwise, use
+ lowercase throughout.
+
+Various pages
+ Michael Kerrisk
+ Global fix: "userspace" ==> "user space" or "user-space"
+ Existing pages variously use "userspace or "user space".
+ But, "userspace" is not quite an English word.
+ So change "userspace" to "user space" or, when used
+ attributively, "user-space".
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+clock_nanosleep.2
+ Michael Kerrisk
+ Linking with -lrt is no longer needed from glibc 2.17 onward
+
+create_module.2
+ Michael Kerrisk
+ Note that this system call is present only in kernels before 2.6
+ Michael Kerrisk
+ Note that ENOSYS probably indicates kernel 2.6+
+
+execve.2
+ Michael Kerrisk
+ Document treatment of PR_SET_PDEATHSIG on execve()
+ Michael Kerrisk
+ Document treatment of SECBIT_KEEP_CAPS securebits flag on execve()
+
+fork.2
+ Michael Kerrisk
+ Note treatment of default timer slack value on fork()
+
+getdomainname.2
+ Simon Paillard [Lars Wirzenius]
+ Point out that these calls relate to NIS, not DNS
+ See http://bugs.debian.org/295635
+
+get_kernel_syms.2
+ Michael Kerrisk
+ Note that this system call is present only in kernels before 2.6
+
+ipc.2
+ Michael Kerrisk
+ Update note on architectures that don't have ipc()
+ Replace mention of ia64 with x86-64 and ARM.
+
+link.2
+ Michael Kerrisk
+ Add EPERM error triggered by /proc/sys/fs/protected_hardlink
+
+prctl.2
+ Michael Kerrisk
+ Mention Documentation/prctl/no_new_privs.txt for PR_SET_NO_NEW_PRIVS
+ Kees Cook
+ update seccomp sections for mode 2 (BPF)
+ This adds a short summary of the arguments used
+ for "mode 2" (BPF) seccomp.
+ Michael Kerrisk
+ Small improvements to PR_SET_SECCOMP discussion
+ Note type of 'arg3' for SECCOMP_MODE_FILTER.
+ Add pointer to Documentation/prctl/seccomp_filter.txt.
+ Michael Kerrisk
+ Note 'seccomp' semantics with respect to fork(), execve(), and prctl()
+ Michael Kerrisk
+ Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK
+ Michael Kerrisk
+ Reword PR_SET_NAME and PR_GET_NAME in terms of threads
+ Plus tfix
+ Kees Cook
+ document PR_SET_NO_NEW_PRIVS, PR_GET_NO_NEW_PRIVS
+ This adds a short description of the no_new_privs bit,
+ as described in Documentation/prctl/no_new_privs.txt.
+
+ptrace.2
+ Michael Kerrisk
+ Clarify that some operations are not present on all architectures
+ PTRACE_GETREGS, PTRACE_SETGREFS, PTRACE_GETFPREGS,
+ and PTRACE_GETSPREGS are not present on all architectures.
+ PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP are present only
+ on x86.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=122383
+
+query_module.2
+ Michael Kerrisk
+ Add a few words clarifying reference to /sys/module
+ Michael Kerrisk
+ Note that this system call is present only in kernels before 2.6
+ Michael Kerrisk
+ Note that ENOSYS probably indicates kernel 2.6+
+ Michael Kerrisk
+ SEE ALSO: Add modinfo(8) and lsinfo(8)
+ Michael Kerrisk
+ Move some information in NOTES to VERSIONS
+
+socketcall.2
+ Michael Kerrisk
+ Update note on architectures that don't have socketcall()
+ Replace mention of ia64 with x86-64 and ARM.
+
+times.2
+ Thomas Habets
+ Recommend clock_gettime(2) as alternative to times(2)
+
+clock_getcpuclockid.3
+ Michael Kerrisk
+ Linking with -lrt is no longer needed from glibc 2.17 onward
+
+fts.3
+ Simon Paillard [James Youngman]
+ Improve description of physical vs. logical tree walking
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=633505
+
+getenv.3
+ Michael Kerrisk
+ SEE ALSO: add getauxval(3)
+
+proc.5
+ Michael Kerrisk
+ Document /proc/meminfo
+ Info mostly taken from Documentation/filesystems/proc.txt
+ and Documentation/vm/hugetlbpage.txt.
+ Michael Kerrisk
+ Default for /proc/sys/fs/protected_{hardlinks,symlinks} is now 0
+ The default setting of 1 in/proc/sys/fs/protected_hardlinks
+ and /proc/sys/fs/protected_symlinks caused one too many
+ breakages for Linus's taste, so commit 561ec64ae67e changed
+ the default for both files to 0.
+ Note system call error yielded by /proc/sys/fs/protected_symlinks
+ Note that violating 'protected_symlinks' restrictions
+ causes system calls to fail with the error EACCES.
+ Michael Kerrisk
+ Since Linux 2.6.27, /proc/sys/kernel/modprobe depends on CONFIG_MODULES
+
+ipv6.7
+ Bert Hubert
+ Document IPV6_RECVPKTINFO
+
+man-pages.7
+ Michael Kerrisk
+ Note rules for capitalization in NAME section
+
+time.7
+ Michael Kerrisk
+ Add a subsection on timer slack
+
+ld.so.8
+ Michael Kerrisk
+ SEE ALSO: add getauxval(3)
+
+
+==================== Changes in man-pages-3.45 ====================
+
+Released: 2012-12-21, Christchurch
+
+
+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:
+
+Andi Kleen <andi@firstfloor.org>
+Cyril Hrubis <chrubis@suse.cz>
+David Prévot <taffit@debian.org>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Eric Dumazet <eric.dumazet@gmail.com>
+Felipe Pena <felipensp@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+Gao Feng <gaofeng@cn.fujitsu.com>
+Jan Glauber <jang@linux.vnet.ibm.com>
+Jim Paris <jim@jtan.com>
+Jon Grant <jg@jguk.org>
+Julien Cristau <jcristau@debian.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Rens van der Heijden <rens.vanderheijden@uni-ulm.de>
+Simon Paillard <spaillard@debian.org>
+Thierry Vignaud <thierry.vignaud@gmail.com>
+Trevor Woerner <twoerner@gmail.com>
+YOSHIFUJI Hideaki <yoshfuji@linux-ipv6.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+s390_runtime_instr.2
+ Jan Glauber
+ New page for s390-specific s390_runtime_instr(2)
+
+if_nameindex.3
+ YOSHIFUJI Hideaki
+ Document if_nameindex(3) and if_freenameindex(3)
+ Michael Kerrisk
+ Edits, improvements and corrections to Hideaki's page
+ Michael Kerrisk
+ Add an example program
+
+if_nametoindex.3
+ YOSHIFUJI Hideaki
+ New page documenting if_nametoindex(3) and if_indextoname(3)
+
+
+New and changed links
+---------------------
+
+if_freenameindex.3
+ Michael Kerrisk
+ New link to if_nameindex.3
+
+if_indextoname.3
+ Michael Kerrisk
+ New link to if_nametoindex.3
+
+
+Global changes
+--------------
+
+sysconf.3
+cciss.4
+ Michael Kerrisk
+ Global fix: s/runtime/run time/
+
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Since 2.6.30, CLONE_NEWIPC also supports POSIX message queues
+
+delete_module.2
+ Michael Kerrisk
+ Small rewording of description of effect of O_TRUNC
+
+getrlimit.2
+ Michael Kerrisk [Trevor Woerner]
+ Document Linux's nonstandard treatment or RLIMIT_CPU soft limit
+ Upon encountering the RLIMIT_CPU soft limit when a SIGXCPU handler
+ has been installed, Linux invokes the signal handler *and* raises
+ the soft limit by one second. This behavior repeats until the
+ limit is encountered. No other implementation that I tested
+ (Solaris 10, FreeBSD 9.0, OpenBSD 5.0) does this, and it seems
+ unlikely to be POSIX-conformant. The (Linux-specific)
+ RLIMIT_RTTIME soft limit exhibits similar behavior.
+ Michael Kerrisk
+ Point reader at discussion of /proc/[pid]/limits in proc(5)
+
+io_getevents.2
+ Michael Kerrisk
+ io_getevents() may cause segfault when called with invalid ctx_id
+ For reference see: http://marc.info/?l=linux-aio&m=130089887002435&w=2
+
+recv.2
+ Michael Kerrisk [Eric Dumazet]
+ UNIX domain sockets support MSG_TRUNC since 3.4
+
+sendmmsg.2
+ Elie De Brauwer
+ Add example program for sendmmsg()
+
+stat.2
+ Simon Paillard
+ Clarify description of EOVERFLOW error
+ The EOVERFLOW error is not only for st_size, but also
+ inode and block size fields. See glibc source file
+ sysdeps/unix/sysv/linux/xstatconv.c and kernel source
+ file fs/stat.c. Also, fix bit/byte confusion
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604928
+
+syscalls.2
+ Michael Kerrisk
+ Update various references to "i386" to "x86"
+ Michael Kerrisk
+ Add s390_runtime_instr(2)
+
+sysctl.2
+ Michael Kerrisk
+ Mention CONFIG_SYSCTL_SYSCALL
+ Michael Kerrisk
+ Calls to sysctl() log warnings to the kernel log since 2.6.24
+
+syslog.2
+ Michael Kerrisk
+ Substantially reorganize discussion of commands
+ Make the layout of the discussion of the commands
+ more readable.
+ Michael Kerrisk
+ Add kernel symbolic 'type' names
+ Michael Kerrisk
+ Clarify SYSLOG_ACTION_SIZE_UNREAD semantics
+ SYSLOG_ACTION_SIZE_UNREAD returns the number of bytes
+ available for reading via SYSLOG_ACTION_READ.
+ Michael Kerrisk
+ Clarify where SYSLOG_ACTION_READ_ALL places data it reads
+ Michael Kerrisk
+ Clarify semantics of SYSLOG_ACTION_CLEAR
+ The SYSLOG_ACTION_CLEAR command (5) does not really clear
+ the ring buffer; rather it affects the semantics of what
+ is returned by commands 3 (SYSLOG_ACTION_READ_ALL) and
+ 4 (SYSLOG_ACTION_READ_CLEAR).
+ Michael Kerrisk
+ Clarify discussion of privileges for commands 3 and 10
+ Michael Kerrisk
+ Add mention of CONFIG_LOG_BUF_SHIFT
+
+wait.2
+ Michael Kerrisk
+ BUGS: Document odd waitid() behavior when 'infop' is NULL
+
+getifaddrs.3
+ Michael Kerrisk [Julien Cristau]
+ Update description of ifa_data to Linux 2.6+ reality
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778
+
+memcmp.3
+ Michael Kerrisk [Jon Grant]
+ Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
+ Note that sign of result equals sign of difference between
+ first two bytes that differ (treated as "unsigned char")."
+
+mkstemp.3
+ Michael Kerrisk [Florian Weimer]
+ Deemphasize discussion of mode 066 in glibc 2.0.6
+ Glibc 2.0.6 is now so ld that the discussion of details
+ of that version can be deemphasized placing just under
+ NOTES.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=51811
+
+strcmp.3
+ Michael Kerrisk [Jon Grant]
+ Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
+ Note that sign of result equals sign of difference between
+ first two bytes that differ (treated as "unsigned char")."
+
+ttyname.3
+ Michael Kerrisk
+ Fix confused text in ERRORS
+ The existing text suggested that the ERRORS applied
+ only for ttyname_r(). However, 2 of the 3 errors
+ can occur for ttyname().
+
+undocumented.3
+ Michael Kerrisk
+ Remove some now documented functions
+
+proc.5
+ Michael Kerrisk [Jim Paris]
+ Correct description of SwapFree in /proc/meminfo
+ Michael Kerrisk
+ Note change of /proc/[pid]/limits file permissions in 2.6.36
+
+resolv.conf.5
+ Simon Paillard
+ Document IPv6 format for nameserver
+ See: http://bugs.debian.org/610036
+
+capabilities.7
+ Michael Kerrisk [Rens van der Heijden]
+ Correct URL for POSIX.1e draft
+
+ipv6.7
+ Gao Feng
+ Add description of getsockopt() for IPV6_MTU
+ In IPv4,IP_MTU is only supported by getsockopt.
+ In IPv6, we can use IPV6_MTU to set socket's MTU,
+ but the return value of getsockopt() is the path MTU.
+
+rtnetlink.7
+ Michael Kerrisk [Julien Cristau]
+ Update description of IFLA_STATS to Linux 2.6+ reality
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778
+
+socket.7
+ Michael Kerrisk [YOSHIFUJI Hideaki]
+ Document 'sockaddr' and 'sockaddr_storage' types
+ Andi Kleen
+ Explain effect of SO_SNDTIMEO for connect()
+ When SO_SNDTIMEO is set before connect(), then connect()
+ may return EWOULDBLOCK when the timeout fires.
+
+
+==================== Changes in man-pages-3.46 ====================
+
+Released: 2013-01-27, Canberra
+
+
+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:
+
+Andrew Perepechko <andrew_perepechko@xyratex.com>
+Cédric Boutillier <cedric.boutillier@gmail.com>
+Cyrill Gorcunov <gorcunov@openvz.org>
+Daan Spitz <daan.f.spitz@gmail.com>
+David Prévot <taffit@debian.org>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Garrett Cooper <yanegomi@gmail.com>
+James Noble <James.Noble@daktronics.com>
+Justin Lebar <justin.lebar@gmail.com>
+Kees Cook <keescook@chromium.org>
+Lucas De Marchi <lucas.demarchi@profusion.mobi>
+Mark Hills <mark@pogo.org.uk>
+Maxin B. John <maxin.john@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Gorny <mgorny@gentoo.org>
+Peter Budny <bigpeteb@gmail.com>
+Peter Lekeynstein <lekensteyn@gmail.com>
+Rusty Russell <rusty@rustcorp.com.au>
+Samuel Thibault <sthibault@debian.org>
+Sam Varshavchik <mrsam@courier-mta.com>
+Shawn Landden <shawnlandden@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Starlight <starlight.2013q1@binnacle.cx>
+Theodore Ts'o <tytso@mit.edu>
+Wolfgang Rohdewald <wolfgang@rohdewald.de>
+Zsbán Ambrus <ambrus@math.bme.hu>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+kcmp.2
+ Cyrill Gorcunov, Michael Kerrisk
+ New page for kcmp(2)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+init_module.2
+ Michael Kerrisk [Kees Cook, Rusty Russell, Lucas De Marchi]
+ Document finit_module(2)
+ Rusty Russell [Lucas De Marchi, Kees Cook]
+ Document finit_module() 'flags' argument
+ Document MODULE_INIT_IGNORE_MODVERSIONS and
+ MODULE_INIT_IGNORE_VERMAGIC. (Some edits by mtk.)
+
+
+New and changed links
+---------------------
+
+finit_module.2
+ Michael Kerrisk
+ New link to init_module.2
+
+__after_morecore_hook.3
+__free_hook.3
+__malloc_initialize_hook.3
+__memalign_hook.3
+__realloc_hook.3
+ Michael Kerrisk
+ New link to malloc_hook.3
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/tty/terminal/
+
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Add kernel versions for various CLONE_* constants
+ Michael Kerrisk
+ CLONE_NEWIPC governs mechanisms that don't have filesystem pathnames
+ Michael Kerrisk
+ CLONE_NEWIPC doesn't mount the POSIX MQ file system
+ Michael Kerrisk
+ Add an example program (CLONE_NEWUTS)
+ Michael Kerrisk
+ Some reworking of CLONE_NEWIPC text
+ No substantial content changes.
+ Michael Kerrisk
+ SEE ALSO: add kcmp(2)
+ SEE ALSO: add setns(2)
+
+fallocate.2
+ Michael Kerrisk
+ FALLOC_FL_* flags are defined in glibc only since 2.18
+
+getxattr.2
+removexattr.2
+setxattr.2
+ Michael Kerrisk [Andrew Perepechko, ]
+ Note that ENOATTR is a synonym for ENODATA
+ Various people have pointed out that strace(1) shows ENODATA
+ for the case where the named attribute does not exist, or
+ the process has no access to this attribute. ENODATA
+ and ENOATTR are in fact defined as synonyms. Point this out
+ in the man page, so that people understand the strace(1) info.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=51871
+
+getxattr.2
+listxattr.2
+removexattr.2
+setxattr.2
+ Michael Kerrisk
+ Put errors under ERRORS section
+ The errno values on these pages were listed in a nonstandard
+ way under the RETURN VALUE section. Put them in ERRORS sections.
+
+init_module.2
+ Michael Kerrisk [Rusty Russell]
+ ERRORS: Add errors for module signatures (EBADMSG, ENOKEY)
+
+link.2
+mkdir.2
+mknod.2
+open.2
+rename.2
+symlink.2
+write.2
+mkfifo.3
+ Mark Hills
+ Document EDQUOT error
+ The return error EDQUOT is not documented in open(2), write(2),
+ symlink(2) etc.
+
+ Whether inodes or disk blocks are required for each function
+ is something I based on received wisdom and BSD documentation,
+ rather than tracing the code to the kernel. For symlink(2)
+ this certainly depends on the file system type.
+
+listxattr.2
+ Michael Kerrisk [Theodore Ts'o]
+ Fix RETURN VALUE description
+ On success, 0 may be returned, so change wording from
+ "positive number" to "nonnegative number".
+
+outb.2
+ Michael Kerrisk
+ Add SYNOPSIS
+
+prctl.2
+ Kees Cook
+ Document PR_SET_PTRACER
+ Document the Yama LSM's prctl handler that allows processes to
+ declare ptrace restriction exception relationships via
+ PR_SET_PTRACER.
+ Michael Kerrisk
+ Make it explicit that PR_SET_PTRACER replaces previous setting
+ The attribute is a scalar, not a list.
+ Shawn Landden
+ Document EINVAL error for PR_SET_PTRACER
+ Michael Kerrisk
+ Document PR_GET_TID_ADDRESS
+
+ptrace.2
+ Michael Kerrisk
+ Document PTRACE_O_EXITKILL
+ Michael Kerrisk
+ Place PTRACE_SETOPTIONS list in alphabetical order
+
+query_module.2
+ Michael Kerrisk
+ Must be called using syscall(2)
+ Yes, the call is way obsolete, but add this info
+ for completeness.
+
+recvmmsg.2
+ Elie De Brauwer
+ Add/correct kernel version info for recvmmsg() and MSG_WAITFORNONE
+ This patch isolates the since/version related fixes as requested.
+ This change introduces the following delta:
+ * The page states it was added in 2.6.32 but it is only added
+ 2.6.33 (ref: http://kernelnewbies.org/Linux_2_6_33)
+ * The MSG_WAITFORONE flag was in turn only added in 2.6.34
+ (ref: http://kernelnewbies.org/Linux_2_6_34)
+ Elie De Brauwer
+ Add an example program
+
+setns.2
+ Michael Kerrisk
+ Add example program
+
+sigaction.2
+ Michael Kerrisk [Zsbán Ambrus]
+ Note feature test macro requirements for 'siginfo_t'
+ See https://bugzilla.kernel.org/show_bug.cgi?id=52931
+
+syscalls.2
+ Michael Kerrisk
+ Add kern_features(2)
+ Michael Kerrisk
+ Add utrap_install(2)
+ Sparc-specific, present since ancient times
+ Michael Kerrisk
+ Add finit_module(2)
+
+sysctl.2
+ Michael Kerrisk [Garrett Cooper]
+ ERRORS: EACCES as a synonym for EPRM
+ See https://bugzilla.kernel.org/show_bug.cgi?id=46731
+ and http://thread.gmane.org/gmane.linux.ltp/11413/focus=957635
+ From: Garrett Cooper <yanegomi <at> gmail.com>
+ Subject: Re: [LTP] [PATCH] sysctl03: sysctl returns EACCES after 2.6.33-rc1
+ Newsgroups: gmane.linux.kernel, gmane.linux.ltp
+ Date: 2010-03-04 18:35:33 GMT
+
+unshare.2
+ Michael Kerrisk
+ Update NOTES on unimplemented flags
+ Michael Kerrisk
+ Fix text problems in description of CLONE_FS
+ Michael Kerrisk
+ SEE ALSO: add kcmp(2)
+ SEE ALSO: add setns(2)
+ Michael Kerrisk
+ Reorder CLONE_NEWUTS entry in list
+
+difftime.3
+ Michael Kerrisk [Michal Gorny]
+ Remove crufty text about 'time_t' on "other systems"
+ Back in 2006, some text came in via Debian patches that seems
+ crufty. Remove it.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=46731
+
+getaddrinfo.3
+getnameinfo.3
+ Michael Kerrisk [Peter Budny]
+ Fix some confused references to function names
+ See https://bugzilla.kernel.org/show_bug.cgi?id=52741
+
+getspnam.3
+ Michael Kerrisk [Wolfgang Rohdewald]
+ ERRORS: Add EACCES
+ See https://bugzilla.kernel.org/show_bug.cgi?id=52681
+
+__setfpucw.3
+ Michael Kerrisk
+ Add proper page cross refs for alternate functions
+
+core.5
+proc.5
+ Kees Cook
+ Clarify suid_dumpable versus core_pattern
+ In Linux 3.6, additional requirements were placed on core_pattern
+ when suid_dumpable is set to 2. Document this and include commit
+ references.
+ Justin Lebar
+ statm's "shared" field refers to pages backed by files
+ I noticed that statm's "shared" field doesn't match the sum of
+ all the "shared" entries in smaps [1].
+
+ The kernel docs explain that statm's "shared" field is "number of
+ pages that are shared (i.e. backed by a file)" [2]. smaps appears
+ to call a page shared if it's mapped by at least two processes,
+ which explains this discrepancy.
+
+ I'm not a kernel hacker, but it appears to me they do mean "i.e."
+ and not "e.g." in the statm description: In
+ fs/proc/task_mmu.c::task_statm, I see
+
+ *shared = get_mm_counter(mm, MM_FILEPAGES);
+
+ Here's a patch which updates the man page to match the (hopefully
+ correct) kernel docs.
+
+ [1] https://bugzilla.mozilla.org/show_bug.cgi?id=807181
+ [2] http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob;f=Documentation/filesystems/proc.txt;h=a1793d670cd01bd374eddf54ffdfc768504291ff;hb=HEAD
+
+proc.5
+ Kees Cook
+ Put /proc/sys/kernel/hotplug in alphabetical order
+ Kees Cook
+ Document /proc/sys/kernel/dmesg_restrict
+ Kees Cook
+ Linux 3.4 changed permissions needed to change kptr_restrict
+ Michael Kerrisk [Samuel Thibault, Simon Paillard]
+ Add field numbers for /proc/PID/stat
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
+ Add numbering to /proc/stat "cpu" fields
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
+ Michael Kerrisk
+ Reorganize text describing /proc/stat "cpu" fields
+ Michael Kerrisk
+ Rewording of suid_dumpable text after comments from Kees Cook
+ Michael Kerrisk [Samuel Thibault, Simon Paillard]
+ Add field numbers for /proc/[pid]/statm
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
+ Michael Kerrisk
+ Document /proc/stat "cpu" "nice_guest" field
+ Info taken from commit ce0e7b28fb75cb003cfc8d0238613aaf1c55e797
+ Michael Kerrisk [Peter Lekeynstein]
+ Document /prod/[pid]/oom_score_adj
+ Text taken directly from Documentation/filesystems/proc.txt,
+ with some light editing.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=50421
+
+shells.5
+ Michael Kerrisk
+ Add /etc/bash to list of example shells
+
+ttytype.5
+ Michael Kerrisk
+ Add proper xref for termcap and terminfo pages
+
+capabilities.7
+ Michael Kerrisk
+ Add kcmp(2) under CAP_SYS_PTRACE
+
+man-pages.7
+ Michael Kerrisk
+ Update description of Section 7
+
+
+==================== Changes in man-pages-3.47 ====================
+
+Released: 2013-02-12, Christchurch
+
+
+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:
+
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Lennart Poettering <lennart@poettering.net>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peter Schiffer <pschiffe@redhat.com>
+Radek Pazdera <rpazdera@redhat.com>
+Reuben Thomas <rrt@sc3d.org>
+Shawn Landden <shawnlandden@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Vince Weaver <vweaver1@eecs.utk.edu>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+perf_event_open.2
+ Vincent Weaver
+ New page documenting perf_event_open(2)
+
+pthread_setname_np.3
+ Chandan Apsangi, Michael Kerrisk
+ New page for pthread_setname_np(3) and pthread_getname_np(3)
+
+sln.8
+ Michael Kerrisk [Peter Schiffer]
+ New page documenting the 'sln' command provided by glibc
+ Inspired by a Red Hat downstream page, but with rather
+ more detail.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+prctl.2
+ Michael Kerrisk [Shawn Landden, Lennart Poettering]
+ Document PR_SET_CHILD_SUBREAPER and PR_GET_CHILD_SUBREAPER
+
+ip.7
+ Radek Pazdera
+ Add source-specific multicast sockopts
+ This patch adds documentation of several source-specific multicast
+ socket options that were added to kernel with implementation
+ of IGMPv3 in 2.5.68.
+
+ The following socket options were added:
+ IP_ADD_SOURCE_MEMBERSHIP
+ IP_DROP_SOURCE_MEMBERSHIP
+ IP_BLOCK_SOURCE
+ IP_UNBLOCK_SOURCE
+ IP_MSFILTER
+
+
+Pages moved across sections
+---------------------------
+
+getcontext.3
+ Michael Kerrisk
+ This page really belongs in Section 3 (moved from Section 2)
+
+getdtablesize.3
+ Michael Kerrisk
+ Move from Section 2
+
+
+New and changed links
+---------------------
+
+getcontext.2
+ Michael Kerrisk
+ Make link to page moved into Section 3
+
+getdtablesize.2
+ Michael Kerrisk
+ Link to renamed getdtablesize.3
+
+setcontext.2
+ Michael Kerrisk
+ Modify link to point to Section 3
+
+pthread_getname_np.3
+ Michael Kerrisk
+ New link to new pthread_setname_np.3
+
+setcontext.3
+ Michael Kerrisk
+ Link to getcontext page renamed into Section 3
+
+
+Changes to individual pages
+---------------------------
+
+fallocate.2
+ Michael Kerrisk
+ SEE ALSO: add fallocate(1)
+
+flock.2
+ Michael Kerrisk
+ SEE ALSO: add flock(1)
+
+fork.2
+ Michael Kerrisk
+ SEE ALSO: add exit(2)
+
+getpriority.2
+ Michael Kerrisk
+ BUGS: note that nice value is per-thread on Linux
+
+getrlimit.2
+ Michael Kerrisk
+ SEE ALSO: add prlimit(1)
+
+gettid.2
+ Michael Kerrisk
+ SEE ALSO: add various system calls that use thread IDs
+
+ioprio_set.2
+ Michael Kerrisk
+ SEE ALSO: add ionice(1)
+
+sched_setaffinity.2
+ Michael Kerrisk
+ SEE ALSO: add taskset(1)
+
+sched_setparam.2
+ Michael Kerrisk
+ Scheduling policy and parameters are per-thread on Linux
+ Direct the reader to the discussion in sched_setscheduler(2).
+
+sched_setscheduler.2
+ Michael Kerrisk
+ Scheduling policy and parameters are per-thread on Linux
+ Michael Kerrisk
+ SEE ALSO: add chrt(1)
+
+setsid.2
+ Michael Kerrisk
+ SEE ALSO: add setsid(1)
+
+shmop.2
+ Michael Kerrisk [Peter Schiffer]
+ ERRORS: Add EIDRM
+ Taken from Red Hat downstream patch
+
+sigaction.2
+makecontext.3
+ Michael Kerrisk
+ Change getcontext/setcontext page ref to Section 3
+
+signal.2
+ Michael Kerrisk [Reuben Thomas]
+ Clarify System V vs BSD semantics for signal()
+
+syscalls.2
+ Michael Kerrisk
+ The list on this page is not just syscalls common to all platforms
+ Michael Kerrisk
+ Add perfctr(2)
+ Add ppc_rtas(2)
+ Michael Kerrisk
+ Add kernel version number of utrap_install(2)
+
+unimplemented.2
+ Michael Kerrisk [Peter Schiffer]
+ Remove mention of kernel version number in DESCRIPTION
+
+inet.3
+ Michael Kerrisk [Peter Schiffer]
+ Fix error in EXAMPLE using inet_aton()
+ See https://bugzilla.redhat.com/show_bug.cgi?id=837090
+ Patch taken from Red Hat downstream.
+
+posix_fallocate.3
+ Michael Kerrisk
+ SEE ALSO: add fallocate(1)
+
+regex.3
+ Reuben Thomas
+ Clarify details of matching
+ The first is that it's far from clear that the end points of the
+ complete string match are stored in the zero'th element of the
+ regmatch_t array; secondly, the phrase "next largest substring
+ match" is positively misleading, implying some sort of size
+ ordering, whereas in fact they are ordered according to their
+ appearance in the regex pattern.
+
+scanf.3
+ Michael Kerrisk
+ Clarify meaning of "string conversions" for 'm' modifier
+ Mike Frysinger
+ Update %a vs %m documentation
+ POSIX.1-2008 adopted the 'm' flag for dynamic allocation. Update
+ page to cover it and relegate the glibc-specific 'a' flag to
+ NOTES.
+
+strtol.3
+ Michael Kerrisk [Peter Schiffer]
+ Replace some bogus text about "thousands separator"
+ See https://bugzilla.redhat.com/show_bug.cgi?id=652870
+
+sysconf.3
+ Michael Kerrisk [Peter Schiffer]
+ Use "_SC_PAGESIZE" consistently on page
+ s/_SC_PAGE_SIZE/_SC_PAGESIZE/ in one instance.
+ From Red Hat downstream patch.
+
+nscd.conf.5
+ Peter Schiffer
+ Add max-db-size and auto-propagate descriptions, default values, + misc
+ * added missing valid services (services and netgroup)
+ * added many default values for options
+ * reordered options according to the nscd.conf file
+ (logical order)
+ * added 2 missing options: max-db-size and auto-propagate
+
+nsswitch.conf.5
+ Peter Schiffer
+ Mention initgroups db
+
+proc.5
+ Michael Kerrisk
+ Document /proc/profile
+ Michael Kerrisk [Peter Schiffer]
+ Update /proc/sys/fs/file-nr to include Linux 2.6 details
+ Michael Kerrisk
+ Clarify relationship between file-max and file-nr
+ The third value in /proc/sys/fs/file-nr is the same as
+ the value in /proc/sys/fs/file-max.
+ Michael Kerrisk
+ Note message written to kernel log when file-max limit is hit
+ Info from Documentation/sysctl/fs.txt.
+ Michael Kerrisk
+ Mention lscpu(1) under discussion of /proc/cpuinfo
+
+resolv.conf.5
+ Michael Kerrisk [Peter Schiffer]
+ Document "single-request-reopen" option
+ Taken from Red Hat downstream patch
+
+ See https://bugzilla.redhat.com/show_bug.cgi?id=717770
+ See http://thread.gmane.org/gmane.linux.man/3161
+
+utmp.5
+ Michael Kerrisk
+ SEE ALSO: add utmpdump(1)
+
+cpuset.7
+ Simon Paillard
+ Add missing 'cpuset.' prefix for some flags
+ See kernel commit e21a05cb408bb9f244f11a0813d4b355dad0822e
+
+svipc.7
+ Michael Kerrisk
+ SEE ALSO: add ipcmk(1), ipcrm(1), ipcs(1)
+
+termio.7
+ Michael Kerrisk
+ SEE ALSO: add reset(1), setterm(1), stty(1), tty(4)
+
+ld.so.8
+ Michael Kerrisk [Peter Schiffer]
+ LD_VERBOSE does not work with ld.so --list and --verify
+ From Red Hat downstream patch
+
+ See https://bugzilla.redhat.com/show_bug.cgi?id=532629
+ Michael Kerrisk
+ SEE ALSO: add sln(8)
+
+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.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.
+
+
+==================== Changes in man-pages-3.49 ====================
+
+Released: 2013-03-10, 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:
+
+Michael Kerrisk <mtk.manpages@gmail.com>
+
+
+Global changes
+--------------
+
+The goal of the changes below to consistently format copyright
+and license information in the comments in the page source
+at the top of each page. This allows for easy scripting to
+extract that information. Following these changes the comments
+the top of the page source should now consistently have the form:
+
+ .\" <copyright info, possibly spread over several lines>
+ .\"
+ .\" %%%LICENSE_START(<license-type>)
+ .\" <license text>
+ .\" %%%LICENSE_END
+ .\" <other comments>
+
+Note that the 'license-type' is merely descriptive. Its purpose is
+to simplify scripting for the purpose of gathering statistics on
+types of licenses used in man-pages. It is NOT a statement about
+the actual licensing of the page; that license is contain INSIDE the
+LICENSE_START...LICENSE_END clause.
+
+All pages
+ Michael Kerrisk
+ Add a LICENSE_START()...LICENSE_END clause in source at
+ top of each page that encapsulates the license text.
+ Michael Kerrisk
+ Put copyright info at top of page, followed by blank line and LICENSE
+
+Various pages
+ Michael Kerrisk
+ Update info in source comments on where to get a copy of the GPL
+
+Various pages
+ Michael Kerrisk
+ Remove "Hey Emacs" comment in page source
+ Only certain pages have this; there is no consistency, so
+ 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
+
+
+==================== Changes in man-pages-3.51 ====================
+
+Released: 2013-04-17, 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:
+
+Andreas Jaeger <aj@suse.de>
+Andrew Clayton <andrew@digital-domain.net>
+Brian M. Carlson <sandals@crustytoothpaste.net>
+Changhee Han <ch0.han@lge.com>
+Cyril Hrubis <chrubis@suse.cz>
+Damien Grassart <damien@grassart.com>
+David Prévot <taffit@debian.org>
+Denis Barbier <bouzim@gmail.com>
+Jeff Moyer <jmoyer@redhat.com>
+Krzysztof Konopko <krzysztof.konopko@gmail.com>
+Kyle McMartin <kyle@mcmartin.ca>
+Mark H Weaver <mhw@netris.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Nicolas Hillegeer <nicolas@hillegeer.com>
+Pavel Emelyanov <xemul@parallels.com>
+Peter Schiffer <pschiffe@redhat.com>
+Radek Pazdera <rpazdera@redhat.com>
+Ralph Loader <suckfish@ihug.co.nz>
+Simon Paillard <spaillard@debian.org>
+The Wanderer <wanderer@fastmail.fm>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+sched_rr_get_interval.2
+ Michael Kerrisk
+ Document /proc/sys/kernel/sched_rr_timeslice_ms
+
+proc.5
+ Pavel Emelyanov
+ Document /proc/[pid]/map_files directory
+ This directory was added in Linux v3.3 and provides info about
+ files being mmap-ed in a way very similar to how /proc/[pid]/fd
+ works.
+
+ v2: Added examples of how links look like and noted dependency
+ on kernel config option CONFIG_CHECKPOINT_RESTORE.
+ Michael Kerrisk
+ Document /proc/sys/kernel/shm_rmid_forced
+
+capabilities.7
+ Michael Kerrisk
+ Document /proc/sys/kernel/cap_last_cap
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: fix placement of word "only"
+
+Various pages
+ Simon Paillard
+ License headers: consistent format
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/since kernel/since Linux/
+
+Various System V IPC pages in Section 2
+ Michael Kerrisk
+ Add "System V" to .TH line and text
+ Make it clear that these pages relate to System V IPC,
+ not POSIX IPC.
+
+
+Changes to individual pages
+---------------------------
+
+access.2
+ Michael Kerrisk [The Wanderer]
+ Clarify RETURN VALUE for F_OK
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=705293
+
+alarm.2
+ Michael Kerrisk
+ Correct the description of behavior when 'seconds' is 0
+
+clone.2
+ Michael Kerrisk [Peter Schiffer]
+ Add prototype for syscall to SYNOPSIS
+ And further clarify the distinction between the system call
+ and the wrapper function in the introductory text.
+ Michael Kerrisk
+ Update feature test macro requirements
+ The requirements quietly changed changed in glibc 2.14
+
+ See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
+ Michael Kerrisk [Mike Frysinger]
+ Clarify differences between clone2() syscall and wrapper function
+ Michael Kerrisk [Mike Frysinger]
+ Note those architectures where the sys_clone argument order differs
+ Michael Kerrisk [Mike Frysinger]
+ Add short subsection noting that blackfin, m68k, and sparc are different
+ Michael Kerrisk
+ Move clone2() text to subsection in description
+ The description of ia64 clone2() should follow the discussion
+ of the raw system call interface.
+ Michael Kerrisk
+ Change subhead for ia64 discussion
+
+getcpu.2
+ Michael Kerrisk
+ Recommend that 'tcache' should be specified as NULL nowadays
+
+io_cancel.2
+ Jeff Moyer, Michael Kerrisk [Cyril Hrubis]
+ Improve description
+
+io_destroy.2
+ Jeff Moyer
+ Improve description
+ The description was rather vague, citing a "list of I/O contexts"
+ and stating that it "can" cancel outstanding requests. This
+ update makes things more concrete so that the reader knows exactly
+ what's going on.
+
+io_getevents.2
+ Jeff Moyer
+ The 'timeout' argument is not updated
+ I looked back through the kernel code, and the timeout was
+ never updated in any case. I've submitted a patch upstream
+ to change the comment above io_getevents.
+
+io_setup.2
+ Jeff Moyer
+ Clarify nr_events
+ nr_events is technically the number of completion events that can
+ be stored in the completion ring. The wording of the man page:
+ "capable of receiving at least nr_events" seems dubious to me,
+ only because I worry that folks might interpret that to mean
+ 'nr_events' total, instead of 'nr_events' concurrently.
+
+ Further, I've added information on where to find the per-user
+ limit on 'nr_events', /proc/sys/fs/aio-max-nr. Let me know if
+ you think that is not relevant.
+
+listxattr.2
+ Michael Kerrisk
+ Explain use of 'size' argument
+
+lseek.2
+ Michael Kerrisk [Andreas Jaeger]
+ _GNU_SOURCE must be defined to get SEEK_DATE and SEEK_HOLE definitions
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=15312
+
+mmap.2
+ Michael Kerrisk
+ Add pointers to relevant /proc files described in proc(5)
+
+posix_fadvise.2
+pread.2
+readahead.2
+sync_file_range.2
+truncate.2
+ Michael Kerrisk
+ Refer to syscall(2) for ABI semantics on certain 32-bit architectures
+ Also: in sync_file_range.2 and posix_fadvise.2 remove description
+ of conventional calling signature as flawed, and in
+ posix_fadvise.2, de-emphasize focus on ARM, and rather phrase
+ as a more general discussion of certain architectures.
+
+readdir.2
+ Michael Kerrisk
+ readdir(2) doesn't exist on x86-64
+
+semop.2
+ Michael Kerrisk
+ Clarify the discussion of 'semadj'
+
+shmctl.2
+ Michael Kerrisk
+ Refer to proc(5) for description of /proc/sys/kernel/shm_rmid_forced
+
+syscall.2
+ Changhee Han
+ Add notes that caution users when passing arguments to syscall()
+ For example, passing 'long long' on ARM-32 requires special
+ treatment.
+ Mike Frysinger [Michael Kerrisk]
+ Document the exact calling convention for architecture system calls
+ Mike Frysinger [Kyle McMartin]
+ Add PA-RISC details under calling conventions
+ Michael Kerrisk [Mike Frysinger]
+ Refine discussion of ARM and other ABIs
+
+syscalls.2
+ Michael Kerrisk
+ Update kernel version number at start of list
+
+umask.2
+ Michael Kerrisk
+ SEE ALSO: add acl(5)
+
+unshare.2
+ Michael Kerrisk
+ Update feature test macro requirements
+ The requirements quietly changed changed in glibc 2.14
+
+ See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
+
+fopencookie.3
+ Michael Kerrisk [Ralph Loader]
+ Correct definition of cookie_io_functions_t
+
+pthread_setname_np.3
+ Andrew Clayton
+ The thread argument is passed in by value
+
+readir.3
+seekdir.3
+telldir.3
+ Michael Kerrisk
+ Eliminate the implication that these functions deal with "offsets"
+ The directory position dealt with by the readdir() and
+ friends is not a simple file offset in modern file systems.
+ Typically, it is some kind of cookie value. Add text and
+ make other changes to these pages to eliminate the
+ implication that this is an offset, and warn the reader
+ that directory positions should be treated strictly as
+ opaque values.
+
+ In the process, rename the 'offset' argument of seekdir(3)
+ to 'loc', and add some text to readdir(3) to note that
+ the 'd_off' field is the same value returned by telldir(3)
+ at the current directory position.
+
+ See also https://lwn.net/Articles/544298/
+
+scalb.3
+ Mark H Weaver
+ Fix prototypes for scalbf() and scalbl()
+
+sched_getcpu.3
+ Michael Kerrisk
+ Update feature test macro requirements
+ The requirements quietly changed changed in glibc 2.14
+
+ See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
+
+ualarm.3
+ Michael Kerrisk [Nicolas Hillegeer]
+ Add note on the behavior when 'usecs' is zero
+ POSIX.1-2001 does not specify the behavior in this case
+ and no other system that I checked documented the behavior.
+ Probably, most or all systems do what Linux does in this
+ case: cancel any pending alarm, just as alarm(0) does.
+ Add that info in NOTES.
+
+elf.5
+ Mike Frysinger
+ Add byte positions for all EI_xxx fields
+ When describing e_ident, most of the EI_xxx defines mention the
+ exact byte number. This is useful when manually hacking an ELF
+ with a hex editor. However, the last few fields don't do this,
+ which means you have to count things up yourself.
+ Add a single word to each so you don't have to do that.
+
+proc.5
+ Michael Kerrisk
+ Refer to sched_rr_get_interval(2) for info on sched_rr_timeslice_ms
+ Since Linux 3.9, /proc/sys/kernel/sched_rr_timeslice_ms can
+ be used to change the SCHED_RR quantum.
+ Michael Kerrisk
+ SEE ALSO: Add sysctl(8)
+ Krzysztof Konopko
+ Simplify the example of printing out environ
+ The binutils package contains a very handy utility to
+ print out null-byte delimited strings from a file. This
+ can replace a rather complex expression with cat(1)
+ provided as an example for printing out /proc/[pid]/environ.
+ Michael Kerrisk
+ Update /proc/PID/maps example
+ Update to 64-bit example that includes "[heap]", "[stack],
+ and "[vdso]"
+ Michael Kerrisk
+ Formatting fixes for /proc/PID/maps
+ Mike Frysinger
+ Document the "pathname" field of /proc/PID/maps
+ Michael Kerrisk
+ Add reference to capabilities(7) for /proc/sys/kernel/cap_last_cap
+ Michael Kerrisk
+ /proc/PID/maps: add a reference to mmap(2)
+
+ip.7
+ Radek Pazdera
+ Document IP_MULTICAST_ALL
+ This commit adds documentation for the IP_MULTICAST_ALL socket
+ option.
+
+ The option was added to the Linux kernel in 2.6.31:
+
+ Author Nivedita Singhvi <niv@us.ibm.com>
+ Commit f771bef98004d9d141b085d987a77d06669d4f4f
+
+ The description is based on a previous one [3] posted by the
+ original author of the code -- Nivedita, but it is slightly
+ re-worded.
+
+ I tested it myself and it works as described.
+
+ References:
+ [1] http://lxr.free-electrons.com/source/net/ipv4/ip_sockglue.c#L972
+ [2] http://lxr.free-electrons.com/source/net/ipv4/igmp.c#L2267
+ [3] http://patchwork.ozlabs.org/patch/28902/
+
+units.7
+ Brian M. Carlson
+ units should use an actual µ
+ The units(7) man page uses an ASCII u in place of the actual Greek
+ letter mu. Since we're in the twenty-first century, with
+ UTF-8-compatible terminals and terminal emulators, we should use
+ the actual letter µ instead of an ASCII approximation.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=704787
+
+
+==================== Changes in man-pages-3.52 ====================
+
+Released: 2013-07-04, Christchurch
+
+
+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:
+
+Adrian Bunk <bunk@kernel.org>
+Andrea Remondini <andrea@undeadlinks.com>
+Anthony Foiani <anthony.foiani@gmail.com>
+Brian Norris <computersforpeace@gmail.com>
+Cyril Hrubis <chrubis@suse.cz>
+Dan Jacobson <jidanni@jidanni.org>
+David Prévot <taffit@debian.org>
+Eric S. Raymond <esr@thyrsus.com>
+Georg Sauthoff <mail@georg.so>
+Jeff Moyer <jmoyer@redhat.com>
+Jérémie Galarneau <jeremie.galarneau@efficios.com>
+Jon Grant <jg@jguk.org>
+Manuel Traut <manut@linutronix.de>
+Марк Коренберг <socketpair@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Pavel Emelyanov <xemul@parallels.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter LaDow <petela@gocougs.wsu.edu>
+Petr Gajdos <pgajdos@suse.cz>
+Regid <regid23@nt1.in>
+Siddhesh Poyarekar <siddhesh@redhat.com>
+Simone Piccardi <piccardi@truelite.it>
+Simon Paillard <spaillard@debian.org>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+perf_event_open.2
+ Vince Weaver
+ Add PERF_IOC_FLAG_GROUP documentation
+ The perf_event_open() ENABLE/DISABLE/RESET ioctls can take an
+ argument, PERF_IOC_FLAG_GROUP. This wasn't documented at all
+ until about a year ago (despite the support being there from
+ the beginning) so I missed this when initially writing
+ the man page.
+
+socket.7
+ Pavel Emelyanov, Michael Kerrisk
+ Document SO_PEEK_OFF option
+ Since Linux 3.4 there appeared an ability to specify the
+ offset in bytes from which the data will be MSG_PEEK-ed.
+ Describe this socket option in the socket(7) page, where
+ all the other socket options are described.
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Convert inline formatting (\fX...\fP) to dot-directive formatting
+
+readdir.2
+asprintf.
+getline.3
+getlogin.3
+pthread_setname_np.3
+readdir.3
+strerror.3
+ Michael Kerrisk [Jon Grant]
+ Clarify that terminating null byte is '\0'
+
+
+Changes to individual pages
+---------------------------
+
+execve.2
+ Peter LaDow
+ Add envp to the Linux notes about NULL pointers
+ During the review of static analysis results, we discovered a
+ functional, but non-portable, use of execve(). For example:
+
+ char *cmd[] = { "/path/to/some/file", NULL };
+ execve(cmd[0], cmd, NULL);
+
+ The call succeeds. Yet, the static analysis tool (rightly)
+ pointed out that envp could be dereferenced. But digging into
+ glibc and the kernel, it appears that like argv, envp when NULL
+ is treated as if it were an empty list.
+
+ So, to clear things up, I'm submitting this patch to update the
+ man page to indicate that envp is treated like argv.
+
+fallocate.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+io_setup.2
+ Cyril Hrubis [Jeff Moyer]
+ Clarify the nr_events parameter
+ Currently the io_setup.2 man page describes what the kernel really
+ does, i.e., that the resulting context may be able to hold more
+ than the 'nr_event's operations because the memory allocated in
+ kernel is rounded to be multiple of page size.
+
+ It is better not to expose this implementation detail and
+ simply state that the resulting context is suitable for
+ 'nr_events' operations.
+
+perf_event_open.2
+ Vince Weaver
+ Clarify the perf_event_open() wakeup_events/wakeup_watermark fields
+ Clarify the perf_event_open() wakeup_events/wakeup_watermark
+ fields a bit, based on info from kernel commit cfeb1d90a1b1.
+ Vince Weaver
+ Update to match the Linux 3.10 release
+ This patch updates the perf_event_open() documentation to include
+ new interfaces added in the 3.10 kernel.
+
+ It also documents a few [To be documented] instances left over
+ from the 3.7 kernel.
+ Vince Weaver
+ Small correction to description of 'flags' argument
+
+prctl.2
+ Michael Kerrisk
+ Note equivalents of PR_SET_NAME
+ pthread_setname_np() and pthread_getname_np() and
+ /proc/self/task/TID/comm provide access to the same
+ attribute.
+
+pread.2
+ Michael Kerrisk [Марк Коренберг]
+ pread() and pwrite() are especially useful in multithreaded applications
+
+recv.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+semctl.2
+ Michael Kerrisk [Simone Piccardi]
+ 'sem_nsems' is 'unsigned long' since Linux 2.4
+
+shmget.2
+ Michael Kerrisk
+ Rewrite RETURN VALUE and mention that 'errno' is set on error
+
+sigaction.2
+ Michael Kerrisk [Brian Norris]
+ RETURN VALUE: mention that 'errno' is set on error
+
+signal.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+sigpending.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+sigprocmask.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+sigsuspend.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+syscall.2
+ Mike Frysinger
+ Document s390/s390x calling convention
+
+a64l.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function l64a() is not thread safe.
+
+abs.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions abs(), labs(), llabs() and imaxabs() are
+ thread-safe.
+
+aio_error.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function aio_error() is thread safe.
+
+aio_return.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function aio_return() is thread safe.
+
+alloca.3
+ Adrian Bunk
+ Correct information on getting non-inlined version with gcc+glibc
+ - remove the incorrect information that -fno-builtin would help
+ - add -std=c11 to the list of strict options
+ - emphasize more that both the gcc option and not including
+ alloca.h are needed
+ - add the #ifdef from the glibc alloca.h to make the situation
+ clearer
+
+bindresvport.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ Before glibc 2.17, bindresvport() is not thread-safe.
+ Since glibc 2.17, it is thread-safe, the patch can refer to URL:
+ http://sourceware.org/git/?p=glibc.git;a=commit;h=f6da27e53695ad1cc0e2a9490358decbbfdff5e5
+
+canonicalize_file_name.3
+ Michael Kerrisk
+ Put CONFORMING TO section in right location
+
+catgets.3
+ Michael Kerrisk [Jon Grant]
+ Clarify that null byte is '\0'
+
+ceil.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ceil(), ceilf() and ceill() are thread safe.
+
+cimag.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions cimag(), cimagf() and cimagl() are thread safe.
+
+clock_getcpuclockid.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function clock_getcpuclockid() is thread safe.
+
+conj.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions conj(), conjf() and conjl() are thread safe.
+
+crypt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function crypt() is not thread safe.
+
+ctermid.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function ctermid() is thread safe with exceptions.
+
+dirfd.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+drand48.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions drand48(), erand48(), lrand48(), nrand48(),
+ mrand48(), jrand48(), srand48(), seed48() and lcong48() are
+ not thread safe.
+
+ecvt.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions ecvt() and fcvt() return a string located in a
+ static buffer which is overwritten by the next call to the
+ functions, so they are not thread-safe.
+
+encrypt.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions encrypt() and setkey() are not thread safe.
+
+ether_aton.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions ether_aton() and ether_ntoa() are not thread safe.
+
+fcloseall.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function fcloseall() is not thread safe.
+
+ferror.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ferror(), clearerr(), feof() and fileno() are
+ thread safe.
+
+fgetgrent.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+fgetpwent.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+fgetwc.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+fmtmsg.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ Before glibc 2.16, fmtmsg() is not thread-safe.
+ Since glibc 2.16, it is thread-safe, the patch can refer to URL:
+ http://sourceware.org/git/?p=glibc.git;a=commit;h=7724defcf8873116fe4efab256596861eef21a94
+
+fputwc.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+getdate.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are and aren't thread-safe
+
+getgrent.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function getgrent() is not thread safe.
+
+getgrnam.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are and aren't thread-safe
+
+getline.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+getlogin.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function getlogin() is not thread safe.
+ The function cuserid() is thread-safe with exceptions.
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+getpass.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+
+getpwent.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function getpwent() is not thread safe.
+
+getpwnam.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are and aren't thread-safe
+
+getspnam.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+getttyent.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+
+getusershell.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions getusershell(), setusershell() and endusershell()
+ are not thread safe.
+
+getutent.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+hsearch.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+hsearch.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions hsearch(), hcreate() and hdestroy() are not
+ thread-safe.
+
+localeconv.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The function localeconv() returns a pointer to a structure which
+ might be overwritten by subsequent calls to localeconv() or by
+ calls to setlocale(), so it is not thread-safe.
+ Peng Haitao
+ Add RETURN VALUE section
+
+malloc_info.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+mblen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function mblen() is not thread safe.
+
+mbrlen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function mbrlen() is thread safe with exceptions.
+
+mbrtowc.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function mbrtowc() is thread safe with exceptions.
+
+mktemp.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+modf.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions modf(), modff() and modfl() are thread safe.
+
+popen.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+pthread_attr_setinheritsched.3
+ Michael Kerrisk
+ Note the scheduling attributes affected by this function
+
+pthread_attr_setschedparam.3
+pthread_attr_setschedpolicy.3
+pthread_attr_setscope.3
+ Michael Kerrisk [Manuel Traut, Siddhesh Poyarekar]
+ The inherit-scheduler attribute must be set to PTHREAD_EXPLICIT_SCHED
+ In order for the attributes set by these functions to have
+ an effect, the caller must use pthread_attr_setinheritsched(3)
+ to set the inherit-scheduler attribute of the attributes object
+ to PTHREAD_EXPLICIT_SCHED.
+
+ptsname.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function ptsname() is not thread safe.
+
+putenv.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+putpwent.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+qecvt.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions qecvt() and qfcvt() are not thread-safe.
+
+random.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+ Michael Kerrisk
+ Add EINVAL error for setstate()
+ Michael Kerrisk
+ BUGS: initstate() does not return NULL on error
+ http://sourceware.org/bugzilla/show_bug.cgi?id=15380
+
+random_r.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+readdir.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The data returned by readdir() may be overwritten by subsequent
+ calls to readdir() for the same directory stream, so it is not
+ thread-safe.
+
+re_comp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions re_comp() and re_exec() are not thread safe.
+
+rexec.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions rexec() and rexec_af() are not thread safe.
+
+round.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions round(), roundf() and roundl() are thread safe.
+
+scalbln.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions scalbn(), scalbnf(), scalbnl(), scalbln(),
+ scalblnf() and scalblnl() are thread safe.
+
+scandir.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+siginterrupt.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+signbit.3
+ Peng Haitao
+ ATTRIBUTES: Note macro that is thread-safe
+ The macro signbit() is thread safe.
+
+sigsetops.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+stdio_ext.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions __fbufsize(), __fpending(), __fpurge() and
+ __fsetlocking() are not thread safe.
+
+strdup.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+strerror.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function strerror() is not thread safe.
+
+strftime.3
+ Michael Kerrisk
+ Clarify details of return value
+ Michael Kerrisk
+ BUGS: 'errno' is not set if the result string would exceed 'max' bytes
+
+strtok.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function strtok() is not thread safe.
+ Michael Kerrisk [Georg Sauthoff]
+ Add more detail on the operation of strtok()
+ Add a number of missing details on the operation of strtok()
+
+tempnam.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+timegm.3
+ Jérémie Galarneau
+ copy the string returned by getenv()
+ The example of a portable version of timegm() uses the string
+ returned by getenv() after calling setenv() on the same
+ environment variable. The tz string may be invalid as per
+ getenv.3:
+
+ "The string pointed to by the return value of getenv()
+ may be statically allocated, and can be modified by a
+ subsequent call to getenv(), putenv(3), setenv(3), or
+ unsetenv(3)."
+
+tmpnam.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function tmpnam() is thread safe with exceptions.
+
+trunc.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions trunc(), truncf() and truncl() are thread safe.
+
+ttyname.3
+ Michael Kerrisk
+ ATTRIBUTES: Note functions that are and aren't thread-safe
+
+ttyslot.3
+ Michael Kerrisk
+ ATTRIBUTES: Note functions that are not thread-safe
+
+usleep.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+wcsdup.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+core.5
+ Michael Kerrisk
+ Implicitly adding the PID to a core filename was dropped in 2.6.27
+
+proc.5
+ Michael Kerrisk
+ Document /proc/[pid]/fd/ anon_inode symlinks
+ Mike Frysinger
+ Document /proc/[pid]/fd/ symlinks a bit more
+ Describe the type:[inode] syntax used in this dir
+
+bootparam.7
+ Michael Kerrisk [Dan Jacobson]
+ Remove outdated text on LILO and LoadLin
+ Strike the discussion of LILO and LoadLin, which
+ are long obsolete, and make a brief mention of GRUB.
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604019
+ Regid
+ Remove mention of the deprecated rdev(8)
+ The deprecated rdev(8) command was removed from util-linux in 2010.
+ See https://git.kernel.org/?p=utils/util-linux/util-linux.git;a=commit;h=a3e40c14651fccf18e7954f081e601389baefe3fO
+ Andrea Remondini
+ Document the 'resume' boot parameter
+
+inotify.7
+ Michael Kerrisk [Jon Grant]
+ Clarify that null byte is '\0'
+
+iso_8859-2.7
+ Eric S. Raymond
+ Remove incorrect reference to nonexistent groff glyph \[shc]
+ The reference incorrectly attempted to duplicate an
+ actual soft hyphen (hex 0xad) just before it in the file.
+
+man-pages.7
+ Peng Haitao
+ Add description of "ATTRIBUTES"
+ "ATTRIBUTES" section can mention thread safety,
+ cancellation safety, and async-cancel-safety.
+
+socket.7
+ Michael Kerrisk
+ Note that 'optval' for socket options is an 'int' in most cases
+
+tcp.7
+ Michael Kerrisk
+ Note that 'optval' for socket options is an 'int' in most cases
+
+udp.7
+ Michael Kerrisk
+ Note that 'optval' for socket options is an 'int' in most cases
+
+
+==================== Changes in man-pages-3.53 ====================
+
+Released: 2013-07-31, 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:
+
+Al Viro <viro@ZenIV.linux.org.uk>
+Andrey Vagin <avagin@openvz.org>
+Benjamin Poirier <bpoirier@suse.de>
+Chris Heath <chris@heathens.co.nz>
+Chuck Coffing <clc@alum.mit.edu>
+David Prévot <taffit@debian.org>
+Denys Vlasenko <dvlasenk@redhat.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Felix Schulte <Felix_Schulte@McAfee.com>
+Graud <graud@gmx.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Oleg Nesterov <oleg@redhat.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Schiffer <pschiffe@redhat.com>
+Simon Paillard <spaillard@debian.org>
+Vince Weaver <vincent.weaver@maine.edu>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+restart_syscall.2
+ Michael Kerrisk
+ New page for restart_syscall(2) system call
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fchownat.2
+ Michael Kerrisk
+ Document AT_EMPTY_PATH
+
+fstatat.2
+ Michael Kerrisk
+ Document AT_EMPTY_PATH
+
+linkat.2
+ Michael Kerrisk
+ Document AT_EMPTY_PATH
+
+open.2
+ Michael Kerrisk [Al Viro]
+ Document O_PATH
+ See also https://bugzilla.redhat.com/show_bug.cgi?id=885740
+
+
+Changes to individual pages
+---------------------------
+
+clock_nanosleep.2
+futex.2
+nanosleep.2
+poll.2
+sigaction.2
+sigreturn.2
+signal.7
+ Michael Kerrisk
+ SEE ALSO: add restart_syscall(2)
+
+open.2
+ Michael Kerrisk [Geoffrey Thomas]
+ Remove warning that O_DIRECTORY is only for use with opendir(3)
+ O_DIRECTORY can also be used with, for example, O_PATH.
+
+perf_event_open.2
+ Vince Weaver
+ Improve PERF_SAMPLE_BRANCH_STACK documentation
+ Vince Weaver
+ Fix indentation of the MMAP layout section
+ The indentation of the MMAP layout section wasn't quite right.
+ I think this improves things but I admit I'm not an expert at the
+ low-level indentation directives.
+ Vince Weaver
+ Update PERF_IOC_FLAG_GROUP info
+ It turns out PERF_IOC_FLAG_GROUP was broken from 75f937f24bd9
+ (in Linux 2.6.31, the initial perf_event release) until
+ 724b6daa1 (Linux 3.4).
+
+ I've done some extensive kernel source code digging plus
+ running tests of various kernels and I hope the info
+ presented is accurate now.
+
+ (Patch edited somewhat by mtk.)
+ Vince Weaver
+ Improve sysfs files documentation
+ This improves the documentation of the various
+ perf_event_open()-related sysfs files.
+
+ptrace.2
+ Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
+ If SEIZE was used, initial auto-attach stop is EVENT_STOP
+ For every PTRACE_O_TRACEfoo option, mention that old-style SIGSTOP
+ is replaced by PTRACE_EVENT_STOP if PTRACE_SEIZE attach was used.
+
+ Mention the same thing again in the description of
+ PTRACE_EVENT_STOP.
+ Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
+ Mention that PTRACE_PEEK* libc API and kernel API are different
+ Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
+ Clarify PTRACE_INTERRUPT, PTRACE_LISTEN, and group-stop behavior
+
+readlink.2
+ Michael Kerrisk
+ Document use of empty 'pathname' argument
+ Michael Kerrisk
+ Change error check in example program from "< 0" to "== -1"
+ Chuck Coffing
+ Fix possible race condition in readlink.2 example
+ I noticed that the example in the readlink.2 man pages does error
+ checking for a race condition that would cause the value of the
+ symbolic link to get larger. However, it doesn't handle the
+ opposite case, in which the value gets shorter. (The NULL
+ terminator is always set at the old, longer offset.) This could
+ cause the program to operate on uninitialized data.
+
+setpgid.2
+ Michael Kerrisk [Graud]
+ s/SIGTSTP/SIGTTIN/ when discussing reads from terminal
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60504
+
+clog2.3
+ Michael Kerrisk
+ Note that these functions are still not present in glibc 2.17
+
+dirfd.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function dirfd() is thread safe.
+
+div.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions div(), ldiv(), lldiv() and imaxdiv() are thread
+ safe.
+
+fabs.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fabs(), fabsf() and fabsl() are thread safe.
+
+fdim.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fdim(), fdimf() and fdiml() are thread safe.
+
+fflush.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function fflush() is thread safe.
+
+finite.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions finite(), finitef(), finitel(), isinf(), isinff(),
+ isinfl(), isnan(), isnanf() and isnanl() are thread safe.
+
+flockfile.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions flockfile(), ftrylockfile() and funlockfile() are
+ thread safe.
+
+floor.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions floor(), floorf() and floorl() are thread safe.
+
+resolv.conf.5
+ Simon Paillard
+ Explain how to set empty domain
+ See http://bugs.debian.org/463575
+
+capabilities.7
+ Michael Kerrisk
+ Add open_by_handle_at(2) under CAP_DAC_READ_SEARCH
+
+inotify.7
+ Michael Kerrisk [Felix Schulte]
+ Clarify description of IN_MOVED_FROM and IN_MOVED_TO
+
+man-pages.7
+ Michael Kerrisk
+ DESCRIPTION should note versions for new interface features or behavior
+
+udp.7
+ Benjamin Poirier
+ Add missing #include directive
+ Using the UDP_CORK socket option documented in udp.7 requires
+ including <netinet/udp.h>.
+
+ld.so.8
+ Michael Kerrisk
+ Rework rpath token expansion text
+ Michael Kerrisk
+ Describe $PLATFORM rpath token
+ Michael Kerrisk
+ Describe $LIB rpath token
+ Michael Kerrisk
+ Document LD_BIND_NOT
+ Michael Kerrisk [Simon Paillard]
+ Add reference to pthreads(7) in discussion of LD_ASSUME_KERNEL
+
+
+==================== Changes in man-pages-3.54 ====================
+
+Released: 2013-09-17, 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:
+
+A. Costa <agcosta@gis.net>
+Akihiro MOTOKI <amotoki@gmail.com>
+Andreas Wiese <aw-lkml@instandbesetzt.net>
+Andrew Hunter <andrewhhunter@gmail.com>
+Chen Gang <gang.chen@asianux.com>
+Christopher Hall <chall0@gmail.com>
+Christos Tsopokis <christos@tsopokis.gr>
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Doug Goldstein <cardoe@cardoe.com>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
+Felix Janda <felix.janda@posteo.de>
+G.raud <graud@gmx.com>
+Hannes Landeholm <hannes@jumpstarter.io>
+J. Bruce Fields <bfields@fieldses.org>
+J. Bruce Fields <bfields@redhat.com>
+Johan Erlandsson <jeoerl@gmail.com>
+Jon Grant <jg@jguk.org>
+Magnus Reftel <magnus.reftel@gmail.com>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Oleg Nesterov <oleg@redhat.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Schiffer <pschiffe@redhat.com>
+Robert Harris <robert.harris@fixnetix.com>
+Rodrigo Campos <rodrigo@sdfg.com.ar>
+Simon Paillard <spaillard@debian.org>
+Stas <stas.grumbler@gmail.com>
+Vince Weaver <vincent.weaver@maine.edu>
+Will Newton <will.newton@linaro.org>
+Zdenek Pavlas <zpavlas@redhat.com>
+Zsbán Ambrus <ambrus@math.bme.hu>
+
+Apologies if I missed anyone!
+
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+ioctl_list.2
+ Zsbán Ambrus
+ Document FAT_IOCTL_GET_ATTRIBUTES
+ The attached patch adds four ioctls from linux/msdos_fs.h to the
+ ioctl_list(2) manpage.
+
+ The ioctl FAT_IOCTL_GET_ATTRIBUTES reads FAT attributes of a
+ file a mounted vfat file system. I tested this on Linux
+ 2.6.33, an example script can be found at
+ http://www.perlmonks.com/?node_id=832623
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/file system/filesystem/
+ Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
+ "filesystem" is the form used by the great majority of man pages
+ outside the man-pages project and in a number of other sources,
+ so let's go with that.
+
+
+Changes to individual pages
+---------------------------
+
+access.2
+ J. Bruce Fields
+ Fix outdated NFS information
+ Note that NFS versions since version 3 support an "access" call
+ so that the client doesn't have to guess permissions or ID
+ mapping on its own.
+
+ (See RFC 1813 sections 1.7 and 3.3.4.)
+
+adjtimex.2
+ Michael Kerrisk
+ SEE ALSO: Add adjtimex(8)
+
+clock_getres.2
+ Michael Kerrisk [Rodrigo Campos]
+ Note circumstances in which "SMP" note applies.
+ Michael Kerrisk
+ Add kernel version for CLOCK_*_CPUTIME_ID
+ CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID
+ appeared in 2.6.12.
+ Michael Kerrisk
+ Add VERSIONS section
+
+futex.2
+ Michael Kerrisk
+ The 'timeout' can be rounded upwards by clock granularity and also overrun
+
+kill.2
+ Michael Kerrisk
+ Small improvements to text on historical rules for permissions
+
+nfsservctl.2
+ Michael Kerrisk
+ Note commands that were only in Linux 2.4.x and earlier
+
+open.2
+ Robert Harris
+ Add mmap(2) to list of calls that fail when given an O_PATH descriptor
+ Doug Goldstein
+ Add EINVAL to errors list
+ EINVAL can be returned by open(2) when the underlying filesystem
+ doesn't support O_DIRECT. It is documented in the NOTES section
+ but this patch adds it to the list of possible errors.
+
+perf_event_open.2
+ Vince Weaver
+ PERF_SAMPLE_BRANCH_STACK updates
+ This started out as just adding the new perf_event_open features
+ from Linux 3.11 (which was the addition of transactional memory
+ defines for PERF_SAMPLE_BRANCH_STACK samples) but turned into a
+ general cleanup of the PERF_SAMPLE_BRANCH_STACK documentation.
+
+ The main clarification is that at least one of the non-privilege
+ values must be set or else perf_event_open() will return an EINVAL
+ error.
+ Michael Kerrisk
+ Reorder text describing fields of 'perf_event_header' structure
+ Place the fields with the shorter descriptions first, to make the
+ information easier to read.
+
+poll.2
+ Michael Kerrisk
+ Clarify wording of 'timeout' as a "minimum" interval
+
+sched_setaffinity.2
+ Michael Kerrisk [Christos Tsopokis]
+ Clarify that these system calls affect a per-thread attribute
+
+sched_setparam.2
+ Michael Kerrisk
+ Clarify that this system call applies to threads (not processes)
+
+sched_setscheduler.2
+ Michael Kerrisk
+ Clarify that this system call applies to threads (not processes)
+
+select.2
+ Michael Kerrisk [G.raud]
+ Clarify wording of 'timeout' as a "minimum" interval
+
+setfsgid.2
+ Michael Kerrisk [Oleg Nesterov]
+ Clarify description of return value
+ More clearly describe the weirdness in the return value of this
+ system call, and note the problems it creates in BUGS
+ Michael Kerrisk
+ Correct header file in SYNOPSIS
+ Michael Kerrisk
+ Refer to setfsuid(2) for an explanation of why setfsgid() is obsolete
+ Michael Kerrisk
+ Wording improvements
+
+setfsuid.2
+ Michael Kerrisk [Oleg Nesterov]
+ Clarify description of return value
+ More clearly describe the weirdness in the return value of this
+ system call, and note the problems it creates in BUGS
+ Michael Kerrisk [Chen Gang]
+ Clarify historical details and note that setfsuid() is obsolete
+ Michael Kerrisk
+ Wording improvements
+ Michael Kerrisk
+ Correct header file in SYNOPSIS
+
+sigwaitinfo.2
+ Michael Kerrisk
+ Clarify wording of 'timeout' as a "minimum" interval
+
+syscall.2
+ Johan Erlandsson
+ Add missing argument in example
+ Johan Erlandsson
+ Correct registers for arm/EABI
+ Registers was off by one.
+
+ Reference:
+ http://www.arm.linux.org.uk/developer/patches/viewpatch.php?id=3105/4
+
+ See also:
+ http://peterdn.com/post/e28098Hello-World!e28099-in-ARM-assembly.aspx
+ https://wiki.debian.org/ArmEabiPort
+ http://en.wikipedia.org/wiki/Calling_convention#ARM
+
+wait.2
+ Michael Kerrisk [Hannes Landeholm]
+ Add details on the fifth argument provided by raw waitid() system call
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60744
+
+clock.3
+ Michael Kerrisk
+ clock() switched from using times(2) to clock_gettime() in glibc 2.18
+
+drand48_r.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions drand48_r(), erand48_r(), lrand48_r(),
+ nrand48_r(), mrand48_r(), jrand48_r(), srand48_r(), seed48_r(),
+ and lcong48_r() are thread safe.
+
+fma.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fma(), fmaf() and fmal() are thread safe.
+
+fmax.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fmax(), fmaxf() and fmaxl() are thread safe.
+
+fmin.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fmin(), fminf() and fminl() are thread safe.
+
+fpclassify.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fpclassify(), isfinite(), isnormal(), isnan(), and
+ isinf() are thread safe.
+
+frexp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions frexp(), frexpf() and frexpl() are thread safe.
+
+gethostbyname.3
+ Michael Kerrisk [Jon Grant]
+ gai_strerror() is the modern replacement for herror() and hstrerror()
+ Michael Kerrisk
+ Update feature test macro requirements for herror() and hstrerror()
+ Michael Kerrisk
+ Add feature test macro requirements for h_errno
+
+ilogb.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ilogb(), ilogbf() and ilogbl() are thread safe.
+
+ldexp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ldexp(), ldexpf() and ldexpl() are thread safe.
+
+lrint.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions lrint(), lrintf(), lrintl(), llrint(), llrintf(),
+ and llrintl() are thread safe.
+
+lround.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions lround(), lroundf(), lroundl(), llround(),
+ llroundf() and llroundl() are thread safe.
+
+lseek64.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function lseek64() is thread safe.
+
+mbsinit.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function mbsinit() is thread safe.
+
+nextafter.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions nextafter(), nextafterf(), nextafterl(),
+ nexttoward(), nexttowardf() and nexttowardl() are thread safe.
+
+posix_memalign.3
+ Michael Kerrisk [Will Newton]
+ 'errno" is indeterminate after a call to posix_memalign()
+ Michael Kerrisk [Will Newton]
+ Clarify wording on "return value" when size==0
+
+printf.3
+ Christopher Hall
+ Correctly describe the meaning of a negative precision
+ The printf(3) manpage says that a negative precision is taken to
+ be zero, whereas printf(3p) says that a negative precision is
+ taken as if the precision were omitted. glibc agrees with the
+ latter (POSIX) specification.
+
+ Test code:
+
+ printf("%f\n",42.0); // "42.000000"
+ printf("%.*f\n",0,42.0); // "42"
+ printf("%.*f\n",-1,42.0); // "42.000000"
+
+ This patch corrects the explanation to match what actually happens.
+
+rewinddir.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function rewinddir() is thread safe.
+
+rint.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions nearbyint(), nearbyintf(), nearbyintl(), rint(),
+ rintf() and rintl() are thread safe.
+
+seekdir.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function seekdir() is thread safe.
+
+telldir.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function telldir() is thread safe.
+
+wctomb.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function wctomb() is not thread safe.
+
+wavelan.4
+ Michael Kerrisk [Elie De Brauwer]
+ This driver disappeared in 2.56.35
+
+dir_colors.5
+ Michael Kerrisk [Stas]
+ Add various synonyms
+ See http://bugs.debian.org/553477
+ Simon Paillard [Stas]
+ Add keywords SUID, SGID, STICKY, STICKY_OTHER_WRITABLE, OTHER_WRITABLE
+ See http://bugs.debian.org/553477
+ See ls.c and dircolors.c in coreutils
+
+proc.5
+ Peter Schiffer
+ Document /proc/[pid]/io file
+ Attempt to document fields in the /proc/[pid]/io file, based on
+ the Documentation/filesystems/proc.txt. The text will probably
+ need some grammar corrections.
+ Michael Kerrisk [Marko Myllynen]
+ /proc/sys/fs/inode-max went away in Linux 2.4
+ Also, the 'preshrink' field in /proc/sys/fs/inode-state became
+ a dummy value in Linux 2.4.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60836
+ Michael Kerrisk [A. Costa]
+ Note block size used by /proc/partitions
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=666972
+ Michael Kerrisk
+ Add rationale on drop_caches and note that it can hurt performance
+ See also http://lwn.net/Articles/562211/
+
+bootparam.7
+ Michael Kerrisk [Eugen Dedu]
+ Remove "lilo" entries from SEE ALSO
+ See http://bugs.debian.org/604019
+
+inotify.7
+ Michael Kerrisk
+ SEE ALSO: add inotifywait(1) and inotifywatch(1)
+
+ip.7
+ Simon Paillard
+ IP_MULTICAST_IF setsockopt recognizes struct mreq (compatibility)
+ Kernel added compatibility only recently in
+ 3a084ddb4bf299a6e898a9a07c89f3917f0713f7
+ See: http://bugs.debian.org/607979
+
+standards.7
+ Michael Kerrisk
+ Add mention of SUSv4-TC1 (POSIX.1-2013)
+
+
+==================== Changes in man-pages-3.55 ====================
+
+Released: 2013-12-12, Christchurch
+
+
+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:
+
+Alfred Agrell <alfred@agrell.info>
+Andreas Sandberg <andreas.sandberg@it.uu.se>
+Christoph Hellwig <hch@infradead.org>
+David Gibson <david@gibson.dropbear.id.au>
+David Prévot <taffit@debian.org>
+Fabrice Bauzac <libnoon@gmail.com>
+Greg Price <price@mit.edu>
+Jon Grant <jg@jguk.org>
+KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Liu Jiaming <storypku@gmail.com>
+Maxin B. John <maxin.john@enea.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Paolo Bonzini <bonzini@gnu.org>
+Peng Haitao <penght@cn.fujitsu.com>
+Robert P. J. Day <rpjday@crashcourse.ca>
+Rodrigo Campos <rodrigo@sdfg.com.ar>
+Shawn Landden <shawn@churchofgit.com>
+Trevor Bramwell <trevor@bramwell.net>
+Vince Weaver <vincent.weaver@maine.edu>
+Yang Yang <yangyang.gnu@gmail.com>
+Yuanhang Zheng <zhengyhn@gmail.com>
+Yuri Kozlov <yuray@komyakino.ru>
+janh <a0vhv@t-online.de>
+
+Apologies if I missed anyone!
+
+
+Global changes
+--------------
+
+assert.3
+assert_perror.3
+rexec.3
+rpc.3
+ Michael Kerrisk [Jon Grant]
+ Reword a sentence to use more gender-neutral language
+
+
+Changes to individual pages
+---------------------------
+
+execve.2
+ Michael Kerrisk
+ 'arg...' for interpreter scripts starts with argv[1]
+
+fallocate.2
+ Christoph Hellwig
+ Clarify the zeroing behavior
+ fallocate() zeroes only space that did not previously contain
+ data, but leaves existing data untouched.
+
+futex.2
+ Rodrigo Campos
+ Fix link to Rusty's futex example library
+ When I asked to webmaster@kernel.org, Konstantin Ryabitsev
+ answered that the ".nl." is "an obsolete scheme and really
+ should be changed to just ftp.kernel.org".
+
+getgroups.2
+ Michael Kerrisk
+ Note that NGROUPS_MAX is defined in <limits.h>
+ Michael Kerrisk
+ Clarify that sysconf(_SC_NGROUPS_MAX) is a run-time technique
+ Michael Kerrisk
+ Document /proc/sys/kernel/ngroups_max
+
+ioctl.2
+ Michael Kerrisk [KOSAKI Motohiro, David Gibson]
+ 'request' argument is typed as 'unsigned long' in glibc
+ See https://bugzilla.kernel.org/show_bug.cgi?id=42705
+
+perf_event_open.2
+ Vince Weaver
+ Linux 3.12 rdpmc/mmap
+ It turns out that the perf_event mmap page rdpmc/time setting was
+ broken, dating back to the introduction of the feature. Due
+ to a mistake with a bitfield, two different values mapped to
+ the same feature bit.
+
+ A new somewhat backwards compatible interface was introduced
+ in Linux 3.12. A much longer report on the issue can be found
+ here:
+ https://lwn.net/Articles/567894/
+ Vince Weaver
+ Linux 3.12 adds PERF_SAMPLE_IDENTIFIER
+ A new PERF_SAMPLE_IDENTIFIER sample type was added in Linux 3.12.
+ Vince Weaver
+ E2BIG documentation
+ The following documents the E2BIG error return for
+ perf_event_open().
+
+ I actually ran into this error the hard way and it took me
+ half a day to figure out why my ->size value was changing.
+ Vince Weaver
+ Linux 3.12 adds PERF_EVENT_IOC_ID
+ A new perf_event related ioctl, PERF_EVENT_IOC_ID, was added
+ in Linux 3.12.
+ Vince Weaver
+ PERF_COUNT_SW_DUMMY support
+ Support for the PERF_COUNT_SW_DUMMY event type was added in
+ Linux 3.12.
+ Vince Weaver [Andreas Sandberg]
+ PERF_EVENT_IOC_PERIOD update
+ The PERF_EVENT_IOC_PERIOD ioctl was broken until 2.6.36,
+ and it turns out that the ARM architecture has some
+ differing behavior too.
+
+pipe.2
+ Trevor Bramwell
+ Fix error in example program
+
+poll.2
+ Michael Kerrisk [Paolo Bonzini]
+ Clarify meaning of events==0
+ events==0 does not mean that revents is always returned as
+ zero. The "output only" events (POLLHUP, POLLERR, POLLNVAL)
+ can still be returned.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=61911
+
+readlink.2
+ Michael Kerrisk [Yuanhang Zheng]
+ Fix typo in error message in example program
+
+recv.2
+ Michael Kerrisk
+ Remove out-of-date statement that UNIX domain does not support MSG_TRUNC
+ Should have removed that sentence as part of
+ commit a25601b48b822eb1882ae336574b8d062a17e564
+
+sched_get_priority_max.2
+ Michael Kerrisk
+ Add SCHED_IDLE to discussion
+
+send.2
+ Michael Kerrisk
+ RETURN VALUE: these calls return number of bytes (not characters) sent
+
+setreuid.2
+ Michael Kerrisk
+ Small clarification to description of when saved set-user-ID is set
+
+sigpending.2
+ Michael Kerrisk
+ Note treatment of signals that are blocked *and* ignored
+
+stat.2
+ Michael Kerrisk
+ Note filesystem support for nanosecond timestamps
+ Add some detail on which native filesystems do and don't
+ support nanosecond timestamps.
+ Michael Kerrisk
+ Cosmetic reworking of timestamp discussion in NOTES
+ Michael Kerrisk [Yang Yang]
+ Update discussion of nanosecond timestamps
+ The existing text describes the timestamp fields as 'time_t'
+ and delegates discussion of nanosecond timestamps under NOTES.
+ Nanosecond timestamps have been around for a while now,
+ and are in POSIX.1-2008, so reverse the orientation of the
+ discussion, putting the nanosecond fields into DESCRIPTION
+ and detailing the historical situation under NOTES.
+
+symlink.2
+ Michael Kerrisk
+ Further fine tuning of argument names
+ Follow-up to f2ae6dde0c68448bec986d12fe32268a2c98bfd9
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=16073
+ Michael Kerrisk [Fabrice Bauzac]
+ Give arguments of symlink() more meaningful names
+
+adjtime.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function adjtime() is thread safe.
+
+alloca.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function alloca() is thread safe.
+
+asinh.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions asinh(), asinhf() and asinhl() are thread safe.
+
+atan.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions atan(), atanf() and atanl() are thread safe.
+
+atof.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function atof() is thread safe with exceptions.
+
+atoi.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions atoi(), atol() and atoll() are thread safe with
+ exceptions.
+
+bcmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function bcmp() is thread safe.
+
+bcopy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function bcopy() is thread safe.
+
+bsd_signal.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function bsd_signal() is thread safe.
+
+bzero.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function bzero() is thread safe.
+
+cbrt.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions cbrt(), cbrtf() and cbrtl() are thread safe.
+
+copysign.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions copysign(), copysignf() and copysignl() are thread
+ safe.
+
+cos.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions cos(), cosf() and cosl() are thread safe.
+
+cproj.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions cproj(), cprojf() and cprojl() are thread safe.
+
+creal.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions creal(), crealf() and creall() are thread safe.
+
+daemon.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function daemon() is thread safe.
+
+des_crypt.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ecb_crypt(), cbc_crypt() and des_setparity() are
+ thread safe.
+
+difftime.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function difftime() is thread safe.
+
+dysize.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function dysize() is thread safe.
+
+erf.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions erf(), erff() and erfl() are thread safe.
+
+erfc.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions erfc(), erfcf() and erfcl() are thread safe.
+
+euidaccess.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions euidaccess() and eaccess() are thread safe.
+
+expm1.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions expm1(), expm1f() and expm1l() are thread safe.
+
+fexecve.3
+ Michael Kerrisk
+ POSIX.1-2008 specifies fexecve()
+ Michael Kerrisk
+ Explain the use and rationale of fexecve()
+
+ftime.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function ftime() is thread safe.
+
+ftok.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function ftok() is thread safe.
+
+ftw.3
+ Michael Kerrisk
+ nftw() visits directories with FTW_D if FTW_DEPTH was not specified
+ Michael Kerrisk
+ Explain probable cause of FTW_NS
+
+futimes.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions futimes() and lutimes() are thread safe.
+
+getaddrinfo.3
+ Michael Kerrisk
+ Explain one use case for AI_ADDRCONFIG
+ Michael Kerrisk
+ Highlight difference in ai_flags when hints==NULL
+ NOTES already described how glibc differs from POSIX.
+ Add a pointer to that text from the point in DESCRIPTION
+ where hints==NULL is discussed.
+
+kcmp.3
+ Shawn Landden
+ Reword slightly awkward section
+
+malloc.3
+ Greg Price
+ Scale back promises of alignment
+ It's not true that the return value is suitably aligned for "any
+ variable"; for example, it's unsuitable for a variable like
+ float *x __attribute__ ((__vector_size__ (32)));
+ which requires 32-byte alignment. Types like this are defined in
+ <avxintrin.h>, and with 16-byte alignment in <emmintrin.h> and
+ <xmmintrin.h>, so the application programmer need not even know
+ that a vector_size attribute has been applied.
+
+ On an x86 architecture, a program that loads from or stores to a
+ pointer with this type derived from malloc can crash because GCC
+ generates an aligned load/store, like MOVDQA.
+
+ The C99 standard (TC3, as of N1256) does say the return value is
+ suitably aligned for "any type of object". The C11 standard (as
+ of N1570) revises this to any type with "fundamental alignment",
+ which means an alignment "supported by the implementation in all
+ contexts", which I suppose tautologically includes aligning
+ malloc/realloc return values.
+
+ The actual behavior of current glibc malloc is to align to the
+ greater of 2 * sizeof(size_t) and __alignof__ (long double),
+ which may be one bit greater than this commit promises.
+
+mq_receive.3
+ Michael Kerrisk [janh]
+ msg_len must be greater than *or equal to* mq_msgsize
+ See https://bugzilla.kernel.org/show_bug.cgi?id=64571
+
+setenv.3
+ Michael Kerrisk
+ Clarify that setenv() returns success in the overwrite==0 case
+
+sigsetops.3
+ Michael Kerrisk [Robert P. J. Day]
+ Add 'const' to sigisemptyset(), sigorset(), sigandset() declarations
+ Michael Kerrisk
+ Rework text describing sigisemptyset(), sigorset(), and sigandset()
+
+statvfs.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions statvfs() and fstatvfs() are thread safe.
+
+stdarg.3
+ Peng Haitao
+ ATTRIBUTES: Note macros that are thread-safe
+ The macros va_start(), va_arg(), va_end() and va_copy() are
+ thread safe.
+
+termios.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions tcgetattr(), tcsetattr(), tcsendbreak(),
+ tcdrain(), tcflush(), tcflow(), cfmakeraw(), cfgetispeed(),
+ cfgetospeed(), cfsetispeed(), cfsetospeed() and cfsetspeed()
+ are thread safe.
+
+ungetwc.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function ungetwc() is thread safe.
+
+unlockpt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function unlockpt() is thread safe.
+
+usleep.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function usleep() is thread safe.
+
+wcpcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcpcpy() is thread safe.
+
+wcscasecmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wcscasecmp() is thread safe with exceptions.
+
+wcscat.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcscat() is thread safe.
+
+wcschr.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcschr() is thread safe.
+
+wcscmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcscmp() is thread safe.
+
+wcscpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcscpy() is thread safe.
+
+wcscspn.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcscspn() is thread safe.
+
+wcslen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcslen() is thread safe.
+
+wcsncasecmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wcsncasecmp() is thread safe with exceptions.
+
+wcsncat.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsncat() is thread safe.
+
+wcsncmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsncmp() is thread safe.
+
+wcsncpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsncpy() is thread safe.
+
+wcsnlen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsnlen() is thread safe.
+
+wcspbrk.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcspbrk() is thread safe.
+
+wcsrchr.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsrchr() is thread safe.
+
+wcsspn.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsspn() is thread safe.
+
+wcsstr.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsstr() is thread safe.
+
+wcstoimax.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions wcstoimax() and wcstoumax() are thread safe with
+ exceptions.
+
+wcstok.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcstok() is thread safe.
+
+wcswidth.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wcswidth() is thread safe with exceptions.
+
+wctrans.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wctrans() is thread safe with exceptions.
+
+wctype.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wctype() is thread safe with exceptions.
+
+wcwidth.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wcwidth() is thread safe with exceptions.
+
+wmemchr.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wmemchr() is thread safe.
+
+wmemcmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wmemcmp() is thread safe.
+
+wmemcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wmemcpy() is thread safe.
+
+wmemmove.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wmemmove() is thread safe.
+
+wmemset.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wmemset() is thread safe.
+
+tty_ioctl.4
+ Michael Kerrisk [Liu Jiaming]
+ Note that 'arg' should be 0 in the usual case when using TIOCSCTTY
+ Michael Kerrisk
+ Rework text on root to discuss just in terms of capabilities
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/kernel/ngroups_max
+
+capabilities.7
+ Michael Kerrisk
+ Fix 2 version numbers under "Effect of user ID changes on capabilities"
+
+feature_test_macros.7
+ Michael Kerrisk
+ Add _ISOC11_SOURCE to example program
+
+tcp.7
+ Michael Kerrisk
+ Fix (nontrivial) wordo in discussion of MSG_TRUNC
+ s/MSG_PEEK/MSG_TRUNC/
+
+ld.so.8
+ Michael Kerrisk [Alfred Agrell]
+ Fix crufty wording in one sentence
+
+
+==================== Changes in man-pages-3.56 ====================
+
+Released: 2014-01-11, Christchurch
+
+In memory of Doris Church (1939-2013)
+
+
+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:
+
+Andre Majorel <aym-xunil@teaser.fr>
+Arif Zaman <arifz@lums.edu.pk>
+Bert Wesarg <bert.wesarg@googlemail.com>
+Daniel Borkmann <dborkman@redhat.com>
+David Malcolm <dmalcolm@redhat.com>
+David Prévot <taffit@debian.org>
+Dongsheng Song <dongsheng.song@gmail.com>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+James Smith <james@theta.pw>
+Janne Blomqvist <blomqvist.janne@gmail.com>
+Joseph S. Myers <joseph@codesourcery.com>
+Luke Hutchison <luke.hutch@mit.edu>
+Marco Dione <mdione@grulic.org.ar>
+Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+Mathieu Malaterre <malat@debian.org>
+Matthias Klose <doko@debian.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Moritz 'Morty' Strübe <morty@gmx.net>
+Nadav Har'El <nyh@math.technion.ac.il>
+Ondřej Bílka <neleai@seznam.cz>
+Prádraig Brady <P@draigBrady.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Raphael Geissert <geissert@debian.org>
+Shawn Landden <shawn@churchofgit.com>
+Simon Paillard <spaillard@debian.org>
+Stephen Kell <srk31@srcf.ucam.org>
+Sudhanshu Goswami <Sudhanshu.Goswami@emc.com>
+Sworddragon2 <sworddragon2@aol.com>
+Vince Weaver <vincent.weaver@maine.edu>
+Willem de Bruijn <willemb@google.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+fgetc.3
+gets.3
+ David Malcolm
+ Split gets(3) to isolate unsafe gets(3) to a page on its own
+ Currently man3/gets.3 documents various safe I/O functions, along
+ with the toxic "gets" function.
+
+ At the risk of being melodramatic, this strikes me as akin to
+ storing rat poison in a food cabinet, in the same style of
+ packaging as the food, but with a post-it note on it saying
+ "see warnings below".
+
+ I think such "never use this" functions should be quarantined
+ into their own manpages, rather than listing them alongside
+ sane functions.
+
+ The attached patch does this for "gets", moving the documentation
+ of the good functions from man3/gets.3 into man3/fgetc.3,
+ updating the SO links in the relevant functions to point at the
+ latter.
+
+ It then rewrites man3/gets.3 to spell out that "gets" is toxic
+ and should never be used (with a link to CWE-242 for good
+ measure).
+ Michael Kerrisk [Andre Majorel]
+ Tweaks to David Malcolm's patch
+
+vdso.7
+ Mike Frysinger
+ New page documenting the vDSO mapped into each process by the kernel
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+reboot.2
+ Elie De Brauwer
+ Document LINUX_REBOOT_SW_SUSPEND
+
+
+New and changed links
+---------------------
+
+fgets.3
+getc.3
+getchar.3
+ungetc.3
+ Michael Kerrisk
+ Adjust links to gets(3) to point to fgetc(3)
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix of "NULL pointer"
+ Change "NULL pointer" to "NULL" or null pointer".
+ POSIX uses the term "null pointer", not "NULL pointer".
+
+Various pages
+ Michael Kerrisk
+ Stylistic changes to code example
+ For ease of reading, don't embed assignments inside if().
+
+Various pages
+ Michael Kerrisk
+ Replace uses of "i.e.," in main text with "that is" or similar
+ Usual man-pages style is to use "i.e." only within
+ parenthetical expressions.
+
+Various pages
+ Michael Kerrisk
+ Replace uses of "e.g." in main text with "for example" or similar
+ Usual man-pages style is to use "e.g." only within
+ parenthetical expressions.
+
+Various pages
+ Michael Kerrisk
+ Add "Program source" subheading under EXAMPLE
+
+Various pages
+ Michael Kerrisk
+ Add "static" to global variables and functions in example program
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Michael Kerrisk [Nadav Har'El]
+ Improve description of CLOCK_PROCESS_CPUTIME_ID
+ See https://bugzilla.kernel.org/show_bug.cgi?id=67291
+
+close.2
+ Michael Kerrisk [P?draig Brady]
+ Note that errors from close() should be used only for diagnosis
+ In particular, retrying after EINTR is a bad idea.
+
+ See http://austingroupbugs.net/view.php?id=529
+
+ See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/37702
+ Subject: [RFC][BZ #14627] Make linux close errno to EINPROGRESS
+ when interrupted in signal.
+
+execve.2
+ Michael Kerrisk [Marco Dione]
+ Add further cases to EFAULT error
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=16402
+
+perf_event_open.2
+ Vince Weaver [Sudhanshu Goswami]
+ Clarify issues with the disabled bit
+ Clarify the perf_event_open behavior with respect to the disabled
+ bit and creating event groups.
+ Vince Weaver [Sudhanshu Goswami]
+ Clarify issues with the exclusive bit
+ Warn that using the perf_event_open "exclusive" bit, while
+ it might seem like a good idea, might lead to all 0 results
+ in some common usage cases.
+
+reboot.2
+ Elie De Brauwer
+ Mention RB_POWER_OFF
+ The manpage did not mention RB_POWER_OFF which is the glibc
+ symbolic name for LINUX_REBOOT_CMD_POWER_OFF.
+
+ $ cd /usr/include
+ $ cat x86_64-linux-gnu/sys/reboot.h | grep POWER_OFF
+ define RB_POWER_OFF 0x4321fedc
+ Elie De Brauwer
+ Add "Linux" to kernel version numbers
+ Michael Kerrisk
+ Add RB_SW_SUSPEND synonym
+ Michael Kerrisk
+ Add RB_KEXEC synonym
+
+setpgid.2
+ Michael Kerrisk [Joseph S. Myers]
+ BSD getpgrp() and setpgrp() go away in glibc 2.19
+
+socket.2
+ Michael Kerrisk [Dongsheng Song]
+ Remove crufty statement that AF_INET does not support SOCK_SEQPACKET
+ Linux AF_INET supports SOCK_SEQPACKET via SCTP.
+
+syscall.2
+ Mike Frysinger
+ Fix ia64 registers
+ The original list of registers was created by confusing strace
+ source code--this is for parsing legacy 32-bit code (which is
+ dead and no one cares). Update the list to reflect native ia64
+ syscall interface.
+
+syscall.2
+syscalls.2
+getauxval.3
+ Mike Frysinger
+ Add references to new vdso(7) page
+
+utimensat.2
+ Michael Kerrisk
+ Small wording improvement for times!=NULL case
+
+dlopen.3
+ Michael Kerrisk [Mike Frysinger]
+ Update remarks on cast needed when assigning dlsym() return value
+ POSIX.1-2013 eases life when casting the dlsym() return value to a
+ function pointer
+ Michael Kerrisk [Stephen Kell]
+ Fix description of dli_sname
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=16262
+
+getline.3
+ Michael Kerrisk [Luke Hutchison]
+ Correct description of how '*n' is used when '*lineptr' == NULL
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=5468
+ Michael Kerrisk
+ Remove SEE ALSO reference to unsafe gets(3)
+
+mcheck.3
+ Simon Paillard [Raphael Geissert]
+ typo in compiler flag
+ See http://bugs.debian.org/732464
+
+mkstemp.3
+ Michael Kerrisk [Janne Blomqvist]
+ Better describe 'flags' that can be specified for mkostemp()
+
+printf.3
+ Michael Kerrisk [Arif Zaman]
+ Fix memory leak in snprintf() example
+ See http://stackoverflow.com/questions/19933479/snprintf-man-page-example-memory-leak
+
+pthread_kill.3
+ Michael Kerrisk [Mathieu Desnoyers]
+ POSIX.1-2008 removes ESRCH
+ POSIX.1-2001 mistakenly documented an ESRCH error, and
+ POSIX.1-2008 removes this error. Glibc does return
+ this error in cases where it can determine that a thread ID
+ is invalid, but equally, the use of an invalid thread ID
+ can cause a segmentation fault.
+
+puts.3
+ Michael Kerrisk
+ SEE ALSO: replace reference to gets(3) with fgets(3)
+
+scanf.3
+ Michael Kerrisk [Ondřej Bílka]
+ Improve discussion of obsolete 'a' dynamic allocation modifier
+
+setjmp.3
+ Michael Kerrisk [Joseph S. Myers]
+ BSD setjmp() semantics go away in glibc 2.19
+
+sigpause.3
+ Michael Kerrisk [Joseph S. Myers]
+ BSD sigpause() goes away in glibc 2.19
+ Michael Kerrisk
+ Correct feature text macro requirements
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sigpause() is thread safe.
+
+sigqueue.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sigqueue() is thread safe.
+
+sigwait.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sigwait() is thread safe.
+
+sin.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sin(), sinf() and sinl() are thread safe.
+
+sincos.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sincos(), sincosf() and sincosl() are thread safe.
+
+string.3
+ Moritz 'Morty' Strübe
+ Add short description of the functions
+ It is helpful to have a short description about what the different
+ functions in string.h do.
+ Michael Kerrisk
+ Fixes and enhancements to Moritz Strübe's patch
+
+strptime.3
+ Michael Kerrisk [Mathieu Malaterre, Simon Paillard]
+ Add number ranges to comments in 'tm' structure
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729570
+ Michael Kerrisk
+ Point to ctime(3) for more details on 'tm' structure
+ Michael Kerrisk
+ Some rewording and reorganization
+
+strsep.3
+ Michael Kerrisk
+ Clarify description
+ The use of "symbols" in the existing description is confusing;
+ it's "bytes". Other fixes as well.
+
+strspn.3
+ Michael Kerrisk [Mathieu Malaterre]
+ Improve description in NAME
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=723659
+
+strstr.3
+ Michael Kerrisk
+ Clarify RETURN VALUE: s/substring/located substring/
+
+sysv_signal.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sysv_signal() is thread safe.
+
+tan.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions tan(), tanf() and tanl() are thread safe.
+
+tanh.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions tanh(), tanhf() and tanhl() are thread safe.
+
+toascii.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function toascii() is thread safe.
+
+toupper.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions toupper() and tolower() are thread safe with
+ exceptions.
+
+towctrans.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function towctrans() is thread safe.
+
+towlower.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function towlower() is thread safe with exceptions.
+
+towupper.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function towupper() is thread safe with exceptions.
+
+ualarm.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function ualarm() is thread safe.
+
+wcpncpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcpncpy() is thread safe.
+
+proc.5
+ Michael Kerrisk [Sworddragon2]
+ Fix formula for CommitLimit under /proc/meminfo
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60991
+
+credentials.7
+ Michael Kerrisk
+ List APIs that operate on process groups
+ Michael Kerrisk
+ Add details on controlling terminal and foreground/background jobs
+
+feature_test_macros.7
+ Michael Kerrisk
+ Document _DEFAULT_SOURCE
+ Michael Kerrisk [Joseph S. Myers]
+ From glibc 2.19, _BSD_SOURCE no longer causes __FAVOR_BSD
+ Starting with glibc 2.19, _BSD_SOURCE no longer causes BSD
+ definitions to be favored in cases where standards conflict.
+
+libc.7
+ Mike Frysinger
+ SEE ALSO: add various entries
+
+man-pages.7
+ Michael Kerrisk [Mike Frysinger]
+ Add STYLE GUIDE section
+ Incorporate some of the existing material in the page
+ into the STYLE GUIDE, and add a lot more material, mainly
+ drawn from the "Global changes" sections in the release
+ changelogs.
+ Michael Kerrisk
+ Add historical note on reason for use of American spelling
+ Michael Kerrisk [Mike Frysinger]
+ Various improvements to style guide
+
+packet.7
+ Willem de Bruijn [Daniel Borkmann]
+ Document fanout, ring, and auxiliary options
+ This patch adds descriptions of the common packet socket options
+ PACKET_AUXDATA, PACKET_FANOUT, PACKET_RX_RING, PACKET_STATISTICS,
+ PACKET_TX_RING
+ and the ring-specific options
+ PACKET_LOSS, PACKET_RESERVE, PACKET_TIMESTAMP, PACKET_VERSION
+ Michael Kerrisk
+ Add kernel version numbers for PACKET_VERSION and PACKET_TIMESTAMP
+
+ld.so.8
+ Michael Kerrisk [Matthias Klose]
+ Default output file for D_DEBUG is stderr not stdout
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=6874
+
+
+
+==================== Changes in man-pages-3.57 ====================
+
+Released: 2014-01-24, 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:
+
+Andi Kleen <andi@firstfloor.org>
+Andre Majorel <aym-xunil@teaser.fr>
+Andrey Vagin <avagin@openvz.org>
+Andy Lutomirski <luto@amacapital.net>
+Axel Beckert <abe@debian.org>
+Bernhard Walle <bernhard@bwalle.de>
+Brandon Edens <bedens@fitbit.com>
+Eliezer Tamir <eliezer.tamir@linux.intel.com>
+Gioele Barabucci <gioele@svario.it>
+Ian Abbott <abbotti@mev.co.uk>
+Jerry Chu <hkchu@google.com>
+Jonas Jonsson <jonas@websystem.se>
+Marc Lehmann <debian-reportbug@plan9.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peng Haitao <penght@cn.fujitsu.com>
+Reuben Thomas <rrt@sc3d.org>
+Simone Piccardi <piccardi@truelite.it>
+Simon Paillard <spaillard@debian.org>
+Thomas Posch <man-pages@online.posch.name>
+Tilman Schmidt <tilman@imap.cc>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+Марк Коренберг <socketpair@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+msgop.2
+ Michael Kerrisk
+ Document MSG_COPY
+
+open.2
+ Michael Kerrisk, Andy Lutomirski
+ Document O_TMPFILE
+ O_TMPFILE is new in Linux 3.11
+
+perf_event_open.2
+ Vince Weaver [Andi Kleen]
+ PERF_SAMPLE_TRANSACTION support in Linux 3.13
+ The following patch adds descriptions of the new perf_event_open.2
+ PERF_SAMPLE_TRANSACTION sample type as added in Linux 3.13.
+
+ The descriptions are based on information provided by Andi Kleen,
+ both in the e-mail
+
+ [PATCH 1/6] perf, core: Add generic transaction flags v5
+
+ sent to the linux-kernel list as well as an e-mail
+
+ [PATCH] Document transaction flags in perf_event_open manpage
+
+ sent to the linux-man list.
+
+ The implementation is based heavily on the Intel Haswell
+ processor. Documentation can be found at this page:
+ http://software.intel.com/en-us/blogs/2013/05/03/intelr-transactional-synchronization-extensions-intelr-tsx-profiling-with-linux-0
+ as well as in section 18.11.5.1 of volume 3 of the
+ Intel 64 and IA-32 Architecture Software Developer's Manual.
+
+ptrace.2
+ Andrey Vagin
+ Add description for PTRACE_PEEKSIGINFO
+ Retrieve signals without removing them from a queue.
+ Andrey Vagin
+ Add description for PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
+ These two commands allow to examine and change mask of blocked
+ signals.
+
+socket.7
+ Eliezer Tamir
+ Add description for SO_BUSY_POLL
+ Add description for the SO_BUSY_POLL socket option.
+
+tcp.7
+ Michael Kerrisk [Jerry Chu]
+ Document TCP_USER_TIMEOUT
+ Text slightly adapted from Jerry Chu's (excellent) commit
+ message (commit dca43c75e7e545694a9dd6288553f55c53e2a3a3).
+ Michael Kerrisk
+ Document TCP_CONGESTION
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Reword to avoid use of "etc."
+
+Various pages
+ Peng Haitao [Andre Majorel]
+ Make wording around thread-safety and setlocale() more precise
+
+getdate.3
+strptime.3
+locale.5
+ Michael Kerrisk
+ Replace "weekday" with less ambiguous language
+ Notwithstanding POSIX's use of the term "weekday", in everyday
+ English, "weekday" is commonly understood to mean a day in the
+ set [Monday..Friday] (vs one of the "weekend" days).
+
+
+Changes to individual pages
+---------------------------
+
+epoll_wait.2
+ Michael Kerrisk [Jonas Jonsson]
+ Clarify wording of EINTR error
+ See https://bugzilla.kernel.org/show_bug.cgi?id=66571
+
+faccessat.2
+ Michael Kerrisk
+ Note that the system call takes only three arguments
+
+fallocate.2
+ Michael Kerrisk
+ Note filesystems that support FALLOC_FL_PUNCH_HOLE operation
+
+fcntl.2
+ Michael Kerrisk
+ BUGS: The O_SYNC and O_DSYNC flags are not modifiable using F_SETFL
+ Michael Kerrisk
+ Add susbsections under BUGS
+ There's several bugs listed. It's helpful to mark
+ them separately.
+ Michael Kerrisk
+ POSIX.1 specifies F_SETOWN and F_GETOWN for sockets/SIGURG
+
+getrlimit.2
+ Michael Kerrisk [Марк Коренберг]
+ Note that rlim_cur can be set lower than current resource consumption
+
+getsockopt.2
+ Michael Kerrisk
+ SEE ALSO: add ip(7) and udp(7)
+
+keyctl.2
+ Michael Kerrisk
+ SEE ALSO: mention Documentation/security/keys.txt
+
+linkat.2
+ Michael Kerrisk
+ Add ENOENT for O_TMPFILE created with O_EXCL
+ Michael Kerrisk
+ ERRORS: Add EINVAL
+
+lseek.2
+ Michael Kerrisk
+ Note which filesystems support SEEK_HOLE/SEEK_DATA
+
+msgop.2
+ Michael Kerrisk
+ Note that MSG_EXCEPT is Linux-specific
+
+open.2
+ Michael Kerrisk
+ Update CONFORMING TO
+ Add POSIX.1-2008. Add mention of O_TMPFILE.
+ Update text on various flags that were added in POSIX.1-2008, and
+ whose definitions can, since glibc 2.12, be obtained by suitably
+ defining _POSIX_C_SOURCE or _XOPEN_SOURCE
+ Michael Kerrisk
+ Add pointer in description to BUGS, for O_ASYNC limitation
+ Michael Kerrisk
+ Remove crufty duplicate text on modifying file status flags
+
+ptrace.2
+ Michael Kerrisk
+ Add details to descriptions of PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
+
+select.2
+ Michael Kerrisk [Marc Lehmann]
+ RETURN VALUE: Fix discussion of treatment of file descriptor sets
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=574370
+
+syscalls.2
+ Michael Kerrisk
+ Remove madvise1() from main list
+ madvise1() is one of the system calls that was never
+ implemented, and listed toward the bottom of the page.
+
+timer_create.2
+ Michael Kerrisk
+ Add pointer to proc(5) for info on /proc/[pid]/timers
+
+unlinkat.2
+ Michael Kerrisk [Mike Frysinger:]
+ ERRORS: Add EISDIR
+ See https://bugzilla.kernel.org/show_bug.cgi?id=29702
+
+ferror.3
+ Michael Kerrisk
+ clearerr(), feof(), and ferror() are also POSIX-conformant
+ Michael Kerrisk [Reuben Thomas]
+ CONFORMING TO: add fileno()
+
+gets.3
+ Ian Abbott
+ SEE ALSO: add fgets(3)
+
+mq_receive.3
+mq_send.3
+ Michael Kerrisk [Simone Piccardi]
+ SYNOPSIS: s/unsigned/unsigned int/
+
+printf.3
+ Michael Kerrisk
+ Small reorganization of text in EXAMPLE
+
+rand.3
+ Michael Kerrisk
+ s/unsigned/unsigned int/ in example
+
+stpcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function stpcpy() is thread safe.
+
+stpncpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function stpncpy() is thread safe.
+
+strcat.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions strcat() and strncat() are thread safe.
+
+strchr.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions strchr(), strrchr() and strchrnul() are thread safe.
+
+strcmp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions strcmp() and strncmp() are thread safe.
+
+strftime.3
+ Brandon Edens
+ Change "week day" to "day of week"
+ See https://bugzilla.kernel.org/show_bug.cgi?id=68861
+
+strstr.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function strstr() is thread safe.
+ The function strcasestr() is thread safe with exceptions.
+
+strtod.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions strtod(), strtof() and strtold() are thread safe
+ with exceptions.
+
+strtoimax.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions strtoimax() and strtoumax() are thread safe with
+ exceptions.
+
+strtol.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions strtol(), strtoll() and strtoq() are thread safe
+ with exceptions.
+
+tcgetpgrp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions tcgetpgrp() and tcsetpgrp() are thread safe.
+
+tcgetsid.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function tcgetsid() is thread safe.
+
+core.5
+ Bernhard Walle
+ Mention that %E exists since Linux 3.0
+ '%E' in the 'core_pattern' has been introduced in kernel commit
+ 57cc083ad9e1bfeeb4a0ee831e7bb008c8865bf0 which was included in
+ version 3.0. Add that information to the manual page.
+
+filesystems.5
+ Michael Kerrisk [Axel Beckert]
+ Add reference to proc(5) for more details on /proc/filesystems
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=735590
+
+locale.5
+ Michael Kerrisk
+ SEE ALSO: add locale(7)
+
+proc.5
+ Michael Kerrisk
+ Document /proc/[pid]/timers
+ Michael Kerrisk
+ Update discussion of wchan
+ Remove crufty reference to /etc/psdatabase in /proc/PID/stat.
+ Add /proc/PID/wchan.
+
+ See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/737452
+
+environ.7
+ Michael Kerrisk [Gioele Barabucci]
+ Correct reference to locale(7) (not locale(5))
+ locale(7) is the right place for details of the LC_*
+ environment variables.
+
+ See http://bugs.debian.org/638186
+ Michael Kerrisk
+ Improve references for discussion of locale environment variables
+ Michael Kerrisk
+ SEE ALSO: add catopen(3)
+ Michael Kerrisk
+ SEE ALSO: add locale(5)
+
+man-pages.7
+ Michael Kerrisk
+ Prefer "usable" over "useable"
+
+netdevice.7
+ Tilman Schmidt
+ Document SIOCGIFCONF case ifc_req==NULL
+ Add the missing description of the possibility to call SIOCGIFCONF
+ with ifc_req==NULL to determine the needed buffer size, as
+ described in
+ http://lkml.indiana.edu/hypermail/linux/kernel/0110.1/0506.html
+ and verified against source files net/core/dev_ioctl.c and
+ net/ipv4/devinet.c in the current kernel git tree.
+ This functionality has been present since the beginning of the 2.6
+ series. It's about time it gets documented.
+
+ While I'm at it, also generally clarify the section on
+ SIOCGIFCONF.
+
+standards.7
+ Michael Kerrisk
+ Enhance description of V7
+ Michael Kerrisk
+ Add C11
+
+tcp.7
+ Michael Kerrisk
+ Describe format of tcp_*_congestion_control /proc files
+ Describe format of tcp_allowed_congestion_control and
+ tcp_available_congestion_control.
+
+
+==================== Changes in man-pages-3.58 ====================
+
+Released: 2014-02-11, 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:
+
+Cyril Hrubis <chrubis@suse.cz>
+Daniel Borkmann <dborkman@redhat.com>
+David Prévot <taffit@debian.org>
+Fabrice Bauzac <libnoon@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Network Nut <sillystack@gmail.com>
+Ola Olsson <ola1olsson@gmail.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Schiffer <pschiffe@redhat.com>
+Simone Piccardi <piccardi@truelite.it>
+Simon Paillard <spaillard@debian.org>
+Yuri Kozlov <yuray@komyakino.ru>
+Марк Коренберг <socketpair@gmail.com>
+未卷起的浪 <ayjj_8109@qq.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+pipe.2
+ Michael Kerrisk
+ Document the pipe2() O_DIRECT flag added in Linux 3.4
+
+packet.7
+ Daniel Borkmann
+ Document PACKET_QDISC_BYPASS
+ New in Linux 3.14.
+
+
+Global changes
+--------------
+
+Various pages
+ Simon Paillard
+ Formatting fix: add space between function and () if BR or IR
+ Detected through the regex:
+ git grep -P '^\.(BR|IR) [\w]*\([\d]*\)$'
+
+Various pages
+ Simon Paillard
+ Formatting fix: add space between word and punctuation if BR or IR
+ Detected through the regex:
+ git grep -P '^\.(BR|IR) [^ ]*[,\.]$'
+
+ Could probably be extended to match more cases and fix in perl.
+
+Various pages
+ Michael Kerrisk
+ Use Oxford comma
+
+gettid.2
+restart_syscall.2
+passwd.5
+socket.7
+ Michael Kerrisk
+ Fix order of SEE ALSO entries
+
+
+Changes to individual pages
+---------------------------
+
+epoll_wait.2
+ Michael Kerrisk [Network Nut]
+ Remove word "minimum" from the description of 'timeout'
+
+epoll_wait.2
+poll.2
+select.2
+ Michael Kerrisk
+ Go into more detail on timeout and when call will cease blocking
+
+getxattr.2
+listxattr.2
+removexattr.2
+setxattr.2
+ Michael Kerrisk [Fabrice Bauzac]
+ Correct header file is <sys/xattr.h> (not <xattr/xattr.h>)
+ See https://bugzilla.kernel.org/show_bug.cgi?id=70141
+
+msgctl.2
+ Cyril Hrubis
+ Add note about ignored arg to IPC_RMID
+
+prctl.2
+ Michael Kerrisk [Марк Коренберг]
+ PR_SET_PDEATHSIG value is preserved across execve(2)
+
+recv.2
+ Michael Kerrisk
+ Rework and reorganize the text in various parts of the page.
+ Isolate details specific to recv() vs recvfrom() vs recvmsg()
+ Place details specific to each system call under a
+ a separate subheading.
+ Rework discussion of 'src_addr' and 'addrlen' for recvfrom()
+ Add description of 'buf' and 'len' in recvfrom() section
+ 'addrlen' should be 0 (*not* NULL) when 'src_addr' is NULL
+ Improve text describing recvfrom() call that is equivalent to recv()
+ Michael Kerrisk [未卷起的浪]
+ Describe the various cases where the return value can be 0
+
+shmctl.2
+ Michael Kerrisk
+ Note that 'buf' is ignored for IPC_RMID
+
+symlinkat.2
+ Michael Kerrisk
+ Make argument names consistent with symlink(2) page
+
+isalpha.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions isalnum(), isalpha(), isascii(), isblank(),
+ iscntrl(), isdigit(), isgraph(), islower(), isprint(),
+ ispunct(), isspace(), isupper() and isxdigit() are thread safe.
+
+isatty.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function isatty() is thread safe.
+
+isgreater.3
+ Peng Haitao
+ ATTRIBUTES: Note macros that are thread-safe
+ The macros isgreater(), isgreaterequal(), isless(),
+ islessequal(), islessgreater() and isunordered() are thread safe.
+
+iswalnum.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function iswalnum() is thread safe with exceptions.
+
+iswalpha.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function iswalpha() is thread safe with exceptions.
+
+iswblank.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function iswblank() is thread safe with exceptions.
+
+iswcntrl.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function iswcntrl() is thread safe with exceptions.
+
+lockf.3
+ Michael Kerrisk [Simone Piccardi]
+ Fix incorrect argument mentioned under EINVAL error
+
+pthread_kill.3
+ Michael Kerrisk
+ Add feature test macro requirements
+
+pthread_sigmask.3
+ Michael Kerrisk
+ Add feature test macro requirements
+
+strtoul.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions strtoul(), strtoull() and strtouq() are thread safe
+ with exceptions.
+
+nscd.conf.5
+ Peter Schiffer
+ Add note about default values
+
+proc.5
+ Michael Kerrisk
+ SEE ALSO: Add some further kernel Documentation/sysctl files
+
+man-pages.7
+ Michael Kerrisk
+ ATTRIBUTES sections come after VERSIONS
+ Peng Haitao has consistently ordered the ATTRIBUTES after
+ VERSIONS, so adjust the text in man-pages.7
+
+vdso.7
+ Michael Kerrisk
+ Add words "virtual dynamic shared object" in DESCRIPTION
+
+
+==================== Changes in man-pages-3.59 ====================
+
+Released: 2014-02-16, 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:
+
+Michael Kerrisk <mtk.manpages@gmail.com>
+Peter Schiffer <pschiffe@redhat.com>
+Weizhou Pan <cs.wzpan@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Global changes
+--------------
+
+Various pages
+ Peter Schiffer, Michael Kerrisk [Weizhou Pan]
+ Convert pages containing non-ASCII in source code comments to use UTF-8
+ Done using a slightly modified version of Peter Schiffer's
+ convert_to_utf_8.sh script. The script was modified so as *not*
+ a "coding:" marker to the groff source. For now, we'll only put
+ that marker on pages that contain non-ASCII characters in the
+ rendered text.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60807
+
+armscii-8.7
+cp1251.7
+iso_8859-1.7
+iso_8859-10.7
+iso_8859-11.7
+iso_8859-13.7
+iso_8859-14.7
+iso_8859-15.7
+iso_8859-16.7
+iso_8859-2.7
+iso_8859-3.7
+iso_8859-4.7
+iso_8859-5.7
+iso_8859-6.7
+iso_8859-7.7
+iso_8859-8.7
+iso_8859-9.7
+koi8-r.7
+koi8-u.7
+ Peter Schiffer, Michael Kerrisk [Weizhou Pan]
+ Convert pages containing non-ASCII to use UTF-8
+ Done using Peter Schiffer's convert_to_utf_8.sh script.
+ These pages containing non-ASCII in the rendered characters, and
+ so the script inserts a "coding:" marker into the groff source.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60807
+
+
+==================== Changes in man-pages-3.60 ====================
+
+Released: 2014-02-18, 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:
+
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Kalle Olavi Niemitalo <kon@iki.fi>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Simon Paillard <spaillard@debian.org>
+
+Apologies if I missed anyone!
+
+
+Changes to individual pages
+---------------------------
+sigvec.3
+ Michael Kerrisk [Kalle Olavi Niemitalo]
+ Fix error in code snippet
+ s/sigpause/sigmask/
+
+armscii-8.7
+cp1251.7
+iso_8859-1.7
+iso_8859-10.7
+iso_8859-11.7
+iso_8859-13.7
+iso_8859-14.7
+iso_8859-15.7
+iso_8859-16.7
+iso_8859-2.7
+iso_8859-3.7
+iso_8859-4.7
+iso_8859-5.7
+iso_8859-6.7
+iso_8859-7.7
+iso_8859-8.7
+iso_8859-9.7
+koi8-u.7
+ Michael Kerrisk [Simon Paillard]
+ Remove comment that glyphs in column 4 may not display correctly
+ With the conversion to UTF-8, the glyphs in column 4 of the
+ tables in these pages will display regardless of whether the
+ environment is configured for the corresponding character set.
+
+iso_8859-11.7
+iso_8859-13.7
+ D. Barbier [Simon Paillard]
+ Fix encoding mistakes in 5f7f4042b8848127d852c6fa7c02e31ccfaeeae5
+ Fixed via:
+
+ for f in iso_8859-11 iso_8859-13; do
+ cp man7/$f.7 $f
+ iconv -f utf8 -t latin1 $f | iconv -f iso-${f#iso_} -t utf8 > man7/$f.7
+ done
+
+
+
+
+==================== Changes in man-pages-3.61 ====================
+
+Released: 2014-02-26, 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:
+
+Andrew Hunter <ahh@google.com>
+Carlos O'Donell <carlos@redhat.com>
+Christoph Hellwig <hch@infradead.org>
+Daniel Borkmann <dborkman@redhat.com>
+Duncan de Wet <duncandewet@gmail.com>
+Kir Kolyshkin <kir@openvz.org>
+KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Neil Horman <nhorman@tuxdriver.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Simon Paillard <spaillard@debian.org>
+Sulaiman Mustafa <seininn@hush.com>
+Xiawei Chen <chenxiawei@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+A note from Christoph Hellwig prompted me to perform a task that has
+been queued for a while: merging the text of the man pages for the
+*at([23]) ("directory file descriptor") APIs into their corresponding
+traditional pages. When the *at([23]) pages were originally written
+(mostly in 2006), the APIs were not part of POSIX and (in most cases)
+were not available on other systems. So, it made some sense to wall
+them off into their own separate pages. Eight years later, with the
+APIs now all in POSIX (except scandirat()), it is much more sensible
+to document the newer APIs alongside their traditional counterparts,
+so that the newer APIs are not "hidden", and the reader can more
+easily see the differences between the APIs.
+
+Thus, the text of 14 pairs of pages has been merged, and the "merged
+from" pages have been converted to links to the "merged to" pages.
+Along the way, a few other fixes were made to the pages, as noted
+below.
+
+One page that did not undergo such a change was utimensat(2), which
+is different enough from utime(2) that it warrants a separate page.
+Unlike the other *at() pages, the utimensat(2) page was also already
+self-contained, rather than defining itself in terms of differences
+from utime(2) as the other *at() pages did.
+
+access.2
+ Michael Kerrisk
+ Merge text from faccessat(2)
+ Michael Kerrisk
+ Remove faccessat() race warning
+ That point is already covered in existing text in this page.
+ Michael Kerrisk
+ access() also conforms to POSIX.1-2008
+
+chmod.2
+ Michael Kerrisk
+ Merge text from fchmodat(2)
+ Michael Kerrisk
+ Use argument name 'pathname' throughout page
+ (Some APIs were using 'path' while others used 'pathname')
+ Michael Kerrisk
+ CONFORMING TO: chmod() and fchmod() are also in POSIX.1-2008
+
+chown.2
+ Michael Kerrisk
+ Merge text of fchownat(2)
+ Michael Kerrisk
+ AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE
+ Michael Kerrisk
+ Use argument name 'pathname' throughout page
+ (Some APIs were using 'path' while others used 'pathname')
+ Michael Kerrisk
+ Remove sentence that fchownat() is present on Solaris
+ That point was only really relevant before fchownat() was
+ standardized in POSIX.1.2008.
+ Michael Kerrisk
+ CONFORMING TO: chown(), fchown(), lchown() are in POSIX.1-2008
+
+link.2
+ Michael Kerrisk
+ Merge text of linkat(2)
+ Michael Kerrisk
+ CONFORMING TO: link() is in POSIX.1-2008
+ Michael Kerrisk
+ AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE
+
+mkdir.2
+ Michael Kerrisk
+ Merge text of mkdirat(2)
+ Michael Kerrisk
+ CONFORMING TO: mkdir() is in POSIX.1-2008
+
+mknod.2
+ Michael Kerrisk
+ Merge text of mknodat(2)
+ Michael Kerrisk
+ CONFORMING TO: mknod(2) is in POSIX.1-2008
+
+open.2
+ Michael Kerrisk
+ Merge text from openat(2)
+ Michael Kerrisk
+ Remove sentence that openat() is present on Solaris
+ That point was only really relevant before openat() was
+ standardized in POSIX.1.2008.
+
+readlink.2
+ Michael Kerrisk
+ Merge text of readlinkat(2)
+ Michael Kerrisk
+ CONFORMING TO: readlink() is in POSIX.1-2008.
+ Michael Kerrisk
+ Use argument name 'pathname' throughout page
+ (Some APIs were using 'path' while others used 'pathname')
+
+rename.2
+ Michael Kerrisk
+ Merge text of renameat(2)
+ Michael Kerrisk
+ CONFORMING TO: rename(2) is in POSIX.1-2008
+
+stat.2
+ Michael Kerrisk
+ Merge text from fstatat(2)
+ Michael Kerrisk
+ AT_EMPTY_PATH and AT_NO_AUTOMOUNT are Linux-specific
+ These flags require _GNU_SOURCE.
+ Michael Kerrisk
+ Use argument name 'pathname' throughout page
+ (Some APIs were using 'path' while others used 'pathname')
+ Michael Kerrisk
+ Remove sentence that fstatat() is present on Solaris
+ That point was only really relevant before fstatat() was
+ standardized in POSIX.1.2008.
+ Michael Kerrisk
+ CONFORMING TO: stat(), fstat(), lstat() are specified in POSIX.1-2008
+
+symlink.2
+ Michael Kerrisk
+ Merge text of symlinkat(2)
+ Michael Kerrisk
+ CONFORMING TO: symlink() is in POSIX.1-2008
+
+unlink.2
+ Michael Kerrisk
+ Merge text of unlinkat(2)
+ Michael Kerrisk
+ Remove sentence that unlinkat() is present on Solaris
+ That point was only really relevant before unlinkat() was
+ standardized in POSIX.1.2008.
+ Michael Kerrisk
+ CONFORMING TO: unlink() is in POSIX.1-2008
+
+mkfifo.3
+ Michael Kerrisk
+ Merge text of mkfifoat(3)
+ Michael Kerrisk
+ CONFORMING TO: mkfifo() is in POSIX.1-2008
+
+scandir.3
+ Michael Kerrisk
+ Merge text of scandirat(3)
+ Michael Kerrisk
+ Update feature test macro requirements
+ The FTM requirements changed in glibc 2.10.
+ Michael Kerrisk
+ Remove libc4/libc5 note under CONFORMING TO
+ No-one much cares about Linux libc these days.
+ Michael Kerrisk
+ Put detail about alphasort under a NOTES heading
+ This text was under CONFORMING TO, which made no sense.
+ Michael Kerrisk
+ Rework CONFORMING TO text
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+prctl.2
+ Kir Kolyshkin
+ Document PR_SET_MM options in Linux 3.5
+ Some of the PR_SET_MM options were merged to vanilla kernel
+ later, and appeared in Linux 3.5. Those are:
+
+ - PR_SET_MM_ARG_START
+ - PR_SET_MM_ARG_END
+ - PR_SET_MM_ENV_START
+ - PR_SET_MM_ENV_END
+ - PR_SET_MM_AUXV
+ - PR_SET_MM_EXE_FILE
+
+socket.7
+ Neil Horman
+ Document the SO_RXQ_OVFL socket option
+ Michael Kerrisk
+ Add kernel version number for SO_RXQ_OVFL
+
+
+New and changed links
+---------------------
+
+faccessat.2
+ Michael Kerrisk
+ Convert to link to access.2
+
+fchmodat.2
+ Michael Kerrisk
+ Convert to link to chmod.2
+
+fchownat.2
+ Michael Kerrisk
+ Convert to link to chown.2
+
+fstatat.2
+ Michael Kerrisk
+ Convert to link to stat.2
+
+linkat.2
+ Michael Kerrisk
+ Convert to link to link.2
+
+mkdirat.2
+ Michael Kerrisk
+ Convert to link to mkdir.2
+
+mknodat.2
+ Michael Kerrisk
+ Convert to link to mknod.2
+
+openat.2
+ Michael Kerrisk
+ Convert to link to open.2
+
+readlinkat.2
+ Michael Kerrisk
+ Convert to link to symlink.2
+
+renameat.2
+ Michael Kerrisk
+ Convert to link rename.2
+
+symlinkat.2
+ Michael Kerrisk
+ Convert to link to symlink.2
+
+unlinkat.2
+ Michael Kerrisk
+ Convert to link to unlink.2
+
+mkfifoat.3
+ Michael Kerrisk
+ Convert to link to mkfifo.3
+
+scandirat.3
+ Michael Kerrisk
+ Convert to link to scandir.3
+
+
+Changes to individual pages
+---------------------------
+
+alarm.2
+ Michael Kerrisk
+ Note semantics of alarm with respect to fork() and execve()
+
+fcntl.2
+ Michael Kerrisk
+ Warn that F_GETLK info may already be out of date when the call returns
+
+intro.2
+ Michael Kerrisk
+ Describe policy on documenting differences between syscall and glibc API
+
+mmap2.2
+ Michael Kerrisk
+ Reword note on glibc mmap() wrapper invocation of mmap2()
+ Michael Kerrisk
+ This system call does not exist on x86-64
+
+msgctl.2
+ Michael Kerrisk
+ ERRORS: add EPERM for unprivileged attempt to set msg_qbytes > MSGMNB
+
+prctl.2
+ Michael Kerrisk [Xiawei Chen]
+ Clarify that PR_GET_TIMERSLACK is returned as the function result
+ Michael Kerrisk
+ Clarify that PR_GET_SECCOMP is returned as function result
+ Michael Kerrisk
+ Clarify that PR_GET_NO_NEW_PRIVS is returned as function result
+
+ptrace.2
+ Michael Kerrisk [Andrew Hunter]
+ Make it clearer that glibc and syscall APIs differ for PTRACE_PEEK*
+ Thanks to Denys Vlasenko's additions in 78686915aed6bd12
+ this page does note that the glibc API for PTRACE_PEEK*
+ differs from the raw syscall interface. But, as the report
+ at https://bugzilla.kernel.org/show_bug.cgi?id=70801 shows,
+ this information could be more obvious. This patch makes its so.
+
+sgetmask.2
+ Michael Kerrisk
+ Note that these system calls don't exist on x86-64
+
+swapon.2
+ Michael Kerrisk
+ Split EINVAL cases into separate entries under ERRORS
+ Michael Kerrisk
+ Add EINVAL error for invalid flags to swapon()
+
+syscalls.2
+ Michael Kerrisk
+ SEE ALSO: add intro(2)
+
+umount.2
+ Michael Kerrisk
+ Split EINVAL cases into separate items
+ Michael Kerrisk
+ ERRORS: Add EINVAL case that was new in 2.6.34
+
+utime.2
+ Michael Kerrisk
+ Add note that modern applications probably want utimensat(2) etc.
+
+crypt.3
+ Michael Kerrisk [KOSAKI Motohiro]
+ ERRORS: Add EINVAL and EPERM errors
+ See https://bugzilla.kernel.org/show_bug.cgi?id=69771
+
+getifaddrs.3
+ Michael Kerrisk
+ Enhance example program
+ Print statistics for AF_PACKET interfaces.
+ Add missing feature test macro definition.
+ Reformat output.
+
+iswctype.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function iswctype() is thread safe.
+
+sem_post.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sem_post() is thread safe.
+
+sem_unlink.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sem_unlink() is thread safe.
+
+sem_wait.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sem_wait(), sem_trywait() and sem_timedwait() are
+ thread safe.
+
+setbuf.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions setbuf(), setbuffer(), setlinebuf() and setvbuf()
+ are thread safe.
+
+strlen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function strlen() is thread safe.
+
+strnlen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function strnlen() is thread safe.
+
+strpbrk.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function strpbrk() is thread safe.
+
+strsep.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function strsep() is thread safe.
+
+swab.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function swab() is thread safe.
+
+resolv.conf.5
+ Carlos O'Donell
+ DESCRIPTION: mention that the data is trusted
+ In a recent discussion about DNSSEC it was brought to my
+ attention that not all system administrators may understand
+ that the information in /etc/resolv.conf is fully trusted.
+ The resolver implementation in glibc treats /etc/resolv.conf
+ as a fully trusted source of DNS information and passes on
+ the AD-bit for DNSSEC as trusted.
+
+ This patch adds a clarifying sentence to make it absolutely
+ clear that indeed this source of information is trusted.
+
+ascii.7
+ Michael Kerrisk [Sulaiman Mustafa]
+ Fix rendering of single quote (decimal character 39)
+ Michael Kerrisk
+ SEE ALSO: add utf-8(7)
+ Michael Kerrisk [Duncan de Wet]
+ Remove mention of ISO 8859-1 as being the default encoding on Linux
+
+packet.7
+ Neil Horman
+ Document PACKET_FANOUT_QM fanout mode
+ Michael Kerrisk
+ Add kernel version for PACKET_FANOUT_QM
+ Daniel Borkmann
+ Improve PACKET_QDISC_BYPASS description
+
+socket.7
+ Michael Kerrisk
+ Add kernel version number for SO_BUSY_POLL
+
+
+==================== Changes in man-pages-3.62 ====================
+
+Released: 2014-03-11, 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:
+
+Cyril Hrubis <chrubis@suse.cz>
+Joseph S. Myers <joseph@codesourcery.com>
+Marius Gaubas <marius@livejournalinc.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peng Haitao <penght@cn.fujitsu.com>
+Rick Stanley <rstanley@rsiny.com>
+Simon Paillard <spaillard@debian.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+locale.1
+ Michael Kerrisk [review from Mike Frysinger]
+ New page describing locale(1)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+locale.5
+ Michael Kerrisk
+ Document LC_ADDRESS
+ Michael Kerrisk
+ Document LC_IDENTIFICATION
+ Michael Kerrisk
+ Document LC_MEASUREMENT
+ Michael Kerrisk
+ Document LC_NAME
+ Michael Kerrisk
+ Document LC_PAPER
+ Michael Kerrisk
+ Document LC_TELEPHONE
+
+
+Removed Pages
+-------------
+
+sync.8
+ Michael Kerrisk [Christoph Hellwig, Pádraig Brady]
+ Sometime in the 20th century (before my watch), a sync(8)
+ page into man-pages. It documents the sync command from
+ "fileutils", which long ago become coreutils, and the
+ piece under NOTES note some behavior of sync(2)
+ that ceased to be true many years ago. The man-pages
+ project generally focuses on only Linux kernel and
+ (g)libc interfaces, so this sync(8) page doesn't really
+ belong. Furthermore, coreutils has a sync(1) page which
+ covers the same command. After dicussions on the
+ coreutils list, I've decided to retire this page from
+ man-pages.
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Note that CLONE_THREAD also in effect requires CLONE_VM
+
+stat.2
+ Michael Kerrisk [Marius Gaubas]
+ Warn the reader that the 'stat' structure definition is not precise
+ Padding fields aren't shown, and the order of fields varies
+ somewhat across architectures.
+
+gethostbyname.3
+ Michael Kerrisk
+ Remove redundant FTM requirements
+ _GNU_SOURCE implies _SVID_SOURCE and _BSD_SOURCE, so
+
+ _BSD_SOURCE || _SVID_SOURCE || _GNU_SOURCE
+
+ is the same as
+
+ _BSD_SOURCE || _SVID_SOURCE
+
+getutmp.3
+ Michael Kerrisk
+ SEE ALSO: add utmpdump(1)
+
+log1p.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions log1p(), log1pf() and log1pl() are thread safe.
+
+logb.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions logb(), logbf() and logbl() are thread safe.
+
+memccpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memccpy() is thread safe.
+
+memchr.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions memchr(), memrchr() and rawmemchr() are thread safe.
+
+mktemp.3
+ Michael Kerrisk
+ Make warning not to use this function more prominent
+
+qecvt.3
+ Michael Kerrisk [Joseph S. Myers]
+ Recommend snprintf(3) not sprintf(3)
+
+raise.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function raise() is thread safe.
+
+remove.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function remove() is thread safe.
+
+sem_destroy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sem_destroy() is thread safe.
+
+sem_getvalue.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sem_getvalue() is thread safe.
+
+sem_init.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sem_init() is thread safe.
+
+sockatmark.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sockatmark() is thread safe.
+
+strcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions strcpy() and strncpy() are thread safe.
+ Michael Kerrisk [Rick Stanley]
+ Fix a bug, and improve discussion of forcing termination with strncpy()
+
+strspn.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions strspn() and strcspn() are thread safe.
+
+tempnam.3
+ Michael Kerrisk
+ Make warning not to use this function more prominent
+
+tmpnam.3
+ Michael Kerrisk
+ Recommend use mkstemp(3) or tmpfile(3) instead
+
+locale.5
+ Michael Kerrisk
+ Add intro section that lists all of the LC categories
+ Michael Kerrisk
+ 'p_cs_precedes' is for *positive* values
+ Michael Kerrisk
+ Clarify 'p_sign_posn' and 'n_sign_posn'; simplify 'n_sign_posn'
+ Add initial sentence for 'p_sign_posn' and 'n_sign_posn'.
+ Remove repeated list for 'n_sign_posn'.
+ Michael Kerrisk
+ Document LC_MESSAGES 'yesstr' and 'nostr'
+ Michael Kerrisk
+ Clarify LC_MONETARY 'n_cs_precedes'
+ Michael Kerrisk
+ LC_MONETARY: Document 'int_p_sign_posn' and 'int_n_sign_posn'
+ Michael Kerrisk
+ Clarify/rework 'p_cs_precedes' and 'n_cs_precedes'
+ Michael Kerrisk
+ LC_MONETARY: document 'int_p_sep_by_space' and 'int_n_sep_by_space'
+ Michael Kerrisk
+ Remove crufty reference to POSIX.2
+ Michael Kerrisk
+ LC_MONETARY: document 'int_p_cs_precedes' and 'int_n_cs_precedes'
+ Michael Kerrisk
+ Clarify/simplify 'n_sep_by_space'
+ Michael Kerrisk
+ LC_TIME: document 'cal_direction' and 'date_fmt'
+ Michael Kerrisk
+ Clarify 'p_sep_by_space'
+
+feature_test_macros.7
+ Michael Kerrisk
+ _BSD_SOURCE and _SVID_SOURCE are deprecated in glibc 2.20
+ Michael Kerrisk
+ _GNU_SOURCE implicitly defines other macros
+ Saying that _GNU_SOURCE has the "effects of" other macros is not
+ quite precise.
+ Michael Kerrisk
+ Reword glibc version for _ISOC95_SOURCE
+ Michael Kerrisk
+ _ISOC99_SOURCE also exposes C95 definitions
+ Michael Kerrisk
+ _ISOC11_SOURCE implies the effects of _ISOC99_SOURCE
+ Michael Kerrisk
+ Note version number for _POSIX_C_SOURCE >= 200112L implies C99/C95
+ _POSIX_C_SOURCE >= 200112L causes C95 definitions to be
+ exposed only since glibc 2.12 and C99 definitions only
+ since 2.10.
+ Michael Kerrisk
+ _XOPEN_SOURCE may implicitly define _POSIX_SOURCE and _POSIX_C_SOURCE
+ Michael Kerrisk
+ Reword glibc version for _ISOC99_SOURCE
+ Michael Kerrisk
+ Rework discussion of _ISOC99_SOURCE
+ Michael Kerrisk
+ Improve discussion of _DEFAULT_SOURCE
+ Michael Kerrisk
+ _POSIX_C_SOURCE >= 200112L implies C95 and C95 features
+
+
+
+==================== Changes in man-pages-3.63 ====================
+
+Released: 2014-03-18, 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:
+
+Carlos O'Donell <carlos@redhat.com>
+Christoph Hellwig <hch@infradead.org>
+Corrado Zoccolo <czoccolo@gmail.com>
+Gregory P. Smith <gps@google.com>
+Joseph S. Myers <joseph@codesourcery.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peng Haitao <penght@cn.fujitsu.com>
+Phillip Susi <psusi@ubuntu.com>
+Robert P. J. Day <rpjday@crashcourse.ca>
+Stefan Puiu <stefan.puiu@gmail.com>
+Zhu Yanhai <zhu.yanhai@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+duplocale.3
+ Michael Kerrisk
+ New page documenting duplocale(3)
+
+newlocale.3
+ Michael Kerrisk [Mike Frysinger]
+ New page documenting newlocale(3) and freelocale(3)
+
+towlower.3
+ Michael Kerrisk
+ Largely rewrite description of towlower() to be simpler and clearer
+
+towupper.3
+ Michael Kerrisk
+ Largely rewrite description of towupper() to be simpler and clearer
+
+uselocale.3
+ Michael Kerrisk
+ New page documenting uselocale(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+open.2
+ Michael Kerrisk
+ Document O_DSYNC and rewrite discussion of O_SYNC
+
+isalpha.3
+ Michael Kerrisk
+ Document the "_l" locale APIs
+ The GNU C library v2.3 added some locale APIs, most of which
+ were later specified in POSIX.1-2008, namely:
+
+ isalnum_l()
+ isalpha_l()
+ isblank_l()
+ iscntrl_l()
+ isdigit_l()
+ isgraph_l()
+ islower_l()
+ isprint_l()
+ ispunct_l()
+ isspace_l()
+ isupper_l()
+ isxdigit_l()
+ isascii_l()
+
+ Also update and correct various pieces in CONFORMING TO
+ (and remove a few crufty old pieces there).
+
+strerror.3
+ Michael Kerrisk
+ Document strerror_l()
+
+toupper.3
+ Michael Kerrisk
+ Document toupper_l() and tolower_l()
+
+towlower.3
+ Michael Kerrisk
+ Document towlower_l()
+
+towupper.3
+ Michael Kerrisk
+ Document towupper_l()
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/kernel/random/uuid
+
+locale.7
+ Michael Kerrisk
+ Document LC_ADDRESS
+ Document LC_IDENTIFICATION
+ Document LC_MEASUREMENT
+ Document LC_NAME
+ Document LC_PAPER
+ Document LC_TELEPHONE
+
+
+New and changed links
+---------------------
+
+freelocale.3
+ Michael Kerrisk
+ New link to new newlocale.3 page
+
+isalnum_l.3
+isascii_l.3
+isblank_l.3
+iscntrl_l.3
+isdigit_l.3
+isgraph_l.3
+islower_l.3
+isprint_l.3
+ispunct_l.3
+isspace_l.3
+isupper_l.3
+isxdigit_l.3
+ Michael Kerrisk
+ New links to isalpha.3
+
+tolower_l.3
+toupper_l.3
+ Michael Kerrisk
+ New links to toupper.3
+
+towlower_l.3
+ Michael Kerrisk
+ New link to towlower.3
+
+towupper_l.3
+ Michael Kerrisk
+ New link to towupper.3
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global change: "upper case" ==> "uppercase", "lower case" ==> lowercase"
+
+
+Changes to individual pages
+---------------------------
+
+mount.2
+ Michael Kerrisk
+ SEE ALSO: add blkid(1)
+
+msgop.2
+ Michael Kerrisk
+ Document two MSG_COPY failure modes
+ Since Linux 3.14, the kernel now diagnoses two errors
+ when using msgrcv() MSG_COPY:
+ * MSG_COPY must be specified with IPC_NOWAIT
+ * MSG_COPY can't be specified with MSG_EXCEPT
+
+open.2
+ Michael Kerrisk
+ Organize some material under additional subheadings in NOTES
+ There's an amorphous mass of material under NOTES. Structure
+ it with some subheadings, and do a little reorganizing.
+ Michael Kerrisk
+ Add other system calls and functions that are like openat()
+ fanotify_mark(2), name_to_handle_at(2), and scandirat(3) have a
+ directory file descriptor argument for the same reason as openat().
+ Also: reword the rationale for the *at() functions somewhat.
+ Michael Kerrisk
+ Clarify ELOOP error interaction with O_PATH
+
+readahead.2
+ Phillip Susi [Corrado Zoccolo, Gregory P. Smith, Zhu Yanhai, Michael Kerrisk, Christoph Hellwig]
+ Don't claim the call blocks until all data has been read
+ The readahead(2) man page was claiming that the call blocks until
+ all data has been read into the cache. This is incorrect.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=54271
+
+stat.2
+ Michael Kerrisk
+ SEE ALSO: add ls(1) and stat(1)
+
+fts.3
+ Christoph Hellwig [Michael Kerrisk]
+ The fts(3) API does not work with LFS builds
+ As pointed out during a recent discussion on libc-hacker the
+ fts(3) APIs can't be used with large file offsets:
+
+ https://sourceware.org/bugzilla/show_bug.cgi?id=15838
+
+mbrtowc.3
+mbsnrtowcs.3
+mbsrtowcs.3
+mbtowc.3
+ Michael Kerrisk
+ Add entries in SEE ALSO
+ Mainly inspired by the POSIX pages.
+
+mbsinit.3
+ Michael Kerrisk
+ SEE ALSO: add mbrlen(3), mbrtowc(3), and wcrtomb(3)
+
+mbsrtowcs.3
+wcsrtombs.3
+ Michael Kerrisk
+ SEE ALSO: add mbsinit(3)
+
+mbstowcs.3
+ Michael Kerrisk [Stefan Puiu]
+ Add example program
+ And add some SEE ALSO entries
+
+memcmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memcmp() is thread safe.
+
+memcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memcpy() is thread safe.
+
+memfrob.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memfrob() is thread safe.
+
+memmem.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memmem() is thread safe.
+
+memmove.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memmove() is thread safe.
+
+mempcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mempcpy() and wmempcpy() are thread safe.
+
+memset.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memset() is thread safe.
+
+strerror.3
+ Michael Kerrisk
+ CONFORMING TO: strerror() and strerror_r() are in POSIX.1-2008
+ Michael Kerrisk
+ Add SS heading for strerror_r()
+
+toupper.3
+ Michael Kerrisk
+ Rewrite to more explicitly bring locales into the discussion
+ Michael Kerrisk
+ Retitle BUGS section to NOTES
+ These are not really bugs, just background info.
+
+wcrtomb.3
+wcsnrtombs.3
+wcsrtombs.3
+wcstombs.3
+wctomb.3
+ Michael Kerrisk
+ SEE ALSO: add various entries
+ Mainly inspired by POSIX
+
+core.5
+ Mike Frysinger [Michael Kerrisk]
+ Document core_pattern %d specifier
+ Document %P core_pattern specifier
+ Michael Kerrisk
+ Rearrange core_pattern specifiers alphabetically
+
+locale.5
+ Michael Kerrisk
+ SEE ALSO: add newlocale(3) + duplocale(3)
+
+feature_test_macros.7
+ Michael Kerrisk [Joseph S. Myers]
+ Remove mention of bogus _ISOC95_SOURCE macro
+ The _ISOC95_SOURCE macro is defined in <features.h>, but it
+ does nothing. So remove discussion of it, and move some of
+ the discussion of C95 under the ISOC99_SOURCE subhead.
+ Michael Kerrisk [Carlos O'Donell]
+ Add packaging note for _BSD_SOURCE/_SVID_SOURCE/_DEFAULT_SOURCE
+ To compile warning-free across glibc < 2.20 and glibc >= 2.20
+ code may been to define both _DEFAULT_SOURCE and either
+ _BSD_SOURCE or _SVID_SOURCE.
+ Michael Kerrisk
+ Reword description of C90
+
+locale.7
+ Michael Kerrisk
+ Add subsection on POSIX.1-2008 (originally GNU) extensions to locale API
+ Michael Kerrisk
+ Remove reference to LI18NUX2000
+ LI18NUX2000 is difficult to even find these days, and in any case
+ this page does not document gettext(), so notes about gettext()
+ in the CONFORMING TO section here make no sense.
+ Michael Kerrisk
+ SEE ALSO: add mbstowcs(3) and wcstombs(3)
+ SEE ALSO: add newlocale(3) + duplocale(3)
+
+man-pages.7
+ Michael Kerrisk
+ Add preferred term "superblock"
+ Michael Kerrisk
+ Add preferred terms "uppercase" and "lowercase"
+
+
+
+==================== Changes in man-pages-3.64 ====================
+
+Released: 2014-04-06, 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:
+
+Abhay Sachan <sachan.abhay@gmail.com>
+Alexey Samsonov <samsonov@google.com>
+Andrey Vagin <avagin@openvz.org>
+Aneesh Kumar K.V <aneesh.kumar@linux.vnet.ibm.com>
+Christoph Hellwig <hch@infradead.org>
+David Prévot <taffit@debian.org>
+Eric Dumazet <edumazet@google.com>
+Eric W. Biederman <ebiederm@xmission.com>
+Jan Kara <jack@suse.cz>
+Kir Kolyshkin <kir@openvz.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+NeilBrown <neilb@suse.de>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Hurley <peter@hurleysoftware.com>
+Petr Gajdos <pgajdos@suse.cz>
+Robert P. J. Day <rpjday@crashcourse.ca>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+open_by_handle_at.2
+ Michael Kerrisk [Mike Frysinger, Neil Brown, Aneesh Kumar K.V,
+ Christoph Hellwig]
+ New page describing name_to_handle_at(2) and open_by_handle_at(2)
+
+inotify.7
+ Michael Kerrisk
+ Rewrite introductory section
+ Reorganize "Limitations and caveats" subsection
+ Michael Kerrisk
+ Further describe the race when adding a watch to a new subtree
+ Michael Kerrisk
+ Directory renames may invalidate multiple paths cached by application
+ Michael Kerrisk
+ Add paragraph on cache consistency checking
+ Michael Kerrisk
+ Mention cache rebuilding to handle overflow events
+ Michael Kerrisk
+ Moving an object to another filesystem generates IN_DELETE_SELF
+ Michael Kerrisk [Jan Kara]
+ Add text on dealing with rename() events
+ Michael Kerrisk
+ Note rationale and consequences of event coalescing
+ Michael Kerrisk [Eric W. Biederman]
+ Inotify doesn't work for remote and pseudo filesystems
+ Michael Kerrisk
+ Add some examples of events generated by various system calls
+ Michael Kerrisk
+ BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped
+ A silent change as a result of the fanotify work in kernel 2.6.36.
+ Michael Kerrisk
+ Note that IN_DELETE_SELF will be followed by IN_IGNORED
+ Michael Kerrisk
+ Note that IN_UNMOUNT will be followed by an IN_IGNORED event
+ Michael Kerrisk
+ Inotify does not report events for mmap(2) and msync(2)
+ Michael Kerrisk
+ Add examples of syscalls that trigger IN_ATTRIB
+ Michael Kerrisk
+ Add some examples of syscalls that trigger IN_MODIFY
+ Michael Kerrisk
+ execve(2) also generates IN_ACCESS
+ Michael Kerrisk
+ Add examples of syscalls that trigger IN_CREATE
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+perf_event_open.2
+ Vince Weaver [Michael Kerrisk]
+ Document the PERF_FLAG_FD_CLOEXEC flag
+ The Linux 3.14 release adds support for the PERF_FLAG_FD_CLOEXEC
+ flag.
+
+feature_test_macros.7
+ Michael Kerrisk
+ Document _LARGEFILE_SOURCE
+
+tcp.7
+ Michael Kerrisk [Eric Dumazet]
+ Document /proc/sys/net/ipv4/tcp_autocorking
+ Text heavily based on Documentation/networking/ip-sysctl.txt
+
+
+New and changed links
+---------------------
+
+name_to_handle_at.2
+ Michael Kerrisk
+ New link to new open_by_name_at(2) page
+
+
+Global changes
+--------------
+
+fmemopen.3
+getaddrinfo.3
+mq_notify.3
+offsetof.3
+aio.7
+ Michael Kerrisk
+ Print size_t/ssize_t values using %z printf() modifier
+ There are fewer and fewer systems these days that don't
+ support the %z specifier mandated in C99. So replace the
+ use of %ld/%lu + (long) cast with %zd/%zu.
+
+
+Changes to individual pages
+---------------------------
+
+bdflush.2
+fsync.2
+sync.2
+ Kir Kolyshkin
+ SEE ALSO: remove update(8) reference
+ Remove reference to update(8) man page, since there is no such
+ page. This is an ancient BSD leftover I believe.
+
+chown.2
+ Michael Kerrisk
+ Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
+
+getxattr.2
+ Abhay Sachan
+ Fix RETURN VALUE description
+ A EA can have length zero.
+
+inotify_add_watch.2
+ Michael Kerrisk
+ ERRORS: add ENAMETOOLONG
+
+inotify_init.2
+ Michael Kerrisk
+ Add pointer to inotify(7)
+
+link.2
+ Michael Kerrisk
+ When AT_EMPTY_PATH is specified, 'olddirfd' must not refer to a
+ directory
+
+mmap.2
+ Andrey Vagin
+ The file descriptor for a file mapping must be readable
+ There is no difference between MAP_SHARED and MAP_PRIVATE.
+
+open.2
+ Michael Kerrisk
+ SEE ALSO: add open_by_name_at(2)
+
+perf_event_open.2
+ Vince Weaver
+ Document PERF_EVENT_IOC_PERIOD behavior change
+ Linux 3.14 (in commit bad7192b842c83e580747ca57104dd51fe08c223)
+ changes the perf_event PERF_EVENT_IOC_PERIOD ioctl() behavior
+ on all architectures to update immediately, to match the behavior
+ found on ARM.
+
+stat.2
+ Michael Kerrisk
+ Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
+
+syscalls.2
+ Michael Kerrisk
+ Add sched_getattr() and sched_setattr()
+ And update kernel version to 3.14
+
+abort.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function abort() is thread safe.
+
+confstr.3
+ Michael Kerrisk
+ SEE ALSO: add getconf(1), fpathconf(3), sysconf(3), pathconf(3)
+
+exit.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function exit() is not thread safe.
+
+fenv.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions feclearexcept(), fegetexceptflag(), feraiseexcept(),
+ fesetexceptflag(), fetestexcept(), fegetround(), fesetround(),
+ fegetenv(), feholdexcept(), fesetenv(), feupdateenv(),
+ feenableexcept(), fedisableexcept() and fegetexcept() are thread
+ safe.
+
+fpathconf.3
+ Michael Kerrisk
+ SEE ALSO: add confstr(3)
+
+fseek.3
+ Michael Kerrisk [Petr Gajdos]
+ Document EINVAL error for negative file offset
+
+fseeko.3
+ Michael Kerrisk
+ Add feature test macro requirements
+
+fts.3
+ Michael Kerrisk [Mike Frysinger]
+ Remove mention of "32-bit systems" in BUGS
+
+fwide.3
+wprintf.3
+ Michael Kerrisk [Robert P. J. Day]
+ Remove mention of bogus _ISOC95_SOURCE feature test macro
+
+getline.3
+ Alexey Samsonov
+ Caller should free the allocated buffer even if getline() failed
+ Relevant discussion in glibc bugzilla:
+ https://sourceware.org/bugzilla/show_bug.cgi?id=5666
+
+getloadavg.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getloadavg() is thread safe.
+
+getpt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getpt() is thread safe.
+
+if_nametoindex.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions if_nametoindex() and if_indextoname() are thread safe.
+
+index.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions index() and rindex() are thread safe.
+
+mkfifo.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mkfifo() and mkfifoat() are thread safe.
+
+netlink.3
+ Michael Kerrisk
+ SEE ALSO: make the reference for libnetlink the libnetlink(3) man page
+
+random.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions random(), srandom(), initstate() and setstate()
+ are thread safe.
+
+random_r.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions random_r(), srandom_r(), initstate_r() and
+ setstate_r() are thread safe.
+
+sigvec.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sigvec(), sigblock(), sigsetmask() and
+ siggetmask() are thread safe.
+
+ The macro sigmask() is thread safe.
+
+sysconf.3
+ Michael Kerrisk
+ SEE ALSO: add confstr(3)
+
+termios.3
+ Michael Kerrisk [Peter Hurley]
+ Fix error in discussion of MIN > 0, TIME == 0 noncanonical mode
+ As reported by Peter Hurley, for the MIN > 0, TIME == 0 case:
+
+ read() may unblock when MIN bytes are available but return
+ up to the 'count' parameter if more input arrives in between
+ waking and copying into the user buffer.
+ ...
+ read() may also _not_ return until MIN bytes have been
+ received, even if 'count' bytes have been received.
+ Michael Kerrisk
+ Add a note on interaction of O_NONBLOCK with noncanonical MIN/TIME
+ POSIX leaves the behavior open.
+ Michael Kerrisk
+ Clarify termination conditions for MIN > 0, TIME > 0
+ Michael Kerrisk
+ Clarify behavior if data is available before noncanonical read()
+ Michael Kerrisk
+ Add descriptive titles to noncanonical read() cases
+
+symlink.7
+ Michael Kerrisk
+ Add subsection on opening a symbolic link with O_PATH
+ Michael Kerrisk
+ name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
+ Michael Kerrisk
+ Mention use of readlink(2) to read contents of a symlink
+
+
+==================== Changes in man-pages-3.65 ====================
+
+Released: 2014-04-20, 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:
+
+Alex Thorlton <athorlton@sgi.com>
+Ashish Sangwan <a.sangwan@samsung.com>
+Christopher Covington <cov@codeaurora.org>
+Christoph Hellwig <hch@infradead.org>
+Craig McQueen <craig.mcqueen@beamcommunications.com>
+Dave Chinner <david@fromorbit.com>
+David Prévot <taffit@debian.org>
+Greg Troxel <gdt@ir.bbn.com>
+Matthew Dempsky <mdempsky@chromium.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Namjae Jeon <namjae.jeon@samsung.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Petr Gajdos <pgajdos@suse.cz>
+Richard Hansen <rhansen@bbn.com>
+Simon Paillard <spaillard@debian.org>
+Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+inet_net_pton.3
+ Michael Kerrisk
+ New page describing inet_net_pton(3) and inet_net_ntop(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fallocate.2
+ Michael Kerrisk, Namjae Jeon [Christoph Hellwig, Dave Chinner]
+ Document FALLOC_FL_COLLAPSE_RANGE
+
+prctl.2
+ Michael Kerrisk [Alex Thorlton]
+ Document PR_SET_THP_DISABLE and PR_GET_THP_DISABLE
+
+proc.5
+ Michael Kerrisk
+ Document /proc/[pid]/stack
+ Michael Kerrisk
+ Document /proc/[pid]/clear_refs
+
+
+New and changed links
+---------------------
+
+inet_net_ntop.3
+ Michael Kerrisk
+ New link to new inet_net_pton.3
+
+
+Changes to individual pages
+---------------------------
+
+fcntl.2
+ Michael Kerrisk
+ Note the race when O_CLOEXEC is used at same time as fork()+execve()
+
+madvise.2
+ Michael Kerrisk
+ SEE ALSO: see prctl(2)
+ Because of PR_SET_THP_DISABLE.
+
+mlock.2
+ Michael Kerrisk
+ Describe treatment of MCL_FUTURE during fork(2) and execve(2)
+
+msync.2
+ Michael Kerrisk [Richard Hansen, Greg Troxel]
+ Warn that one of MS_SYNC or MS_ASYNC is required
+
+open.2
+ Michael Kerrisk
+ Add more detail on the race that O_CLOEXEC is designed to avoid
+ Michael Kerrisk [Matthew Dempsky]
+ Remove crufty text stating that O_DIRECTORY is Linux-specific
+ Michael Kerrisk
+ Note which filesystems support O_TMPFILE
+
+perf_event_open.2
+ Vince Weaver [Michael Kerrisk]
+ Clarify EACCES and EPERM errors
+ Clarify the reasons for EACCES and EPERM errors.
+ Vince Weaver [Michael Kerrisk]
+ Make the ERRORS section more comprehensive.
+ Determined both by code inspection and by writing a large
+ number of test programs.
+
+personality.2
+ Michael Kerrisk
+ Available execution domains are listed in <sys/personality.h>
+ Michael Kerrisk
+ Fix discussion of return value
+
+prctl.2
+ Michael Kerrisk
+ ERRORS: document EINVAL for PR_GET_NO_NEW_PRIVS
+ ERRORS: document EINVAL for PR_SET_PDEATHSIG
+ ERRORS: document EINVAL for PR_SET_TIMING
+ ERRORS: document EINVAL for PR_SET_DUMPABLE
+ ERRORS: document EINVAL for PR_SET_NO_NEW_PRIVS
+
+shmget.2
+ Michael Kerrisk
+ Rewrite description of SHMMNI default value
+ Michael Kerrisk
+ Note default value of SHMMAX
+ Note default value for SHMALL
+
+byteorder.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions htonl(), htons(), ntohl() and ntohs() are thread
+ safe.
+
+fexecve.3
+ Michael Kerrisk [Steven Stewart-Gallus]
+ If 'fd' is a close-on-exec file descriptor for a script, fexecve() fails
+ See https://bugzilla.kernel.org/show_bug.cgi?id=74481
+
+ffs.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ffs(), ffsl() and ffsll() are thread safe.
+
+getauxval.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getauxval() is thread safe.
+
+getcontext.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions getcontext() and setcontext() are thread safe.
+
+getsubopt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getsubopt() is thread safe.
+
+getutmp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions getutmp() and getutmpx() are thread safe.
+
+inet.3
+ Michael Kerrisk
+ Note success and error return for inet_aton()
+
+inet.3
+ Michael Kerrisk [Craig McQueen]
+ The form 'a.b' if is suitable for Class A addresses (not class C)
+ Michael Kerrisk
+ SEE ALSO: add inet_net_pton(3)
+
+makecontext.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions makecontext() and swapcontext() are thread safe.
+
+pthread_attr_setdetachstate.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setdetachstate() and
+ pthread_attr_getdetachstate() are thread safe.
+
+pthread_attr_setguardsize.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setguardsize() and
+ pthread_attr_getguardsize() are thread safe.
+
+sigsetops.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sigemptyset(), sigfillset(), sigaddset(),
+ sigdelset(), sigismember(), sigisemptyset(), sigorset() and
+ sigandset() are thread safe.
+
+proc.5
+ Petr Gajdos
+ Improve /proc/[pid]/smaps entries description
+ Michael Kerrisk
+ /proc/PID/smaps is present only if CONFIG_PROC_PAGE_MONITOR
+ Michael Kerrisk
+ Note kernel version for /proc/sys/kernel/{shmall,shmmax}
+ Michael Kerrisk
+ Note kernel version for /proc/sys/kernel/{msgmax,msgmnb}
+
+capabilities.7
+ Michael Kerrisk
+ SEE ALSO: add capsh(1)
+
+libc.7
+ Michael Kerrisk
+ Add musl libc
+
+
+==================== Changes in man-pages-3.66 ====================
+
+Released: 2014-05-08, 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:
+
+Alan Curry <rlwinm@sdf.org>
+Carsten Andrich <carsten.andrich@tu-ilmenau.de>
+Daniel Borkmann <dborkman@redhat.com>
+David Prévot <taffit@debian.org>
+Eric Siegerman <pub08-knl@davor.org>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Jan Kara <jack@suse.cz>
+Jan Moskyto Matejka <mq@suse.cz>
+John Marshall <jm18@sanger.ac.uk>
+Lukáš Czerner <lczerner@redhat.com>
+Manfred Spraul <manfred@colorfullife.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Miklos Szeredi <miklos@szeredi.hu>
+Neil Horman <nhorman@tuxdriver.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Schiffer <pschiffe@redhat.com>
+Randy Dunlap <rdunlap@infradead.org>
+Silvan Jegen <s.jegen@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Stefan Puiu <stefan.puiu@gmail.com>
+Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
+Stijn Hinterding <contact@stijnhinterding.nl>
+Willem de Bruijn <willemb@google.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+fanotify_init.2
+ Heinrich Schuchardt, Michael Kerrisk
+ New page documenting fanotify_init(2)
+
+fanotify_mark.2
+ Heinrich Schuchardt, Michael Kerrisk
+ New page documenting fanotify_mark(2)
+
+sched_setscheduler.2
+ Michael Kerrisk
+ Page rewritten
+ Stripped out the general scheduling material, which
+ moved to sched(7), and rewrote much of the remainder.
+ Changed copyright and license since pretty much all
+ of the content was or is written by mtk.
+
+fanotify.7
+ Heinrich Schuchardt, Michael Kerrisk
+ New page providing overview of the fanotify API
+
+sched.7
+ Michael Kerrisk
+ New page providing an overview of the scheduling APIs
+ Most of this content derives from sched_setscheduler(2). In
+ preparation for adding a sched_setattr(2) page, it makes
+ sense to isolate out this general content to a separate
+ page that is referred to by the other scheduling pages.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fallocate.2
+ Lukas Czerner [Michael Kerrisk]
+ Document FALLOC_FL_ZERO_RANGE
+ FALLOC_FL_ZERO_RANGE was added in Linux 3.14,
+ for zeroing ranges in the allocated space in a file.
+
+rename.2
+ Miklos Szeredi [Michael Kerrisk]
+ Document renameat2() system call added in Linux 3.15
+
+shmop.2
+ Michael Kerrisk
+ Document SHM_EXEC
+
+
+Changes to individual pages
+---------------------------
+
+flock.2
+ Michael Kerrisk
+ Employ term "open file description" in DESCRIPTION
+ And include reference to open(2) for an explanation of the term.
+
+getpriority.2
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+getsockopt.2
+ Carsten Andrich
+ SEE ALSO: add packet(7)
+
+link.2
+ Michael Kerrisk [Steven Stewart-Gallus]
+ Document ENOENT error for linkat()
+ See https://bugzilla.kernel.org/show_bug.cgi?id=73301
+
+msgget.2
+ Michael Kerrisk
+ Reword EEXIST error
+
+msgop.2
+ Michael Kerrisk
+ Note capability required to raise MQ size beyond MSGMNB
+
+msync.2
+ Michael Kerrisk [Heinrich Schuchardt]
+ s/flushes... back to disk/flushes... back to filesystem/
+
+nice.2
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+open.2
+ Peter Schiffer
+ Update note on alignment of user buffer and file offset for O_DIRECT
+ The sentence in open(2) man page in notes for O_DIRECT flag:
+
+ "Under Linux 2.6, alignment to 512-byte boundaries suffices."
+
+ is not universally correct. The alignment is a property of the
+ storage, for example, 4k-sector drives with no 512 byte sector
+ emulation will be unable to perform 512-byte direct I/O.
+ Michael Kerrisk
+ Note some of the various synonyms for "open file description"
+ Michael Kerrisk
+ Remove repetitious text on use of fcntl() to change file status flags
+
+open_by_handle_at.2
+ Michael Kerrisk
+ Mention FreeBSD analogs
+
+posix_fadvise.2
+ Michael Kerrisk [Eric Siegerman]
+ Fix wording error under "Architecture-specific variants"
+ See https://bugzilla.kernel.org/show_bug.cgi?id=75431
+
+process_vm_readv.2
+ Michael Kerrisk [Stijn Hinterding]
+ Add feature test macro requirements
+ The _GNU_SOURCE FTM must be defined.
+
+read.2
+ Michael Kerrisk
+ BUGS: detail nonatomicity bug with respect to file offset updates
+ This bug was fixed in Linux 3.14, with commit
+ 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
+ See also http://thread.gmane.org/gmane.linux.kernel/1649458
+
+sched_get_priority_max.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_rr_get_interval.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_setaffinity.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_setparam.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_yield.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+semget.2
+ Michael Kerrisk
+ Consolidate discussion on noninitialization of semaphores
+ The fact that semget() does not initialize the semaphores
+ in a new set was covered in two places (in DESCRIPTION
+ and BUGS). Consolidate these into one place (in NOTES)
+ and also point out that POSIX.1-2008 says that a future
+ version of the standard may require an implementation to
+ initialize the semaphores to 0.
+ Michael Kerrisk
+ Clarify SEMMNS versus SEMMSL*SEMMNI
+ Michael Kerrisk
+ Rework EINVAL text a little
+ Michael Kerrisk
+ Clarify wording for EEXIST error
+
+shmget.2
+ Manfred Spraul
+ Clarify SHMALL
+ The default for SHMALL is a limit of 8 GB, regardless of
+ PAGE_SIZE. The current documentation does not mention that
+ and is therefore more difficult to understand than necessary.
+ Manfred Spraul
+ Correct math error
+ 2097152 is 2^21, not 2^20.
+ Michael Kerrisk
+ Reword EEXIST error
+ Michael Kerrisk
+ Clarify one of the EINVAL cases
+ Michael Kerrisk
+ Note that SHM_NORESERVE is a Linux extension
+ Michael Kerrisk [Simon Paillard]
+ Fix kernel version numbers in discussion of SHMALL
+ Michael Kerrisk
+ Rework EINVAL text
+ Michael Kerrisk
+ Move and rework discussion of mode bits
+ Michael Kerrisk
+ Reword description of O_EXCL
+
+shmop.2
+ Michael Kerrisk
+ Move fork(2), execve(2), _exit(2) discussion to NOTES
+ Michael Kerrisk
+ Add subheads for shmat() and shmdt()
+ Michael Kerrisk
+ Rework discussion of SHM_RDONLY and SHM_REMAP into list format
+ Michael Kerrisk
+ Structure the attach cases as a list
+
+sigaction.2
+ Alan Curry
+ Fix bad cross reference (times(2) not time(2))
+ The system call that reports child CPU usage is times(2),
+ not time(2).
+
+symlink.2
+ Michael Kerrisk [Steven Stewart-Gallus]
+ Document ENOENT error for symlinkat()
+ See https://bugzilla.kernel.org/show_bug.cgi?id=73301
+
+syscalls.2
+ Michael Kerrisk
+ Add renameat2()
+ And bump kernel version.
+
+write.2
+ Michael Kerrisk
+ BUGS: detail nonatomicity bug with respect to file offset updates
+ This bug was fixed in Linux 3.14, with commit
+ 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
+ See also http://thread.gmane.org/gmane.linux.kernel/1649458
+
+pthread_attr_setinheritsched.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setinheritsched() and
+ pthread_attr_getinheritsched() are thread safe.
+
+pthread_attr_setschedparam.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setschedparam() and
+ pthread_attr_getschedparam() are thread safe.
+
+pthread_attr_setschedpolicy.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setschedpolicy() and
+ pthread_attr_getschedpolicy() are thread safe.
+
+pthread_attr_setscope.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setscope() and pthread_attr_getscope()
+ are thread safe.
+
+pthread_attr_setstack.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setstack() and pthread_attr_getstack()
+ are thread safe.
+
+sched_getcpu.3
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+termios.3
+ Michael Kerrisk [Yuri Kozlov]
+ Rework intro text for 'c_oflag'
+ Michael Kerrisk
+ OFDEL is in POSIX.1-2001, so remove "(Not in POSIX)" text
+
+proc.5
+ Jan Moskyto Matejka [Randy Dunlap]
+ Improve description of /proc/stat 'intr' field
+ The sum at the beginning of line "intr" includes also
+ unnumbered interrupts.
+
+packet.7
+ Carsten Andrich [Neil Horman]
+ Improve sockopt documentation for packet sockets
+ Carsten Andrich [Willem de Bruijn]
+ PACKET_LOSS has inverse meaning
+ Stefan Puiu [Daniel Borkmann, Carsten Andrich]
+ Status in PACKET_RX_RING is actually a bit mask
+ Michael Kerrisk [Carsten Andrich]
+ SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c
+
+
+==================== Changes in man-pages-3.67 ====================
+
+Released: 2014-05-21, 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:
+
+Andy Lutomirski <luto@amacapital.net>
+Aurelien Jarno <aurelien@aurel32.net>
+Bill Allombert <ballombe@debian.org>
+Christoph Hellwig <hch@infradead.org>
+Davidlohr Bueso <davidlohr@hp.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Ingo Schwarze <schwarze@usta.de>
+Jan Kara <jack@suse.cz>
+Jon Grant <jg@jguk.org>
+Juri Lelli <juri.lelli@gmail.com>
+Lucas De Marchi <lucas.demarchi@profusion.mobi>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Zijlstra <peterz@infradead.org>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Sam Varshavchik <mrsam@courier-mta.com>
+Simon Paillard <spaillard@debian.org>
+Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
+Török Edwin <edwin@etorok.net>
+William Morriss <wjmelements@gmail.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+sched_setattr.2
+ Michael Kerrisk, Peter Zijlstra [Juri Lelli]
+ New page describing sched_setattr(2) and sched_getattr(2)
+
+system.3
+ Michael Kerrisk
+ Rewrote large parts of the page and added a number of details
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+sched.7
+ Peter Zijlstra, Michael Kerrisk [Juri Lelli]
+ Document SCHED_DEADLINE
+
+New and changed links
+---------------------
+
+renameat2.2
+ Michael Kerrisk
+ New link to rename.2
+
+sched_getattr.2
+ Michael Kerrisk
+ New link to new sched_setattr
+
+
+Changes to individual pages
+---------------------------
+
+bind.2
+ Michael Kerrisk
+ ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
+
+chown.2
+ Michael Kerrisk
+ NOTES: Add some subheadings
+
+connect.2
+ Michael Kerrisk [William Morriss]
+ ERRORS: Add EADDRNOTAVAIL for ephemeral port range exhaustion
+ Verified from testing and the kernel source.
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=745775
+ Michael Kerrisk
+ Remove mention of ip_local_port_range under EAGAIN error
+
+create_module.2
+delete_module.2
+init_module.2
+query_module.2
+ Michael Kerrisk [Lucas De Marchi]
+ Clarify glibc header file declaration/ABI wrapper details
+ create_module(), delete_module(), init_module(), and
+ query_module() are not declared in header files, but
+ through an accident of history glibc provides an ABI
+ for them that it continues to maintain, for
+ compatibility reasons.
+
+execve.2
+ Michael Kerrisk [Steven Stewart-Gallus]
+ Note SIGKILL case when execve() fails beyond the point of no return
+ Michael Kerrisk
+ NOTES: Add a subheading and reorder paragraphs
+
+fanotify_init.2
+ Heinrich Schuchardt [Michael Kerrisk]
+ Document range of permitted flags for event_f_flags
+ With a new patch included in the mm tree, event_f_flags is
+ checked for allowable values.
+
+fcntl.2
+ Michael Kerrisk
+ Add "file locking" subheading under NOTES
+
+fork.2
+ Michael Kerrisk
+ ERRORS: SCHED_DEADLINE tasks can fail with EAGAIN
+ SCHED_DEADLINE tasks can fail with EAGAIN unless the
+ reset-on-fork flag is set.
+
+futex.2
+ Michael Kerrisk
+ Note that there is no glibc wrapper
+
+getpriority.2
+ Rasmus Villemoes
+ Fix prototypes for getpriority() and setpriority()
+ The who argument has type id_t (which happens to be u32 on linux).
+
+get_robust_list.2
+ Rasmus Villemoes
+ Add <sys/types.h> to synopsis of get_robust_list()
+ If one were to implement wrappers for [gs]et_robust_list() using the
+ given prototypes, one would also have to include sys/types.h to get
+ a definition of size_t.
+
+getrusage.2
+ Michael Kerrisk [Bill Allombert]
+ _GNU_SOURCE must be defined to obtain RUSAGE_THREAD definition
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=746569
+
+link.2
+open.2
+ Andy Lutomirski [Michael Kerrisk]
+ Update AT_EMPTY_PATH and O_PATH documentation
+
+listen.2
+ Michael Kerrisk
+ ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
+
+mbind.2
+ Rasmus Villemoes
+ Fix prototype for mbind(2)
+ The nmask argument is const. The return type in numaif.h is long.
+ (Well, at least <numaif.h> says nmask is const. The current kernel
+ does not define it as a const argument, but sys_mbind() only
+ passes it to get_nodes(), which does treat it as const.)
+
+msgop.2
+ Davidlohr Bueso [Michael Kerrisk]
+ Enhance description of "full queue" criteria
+
+poll.2
+ Rasmus Villemoes
+ Add <signal.h> to synopsis for ppoll()
+ One needs to #include <signal.h> to get the definition of the
+ type (sigset_t) of the mask argument to ppoll().
+
+readlink.2
+ Rasmus Villemoes
+ Fix return type of readlinkat()
+
+recv.2
+ Michael Kerrisk
+ Clarify details of msg_name and msg_namelen fields
+
+recvmmsg.2
+ Michael Kerrisk
+ Describe timeout bug
+ See https://bugzilla.kernel.org/show_bug.cgi?id=75371
+ and http://thread.gmane.org/gmane.linux.man/5677
+
+remap_file_pages.2
+ Andy Lutomirski [Christoph Hellwig, Andy Lutomirski]
+ remap_file_pages() has no benefit for real files
+ Linux commit 3ee6dafc677a68e461a7ddafc94a580ebab80735 caused
+ remap_file_pages to be emulated when used on real file.
+
+sched_get_priority_max.2
+ Michael Kerrisk
+ 'policy' can also be SCHED_DEADLINE
+
+sched_setaffinity.2
+ Rasmus Villemoes
+ Fix prototype for sched_setaffinity()
+ The mask argument is const.
+
+sched_setparam.2
+ Michael Kerrisk
+ ERRORS: mark errors that apply just for sched_setparam()
+ Michael Kerrisk
+ ERRORS: Add EINVAL for invalid arguments
+ Michael Kerrisk
+ SEE ALSO: add sched_setattr(2)
+
+sched_setscheduler.2
+ Michael Kerrisk
+ ERRORS: mark errors that apply just to sched_setscheduler()
+ Michael Kerrisk
+ ERRORS: add EINVAL case for pid < 0
+ Michael Kerrisk
+ ERRORS: separate out EINVAL cases
+
+semget.2
+ Michael Kerrisk
+ NOTES: Add subheadings and reorder paragraphs
+
+semop.2
+ Rasmus Villemoes
+ Fix prototypes for semop() and semtimedop()
+ The nsops arguments have type size_t, not unsigned, and the
+ timeout argument of semtimedop() is const.
+ Michael Kerrisk
+ NOTES: Add a subheading
+
+send.2
+ Michael Kerrisk
+ Add details on various 'msghdr' fields
+ Michael Kerrisk
+ ERRORS: Add EAGAIN for ephemeral port range exhaustion
+ Michael Kerrisk
+ Add some subheadings under DESCRIPTION
+
+shmget.2
+ Michael Kerrisk
+ NOTES: Add a subheading
+
+stat.2
+ Michael Kerrisk [Aurelien Jarno]
+ Describe feature test macro requirements for file type test macros
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=728240
+ Michael Kerrisk
+ Update FTM requirements for lstat()
+ Michael Kerrisk
+ Split discussion of 'st_mode' fields into type and permissions
+ Michael Kerrisk
+ Move text on S_I*() macros to follow text on S_I* macros
+ That ordering is more logical
+
+stime.2
+ Rasmus Villemoes
+ Fix prototype for stime()
+ The argument is const, both according to the actual header files and
+ according to <http://www.sco.com/developers/devspecs/vol1a.pdf>.
+
+syscall.2
+ Rasmus Villemoes
+ Fix prototype for syscall()
+ The first argument and the return value of syscall() has type long,
+ not int.
+
+getopt.3
+ Michael Kerrisk
+ EXAMPLE: Add subheadings to distinguish the two example programs
+
+malloc.3
+ Michael Kerrisk
+ Reword text referring to mallopt(3)
+ Linux libc is no longer "recent"; drop mention of it.
+
+pthread_attr_setinheritsched.3
+pthread_attr_setschedparam.3
+pthread_attr_setschedpolicy.3
+pthread_setaffinity_np.3
+pthread_setschedparam.3
+pthread_setschedprio.3
+pthread_yield.3
+pthreads.7
+ Michael Kerrisk
+ Change references to "sched_setscheduler(2)" to "sched(7)"
+ Change consistent with the fact that the scheduling overview
+ page is now sched(7) not sched_setscheduler(2).
+
+pthread_attr_setstackaddr.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setstackaddr() and
+ pthread_attr_getstackaddr() are thread safe.
+
+pthread_attr_setstacksize.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setstacksize() and
+ pthread_attr_getstacksize() are thread safe.
+
+pthread_kill.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_kill() is thread safe.
+
+pthread_kill_other_threads_np.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_kill_other_threads_np() is thread safe.
+
+pthread_self.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_self() is thread safe.
+
+pthread_setcancelstate.3
+ Michael Kerrisk
+ Add paragraph breaks to "Asynchronous cancelability" subsection
+
+pthread_setcancelstate.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setcancelstate() and
+ pthread_setcanceltype() are thread safe.
+ Michael Kerrisk
+ NOTES: Add some subheadings
+
+pthread_setschedparam.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setschedparam() and pthread_getschedparam()
+ are thread safe.
+
+pthread_setschedprio.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_setschedprio() is thread safe.
+
+pthread_sigmask.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_sigmask() is thread safe.
+
+pthread_sigqueue.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_sigqueue() is thread safe.
+
+pthread_testcancel.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_testcancel() is thread safe.
+
+pthread_yield.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_yield() is thread safe.
+
+remquo.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions remquo(), remquof() and remquol() are thread safe.
+
+rtime.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function rtime() is thread safe.
+
+sched_getcpu.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sched_getcpu() is thread safe.
+
+stpcpy.3
+ Ingo Schwarze
+ Note some history of stpcpy()
+ Quoting Ingo:
+ I just noticed that the stpcpy(3) manual contains a speculation
+ that appears to be untrue on closer investigation: That function
+ did not originate in MS DOS, but in Lattice C on AmigaDOS.
+
+ Here is a patch against the git master HEAD to fix that, and add
+ some more historical information. To provide some background and
+ allow you to more easily verify the correctness of the patch, i'm
+ appending my mail to <misc@openbsd.org>, where i'm giving some
+ more details about the history and pointing to some primary
+ sources. That mail also contains the (similar, but shorter)
+ patch i just committed to the OpenBSD manual page.
+
+strcasecmp.3
+ Michael Kerrisk [Aurelien Jarno, Török Edwin]
+ Explain why strcasecmp()+strncasecmp() are also declared in <string.h>
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729436
+
+strcpy.3
+ Michael Kerrisk
+ NOTES: Add a subheading
+
+fd.4
+ Michael Kerrisk [Sam Varshavchik]
+ Fix floppy disk device names
+ The naming convention shown in the page was ancient.
+ Now, the page is consistent with Documentation/devices.txt
+ (where it is noted that "The use of the capital letters
+ D, H and E for the 3.5" models have been deprecated, since
+ the drive type is insignificant for these devices"
+
+proc.5
+ Michael Kerrisk
+ Document /proc/timer_stats
+ Michael Kerrisk
+ (Briefly) document /proc/timer_list
+ Michael Kerrisk
+ Add /proc/sys/kernel/{sched_rt_period_us,sched_rt_runtime_us}
+ Reference sched(7) for an explanation of these two files
+
+capabilities.7
+ Michael Kerrisk
+ Mention sched_setattr(2) under CAP_SYS_NICE
+
+cpuset.7
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+credentials.7
+ Michael Kerrisk
+ Mention sched_getattr() as a place where credentials are checked
+
+fanotify.7
+ Heinrich Schuchardt [Jan Kara]
+ BUGS: error events can be lost when reading from fanotify FD
+ Michael Kerrisk [Heinrich Schuchardt]
+ Fix description of FAN_EVENT_NEXT()
+ FAN_EVENT_NEXT() does not update 'meta'; rather, it returns a
+ pointer to the next metadata structure. In addition, generally
+ rework the description to be a bit clearer and more detailed.
+ Heinrich Schuchardt
+ Document FAN_EVENT_METADATA_LEN
+
+ip.7
+ Michael Kerrisk
+ Note cases where an ephemeral port is used
+ Michael Kerrisk
+ Remove BUGS text on glibc failing to declare in_pktinfo
+ Michael Kerrisk
+ Clarify 'ip_local_port_range' and mention the term "ephemeral ports"
+ Michael Kerrisk
+ Note some more details about assignment of ephemeral ports
+ Michael Kerrisk
+ BUGS: ephemeral port range exhaustion is diagnosed inconsistently
+ Different system calls use different 'errno' values to diagnose
+ exhaustion of the ephemeral port range.
+
+sched.7
+ Michael Kerrisk
+ Document sched_rt_period_us and sched_rt_runtime_us /proc files
+ And rework and relocate the text on dealing with runaway
+ real-time processes.
+ Michael Kerrisk
+ Mention sched_setattr(2) in list of APIs that can change policies
+ Michael Kerrisk
+ sched_setattr(2) can also be used to set 'nice' value
+ Michael Kerrisk
+ Remove mention of sched_setscheduler() when talking about sched_priority
+ There are nowadays multiple ways to set sched_priority (and
+ in fact there always were, since we also had sched_setparam(2)).
+ Michael Kerrisk
+ SEE ALSO: Add Documentation/scheduler/sched-design-CFS.txt
+ Michael Kerrisk
+ Don't mention sched_setscheduler(2) in discussions of setting policies
+ In a couple of places, sched_setscheduler(2) is mentioned as the
+ way of setting policies. But now there is sched_setattr(2) as
+ well, rewrite the text in a more generic way.
+ Michael Kerrisk
+ Rework summary text describing sched_setattr(2) and sched_getattr(2)
+ Note that these APIs are a superset of sched_setscheduler(2)
+ and sched_getscheduler(2).
+ Michael Kerrisk
+ Remove crufty text relating to sched_setscheduler()
+ All of the removed text is in sched_setscheduler(2) and
+ should have been trimmed from this page.
+ Michael Kerrisk
+ SEE ALSO: Mention more files in Documentation/scheduler/ directory
OSDN Git Service
