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!
pthread_sigqueue.3
Michael Kerrisk
- New page documenting ptrhead_sigqueue()
+ New page documenting pthread_sigqueue()
pthread_sigqueue() is new in glibc 2.11 (requires a kernel with
rt_tgsigqueinfo(), added in Linux 2.6.31).
timerfd_create.2
Michael Kerrisk [Josh Triplett]
- Note behavior when timerdfd_settime() old_value is NULL
+ Note behavior when timerfd_settime() old_value is NULL
See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513
Tomislav Jonjic
Fix small error in description of timerfd_settime()
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>
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
Akihiro MOTOKI <amotoki@gmail.com>
Andries E. Brouwer <Andries.Brouwer@cwi.nl>
-Angelo Borsotti <angelo.borsotti@gmail.com >
+Angelo Borsotti <angelo.borsotti@gmail.com>
Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
-Casper.Dik@oracle.com
+Casper Dik <Casper.Dik@oracle.com>
David Prévot <taffit@debian.org>
D. Barbier <bouzim@gmail.com>
Eric Blake <eblake@redhat.com>
Nick Piggin <npiggin@gmail.com>
Paul Pluzhnikov <ppluzhnikov@google.com>
Petr Baudis <pasky@ucw.cz>
-Ralph Corderoy <ralph@inputplus.co.uk >
+Ralph Corderoy <ralph@inputplus.co.uk>
Rich Felker <bugdal@aerifal.cx>
Simone Piccardi <piccardi@truelite.it>
Simon Paillard <spaillard@debian.org>
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.kernel.org
+ 2012-05-07 "aio manuals", linux-man@vger
http://thread.gmane.org/gmane.linux.man/1935/focus=2910
Other minor rewrites.
Upstreamed from Red Hat / Fedora
realpath.3
- Michael Kerrisk [Casper.Dik@oracle.com]
+ Michael Kerrisk [Casper Dik]
Remove note about Solaris possibly returning a relative path
syslog.3
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
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
lseek.2
Michael Kerrisk [Andreas Jaeger]
- _GNU_SOURCE must be defined to get SEEK_DATE and SEEK_HOLE definitions
+ _GNU_SOURCE must be defined to get SEEK_DATA and SEEK_HOLE definitions
See http://sourceware.org/bugzilla/show_bug.cgi?id=15312
mmap.2
Michael Kerrisk
Add EINVAL error for setstate()
Michael Kerrisk
- BUGS: inistate() does not return NULL on error
+ BUGS: initstate() does not return NULL on error
http://sourceware.org/bugzilla/show_bug.cgi?id=15380
random_r.3
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_handle_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
+
+
+==================== Changes in man-pages-3.68 ====================
+
+Released: 2014-05-28, 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:
+
+Alastair McKinstry <mckinstry@computer.org>
+Carsten Grohmann <carstengrohmann@gmx.de>
+Colin Williams <colinwilliams1968@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Lars Wirzenius <liw@iki.fi>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Richard Braakman <richard.braakman@jollamobile.com>
+Simon Paillard <spaillard@debian.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+localedef.1
+ Marko Myllynen, Richard Braakman, Alastair McKinstry, Lars Wirzenius
+ New page for localedef(1)
+ Add new page based on Debian localedef(1) page.
+
+
+New and changed links
+---------------------
+
+procfs.5
+ New link to proc.5
+ Since the term "procfs" is widely used, it seems reasonable to have
+ a link from that name to proc(5).
+
+
+Changes to individual pages
+---------------------------
+
+locale.1
+ Marko Myllynen
+ Provide a step-by-step example of how to use a custom locale
+ Marko Myllynen
+ Use LC_TELEPHONE instead of LC_MESSAGES in the example
+ yesstr/nostr in LC_MESSAGES are planned to be changed at some
+ point [1], so it's better to provide an example which won't
+ be obsoleted by that change.
+
+ [1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975
+
+adjtimex.2
+ Michael Kerrisk
+ Add feature test macro requirements
+
+clone.2
+ Michael Kerrisk
+ ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
+
+fork.2
+ Michael Kerrisk
+ ERRORS: add pid_max and threads-max to EAGAIN
+ And rewrite text to be the same as pthread_create(3).
+
+getrlimit.2
+ Michael Kerrisk
+ RLIMIT_NPROC is not enforced if CAP_SYS_ADMIN or CAP_SYS_RESOURCE
+
+remap_file_pages.2
+ Rasmus Villemoes
+ Fix prototype
+ The pgoff argument has type size_t, not ssize_t (and in the
+ kernel it is unsigned long).
+
+set_mempolicy.2
+ Rasmus Villemoes
+ Fix prototype for set_mempolicy(2)
+ The nodemask argument is const. The return type in numaif.h is long.
+
+swapon.2
+ Rasmus Villemoes
+ Remove header from synopsis
+ The <asm/page.h> header is not readily available, and the comment
+ seems to indicate that it is for getting PAGE_SIZE. But it is
+ never mentioned why one would need to know that, and it is in any
+ case better obtained using sysconf(), provided by <unistd.h>.
+
+a64l.3
+ Rasmus Villemoes
+ Fix prototype for a64l()
+ The argument is const, both according to POSIX and the
+ glibc headers.
+
+adjtime.3
+ Rasmus Villemoes
+ Add required header
+ The prototype for adjtime(3) is declared in <sys/time.h>.
+
+argz_add.3
+ Rasmus Villemoes
+ Fix prototypes
+ Update the prototypes of argz_{delete,extract,next} to agree with
+ glibc headers and manual.
+
+bstring.3
+ Rasmus Villemoes
+ Fix prototypes
+ The length parameter n has type size_t in bcmp(), bcopy() and
+ bzero().
+
+envz_add.3
+ Rasmus Villemoes
+ Fix prototypes
+ The envz_len parameters for envz_entry() and envz_get() are not
+ passed by reference.
+
+fpathconf.3
+ Rasmus Villemoes
+ Fix prototype
+ The path argument to pathconf() is const.
+
+fseek.3
+ Rasmus Villemoes
+ Fix prototype
+ The pos argument to fsetpos() is const.
+
+gcvt.3
+ Rasmus Villemoes
+ Fix prototype
+ The ndigit parameter to gcvt() has type int.
+
+getaddrinfo_a.3
+ Rasmus Villemoes
+ Fix prototype
+ The pointer arguments to gai_suspend() are const.
+
+getauxval.3
+ Rasmus Villemoes
+ Fix permissions
+ There doesn't seem to be any reason for getauxval.3 to be
+ executable...
+
+getnameinfo.3
+ Rasmus Villemoes
+ Fix prototype
+ The hostlen and servlen parameters have type socklen_t.
+ (The types changed in glibc 2.2)
+ Michael Kerrisk
+ Note types of 'hostlen'; and 'servlen' in glibc < 2.2
+
+getrpcent.3
+ Rasmus Villemoes
+ Fix prototype
+ The argument to getrpcbyname() is const.
+
+getrpcport.3
+ Rasmus Villemoes
+ Add #include and fix prototype
+ The prototype for getrpcport() is obtained by #include'ing
+ <rpc/rpc.h>. Also, update its prototype.
+
+getspnam.3
+ Rasmus Villemoes
+ Fix prototype
+ The struct spwd argument to putspent() is const.
+
+getutent.3
+ Rasmus Villemoes
+ Fix prototypes
+ The arguments to getutid(), getutline(), and pututline()
+ are const.
+
+inet.3
+ Rasmus Villemoes
+ Fix prototype
+ The parameters to inet_makeaddr have type in_addr_t.
+
+inet_net_pton.3
+ Rasmus Villemoes
+ srcfix, cfix
+ Use a consistent style throughout the man-pages.
+
+key_setsecret.3
+ Rasmus Villemoes
+ Fix prototypes
+ Remove const qualifiers from arguments to key_decryptsession,
+ key_encryptsession, and key_setsecret.
+
+makecontext.3
+ Rasmus Villemoes
+ Fix prototype
+ The second argument to swapcontext() is const.
+
+makedev.3
+ Rasmus Villemoes
+ Fix prototype
+ gnu_dev_makedev, and hence its trivial macro wrapper makedev, takes
+ two unsigned int parameters; this is consistent with it being the
+ inverse of (gnu_dev_)major/minor, which return unsigned int.
+
+malloc_trim.3
+ Rasmus Villemoes
+ Fix prototype
+ As mentioned further down, malloc_trim returns an integer.
+
+mq_getattr.3
+ Rasmus Villemoes
+ Fix prototype
+ The newattr parameter to mq_setattr is const.
+
+newlocale.3
+ Marko Myllynen
+ List all available category masks
+ Michael Kerrisk
+ Add LC_ALL_MASK description
+
+nl_langinfo.3
+ Marko Myllynen
+ Expand the example code a bit
+ Better illustrate querying elements from different categories.
+
+perror.3
+ Rasmus Villemoes
+ Fix declaration
+ The elements of the array sys_errlist are also const.
+
+pthread_attr_setaffinity_np.3
+pthread_attr_setdetachstate.3
+pthread_attr_setguardsize.3
+pthread_attr_setinheritsched.3
+pthread_attr_setschedparam.3
+pthread_attr_setschedpolicy.3
+pthread_attr_setscope.3
+pthread_attr_setstack.3
+pthread_attr_setstackaddr.3
+pthread_attr_setstacksize.3
+ Rasmus Villemoes
+ Constify parameters
+ Each of the pthread_attr_get* functions extract some piece of
+ information from a pthread_attr_t, which is passed by const
+ reference. Add the const keyword to the prototypes of these
+ functions.
+
+pthread_cleanup_push_defer_np.3
+ Michael Kerrisk [Rasmus Villemoes]
+ Add feature test macro requirements
+
+pthread_create.3
+ Michael Kerrisk [Carsten Grohmann]
+ Add pid_max limit to EAGAIN error cases
+
+pthread_equal.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_equal() is thread safe.
+
+pthread_exit.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_exit() is thread safe.
+
+pthread_getcpuclockid.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_getcpuclockid() is thread safe.
+
+pthread_setaffinity_np.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setaffinity_np() and
+ pthread_getaffinity_np() are thread safe.
+
+pthread_setconcurrency.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setconcurrency() and
+ pthread_getconcurrency() are thread safe.
+
+pthread_setname_np.3
+ Rasmus Villemoes
+ Fix prototype
+ The name parameter of pthread_getname_np is an output parameter and
+ hence not const.
+
+pthread_setschedparam.3
+ Rasmus Villemoes
+ Fix prototypes
+ Add return type for pthread_{s,g}etschedparam.
+
+pthread_setschedprio.3
+ Rasmus Villemoes
+ Fix prototype
+ Add return type for pthread_setschedprio.
+
+pthread_sigqueue.3
+ Rasmus Villemoes
+ Add missing #include <signal.h>
+
+rcmd.3
+ Rasmus Villemoes
+ Fix prototypes
+ Unlike the BSDs, the second argument of rcmd() and rcmd_af() has
+ type unsigned short.
+ The first argument of iruserok_af() has type const void*.
+
+re_comp.3
+ Rasmus Villemoes
+ Fix prototypes
+ re_comp and re_exec take const char* arguments.
+
+resolver.3
+ Rasmus Villemoes
+ Fix prototypes and extern-declaration
+ Fix const- and signedness of various char* parameters.
+
+ Also, there is no "struct state", but _res is a struct
+ __res_state. (Actually, _res is errno-like in that it is really a
+ macro expanding to (*__res_state()).)
+
+rexec.3
+ Rasmus Villemoes
+ Fix prototypes
+ The user, passwd and cmd arguments to rexec and rexec_af are all
+ const.
+
+rtime.3
+ Rasmus Villemoes
+ Replace header
+ The header <rpc/des_crypt.h> does not provide rtime();
+ <rpc/auth_des.h> does, as is also implied in both the NOTES and
+ EXAMPLE sections.
+
+scandir.3
+ Rasmus Villemoes
+ Fix prototypes
+ The alphasort and versionsort functions take arguments of type
+ const struct dirent **, not const void *.
+
+setlocale.3
+ Michael Kerrisk [Marko Myllynen]
+ Simplify locale category listing and add GNU-specific locale categories
+ Some information that was here will move to locale(7).
+ Marko Myllynen
+ Remove now obsolete NOTES section
+
+setnetgrent.3
+ Rasmus Villemoes
+ Fix prototype
+ The buflen argument to getnetgrent_r has type size_t.
+
+sigvec.3
+ Rasmus Villemoes
+ Fix prototype
+ The vec argument to sigvec is const.
+
+tsearch.3
+ Rasmus Villemoes
+ Fix prototype
+ The rootp argument to tfind is "void * const *",
+ not "const void **".
+
+core.5
+ Michael Kerrisk
+ Core dump files are nowadays core.pid by default
+
+locale.5
+ Marko Myllynen
+ Document mon_grouping and grouping properly
+ Michael Kerrisk
+ Note default value for 'first_workday'
+ Michael Kerrisk [Marko Myllynen]
+ Add brief descriptions of collating-element and collating-symbol
+ Marko Myllynen
+ t_fmt_ampm is needed only for locales that employ AM/PM convention
+ Michael Kerrisk [Marko Myllynen]
+ Remove crufty reference to /usr/lib/nls/src
+ That file is nowhere to be found
+ Marko Myllynen
+ Clarify LC_TIME/am_pm and LC_NAME keywords usage
+ am_pm should be defined only if AM/PM convention is used to signal
+ applications they should not try to print them when using them in
+ unwanted.
+
+ Same for all LC_NAME keywords expect for name_fmt which should be
+ always defined.
+ Marko Myllynen
+ Clarify lang_term / lang_lib
+ As noted by Keld Simonsen in the lib-locales@sourceware mailing
+ list:
+
+ https://sourceware.org/ml/libc-locales/2014-q2/msg00008.html
+ From: Keld Simonsen <keld at rap dot rap dot dk>
+ To: Marko Myllynen <myllynen at redhat dot com>
+ Date: Tue, 29 Apr 2014 17:02:09 +0200
+
+ lang_term reflects ISO 639-2/T (terminology) codes, while
+ lang_lib reflects ISO 639-2/B (bibliographic) codes.
+ lang_term is preferred over lang_lib codes for locale names.
+ There are 20 specific ISO 639-2/B codes.
+ Marko Myllynen
+ Correct the FILES section
+
+proc.5
+ Michael Kerrisk
+ 'pid_max' is a system-wide limit on number of threads and processes
+ Since PIDs > /proc/sys/kernel/pid_max are not allocated, this
+ file thus also imposes a system-wide limit on the number of
+ threads and processes.
+
+capabilities.7
+ Michael Kerrisk
+ CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
+ Michael Kerrisk
+ CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
+
+charsets.7
+ Michael Kerrisk [Marko Myllynen]
+ Remove crufty statement that Romanian may be switching to ISO 8859-16
+ Michael Kerrisk
+ Remove ancient paragraph on charsets supported in glibc 2.3.2
+ That test is rather ancient, and probably of little use.
+
+fanotify.7
+ Heinrich Schuchardt
+ Fix to example program: fanotify read() should use aligned buffer
+
+inotify.7
+ Heinrich Schuchardt
+ Add example program
+ This example of the usage of the inotify API shows the
+ usage of inotify_init1(2) and inotify_add_watch(2) as well
+ as polling and reading from the inotify file descriptor.
+ Heinrich Schuchardt
+ munmap() does not generate inotify events
+
+locale.7
+ Marko Myllynen [Michael Kerrisk]
+ Document the LOCPATH environment variable
+ Michael Kerrisk
+ Add further details on various categories
+
+
+
+==================== Changes in man-pages-3.69 ====================
+
+Released: 2014-06-14, 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>
+Jan Chaloupka <jchaloup@redhat.com>
+Jeff Layton <jlayton@poochiereds.net>
+Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
+KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+NeilBrown <neilb@suse.de>
+Peng Haitao <penght@cn.fujitsu.com>
+Petr Gajdos <pgajdos@suse.cz>
+Qian Lei <qianl.fnst@cn.fujitsu.com>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Vasiliy Kulikov <segoon@openwall.com>
+Walter Harms <wharms@bfs.de>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+iconv.1
+ Marko Myllynen [Michael Kerrisk]
+ New page for the iconv(1) command
+
+iconvconfig.8
+ Marko Myllynen
+ New page for iconvconfig(8)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fcntl.2
+ Jeff Layton, Michael Kerrisk
+ Document open file description locks
+ As provided by the fcntl() operations F_OFD_SETLK,
+ F_OFD_SETLKW, and F_OFD_GETLK
+
+
+Changes to individual pages
+---------------------------
+
+locale.1
+ Marko Myllynen
+ Add FILES section, add charmap(5) reference
+ Marko Myllynen
+ Align with recent charmap(5) / repertoiremap(5) changes
+
+execve.2
+ Michael Kerrisk [NeilBrown]
+ Before kernel 2.6.0, RLIMIT_NPROC had no effect for set*uid()
+ Michael Kerrisk [Vasiliy Kulikov]
+ RLIMIT_NPROC is checked only if preceded by set*uid()
+ Michael Kerrisk [Vasiliy Kulikov, NeilBrown, KOSAKI Motohiro]
+ Document EAGAIN error
+ See also https://bugzilla.kernel.org/show_bug.cgi?id=42704
+
+fcntl.2
+ Michael Kerrisk
+ Detail the limitations of traditional (process-associated) locks
+ Michael Kerrisk [Jeff Layton]
+ Describe how to check whether the kernel supports a particular command
+ Michael Kerrisk
+ ERRORS: add EINVAL for invalid 'cmd'
+ Michael Kerrisk
+ Add para introducing advisory locks and noting existence of OFD locks
+ Michael Kerrisk [Jeff Layton]
+ Add notes on F_SETLKW deadlock detection and its limitations
+ Michael Kerrisk
+ Add an explicit note that mandatory locking is not in POSIX
+ Michael Kerrisk
+ Rewrite introductory paragraphs on mandatory locking
+ Make the structure more logical, and also explicitly mention
+ OFD locks.
+ Michael Kerrisk [Jeff Layton]
+ Reword discussion of mandatory lock bug a little
+ Jeff Layton confirmed that the bug remains even in modern kernels.
+ Michael Kerrisk
+ Explain POSIX background to EACCES/EAGAIN error for F_GETLK
+ Michael Kerrisk
+ Add NOTES subhead for record locking and NFS
+ Michael Kerrisk [NeilBrown]
+ Note treatment of locks when an NFS client loses contact with the server
+ Michael Kerrisk [Jeff Layton]
+ nfsv4leasetime controls the "contact lost" interval for NFSv4
+
+flock.2
+ Michael Kerrisk
+ In some modern BSDs, fcntl() and flock() locks do interact
+ So, reword and extend the discussion of this topic in NOTES.
+ Michael Kerrisk
+ Move NOTES text describing implementation of flock()
+ Michael Kerrisk [NeilBrown]
+ Add more details on NFS, including Linux 2.6.37 changes
+ Also: move NOTES text describing interaction of fcntl()
+ and flock() locks.
+
+fork.2
+ Michael Kerrisk
+ Add notes on inheritance of flock() and OFD locks across fork()
+
+lseek.2
+ Michael Kerrisk
+ Add reference to open(2) for discussion of file descriptors and OFDs
+
+open.2
+ Michael Kerrisk
+ Rework and extend the discussion of open file descriptions
+
+open_by_handle_at.2
+ Rasmus Villemoes
+ Add reference to feature_test_macros(7)
+
+recvmmsg.2
+ Rasmus Villemoes
+ Add reference to feature_test_macros(7)
+
+remap_file_pages.2
+ Michael Kerrisk [Kirill A. Shutemov]
+ Note that remap_file_pages() is deprecated
+
+sendmmsg.2
+ Rasmus Villemoes
+ Add reference to feature_test_macros(7)
+
+seteuid.2
+ Michael Kerrisk
+ seteuid() and setegid() are implemented as library functions
+ Michael Kerrisk
+ Error checking should always be performed, even when caller is UID 0
+
+setresuid.2
+ Michael Kerrisk
+ Document EAGAIN error that can occur after kernel alloc_uid() failure
+ Michael Kerrisk
+ Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
+ Michael Kerrisk
+ Correct the description of the EAGAIN error
+ Michael Kerrisk
+ Error checking should always be performed, even when caller is UID 0
+
+setreuid.2
+ Michael Kerrisk
+ Document EAGAIN error that can occur after kernel alloc_uid() failure
+ Michael Kerrisk
+ Error checking should always be performed, even when caller is UID 0
+ Michael Kerrisk
+ Add EAGAIN error for hitting RLIMIT_NPROC limit
+ Michael Kerrisk
+ Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
+
+setuid.2
+ Michael Kerrisk
+ Document EAGAIN error that can occur after kernel alloc_uid() failure
+ Michael Kerrisk
+ Correct the description of the EAGAIN error
+ Michael Kerrisk
+ Error checking should always be performed, even when caller is UID 0
+ Michael Kerrisk
+ Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
+
+statfs.2
+ Cyril Hrubis
+ Update MAGIC constants
+ Most of the updates are taken from /usr/include/linux/magic.h,
+ some were found by grepping the Linux source code.
+ Cyril Hrubis [Michael Kerrisk]
+ fstatfs(2) was broken on file descriptors from pipe(2)
+
+syscalls.2
+ Michael Kerrisk
+ Note that remap_file_pages() is deprecated
+
+basename.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions basename() and dirname() are thread safe.
+
+catgets.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function catgets() is thread safe.
+
+getdate.3
+ Rasmus Villemoes
+ Use blank definition of _GNU_SOURCE in example program
+
+getdirentries.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getdirentries() is thread safe.
+
+getdtablesize.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getdtablesize() is thread safe.
+
+iconv.3
+ Qian Lei [Peng Haitao]
+ ATTRIBUTES: Note function that is thread-safe
+ The function iconv() is thread safe.
+ Michael Kerrisk
+ SEE ALSO: add iconvconfig(8)
+
+lockf.3
+ Qian Lei [Peng Haitao]
+ ATTRIBUTES: Note function that is thread-safe
+ The function lockf() is thread safe.
+
+malloc_get_state.3
+ Rasmus Villemoes
+ SYNOPSIS: use correct header
+ The nonstandard functions malloc_set_state() and
+ malloc_get_state() are provided by <malloc.h> not <stdlib.h>.
+
+malloc_usable_size.3
+ Qian Lei
+ ATTRIBUTES: Note function that is thread-safe
+ The function malloc_usable_size() is thread safe.
+
+matherr.3
+ Qian Lei [Peng Haitao]
+ ATTRIBUTES: Note function that is thread-safe
+ The function matherr() is thread safe.
+
+mkdtemp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function mkdtemp() is thread safe.
+
+mkstemp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mkstemp(), mkostemp(), mkstemps() and mkostemps()
+ are thread safe.
+
+mq_close.3
+ Qian Lei
+ ATTRIBUTES: Note function that is thread-safe
+ The function mq_close() is thread safe.
+
+mq_getattr.3
+ Qian Lei
+ ATTRIBUTES: Note function that is thread-safe
+ The functions mq_getattr() and mq_setattr() are thread safe.
+
+mq_open.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function mq_open() is thread safe.
+
+mq_receive.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mq_receive() and mq_timedreceive() are thread safe.
+
+mq_send.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mq_send() and mq_timedsend() are thread safe.
+
+mq_unlink.3
+ Qian Lei
+ ATTRIBUTES: Note function that is thread-safe
+ The function mq_unlink() is thread safe.
+
+posix_fallocate.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function posix_fallocate() is thread safe.
+
+posix_openpt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function posix_openpt() is thread safe.
+
+siginterrupt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function siginterrupt() is not thread safe.
+
+system.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function system() is thread safe.
+
+charmap.5
+ Marko Myllynen
+ Update to match current glibc
+ charmap(5) was outdated, bring it to closer to reality by fixing
+ syntax descriptions to match current glibc code and practices,
+ adding missing options, removing obsolete comments and references,
+ and removing now incorrect examples.
+
+locale.5
+ Marko Myllynen
+ Clarify AM/PM settings a bit
+ localedef(1) complains if really undefined, should be empty instead.
+ Also: add some SEE ALSO references.
+ Marko Myllynen
+ Document glibc conventions regarding days and week
+ Based on existing practice and glibc community wiki page at
+ https://sourceware.org/glibc/wiki/Locales
+
+proc.5
+ Michael Kerrisk [Jan Chaloupka, Walter Harms]
+ Add a brief description of /proc/fs
+
+repertoiremap.5
+ Marko Myllynen
+ New page for repertoiremap(5)
+ Rather obsolete feature but localedef(1) refers to repertoiremaps.
+
+bootparam.7
+ Petr Gajdos
+ Describe 'rootflags' and 'rootdelay' kernel parameters
+ Patch based on text from Documentation/kernel-parameters.txt
+
+charsets.7
+ Marko Myllynen
+ Update to reflect past developments
+ Rewrite the introduction to make Unicode's prominence more obvious.
+ Reformulate parts of the text to reflect current Unicode world.
+ Minor clarification for ASCII/ISO sections, some other minor fixes.
+ Marko Myllynen
+ List CJK encodings in the order of C, J, K
+
+environ.7
+ Michael Kerrisk
+ SEE ALSO: add env(1), printenv(1), ld.so(8)
+
+locale.7
+ Marko Myllynen
+ Add some SEE ALSO references
+
+man-pages.7
+ Michael Kerrisk
+ Note that .TH 'date' field is nowadays automatically updated by scripts
+
+signal.7
+ Michael Kerrisk
+ Describe EINTR semantics for recvmmsg(2)
+ Michael Kerrisk
+ Clarify text describing EINTR semantics for socket interfaces
+
+unicode.7
+ Marko Myllynen
+ Update to reflect past developments
+ The unicode(7) page will look more modern with few small changes:
+
+ - drop old BUGS section, editors cope with UTF-8 ok these days,
+ and perhaps the state-of-the-art is better described elsewhere
+ anyway than in a man page
+ - drop old suggestion about avoiding combined characters
+ - refer to LANANA for Linux zone, add registry file reference
+ - drop a reference to an inactive/dead mailing list
+ - update some reference URLs
+
+utf-8.7
+ Marko Myllynen
+ Drop an old comment about UTF-8 replacing ISO 8859
+ And add locale(1) under SEE ALSO.
+
+
+==================== Changes in man-pages-3.70 ====================
+
+Released: 2014-07-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:
+
+Carlos O'Donell <carlos@redhat.com>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Nadav Har'El <nyh@math.technion.ac.il>
+NeilBrown <neilb@suse.de>
+Rich Felker <dalias@libc.org>
+Robert P. J. Day <rpjday@crashcourse.ca>
+Simon Paillard <spaillard@debian.org>
+Tomi Salminen <tlsalmin@gmail.com>
+Walter Harms <wharms@bfs.de>
+Yuri Kozlov <yuray@komyakino.ru>
+Кирилл <kirillnow@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+sprof.1
+ Michael Kerrisk [Marko Myllynen]
+ New page for the glibc sprof(1) command
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+epoll_ctl.2
+ NeilBrown
+ Document EPOLLWAKEUP
+
+epoll.7
+ NeilBrown
+ Document EPOLLWAKEUP
+
+
+Changes to individual pages
+---------------------------
+
+iconv.1
+iconvconfig.8
+ Marko Myllynen
+ Clarify gconv file terminology a bit
+
+ldd.1
+ Michael Kerrisk
+ SEE ALSO: add sprof(1)
+
+connect.2
+ Michael Kerrisk
+ ERRORS: add EPROTOTYPE
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=708394
+
+dup.2
+ Michael Kerrisk [Rich Felker]
+ Fix erroneous discussion regarding closing 'newfd' before calling dup2()
+ And propose a workaround if the caller cares about catching
+ close() time errors.
+
+ See http://stackoverflow.com/questions/23440216/race-condition-when-using-dup2#comment36888604_23444465
+ and http://austingroupbugs.net/view.php?id=411
+ Michael Kerrisk
+ Rework and enhance discussion of dup2()
+ In particular, note that dup2() performs the steps of closing
+ and reusing 'newfd' atomically.
+ Michael Kerrisk
+ Add subhead for dup3()
+
+epoll_ctl.2
+ Michael Kerrisk
+ BUGS: EPOLLWAKEUP is silently ignored without CAP_BLOCK_SUSPEND
+ If the caller does not have CAP_BLOCK_SUSPEND, then EPOLLWAKEUP
+ is silently ignored.
+
+fcntl.2
+ Michael Kerrisk [Tomi Salminen]
+ The return value for F_SETPIPE_SZ is the pipe capacity
+ Michael Kerrisk
+ ERRORS: Document ENOTDIR error for F_NOTIFY
+ Michael Kerrisk
+ Use proper page cross-references in F_NOTIFY discussion
+ Michael Kerrisk
+ Suggest the use of real-time signals with F_NOTIFY
+
+getitimer.2
+ Michael Kerrisk
+ Rewrite a few pieces to clarify some details
+
+inotify_add_watch.2
+ Michael Kerrisk
+ Clarify that the target of a watch is an i-node
+ The target of a watch is an i-node, not a pathname. Clarify
+ the text to prevent the reader possibly misunderstanding
+ that establishing watches by two different links to the same
+ file might create different watch descriptors.
+
+open.2
+ Michael Kerrisk [Кирилл]
+ O_CLOEXEC is also one the flags not ignored when O_PATH is specified
+
+pipe.2
+ Elie De Brauwer
+ PIPE_BUF is defined in limits.h
+ To make use of PIPE_BUF in an application one should include
+ <limits.h>. Adding a reference to this inclusion.
+
+poll.2
+ Michael Kerrisk [Nadav Har'El]
+ The negate-fd-to-ignore technique does not work for file descriptor 0
+ See https://bugzilla.kernel.org/show_bug.cgi?id=79411
+
+set_tid_address.2
+ Michael Kerrisk [Rich Felker]
+ Use "thread" rather than "process" in DESCRIPTION
+ Michael Kerrisk
+ SEE ALSO: add gettid(2)
+
+shmop.2
+ Michael Kerrisk
+ Explain SHMLBA in much more detail
+
+splice.2
+ Michael Kerrisk
+ Document EAGAIN error
+ See https://bugzilla.kernel.org/show_bug.cgi?id=48641
+
+syscalls.2
+ Carlos O'Donell
+ Add prlimit64(2)
+ While trying to reconcile the new features in glibc with the
+ documented entries in the linux kernel man pages I noticed that
+ glibc exports prlimit64 for use by 32-bit applications (as does
+ the linux kernel), but that prlimit64 was not defined in the
+ syscalls list or in the prlimit-related page.
+
+ This is not the complete fix for this, but I don't have the time
+ to explain why and when prlimit64 should be used (or how it should
+ be used safely). Therefore I'm just patching the syscalls.2 list
+ to show that prlimit64 exists and was added in 2.6.36 (verified
+ with git by checking out the tags before and after).
+
+syslog.2
+ Michael Kerrisk
+ Rework introductory paragraph
+ Michael Kerrisk [Robert P. J. Day]
+ Rework text describing loglevels
+ The kernel header file mentioned in the discussion of the KERN_*
+ constants has morphed and is no longer exported inside glibc.
+ And the definitions of the constants themselves changed subtly
+ with kernel commit 04d2c8c83d0e3ac5f78aeede51babb3236200112.
+ So, rewrite the description of the constants to be a bit more
+ abstract.
+ Michael Kerrisk
+ Rewrite parts of the page, and import /proc/sys/kernel/printk
+ * Move /proc/sys/kernel/printk from proc(5) to this page,
+ and correct various details in the discussion of that file.
+ * Rewrite and correct various other details on the page.
+ * Clean out some crufty text.
+ * Miscellaneous minor fixes.
+ Michael Kerrisk
+ Update SYSLOG_ACTION_CONSOLE_OFF + SYSLOG_ACTION_CONSOLE_ON description
+ Details changed in Linux 2.6.32
+
+tee.2
+ Michael Kerrisk
+ Document EAGAIN error
+ See https://bugzilla.kernel.org/show_bug.cgi?id=48641
+
+vmsplice.2
+ Michael Kerrisk
+ Document EAGAIN error
+ See https://bugzilla.kernel.org/show_bug.cgi?id=48641
+
+ether_aton.3
+ Michael Kerrisk
+ Make description of ether_line() bug a little more informative
+
+mallopt.3
+ Michael Kerrisk [Florian Weimer]
+ MALLOC_MMAP_THRESHOLD_ and MALLOC_MMAP_MAX_ *do* work in setgid programs
+ My testing on this point was bogus, overlooking details of
+ strace(1)'s behavior with setuid programs.
+
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=12155
+
+printf.3
+ Michael Kerrisk [Rich Felker]
+ Remove libc4 and libc5 details
+ Rich Felker noted that "scare text" in the man page warned about
+ the use of snprintf() on libc, and that some people had cited
+ this as a reason not to use snprintf(). Linux libc is now
+ ancient history, so there is no real need to keep that text.
+ But, while we're at it, we may as well clear out all of the
+ other ancient libc4 and libc5 pieces in the page. They are
+ nowadays more clutter than help.
+ Michael Kerrisk
+ SUSv3 and later agree with C99 for the snprintf() return value
+ Determined by inspection of the SUSv3 and SUSv4 specifications.
+ Michael Kerrisk
+ Remove some old text about glibc 2.0 changes
+ We probably don't now need such ancient info.
+ Michael Kerrisk
+ Update references to standards for C and S conversion specifiers
+
+profil.3
+ Michael Kerrisk
+ SEE ALSO: add sprof(1)
+
+charmap.5
+ Marko Myllynen
+ Various minor updates and improvements
+ - more precise title
+ - extend description a bit
+ - document previously omitted WIDTH_DEFAULT
+ Marko Myllynen
+ Remove accidental ISO C compliance reference
+ glibc refers in locale/programs/charmap.c to ISO C 99 section
+ 7.17.(2) and ISO C 99 section 5.2.1.(3) that if a character map
+ is not ASCII compatible then the locale using it is not ISO C
+ compliant. This does not state anything about the character set
+ itself.
+
+proc.5
+ Michael Kerrisk
+ Replace /proc/sys/kernel/printk discussion with reference to syslog(2)
+ It makes more sense to have the /proc/sys/kernel/printk with
+ the related material in syslog(2).
+ Michael Kerrisk
+ Rewrite /proc/sys/kernel/printk description
+
+inotify.7
+ Michael Kerrisk
+ Clarify which events are generated for watched directories
+ Really, with respect to watched directories, events fall into
+ three classes (not two, as was shown):
+
+ * Events that can be generated only for the watched directory.
+ * Events that can be generated only for objects that are inside
+ the watched directory.
+ * Events that can be generated both for the watched directory
+ and for objects inside the directory.
+
+ So, mark these three classes more clearly in the list of inotify
+ events.
+ Heinrich Schuchardt [Michael Kerrisk]
+ BUGS: Note possible bug triggered by watch descriptor reuse
+ Watch descriptor IDs are returned by inotify_add_watch().
+ When calling inotify_rm_watch() an IN_IGNORED is placed on the
+ inotify queue pointing to the ID of the removed watch.
+
+ inotify_add_watch() should not return a watch descriptor ID for
+ which events are still on the queue but should return an
+ unused ID.
+
+ Unfortunately, the existing Kernel code does not provide such a
+ guarantee.
+
+ Actually, in rare cases watch descriptor IDs are returned by
+ inotify_add_watch() for which events are still on the inotify
+ queue.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=77111
+ Michael Kerrisk
+ Add further detail to the watch descriptor reuse bug
+ As well as inotify_rm_watch(), file deletion and unmounting a
+ filesystem can also cause a watch descriptor to be deleted.
+ Michael Kerrisk
+ The watch descriptor reuse bug may be hard to hit in practice
+ Explain the circumstances in detail, indicating that the
+ bug may be very unlikely to occur in practice.
+ Michael Kerrisk
+ Clarify description of IN_EXCL_UNLINK
+ Clarify the text a little, in particular making it clearer
+ that the target of a watch is an i-node (not a pathname).
+ Michael Kerrisk
+ Clarify IN_ONESHOT explanation
+ Make it clearer that the target of monitoring is an i-node,
+ not a pathname.
+ Michael Kerrisk
+ Make comment on 'mask' field more accurate
+
+libc.7
+ Michael Kerrisk
+ Clarify man-pages policy on documenting C libraries other tahn glibc
+ Michael Kerrisk
+ Use absolute dates in discussion of libc vs glibc
+
+pipe.7
+ Elie De Brauwer
+ Add reference that the pipe capacity can be changed
+ In fcntl(2) F_SETPIPE_SZ, F_GETPIPE_SZ and
+ /proc/sys/fs/pipe-max-size are defined, however
+ pipe(7) still defines the pipe capacity as being
+ a static entity. Adding a reference to fcntl(2).
+ Michael Kerrisk [Walter Harms]
+ Clarify that since 2.6.35, 65535 bytes is the default pipe capacity
+
+ld.so.8
+ Michael Kerrisk
+ Clarify that LD_PROFILE can specify just a single shared object
+ Michael Kerrisk
+ Clarify that LD_PROFILE output is appended to target file
+ The LD_PROFILE output is appended to any existing
+ contents of the target file.
+ Michael Kerrisk
+ SEE ALSO: add sprof(1)
+
+
+==================== Changes in man-pages-3.71 ====================
+
+Released: 2014-08-17, Chicago
+
+
+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>
+Damir Nedzibovic <d.nedzibovic@anoxtech.com>
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Jakub Wilk <jwilk@debian.org>
+Jan Chaloupka <jchaloup@redhat.com>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+NeilBrown <neilb@suse.de>
+Paul Jackson <pj@usa.net>
+Peng Haitao <penght@cn.fujitsu.com>
+Rahul Bedarkar <rahulbedarkar89@gmail.com>
+Rob Landley <rob@landley.net>
+Ryan Hammonds <rhammonds@unicoi.com>
+Simon Paillard <spaillard@debian.org>
+Ville Ylenius <ville@ylenius.net>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+group_member.3
+ Michael Kerrisk
+ New page documenting group_member(3)
+
+isfdtype.3
+ Michael Kerrisk
+ New page documenting isfdtype(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+perf_event_open.2
+ Vince Weaver
+ Document new comm_exec flag
+ Linux 3.16 (more specifically, commit 82b897782d10fcc4 )
+ added support for differentiating between process renames
+ caused by exec versus those caused by other methods.
+ Vince Weaver
+ Document new mmap2 record type
+ Linux 3.16 (more specifically, commit a5a5ba72843dd05f9 )
+ enabled the enhanced mmap2 record support.
+ The interface was added in Linux 3.12 but disabled until
+ Linux 3.16.
+ Vince Weaver
+ Document PERF_SAMPLE_BRANCH_COND
+ Linux 3.16 (more specifically, commit bac52139f0b7ab31330 )
+ adds support for gathering PERF_SAMPLE_BRANCH_COND
+ conditional branch values when doing PERF_SAMPLE_BRANCH_STACK
+ sampling.
+
+proc.5
+ Michael Kerrisk
+ Document /proc/PID/comm
+ Michael Kerrisk
+ Document /proc/PID/pagemap
+ Michael Kerrisk
+ Document /proc/PID/personality
+ Michael Kerrisk
+ Document /proc/PID/syscall
+ Michael Kerrisk
+ Document /proc/kpagecount
+ Michael Kerrisk
+ Document /proc/kpageflags
+ Michael Kerrisk
+ Document /proc/sys/vm/overcommit_kbytes
+
+capabilities.7
+ Michael Kerrisk
+ Add CAP_AUDIT_READ
+ CAP_AUDIT_READ is new in Linux 3.16.
+
+
+Global changes
+--------------
+
+ldd.1
+clone.2
+execve.2
+getpagesize.2
+ioperm.2
+msgop.2
+readv.2
+recv.2
+select.2
+send.2
+seteuid.2
+shmop.2
+signal.2
+sync.2
+sysinfo.2
+utime.2
+abs.3
+atoi.3
+catopen.3
+clearenv.3
+ctime.3
+des_crypt.3
+ecvt.3
+flockfile.3
+fseeko.3
+ftime.3
+ftok.3
+ftw.3
+getcwd.3
+getdtablesize.3
+getline.3
+getpass.3
+getpass.3
+getutent.3
+glob.3
+insque.3
+lseek64.3
+memmem.3
+mkstemp.3
+mktemp.3
+on_exit.3
+openpty.3
+putenv.3
+putenv.3
+qecvt.3
+realpath.3
+realpath.3
+remove.3
+setbuf.3
+sigpause.3
+strftime.3
+strptime.3
+tzset.3
+xcrypt.3
+utmp.5
+environ.7
+ipv6.7
+packet.7
+ Michael Kerrisk
+ Remove ancient Linux libc details
+
+access.2
+brk.2
+chmod.2
+eventfd.2
+gethostname.2
+getpriority.2
+mmap.2
+poll.2
+ptrace.2
+readv.2
+sched_setaffinity.2
+select.2
+seteuid.2
+signalfd.2
+sync_file_range.2
+timer_create.2
+uname.2
+wait.2
+ Michael Kerrisk
+ NOTES: add "C library/kernel ABI differences" subheading
+
+
+Changes to individual pages
+---------------------------
+
+access.2
+ Michael Kerrisk
+ Glibc falls back to using access() on kernels that lack faccessat()
+
+bdflush.2
+fsync.2
+sync.2
+proc.5
+ Adrian Bunk
+ Change "sync(1)" to "sync(8)"
+
+bind.2
+ Michael Kerrisk [Ryan Hammonds]
+ Correct EINVAL error description
+ As pointed out by Ryan:
+
+ My application is trying to bind an IPv4 UDP socket to an
+ address. I've found that passing an invalid address length
+ to bind() causes bind to return EINVAL. According to the
+ bind(2) manpage, this should only occur when using unix
+ domain sockets (which I am not).
+
+chmod.2
+ Michael Kerrisk
+ Glibc falls back to chmod() on kernels that don't support fchmodat()
+ Michael Kerrisk
+ Glibc falls back to chown()/lchown() on kernels that lack fchownat()
+
+epoll_wait.2
+ Michael Kerrisk
+ NOTES: describe raw epoll_pwait() system call differences
+
+getgroups.2
+ Michael Kerrisk
+ SEE ALSO: add group_member(3)
+
+getpriority.2
+ Michael Kerrisk
+ Enhance discussion of kernel nice range versus user-space nice range
+ Michael Kerrisk
+ Move text describing nice range on other systems
+
+getrlimit.2
+ Michael Kerrisk
+ Add cross reference to core(5) in discussion of RLIMIT_CORE
+ Michael Kerrisk
+ Describe the "large" resource limit bug on 32-bit platforms
+ See https://bugzilla.kernel.org/show_bug.cgi?id=5042.
+ Michael Kerrisk
+ Glibc's setrlimit() and getrlimit() are implemented using prlimit()
+
+kexec_load.2
+ Michael Kerrisk
+ Note limit of 16 for 'nr_segments'
+ Michael Kerrisk
+ Clarify the 'flags' bits that contain the architecture
+ Michael Kerrisk
+ Add KEXEC_ARCH_68K to list of architectures for 'flags'
+ Michael Kerrisk
+ Reword description of 'flags' a little
+
+link.2
+ Michael Kerrisk
+ Glibc falls back to link() on kernels that lack linkat()
+ Unless 'flags' contains AT_SYMLINK_FOLLOW.
+
+mkdir.2
+ Michael Kerrisk
+ Glibc falls back to mkdir() on kernels that don't support mkdirat()
+
+perf_event_open.2
+ Vince Weaver
+ Clarify PERF_SAMPLE_STACK_USER usage
+ This clarifies the PERF_SAMPLE_STACK_USER section.
+ I found these issue while implementing some code that uses
+ the option. The important change is fixing the name of the
+ sample_stack_user parameter, the rest is just some wording
+ fixes and minor clarifications.
+ Vince Weaver
+ Clarify PERF_SAMPLE_DATA_SRC usage
+ When checking the fields in the PERF_SAMPLE_DATA_SRC type samples
+ you need to shift the masks before doing the compare.
+
+ Although the value you are checking (perf_mem_data_src) is
+ specified as a bitfield so this might all fall apart if trying
+ to access the field in a cross-endian way. The Power people
+ were working on this issue, not sure if they resolved it.
+
+poll.2
+ Michael Kerrisk
+ Describe fifth argument (sigsetsize) of raw ppoll() system call
+
+process_vm_readv.2
+ Michael Kerrisk [Ville Ylenius]
+ Fix typo in example program
+
+readlink.2
+ Michael Kerrisk
+ Glibc falls back to readlink() on kernels that lack readlinkat()
+
+recv.2
+ Michael Kerrisk
+ 'addrlen' should be NULL (not 0) if we don't need sender address
+
+rename.2
+ Michael Kerrisk
+ Glibc falls back to rename() when the kernel doesn't have renameat()
+
+sigwaitinfo.2
+ Michael Kerrisk
+ The raw sigtimedwait() system call has a fifth argument
+
+symlink.2
+ Michael Kerrisk
+ Glibc falls back to symlink() on kernels that lack symlinkat()
+
+sysinfo.2
+ Michael Kerrisk
+ Add VERSIONS section
+
+unlink.2
+ Michael Kerrisk
+ Glibc falls back to unlink() or rmdir() on kernels that lack unlinkat()
+
+atoi.3
+ Michael Kerrisk
+ Downgrade discussion of atoq()
+ Remove most references to atoq() in this page, since this function
+ was present only in Linux libc (not glibc).
+
+cerf.3
+cexp2.3
+clog2.3
+ Michael Kerrisk
+ Update version number on "Not yet in glibc" sentence
+
+fgetgrent.3
+getgrent.3
+getgrent_r.3
+getgrnam.3
+ Michael Kerrisk [Rob Landley]
+ Clarify that 'gr_mem' is a NULL-terminated array of pointers
+
+fseeko.3
+ Michael Kerrisk
+ Add VERSIONS section
+
+ftw.3
+ Michael Kerrisk
+ Add VERSIONS section
+
+getauxval.3
+ Michael Kerrisk
+ Document ENOENT error
+ And add an entry to BUGS explaining the ambiguity that was
+ present before the addition of this error.
+
+getgrouplist.3
+ Michael Kerrisk
+ SEE ALSO: add group_member(3)
+
+getline.3
+ Rahul Bedarkar
+ Close opened file at end of example program
+
+memmem.3
+ Michael Kerrisk
+ Rewrite text of glibc 2.0 bug
+
+printf.3
+ Michael Kerrisk [Jakub Wilk]
+ Clarify details of the %n conversion specifier
+ See http://bugs.debian.org/756602
+ Michael Kerrisk [Jakub Wilk]
+ Note use of 'j', 'z', and 't' length modifiers for '%n'
+ See http://bugs.debian.org/756602
+ Michael Kerrisk
+ Update with some SUSv3 details
+
+setbuf.3
+ Michael Kerrisk
+ Remove ancient Linux libc and 4.x BSD details
+
+strstr.3
+ Michael Kerrisk
+ Remove discussion of Linux libc bugs
+ Linux libc is old enough that we needn't care any longer.
+
+strtod.3
+ Michael Kerrisk
+ Explain NAN(n-char-sequence)
+
+strtod.3
+ Michael Kerrisk
+ SEE ALSO: add nan(3), nanf(3), NANL(3)
+
+updwtmp.3
+ Michael Kerrisk
+ Replace AVAILABILITY section with note to link logwtmp() using -lutil
+ Linux libc details are no longer needed these days.
+
+core.5
+ Rahul Bedarkar
+ Close opened file in example program
+
+proc.5
+ Michael Kerrisk
+ Fix kernel version numbers for /proc/PID/stat fields
+
+proc.5
+ Jan Chaloupka
+ Add missing proc stats fields
+ Adding missing proc stats fields from
+ https://www.kernel.org/doc/Documentation/filesystems/proc.txt
+ Michael Kerrisk [Simon Paillard]
+ Remove crufty text under 'timer_stats'
+ Michael Kerrisk
+ Update /proc/PID/stat 'state' field documentation
+ Michael Kerrisk
+ Improve description of /proc/PID/stat fields added in Linux 3.3 and 3.5
+ Michael Kerrisk
+ Refer to getauxval(3) in discussion of /proc/PID/auxv
+ Michael Kerrisk
+ Rework formatting of /proc/PID/stat list
+ Make the field numbers more prominent.
+ Michael Kerrisk
+ Note that /proc/PID/cmdline is read-only
+ Michael Kerrisk
+ Rework discussion of CommitLimit and /proc/sys/vm/overcommit_memory
+ Michael Kerrisk
+ Improve discussion of /proc/sys/vm/overcommit_ratio
+
+charsets.7
+ David Prévot [Marko Myllynen]
+ Tidy up list
+ Remove German from main list, to be consistent with earlier
+ removal of Dutch and French (in commit a8ed5f7430e0d1).
+
+inotify.7
+ Michael Kerrisk
+ Note that IN_ONLY_DIR can be used to avoid races
+ Michael Kerrisk
+ Note that insertion of IN_MOVED_FROM+IN_MOVED_TO pair is not atomic
+ Michael Kerrisk
+ Mention use of timeout when reading IN_MOVED_TO after IN_MOVED_FROM
+
+man-pages.7
+ Michael Kerrisk
+ Add description of "C library/kernel ABI differences" subsection
+ Michael Kerrisk
+ Rework text describing sections (stylistic improvements)
+
+vdso.7
+ Mike Frysinger
+ Add new i386 vdso symbols in Linux 3.15
+ Michael Kerrisk
+ Note kernel version that exports new i386 symbols (Linux 3.15)
+
+
+==================== Changes in man-pages-3.72 ====================
+
+Released: 2014-09-07, Mountain View
+
+
+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:
+
+Christian von Roques <roques@mti.ag>
+Holger Hans Peter Freyther <holger@moiji-mobile.com>
+Michael Haardt <michael@moria.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peter Schiffer <pschiffe@redhat.com>
+Rusty Russell <rusty@rustcorp.com.au>
+Sorin Dumitru <sdumitru@ixiacom.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+memusage.1
+ Peter Schiffer, Michael Kerrisk [Jan Chaloupka]
+ New page for glibc memusage(1) command
+
+memusagestat.1
+ Peter Schiffer [Jan Chaloupka, Michael Kerrisk]
+ New page for glibc memusagestat(1) command
+
+mtrace.1
+ Peter Schiffer [Jan Chaloupka]
+ New page describing the glibc mtrace(1) command
+
+
+Changes to individual pages
+---------------------------
+
+connect.2
+ Michael Haardt
+ Note that a new socket should be used if connect() fails
+
+fcntl.2
+ Michael Kerrisk
+ One must define _GNU_SOURCE to get the F_OFD_* definitions
+
+poll.2, select.2
+ Rusty Russell
+ Fix erroneous description of "available for write".
+ POSIX says: "POLLOUT Normal data may be written without
+ blocking.". This "may" is misleading, see the POSIX
+ write page:
+
+ Write requests to a pipe or FIFO shall be handled in the
+ same way as a regular file with the following exceptions:
+ ...
+ If the O_NONBLOCK flag is clear, a write request may cause
+ the thread to block, but on normal completion it shall
+ return nbyte.
+ ...
+ When attempting to write to a file descriptor (other than a
+ pipe or FIFO) that supports non-blocking writes and cannot
+ accept the data immediately:
+
+ If the O_NONBLOCK flag is clear, write() shall block the
+ calling thread until the data can be accepted.
+
+ If the O_NONBLOCK flag is set, write() shall not block the
+ thread. If some data can be written without blocking the
+ thread, write() shall write what it can and return the
+ number of bytes written. Otherwise, it shall return -1 and
+ set errno to [EAGAIN].
+
+ The net result is that write() of more than 1 byte on a
+ socket, pipe or FIFO which is "ready" may block: write()
+ (unlike read!) will attempt to write the entire buffer and
+ only return a short write under exceptional circumstances.
+
+ Indeed, this is the behaviour we see in Linux:
+
+ https://github.com/rustyrussell/ccan/commit/897626152d12d7fd13a8feb36989eb5c8c1f3485
+ https://plus.google.com/103188246877163594460/posts/BkTGTMHDFgZ
+
+errno.3
+ Michael Kerrisk
+ SEE ALSO: add errno(1)
+
+rtnetlink.3
+ Holger Hans Peter Freyther
+ Fix parameters for the send() call in the example
+
+inotify.7
+ Michael Kerrisk
+ IN_OPEN and IN_CLOSE_NOWRITE can also occur for directories
+ Michael Kerrisk
+ IN_CLOSE_WRITE occurs only for files (not monitored directory)
+ Michael Kerrisk
+ IN_MODIFY is generated for files only (not monitored directories)
+ Michael Kerrisk
+ IN_ACCESS occurs only for files inside directories
+ IN_ACCESS does not occur for monitored directory.
+
+packet.7
+ Sorin Dumitru
+ Fix include file
+ It looks like most of the socket options from this man pages
+ are not defined in <netpacket/packet.h>. They are defined in
+ <linux/if_packet.h> so we should include that one.
+
+
+==================== Changes in man-pages-3.73 ====================
+
+Released: 2014-09-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:
+
+David Prévot <taffit@debian.org>
+Eric W. Biederman <ebiederm@xmission.com>
+J. Bruce Fields <bfields@fieldses.org>
+Justin Cormack <justin@street-vision.com>
+Lorenzo Beretta <lory.fulgi@infinito.it>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Rob Landley <rob@landley.net>
+Serge E. Hallyn <serge@hallyn.com>
+Serge Hallyn <serge.hallyn@ubuntu.com>
+Vasily Kulikov <segoon@openwall.com>
+Vincent Lefevre <vincent@vinc17.net>
+Vitaly Rybnikov <frodox@zoho.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+namespaces.7
+ Michael Kerrisk [Eric W. Biederman]
+ New page providing overview of Linux namespaces
+
+pid_namespaces.7
+ Michael Kerrisk [Eric W. Biederman, Vasily Kulikov, Rob Landley,
+ Serge Hallyn]
+ New page describing PID namespaces
+
+user_namespaces.7
+ Michael Kerrisk [Eric W. Biederman, Andy Lutomirski, Serge Hallyn]
+ New page describing user namespaces.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Eric W. Biederman [Michael Kerrisk]
+ Document CLONE_NEWUSER for creating a new user namespace
+
+setns.2
+ Eric W. Biederman, Michael Kerrisk
+ Document the PID, user, and mount namespace support
+ Document CLONE_NEWPID, CLONE_NEWUSER, and CLONE_NEWNS flags.
+
+unshare.2
+ Michael Kerrisk [Eric W. Biederman]
+ Document CLONE_NEWPID
+ Michael Kerrisk [Eric W. Biederman]
+ Document CLONE_NEWUSER
+ Michael Kerrisk
+ Document CLONE_THREAD, CLONE_SIGHAND, and CLONE_VM
+
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Move some CLONE_NEWNET text to namespaces.7
+ Michael Kerrisk
+ Move some CLONE_NEWUTS text 2 to namespaces.7
+ Michael Kerrisk
+ Move some CLONE_NEWIPC text to namespaces.7
+ Michael Kerrisk
+ Reword discussion of CLONE_NEWNS, removing text also in namespaces(7)
+ Michael Kerrisk
+ Standardize text on CLONE_NEW* flags and CAP_SYS_ADMIN
+ Michael Kerrisk
+ EINVAL if (CLONE_NEWUSER|CLONE_NEWPID) && (CLONE_THREAD|CLONE_PARENT)
+ Michael Kerrisk
+ Add more detail on the meaning of CLONE_SYSVSEM
+
+flock.2
+ Michael Kerrisk [J. Bruce Fields]
+ Don't mention "classical BSD" in discussion of fcntl()/flock interaction
+ The noninteraction of flock(2) and fcntl(2) locks does
+ not seem to be classical BSD semantics (at least, checking
+ the 4.4BSD sources suggest that the lock types do interact,
+ although there have been other systems also where fcntl()
+ and flock() locks do not interact). So, fix the text
+ discussing "classical BSD" lock semantics.
+
+getunwind.2
+ Michael Kerrisk [Yuri Kozlov]
+ Fix description of return value
+ s/size of unwind table/size of the unwind data/
+
+mount.2
+ Eric W. Biederman
+ Clarify use of 'mountflags' and 'data' for MS_REMOUNT
+
+reboot.2
+ Michael Kerrisk [Justin Cormack, Eric W. Biederman]
+ Document effect of reboot() inside PID namespaces
+
+semop.2
+ Michael Kerrisk
+ Refer to clone(2) for semantics of CLONE_SYSVSEM and semadj lists
+
+seteuid.2
+setgid.2
+setresuid.2
+setreuid.2
+setuid.2
+ Michael Kerrisk
+ EINVAL can occur if UID/GID is not valid in caller's user namespace
+
+setns.2
+ Michael Kerrisk [Eric W. Biederman]
+ Clarify capabilities required for reassociating with a mount namespace
+ Michael Kerrisk
+ Specify kernel version on each CLONE_NEW* flag
+ And remove text on flags from VERSIONS.
+
+unshare.2
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk
+ Clarify semantics of CLONE_SYSVSEM
+ Michael Kerrisk
+ CLONE_SYSVSEM does not require CAP_SYS_ADMIN
+ Michael Kerrisk
+ Note flags implied by CLONE_THREAD and CLONE_VM
+
+clock.3
+ Michael Kerrisk [Vincent Lefevre]
+ The implementation uses clock_gettime() was to improve *accuracy*
+ (The man page text mistakenly used the word "precision".)
+
+drand48.3
+ Michael Kerrisk [Lorenzo Beretta]
+ Remove crufty text about SVID 3 marking drand48() obsolete
+ See http://bugs.debian.org/758293
+
+proc.5
+ Michael Kerrisk
+ Move /proc/[pid]/mounts text to namespaces.7
+ Michael Kerrisk
+ Move /proc/[pid]/mountstats text to namespaces.7
+
+capabilities.7
+ Michael Kerrisk
+ Refer reader to user_namespaces(7) for a discussion of capabilities
+ Michael Kerrisk
+ Document CAP_SETUID and CAP_SETGID for user namespace mappings
+ Michael Kerrisk
+ setns() needs CAP_SYS_ADMIN in the *target* namespace
+ Michael Kerrisk
+ Since Linux 3.8, user namespaces no longer require CAP_SYS_ADMIN
+
+mq_overview.7
+ Michael Kerrisk
+ Refer to namespaces(7) for info on POSIX MQs and IPC namespaces
+
+svipc.7
+ Michael Kerrisk
+ Refer to namespaces(7) for info on System V IPC and IPC namespaces
+
+
+==================== Changes in man-pages-3.74 ====================
+
+Released: 2014-10-03, 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:
+
+Arto Bendiken <arto@bendiken.net>
+Ben Hutchings <ben@decadent.org.uk>
+Benjamin Herr <ben@0x539.de>
+C. Alex North-Keys <erlkonig@talisman.org>
+Carlos O'Donell <carlos@redhat.com>
+Cyril Hrubis <chrubis@suse.cz>
+Davidlohr Bueso <dave@stgolabs.net>
+Doug Ledford <dledford@redhat.com>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Jonny Grant <jg@jguk.org>
+Lanchon <lanchon@gmail.com>
+Manfred Spraul <manfred@colorfullife.com>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Shriramana Sharma <samjnaa@gmail.com>
+Thomas Mack <mack@ifis.cs.tu-bs.de>
+Wieland Hoffmann <themineo@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pldd.1
+ Michael Kerrisk
+ New page for pldd(1) command added to glibc in version 2.15
+
+cp1252.7
+ Marko Myllynen
+ New page documenting CP 1252
+ CP 1252 is probably one of the most used Windows Code Pages so
+ let's add a page for it alongside with the already provided
+ CP 1251 page.
+
+ Table generated from /usr/share/i18n/charmaps/CP1252.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+mq_overview.7
+ Michael Kerrisk
+ Document /proc/sys/fs/mqueue/msgsize_default
+ Michael Kerrisk
+ Document /proc/sys/fs/mqueue/msg_default
+
+
+Changes to individual pages
+---------------------------
+
+ldd.1
+ Michael Kerrisk
+ SEE ALSO: add pldd(1)
+
+execve.2
+ Michael Kerrisk [C. Alex North-Keys]
+ Remove unneeded ".sh" extension in interpreter script example
+ See https://bugzilla.kernel.org/show_bug.cgi?id=84701
+
+fanotify_init.2
+ Heinrich Schuchardt
+ BUGS: O_CLOEXEC is ignored
+ Michael Kerrisk [Heinrich Schuchardt]
+ The 'event_f_flags' failure to check invalid flags was fixed in 3.15
+
+fanotify_mark.2
+ Michael Kerrisk
+ Note that various bugs were fixed in Linux 3.16
+
+getrlimit.2
+ Michael Kerrisk [Doug Ledford]
+ Since Linux 3.5, the accounting formula for RLIMIT_MSGQUEUE has changed
+
+open.2
+ Michael Kerrisk [Shriramana Sharma]
+ Fix number and formula in description of EOVERFLOW error
+
+readlink.2
+ Michael Kerrisk [Ben Hutchings]
+ Fix description of readlinkat() with empty 'pathname'
+ Michael Kerrisk
+ SEE ALSO: add realpath(3)
+
+sched_setattr.2
+sched_setscheduler.2
+ Michael Kerrisk
+ SEE ALSO: add chrt(1)
+
+shmget.2
+ Manfred Spraul [Michael Kerrisk, Davidlohr Bueso]
+ Update for increase of SHMALL and SHMMAX
+ The default values of SHMALL and SHMMAX have been increased.
+
+syscalls.2
+ Michael Kerrisk
+ Add 3 new system calls added in Linux 3.17
+
+vmsplice.2
+ Cyril Hrubis
+ vmsplice() does not fail when nr_segs==0
+ This nr_segs==0 case is no-op; the call succeeds and no
+ EINVAL error is returned.
+
+dlopen.3
+ Michael Kerrisk
+ SEE ALSO: add pldd(1)
+
+fseeko.3
+ Michael Kerrisk [Thomas Mack]
+ _FILE_OFFSET_BITS must be defined before including any header file
+
+getgrent.3
+ Carlos O'Donell
+ Add ENOENT and EAGAIN to error list
+
+mq_getattr.3
+ Michael Kerrisk
+ Add an example program
+ The example program can be used to discover the default
+ 'mq_maxmsg' and 'mq_msgsize' values used to create a queue with
+ a mq_open(3) call in which 'attr' is NULL.
+
+mq_open.3
+ Michael Kerrisk
+ Two /proc files control the defaults for the attrp==NULL case
+ Refer the reader to the discussion in mq_overview(7) for a
+ discussion of these files, which exist since Linux 3.5.
+
+realpath.3
+ Michael Kerrisk
+ SEE ALSO: add realpath(1)
+
+proc.5
+ Elie De Brauwer
+ Document /proc/buddyinfo
+ This patch adds a short description about the contents of
+ /proc/buddyinfo and how this file can be used to assist
+ in checking for memory fragmentation issues.
+ Michael Kerrisk
+ Mention pmap(1) in discussion of /proc/PID/smaps
+
+armscii-8.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+ascii.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+ This and [the related *.7] patches will provide unification of
+ charset pages, minor cleanups, and some unifying cosmetic
+ changes. References are adjusted so that all pages include
+ a reference to charsets(7), which contains a description of
+ these sets, stray comments are removed, some obsolete
+ statements (like ISO 8859-1 being the de-facto ASCII
+ replacement) are removed, and some minor reformatting
+ to minimize diff's between the pages are done.
+
+ The actual substance, the character tables, remain unchanged.
+
+ This series changes the following pages (under man7): ascii,
+ armscii, cp1251, koi8-r, koi8-u, and all of iso_8859-*.
+
+cp1251.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-10.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-11.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-13.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-14.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-15.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-16.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-1.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-2.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-3.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-4.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-5.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-6.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-7.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-8.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-9.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+koi8-r.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+ - remove stray comments, streamline description
+ (charsets(7) and Wikipedia provide more detailed
+ and up-to-date description)
+ - list differences between koi8-r.7 vs koi8-u.7
+
+koi8-u.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+ - remove stray comments, streamline description
+ (charsets(7) and Wikipedia provide more detailed
+ and up-to-date description)
+ - list differences between koi8-r.7 vs koi8-u.7
+
+mq_overview.7
+ Michael Kerrisk
+ Update queues_max details for Linux 3.14
+ And in general rework the text a little.
+ Michael Kerrisk
+ Update discussion of HARD_MSGMAX
+ The limit has changed in 2.6.33 and then again in 3.5.
+ Michael Kerrisk [Arto Bendiken]
+ Update details for 'queues_max' limit
+ Things changed in Linux 3.5.
+ See https://bugs.launchpad.net/bugs/1155695
+ Michael Kerrisk
+ Update details on defaults and ceiling for 'msgsize_max' limit
+ Michael Kerrisk
+ Rework discussion of HARD_MSGMAX
+ Michael Kerrisk [Davidlohr Bueso]
+ Various fixes after review from Davidlohr Bueso
+
+sched.7
+ Michael Kerrisk
+ SEE ALSO: add taskset(1)
+
+ld.so.8
+ Michael Kerrisk
+ SEE ALSO: add pldd(1)
+ Michael Kerrisk
+ SEE ALSO: add dlopen(3)
+ Michael Kerrisk
+ SEE ALSO: add ld(1)
+
+
+
+==================== Changes in man-pages-3.75 ====================
+
+Released: 2014-10-15, Düsseldorf
+
+
+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:
+
+Jonny Grant <jg@jguk.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Robert Schweikert <rjschwei@suse.com>
+Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
+Walter Harms <wharms@bfs.de>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pthread_rwlockattr_setkind_np.3
+ Robert Schweikert [Michael Kerrisk]
+ New page documenting pthread_rwlockattr_[sg]etkind_np(3)
+ Documents pthread_rwlockattr_setkind_np(3) and
+ pthread_rwlockattr_getkind_np(3).
+
+
+New and changed links
+---------------------
+
+pthread_rwlockattr_getkind_np.3
+ Robert Schweikert
+ New link to pthread_rwlockattr_setkind_np(3)
+
+
+Changes to individual pages
+---------------------------
+
+readlink.2
+ Michael Kerrisk [Jonny Grant]
+ Add free() call to example program
+
+readv.2
+ Michael Kerrisk
+ The raw preadv() and pwritev() syscalls split 'offset' into 2 arguments
+
+signal.7
+ Michael Kerrisk
+ pthread_mutex_lock() and pthread_cond_wait() are restartable
+ pthread_mutex_lock(, pthread_cond_wait(), and related APIs are
+ automatically restarted if interrupted by a signal handler.
+
+unix.7
+ Michael Kerrisk [Carlos O'Donell, David Miller, Tetsuo Handa]
+ Various additions and rewordings
+ Notable changes:
+ * Clarify some details for pathname sockets.
+ * Add some advice on portably coding with pathname sockets.
+ * Note the "buggy" behavior for pathname sockets when
+ the supplied pathname is 108 bytes (after a report by
+ Tetsuo Handa).
+
+
+==================== Changes in man-pages-3.76 ====================
+
+Released: 2014-12-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:
+
+Adam Jiang <jiang.adam@gmail.com>
+Andrea Balboni <andrea.balboni@unimore.it>
+Andreas Schwab <schwab@suse.de>
+Bernhard Walle <bernhard@bwalle.de>
+Carlos O'Donell <carlos@redhat.com>
+David Wragg <david@wragg.org>
+Florian Westphal <fw@strlen.de>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Huxiaoxiang <huxiaoxiang@huawei.com>
+Jan Chaloupka <jchaloup@redhat.com>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Josh Triplett <josh@joshtriplett.org>
+Kamezawa Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
+Laurent Georget <laurent.georget@supelec.fr>
+Manuel López-Ibáñez <lopezibanez@gmail.com>
+Marko Myllynen <myllynen@redhat.com>
+Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
+Mel Gorman <mgorman@suse.de>
+Michael Gehring <mg@ebfe.org>
+Michael Haardt <michael@moria.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Richard Weinberger <richard@nod.at>
+Rich Felker <dalias@libc.org>
+Scott Harvey <scott.harvey@stonybrook.edu>
+Siddhesh Poyarekar <siddhesh.poyarekar@gmail.com>
+Simon Newton <nomis52@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Sven Hoexter <sven@stormbind.net>
+Tobias Werth <werth@cs.fau.de>
+Weijie Yang <weijie.yang.kh@gmail.com>
+Will Newton <will.newton@linaro.org>
+Yuri Kozlov <yuray@komyakino.ru>
+刘湃 <liupai_work@163.com>
+尹杰 <writalnaie@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+adjtimex.2
+ Laurent Georget
+ Add fields in struct timex description
+ This patch updates the man page with the new fields added in
+ struct timex since last edition of the man page.
+ Laurent Georget [Michael Kerrisk]
+ Document ADJ_TAI
+ Michael Kerrisk
+ Improve description of ADJ_OFFSET_SINGLESHOT
+ Michael Kerrisk
+ Add brief documentation of ADJ_MICRO and ADJ_NANO
+ Michael Kerrisk
+ Reformat return value list
+ And remove numeric values, since they're not needed
+ Michael Kerrisk
+ Other 'modes' bits are ignored on ADJ_OFFSET_*
+ Other bits in 'modes' are ignored if modes contains
+ ADJ_OFFSET_SINGLESHOT or ADJ_OFFSET_SS_READ.
+ Michael Kerrisk
+ Add nanosecond details
+ Fixes https://bugzilla.kernel.org/show_bug.cgi?id=61171.
+ Michael Kerrisk
+ Document ADJ_OFFSET_SS_READ
+ Michael Kerrisk
+ Reformat 'times' flags as list
+ And remove numeric values, since they're not needed.
+ Michael Kerrisk
+ Note effect of ADJ_NANO for ADJ_SETOFFSET
+ Michael Kerrisk
+ Add comment noting that timex structure contains padding bytes
+ Michael Kerrisk
+ Add more details to description of 'tai' field
+ Michael Kerrisk
+ Note meaning of "PLL" abbreviation
+ Michael Kerrisk
+ Clarify which 'timex' field is used by each 'modes' bit
+ Michael Kerrisk
+ Document timex 'status' bits
+ Michael Kerrisk
+ Clarify treatment of other 'modes' bits for ADJ_OFFSET_*
+ Michael Kerrisk
+ Update RFC number: RFC 5905 obsoletes RFC 1305
+ Michael Kerrisk
+ Briefly document ADJ_SETOFFSET
+ Michael Kerrisk
+ Note PPS (pulse per second) fields in timex structure
+
+sigreturn.2
+ Michael Kerrisk
+ Add (a lot) more detail on the signal trampoline
+ And rewrite much of the page.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+proc.5
+ Bernhard Walle
+ Document /proc/thread-self
+ /proc/thread-self has been introduced in Linux 3.17 with
+ commit 0097875bd41528922fb3bb5f348c53f17e00e2fd.
+ Sven Hoexter [Michael Kerrisk, Kamezawa Hiroyuki]
+ Document "VmSwap" field of /proc/[pid]/status
+ Florian Westphal
+ Document /proc/net/netfilter/nfnetlink_queue
+
+
+Changes to individual pages
+---------------------------
+
+localedef.1
+ Marko Myllynen
+ Mention default path for compiled files
+
+clock_nanosleep.2
+ Michael Kerrisk
+ Note that 'clock_id' can also be a CPU clock ID
+
+epoll_ctl.2
+ Michael Kerrisk
+ Regular files and directories can't be monitored with epoll_ctl()
+
+ioctl.2
+ Heinrich Schuchardt
+ Rename 'd' argument to 'fd' in text
+ In most other manpages file descriptors are called 'fd'.
+ This patches renames attribute 'd' to 'fd'.
+
+madvise.2
+ Michael Kerrisk
+ VERSIONS: Support for madvise() is now configurable
+ Support for this system call now depends on the
+ CONFIG_ADVISE_SYSCALLS configuration option.
+
+open.2
+ Michael Kerrisk
+ Enhance rationale discussion for openat() and friends
+
+posix_fadvise.2
+ Mel Gorman
+ Document the behavior of partial page discard requests
+ It is not obvious from the interface that "partial page discard"
+ requests are ignored. It should be spelled out.
+ Michael Kerrisk [Weijie Yang]
+ ERRORS: Since 2.6.16, the kernel correctly deals with the ESPIPE case
+ Michael Kerrisk
+ Support for fadvise64() is now configurable
+ Support for this system call now depends on the
+ CONFIG_ADVISE_SYSCALLS configuration option.
+
+prctl.2
+ Andreas Schwab
+ Correct description of null-termination in PR_GET_NAME and PR_SET_NAME
+ The size of the process name has always been at most 16 byte
+ _including_ the null terminator. This also means that the
+ name returned by PR_GET_NAME is always null-terminated.
+ Michael Kerrisk
+ PR_SET_NAME silently truncates strings that exceed 16 bytes
+
+restart_syscall.2
+ Michael Kerrisk
+ Add some text explaining why restart_syscall() exists
+
+sched_setaffinity.2
+ Michael Kerrisk
+ NOTES: Add paragraph on how to discover set of CPUs available on system
+ Michael Kerrisk
+ SEE ALSO: add nproc(1) and lscpu(1)
+
+select.2
+ Michael Kerrisk
+ SEE ALSO: add restart_syscall(2)
+
+semop.2
+ Michael Kerrisk
+ Add note that interrupted semtimedop() returns 'timeout' unchanged
+ Michael Kerrisk
+ Remove information about semtimedop() EAGAIN that is repeated elsewhere
+ Michael Kerrisk
+ Add subsection head for semtimedop()
+
+setsid.2
+ Michael Kerrisk
+ Rewrite some pieces and add some details
+ Among other changes, add an explanation of why setsid() can't
+ be called from a process group leader
+
+sgetmask.2
+ Michael Kerrisk
+ Since 3.16, support for these system calls is configurable
+ Support for these calls is now dependent on the setting of the
+ CONFIG_SGETMASK_SYSCALL option.
+
+sigaction.2
+ Michael Kerrisk
+ Document SA_RESTORER
+ Michael Kerrisk
+ Add some detail on the sa_restorer field
+ Michael Kerrisk
+ SEE ALSO: add sigreturn(2)
+
+splice.2
+ Michael Kerrisk
+ Reformat description of 'fd_in' and 'off_in' to improve readability
+
+syscall.2
+ Michael Kerrisk
+ SEE ALSO: add errno(3)
+
+syscalls.2
+ Michael Kerrisk
+ SEE ALSO: add errno(3)
+ Michael Kerrisk
+ 3.19 adds execveat()
+ Michael Kerrisk
+ Add bpf(2) to list
+
+tee.2
+ Michael Kerrisk
+ Add shell session demonstrating use of the example program
+
+tkill.2
+ Michael Kerrisk [Rich Felker]
+ Remove bogus text saying tgid==-1 makes tgkill() equivalent to tkill()
+
+abort.3
+ Michael Kerrisk
+ Note that SIGABRT is raised as though raise(3) is called
+ Also note that abort() is POSIX.1-2008 compliant.
+
+cmsg.3
+ David Wragg
+ Ensure buf is suitably aligned in sending example
+ Inspection of the definition of CMSG_FIRSTHDR (both in glibc and
+ the suggested definition in RFC3542) shows that it yields the
+ msg_control field. So when sending, the pointer placed in
+ msg_control should be suitably aligned as a struct cmsghdr.
+ In the sending example, buf was declared as a bare char array,
+ and so is not necessarily suitably aligned.
+
+ The solution here involves placing buf inside a union, and is
+ based on the sockets/scm_rights_send.c sample from The Linux
+ Programming Interface "dist" source code collection.
+
+exp10.3
+ Michael Kerrisk
+ Before glibc 2.19, exp() did not give ERANGE error on underflow
+ http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787
+
+ftw.3
+ Michael Kerrisk
+ FTW_CHDIR has no effect on the 'fpath' argument passed to fn()
+
+getopt.3
+ Michael Kerrisk [Jonny Grant]
+ Ensure that 'nsecs' is used
+
+ilogb.3
+ Michael Kerrisk [Will Newton]
+ Since glibc 2.16, ilogb() does correctly diagnose domain errors
+
+memcmp.3
+ Michael Haardt
+ Document return value for n==0 case
+ Michael Haardt
+ Warn against use of memcmp() for comparing security-critical data
+
+mq_open.3
+ Michael Kerrisk
+ Document the O_CLOEXEC flag
+ Michael Kerrisk
+ Place 'flags' constants in alphabetical order
+
+pow.3
+ Manuel López-Ibáñez
+ Add note on performance characteristics of pow()
+
+pthread_setschedparam.3
+ Simon Newton
+ Fix logic error in example program
+ The example program will crash if -A is used, since 'attr'
+ is uninitialized.
+
+ $ ./a.out -A
+ *** Error in `./a.out': free(): invalid pointer: 0xb779c3c4 ***
+ Aborted (core dumped)
+ 刘湃
+ Small fixes to example program
+
+sigvec.3
+ Michael Kerrisk
+ Starting with version 2.21, glibc no longer exports sigvec()
+
+sysconf.3
+ Josh Triplett
+ Document _SC_NGROUPS_MAX
+ Already documented in getgroups(2), but not in sysconf(3).
+
+termios.3
+ Michael Kerrisk
+ SEE ALSO: add tset(1)
+
+tgamma.3
+ Michael Kerrisk
+ Since glibc 2.18, errno is correctly set to EDOM when (x == -infinity))
+
+wordexp.3
+ Carlos O'Donell
+ Make it clear that WRDE_NOCMD prevents command substitution
+ The use of WRDE_NOCMD prevents command substitution. If the flag
+ WRDE_NOCMD is set then no command substitution shall occur and
+ the error WRDE_CMDSUB will be returned if such substitution is
+ requested when processing the words.
+
+ The manual page as-is makes it seem like the command substitution
+ occurs, and an error is returned *after* the substitution.
+ This patch clarifies that.
+
+locale.5
+ Marko Myllynen
+ Describe the formats of values
+ locale(5) describes what a locale should define but doesn't
+ spell out how (in what format). The patch attempts to address
+ this, it also has few trivial additional enhancements.
+
+ * Reference to locale(7) for category descriptions.
+ * Clarify first_workday in NOTES a bit.
+ * Add upstream BZ reference for two missing LC_ADDRESS fields.
+ Marko Myllynen
+ Fix miscoded character
+
+resolv.conf.5
+ Jan Chaloupka
+ Add missing no-tld-query option
+ Based on commit [1], the no-tld-query option exists for
+ resolv.conf configuration file. Description of this option
+ is provided in [2]. This patch just copies this option
+ into resolv.conf.5 man page. Plus changes 'a' member
+ into 'an' before 'unqualified name as if it ...'
+ on the third line of [2]. Based on [3], this option
+ was added in glibc 2.14 as solving [4] bug.
+
+ [1] https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
+ [2] http://www.daemon-systems.org/man/resolv.conf.5.html man page.
+ [3] https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;h=952f32af17e7fb49c4c1a305de673a13075bfaf5;hb=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
+ [4] https://sourceware.org/bugzilla/show_bug.cgi?id=12734
+
+credentials.7
+ Josh Triplett
+ Cross-reference getgroups(2)
+ Since credentials.7 discusses supplementary GIDs, it should
+ reference getgroups(2).
+
+fanotify.7
+ Heinrich Schuchardt
+ Allow relative paths in example
+ The current example code requires passing an absolute
+ path to the mount to be watched.
+
+ By passing AT_FDCWD to fanotify_mark it can use both
+ absolute and relative paths.
+ Heinrich Schuchardt
+ fallocate(2) creates no events
+ fallocate(2) should create FAN_MODIFY events but does not.
+ Heinrich Schuchardt [Michael Kerrisk]
+ fanotify notifies only events generated on the same mount
+ Unfortunately, fanotify does not inform listeners for all paths
+ under which a touched filesystem object is visible, but only the
+ listener using the same path as the process touching the
+ filesystem object.
+ Heinrich Schuchardt
+ Update BUGS to note bugs still not fixed in 3.17
+ I bumped the Linux version number in the BUGS section to 3.17.
+
+inotify.7
+ Heinrich Schuchardt
+ fallocate(2) does not trigger inotify events
+ Calling fallocate(2) does not result in inotify events.
+
+locale.7
+ Marko Myllynen
+ Improve LOCPATH description
+ LOCPATH is ignored by privileged programs.
+
+ Add locale archive references.
+
+ Add FILES section.
+
+man-pages.7
+ Michael Kerrisk [Laurent Georget]
+ Clarify that SEE ALSO entries may refer to pages from other projects
+
+signal.7
+ Michael Kerrisk
+ Mention other "slow devices"
+ Reads from eventfd(2), signalfd(2), timerfd(2), inotify(7),
+ and fanotify(7) file descriptors are also slow operations
+ that are restartable.
+ Michael Kerrisk
+ Fix SO_RECVTIMEO/ SO_SENDTIMEO confusion in text
+ Michael Kerrisk
+ Since Linux 3.8, reads on inotify(7) file descriptors are restartable
+ Michael Kerrisk
+ inotify(7) reads no longer show the odd EINTR error after SIGCONT
+ Since kernel 3.7, reads from inotify(7) file descriptors no longer
+ show the (Linux oddity) behavior of failing with EINTR when the
+ process resumes after a stop signal + SIGCONT.
+ Michael Kerrisk
+ SEE ALSO: add sigreturn(2)
+
+unix.7
+ Michael Kerrisk [Scott Harvey]
+ Fix buglet in code snippet in BUGS section
+
+ld.so.8
+ Carlos O'Donell
+ Add --inhibit-cache option
+ The dynamic loader has 6 options, only 5 are documented.
+ This patch documents the sixth option i.e. `--inhibit-cache`.
+ Jonathan Wakely [Siddhesh Poyarekar]
+ Correct documentation of $ORIGIN
+ As noted by Siddhesh:
+
+ The ld.so man page says:
+
+ $ORIGIN (or equivalently ${ORIGIN})
+ This expands to the directory containing the
+ application executable. Thus, an application located
+ in somedir/app could be compiled with
+
+ This is incorrect since it expands to the directory containing
+ the DSO and not the application executable. This seems like
+ deliberate behaviour in dl-object.c, so it needs to be fixed in
+ the man page.
+
+ See http://stackoverflow.com/questions/26280738/what-is-the-equivalent-of-loader-path-for-rpath-specification-on-linux/26281226#26281226
+