Justin Pryzby <justinpryzby@users.sourceforge.net>
Ludovic Courtes <ludovic.courtes@laas.fr>
Mike Frysinger <vapier@gentoo.org>
-Nicolas François <nicolas.francois@centraliens.net>
+Nicolas François <nicolas.francois@centraliens.net>
Norbert Buchmuller <norbi.spam@nix.hu>
Paul Brook <paul@nowt.org>
Ramiro Aceves <ea1abz@gmail.com>
Hasso Tepper <hasso@estpak.ee>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Martin (Joey) Schulze <joey@infodrom.org>
-Nicolas François <nicolas.francois@centraliens.net>
+Nicolas François <nicolas.francois@centraliens.net>
Paul Brook <paul@nowt.org>
Siward de Groot <siward@wanadoo.nl>
Steve Beattie <sbeattie@suse.de>
Helmut Grohne <helmut@subdivi.de>
Ivana Varekova <varekova@redhat.com>
Thomas Huriaux <thomas.huriaux@gmail.com>
-Ville Skyttä <ville.skytta@iki.fi>
+Ville Skyttä <ville.skytta@iki.fi>
Apologies if I missed anyone!
Various formatting problems found as a result of reviewing the
following command were fixed.
- for a in $(wc man?/*.?| awk '$1 > 2 ' | grep -v total); do
+ for a in $(wc -l man?/*.?| awk '$1 > 2 {print $2}' | grep -v total); do
echo $a; groff -Tascii -wmac -mman $a > /dev/null;
done 2>&1 | less
---------------------------
ldd.1
- Ville Skyttä
+ Ville Skyttä
Document "-u" option.
chdir.2
Christoph Hellwig <hch@lst.de>
Chuck Ebbert <76306.1226@compuserve.com>
Samuel Thibault <samuel.thibault@ens-lyon.org>
-Toralf Förster <toralf.foerster@gmx.de>
+Toralf Förster <toralf.foerster@gmx.de>
Apologies if I missed anyone!
Julien Blache <jblache@debian.org>
Julien Cristau <jcristau@debian.org>
Justin Pryzby <justinpryzby@users.sourceforge.net>
-Martín Ferrari <martin.ferrari@gmail.com>
+Martín Ferrari <martin.ferrari@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Nick Piggin <npiggin@suse.de>
Nick Pollitt <npollitt@mvista.com>
-Nicolas François <nicolas.francois@centraliens.net>
-P
ádraig Brady <P@draigBrady.com>
+Nicolas François <nicolas.francois@centraliens.net>
+P
ádraig Brady <P@draigBrady.com>
Premysl Hruby <dfenze@gmail.com>
Reuben Thomas <rrt@sc3d.org>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Fixed consecutive duplicate word typos on a number of pages.
Typographical or grammatical errors have been corrected in several
-places. (Special thanks to Nicolas François!)
+places. (Special thanks to Nicolas François!)
Changes to individual pages
32-bit system is actually EFBIG, not EOVERFLOW.
posix_fadvise.2
- Pádraig Brady
+ Pádraig Brady
Fix RETURN VALUE description: returns error number of failure.
rename.2
Small rewording of explanation of "atomically".
signal.2
- Nicolas François
+ Nicolas François
Fix incorrect argument name in DESCRIPTION.
mtk
Small wording improvement.
socket.2
- Nicolas François
+ Nicolas François
Add reference to ipv6.7 page.
socketcall.2
- Nicolas François
+ Nicolas François
Fix .TH line.
splice.2
Small wording clarification.
symlink.2
- mtk / Nicolas François
+ mtk / Nicolas François
Removed cryptic text under CONFORMING to referring to
"open(2) and NFS". There is no relevant text in open.2 as
far as I (mtk) can see.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=352139
glob.3
- Nicolas François
+ Nicolas François
Fix PROTOTYPE.
inet_network.3
Clarified description of inet_network().
log.3
- Nicolas François
+ Nicolas François
Fix .TH line.
log10.3
- Nicolas François
+ Nicolas François
Fix .TH line.
malloc.3
- Nicolas François
+ Nicolas François
Small rewording to mention calloc().
posix_openpt.3
- Martín Ferrari
+ Martín Ferrari
Fix return type in SYNOPSIS; as per
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400971
Needs _XOPEN_SOURCE == 600; as per
Add "#define _REGEX_RE_COMP" to SYNOPSIS.
regex.3
- Nicolas François
+ Nicolas François
Fix .TH line.
termios.3
Document _REENTRANT and _THREAD_SAFE.
mdoc.7
- mtk / Nicolas François
+ mtk / Nicolas François
Remove CONFIGURATION section, since this does not seem to be
true for Linux.
svipc.7
- Nicolas François
+ Nicolas François
Fix data types in associated data structures;
remove nonexistent semzcnt and semncnt fields.
Jeff Schroeder <jeffschroeder@computer.org>
Joey (Martin) Schulze <joey@infodrom.org>
Justin Pryzby <justinpryzby@users.sourceforge.net>
-Loïc Minier <lool@dooz.org>
+Loïc Minier <lool@dooz.org>
Michael Gehring <mg@ebfe.org>
Serge van den Boom <svdb@stack.nl>
Stefan Puiu <stefanpuiuro@yahoo.com>
Reformatted headings; minor rewrites.
socket.7
- Loïc Minier <lool@dooz.org>
+ Loïc Minier <lool@dooz.org>
Document argument type for SO_REUSEADDR.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=255881
Justin Pryzby <justinpryzby@users.sourceforge.net>
Marc Boyer <marc.boyer@enseeiht.fr>
Martin (Joey) Schulze <joey@infodrom.org>
-Martin Röhricht <martin@roehricht.info>
+Martin Röhricht <martin@roehricht.info>
Patrick Mansfield <patmans@us.ibm.com>
Pierre Habouzit <madcoder@debian.org>
Stepan Kasal <kasal@ucw.cz>
Changed link to point to uname.2 (instead of obsolete.2).
sched_setaffinity.2
- Martin Röhricht
+ Martin Röhricht
Added _GNU_SOURCE to SYNOPSIS.
semctl.2
Anton Blanchard <anton@samba.org>
Ari Entlich <lmage11@twcny.rr.com>
Carsten Emde <Carsten.Emde@osadl.org>
-François Diakhate <diakhate@enseirb.fr>
+François Diakhate <diakhate@enseirb.fr>
Geoff Clare <gclare@gclare.org.uk>
Jon Burgess <jburgess777@googlemail.com>
Julien Cristau <jcristau@debian.org>
Maxime Vaudequin <maxime.vaudequin@gmail.com>
Michael Prokop <mika@grml.org>
Mike Frysinger <vapier@gentoo.org>
-Nicolas François <nicolas.francois@centraliens.net>
+Nicolas François <nicolas.francois@centraliens.net>
Nicolas George <nicolas.george@ens.fr>
Paul Brook <paul@nowt.org>
Reuben Thomas <rrt@sc3d.org>
Order errors under ERRORS alphabetically.
Various pages
- Nicolas François
+ Nicolas François
Spelling and formatting fixes, as per
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=439560
mmap.2
mprotect.2
- François Diakhate
+ François Diakhate
Add text noting that PROT_WRITE may (and on x86 does)
imply PROT_READ.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=441387
Add vsyslog to NAME section.
termios.3
- Nicolas François
+ Nicolas François
Fix XCASE feature test macro description.
wcsspn.3
man.7
mdoc.7
mdoc.samples.7
- mtk / Nicolas François
+ mtk / Nicolas François
Nowadays tmac.XXX are called XXX.tmac.
pthreads.7
Justin Pryzby <jpryzby+d@quoininc.com>
Maxime Vaudequin <maxime.vaudequin@gmail.com>
Mike Frysinger <vapier@gentoo.org>
-Nicolas François <nicolas.francois@centraliens.net>
-P
ádraig Brady <P@draigBrady.com>
+Nicolas François <nicolas.francois@centraliens.net>
+P
ádraig Brady <P@draigBrady.com>
Sam Varshavchik <mrsam@courier-mta.com>
Timo Juhani Lindfors <timo.lindfors@iki.fi>
Ulrich Drepper <drepper@redhat.com>
Linux 2.6.22 added support on Alpha for PR_SET_UNALIGN.
ptrace.2
- Nicolas François / mtk
+ Nicolas François / mtk
s/PTRACE_POKEUSR/PTRACE_POKEUSER/
s/PTRACE_PEEKUSR/PTRACE_PEEKUSER/
Remove SEE ALSO references to getipnodebyname.3 and
getipnodebyaddr.3.
- Pádraig Brady / mtk / Ulrich Drepper
+ Pádraig Brady / mtk / Ulrich Drepper
Point out that the functions described on this page
are made obsolete by getaddrinfo(3) and getnameinfo(3).
Alain Portal <aportal@univ-montp2.fr>
Andries E. Brouwer <Andries.Brouwer@cwi.nl>
J. Bruce Fields <bfields@citi.umich.edu>
-David Härdeman <david@hardeman.nu>
+David Härdeman <david@hardeman.nu>
Jeremy Kerr <jk@ozlabs.org>
Luke Browning <lukebr@linux.vnet.ibm.com>
Mats Wichmann <mats.d.wichmann@intel.com>
mq_notify.3
makecontext.3
fmemopen.3
- David Härdeman / mtk
+ David Härdeman / mtk
Rename error handling function in example program
(s/die/handle_error/).
been incorporated in changes in this release:
Alain Portal <aportal@univ-montp2.fr>
-P
ádraig Brady <P@draigBrady.com>
+P
ádraig Brady <P@draigBrady.com>
Reuben Thomas <rrt@sc3d.org>
Apologies if I missed anyone!
Andries E. Brouwer <Andries.Brouwer@cwi.nl>
Chris Heath <chris@heathens.co.nz>
Davide Libenzi <davidel@xmailserver.org>
-Fernando Luis Vázquez Cao <fernando@oss.ntt.co.jp>
+Fernando Luis Vázquez Cao <fernando@oss.ntt.co.jp>
Heikki Orsila <shdl@zakalwe.fi>
Jeremy Kerr <jk@ozlabs.org>
Justin Pryzby <justinpryzby@users.sourceforge.net>
-Lasse Kärkkäinen <tronic@trn.iki.fi>
+Lasse Kärkkäinen <tronic@trn.iki.fi>
Michael Haardt <michael@moria.de>
Mike Frysinger <vapier@gentoo.org>
Ron Burk <ronburk@gmail.com>
Remove some duplicated text.
malloc.3
- Lasse Kärkkäinen / Mike Frysinger / mtk
+ Lasse Kärkkäinen / Mike Frysinger / mtk
Clarify description of realloc() behavior for
((size == 0) && (ptr != NULL)).
s/stdlib.h/fcntl.h/ in SYNOPSIS.
proc.5
- Fernando Luis Vázquez Cao
+ Fernando Luis Vázquez Cao
Update /proc/[number]/cmdline description.
It used to be true that the command line arguments were
not accessible when the process had been swapped out.
Karsten Weiss <K.Weiss@science-computing.de>
Martin Pitt <mpitt@debian.org>
Marty Leisner <leisner@rochester.rr.com>
-Nicolas François <nicolas.francois@trialog.com>
+Nicolas François <nicolas.francois@trialog.com>
Nick Piggin <npiggin@suse.de>
Petter Reinholdtsen <pere@hungry.com>
Reuben Thomas <rrt@sc3d.org>
Reformat kernel version information for flags.
Typographical or grammatical errors have been corrected in several places.
-(Special thanks to Nicolas François.)
+(Special thanks to Nicolas François.)
New pages
Add "Link with -lrt" to SYNOPSIS.
backtrace.3
- Nicolas François
+ Nicolas François
s/backtrace_symbols/backtrace_symbols_fd/ in one sentence.
mtk
Fix bogus reference to variable 'strings': should be:
initstate_r(3), setkey_r(3), setstate_r(3) are now documented.
utmp.5
- Nicolas François
+ Nicolas François
Small rewording.
resolv.conf.5
- Nicolas François
+ Nicolas François
gethostname() is in Section 2, not section 3.
ascii.7
Fix rendering of ' (backtick) and apostrophe (') in tables
charsets.7
- Nicolas François
+ Nicolas François
s/unicode.com/unicode.org/
credentials.7
SEE ALSO: add time(7)
Typographical or grammatical errors have been corrected in several places.
-(Special thanks to Nicolas François and Alain Portal.)
+(Special thanks to Nicolas François and Alain Portal.)
Changes to individual pages
CONFIG_PRINTK.
utime.2
- Nicolas François
+ Nicolas François
Clarify description of 'times' array for utimes().
adjtime.3
Suka <sukadev@us.ibm.com>
Timothy S. Nelson <wayland@wayland.id.au>
Tolga Dalman <tdalman@project-psi.org>
-Török Edwin <edwintorok@gmail.com>
+Török Edwin <edwintorok@gmail.com>
Apologies if I missed anyone!
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
-Andr
é Goddard Rosa <andre.goddard@gmail.com>
+Andr
é Goddard Rosa <andre.goddard@gmail.com>
George Spelvin <linux@horizon.com>
Pavel Heimlich <tropikhajma@seznam.cz>
Sam Varshavchik <mrsam@courier-mta.com>
Clarify closedir()'s treatment of underlying file descriptor.
tsearch.3
- André Goddard Rosa
+ André Goddard Rosa
Fix memory leak in example program.
Add use of tdestroy to example program.
mtk
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
-Andr
é Goddard Rosa <andre.goddard@gmail.com>
+Andr
é Goddard Rosa <andre.goddard@gmail.com>
Eugene V. Lyubimkin <jackyf.devel@gmail.com>
Gergely Soos <sogerc1@gmail.com>
Kirill A. Shutemov <kirill@shutemov.name>
Maxin B. John <maxin.john@ap.sony.com>
Maxin John <maxin.john@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
-Nicolas François <nicolas.francois@centraliens.net>
+Nicolas François <nicolas.francois@centraliens.net>
Pavel Heimlich <tropikhajma@seznam.cz>
-Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
+Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
Sam Varshavchik <mrsam@courier-mta.com>
Apologies if I missed anyone!
Add EAGAIN error.
move_pages.2
- Nicolas François
+ Nicolas François
Make a detail of EPERM error more precise
mount.2
that glibc does provide the required pieces).
recv.2
- Nicolas François
+ Nicolas François
Move kernel version number to first mention to MSG_ERRQUEUE.
semop.2
Make it clear that the POSIX.1 revision that is likely
to affect the feature test macro requirements for futimens()
is POSIX.1-2008.
- Nicolas François
+ Nicolas François
Make various wordings a little more precise.
The times argument point to *an array of* structures, and the
man-page should say that consistently.
for example.)
atan2.3
- Nicolas François
+ Nicolas François
Fix error in description of range or return value
In recent changes to the man page, mtk accidentally changed
the description of the return value range to -pi/2..pi/2;
the correct range is -pi..pi.
cmsg.3
- Nicolas François
+ Nicolas François
Add parentheses after macro names.
ctime.3
Minor rewording of mktime() description.
floor.3
- Nicolas François
+ Nicolas François
floor.3: Fix error in description: s/smallest/largest/
hsearch.3
- André Goddard Rosa
+ André Goddard Rosa
Call hdestroy() after using hash table created by hcreate(),
for the sake of completeness
This info is useful for users of strace(1).
nextafter.3
- Nicolas François
+ Nicolas François
Make description more precise: s/next/largest/
readdir.3
Lefteris Dimitroulakis <edimitro@tee.gr>
Olaf van der Spek <olafvdspek@gmail.com>
Sam Varshavchik <mrsam@courier-mta.com>
-Török Edwin <edwintorok@gmail.com>
+Török Edwin <edwintorok@gmail.com>
Ulrich Mueller <ulm@gentoo.org>
Valdis Kletnieks <Valdis.Kletnieks@vt.edu>
Ivana Varekova <varekova@redhat.com>
Jen Axboe <jens.axboe@oracle.com>
Jens Axboe <jens.axboe@oracle.com>
-Loïc Domaigne <tech@domaigne.com>
+Loïc Domaigne <tech@domaigne.com>
Masanari Iida <masanari.iida@hp.com>
Paul Evans <leonerd@leonerd.org.uk>
Pavel Emelyanov <xemul@openvz.org>
sched_setaffinity.2
Michael Kerrisk
Add note on system-imposed restrictions on CPUs actually used
- After Loic Domaigne's suggestion for pthread_setaffinity_np(3), add
+ After Loïc Domaigne's suggestion for pthread_setaffinity_np(3), add
similar text to this page noting that the system silently
limits the set of CPUs on which the process actually runs to
the set of CPUs physically present and the limits imposed by
Fix description of range of function value return
The range is not [-pi/2, pi/2], but [-pi, pi].
- (mtk: This error was reported by Nicolas Francois, and
+ (mtk: This error was reported by Nicolas François, and
should have been fixed in 3.11, but somewhere along the way,
the fix got lost.)
pthread_attr_setaffinity_np.3
Michael Kerrisk
- Various fixes after review by Loic Domaigne
- Reviewed-by: Loic Domaigne
+ Various fixes after review by Loïc Domaigne
+ Reviewed-by: Loïc Domaigne
pthread_attr_setaffinity_np.3
pthread_setaffinity_np.3
pthread_setschedparam.3
Michael Kerrisk
Remove text saying that only sched_priority is required by POSIX.1
- Loic Domaigne points out that if a system implements
+ Loïc Domaigne points out that if a system implements
SCHED_SPORADIC (which Linux does not), then other
fields are also specified in sched_param. The simple
solution is just to remove that phrase from the man
Michael Kerrisk
Add text to EINVAL error mentioning cpuset(7)
Michael Kerrisk
- Various improvements after review by Loïc Domaigne
- Various fix-ups after Loïc's review.
+ Various improvements after review by Loïc Domaigne
+ Various fix-ups after Loïc's review.
- Reviewed-by: Loïc Domaigne
+ Reviewed-by: Loïc Domaigne
pthread_setschedparam.3
Michael Kerrisk
Fix return value description
The correct range for the return value is [-pi/2,pi/2].
(mtk's fix in the last change to the return value text was
- a botch-up of a (correct) suggestion by Nicolas Francois.)
+ a botch-up of a (correct) suggestion by Nicolas François.)
atexit.3
Michael Kerrisk
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
-Adeodato Simó <dato@net.com.org.es>
+Adeodato Simó <dato@net.com.org.es>
Bastien ROUCARIES <roucaries.bastien@gmail.com>
Davide Libenzi <davidel@xmailserver.org>
Lefteris Dimitroulakis <edimitro@tee.gr>
been incorporated in changes in this release:
Alan Curry <pacman@kosh.dhis.org>
-Américo Wang <xiyou.wangcong@gmail.com>
+Américo Wang <xiyou.wangcong@gmail.com>
Andi Kleen <andi@firstfloor.org>
Carlos O'Donell <carlos@systemhalted.org>
Chunming Chang <cchang@aerohive.com>
---------------------------------------------
proc.5
- Américo Wang
+ Américo Wang
Document /proc/sys/vm/swappiness
Michael Kerrisk
Document /proc/sysrq-trigger
Adrian Dewhurst <sailor@sailorfrag.net>
Alexander Lamaison <awl03@doc.ic.ac.uk>
-Bryan Østergaard <kloeri@exherbo.org>
+Bryan Østergaard <kloeri@exherbo.org>
Christopher Head <chead@telus.net>
Doug Goldstein <cardoe@gentoo.org>
Florentin Duneau <fduneau@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Petr Baudis <pasky@suse.cz>
-Reimar Döffinger <Reimar.Doeffinger@gmx.de>
+Reimar Döffinger <Reimar.Doeffinger@gmx.de>
Ricardo Garcia <rg3.zeluan@gmail.com>
Rui Rlex <rui.rlex@gmail.com>
Shachar Shemesh <shachar@debian.org>
complex.7
Michael Kerrisk
Add missing header file for example program
- Reimar Döffinger
+ Reimar Döffinger
Fix type used in example code
man complex (from release 3.18) contains the following code:
complex z = cexp(I * pi);
Mark Hills <mark@pogo.org.uk>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
-Nicolas François <nicolas.francois@centraliens.net>
+Nicolas François <nicolas.francois@centraliens.net>
Serge Hallyn <serue@us.ibm.com>
Siward de Groot <siward@ziggo.nl>
rui rlex <rui.rlex@gmail.com>
reported by: rui rlex <rui.rlex@gmail.com>
semctl.2
- Nicolas François
+ Nicolas François
Remove some redundant words
setpgid.2
is ssize_t (formerly it was long).
stat.2
- Nicolas François
+ Nicolas François
Fix small bug in example program
Since it is a failure, EXIT_FAILURE looks more appropriate
than EXIT_SUCCESS.
argument name.
posix_fallocate.3
- Nicolas François
+ Nicolas François
Fix reference to POSIX.1-2008
The sentence mentions twice POSIX.1-2001.
I guess the second one should be POSIX.1-2008.
of errno.
strftime.3
- Nicolas François
+ Nicolas François
Fix error in description: s/Monday/Thursday/
proc.5
- Nicolas François
+ Nicolas François
Fix page cross reference
max_user_watches is better explained in epoll(7) than inotify(7).
been "since 2.6.30".
capabilities.7
- Nicolas François
+ Nicolas François
Reword a bad sentence in description of capability bounding set.
mq_overview.7
tcp.7
udp.7
- Nicolas François
+ Nicolas François
Replace references to syctl interfaces with /proc
Doug Manley <doug.manley@gmail.com>
Edward Welbourne <eddy@opera.com>
Fang Wenqi <anton.fang@gmail.com>
-Frédéric Brière <fbriere@fbriere.net>
+Frédéric Brière <fbriere@fbriere.net>
Garrett Cooper <yaneurabeya@yahoo.com>
Ihar Hrachyshka <ihar.hrachyshka@gmail.com>
Jann Poppinga <jann.poppinga@gmx.de>
Alexander E. Patrakov <patrakov@gmail.com>
Andi Kleen <andi@firstfloor.org>
Andrew Klossner <andrew@cesa.opbu.xerox.com>
-Andr
é Goddard Rosa <andre.goddard@gmail.com>
+Andr
é Goddard Rosa <andre.goddard@gmail.com>
Bo Borgerson <gigabo@gmail.com>
Christian Franke <nobody@nowhere.ws>
Daisuke HATAYAMA <d.hatayama@jp.fujitsu.com>
Jianhua Li <jhlicc@gmail.com>
Linus Nilsson <lajnold@gmail.com>
Lenaic Huard <lenaic.huard@laposte.net>
-mac@mcrowe.com
+Mac <mac@mcrowe.com>
Martin Schulze <joey@infodrom.org>
Maxin John <maxin.john@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
-caishuxian@gmail.com
+caishuxian <caishuxian@gmail.com>
Denis Barbier <bouzim@gmail.com>
Denis Silakov <silakov@ispras.ru>
der Mouse <mouse@rodents-montreal.org>
readdir.3
Michael Kerrisk
Clarify that "positive error numbers" are listed in ERRORS
- Reported-by fkater@googlemail.com
rexec.3
Michael Kerrisk
Michael Kerrisk <mtk.manpages@gmail.com>
Petr Uzel <petr.uzel@suse.cz>
Roger Pate <roger@qxxy.com>
-Török Edwin <edwintorok@gmail.com>
+Török Edwin <edwintorok@gmail.com>
Yuri Kozlov <yuray@komyakino.ru>
Apologies if I missed anyone!
Salvo Tomaselli <tiposchi@tiscali.it>
Simone Piccardi <piccardi@truelite.it>
Slaven Rezic <srezic@iconmobile.com>
-starlight@binnacle.cx
+starlight <starlight@binnacle.cx>
Stephan Mueller <stephan.mueller@atsec.com>
Vijay Rao <vijay@portuosus.com>
Walter Haidinger <walter.haidinger@gmx.at>
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
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
Michael Kerrisk [Florian Weimer]
Define _GNU_SOURCE to obtain the definition of 'struct ucred'
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572210
+
+
+==================== Changes in man-pages-3.51 ====================
+
+Released: 2013-04-17, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andreas Jaeger <aj@suse.de>
+Andrew Clayton <andrew@digital-domain.net>
+Brian M. Carlson <sandals@crustytoothpaste.net>
+Changhee Han <ch0.han@lge.com>
+Cyril Hrubis <chrubis@suse.cz>
+Damien Grassart <damien@grassart.com>
+David Prévot <taffit@debian.org>
+Denis Barbier <bouzim@gmail.com>
+Jeff Moyer <jmoyer@redhat.com>
+Krzysztof Konopko <krzysztof.konopko@gmail.com>
+Kyle McMartin <kyle@mcmartin.ca>
+Mark H Weaver <mhw@netris.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Nicolas Hillegeer <nicolas@hillegeer.com>
+Pavel Emelyanov <xemul@parallels.com>
+Peter Schiffer <pschiffe@redhat.com>
+Radek Pazdera <rpazdera@redhat.com>
+Ralph Loader <suckfish@ihug.co.nz>
+Simon Paillard <spaillard@debian.org>
+The Wanderer <wanderer@fastmail.fm>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+sched_rr_get_interval.2
+ Michael Kerrisk
+ Document /proc/sys/kernel/sched_rr_timeslice_ms
+
+proc.5
+ Pavel Emelyanov
+ Document /proc/[pid]/map_files directory
+ This directory was added in Linux v3.3 and provides info about
+ files being mmap-ed in a way very similar to how /proc/[pid]/fd
+ works.
+
+ v2: Added examples of how links look like and noted dependency
+ on kernel config option CONFIG_CHECKPOINT_RESTORE.
+ Michael Kerrisk
+ Document /proc/sys/kernel/shm_rmid_forced
+
+capabilities.7
+ Michael Kerrisk
+ Document /proc/sys/kernel/cap_last_cap
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: fix placement of word "only"
+
+Various pages
+ Simon Paillard
+ License headers: consistent format
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/since kernel/since Linux/
+
+Various System V IPC pages in Section 2
+ Michael Kerrisk
+ Add "System V" to .TH line and text
+ Make it clear that these pages relate to System V IPC,
+ not POSIX IPC.
+
+
+Changes to individual pages
+---------------------------
+
+access.2
+ Michael Kerrisk [The Wanderer]
+ Clarify RETURN VALUE for F_OK
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=705293
+
+alarm.2
+ Michael Kerrisk
+ Correct the description of behavior when 'seconds' is 0
+
+clone.2
+ Michael Kerrisk [Peter Schiffer]
+ Add prototype for syscall to SYNOPSIS
+ And further clarify the distinction between the system call
+ and the wrapper function in the introductory text.
+ Michael Kerrisk
+ Update feature test macro requirements
+ The requirements quietly changed changed in glibc 2.14
+
+ See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
+ Michael Kerrisk [Mike Frysinger]
+ Clarify differences between clone2() syscall and wrapper function
+ Michael Kerrisk [Mike Frysinger]
+ Note those architectures where the sys_clone argument order differs
+ Michael Kerrisk [Mike Frysinger]
+ Add short subsection noting that blackfin, m68k, and sparc are different
+ Michael Kerrisk
+ Move clone2() text to subsection in description
+ The description of ia64 clone2() should follow the discussion
+ of the raw system call interface.
+ Michael Kerrisk
+ Change subhead for ia64 discussion
+
+getcpu.2
+ Michael Kerrisk
+ Recommend that 'tcache' should be specified as NULL nowadays
+
+io_cancel.2
+ Jeff Moyer, Michael Kerrisk [Cyril Hrubis]
+ Improve description
+
+io_destroy.2
+ Jeff Moyer
+ Improve description
+ The description was rather vague, citing a "list of I/O contexts"
+ and stating that it "can" cancel outstanding requests. This
+ update makes things more concrete so that the reader knows exactly
+ what's going on.
+
+io_getevents.2
+ Jeff Moyer
+ The 'timeout' argument is not updated
+ I looked back through the kernel code, and the timeout was
+ never updated in any case. I've submitted a patch upstream
+ to change the comment above io_getevents.
+
+io_setup.2
+ Jeff Moyer
+ Clarify nr_events
+ nr_events is technically the number of completion events that can
+ be stored in the completion ring. The wording of the man page:
+ "capable of receiving at least nr_events" seems dubious to me,
+ only because I worry that folks might interpret that to mean
+ 'nr_events' total, instead of 'nr_events' concurrently.
+
+ Further, I've added information on where to find the per-user
+ limit on 'nr_events', /proc/sys/fs/aio-max-nr. Let me know if
+ you think that is not relevant.
+
+listxattr.2
+ Michael Kerrisk
+ Explain use of 'size' argument
+
+lseek.2
+ Michael Kerrisk [Andreas Jaeger]
+ _GNU_SOURCE must be defined to get SEEK_DATE and SEEK_HOLE definitions
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=15312
+
+mmap.2
+ Michael Kerrisk
+ Add pointers to relevant /proc files described in proc(5)
+
+posix_fadvise.2
+pread.2
+readahead.2
+sync_file_range.2
+truncate.2
+ Michael Kerrisk
+ Refer to syscall(2) for ABI semantics on certain 32-bit architectures
+ Also: in sync_file_range.2 and posix_fadvise.2 remove description
+ of conventional calling signature as flawed, and in
+ posix_fadvise.2, de-emphasize focus on ARM, and rather phrase
+ as a more general discussion of certain architectures.
+
+readdir.2
+ Michael Kerrisk
+ readdir(2) doesn't exist on x86-64
+
+semop.2
+ Michael Kerrisk
+ Clarify the discussion of 'semadj'
+
+shmctl.2
+ Michael Kerrisk
+ Refer to proc(5) for description of /proc/sys/kernel/shm_rmid_forced
+
+syscall.2
+ Changhee Han
+ Add notes that caution users when passing arguments to syscall()
+ For example, passing 'long long' on ARM-32 requires special
+ treatment.
+ Mike Frysinger [Michael Kerrisk]
+ Document the exact calling convention for architecture system calls
+ Mike Frysinger [Kyle McMartin]
+ Add PA-RISC details under calling conventions
+ Michael Kerrisk [Mike Frysinger]
+ Refine discussion of ARM and other ABIs
+
+syscalls.2
+ Michael Kerrisk
+ Update kernel version number at start of list
+
+umask.2
+ Michael Kerrisk
+ SEE ALSO: add acl(5)
+
+unshare.2
+ Michael Kerrisk
+ Update feature test macro requirements
+ The requirements quietly changed changed in glibc 2.14
+
+ See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
+
+fopencookie.3
+ Michael Kerrisk [Ralph Loader]
+ Correct definition of cookie_io_functions_t
+
+pthread_setname_np.3
+ Andrew Clayton
+ The thread argument is passed in by value
+
+readir.3
+seekdir.3
+telldir.3
+ Michael Kerrisk
+ Eliminate the implication that these functions deal with "offsets"
+ The directory position dealt with by the readdir() and
+ friends is not a simple file offset in modern file systems.
+ Typically, it is some kind of cookie value. Add text and
+ make other changes to these pages to eliminate the
+ implication that this is an offset, and warn the reader
+ that directory positions should be treated strictly as
+ opaque values.
+
+ In the process, rename the 'offset' argument of seekdir(3)
+ to 'loc', and add some text to readdir(3) to note that
+ the 'd_off' field is the same value returned by telldir(3)
+ at the current directory position.
+
+ See also https://lwn.net/Articles/544298/
+
+scalb.3
+ Mark H Weaver
+ Fix prototypes for scalbf() and scalbl()
+
+sched_getcpu.3
+ Michael Kerrisk
+ Update feature test macro requirements
+ The requirements quietly changed changed in glibc 2.14
+
+ See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
+
+ualarm.3
+ Michael Kerrisk [Nicolas Hillegeer]
+ Add note on the behavior when 'usecs' is zero
+ POSIX.1-2001 does not specify the behavior in this case
+ and no other system that I checked documented the behavior.
+ Probably, most or all systems do what Linux does in this
+ case: cancel any pending alarm, just as alarm(0) does.
+ Add that info in NOTES.
+
+elf.5
+ Mike Frysinger
+ Add byte positions for all EI_xxx fields
+ When describing e_ident, most of the EI_xxx defines mention the
+ exact byte number. This is useful when manually hacking an ELF
+ with a hex editor. However, the last few fields don't do this,
+ which means you have to count things up yourself.
+ Add a single word to each so you don't have to do that.
+
+proc.5
+ Michael Kerrisk
+ Refer to sched_rr_get_interval(2) for info on sched_rr_timeslice_ms
+ Since Linux 3.9, /proc/sys/kernel/sched_rr_timeslice_ms can
+ be used to change the SCHED_RR quantum.
+ Michael Kerrisk
+ SEE ALSO: Add sysctl(8)
+ Krzysztof Konopko
+ Simplify the example of printing out environ
+ The binutils package contains a very handy utility to
+ print out null-byte delimited strings from a file. This
+ can replace a rather complex expression with cat(1)
+ provided as an example for printing out /proc/[pid]/environ.
+ Michael Kerrisk
+ Update /proc/PID/maps example
+ Update to 64-bit example that includes "[heap]", "[stack],
+ and "[vdso]"
+ Michael Kerrisk
+ Formatting fixes for /proc/PID/maps
+ Mike Frysinger
+ Document the "pathname" field of /proc/PID/maps
+ Michael Kerrisk
+ Add reference to capabilities(7) for /proc/sys/kernel/cap_last_cap
+ Michael Kerrisk
+ /proc/PID/maps: add a reference to mmap(2)
+
+ip.7
+ Radek Pazdera
+ Document IP_MULTICAST_ALL
+ This commit adds documentation for the IP_MULTICAST_ALL socket
+ option.
+
+ The option was added to the Linux kernel in 2.6.31:
+
+ Author Nivedita Singhvi <niv@us.ibm.com>
+ Commit f771bef98004d9d141b085d987a77d06669d4f4f
+
+ The description is based on a previous one [3] posted by the
+ original author of the code -- Nivedita, but it is slightly
+ re-worded.
+
+ I tested it myself and it works as described.
+
+ References:
+ [1] http://lxr.free-electrons.com/source/net/ipv4/ip_sockglue.c#L972
+ [2] http://lxr.free-electrons.com/source/net/ipv4/igmp.c#L2267
+ [3] http://patchwork.ozlabs.org/patch/28902/
+
+units.7
+ Brian M. Carlson
+ units should use an actual µ
+ The units(7) man page uses an ASCII u in place of the actual Greek
+ letter mu. Since we're in the twenty-first century, with
+ UTF-8-compatible terminals and terminal emulators, we should use
+ the actual letter µ instead of an ASCII approximation.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=704787
+
+
+==================== Changes in man-pages-3.52 ====================
+
+Released: 2013-07-04, Christchurch
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adrian Bunk <bunk@kernel.org>
+Andrea Remondini <andrea@undeadlinks.com>
+Anthony Foiani <anthony.foiani@gmail.com>
+Brian Norris <computersforpeace@gmail.com>
+Cyril Hrubis <chrubis@suse.cz>
+Dan Jacobson <jidanni@jidanni.org>
+David Prévot <taffit@debian.org>
+Eric S. Raymond <esr@thyrsus.com>
+Georg Sauthoff <mail@georg.so>
+Jeff Moyer <jmoyer@redhat.com>
+Jérémie Galarneau <jeremie.galarneau@efficios.com>
+Jon Grant <jg@jguk.org>
+Manuel Traut <manut@linutronix.de>
+Марк Коренберг <socketpair@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Pavel Emelyanov <xemul@parallels.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter LaDow <petela@gocougs.wsu.edu>
+Petr Gajdos <pgajdos@suse.cz>
+Regid <regid23@nt1.in>
+Siddhesh Poyarekar <siddhesh@redhat.com>
+Simone Piccardi <piccardi@truelite.it>
+Simon Paillard <spaillard@debian.org>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+perf_event_open.2
+ Vince Weaver
+ Add PERF_IOC_FLAG_GROUP documentation
+ The perf_event_open() ENABLE/DISABLE/RESET ioctls can take an
+ argument, PERF_IOC_FLAG_GROUP. This wasn't documented at all
+ until about a year ago (despite the support being there from
+ the beginning) so I missed this when initially writing
+ the man page.
+
+socket.7
+ Pavel Emelyanov, Michael Kerrisk
+ Document SO_PEEK_OFF option
+ Since Linux 3.4 there appeared an ability to specify the
+ offset in bytes from which the data will be MSG_PEEK-ed.
+ Describe this socket option in the socket(7) page, where
+ all the other socket options are described.
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Convert inline formatting (\fX...\fP) to dot-directive formatting
+
+readdir.2
+asprintf.
+getline.3
+getlogin.3
+pthread_setname_np.3
+readdir.3
+strerror.3
+ Michael Kerrisk [Jon Grant]
+ Clarify that terminating null byte is '\0'
+
+
+Changes to individual pages
+---------------------------
+
+execve.2
+ Peter LaDow
+ Add envp to the Linux notes about NULL pointers
+ During the review of static analysis results, we discovered a
+ functional, but non-portable, use of execve(). For example:
+
+ char *cmd[] = { "/path/to/some/file", NULL };
+ execve(cmd[0], cmd, NULL);
+
+ The call succeeds. Yet, the static analysis tool (rightly)
+ pointed out that envp could be dereferenced. But digging into
+ glibc and the kernel, it appears that like argv, envp when NULL
+ is treated as if it were an empty list.
+
+ So, to clear things up, I'm submitting this patch to update the
+ man page to indicate that envp is treated like argv.
+
+fallocate.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+io_setup.2
+ Cyril Hrubis [Jeff Moyer]
+ Clarify the nr_events parameter
+ Currently the io_setup.2 man page describes what the kernel really
+ does, i.e., that the resulting context may be able to hold more
+ than the 'nr_event's operations because the memory allocated in
+ kernel is rounded to be multiple of page size.
+
+ It is better not to expose this implementation detail and
+ simply state that the resulting context is suitable for
+ 'nr_events' operations.
+
+perf_event_open.2
+ Vince Weaver
+ Clarify the perf_event_open() wakeup_events/wakeup_watermark fields
+ Clarify the perf_event_open() wakeup_events/wakeup_watermark
+ fields a bit, based on info from kernel commit cfeb1d90a1b1.
+ Vince Weaver
+ Update to match the Linux 3.10 release
+ This patch updates the perf_event_open() documentation to include
+ new interfaces added in the 3.10 kernel.
+
+ It also documents a few [To be documented] instances left over
+ from the 3.7 kernel.
+ Vince Weaver
+ Small correction to description of 'flags' argument
+
+prctl.2
+ Michael Kerrisk
+ Note equivalents of PR_SET_NAME
+ pthread_setname_np() and pthread_getname_np() and
+ /proc/self/task/TID/comm provide access to the same
+ attribute.
+
+pread.2
+ Michael Kerrisk [Марк Коренберг]
+ pread() and pwrite() are especially useful in multithreaded applications
+
+recv.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+semctl.2
+ Michael Kerrisk [Simone Piccardi]
+ 'sem_nsems' is 'unsigned long' since Linux 2.4
+
+shmget.2
+ Michael Kerrisk
+ Rewrite RETURN VALUE and mention that 'errno' is set on error
+
+sigaction.2
+ Michael Kerrisk [Brian Norris]
+ RETURN VALUE: mention that 'errno' is set on error
+
+signal.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+sigpending.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+sigprocmask.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+sigsuspend.2
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+syscall.2
+ Mike Frysinger
+ Document s390/s390x calling convention
+
+a64l.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function l64a() is not thread safe.
+
+abs.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions abs(), labs(), llabs() and imaxabs() are
+ thread-safe.
+
+aio_error.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function aio_error() is thread safe.
+
+aio_return.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function aio_return() is thread safe.
+
+alloca.3
+ Adrian Bunk
+ Correct information on getting non-inlined version with gcc+glibc
+ - remove the incorrect information that -fno-builtin would help
+ - add -std=c11 to the list of strict options
+ - emphasize more that both the gcc option and not including
+ alloca.h are needed
+ - add the #ifdef from the glibc alloca.h to make the situation
+ clearer
+
+bindresvport.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ Before glibc 2.17, bindresvport() is not thread-safe.
+ Since glibc 2.17, it is thread-safe, the patch can refer to URL:
+ http://sourceware.org/git/?p=glibc.git;a=commit;h=f6da27e53695ad1cc0e2a9490358decbbfdff5e5
+
+canonicalize_file_name.3
+ Michael Kerrisk
+ Put CONFORMING TO section in right location
+
+catgets.3
+ Michael Kerrisk [Jon Grant]
+ Clarify that null byte is '\0'
+
+ceil.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ceil(), ceilf() and ceill() are thread safe.
+
+cimag.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions cimag(), cimagf() and cimagl() are thread safe.
+
+clock_getcpuclockid.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function clock_getcpuclockid() is thread safe.
+
+conj.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions conj(), conjf() and conjl() are thread safe.
+
+crypt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function crypt() is not thread safe.
+
+ctermid.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function ctermid() is thread safe with exceptions.
+
+dirfd.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+drand48.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions drand48(), erand48(), lrand48(), nrand48(),
+ mrand48(), jrand48(), srand48(), seed48() and lcong48() are
+ not thread safe.
+
+ecvt.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions ecvt() and fcvt() return a string located in a
+ static buffer which is overwritten by the next call to the
+ functions, so they are not thread-safe.
+
+encrypt.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions encrypt() and setkey() are not thread safe.
+
+ether_aton.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions ether_aton() and ether_ntoa() are not thread safe.
+
+fcloseall.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function fcloseall() is not thread safe.
+
+ferror.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ferror(), clearerr(), feof() and fileno() are
+ thread safe.
+
+fgetgrent.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+fgetpwent.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+fgetwc.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+fmtmsg.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ Before glibc 2.16, fmtmsg() is not thread-safe.
+ Since glibc 2.16, it is thread-safe, the patch can refer to URL:
+ http://sourceware.org/git/?p=glibc.git;a=commit;h=7724defcf8873116fe4efab256596861eef21a94
+
+fputwc.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+getdate.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are and aren't thread-safe
+
+getgrent.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function getgrent() is not thread safe.
+
+getgrnam.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are and aren't thread-safe
+
+getline.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+getlogin.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function getlogin() is not thread safe.
+ The function cuserid() is thread-safe with exceptions.
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+getpass.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+
+getpwent.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function getpwent() is not thread safe.
+
+getpwnam.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are and aren't thread-safe
+
+getspnam.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+getttyent.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+
+getusershell.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions getusershell(), setusershell() and endusershell()
+ are not thread safe.
+
+getutent.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+hsearch.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+hsearch.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions hsearch(), hcreate() and hdestroy() are not
+ thread-safe.
+
+localeconv.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The function localeconv() returns a pointer to a structure which
+ might be overwritten by subsequent calls to localeconv() or by
+ calls to setlocale(), so it is not thread-safe.
+ Peng Haitao
+ Add RETURN VALUE section
+
+malloc_info.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+mblen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function mblen() is not thread safe.
+
+mbrlen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function mbrlen() is thread safe with exceptions.
+
+mbrtowc.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function mbrtowc() is thread safe with exceptions.
+
+mktemp.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+modf.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions modf(), modff() and modfl() are thread safe.
+
+popen.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+pthread_attr_setinheritsched.3
+ Michael Kerrisk
+ Note the scheduling attributes affected by this function
+
+pthread_attr_setschedparam.3
+pthread_attr_setschedpolicy.3
+pthread_attr_setscope.3
+ Michael Kerrisk [Manuel Traut, Siddhesh Poyarekar]
+ The inherit-scheduler attribute must be set to PTHREAD_EXPLICIT_SCHED
+ In order for the attributes set by these functions to have
+ an effect, the caller must use pthread_attr_setinheritsched(3)
+ to set the inherit-scheduler attribute of the attributes object
+ to PTHREAD_EXPLICIT_SCHED.
+
+ptsname.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function ptsname() is not thread safe.
+
+putenv.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+putpwent.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+qecvt.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions qecvt() and qfcvt() are not thread-safe.
+
+random.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+ Michael Kerrisk
+ Add EINVAL error for setstate()
+ Michael Kerrisk
+ BUGS: initstate() does not return NULL on error
+ http://sourceware.org/bugzilla/show_bug.cgi?id=15380
+
+random_r.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+readdir.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The data returned by readdir() may be overwritten by subsequent
+ calls to readdir() for the same directory stream, so it is not
+ thread-safe.
+
+re_comp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions re_comp() and re_exec() are not thread safe.
+
+rexec.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions rexec() and rexec_af() are not thread safe.
+
+round.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions round(), roundf() and roundl() are thread safe.
+
+scalbln.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions scalbn(), scalbnf(), scalbnl(), scalbln(),
+ scalblnf() and scalblnl() are thread safe.
+
+scandir.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+siginterrupt.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+signbit.3
+ Peng Haitao
+ ATTRIBUTES: Note macro that is thread-safe
+ The macro signbit() is thread safe.
+
+sigsetops.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+stdio_ext.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are not thread-safe
+ The functions __fbufsize(), __fpending(), __fpurge() and
+ __fsetlocking() are not thread safe.
+
+strdup.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+strerror.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function strerror() is not thread safe.
+
+strftime.3
+ Michael Kerrisk
+ Clarify details of return value
+ Michael Kerrisk
+ BUGS: 'errno' is not set if the result string would exceed 'max' bytes
+
+strtok.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function strtok() is not thread safe.
+ Michael Kerrisk [Georg Sauthoff]
+ Add more detail on the operation of strtok()
+ Add a number of missing details on the operation of strtok()
+
+tempnam.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+timegm.3
+ Jérémie Galarneau
+ copy the string returned by getenv()
+ The example of a portable version of timegm() uses the string
+ returned by getenv() after calling setenv() on the same
+ environment variable. The tz string may be invalid as per
+ getenv.3:
+
+ "The string pointed to by the return value of getenv()
+ may be statically allocated, and can be modified by a
+ subsequent call to getenv(), putenv(3), setenv(3), or
+ unsetenv(3)."
+
+tmpnam.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function tmpnam() is thread safe with exceptions.
+
+trunc.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions trunc(), truncf() and truncl() are thread safe.
+
+ttyname.3
+ Michael Kerrisk
+ ATTRIBUTES: Note functions that are and aren't thread-safe
+
+ttyslot.3
+ Michael Kerrisk
+ ATTRIBUTES: Note functions that are not thread-safe
+
+usleep.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+wcsdup.3
+ Michael Kerrisk
+ RETURN VALUE: mention that 'errno' is set on error
+
+core.5
+ Michael Kerrisk
+ Implicitly adding the PID to a core filename was dropped in 2.6.27
+
+proc.5
+ Michael Kerrisk
+ Document /proc/[pid]/fd/ anon_inode symlinks
+ Mike Frysinger
+ Document /proc/[pid]/fd/ symlinks a bit more
+ Describe the type:[inode] syntax used in this dir
+
+bootparam.7
+ Michael Kerrisk [Dan Jacobson]
+ Remove outdated text on LILO and LoadLin
+ Strike the discussion of LILO and LoadLin, which
+ are long obsolete, and make a brief mention of GRUB.
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604019
+ Regid
+ Remove mention of the deprecated rdev(8)
+ The deprecated rdev(8) command was removed from util-linux in 2010.
+ See https://git.kernel.org/?p=utils/util-linux/util-linux.git;a=commit;h=a3e40c14651fccf18e7954f081e601389baefe3fO
+ Andrea Remondini
+ Document the 'resume' boot parameter
+
+inotify.7
+ Michael Kerrisk [Jon Grant]
+ Clarify that null byte is '\0'
+
+iso_8859-2.7
+ Eric S. Raymond
+ Remove incorrect reference to nonexistent groff glyph \[shc]
+ The reference incorrectly attempted to duplicate an
+ actual soft hyphen (hex 0xad) just before it in the file.
+
+man-pages.7
+ Peng Haitao
+ Add description of "ATTRIBUTES"
+ "ATTRIBUTES" section can mention thread safety,
+ cancellation safety, and async-cancel-safety.
+
+socket.7
+ Michael Kerrisk
+ Note that 'optval' for socket options is an 'int' in most cases
+
+tcp.7
+ Michael Kerrisk
+ Note that 'optval' for socket options is an 'int' in most cases
+
+udp.7
+ Michael Kerrisk
+ Note that 'optval' for socket options is an 'int' in most cases
+
+
+==================== Changes in man-pages-3.53 ====================
+
+Released: 2013-07-31, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Al Viro <viro@ZenIV.linux.org.uk>
+Andrey Vagin <avagin@openvz.org>
+Benjamin Poirier <bpoirier@suse.de>
+Chris Heath <chris@heathens.co.nz>
+Chuck Coffing <clc@alum.mit.edu>
+David Prévot <taffit@debian.org>
+Denys Vlasenko <dvlasenk@redhat.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Felix Schulte <Felix_Schulte@McAfee.com>
+Graud <graud@gmx.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Oleg Nesterov <oleg@redhat.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Schiffer <pschiffe@redhat.com>
+Simon Paillard <spaillard@debian.org>
+Vince Weaver <vincent.weaver@maine.edu>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+restart_syscall.2
+ Michael Kerrisk
+ New page for restart_syscall(2) system call
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fchownat.2
+ Michael Kerrisk
+ Document AT_EMPTY_PATH
+
+fstatat.2
+ Michael Kerrisk
+ Document AT_EMPTY_PATH
+
+linkat.2
+ Michael Kerrisk
+ Document AT_EMPTY_PATH
+
+open.2
+ Michael Kerrisk [Al Viro]
+ Document O_PATH
+ See also https://bugzilla.redhat.com/show_bug.cgi?id=885740
+
+
+Changes to individual pages
+---------------------------
+
+clock_nanosleep.2
+futex.2
+nanosleep.2
+poll.2
+sigaction.2
+sigreturn.2
+signal.7
+ Michael Kerrisk
+ SEE ALSO: add restart_syscall(2)
+
+open.2
+ Michael Kerrisk [Geoffrey Thomas]
+ Remove warning that O_DIRECTORY is only for use with opendir(3)
+ O_DIRECTORY can also be used with, for example, O_PATH.
+
+perf_event_open.2
+ Vince Weaver
+ Improve PERF_SAMPLE_BRANCH_STACK documentation
+ Vince Weaver
+ Fix indentation of the MMAP layout section
+ The indentation of the MMAP layout section wasn't quite right.
+ I think this improves things but I admit I'm not an expert at the
+ low-level indentation directives.
+ Vince Weaver
+ Update PERF_IOC_FLAG_GROUP info
+ It turns out PERF_IOC_FLAG_GROUP was broken from 75f937f24bd9
+ (in Linux 2.6.31, the initial perf_event release) until
+ 724b6daa1 (Linux 3.4).
+
+ I've done some extensive kernel source code digging plus
+ running tests of various kernels and I hope the info
+ presented is accurate now.
+
+ (Patch edited somewhat by mtk.)
+ Vince Weaver
+ Improve sysfs files documentation
+ This improves the documentation of the various
+ perf_event_open()-related sysfs files.
+
+ptrace.2
+ Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
+ If SEIZE was used, initial auto-attach stop is EVENT_STOP
+ For every PTRACE_O_TRACEfoo option, mention that old-style SIGSTOP
+ is replaced by PTRACE_EVENT_STOP if PTRACE_SEIZE attach was used.
+
+ Mention the same thing again in the description of
+ PTRACE_EVENT_STOP.
+ Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
+ Mention that PTRACE_PEEK* libc API and kernel API are different
+ Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
+ Clarify PTRACE_INTERRUPT, PTRACE_LISTEN, and group-stop behavior
+
+readlink.2
+ Michael Kerrisk
+ Document use of empty 'pathname' argument
+ Michael Kerrisk
+ Change error check in example program from "< 0" to "== -1"
+ Chuck Coffing
+ Fix possible race condition in readlink.2 example
+ I noticed that the example in the readlink.2 man pages does error
+ checking for a race condition that would cause the value of the
+ symbolic link to get larger. However, it doesn't handle the
+ opposite case, in which the value gets shorter. (The NULL
+ terminator is always set at the old, longer offset.) This could
+ cause the program to operate on uninitialized data.
+
+setpgid.2
+ Michael Kerrisk [Graud]
+ s/SIGTSTP/SIGTTIN/ when discussing reads from terminal
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60504
+
+clog2.3
+ Michael Kerrisk
+ Note that these functions are still not present in glibc 2.17
+
+dirfd.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function dirfd() is thread safe.
+
+div.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions div(), ldiv(), lldiv() and imaxdiv() are thread
+ safe.
+
+fabs.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fabs(), fabsf() and fabsl() are thread safe.
+
+fdim.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fdim(), fdimf() and fdiml() are thread safe.
+
+fflush.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function fflush() is thread safe.
+
+finite.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions finite(), finitef(), finitel(), isinf(), isinff(),
+ isinfl(), isnan(), isnanf() and isnanl() are thread safe.
+
+flockfile.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions flockfile(), ftrylockfile() and funlockfile() are
+ thread safe.
+
+floor.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions floor(), floorf() and floorl() are thread safe.
+
+resolv.conf.5
+ Simon Paillard
+ Explain how to set empty domain
+ See http://bugs.debian.org/463575
+
+capabilities.7
+ Michael Kerrisk
+ Add open_by_handle_at(2) under CAP_DAC_READ_SEARCH
+
+inotify.7
+ Michael Kerrisk [Felix Schulte]
+ Clarify description of IN_MOVED_FROM and IN_MOVED_TO
+
+man-pages.7
+ Michael Kerrisk
+ DESCRIPTION should note versions for new interface features or behavior
+
+udp.7
+ Benjamin Poirier
+ Add missing #include directive
+ Using the UDP_CORK socket option documented in udp.7 requires
+ including <netinet/udp.h>.
+
+ld.so.8
+ Michael Kerrisk
+ Rework rpath token expansion text
+ Michael Kerrisk
+ Describe $PLATFORM rpath token
+ Michael Kerrisk
+ Describe $LIB rpath token
+ Michael Kerrisk
+ Document LD_BIND_NOT
+ Michael Kerrisk [Simon Paillard]
+ Add reference to pthreads(7) in discussion of LD_ASSUME_KERNEL
+
+
+==================== Changes in man-pages-3.54 ====================
+
+Released: 2013-09-17, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+A. Costa <agcosta@gis.net>
+Akihiro MOTOKI <amotoki@gmail.com>
+Andreas Wiese <aw-lkml@instandbesetzt.net>
+Andrew Hunter <andrewhhunter@gmail.com>
+Chen Gang <gang.chen@asianux.com>
+Christopher Hall <chall0@gmail.com>
+Christos Tsopokis <christos@tsopokis.gr>
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Doug Goldstein <cardoe@cardoe.com>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
+Felix Janda <felix.janda@posteo.de>
+G.raud <graud@gmx.com>
+Hannes Landeholm <hannes@jumpstarter.io>
+J. Bruce Fields <bfields@fieldses.org>
+J. Bruce Fields <bfields@redhat.com>
+Johan Erlandsson <jeoerl@gmail.com>
+Jon Grant <jg@jguk.org>
+Magnus Reftel <magnus.reftel@gmail.com>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Oleg Nesterov <oleg@redhat.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Schiffer <pschiffe@redhat.com>
+Robert Harris <robert.harris@fixnetix.com>
+Rodrigo Campos <rodrigo@sdfg.com.ar>
+Simon Paillard <spaillard@debian.org>
+Stas <stas.grumbler@gmail.com>
+Vince Weaver <vincent.weaver@maine.edu>
+Will Newton <will.newton@linaro.org>
+Zdenek Pavlas <zpavlas@redhat.com>
+Zsbán Ambrus <ambrus@math.bme.hu>
+
+Apologies if I missed anyone!
+
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+ioctl_list.2
+ Zsbán Ambrus
+ Document FAT_IOCTL_GET_ATTRIBUTES
+ The attached patch adds four ioctls from linux/msdos_fs.h to the
+ ioctl_list(2) manpage.
+
+ The ioctl FAT_IOCTL_GET_ATTRIBUTES reads FAT attributes of a
+ file a mounted vfat file system. I tested this on Linux
+ 2.6.33, an example script can be found at
+ http://www.perlmonks.com/?node_id=832623
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/file system/filesystem/
+ Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
+ "filesystem" is the form used by the great majority of man pages
+ outside the man-pages project and in a number of other sources,
+ so let's go with that.
+
+
+Changes to individual pages
+---------------------------
+
+access.2
+ J. Bruce Fields
+ Fix outdated NFS information
+ Note that NFS versions since version 3 support an "access" call
+ so that the client doesn't have to guess permissions or ID
+ mapping on its own.
+
+ (See RFC 1813 sections 1.7 and 3.3.4.)
+
+adjtimex.2
+ Michael Kerrisk
+ SEE ALSO: Add adjtimex(8)
+
+clock_getres.2
+ Michael Kerrisk [Rodrigo Campos]
+ Note circumstances in which "SMP" note applies.
+ Michael Kerrisk
+ Add kernel version for CLOCK_*_CPUTIME_ID
+ CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID
+ appeared in 2.6.12.
+ Michael Kerrisk
+ Add VERSIONS section
+
+futex.2
+ Michael Kerrisk
+ The 'timeout' can be rounded upwards by clock granularity and also overrun
+
+kill.2
+ Michael Kerrisk
+ Small improvements to text on historical rules for permissions
+
+nfsservctl.2
+ Michael Kerrisk
+ Note commands that were only in Linux 2.4.x and earlier
+
+open.2
+ Robert Harris
+ Add mmap(2) to list of calls that fail when given an O_PATH descriptor
+ Doug Goldstein
+ Add EINVAL to errors list
+ EINVAL can be returned by open(2) when the underlying filesystem
+ doesn't support O_DIRECT. It is documented in the NOTES section
+ but this patch adds it to the list of possible errors.
+
+perf_event_open.2
+ Vince Weaver
+ PERF_SAMPLE_BRANCH_STACK updates
+ This started out as just adding the new perf_event_open features
+ from Linux 3.11 (which was the addition of transactional memory
+ defines for PERF_SAMPLE_BRANCH_STACK samples) but turned into a
+ general cleanup of the PERF_SAMPLE_BRANCH_STACK documentation.
+
+ The main clarification is that at least one of the non-privilege
+ values must be set or else perf_event_open() will return an EINVAL
+ error.
+ Michael Kerrisk
+ Reorder text describing fields of 'perf_event_header' structure
+ Place the fields with the shorter descriptions first, to make the
+ information easier to read.
+
+poll.2
+ Michael Kerrisk
+ Clarify wording of 'timeout' as a "minimum" interval
+
+sched_setaffinity.2
+ Michael Kerrisk [Christos Tsopokis]
+ Clarify that these system calls affect a per-thread attribute
+
+sched_setparam.2
+ Michael Kerrisk
+ Clarify that this system call applies to threads (not processes)
+
+sched_setscheduler.2
+ Michael Kerrisk
+ Clarify that this system call applies to threads (not processes)
+
+select.2
+ Michael Kerrisk [G.raud]
+ Clarify wording of 'timeout' as a "minimum" interval
+
+setfsgid.2
+ Michael Kerrisk [Oleg Nesterov]
+ Clarify description of return value
+ More clearly describe the weirdness in the return value of this
+ system call, and note the problems it creates in BUGS
+ Michael Kerrisk
+ Correct header file in SYNOPSIS
+ Michael Kerrisk
+ Refer to setfsuid(2) for an explanation of why setfsgid() is obsolete
+ Michael Kerrisk
+ Wording improvements
+
+setfsuid.2
+ Michael Kerrisk [Oleg Nesterov]
+ Clarify description of return value
+ More clearly describe the weirdness in the return value of this
+ system call, and note the problems it creates in BUGS
+ Michael Kerrisk [Chen Gang]
+ Clarify historical details and note that setfsuid() is obsolete
+ Michael Kerrisk
+ Wording improvements
+ Michael Kerrisk
+ Correct header file in SYNOPSIS
+
+sigwaitinfo.2
+ Michael Kerrisk
+ Clarify wording of 'timeout' as a "minimum" interval
+
+syscall.2
+ Johan Erlandsson
+ Add missing argument in example
+ Johan Erlandsson
+ Correct registers for arm/EABI
+ Registers was off by one.
+
+ Reference:
+ http://www.arm.linux.org.uk/developer/patches/viewpatch.php?id=3105/4
+
+ See also:
+ http://peterdn.com/post/e28098Hello-World!e28099-in-ARM-assembly.aspx
+ https://wiki.debian.org/ArmEabiPort
+ http://en.wikipedia.org/wiki/Calling_convention#ARM
+
+wait.2
+ Michael Kerrisk [Hannes Landeholm]
+ Add details on the fifth argument provided by raw waitid() system call
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60744
+
+clock.3
+ Michael Kerrisk
+ clock() switched from using times(2) to clock_gettime() in glibc 2.18
+
+drand48_r.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions drand48_r(), erand48_r(), lrand48_r(),
+ nrand48_r(), mrand48_r(), jrand48_r(), srand48_r(), seed48_r(),
+ and lcong48_r() are thread safe.
+
+fma.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fma(), fmaf() and fmal() are thread safe.
+
+fmax.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fmax(), fmaxf() and fmaxl() are thread safe.
+
+fmin.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fmin(), fminf() and fminl() are thread safe.
+
+fpclassify.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions fpclassify(), isfinite(), isnormal(), isnan(), and
+ isinf() are thread safe.
+
+frexp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions frexp(), frexpf() and frexpl() are thread safe.
+
+gethostbyname.3
+ Michael Kerrisk [Jon Grant]
+ gai_strerror() is the modern replacement for herror() and hstrerror()
+ Michael Kerrisk
+ Update feature test macro requirements for herror() and hstrerror()
+ Michael Kerrisk
+ Add feature test macro requirements for h_errno
+
+ilogb.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ilogb(), ilogbf() and ilogbl() are thread safe.
+
+ldexp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ldexp(), ldexpf() and ldexpl() are thread safe.
+
+lrint.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions lrint(), lrintf(), lrintl(), llrint(), llrintf(),
+ and llrintl() are thread safe.
+
+lround.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions lround(), lroundf(), lroundl(), llround(),
+ llroundf() and llroundl() are thread safe.
+
+lseek64.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function lseek64() is thread safe.
+
+mbsinit.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function mbsinit() is thread safe.
+
+nextafter.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions nextafter(), nextafterf(), nextafterl(),
+ nexttoward(), nexttowardf() and nexttowardl() are thread safe.
+
+posix_memalign.3
+ Michael Kerrisk [Will Newton]
+ 'errno" is indeterminate after a call to posix_memalign()
+ Michael Kerrisk [Will Newton]
+ Clarify wording on "return value" when size==0
+
+printf.3
+ Christopher Hall
+ Correctly describe the meaning of a negative precision
+ The printf(3) manpage says that a negative precision is taken to
+ be zero, whereas printf(3p) says that a negative precision is
+ taken as if the precision were omitted. glibc agrees with the
+ latter (POSIX) specification.
+
+ Test code:
+
+ printf("%f\n",42.0); // "42.000000"
+ printf("%.*f\n",0,42.0); // "42"
+ printf("%.*f\n",-1,42.0); // "42.000000"
+
+ This patch corrects the explanation to match what actually happens.
+
+rewinddir.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function rewinddir() is thread safe.
+
+rint.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions nearbyint(), nearbyintf(), nearbyintl(), rint(),
+ rintf() and rintl() are thread safe.
+
+seekdir.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function seekdir() is thread safe.
+
+telldir.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function telldir() is thread safe.
+
+wctomb.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function wctomb() is not thread safe.
+
+wavelan.4
+ Michael Kerrisk [Elie De Brauwer]
+ This driver disappeared in 2.56.35
+
+dir_colors.5
+ Michael Kerrisk [Stas]
+ Add various synonyms
+ See http://bugs.debian.org/553477
+ Simon Paillard [Stas]
+ Add keywords SUID, SGID, STICKY, STICKY_OTHER_WRITABLE, OTHER_WRITABLE
+ See http://bugs.debian.org/553477
+ See ls.c and dircolors.c in coreutils
+
+proc.5
+ Peter Schiffer
+ Document /proc/[pid]/io file
+ Attempt to document fields in the /proc/[pid]/io file, based on
+ the Documentation/filesystems/proc.txt. The text will probably
+ need some grammar corrections.
+ Michael Kerrisk [Marko Myllynen]
+ /proc/sys/fs/inode-max went away in Linux 2.4
+ Also, the 'preshrink' field in /proc/sys/fs/inode-state became
+ a dummy value in Linux 2.4.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60836
+ Michael Kerrisk [A. Costa]
+ Note block size used by /proc/partitions
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=666972
+ Michael Kerrisk
+ Add rationale on drop_caches and note that it can hurt performance
+ See also http://lwn.net/Articles/562211/
+
+bootparam.7
+ Michael Kerrisk [Eugen Dedu]
+ Remove "lilo" entries from SEE ALSO
+ See http://bugs.debian.org/604019
+
+inotify.7
+ Michael Kerrisk
+ SEE ALSO: add inotifywait(1) and inotifywatch(1)
+
+ip.7
+ Simon Paillard
+ IP_MULTICAST_IF setsockopt recognizes struct mreq (compatibility)
+ Kernel added compatibility only recently in
+ 3a084ddb4bf299a6e898a9a07c89f3917f0713f7
+ See: http://bugs.debian.org/607979
+
+standards.7
+ Michael Kerrisk
+ Add mention of SUSv4-TC1 (POSIX.1-2013)
+
+
+==================== Changes in man-pages-3.55 ====================
+
+Released: 2013-12-12, Christchurch
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alfred Agrell <alfred@agrell.info>
+Andreas Sandberg <andreas.sandberg@it.uu.se>
+Christoph Hellwig <hch@infradead.org>
+David Gibson <david@gibson.dropbear.id.au>
+David Prévot <taffit@debian.org>
+Fabrice Bauzac <libnoon@gmail.com>
+Greg Price <price@mit.edu>
+Jon Grant <jg@jguk.org>
+KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Liu Jiaming <storypku@gmail.com>
+Maxin B. John <maxin.john@enea.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Paolo Bonzini <bonzini@gnu.org>
+Peng Haitao <penght@cn.fujitsu.com>
+Robert P. J. Day <rpjday@crashcourse.ca>
+Rodrigo Campos <rodrigo@sdfg.com.ar>
+Shawn Landden <shawn@churchofgit.com>
+Trevor Bramwell <trevor@bramwell.net>
+Vince Weaver <vincent.weaver@maine.edu>
+Yang Yang <yangyang.gnu@gmail.com>
+Yuanhang Zheng <zhengyhn@gmail.com>
+Yuri Kozlov <yuray@komyakino.ru>
+janh <a0vhv@t-online.de>
+
+Apologies if I missed anyone!
+
+
+Global changes
+--------------
+
+assert.3
+assert_perror.3
+rexec.3
+rpc.3
+ Michael Kerrisk [Jon Grant]
+ Reword a sentence to use more gender-neutral language
+
+
+Changes to individual pages
+---------------------------
+
+execve.2
+ Michael Kerrisk
+ 'arg...' for interpreter scripts starts with argv[1]
+
+fallocate.2
+ Christoph Hellwig
+ Clarify the zeroing behavior
+ fallocate() zeroes only space that did not previously contain
+ data, but leaves existing data untouched.
+
+futex.2
+ Rodrigo Campos
+ Fix link to Rusty's futex example library
+ When I asked to webmaster@kernel.org, Konstantin Ryabitsev
+ answered that the ".nl." is "an obsolete scheme and really
+ should be changed to just ftp.kernel.org".
+
+getgroups.2
+ Michael Kerrisk
+ Note that NGROUPS_MAX is defined in <limits.h>
+ Michael Kerrisk
+ Clarify that sysconf(_SC_NGROUPS_MAX) is a run-time technique
+ Michael Kerrisk
+ Document /proc/sys/kernel/ngroups_max
+
+ioctl.2
+ Michael Kerrisk [KOSAKI Motohiro, David Gibson]
+ 'request' argument is typed as 'unsigned long' in glibc
+ See https://bugzilla.kernel.org/show_bug.cgi?id=42705
+
+perf_event_open.2
+ Vince Weaver
+ Linux 3.12 rdpmc/mmap
+ It turns out that the perf_event mmap page rdpmc/time setting was
+ broken, dating back to the introduction of the feature. Due
+ to a mistake with a bitfield, two different values mapped to
+ the same feature bit.
+
+ A new somewhat backwards compatible interface was introduced
+ in Linux 3.12. A much longer report on the issue can be found
+ here:
+ https://lwn.net/Articles/567894/
+ Vince Weaver
+ Linux 3.12 adds PERF_SAMPLE_IDENTIFIER
+ A new PERF_SAMPLE_IDENTIFIER sample type was added in Linux 3.12.
+ Vince Weaver
+ E2BIG documentation
+ The following documents the E2BIG error return for
+ perf_event_open().
+
+ I actually ran into this error the hard way and it took me
+ half a day to figure out why my ->size value was changing.
+ Vince Weaver
+ Linux 3.12 adds PERF_EVENT_IOC_ID
+ A new perf_event related ioctl, PERF_EVENT_IOC_ID, was added
+ in Linux 3.12.
+ Vince Weaver
+ PERF_COUNT_SW_DUMMY support
+ Support for the PERF_COUNT_SW_DUMMY event type was added in
+ Linux 3.12.
+ Vince Weaver [Andreas Sandberg]
+ PERF_EVENT_IOC_PERIOD update
+ The PERF_EVENT_IOC_PERIOD ioctl was broken until 2.6.36,
+ and it turns out that the ARM architecture has some
+ differing behavior too.
+
+pipe.2
+ Trevor Bramwell
+ Fix error in example program
+
+poll.2
+ Michael Kerrisk [Paolo Bonzini]
+ Clarify meaning of events==0
+ events==0 does not mean that revents is always returned as
+ zero. The "output only" events (POLLHUP, POLLERR, POLLNVAL)
+ can still be returned.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=61911
+
+readlink.2
+ Michael Kerrisk [Yuanhang Zheng]
+ Fix typo in error message in example program
+
+recv.2
+ Michael Kerrisk
+ Remove out-of-date statement that UNIX domain does not support MSG_TRUNC
+ Should have removed that sentence as part of
+ commit a25601b48b822eb1882ae336574b8d062a17e564
+
+sched_get_priority_max.2
+ Michael Kerrisk
+ Add SCHED_IDLE to discussion
+
+send.2
+ Michael Kerrisk
+ RETURN VALUE: these calls return number of bytes (not characters) sent
+
+setreuid.2
+ Michael Kerrisk
+ Small clarification to description of when saved set-user-ID is set
+
+sigpending.2
+ Michael Kerrisk
+ Note treatment of signals that are blocked *and* ignored
+
+stat.2
+ Michael Kerrisk
+ Note filesystem support for nanosecond timestamps
+ Add some detail on which native filesystems do and don't
+ support nanosecond timestamps.
+ Michael Kerrisk
+ Cosmetic reworking of timestamp discussion in NOTES
+ Michael Kerrisk [Yang Yang]
+ Update discussion of nanosecond timestamps
+ The existing text describes the timestamp fields as 'time_t'
+ and delegates discussion of nanosecond timestamps under NOTES.
+ Nanosecond timestamps have been around for a while now,
+ and are in POSIX.1-2008, so reverse the orientation of the
+ discussion, putting the nanosecond fields into DESCRIPTION
+ and detailing the historical situation under NOTES.
+
+symlink.2
+ Michael Kerrisk
+ Further fine tuning of argument names
+ Follow-up to f2ae6dde0c68448bec986d12fe32268a2c98bfd9
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=16073
+ Michael Kerrisk [Fabrice Bauzac]
+ Give arguments of symlink() more meaningful names
+
+adjtime.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function adjtime() is thread safe.
+
+alloca.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function alloca() is thread safe.
+
+asinh.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions asinh(), asinhf() and asinhl() are thread safe.
+
+atan.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions atan(), atanf() and atanl() are thread safe.
+
+atof.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function atof() is thread safe with exceptions.
+
+atoi.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions atoi(), atol() and atoll() are thread safe with
+ exceptions.
+
+bcmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function bcmp() is thread safe.
+
+bcopy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function bcopy() is thread safe.
+
+bsd_signal.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function bsd_signal() is thread safe.
+
+bzero.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function bzero() is thread safe.
+
+cbrt.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions cbrt(), cbrtf() and cbrtl() are thread safe.
+
+copysign.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions copysign(), copysignf() and copysignl() are thread
+ safe.
+
+cos.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions cos(), cosf() and cosl() are thread safe.
+
+cproj.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions cproj(), cprojf() and cprojl() are thread safe.
+
+creal.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions creal(), crealf() and creall() are thread safe.
+
+daemon.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function daemon() is thread safe.
+
+des_crypt.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ecb_crypt(), cbc_crypt() and des_setparity() are
+ thread safe.
+
+difftime.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function difftime() is thread safe.
+
+dysize.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function dysize() is thread safe.
+
+erf.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions erf(), erff() and erfl() are thread safe.
+
+erfc.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions erfc(), erfcf() and erfcl() are thread safe.
+
+euidaccess.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions euidaccess() and eaccess() are thread safe.
+
+expm1.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions expm1(), expm1f() and expm1l() are thread safe.
+
+fexecve.3
+ Michael Kerrisk
+ POSIX.1-2008 specifies fexecve()
+ Michael Kerrisk
+ Explain the use and rationale of fexecve()
+
+ftime.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function ftime() is thread safe.
+
+ftok.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function ftok() is thread safe.
+
+ftw.3
+ Michael Kerrisk
+ nftw() visits directories with FTW_D if FTW_DEPTH was not specified
+ Michael Kerrisk
+ Explain probable cause of FTW_NS
+
+futimes.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions futimes() and lutimes() are thread safe.
+
+getaddrinfo.3
+ Michael Kerrisk
+ Explain one use case for AI_ADDRCONFIG
+ Michael Kerrisk
+ Highlight difference in ai_flags when hints==NULL
+ NOTES already described how glibc differs from POSIX.
+ Add a pointer to that text from the point in DESCRIPTION
+ where hints==NULL is discussed.
+
+kcmp.3
+ Shawn Landden
+ Reword slightly awkward section
+
+malloc.3
+ Greg Price
+ Scale back promises of alignment
+ It's not true that the return value is suitably aligned for "any
+ variable"; for example, it's unsuitable for a variable like
+ float *x __attribute__ ((__vector_size__ (32)));
+ which requires 32-byte alignment. Types like this are defined in
+ <avxintrin.h>, and with 16-byte alignment in <emmintrin.h> and
+ <xmmintrin.h>, so the application programmer need not even know
+ that a vector_size attribute has been applied.
+
+ On an x86 architecture, a program that loads from or stores to a
+ pointer with this type derived from malloc can crash because GCC
+ generates an aligned load/store, like MOVDQA.
+
+ The C99 standard (TC3, as of N1256) does say the return value is
+ suitably aligned for "any type of object". The C11 standard (as
+ of N1570) revises this to any type with "fundamental alignment",
+ which means an alignment "supported by the implementation in all
+ contexts", which I suppose tautologically includes aligning
+ malloc/realloc return values.
+
+ The actual behavior of current glibc malloc is to align to the
+ greater of 2 * sizeof(size_t) and __alignof__ (long double),
+ which may be one bit greater than this commit promises.
+
+mq_receive.3
+ Michael Kerrisk [janh]
+ msg_len must be greater than *or equal to* mq_msgsize
+ See https://bugzilla.kernel.org/show_bug.cgi?id=64571
+
+setenv.3
+ Michael Kerrisk
+ Clarify that setenv() returns success in the overwrite==0 case
+
+sigsetops.3
+ Michael Kerrisk [Robert P. J. Day]
+ Add 'const' to sigisemptyset(), sigorset(), sigandset() declarations
+ Michael Kerrisk
+ Rework text describing sigisemptyset(), sigorset(), and sigandset()
+
+statvfs.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions statvfs() and fstatvfs() are thread safe.
+
+stdarg.3
+ Peng Haitao
+ ATTRIBUTES: Note macros that are thread-safe
+ The macros va_start(), va_arg(), va_end() and va_copy() are
+ thread safe.
+
+termios.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions tcgetattr(), tcsetattr(), tcsendbreak(),
+ tcdrain(), tcflush(), tcflow(), cfmakeraw(), cfgetispeed(),
+ cfgetospeed(), cfsetispeed(), cfsetospeed() and cfsetspeed()
+ are thread safe.
+
+ungetwc.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function ungetwc() is thread safe.
+
+unlockpt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function unlockpt() is thread safe.
+
+usleep.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function usleep() is thread safe.
+
+wcpcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcpcpy() is thread safe.
+
+wcscasecmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wcscasecmp() is thread safe with exceptions.
+
+wcscat.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcscat() is thread safe.
+
+wcschr.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcschr() is thread safe.
+
+wcscmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcscmp() is thread safe.
+
+wcscpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcscpy() is thread safe.
+
+wcscspn.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcscspn() is thread safe.
+
+wcslen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcslen() is thread safe.
+
+wcsncasecmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wcsncasecmp() is thread safe with exceptions.
+
+wcsncat.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsncat() is thread safe.
+
+wcsncmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsncmp() is thread safe.
+
+wcsncpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsncpy() is thread safe.
+
+wcsnlen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsnlen() is thread safe.
+
+wcspbrk.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcspbrk() is thread safe.
+
+wcsrchr.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsrchr() is thread safe.
+
+wcsspn.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsspn() is thread safe.
+
+wcsstr.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcsstr() is thread safe.
+
+wcstoimax.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions wcstoimax() and wcstoumax() are thread safe with
+ exceptions.
+
+wcstok.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcstok() is thread safe.
+
+wcswidth.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wcswidth() is thread safe with exceptions.
+
+wctrans.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wctrans() is thread safe with exceptions.
+
+wctype.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wctype() is thread safe with exceptions.
+
+wcwidth.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function wcwidth() is thread safe with exceptions.
+
+wmemchr.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wmemchr() is thread safe.
+
+wmemcmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wmemcmp() is thread safe.
+
+wmemcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wmemcpy() is thread safe.
+
+wmemmove.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wmemmove() is thread safe.
+
+wmemset.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wmemset() is thread safe.
+
+tty_ioctl.4
+ Michael Kerrisk [Liu Jiaming]
+ Note that 'arg' should be 0 in the usual case when using TIOCSCTTY
+ Michael Kerrisk
+ Rework text on root to discuss just in terms of capabilities
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/kernel/ngroups_max
+
+capabilities.7
+ Michael Kerrisk
+ Fix 2 version numbers under "Effect of user ID changes on capabilities"
+
+feature_test_macros.7
+ Michael Kerrisk
+ Add _ISOC11_SOURCE to example program
+
+tcp.7
+ Michael Kerrisk
+ Fix (nontrivial) wordo in discussion of MSG_TRUNC
+ s/MSG_PEEK/MSG_TRUNC/
+
+ld.so.8
+ Michael Kerrisk [Alfred Agrell]
+ Fix crufty wording in one sentence
+
+
+==================== Changes in man-pages-3.56 ====================
+
+Released: 2014-01-11, Christchurch
+
+In memory of Doris Church (1939-2013)
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andre Majorel <aym-xunil@teaser.fr>
+Arif Zaman <arifz@lums.edu.pk>
+Bert Wesarg <bert.wesarg@googlemail.com>
+Daniel Borkmann <dborkman@redhat.com>
+David Malcolm <dmalcolm@redhat.com>
+David Prévot <taffit@debian.org>
+Dongsheng Song <dongsheng.song@gmail.com>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+James Smith <james@theta.pw>
+Janne Blomqvist <blomqvist.janne@gmail.com>
+Joseph S. Myers <joseph@codesourcery.com>
+Luke Hutchison <luke.hutch@mit.edu>
+Marco Dione <mdione@grulic.org.ar>
+Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+Mathieu Malaterre <malat@debian.org>
+Matthias Klose <doko@debian.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Moritz 'Morty' Strübe <morty@gmx.net>
+Nadav Har'El <nyh@math.technion.ac.il>
+Ondřej Bílka <neleai@seznam.cz>
+Prádraig Brady <P@draigBrady.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Raphael Geissert <geissert@debian.org>
+Shawn Landden <shawn@churchofgit.com>
+Simon Paillard <spaillard@debian.org>
+Stephen Kell <srk31@srcf.ucam.org>
+Sudhanshu Goswami <Sudhanshu.Goswami@emc.com>
+Sworddragon2 <sworddragon2@aol.com>
+Vince Weaver <vincent.weaver@maine.edu>
+Willem de Bruijn <willemb@google.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+fgetc.3
+gets.3
+ David Malcolm
+ Split gets(3) to isolate unsafe gets(3) to a page on its own
+ Currently man3/gets.3 documents various safe I/O functions, along
+ with the toxic "gets" function.
+
+ At the risk of being melodramatic, this strikes me as akin to
+ storing rat poison in a food cabinet, in the same style of
+ packaging as the food, but with a post-it note on it saying
+ "see warnings below".
+
+ I think such "never use this" functions should be quarantined
+ into their own manpages, rather than listing them alongside
+ sane functions.
+
+ The attached patch does this for "gets", moving the documentation
+ of the good functions from man3/gets.3 into man3/fgetc.3,
+ updating the SO links in the relevant functions to point at the
+ latter.
+
+ It then rewrites man3/gets.3 to spell out that "gets" is toxic
+ and should never be used (with a link to CWE-242 for good
+ measure).
+ Michael Kerrisk [Andre Majorel]
+ Tweaks to David Malcolm's patch
+
+vdso.7
+ Mike Frysinger
+ New page documenting the vDSO mapped into each process by the kernel
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+reboot.2
+ Elie De Brauwer
+ Document LINUX_REBOOT_SW_SUSPEND
+
+
+New and changed links
+---------------------
+
+fgets.3
+getc.3
+getchar.3
+ungetc.3
+ Michael Kerrisk
+ Adjust links to gets(3) to point to fgetc(3)
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix of "NULL pointer"
+ Change "NULL pointer" to "NULL" or null pointer".
+ POSIX uses the term "null pointer", not "NULL pointer".
+
+Various pages
+ Michael Kerrisk
+ Stylistic changes to code example
+ For ease of reading, don't embed assignments inside if().
+
+Various pages
+ Michael Kerrisk
+ Replace uses of "i.e.," in main text with "that is" or similar
+ Usual man-pages style is to use "i.e." only within
+ parenthetical expressions.
+
+Various pages
+ Michael Kerrisk
+ Replace uses of "e.g." in main text with "for example" or similar
+ Usual man-pages style is to use "e.g." only within
+ parenthetical expressions.
+
+Various pages
+ Michael Kerrisk
+ Add "Program source" subheading under EXAMPLE
+
+Various pages
+ Michael Kerrisk
+ Add "static" to global variables and functions in example program
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Michael Kerrisk [Nadav Har'El]
+ Improve description of CLOCK_PROCESS_CPUTIME_ID
+ See https://bugzilla.kernel.org/show_bug.cgi?id=67291
+
+close.2
+ Michael Kerrisk [P?draig Brady]
+ Note that errors from close() should be used only for diagnosis
+ In particular, retrying after EINTR is a bad idea.
+
+ See http://austingroupbugs.net/view.php?id=529
+
+ See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/37702
+ Subject: [RFC][BZ #14627] Make linux close errno to EINPROGRESS
+ when interrupted in signal.
+
+execve.2
+ Michael Kerrisk [Marco Dione]
+ Add further cases to EFAULT error
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=16402
+
+perf_event_open.2
+ Vince Weaver [Sudhanshu Goswami]
+ Clarify issues with the disabled bit
+ Clarify the perf_event_open behavior with respect to the disabled
+ bit and creating event groups.
+ Vince Weaver [Sudhanshu Goswami]
+ Clarify issues with the exclusive bit
+ Warn that using the perf_event_open "exclusive" bit, while
+ it might seem like a good idea, might lead to all 0 results
+ in some common usage cases.
+
+reboot.2
+ Elie De Brauwer
+ Mention RB_POWER_OFF
+ The manpage did not mention RB_POWER_OFF which is the glibc
+ symbolic name for LINUX_REBOOT_CMD_POWER_OFF.
+
+ $ cd /usr/include
+ $ cat x86_64-linux-gnu/sys/reboot.h | grep POWER_OFF
+ define RB_POWER_OFF 0x4321fedc
+ Elie De Brauwer
+ Add "Linux" to kernel version numbers
+ Michael Kerrisk
+ Add RB_SW_SUSPEND synonym
+ Michael Kerrisk
+ Add RB_KEXEC synonym
+
+setpgid.2
+ Michael Kerrisk [Joseph S. Myers]
+ BSD getpgrp() and setpgrp() go away in glibc 2.19
+
+socket.2
+ Michael Kerrisk [Dongsheng Song]
+ Remove crufty statement that AF_INET does not support SOCK_SEQPACKET
+ Linux AF_INET supports SOCK_SEQPACKET via SCTP.
+
+syscall.2
+ Mike Frysinger
+ Fix ia64 registers
+ The original list of registers was created by confusing strace
+ source code--this is for parsing legacy 32-bit code (which is
+ dead and no one cares). Update the list to reflect native ia64
+ syscall interface.
+
+syscall.2
+syscalls.2
+getauxval.3
+ Mike Frysinger
+ Add references to new vdso(7) page
+
+utimensat.2
+ Michael Kerrisk
+ Small wording improvement for times!=NULL case
+
+dlopen.3
+ Michael Kerrisk [Mike Frysinger]
+ Update remarks on cast needed when assigning dlsym() return value
+ POSIX.1-2013 eases life when casting the dlsym() return value to a
+ function pointer
+ Michael Kerrisk [Stephen Kell]
+ Fix description of dli_sname
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=16262
+
+getline.3
+ Michael Kerrisk [Luke Hutchison]
+ Correct description of how '*n' is used when '*lineptr' == NULL
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=5468
+ Michael Kerrisk
+ Remove SEE ALSO reference to unsafe gets(3)
+
+mcheck.3
+ Simon Paillard [Raphael Geissert]
+ typo in compiler flag
+ See http://bugs.debian.org/732464
+
+mkstemp.3
+ Michael Kerrisk [Janne Blomqvist]
+ Better describe 'flags' that can be specified for mkostemp()
+
+printf.3
+ Michael Kerrisk [Arif Zaman]
+ Fix memory leak in snprintf() example
+ See http://stackoverflow.com/questions/19933479/snprintf-man-page-example-memory-leak
+
+pthread_kill.3
+ Michael Kerrisk [Mathieu Desnoyers]
+ POSIX.1-2008 removes ESRCH
+ POSIX.1-2001 mistakenly documented an ESRCH error, and
+ POSIX.1-2008 removes this error. Glibc does return
+ this error in cases where it can determine that a thread ID
+ is invalid, but equally, the use of an invalid thread ID
+ can cause a segmentation fault.
+
+puts.3
+ Michael Kerrisk
+ SEE ALSO: replace reference to gets(3) with fgets(3)
+
+scanf.3
+ Michael Kerrisk [Ondřej Bílka]
+ Improve discussion of obsolete 'a' dynamic allocation modifier
+
+setjmp.3
+ Michael Kerrisk [Joseph S. Myers]
+ BSD setjmp() semantics go away in glibc 2.19
+
+sigpause.3
+ Michael Kerrisk [Joseph S. Myers]
+ BSD sigpause() goes away in glibc 2.19
+ Michael Kerrisk
+ Correct feature text macro requirements
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sigpause() is thread safe.
+
+sigqueue.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sigqueue() is thread safe.
+
+sigwait.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sigwait() is thread safe.
+
+sin.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sin(), sinf() and sinl() are thread safe.
+
+sincos.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sincos(), sincosf() and sincosl() are thread safe.
+
+string.3
+ Moritz 'Morty' Strübe
+ Add short description of the functions
+ It is helpful to have a short description about what the different
+ functions in string.h do.
+ Michael Kerrisk
+ Fixes and enhancements to Moritz Strübe's patch
+
+strptime.3
+ Michael Kerrisk [Mathieu Malaterre, Simon Paillard]
+ Add number ranges to comments in 'tm' structure
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729570
+ Michael Kerrisk
+ Point to ctime(3) for more details on 'tm' structure
+ Michael Kerrisk
+ Some rewording and reorganization
+
+strsep.3
+ Michael Kerrisk
+ Clarify description
+ The use of "symbols" in the existing description is confusing;
+ it's "bytes". Other fixes as well.
+
+strspn.3
+ Michael Kerrisk [Mathieu Malaterre]
+ Improve description in NAME
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=723659
+
+strstr.3
+ Michael Kerrisk
+ Clarify RETURN VALUE: s/substring/located substring/
+
+sysv_signal.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sysv_signal() is thread safe.
+
+tan.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions tan(), tanf() and tanl() are thread safe.
+
+tanh.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions tanh(), tanhf() and tanhl() are thread safe.
+
+toascii.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function toascii() is thread safe.
+
+toupper.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions toupper() and tolower() are thread safe with
+ exceptions.
+
+towctrans.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function towctrans() is thread safe.
+
+towlower.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function towlower() is thread safe with exceptions.
+
+towupper.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function towupper() is thread safe with exceptions.
+
+ualarm.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function ualarm() is thread safe.
+
+wcpncpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function wcpncpy() is thread safe.
+
+proc.5
+ Michael Kerrisk [Sworddragon2]
+ Fix formula for CommitLimit under /proc/meminfo
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60991
+
+credentials.7
+ Michael Kerrisk
+ List APIs that operate on process groups
+ Michael Kerrisk
+ Add details on controlling terminal and foreground/background jobs
+
+feature_test_macros.7
+ Michael Kerrisk
+ Document _DEFAULT_SOURCE
+ Michael Kerrisk [Joseph S. Myers]
+ From glibc 2.19, _BSD_SOURCE no longer causes __FAVOR_BSD
+ Starting with glibc 2.19, _BSD_SOURCE no longer causes BSD
+ definitions to be favored in cases where standards conflict.
+
+libc.7
+ Mike Frysinger
+ SEE ALSO: add various entries
+
+man-pages.7
+ Michael Kerrisk [Mike Frysinger]
+ Add STYLE GUIDE section
+ Incorporate some of the existing material in the page
+ into the STYLE GUIDE, and add a lot more material, mainly
+ drawn from the "Global changes" sections in the release
+ changelogs.
+ Michael Kerrisk
+ Add historical note on reason for use of American spelling
+ Michael Kerrisk [Mike Frysinger]
+ Various improvements to style guide
+
+packet.7
+ Willem de Bruijn [Daniel Borkmann]
+ Document fanout, ring, and auxiliary options
+ This patch adds descriptions of the common packet socket options
+ PACKET_AUXDATA, PACKET_FANOUT, PACKET_RX_RING, PACKET_STATISTICS,
+ PACKET_TX_RING
+ and the ring-specific options
+ PACKET_LOSS, PACKET_RESERVE, PACKET_TIMESTAMP, PACKET_VERSION
+ Michael Kerrisk
+ Add kernel version numbers for PACKET_VERSION and PACKET_TIMESTAMP
+
+ld.so.8
+ Michael Kerrisk [Matthias Klose]
+ Default output file for D_DEBUG is stderr not stdout
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=6874
+
+
+
+==================== Changes in man-pages-3.57 ====================
+
+Released: 2014-01-24, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andi Kleen <andi@firstfloor.org>
+Andre Majorel <aym-xunil@teaser.fr>
+Andrey Vagin <avagin@openvz.org>
+Andy Lutomirski <luto@amacapital.net>
+Axel Beckert <abe@debian.org>
+Bernhard Walle <bernhard@bwalle.de>
+Brandon Edens <bedens@fitbit.com>
+Eliezer Tamir <eliezer.tamir@linux.intel.com>
+Gioele Barabucci <gioele@svario.it>
+Ian Abbott <abbotti@mev.co.uk>
+Jerry Chu <hkchu@google.com>
+Jonas Jonsson <jonas@websystem.se>
+Marc Lehmann <debian-reportbug@plan9.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peng Haitao <penght@cn.fujitsu.com>
+Reuben Thomas <rrt@sc3d.org>
+Simone Piccardi <piccardi@truelite.it>
+Simon Paillard <spaillard@debian.org>
+Thomas Posch <man-pages@online.posch.name>
+Tilman Schmidt <tilman@imap.cc>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+Марк Коренберг <socketpair@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+msgop.2
+ Michael Kerrisk
+ Document MSG_COPY
+
+open.2
+ Michael Kerrisk, Andy Lutomirski
+ Document O_TMPFILE
+ O_TMPFILE is new in Linux 3.11
+
+perf_event_open.2
+ Vince Weaver [Andi Kleen]
+ PERF_SAMPLE_TRANSACTION support in Linux 3.13
+ The following patch adds descriptions of the new perf_event_open.2
+ PERF_SAMPLE_TRANSACTION sample type as added in Linux 3.13.
+
+ The descriptions are based on information provided by Andi Kleen,
+ both in the e-mail
+
+ [PATCH 1/6] perf, core: Add generic transaction flags v5
+
+ sent to the linux-kernel list as well as an e-mail
+
+ [PATCH] Document transaction flags in perf_event_open manpage
+
+ sent to the linux-man list.
+
+ The implementation is based heavily on the Intel Haswell
+ processor. Documentation can be found at this page:
+ http://software.intel.com/en-us/blogs/2013/05/03/intelr-transactional-synchronization-extensions-intelr-tsx-profiling-with-linux-0
+ as well as in section 18.11.5.1 of volume 3 of the
+ Intel 64 and IA-32 Architecture Software Developer's Manual.
+
+ptrace.2
+ Andrey Vagin
+ Add description for PTRACE_PEEKSIGINFO
+ Retrieve signals without removing them from a queue.
+ Andrey Vagin
+ Add description for PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
+ These two commands allow to examine and change mask of blocked
+ signals.
+
+socket.7
+ Eliezer Tamir
+ Add description for SO_BUSY_POLL
+ Add description for the SO_BUSY_POLL socket option.
+
+tcp.7
+ Michael Kerrisk [Jerry Chu]
+ Document TCP_USER_TIMEOUT
+ Text slightly adapted from Jerry Chu's (excellent) commit
+ message (commit dca43c75e7e545694a9dd6288553f55c53e2a3a3).
+ Michael Kerrisk
+ Document TCP_CONGESTION
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Reword to avoid use of "etc."
+
+Various pages
+ Peng Haitao [Andre Majorel]
+ Make wording around thread-safety and setlocale() more precise
+
+getdate.3
+strptime.3
+locale.5
+ Michael Kerrisk
+ Replace "weekday" with less ambiguous language
+ Notwithstanding POSIX's use of the term "weekday", in everyday
+ English, "weekday" is commonly understood to mean a day in the
+ set [Monday..Friday] (vs one of the "weekend" days).
+
+
+Changes to individual pages
+---------------------------
+
+epoll_wait.2
+ Michael Kerrisk [Jonas Jonsson]
+ Clarify wording of EINTR error
+ See https://bugzilla.kernel.org/show_bug.cgi?id=66571
+
+faccessat.2
+ Michael Kerrisk
+ Note that the system call takes only three arguments
+
+fallocate.2
+ Michael Kerrisk
+ Note filesystems that support FALLOC_FL_PUNCH_HOLE operation
+
+fcntl.2
+ Michael Kerrisk
+ BUGS: The O_SYNC and O_DSYNC flags are not modifiable using F_SETFL
+ Michael Kerrisk
+ Add susbsections under BUGS
+ There's several bugs listed. It's helpful to mark
+ them separately.
+ Michael Kerrisk
+ POSIX.1 specifies F_SETOWN and F_GETOWN for sockets/SIGURG
+
+getrlimit.2
+ Michael Kerrisk [Марк Коренберг]
+ Note that rlim_cur can be set lower than current resource consumption
+
+getsockopt.2
+ Michael Kerrisk
+ SEE ALSO: add ip(7) and udp(7)
+
+keyctl.2
+ Michael Kerrisk
+ SEE ALSO: mention Documentation/security/keys.txt
+
+linkat.2
+ Michael Kerrisk
+ Add ENOENT for O_TMPFILE created with O_EXCL
+ Michael Kerrisk
+ ERRORS: Add EINVAL
+
+lseek.2
+ Michael Kerrisk
+ Note which filesystems support SEEK_HOLE/SEEK_DATA
+
+msgop.2
+ Michael Kerrisk
+ Note that MSG_EXCEPT is Linux-specific
+
+open.2
+ Michael Kerrisk
+ Update CONFORMING TO
+ Add POSIX.1-2008. Add mention of O_TMPFILE.
+ Update text on various flags that were added in POSIX.1-2008, and
+ whose definitions can, since glibc 2.12, be obtained by suitably
+ defining _POSIX_C_SOURCE or _XOPEN_SOURCE
+ Michael Kerrisk
+ Add pointer in description to BUGS, for O_ASYNC limitation
+ Michael Kerrisk
+ Remove crufty duplicate text on modifying file status flags
+
+ptrace.2
+ Michael Kerrisk
+ Add details to descriptions of PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
+
+select.2
+ Michael Kerrisk [Marc Lehmann]
+ RETURN VALUE: Fix discussion of treatment of file descriptor sets
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=574370
+
+syscalls.2
+ Michael Kerrisk
+ Remove madvise1() from main list
+ madvise1() is one of the system calls that was never
+ implemented, and listed toward the bottom of the page.
+
+timer_create.2
+ Michael Kerrisk
+ Add pointer to proc(5) for info on /proc/[pid]/timers
+
+unlinkat.2
+ Michael Kerrisk [Mike Frysinger:]
+ ERRORS: Add EISDIR
+ See https://bugzilla.kernel.org/show_bug.cgi?id=29702
+
+ferror.3
+ Michael Kerrisk
+ clearerr(), feof(), and ferror() are also POSIX-conformant
+ Michael Kerrisk [Reuben Thomas]
+ CONFORMING TO: add fileno()
+
+gets.3
+ Ian Abbott
+ SEE ALSO: add fgets(3)
+
+mq_receive.3
+mq_send.3
+ Michael Kerrisk [Simone Piccardi]
+ SYNOPSIS: s/unsigned/unsigned int/
+
+printf.3
+ Michael Kerrisk
+ Small reorganization of text in EXAMPLE
+
+rand.3
+ Michael Kerrisk
+ s/unsigned/unsigned int/ in example
+
+stpcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function stpcpy() is thread safe.
+
+stpncpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function stpncpy() is thread safe.
+
+strcat.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions strcat() and strncat() are thread safe.
+
+strchr.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions strchr(), strrchr() and strchrnul() are thread safe.
+
+strcmp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions strcmp() and strncmp() are thread safe.
+
+strftime.3
+ Brandon Edens
+ Change "week day" to "day of week"
+ See https://bugzilla.kernel.org/show_bug.cgi?id=68861
+
+strstr.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function strstr() is thread safe.
+ The function strcasestr() is thread safe with exceptions.
+
+strtod.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions strtod(), strtof() and strtold() are thread safe
+ with exceptions.
+
+strtoimax.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions strtoimax() and strtoumax() are thread safe with
+ exceptions.
+
+strtol.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions strtol(), strtoll() and strtoq() are thread safe
+ with exceptions.
+
+tcgetpgrp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions tcgetpgrp() and tcsetpgrp() are thread safe.
+
+tcgetsid.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function tcgetsid() is thread safe.
+
+core.5
+ Bernhard Walle
+ Mention that %E exists since Linux 3.0
+ '%E' in the 'core_pattern' has been introduced in kernel commit
+ 57cc083ad9e1bfeeb4a0ee831e7bb008c8865bf0 which was included in
+ version 3.0. Add that information to the manual page.
+
+filesystems.5
+ Michael Kerrisk [Axel Beckert]
+ Add reference to proc(5) for more details on /proc/filesystems
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=735590
+
+locale.5
+ Michael Kerrisk
+ SEE ALSO: add locale(7)
+
+proc.5
+ Michael Kerrisk
+ Document /proc/[pid]/timers
+ Michael Kerrisk
+ Update discussion of wchan
+ Remove crufty reference to /etc/psdatabase in /proc/PID/stat.
+ Add /proc/PID/wchan.
+
+ See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/737452
+
+environ.7
+ Michael Kerrisk [Gioele Barabucci]
+ Correct reference to locale(7) (not locale(5))
+ locale(7) is the right place for details of the LC_*
+ environment variables.
+
+ See http://bugs.debian.org/638186
+ Michael Kerrisk
+ Improve references for discussion of locale environment variables
+ Michael Kerrisk
+ SEE ALSO: add catopen(3)
+ Michael Kerrisk
+ SEE ALSO: add locale(5)
+
+man-pages.7
+ Michael Kerrisk
+ Prefer "usable" over "useable"
+
+netdevice.7
+ Tilman Schmidt
+ Document SIOCGIFCONF case ifc_req==NULL
+ Add the missing description of the possibility to call SIOCGIFCONF
+ with ifc_req==NULL to determine the needed buffer size, as
+ described in
+ http://lkml.indiana.edu/hypermail/linux/kernel/0110.1/0506.html
+ and verified against source files net/core/dev_ioctl.c and
+ net/ipv4/devinet.c in the current kernel git tree.
+ This functionality has been present since the beginning of the 2.6
+ series. It's about time it gets documented.
+
+ While I'm at it, also generally clarify the section on
+ SIOCGIFCONF.
+
+standards.7
+ Michael Kerrisk
+ Enhance description of V7
+ Michael Kerrisk
+ Add C11
+
+tcp.7
+ Michael Kerrisk
+ Describe format of tcp_*_congestion_control /proc files
+ Describe format of tcp_allowed_congestion_control and
+ tcp_available_congestion_control.
+
+
+==================== Changes in man-pages-3.58 ====================
+
+Released: 2014-02-11, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Cyril Hrubis <chrubis@suse.cz>
+Daniel Borkmann <dborkman@redhat.com>
+David Prévot <taffit@debian.org>
+Fabrice Bauzac <libnoon@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Network Nut <sillystack@gmail.com>
+Ola Olsson <ola1olsson@gmail.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Schiffer <pschiffe@redhat.com>
+Simone Piccardi <piccardi@truelite.it>
+Simon Paillard <spaillard@debian.org>
+Yuri Kozlov <yuray@komyakino.ru>
+Марк Коренберг <socketpair@gmail.com>
+未卷起的浪 <ayjj_8109@qq.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+pipe.2
+ Michael Kerrisk
+ Document the pipe2() O_DIRECT flag added in Linux 3.4
+
+packet.7
+ Daniel Borkmann
+ Document PACKET_QDISC_BYPASS
+ New in Linux 3.14.
+
+
+Global changes
+--------------
+
+Various pages
+ Simon Paillard
+ Formatting fix: add space between function and () if BR or IR
+ Detected through the regex:
+ git grep -P '^\.(BR|IR) [\w]*\([\d]*\)$'
+
+Various pages
+ Simon Paillard
+ Formatting fix: add space between word and punctuation if BR or IR
+ Detected through the regex:
+ git grep -P '^\.(BR|IR) [^ ]*[,\.]$'
+
+ Could probably be extended to match more cases and fix in perl.
+
+Various pages
+ Michael Kerrisk
+ Use Oxford comma
+
+gettid.2
+restart_syscall.2
+passwd.5
+socket.7
+ Michael Kerrisk
+ Fix order of SEE ALSO entries
+
+
+Changes to individual pages
+---------------------------
+
+epoll_wait.2
+ Michael Kerrisk [Network Nut]
+ Remove word "minimum" from the description of 'timeout'
+
+epoll_wait.2
+poll.2
+select.2
+ Michael Kerrisk
+ Go into more detail on timeout and when call will cease blocking
+
+getxattr.2
+listxattr.2
+removexattr.2
+setxattr.2
+ Michael Kerrisk [Fabrice Bauzac]
+ Correct header file is <sys/xattr.h> (not <xattr/xattr.h>)
+ See https://bugzilla.kernel.org/show_bug.cgi?id=70141
+
+msgctl.2
+ Cyril Hrubis
+ Add note about ignored arg to IPC_RMID
+
+prctl.2
+ Michael Kerrisk [Марк Коренберг]
+ PR_SET_PDEATHSIG value is preserved across execve(2)
+
+recv.2
+ Michael Kerrisk
+ Rework and reorganize the text in various parts of the page.
+ Isolate details specific to recv() vs recvfrom() vs recvmsg()
+ Place details specific to each system call under a
+ a separate subheading.
+ Rework discussion of 'src_addr' and 'addrlen' for recvfrom()
+ Add description of 'buf' and 'len' in recvfrom() section
+ 'addrlen' should be 0 (*not* NULL) when 'src_addr' is NULL
+ Improve text describing recvfrom() call that is equivalent to recv()
+ Michael Kerrisk [未卷起的浪]
+ Describe the various cases where the return value can be 0
+
+shmctl.2
+ Michael Kerrisk
+ Note that 'buf' is ignored for IPC_RMID
+
+symlinkat.2
+ Michael Kerrisk
+ Make argument names consistent with symlink(2) page
+
+isalpha.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions isalnum(), isalpha(), isascii(), isblank(),
+ iscntrl(), isdigit(), isgraph(), islower(), isprint(),
+ ispunct(), isspace(), isupper() and isxdigit() are thread safe.
+
+isatty.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function isatty() is thread safe.
+
+isgreater.3
+ Peng Haitao
+ ATTRIBUTES: Note macros that are thread-safe
+ The macros isgreater(), isgreaterequal(), isless(),
+ islessequal(), islessgreater() and isunordered() are thread safe.
+
+iswalnum.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function iswalnum() is thread safe with exceptions.
+
+iswalpha.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function iswalpha() is thread safe with exceptions.
+
+iswblank.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function iswblank() is thread safe with exceptions.
+
+iswcntrl.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread safe with exceptions
+ The function iswcntrl() is thread safe with exceptions.
+
+lockf.3
+ Michael Kerrisk [Simone Piccardi]
+ Fix incorrect argument mentioned under EINVAL error
+
+pthread_kill.3
+ Michael Kerrisk
+ Add feature test macro requirements
+
+pthread_sigmask.3
+ Michael Kerrisk
+ Add feature test macro requirements
+
+strtoul.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread safe with exceptions
+ The functions strtoul(), strtoull() and strtouq() are thread safe
+ with exceptions.
+
+nscd.conf.5
+ Peter Schiffer
+ Add note about default values
+
+proc.5
+ Michael Kerrisk
+ SEE ALSO: Add some further kernel Documentation/sysctl files
+
+man-pages.7
+ Michael Kerrisk
+ ATTRIBUTES sections come after VERSIONS
+ Peng Haitao has consistently ordered the ATTRIBUTES after
+ VERSIONS, so adjust the text in man-pages.7
+
+vdso.7
+ Michael Kerrisk
+ Add words "virtual dynamic shared object" in DESCRIPTION
+
+
+==================== Changes in man-pages-3.59 ====================
+
+Released: 2014-02-16, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Michael Kerrisk <mtk.manpages@gmail.com>
+Peter Schiffer <pschiffe@redhat.com>
+Weizhou Pan <cs.wzpan@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Global changes
+--------------
+
+Various pages
+ Peter Schiffer, Michael Kerrisk [Weizhou Pan]
+ Convert pages containing non-ASCII in source code comments to use UTF-8
+ Done using a slightly modified version of Peter Schiffer's
+ convert_to_utf_8.sh script. The script was modified so as *not*
+ a "coding:" marker to the groff source. For now, we'll only put
+ that marker on pages that contain non-ASCII characters in the
+ rendered text.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60807
+
+armscii-8.7
+cp1251.7
+iso_8859-1.7
+iso_8859-10.7
+iso_8859-11.7
+iso_8859-13.7
+iso_8859-14.7
+iso_8859-15.7
+iso_8859-16.7
+iso_8859-2.7
+iso_8859-3.7
+iso_8859-4.7
+iso_8859-5.7
+iso_8859-6.7
+iso_8859-7.7
+iso_8859-8.7
+iso_8859-9.7
+koi8-r.7
+koi8-u.7
+ Peter Schiffer, Michael Kerrisk [Weizhou Pan]
+ Convert pages containing non-ASCII to use UTF-8
+ Done using Peter Schiffer's convert_to_utf_8.sh script.
+ These pages containing non-ASCII in the rendered characters, and
+ so the script inserts a "coding:" marker into the groff source.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=60807
+
+
+==================== Changes in man-pages-3.60 ====================
+
+Released: 2014-02-18, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Kalle Olavi Niemitalo <kon@iki.fi>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Simon Paillard <spaillard@debian.org>
+
+Apologies if I missed anyone!
+
+
+Changes to individual pages
+---------------------------
+sigvec.3
+ Michael Kerrisk [Kalle Olavi Niemitalo]
+ Fix error in code snippet
+ s/sigpause/sigmask/
+
+armscii-8.7
+cp1251.7
+iso_8859-1.7
+iso_8859-10.7
+iso_8859-11.7
+iso_8859-13.7
+iso_8859-14.7
+iso_8859-15.7
+iso_8859-16.7
+iso_8859-2.7
+iso_8859-3.7
+iso_8859-4.7
+iso_8859-5.7
+iso_8859-6.7
+iso_8859-7.7
+iso_8859-8.7
+iso_8859-9.7
+koi8-u.7
+ Michael Kerrisk [Simon Paillard]
+ Remove comment that glyphs in column 4 may not display correctly
+ With the conversion to UTF-8, the glyphs in column 4 of the
+ tables in these pages will display regardless of whether the
+ environment is configured for the corresponding character set.
+
+iso_8859-11.7
+iso_8859-13.7
+ D. Barbier [Simon Paillard]
+ Fix encoding mistakes in 5f7f4042b8848127d852c6fa7c02e31ccfaeeae5
+ Fixed via:
+
+ for f in iso_8859-11 iso_8859-13; do
+ cp man7/$f.7 $f
+ iconv -f utf8 -t latin1 $f | iconv -f iso-${f#iso_} -t utf8 > man7/$f.7
+ done
+
+
+
+
+==================== Changes in man-pages-3.61 ====================
+
+Released: 2014-02-26, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andrew Hunter <ahh@google.com>
+Carlos O'Donell <carlos@redhat.com>
+Christoph Hellwig <hch@infradead.org>
+Daniel Borkmann <dborkman@redhat.com>
+Duncan de Wet <duncandewet@gmail.com>
+Kir Kolyshkin <kir@openvz.org>
+KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Neil Horman <nhorman@tuxdriver.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Simon Paillard <spaillard@debian.org>
+Sulaiman Mustafa <seininn@hush.com>
+Xiawei Chen <chenxiawei@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+A note from Christoph Hellwig prompted me to perform a task that has
+been queued for a while: merging the text of the man pages for the
+*at([23]) ("directory file descriptor") APIs into their corresponding
+traditional pages. When the *at([23]) pages were originally written
+(mostly in 2006), the APIs were not part of POSIX and (in most cases)
+were not available on other systems. So, it made some sense to wall
+them off into their own separate pages. Eight years later, with the
+APIs now all in POSIX (except scandirat()), it is much more sensible
+to document the newer APIs alongside their traditional counterparts,
+so that the newer APIs are not "hidden", and the reader can more
+easily see the differences between the APIs.
+
+Thus, the text of 14 pairs of pages has been merged, and the "merged
+from" pages have been converted to links to the "merged to" pages.
+Along the way, a few other fixes were made to the pages, as noted
+below.
+
+One page that did not undergo such a change was utimensat(2), which
+is different enough from utime(2) that it warrants a separate page.
+Unlike the other *at() pages, the utimensat(2) page was also already
+self-contained, rather than defining itself in terms of differences
+from utime(2) as the other *at() pages did.
+
+access.2
+ Michael Kerrisk
+ Merge text from faccessat(2)
+ Michael Kerrisk
+ Remove faccessat() race warning
+ That point is already covered in existing text in this page.
+ Michael Kerrisk
+ access() also conforms to POSIX.1-2008
+
+chmod.2
+ Michael Kerrisk
+ Merge text from fchmodat(2)
+ Michael Kerrisk
+ Use argument name 'pathname' throughout page
+ (Some APIs were using 'path' while others used 'pathname')
+ Michael Kerrisk
+ CONFORMING TO: chmod() and fchmod() are also in POSIX.1-2008
+
+chown.2
+ Michael Kerrisk
+ Merge text of fchownat(2)
+ Michael Kerrisk
+ AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE
+ Michael Kerrisk
+ Use argument name 'pathname' throughout page
+ (Some APIs were using 'path' while others used 'pathname')
+ Michael Kerrisk
+ Remove sentence that fchownat() is present on Solaris
+ That point was only really relevant before fchownat() was
+ standardized in POSIX.1.2008.
+ Michael Kerrisk
+ CONFORMING TO: chown(), fchown(), lchown() are in POSIX.1-2008
+
+link.2
+ Michael Kerrisk
+ Merge text of linkat(2)
+ Michael Kerrisk
+ CONFORMING TO: link() is in POSIX.1-2008
+ Michael Kerrisk
+ AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE
+
+mkdir.2
+ Michael Kerrisk
+ Merge text of mkdirat(2)
+ Michael Kerrisk
+ CONFORMING TO: mkdir() is in POSIX.1-2008
+
+mknod.2
+ Michael Kerrisk
+ Merge text of mknodat(2)
+ Michael Kerrisk
+ CONFORMING TO: mknod(2) is in POSIX.1-2008
+
+open.2
+ Michael Kerrisk
+ Merge text from openat(2)
+ Michael Kerrisk
+ Remove sentence that openat() is present on Solaris
+ That point was only really relevant before openat() was
+ standardized in POSIX.1.2008.
+
+readlink.2
+ Michael Kerrisk
+ Merge text of readlinkat(2)
+ Michael Kerrisk
+ CONFORMING TO: readlink() is in POSIX.1-2008.
+ Michael Kerrisk
+ Use argument name 'pathname' throughout page
+ (Some APIs were using 'path' while others used 'pathname')
+
+rename.2
+ Michael Kerrisk
+ Merge text of renameat(2)
+ Michael Kerrisk
+ CONFORMING TO: rename(2) is in POSIX.1-2008
+
+stat.2
+ Michael Kerrisk
+ Merge text from fstatat(2)
+ Michael Kerrisk
+ AT_EMPTY_PATH and AT_NO_AUTOMOUNT are Linux-specific
+ These flags require _GNU_SOURCE.
+ Michael Kerrisk
+ Use argument name 'pathname' throughout page
+ (Some APIs were using 'path' while others used 'pathname')
+ Michael Kerrisk
+ Remove sentence that fstatat() is present on Solaris
+ That point was only really relevant before fstatat() was
+ standardized in POSIX.1.2008.
+ Michael Kerrisk
+ CONFORMING TO: stat(), fstat(), lstat() are specified in POSIX.1-2008
+
+symlink.2
+ Michael Kerrisk
+ Merge text of symlinkat(2)
+ Michael Kerrisk
+ CONFORMING TO: symlink() is in POSIX.1-2008
+
+unlink.2
+ Michael Kerrisk
+ Merge text of unlinkat(2)
+ Michael Kerrisk
+ Remove sentence that unlinkat() is present on Solaris
+ That point was only really relevant before unlinkat() was
+ standardized in POSIX.1.2008.
+ Michael Kerrisk
+ CONFORMING TO: unlink() is in POSIX.1-2008
+
+mkfifo.3
+ Michael Kerrisk
+ Merge text of mkfifoat(3)
+ Michael Kerrisk
+ CONFORMING TO: mkfifo() is in POSIX.1-2008
+
+scandir.3
+ Michael Kerrisk
+ Merge text of scandirat(3)
+ Michael Kerrisk
+ Update feature test macro requirements
+ The FTM requirements changed in glibc 2.10.
+ Michael Kerrisk
+ Remove libc4/libc5 note under CONFORMING TO
+ No-one much cares about Linux libc these days.
+ Michael Kerrisk
+ Put detail about alphasort under a NOTES heading
+ This text was under CONFORMING TO, which made no sense.
+ Michael Kerrisk
+ Rework CONFORMING TO text
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+prctl.2
+ Kir Kolyshkin
+ Document PR_SET_MM options in Linux 3.5
+ Some of the PR_SET_MM options were merged to vanilla kernel
+ later, and appeared in Linux 3.5. Those are:
+
+ - PR_SET_MM_ARG_START
+ - PR_SET_MM_ARG_END
+ - PR_SET_MM_ENV_START
+ - PR_SET_MM_ENV_END
+ - PR_SET_MM_AUXV
+ - PR_SET_MM_EXE_FILE
+
+socket.7
+ Neil Horman
+ Document the SO_RXQ_OVFL socket option
+ Michael Kerrisk
+ Add kernel version number for SO_RXQ_OVFL
+
+
+New and changed links
+---------------------
+
+faccessat.2
+ Michael Kerrisk
+ Convert to link to access.2
+
+fchmodat.2
+ Michael Kerrisk
+ Convert to link to chmod.2
+
+fchownat.2
+ Michael Kerrisk
+ Convert to link to chown.2
+
+fstatat.2
+ Michael Kerrisk
+ Convert to link to stat.2
+
+linkat.2
+ Michael Kerrisk
+ Convert to link to link.2
+
+mkdirat.2
+ Michael Kerrisk
+ Convert to link to mkdir.2
+
+mknodat.2
+ Michael Kerrisk
+ Convert to link to mknod.2
+
+openat.2
+ Michael Kerrisk
+ Convert to link to open.2
+
+readlinkat.2
+ Michael Kerrisk
+ Convert to link to symlink.2
+
+renameat.2
+ Michael Kerrisk
+ Convert to link rename.2
+
+symlinkat.2
+ Michael Kerrisk
+ Convert to link to symlink.2
+
+unlinkat.2
+ Michael Kerrisk
+ Convert to link to unlink.2
+
+mkfifoat.3
+ Michael Kerrisk
+ Convert to link to mkfifo.3
+
+scandirat.3
+ Michael Kerrisk
+ Convert to link to scandir.3
+
+
+Changes to individual pages
+---------------------------
+
+alarm.2
+ Michael Kerrisk
+ Note semantics of alarm with respect to fork() and execve()
+
+fcntl.2
+ Michael Kerrisk
+ Warn that F_GETLK info may already be out of date when the call returns
+
+intro.2
+ Michael Kerrisk
+ Describe policy on documenting differences between syscall and glibc API
+
+mmap2.2
+ Michael Kerrisk
+ Reword note on glibc mmap() wrapper invocation of mmap2()
+ Michael Kerrisk
+ This system call does not exist on x86-64
+
+msgctl.2
+ Michael Kerrisk
+ ERRORS: add EPERM for unprivileged attempt to set msg_qbytes > MSGMNB
+
+prctl.2
+ Michael Kerrisk [Xiawei Chen]
+ Clarify that PR_GET_TIMERSLACK is returned as the function result
+ Michael Kerrisk
+ Clarify that PR_GET_SECCOMP is returned as function result
+ Michael Kerrisk
+ Clarify that PR_GET_NO_NEW_PRIVS is returned as function result
+
+ptrace.2
+ Michael Kerrisk [Andrew Hunter]
+ Make it clearer that glibc and syscall APIs differ for PTRACE_PEEK*
+ Thanks to Denys Vlasenko's additions in 78686915aed6bd12
+ this page does note that the glibc API for PTRACE_PEEK*
+ differs from the raw syscall interface. But, as the report
+ at https://bugzilla.kernel.org/show_bug.cgi?id=70801 shows,
+ this information could be more obvious. This patch makes its so.
+
+sgetmask.2
+ Michael Kerrisk
+ Note that these system calls don't exist on x86-64
+
+swapon.2
+ Michael Kerrisk
+ Split EINVAL cases into separate entries under ERRORS
+ Michael Kerrisk
+ Add EINVAL error for invalid flags to swapon()
+
+syscalls.2
+ Michael Kerrisk
+ SEE ALSO: add intro(2)
+
+umount.2
+ Michael Kerrisk
+ Split EINVAL cases into separate items
+ Michael Kerrisk
+ ERRORS: Add EINVAL case that was new in 2.6.34
+
+utime.2
+ Michael Kerrisk
+ Add note that modern applications probably want utimensat(2) etc.
+
+crypt.3
+ Michael Kerrisk [KOSAKI Motohiro]
+ ERRORS: Add EINVAL and EPERM errors
+ See https://bugzilla.kernel.org/show_bug.cgi?id=69771
+
+getifaddrs.3
+ Michael Kerrisk
+ Enhance example program
+ Print statistics for AF_PACKET interfaces.
+ Add missing feature test macro definition.
+ Reformat output.
+
+iswctype.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function iswctype() is thread safe.
+
+sem_post.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sem_post() is thread safe.
+
+sem_unlink.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sem_unlink() is thread safe.
+
+sem_wait.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sem_wait(), sem_trywait() and sem_timedwait() are
+ thread safe.
+
+setbuf.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions setbuf(), setbuffer(), setlinebuf() and setvbuf()
+ are thread safe.
+
+strlen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function strlen() is thread safe.
+
+strnlen.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function strnlen() is thread safe.
+
+strpbrk.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function strpbrk() is thread safe.
+
+strsep.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function strsep() is thread safe.
+
+swab.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function swab() is thread safe.
+
+resolv.conf.5
+ Carlos O'Donell
+ DESCRIPTION: mention that the data is trusted
+ In a recent discussion about DNSSEC it was brought to my
+ attention that not all system administrators may understand
+ that the information in /etc/resolv.conf is fully trusted.
+ The resolver implementation in glibc treats /etc/resolv.conf
+ as a fully trusted source of DNS information and passes on
+ the AD-bit for DNSSEC as trusted.
+
+ This patch adds a clarifying sentence to make it absolutely
+ clear that indeed this source of information is trusted.
+
+ascii.7
+ Michael Kerrisk [Sulaiman Mustafa]
+ Fix rendering of single quote (decimal character 39)
+ Michael Kerrisk
+ SEE ALSO: add utf-8(7)
+ Michael Kerrisk [Duncan de Wet]
+ Remove mention of ISO 8859-1 as being the default encoding on Linux
+
+packet.7
+ Neil Horman
+ Document PACKET_FANOUT_QM fanout mode
+ Michael Kerrisk
+ Add kernel version for PACKET_FANOUT_QM
+ Daniel Borkmann
+ Improve PACKET_QDISC_BYPASS description
+
+socket.7
+ Michael Kerrisk
+ Add kernel version number for SO_BUSY_POLL
+
+
+==================== Changes in man-pages-3.62 ====================
+
+Released: 2014-03-11, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Cyril Hrubis <chrubis@suse.cz>
+Joseph S. Myers <joseph@codesourcery.com>
+Marius Gaubas <marius@livejournalinc.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peng Haitao <penght@cn.fujitsu.com>
+Rick Stanley <rstanley@rsiny.com>
+Simon Paillard <spaillard@debian.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+locale.1
+ Michael Kerrisk [review from Mike Frysinger]
+ New page describing locale(1)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+locale.5
+ Michael Kerrisk
+ Document LC_ADDRESS
+ Michael Kerrisk
+ Document LC_IDENTIFICATION
+ Michael Kerrisk
+ Document LC_MEASUREMENT
+ Michael Kerrisk
+ Document LC_NAME
+ Michael Kerrisk
+ Document LC_PAPER
+ Michael Kerrisk
+ Document LC_TELEPHONE
+
+
+Removed Pages
+-------------
+
+sync.8
+ Michael Kerrisk [Christoph Hellwig, Pádraig Brady]
+ Sometime in the 20th century (before my watch), a sync(8)
+ page into man-pages. It documents the sync command from
+ "fileutils", which long ago become coreutils, and the
+ piece under NOTES note some behavior of sync(2)
+ that ceased to be true many years ago. The man-pages
+ project generally focuses on only Linux kernel and
+ (g)libc interfaces, so this sync(8) page doesn't really
+ belong. Furthermore, coreutils has a sync(1) page which
+ covers the same command. After dicussions on the
+ coreutils list, I've decided to retire this page from
+ man-pages.
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Note that CLONE_THREAD also in effect requires CLONE_VM
+
+stat.2
+ Michael Kerrisk [Marius Gaubas]
+ Warn the reader that the 'stat' structure definition is not precise
+ Padding fields aren't shown, and the order of fields varies
+ somewhat across architectures.
+
+gethostbyname.3
+ Michael Kerrisk
+ Remove redundant FTM requirements
+ _GNU_SOURCE implies _SVID_SOURCE and _BSD_SOURCE, so
+
+ _BSD_SOURCE || _SVID_SOURCE || _GNU_SOURCE
+
+ is the same as
+
+ _BSD_SOURCE || _SVID_SOURCE
+
+getutmp.3
+ Michael Kerrisk
+ SEE ALSO: add utmpdump(1)
+
+log1p.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions log1p(), log1pf() and log1pl() are thread safe.
+
+logb.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions logb(), logbf() and logbl() are thread safe.
+
+memccpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memccpy() is thread safe.
+
+memchr.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions memchr(), memrchr() and rawmemchr() are thread safe.
+
+mktemp.3
+ Michael Kerrisk
+ Make warning not to use this function more prominent
+
+qecvt.3
+ Michael Kerrisk [Joseph S. Myers]
+ Recommend snprintf(3) not sprintf(3)
+
+raise.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function raise() is thread safe.
+
+remove.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function remove() is thread safe.
+
+sem_destroy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sem_destroy() is thread safe.
+
+sem_getvalue.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sem_getvalue() is thread safe.
+
+sem_init.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sem_init() is thread safe.
+
+sockatmark.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sockatmark() is thread safe.
+
+strcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions strcpy() and strncpy() are thread safe.
+ Michael Kerrisk [Rick Stanley]
+ Fix a bug, and improve discussion of forcing termination with strncpy()
+
+strspn.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions strspn() and strcspn() are thread safe.
+
+tempnam.3
+ Michael Kerrisk
+ Make warning not to use this function more prominent
+
+tmpnam.3
+ Michael Kerrisk
+ Recommend use mkstemp(3) or tmpfile(3) instead
+
+locale.5
+ Michael Kerrisk
+ Add intro section that lists all of the LC categories
+ Michael Kerrisk
+ 'p_cs_precedes' is for *positive* values
+ Michael Kerrisk
+ Clarify 'p_sign_posn' and 'n_sign_posn'; simplify 'n_sign_posn'
+ Add initial sentence for 'p_sign_posn' and 'n_sign_posn'.
+ Remove repeated list for 'n_sign_posn'.
+ Michael Kerrisk
+ Document LC_MESSAGES 'yesstr' and 'nostr'
+ Michael Kerrisk
+ Clarify LC_MONETARY 'n_cs_precedes'
+ Michael Kerrisk
+ LC_MONETARY: Document 'int_p_sign_posn' and 'int_n_sign_posn'
+ Michael Kerrisk
+ Clarify/rework 'p_cs_precedes' and 'n_cs_precedes'
+ Michael Kerrisk
+ LC_MONETARY: document 'int_p_sep_by_space' and 'int_n_sep_by_space'
+ Michael Kerrisk
+ Remove crufty reference to POSIX.2
+ Michael Kerrisk
+ LC_MONETARY: document 'int_p_cs_precedes' and 'int_n_cs_precedes'
+ Michael Kerrisk
+ Clarify/simplify 'n_sep_by_space'
+ Michael Kerrisk
+ LC_TIME: document 'cal_direction' and 'date_fmt'
+ Michael Kerrisk
+ Clarify 'p_sep_by_space'
+
+feature_test_macros.7
+ Michael Kerrisk
+ _BSD_SOURCE and _SVID_SOURCE are deprecated in glibc 2.20
+ Michael Kerrisk
+ _GNU_SOURCE implicitly defines other macros
+ Saying that _GNU_SOURCE has the "effects of" other macros is not
+ quite precise.
+ Michael Kerrisk
+ Reword glibc version for _ISOC95_SOURCE
+ Michael Kerrisk
+ _ISOC99_SOURCE also exposes C95 definitions
+ Michael Kerrisk
+ _ISOC11_SOURCE implies the effects of _ISOC99_SOURCE
+ Michael Kerrisk
+ Note version number for _POSIX_C_SOURCE >= 200112L implies C99/C95
+ _POSIX_C_SOURCE >= 200112L causes C95 definitions to be
+ exposed only since glibc 2.12 and C99 definitions only
+ since 2.10.
+ Michael Kerrisk
+ _XOPEN_SOURCE may implicitly define _POSIX_SOURCE and _POSIX_C_SOURCE
+ Michael Kerrisk
+ Reword glibc version for _ISOC99_SOURCE
+ Michael Kerrisk
+ Rework discussion of _ISOC99_SOURCE
+ Michael Kerrisk
+ Improve discussion of _DEFAULT_SOURCE
+ Michael Kerrisk
+ _POSIX_C_SOURCE >= 200112L implies C95 and C95 features
+
+
+
+==================== Changes in man-pages-3.63 ====================
+
+Released: 2014-03-18, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Carlos O'Donell <carlos@redhat.com>
+Christoph Hellwig <hch@infradead.org>
+Corrado Zoccolo <czoccolo@gmail.com>
+Gregory P. Smith <gps@google.com>
+Joseph S. Myers <joseph@codesourcery.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peng Haitao <penght@cn.fujitsu.com>
+Phillip Susi <psusi@ubuntu.com>
+Robert P. J. Day <rpjday@crashcourse.ca>
+Stefan Puiu <stefan.puiu@gmail.com>
+Zhu Yanhai <zhu.yanhai@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+duplocale.3
+ Michael Kerrisk
+ New page documenting duplocale(3)
+
+newlocale.3
+ Michael Kerrisk [Mike Frysinger]
+ New page documenting newlocale(3) and freelocale(3)
+
+towlower.3
+ Michael Kerrisk
+ Largely rewrite description of towlower() to be simpler and clearer
+
+towupper.3
+ Michael Kerrisk
+ Largely rewrite description of towupper() to be simpler and clearer
+
+uselocale.3
+ Michael Kerrisk
+ New page documenting uselocale(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+open.2
+ Michael Kerrisk
+ Document O_DSYNC and rewrite discussion of O_SYNC
+
+isalpha.3
+ Michael Kerrisk
+ Document the "_l" locale APIs
+ The GNU C library v2.3 added some locale APIs, most of which
+ were later specified in POSIX.1-2008, namely:
+
+ isalnum_l()
+ isalpha_l()
+ isblank_l()
+ iscntrl_l()
+ isdigit_l()
+ isgraph_l()
+ islower_l()
+ isprint_l()
+ ispunct_l()
+ isspace_l()
+ isupper_l()
+ isxdigit_l()
+ isascii_l()
+
+ Also update and correct various pieces in CONFORMING TO
+ (and remove a few crufty old pieces there).
+
+strerror.3
+ Michael Kerrisk
+ Document strerror_l()
+
+toupper.3
+ Michael Kerrisk
+ Document toupper_l() and tolower_l()
+
+towlower.3
+ Michael Kerrisk
+ Document towlower_l()
+
+towupper.3
+ Michael Kerrisk
+ Document towupper_l()
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/kernel/random/uuid
+
+locale.7
+ Michael Kerrisk
+ Document LC_ADDRESS
+ Document LC_IDENTIFICATION
+ Document LC_MEASUREMENT
+ Document LC_NAME
+ Document LC_PAPER
+ Document LC_TELEPHONE
+
+
+New and changed links
+---------------------
+
+freelocale.3
+ Michael Kerrisk
+ New link to new newlocale.3 page
+
+isalnum_l.3
+isascii_l.3
+isblank_l.3
+iscntrl_l.3
+isdigit_l.3
+isgraph_l.3
+islower_l.3
+isprint_l.3
+ispunct_l.3
+isspace_l.3
+isupper_l.3
+isxdigit_l.3
+ Michael Kerrisk
+ New links to isalpha.3
+
+tolower_l.3
+toupper_l.3
+ Michael Kerrisk
+ New links to toupper.3
+
+towlower_l.3
+ Michael Kerrisk
+ New link to towlower.3
+
+towupper_l.3
+ Michael Kerrisk
+ New link to towupper.3
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global change: "upper case" ==> "uppercase", "lower case" ==> lowercase"
+
+
+Changes to individual pages
+---------------------------
+
+mount.2
+ Michael Kerrisk
+ SEE ALSO: add blkid(1)
+
+msgop.2
+ Michael Kerrisk
+ Document two MSG_COPY failure modes
+ Since Linux 3.14, the kernel now diagnoses two errors
+ when using msgrcv() MSG_COPY:
+ * MSG_COPY must be specified with IPC_NOWAIT
+ * MSG_COPY can't be specified with MSG_EXCEPT
+
+open.2
+ Michael Kerrisk
+ Organize some material under additional subheadings in NOTES
+ There's an amorphous mass of material under NOTES. Structure
+ it with some subheadings, and do a little reorganizing.
+ Michael Kerrisk
+ Add other system calls and functions that are like openat()
+ fanotify_mark(2), name_to_handle_at(2), and scandirat(3) have a
+ directory file descriptor argument for the same reason as openat().
+ Also: reword the rationale for the *at() functions somewhat.
+ Michael Kerrisk
+ Clarify ELOOP error interaction with O_PATH
+
+readahead.2
+ Phillip Susi [Corrado Zoccolo, Gregory P. Smith, Zhu Yanhai, Michael Kerrisk, Christoph Hellwig]
+ Don't claim the call blocks until all data has been read
+ The readahead(2) man page was claiming that the call blocks until
+ all data has been read into the cache. This is incorrect.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=54271
+
+stat.2
+ Michael Kerrisk
+ SEE ALSO: add ls(1) and stat(1)
+
+fts.3
+ Christoph Hellwig [Michael Kerrisk]
+ The fts(3) API does not work with LFS builds
+ As pointed out during a recent discussion on libc-hacker the
+ fts(3) APIs can't be used with large file offsets:
+
+ https://sourceware.org/bugzilla/show_bug.cgi?id=15838
+
+mbrtowc.3
+mbsnrtowcs.3
+mbsrtowcs.3
+mbtowc.3
+ Michael Kerrisk
+ Add entries in SEE ALSO
+ Mainly inspired by the POSIX pages.
+
+mbsinit.3
+ Michael Kerrisk
+ SEE ALSO: add mbrlen(3), mbrtowc(3), and wcrtomb(3)
+
+mbsrtowcs.3
+wcsrtombs.3
+ Michael Kerrisk
+ SEE ALSO: add mbsinit(3)
+
+mbstowcs.3
+ Michael Kerrisk [Stefan Puiu]
+ Add example program
+ And add some SEE ALSO entries
+
+memcmp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memcmp() is thread safe.
+
+memcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memcpy() is thread safe.
+
+memfrob.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memfrob() is thread safe.
+
+memmem.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memmem() is thread safe.
+
+memmove.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memmove() is thread safe.
+
+mempcpy.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mempcpy() and wmempcpy() are thread safe.
+
+memset.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function memset() is thread safe.
+
+strerror.3
+ Michael Kerrisk
+ CONFORMING TO: strerror() and strerror_r() are in POSIX.1-2008
+ Michael Kerrisk
+ Add SS heading for strerror_r()
+
+toupper.3
+ Michael Kerrisk
+ Rewrite to more explicitly bring locales into the discussion
+ Michael Kerrisk
+ Retitle BUGS section to NOTES
+ These are not really bugs, just background info.
+
+wcrtomb.3
+wcsnrtombs.3
+wcsrtombs.3
+wcstombs.3
+wctomb.3
+ Michael Kerrisk
+ SEE ALSO: add various entries
+ Mainly inspired by POSIX
+
+core.5
+ Mike Frysinger [Michael Kerrisk]
+ Document core_pattern %d specifier
+ Document %P core_pattern specifier
+ Michael Kerrisk
+ Rearrange core_pattern specifiers alphabetically
+
+locale.5
+ Michael Kerrisk
+ SEE ALSO: add newlocale(3) + duplocale(3)
+
+feature_test_macros.7
+ Michael Kerrisk [Joseph S. Myers]
+ Remove mention of bogus _ISOC95_SOURCE macro
+ The _ISOC95_SOURCE macro is defined in <features.h>, but it
+ does nothing. So remove discussion of it, and move some of
+ the discussion of C95 under the ISOC99_SOURCE subhead.
+ Michael Kerrisk [Carlos O'Donell]
+ Add packaging note for _BSD_SOURCE/_SVID_SOURCE/_DEFAULT_SOURCE
+ To compile warning-free across glibc < 2.20 and glibc >= 2.20
+ code may been to define both _DEFAULT_SOURCE and either
+ _BSD_SOURCE or _SVID_SOURCE.
+ Michael Kerrisk
+ Reword description of C90
+
+locale.7
+ Michael Kerrisk
+ Add subsection on POSIX.1-2008 (originally GNU) extensions to locale API
+ Michael Kerrisk
+ Remove reference to LI18NUX2000
+ LI18NUX2000 is difficult to even find these days, and in any case
+ this page does not document gettext(), so notes about gettext()
+ in the CONFORMING TO section here make no sense.
+ Michael Kerrisk
+ SEE ALSO: add mbstowcs(3) and wcstombs(3)
+ SEE ALSO: add newlocale(3) + duplocale(3)
+
+man-pages.7
+ Michael Kerrisk
+ Add preferred term "superblock"
+ Michael Kerrisk
+ Add preferred terms "uppercase" and "lowercase"
+
+
+
+==================== Changes in man-pages-3.64 ====================
+
+Released: 2014-04-06, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Abhay Sachan <sachan.abhay@gmail.com>
+Alexey Samsonov <samsonov@google.com>
+Andrey Vagin <avagin@openvz.org>
+Aneesh Kumar K.V <aneesh.kumar@linux.vnet.ibm.com>
+Christoph Hellwig <hch@infradead.org>
+David Prévot <taffit@debian.org>
+Eric Dumazet <edumazet@google.com>
+Eric W. Biederman <ebiederm@xmission.com>
+Jan Kara <jack@suse.cz>
+Kir Kolyshkin <kir@openvz.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+NeilBrown <neilb@suse.de>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Hurley <peter@hurleysoftware.com>
+Petr Gajdos <pgajdos@suse.cz>
+Robert P. J. Day <rpjday@crashcourse.ca>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+open_by_handle_at.2
+ Michael Kerrisk [Mike Frysinger, Neil Brown, Aneesh Kumar K.V,
+ Christoph Hellwig]
+ New page describing name_to_handle_at(2) and open_by_handle_at(2)
+
+inotify.7
+ Michael Kerrisk
+ Rewrite introductory section
+ Reorganize "Limitations and caveats" subsection
+ Michael Kerrisk
+ Further describe the race when adding a watch to a new subtree
+ Michael Kerrisk
+ Directory renames may invalidate multiple paths cached by application
+ Michael Kerrisk
+ Add paragraph on cache consistency checking
+ Michael Kerrisk
+ Mention cache rebuilding to handle overflow events
+ Michael Kerrisk
+ Moving an object to another filesystem generates IN_DELETE_SELF
+ Michael Kerrisk [Jan Kara]
+ Add text on dealing with rename() events
+ Michael Kerrisk
+ Note rationale and consequences of event coalescing
+ Michael Kerrisk [Eric W. Biederman]
+ Inotify doesn't work for remote and pseudo filesystems
+ Michael Kerrisk
+ Add some examples of events generated by various system calls
+ Michael Kerrisk
+ BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped
+ A silent change as a result of the fanotify work in kernel 2.6.36.
+ Michael Kerrisk
+ Note that IN_DELETE_SELF will be followed by IN_IGNORED
+ Michael Kerrisk
+ Note that IN_UNMOUNT will be followed by an IN_IGNORED event
+ Michael Kerrisk
+ Inotify does not report events for mmap(2) and msync(2)
+ Michael Kerrisk
+ Add examples of syscalls that trigger IN_ATTRIB
+ Michael Kerrisk
+ Add some examples of syscalls that trigger IN_MODIFY
+ Michael Kerrisk
+ execve(2) also generates IN_ACCESS
+ Michael Kerrisk
+ Add examples of syscalls that trigger IN_CREATE
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+perf_event_open.2
+ Vince Weaver [Michael Kerrisk]
+ Document the PERF_FLAG_FD_CLOEXEC flag
+ The Linux 3.14 release adds support for the PERF_FLAG_FD_CLOEXEC
+ flag.
+
+feature_test_macros.7
+ Michael Kerrisk
+ Document _LARGEFILE_SOURCE
+
+tcp.7
+ Michael Kerrisk [Eric Dumazet]
+ Document /proc/sys/net/ipv4/tcp_autocorking
+ Text heavily based on Documentation/networking/ip-sysctl.txt
+
+
+New and changed links
+---------------------
+
+name_to_handle_at.2
+ Michael Kerrisk
+ New link to new open_by_name_at(2) page
+
+
+Global changes
+--------------
+
+fmemopen.3
+getaddrinfo.3
+mq_notify.3
+offsetof.3
+aio.7
+ Michael Kerrisk
+ Print size_t/ssize_t values using %z printf() modifier
+ There are fewer and fewer systems these days that don't
+ support the %z specifier mandated in C99. So replace the
+ use of %ld/%lu + (long) cast with %zd/%zu.
+
+
+Changes to individual pages
+---------------------------
+
+bdflush.2
+fsync.2
+sync.2
+ Kir Kolyshkin
+ SEE ALSO: remove update(8) reference
+ Remove reference to update(8) man page, since there is no such
+ page. This is an ancient BSD leftover I believe.
+
+chown.2
+ Michael Kerrisk
+ Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
+
+getxattr.2
+ Abhay Sachan
+ Fix RETURN VALUE description
+ A EA can have length zero.
+
+inotify_add_watch.2
+ Michael Kerrisk
+ ERRORS: add ENAMETOOLONG
+
+inotify_init.2
+ Michael Kerrisk
+ Add pointer to inotify(7)
+
+link.2
+ Michael Kerrisk
+ When AT_EMPTY_PATH is specified, 'olddirfd' must not refer to a
+ directory
+
+mmap.2
+ Andrey Vagin
+ The file descriptor for a file mapping must be readable
+ There is no difference between MAP_SHARED and MAP_PRIVATE.
+
+open.2
+ Michael Kerrisk
+ SEE ALSO: add open_by_name_at(2)
+
+perf_event_open.2
+ Vince Weaver
+ Document PERF_EVENT_IOC_PERIOD behavior change
+ Linux 3.14 (in commit bad7192b842c83e580747ca57104dd51fe08c223)
+ changes the perf_event PERF_EVENT_IOC_PERIOD ioctl() behavior
+ on all architectures to update immediately, to match the behavior
+ found on ARM.
+
+stat.2
+ Michael Kerrisk
+ Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
+
+syscalls.2
+ Michael Kerrisk
+ Add sched_getattr() and sched_setattr()
+ And update kernel version to 3.14
+
+abort.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function abort() is thread safe.
+
+confstr.3
+ Michael Kerrisk
+ SEE ALSO: add getconf(1), fpathconf(3), sysconf(3), pathconf(3)
+
+exit.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function exit() is not thread safe.
+
+fenv.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions feclearexcept(), fegetexceptflag(), feraiseexcept(),
+ fesetexceptflag(), fetestexcept(), fegetround(), fesetround(),
+ fegetenv(), feholdexcept(), fesetenv(), feupdateenv(),
+ feenableexcept(), fedisableexcept() and fegetexcept() are thread
+ safe.
+
+fpathconf.3
+ Michael Kerrisk
+ SEE ALSO: add confstr(3)
+
+fseek.3
+ Michael Kerrisk [Petr Gajdos]
+ Document EINVAL error for negative file offset
+
+fseeko.3
+ Michael Kerrisk
+ Add feature test macro requirements
+
+fts.3
+ Michael Kerrisk [Mike Frysinger]
+ Remove mention of "32-bit systems" in BUGS
+
+fwide.3
+wprintf.3
+ Michael Kerrisk [Robert P. J. Day]
+ Remove mention of bogus _ISOC95_SOURCE feature test macro
+
+getline.3
+ Alexey Samsonov
+ Caller should free the allocated buffer even if getline() failed
+ Relevant discussion in glibc bugzilla:
+ https://sourceware.org/bugzilla/show_bug.cgi?id=5666
+
+getloadavg.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getloadavg() is thread safe.
+
+getpt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getpt() is thread safe.
+
+if_nametoindex.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions if_nametoindex() and if_indextoname() are thread safe.
+
+index.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions index() and rindex() are thread safe.
+
+mkfifo.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mkfifo() and mkfifoat() are thread safe.
+
+netlink.3
+ Michael Kerrisk
+ SEE ALSO: make the reference for libnetlink the libnetlink(3) man page
+
+random.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions random(), srandom(), initstate() and setstate()
+ are thread safe.
+
+random_r.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions random_r(), srandom_r(), initstate_r() and
+ setstate_r() are thread safe.
+
+sigvec.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sigvec(), sigblock(), sigsetmask() and
+ siggetmask() are thread safe.
+
+ The macro sigmask() is thread safe.
+
+sysconf.3
+ Michael Kerrisk
+ SEE ALSO: add confstr(3)
+
+termios.3
+ Michael Kerrisk [Peter Hurley]
+ Fix error in discussion of MIN > 0, TIME == 0 noncanonical mode
+ As reported by Peter Hurley, for the MIN > 0, TIME == 0 case:
+
+ read() may unblock when MIN bytes are available but return
+ up to the 'count' parameter if more input arrives in between
+ waking and copying into the user buffer.
+ ...
+ read() may also _not_ return until MIN bytes have been
+ received, even if 'count' bytes have been received.
+ Michael Kerrisk
+ Add a note on interaction of O_NONBLOCK with noncanonical MIN/TIME
+ POSIX leaves the behavior open.
+ Michael Kerrisk
+ Clarify termination conditions for MIN > 0, TIME > 0
+ Michael Kerrisk
+ Clarify behavior if data is available before noncanonical read()
+ Michael Kerrisk
+ Add descriptive titles to noncanonical read() cases
+
+symlink.7
+ Michael Kerrisk
+ Add subsection on opening a symbolic link with O_PATH
+ Michael Kerrisk
+ name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
+ Michael Kerrisk
+ Mention use of readlink(2) to read contents of a symlink
+
+
+==================== Changes in man-pages-3.65 ====================
+
+Released: 2014-04-20, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alex Thorlton <athorlton@sgi.com>
+Ashish Sangwan <a.sangwan@samsung.com>
+Christopher Covington <cov@codeaurora.org>
+Christoph Hellwig <hch@infradead.org>
+Craig McQueen <craig.mcqueen@beamcommunications.com>
+Dave Chinner <david@fromorbit.com>
+David Prévot <taffit@debian.org>
+Greg Troxel <gdt@ir.bbn.com>
+Matthew Dempsky <mdempsky@chromium.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Namjae Jeon <namjae.jeon@samsung.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Petr Gajdos <pgajdos@suse.cz>
+Richard Hansen <rhansen@bbn.com>
+Simon Paillard <spaillard@debian.org>
+Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+inet_net_pton.3
+ Michael Kerrisk
+ New page describing inet_net_pton(3) and inet_net_ntop(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fallocate.2
+ Michael Kerrisk, Namjae Jeon [Christoph Hellwig, Dave Chinner]
+ Document FALLOC_FL_COLLAPSE_RANGE
+
+prctl.2
+ Michael Kerrisk [Alex Thorlton]
+ Document PR_SET_THP_DISABLE and PR_GET_THP_DISABLE
+
+proc.5
+ Michael Kerrisk
+ Document /proc/[pid]/stack
+ Michael Kerrisk
+ Document /proc/[pid]/clear_refs
+
+
+New and changed links
+---------------------
+
+inet_net_ntop.3
+ Michael Kerrisk
+ New link to new inet_net_pton.3
+
+
+Changes to individual pages
+---------------------------
+
+fcntl.2
+ Michael Kerrisk
+ Note the race when O_CLOEXEC is used at same time as fork()+execve()
+
+madvise.2
+ Michael Kerrisk
+ SEE ALSO: see prctl(2)
+ Because of PR_SET_THP_DISABLE.
+
+mlock.2
+ Michael Kerrisk
+ Describe treatment of MCL_FUTURE during fork(2) and execve(2)
+
+msync.2
+ Michael Kerrisk [Richard Hansen, Greg Troxel]
+ Warn that one of MS_SYNC or MS_ASYNC is required
+
+open.2
+ Michael Kerrisk
+ Add more detail on the race that O_CLOEXEC is designed to avoid
+ Michael Kerrisk [Matthew Dempsky]
+ Remove crufty text stating that O_DIRECTORY is Linux-specific
+ Michael Kerrisk
+ Note which filesystems support O_TMPFILE
+
+perf_event_open.2
+ Vince Weaver [Michael Kerrisk]
+ Clarify EACCES and EPERM errors
+ Clarify the reasons for EACCES and EPERM errors.
+ Vince Weaver [Michael Kerrisk]
+ Make the ERRORS section more comprehensive.
+ Determined both by code inspection and by writing a large
+ number of test programs.
+
+personality.2
+ Michael Kerrisk
+ Available execution domains are listed in <sys/personality.h>
+ Michael Kerrisk
+ Fix discussion of return value
+
+prctl.2
+ Michael Kerrisk
+ ERRORS: document EINVAL for PR_GET_NO_NEW_PRIVS
+ ERRORS: document EINVAL for PR_SET_PDEATHSIG
+ ERRORS: document EINVAL for PR_SET_TIMING
+ ERRORS: document EINVAL for PR_SET_DUMPABLE
+ ERRORS: document EINVAL for PR_SET_NO_NEW_PRIVS
+
+shmget.2
+ Michael Kerrisk
+ Rewrite description of SHMMNI default value
+ Michael Kerrisk
+ Note default value of SHMMAX
+ Note default value for SHMALL
+
+byteorder.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions htonl(), htons(), ntohl() and ntohs() are thread
+ safe.
+
+fexecve.3
+ Michael Kerrisk [Steven Stewart-Gallus]
+ If 'fd' is a close-on-exec file descriptor for a script, fexecve() fails
+ See https://bugzilla.kernel.org/show_bug.cgi?id=74481
+
+ffs.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ffs(), ffsl() and ffsll() are thread safe.
+
+getauxval.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getauxval() is thread safe.
+
+getcontext.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions getcontext() and setcontext() are thread safe.
+
+getsubopt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getsubopt() is thread safe.
+
+getutmp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions getutmp() and getutmpx() are thread safe.
+
+inet.3
+ Michael Kerrisk
+ Note success and error return for inet_aton()
+
+inet.3
+ Michael Kerrisk [Craig McQueen]
+ The form 'a.b' if is suitable for Class A addresses (not class C)
+ Michael Kerrisk
+ SEE ALSO: add inet_net_pton(3)
+
+makecontext.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions makecontext() and swapcontext() are thread safe.
+
+pthread_attr_setdetachstate.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setdetachstate() and
+ pthread_attr_getdetachstate() are thread safe.
+
+pthread_attr_setguardsize.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setguardsize() and
+ pthread_attr_getguardsize() are thread safe.
+
+sigsetops.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sigemptyset(), sigfillset(), sigaddset(),
+ sigdelset(), sigismember(), sigisemptyset(), sigorset() and
+ sigandset() are thread safe.
+
+proc.5
+ Petr Gajdos
+ Improve /proc/[pid]/smaps entries description
+ Michael Kerrisk
+ /proc/PID/smaps is present only if CONFIG_PROC_PAGE_MONITOR
+ Michael Kerrisk
+ Note kernel version for /proc/sys/kernel/{shmall,shmmax}
+ Michael Kerrisk
+ Note kernel version for /proc/sys/kernel/{msgmax,msgmnb}
+
+capabilities.7
+ Michael Kerrisk
+ SEE ALSO: add capsh(1)
+
+libc.7
+ Michael Kerrisk
+ Add musl libc
+
+
+==================== Changes in man-pages-3.66 ====================
+
+Released: 2014-05-08, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alan Curry <rlwinm@sdf.org>
+Carsten Andrich <carsten.andrich@tu-ilmenau.de>
+Daniel Borkmann <dborkman@redhat.com>
+David Prévot <taffit@debian.org>
+Eric Siegerman <pub08-knl@davor.org>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Jan Kara <jack@suse.cz>
+Jan Moskyto Matejka <mq@suse.cz>
+John Marshall <jm18@sanger.ac.uk>
+Lukáš Czerner <lczerner@redhat.com>
+Manfred Spraul <manfred@colorfullife.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Miklos Szeredi <miklos@szeredi.hu>
+Neil Horman <nhorman@tuxdriver.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Schiffer <pschiffe@redhat.com>
+Randy Dunlap <rdunlap@infradead.org>
+Silvan Jegen <s.jegen@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Stefan Puiu <stefan.puiu@gmail.com>
+Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
+Stijn Hinterding <contact@stijnhinterding.nl>
+Willem de Bruijn <willemb@google.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+fanotify_init.2
+ Heinrich Schuchardt, Michael Kerrisk
+ New page documenting fanotify_init(2)
+
+fanotify_mark.2
+ Heinrich Schuchardt, Michael Kerrisk
+ New page documenting fanotify_mark(2)
+
+sched_setscheduler.2
+ Michael Kerrisk
+ Page rewritten
+ Stripped out the general scheduling material, which
+ moved to sched(7), and rewrote much of the remainder.
+ Changed copyright and license since pretty much all
+ of the content was or is written by mtk.
+
+fanotify.7
+ Heinrich Schuchardt, Michael Kerrisk
+ New page providing overview of the fanotify API
+
+sched.7
+ Michael Kerrisk
+ New page providing an overview of the scheduling APIs
+ Most of this content derives from sched_setscheduler(2). In
+ preparation for adding a sched_setattr(2) page, it makes
+ sense to isolate out this general content to a separate
+ page that is referred to by the other scheduling pages.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fallocate.2
+ Lukas Czerner [Michael Kerrisk]
+ Document FALLOC_FL_ZERO_RANGE
+ FALLOC_FL_ZERO_RANGE was added in Linux 3.14,
+ for zeroing ranges in the allocated space in a file.
+
+rename.2
+ Miklos Szeredi [Michael Kerrisk]
+ Document renameat2() system call added in Linux 3.15
+
+shmop.2
+ Michael Kerrisk
+ Document SHM_EXEC
+
+
+Changes to individual pages
+---------------------------
+
+flock.2
+ Michael Kerrisk
+ Employ term "open file description" in DESCRIPTION
+ And include reference to open(2) for an explanation of the term.
+
+getpriority.2
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+getsockopt.2
+ Carsten Andrich
+ SEE ALSO: add packet(7)
+
+link.2
+ Michael Kerrisk [Steven Stewart-Gallus]
+ Document ENOENT error for linkat()
+ See https://bugzilla.kernel.org/show_bug.cgi?id=73301
+
+msgget.2
+ Michael Kerrisk
+ Reword EEXIST error
+
+msgop.2
+ Michael Kerrisk
+ Note capability required to raise MQ size beyond MSGMNB
+
+msync.2
+ Michael Kerrisk [Heinrich Schuchardt]
+ s/flushes... back to disk/flushes... back to filesystem/
+
+nice.2
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+open.2
+ Peter Schiffer
+ Update note on alignment of user buffer and file offset for O_DIRECT
+ The sentence in open(2) man page in notes for O_DIRECT flag:
+
+ "Under Linux 2.6, alignment to 512-byte boundaries suffices."
+
+ is not universally correct. The alignment is a property of the
+ storage, for example, 4k-sector drives with no 512 byte sector
+ emulation will be unable to perform 512-byte direct I/O.
+ Michael Kerrisk
+ Note some of the various synonyms for "open file description"
+ Michael Kerrisk
+ Remove repetitious text on use of fcntl() to change file status flags
+
+open_by_handle_at.2
+ Michael Kerrisk
+ Mention FreeBSD analogs
+
+posix_fadvise.2
+ Michael Kerrisk [Eric Siegerman]
+ Fix wording error under "Architecture-specific variants"
+ See https://bugzilla.kernel.org/show_bug.cgi?id=75431
+
+process_vm_readv.2
+ Michael Kerrisk [Stijn Hinterding]
+ Add feature test macro requirements
+ The _GNU_SOURCE FTM must be defined.
+
+read.2
+ Michael Kerrisk
+ BUGS: detail nonatomicity bug with respect to file offset updates
+ This bug was fixed in Linux 3.14, with commit
+ 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
+ See also http://thread.gmane.org/gmane.linux.kernel/1649458
+
+sched_get_priority_max.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_rr_get_interval.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_setaffinity.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_setparam.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_yield.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+semget.2
+ Michael Kerrisk
+ Consolidate discussion on noninitialization of semaphores
+ The fact that semget() does not initialize the semaphores
+ in a new set was covered in two places (in DESCRIPTION
+ and BUGS). Consolidate these into one place (in NOTES)
+ and also point out that POSIX.1-2008 says that a future
+ version of the standard may require an implementation to
+ initialize the semaphores to 0.
+ Michael Kerrisk
+ Clarify SEMMNS versus SEMMSL*SEMMNI
+ Michael Kerrisk
+ Rework EINVAL text a little
+ Michael Kerrisk
+ Clarify wording for EEXIST error
+
+shmget.2
+ Manfred Spraul
+ Clarify SHMALL
+ The default for SHMALL is a limit of 8 GB, regardless of
+ PAGE_SIZE. The current documentation does not mention that
+ and is therefore more difficult to understand than necessary.
+ Manfred Spraul
+ Correct math error
+ 2097152 is 2^21, not 2^20.
+ Michael Kerrisk
+ Reword EEXIST error
+ Michael Kerrisk
+ Clarify one of the EINVAL cases
+ Michael Kerrisk
+ Note that SHM_NORESERVE is a Linux extension
+ Michael Kerrisk [Simon Paillard]
+ Fix kernel version numbers in discussion of SHMALL
+ Michael Kerrisk
+ Rework EINVAL text
+ Michael Kerrisk
+ Move and rework discussion of mode bits
+ Michael Kerrisk
+ Reword description of O_EXCL
+
+shmop.2
+ Michael Kerrisk
+ Move fork(2), execve(2), _exit(2) discussion to NOTES
+ Michael Kerrisk
+ Add subheads for shmat() and shmdt()
+ Michael Kerrisk
+ Rework discussion of SHM_RDONLY and SHM_REMAP into list format
+ Michael Kerrisk
+ Structure the attach cases as a list
+
+sigaction.2
+ Alan Curry
+ Fix bad cross reference (times(2) not time(2))
+ The system call that reports child CPU usage is times(2),
+ not time(2).
+
+symlink.2
+ Michael Kerrisk [Steven Stewart-Gallus]
+ Document ENOENT error for symlinkat()
+ See https://bugzilla.kernel.org/show_bug.cgi?id=73301
+
+syscalls.2
+ Michael Kerrisk
+ Add renameat2()
+ And bump kernel version.
+
+write.2
+ Michael Kerrisk
+ BUGS: detail nonatomicity bug with respect to file offset updates
+ This bug was fixed in Linux 3.14, with commit
+ 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
+ See also http://thread.gmane.org/gmane.linux.kernel/1649458
+
+pthread_attr_setinheritsched.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setinheritsched() and
+ pthread_attr_getinheritsched() are thread safe.
+
+pthread_attr_setschedparam.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setschedparam() and
+ pthread_attr_getschedparam() are thread safe.
+
+pthread_attr_setschedpolicy.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setschedpolicy() and
+ pthread_attr_getschedpolicy() are thread safe.
+
+pthread_attr_setscope.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setscope() and pthread_attr_getscope()
+ are thread safe.
+
+pthread_attr_setstack.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setstack() and pthread_attr_getstack()
+ are thread safe.
+
+sched_getcpu.3
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+termios.3
+ Michael Kerrisk [Yuri Kozlov]
+ Rework intro text for 'c_oflag'
+ Michael Kerrisk
+ OFDEL is in POSIX.1-2001, so remove "(Not in POSIX)" text
+
+proc.5
+ Jan Moskyto Matejka [Randy Dunlap]
+ Improve description of /proc/stat 'intr' field
+ The sum at the beginning of line "intr" includes also
+ unnumbered interrupts.
+
+packet.7
+ Carsten Andrich [Neil Horman]
+ Improve sockopt documentation for packet sockets
+ Carsten Andrich [Willem de Bruijn]
+ PACKET_LOSS has inverse meaning
+ Stefan Puiu [Daniel Borkmann, Carsten Andrich]
+ Status in PACKET_RX_RING is actually a bit mask
+ Michael Kerrisk [Carsten Andrich]
+ SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c
+
+
+==================== Changes in man-pages-3.67 ====================
+
+Released: 2014-05-21, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andy Lutomirski <luto@amacapital.net>
+Aurelien Jarno <aurelien@aurel32.net>
+Bill Allombert <ballombe@debian.org>
+Christoph Hellwig <hch@infradead.org>
+Davidlohr Bueso <davidlohr@hp.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Ingo Schwarze <schwarze@usta.de>
+Jan Kara <jack@suse.cz>
+Jon Grant <jg@jguk.org>
+Juri Lelli <juri.lelli@gmail.com>
+Lucas De Marchi <lucas.demarchi@profusion.mobi>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Zijlstra <peterz@infradead.org>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Sam Varshavchik <mrsam@courier-mta.com>
+Simon Paillard <spaillard@debian.org>
+Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
+Török Edwin <edwin@etorok.net>
+William Morriss <wjmelements@gmail.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+sched_setattr.2
+ Michael Kerrisk, Peter Zijlstra [Juri Lelli]
+ New page describing sched_setattr(2) and sched_getattr(2)
+
+system.3
+ Michael Kerrisk
+ Rewrote large parts of the page and added a number of details
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+sched.7
+ Peter Zijlstra, Michael Kerrisk [Juri Lelli]
+ Document SCHED_DEADLINE
+
+New and changed links
+---------------------
+
+renameat2.2
+ Michael Kerrisk
+ New link to rename.2
+
+sched_getattr.2
+ Michael Kerrisk
+ New link to new sched_setattr
+
+
+Changes to individual pages
+---------------------------
+
+bind.2
+ Michael Kerrisk
+ ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
+
+chown.2
+ Michael Kerrisk
+ NOTES: Add some subheadings
+
+connect.2
+ Michael Kerrisk [William Morriss]
+ ERRORS: Add EADDRNOTAVAIL for ephemeral port range exhaustion
+ Verified from testing and the kernel source.
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=745775
+ Michael Kerrisk
+ Remove mention of ip_local_port_range under EAGAIN error
+
+create_module.2
+delete_module.2
+init_module.2
+query_module.2
+ Michael Kerrisk [Lucas De Marchi]
+ Clarify glibc header file declaration/ABI wrapper details
+ create_module(), delete_module(), init_module(), and
+ query_module() are not declared in header files, but
+ through an accident of history glibc provides an ABI
+ for them that it continues to maintain, for
+ compatibility reasons.
+
+execve.2
+ Michael Kerrisk [Steven Stewart-Gallus]
+ Note SIGKILL case when execve() fails beyond the point of no return
+ Michael Kerrisk
+ NOTES: Add a subheading and reorder paragraphs
+
+fanotify_init.2
+ Heinrich Schuchardt [Michael Kerrisk]
+ Document range of permitted flags for event_f_flags
+ With a new patch included in the mm tree, event_f_flags is
+ checked for allowable values.
+
+fcntl.2
+ Michael Kerrisk
+ Add "file locking" subheading under NOTES
+
+fork.2
+ Michael Kerrisk
+ ERRORS: SCHED_DEADLINE tasks can fail with EAGAIN
+ SCHED_DEADLINE tasks can fail with EAGAIN unless the
+ reset-on-fork flag is set.
+
+futex.2
+ Michael Kerrisk
+ Note that there is no glibc wrapper
+
+getpriority.2
+ Rasmus Villemoes
+ Fix prototypes for getpriority() and setpriority()
+ The who argument has type id_t (which happens to be u32 on linux).
+
+get_robust_list.2
+ Rasmus Villemoes
+ Add <sys/types.h> to synopsis of get_robust_list()
+ If one were to implement wrappers for [gs]et_robust_list() using the
+ given prototypes, one would also have to include sys/types.h to get
+ a definition of size_t.
+
+getrusage.2
+ Michael Kerrisk [Bill Allombert]
+ _GNU_SOURCE must be defined to obtain RUSAGE_THREAD definition
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=746569
+
+link.2
+open.2
+ Andy Lutomirski [Michael Kerrisk]
+ Update AT_EMPTY_PATH and O_PATH documentation
+
+listen.2
+ Michael Kerrisk
+ ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
+
+mbind.2
+ Rasmus Villemoes
+ Fix prototype for mbind(2)
+ The nmask argument is const. The return type in numaif.h is long.
+ (Well, at least <numaif.h> says nmask is const. The current kernel
+ does not define it as a const argument, but sys_mbind() only
+ passes it to get_nodes(), which does treat it as const.)
+
+msgop.2
+ Davidlohr Bueso [Michael Kerrisk]
+ Enhance description of "full queue" criteria
+
+poll.2
+ Rasmus Villemoes
+ Add <signal.h> to synopsis for ppoll()
+ One needs to #include <signal.h> to get the definition of the
+ type (sigset_t) of the mask argument to ppoll().
+
+readlink.2
+ Rasmus Villemoes
+ Fix return type of readlinkat()
+
+recv.2
+ Michael Kerrisk
+ Clarify details of msg_name and msg_namelen fields
+
+recvmmsg.2
+ Michael Kerrisk
+ Describe timeout bug
+ See https://bugzilla.kernel.org/show_bug.cgi?id=75371
+ and http://thread.gmane.org/gmane.linux.man/5677
+
+remap_file_pages.2
+ Andy Lutomirski [Christoph Hellwig, Andy Lutomirski]
+ remap_file_pages() has no benefit for real files
+ Linux commit 3ee6dafc677a68e461a7ddafc94a580ebab80735 caused
+ remap_file_pages to be emulated when used on real file.
+
+sched_get_priority_max.2
+ Michael Kerrisk
+ 'policy' can also be SCHED_DEADLINE
+
+sched_setaffinity.2
+ Rasmus Villemoes
+ Fix prototype for sched_setaffinity()
+ The mask argument is const.
+
+sched_setparam.2
+ Michael Kerrisk
+ ERRORS: mark errors that apply just for sched_setparam()
+ Michael Kerrisk
+ ERRORS: Add EINVAL for invalid arguments
+ Michael Kerrisk
+ SEE ALSO: add sched_setattr(2)
+
+sched_setscheduler.2
+ Michael Kerrisk
+ ERRORS: mark errors that apply just to sched_setscheduler()
+ Michael Kerrisk
+ ERRORS: add EINVAL case for pid < 0
+ Michael Kerrisk
+ ERRORS: separate out EINVAL cases
+
+semget.2
+ Michael Kerrisk
+ NOTES: Add subheadings and reorder paragraphs
+
+semop.2
+ Rasmus Villemoes
+ Fix prototypes for semop() and semtimedop()
+ The nsops arguments have type size_t, not unsigned, and the
+ timeout argument of semtimedop() is const.
+ Michael Kerrisk
+ NOTES: Add a subheading
+
+send.2
+ Michael Kerrisk
+ Add details on various 'msghdr' fields
+ Michael Kerrisk
+ ERRORS: Add EAGAIN for ephemeral port range exhaustion
+ Michael Kerrisk
+ Add some subheadings under DESCRIPTION
+
+shmget.2
+ Michael Kerrisk
+ NOTES: Add a subheading
+
+stat.2
+ Michael Kerrisk [Aurelien Jarno]
+ Describe feature test macro requirements for file type test macros
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=728240
+ Michael Kerrisk
+ Update FTM requirements for lstat()
+ Michael Kerrisk
+ Split discussion of 'st_mode' fields into type and permissions
+ Michael Kerrisk
+ Move text on S_I*() macros to follow text on S_I* macros
+ That ordering is more logical
+
+stime.2
+ Rasmus Villemoes
+ Fix prototype for stime()
+ The argument is const, both according to the actual header files and
+ according to <http://www.sco.com/developers/devspecs/vol1a.pdf>.
+
+syscall.2
+ Rasmus Villemoes
+ Fix prototype for syscall()
+ The first argument and the return value of syscall() has type long,
+ not int.
+
+getopt.3
+ Michael Kerrisk
+ EXAMPLE: Add subheadings to distinguish the two example programs
+
+malloc.3
+ Michael Kerrisk
+ Reword text referring to mallopt(3)
+ Linux libc is no longer "recent"; drop mention of it.
+
+pthread_attr_setinheritsched.3
+pthread_attr_setschedparam.3
+pthread_attr_setschedpolicy.3
+pthread_setaffinity_np.3
+pthread_setschedparam.3
+pthread_setschedprio.3
+pthread_yield.3
+pthreads.7
+ Michael Kerrisk
+ Change references to "sched_setscheduler(2)" to "sched(7)"
+ Change consistent with the fact that the scheduling overview
+ page is now sched(7) not sched_setscheduler(2).
+
+pthread_attr_setstackaddr.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setstackaddr() and
+ pthread_attr_getstackaddr() are thread safe.
+
+pthread_attr_setstacksize.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setstacksize() and
+ pthread_attr_getstacksize() are thread safe.
+
+pthread_kill.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_kill() is thread safe.
+
+pthread_kill_other_threads_np.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_kill_other_threads_np() is thread safe.
+
+pthread_self.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_self() is thread safe.
+
+pthread_setcancelstate.3
+ Michael Kerrisk
+ Add paragraph breaks to "Asynchronous cancelability" subsection
+
+pthread_setcancelstate.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setcancelstate() and
+ pthread_setcanceltype() are thread safe.
+ Michael Kerrisk
+ NOTES: Add some subheadings
+
+pthread_setschedparam.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setschedparam() and pthread_getschedparam()
+ are thread safe.
+
+pthread_setschedprio.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_setschedprio() is thread safe.
+
+pthread_sigmask.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_sigmask() is thread safe.
+
+pthread_sigqueue.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_sigqueue() is thread safe.
+
+pthread_testcancel.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_testcancel() is thread safe.
+
+pthread_yield.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_yield() is thread safe.
+
+remquo.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions remquo(), remquof() and remquol() are thread safe.
+
+rtime.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function rtime() is thread safe.
+
+sched_getcpu.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sched_getcpu() is thread safe.
+
+stpcpy.3
+ Ingo Schwarze
+ Note some history of stpcpy()
+ Quoting Ingo:
+ I just noticed that the stpcpy(3) manual contains a speculation
+ that appears to be untrue on closer investigation: That function
+ did not originate in MS DOS, but in Lattice C on AmigaDOS.
+
+ Here is a patch against the git master HEAD to fix that, and add
+ some more historical information. To provide some background and
+ allow you to more easily verify the correctness of the patch, i'm
+ appending my mail to <misc@openbsd.org>, where i'm giving some
+ more details about the history and pointing to some primary
+ sources. That mail also contains the (similar, but shorter)
+ patch i just committed to the OpenBSD manual page.
+
+strcasecmp.3
+ Michael Kerrisk [Aurelien Jarno, Török Edwin]
+ Explain why strcasecmp()+strncasecmp() are also declared in <string.h>
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729436
+
+strcpy.3
+ Michael Kerrisk
+ NOTES: Add a subheading
+
+fd.4
+ Michael Kerrisk [Sam Varshavchik]
+ Fix floppy disk device names
+ The naming convention shown in the page was ancient.
+ Now, the page is consistent with Documentation/devices.txt
+ (where it is noted that "The use of the capital letters
+ D, H and E for the 3.5" models have been deprecated, since
+ the drive type is insignificant for these devices"
+
+proc.5
+ Michael Kerrisk
+ Document /proc/timer_stats
+ Michael Kerrisk
+ (Briefly) document /proc/timer_list
+ Michael Kerrisk
+ Add /proc/sys/kernel/{sched_rt_period_us,sched_rt_runtime_us}
+ Reference sched(7) for an explanation of these two files
+
+capabilities.7
+ Michael Kerrisk
+ Mention sched_setattr(2) under CAP_SYS_NICE
+
+cpuset.7
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+credentials.7
+ Michael Kerrisk
+ Mention sched_getattr() as a place where credentials are checked
+
+fanotify.7
+ Heinrich Schuchardt [Jan Kara]
+ BUGS: error events can be lost when reading from fanotify FD
+ Michael Kerrisk [Heinrich Schuchardt]
+ Fix description of FAN_EVENT_NEXT()
+ FAN_EVENT_NEXT() does not update 'meta'; rather, it returns a
+ pointer to the next metadata structure. In addition, generally
+ rework the description to be a bit clearer and more detailed.
+ Heinrich Schuchardt
+ Document FAN_EVENT_METADATA_LEN
+
+ip.7
+ Michael Kerrisk
+ Note cases where an ephemeral port is used
+ Michael Kerrisk
+ Remove BUGS text on glibc failing to declare in_pktinfo
+ Michael Kerrisk
+ Clarify 'ip_local_port_range' and mention the term "ephemeral ports"
+ Michael Kerrisk
+ Note some more details about assignment of ephemeral ports
+ Michael Kerrisk
+ BUGS: ephemeral port range exhaustion is diagnosed inconsistently
+ Different system calls use different 'errno' values to diagnose
+ exhaustion of the ephemeral port range.
+
+sched.7
+ Michael Kerrisk
+ Document sched_rt_period_us and sched_rt_runtime_us /proc files
+ And rework and relocate the text on dealing with runaway
+ real-time processes.
+ Michael Kerrisk
+ Mention sched_setattr(2) in list of APIs that can change policies
+ Michael Kerrisk
+ sched_setattr(2) can also be used to set 'nice' value
+ Michael Kerrisk
+ Remove mention of sched_setscheduler() when talking about sched_priority
+ There are nowadays multiple ways to set sched_priority (and
+ in fact there always were, since we also had sched_setparam(2)).
+ Michael Kerrisk
+ SEE ALSO: Add Documentation/scheduler/sched-design-CFS.txt
+ Michael Kerrisk
+ Don't mention sched_setscheduler(2) in discussions of setting policies
+ In a couple of places, sched_setscheduler(2) is mentioned as the
+ way of setting policies. But now there is sched_setattr(2) as
+ well, rewrite the text in a more generic way.
+ Michael Kerrisk
+ Rework summary text describing sched_setattr(2) and sched_getattr(2)
+ Note that these APIs are a superset of sched_setscheduler(2)
+ and sched_getscheduler(2).
+ Michael Kerrisk
+ Remove crufty text relating to sched_setscheduler()
+ All of the removed text is in sched_setscheduler(2) and
+ should have been trimmed from this page.
+ Michael Kerrisk
+ SEE ALSO: Mention more files in Documentation/scheduler/ directory
OSDN Git Service
