+
+
+==================== Changes in man-pages-3.40 ====================
+
+Released: 2012-04-27, Christchurch
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alexey Toptygin <alexeyt@freeshell.org>
+Bernhard Walle <bernhard@bwalle.de>
+Brian F. G. Bidulock <bidulock@openss7.org>
+Brian M. Carlson <sandals@crustytoothpaste.net>
+Christopher Yeoh <cyeoh@au1.ibm.com>
+Daniel J Blueman <daniel@quora.org>
+Eric Blake <eblake@redhat.com>
+Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
+James Hunt <james.hunt@ubuntu.com>
+John Sullivan <jsrhbz@kanargh.force9.co.uk>
+Jon Grant <jg@jguk.org>
+lepton <ytht.net@gmail.com>
+Marcel Holtmann <marcel@holtmann.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Petr Baudis <pasky@ucw.cz>
+Simon Paillard <spaillard@debian.org>
+Stefan Puiu <stefan.puiu@gmail.com>
+Ulrich Drepper <drepper@gmail.com>
+Vadim Mikhailov <vadim.mikhailov@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+process_vm_readv.2
+ Mike Frysinger, Christopher Yeoh, Michael Kerrisk
+ New page for process_vm_readv(2) and process_vm_writev(2)
+
+mcheck.3
+ Michael Kerrisk
+ New man page for mcheck(3) and related functions
+ Also describes mcheck_check_all(3), mcheck_pedantic(3),
+ and mprobe(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+rcmd.3
+ Michael Kerrisk
+ Document "_af" variants of these functions
+ Document rcmd_af(), rresvport_af(), iruserok_af(), ruserok_af().
+ Also some restructuring and other clarifications.
+
+rexec.3
+ Michael Kerrisk
+ Document rexec_af()
+
+
+New and changed links
+---------------------
+
+iruserok_af.3
+rcmd_af.3
+rresvport_af.3
+ruserok_af.3
+ Michael Kerrisk
+ New links to rcmd.3
+
+rexec_af.3
+ Michael Kerrisk
+ New link to rexec.3
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Michael Kerrisk
+ Clarify difference between CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW
+ Note interactions of these two clocks with discontinuous
+ adjustments to the system time and NTP/adjtime(2).
+
+fallocate.2
+ Michael Kerrisk [John Sullivan]
+ Fix description of ENOSYS and EOPNOTSUP errors
+ As reported in https://bugzilla.redhat.com/show_bug.cgi?id=680214
+
+fchmodat.2
+ Michael Kerrisk [Mike Frysinger]
+ Improve discussion of difference between wrapper and underlying syscall
+
+gettimeofday.2
+ Michael Kerrisk
+ gettimeofday() is affected by discontinuous jumps in the system time
+ Advise reader to use clock_gettime(2), if they need a
+ monotonically increasing time source.
+ Michael Kerrisk
+ SEE ALSO: Add clock_gettime(2)
+
+prctl.2
+ Michael Kerrisk
+ Add PR_TASK_PERF_EVENTS_DISABLE and PR_TASK_PERF_EVENTS_ENABLE
+ Add some basic documentation of these operations, with a pointer to
+ tools/perf/design.txt for more information.
+ Michael Kerrisk [Marcel Holtmann]
+ Amend details of PR_SET_PDEATHSIG
+
+ptrace.2
+ Michael Kerrisk [Mike Frysinger]
+ Note SPARC deviation with respect to get/set regs
+ SPARC reverses the use of 'addr' and 'data' for
+ PTRACE_GETREGS, PTRACE_GETFPREGS, PTRACE_SETREGS,
+ and PTRACE_SETFPREGS.
+
+send.2
+ Stefan Puiu
+ Document EACCES error case for UDP
+
+sigaction.2
+ Michael Kerrisk
+ Remove mention of raise(3) for SI_USER
+ For a long time now, glibc's raise(3) didn't yield SI_USER
+ for the signal receiver, so remove mention of raise(3)
+ here. The user can deduce the details, if needed, by looking
+ at the recently updated raise(3) page.
+
+aio_cancel.3
+ Michael Kerrisk [Jon Grant]
+ Rewrite RETURN VALUE section to be clearer
+
+aio_init.3
+ Michael Kerrisk [Jon Grant]
+ Remove extraneous "POSIX" from NAME section
+
+btree.3
+dbopen.3
+hash.3
+mpool.3
+recno.3
+ Michael Kerrisk [Brian M. Carlson]
+ Note that glibc no longer provides these interfaces
+ glibc stopped providing these interfaces with v2.2.
+ Nowadays, the user that finds these pages probably wants
+ the libdb API, so note this in the page.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=337581
+
+fopen.3
+ Michael Kerrisk
+ BUGS: Note limitation on number of flag characters parsed in 'mode'
+ Michael Kerrisk
+ Note that 'c' and 'e' flags are ignored for fdopen()
+ Determined from reading libio/iofdopen.c.
+ Michael Kerrisk
+ Document ",ccs=string" feature of 'mode' for fopen()/freopen()
+
+getgrnam.3
+ Michael Kerrisk [Ulrich Drepper]
+ Fix discussion of _SC_GETGR_R_SIZE_MAX
+ The value is not meant to be a maximum (as was specified in
+ SUSv3) but an initial guess at the required size
+ (as specified in SUSv4).
+
+getpwnam.3
+ Michael Kerrisk [Ulrich Drepper]
+ Fix discussion of _SC_GETPW_R_SIZE_MAX
+ The value is not meant to be a maximum (as was specified in
+ SUSv3) but an initial guess at the required size
+ (as specified in SUSv4).
+
+malloc.3
+mallopt.3
+mtrace.3
+ Michael Kerrisk
+ SEE ALSO: add mcheck(3)
+
+memchr.3
+ Michael Kerrisk
+ Clarify description, omitting mention of "strings" and "characters"
+ The existing text slipped into talking about characters and
+ strings, which could mislead readers into thing that, for
+ example, searches for the byte '\0' are treated specially.
+ Therefore, rewrite in terms of "bytes" and "memory areas".
+
+ At the same time, make a few source file clean-ups.
+
+mkstemp.3
+ Michael Kerrisk
+ Add "mkstemps" and "mkostemps" to NAME line
+
+posix_openpt.3
+ Michael Kerrisk [Vadim Mikhailov]
+ Add some details on use of the slave pathname
+ An explicit pointer to ptsname(3) is useful, as is a note
+ of the fact that the slave device pathname exists only as
+ long as the master device is held open.
+
+raise.3
+ Michael Kerrisk
+ Add some notes on underlying system call that is used
+
+rcmd.3
+ Michael Kerrisk
+ Add some details of the rresvport() 'port' argument
+
+resolver.3
+ Petr Baudis
+ Note that many options are documented in resolv.conf(5)
+
+scandir.3
+ Michael Kerrisk [Daniel J Blueman]
+ Improve EXAMPLE source code: s/0/NULL/ in scandir() call
+
+strchr.3
+ James Hunt
+ Explain behavior when searching for '\0'
+
+strerror.3
+ Eric Blake [Stefan Puiu]
+ Improve strerror_r() description
+ POSIX requires that perror() not modify the static storage
+ returned by strerror(). POSIX 2008 and C99 both require that
+ strerror() never return NULL (a strerror() that always
+ returns "" for all inputs is valid for C99, but not for POSIX).
+
+ http://sourceware.org/bugzilla/show_bug.cgi?id=12204
+ documents glibc's change to come into compliance with POSIX
+ regarding strerror_r() return value. The GNU strerror_r() use
+ of 'buf' was confusing - I ended up writing a test program that
+ proves that 'buf' is unused for valid 'errnum', but contains
+ truncated "unknown message" for out-of-range 'errnum'.
+
+ See also http://austingroupbugs.net/view.php?id=382
+ Bernhard Walle
+ Correct description of error return for XSI strerror_r()
+ Michael Kerrisk [Eric Blake]
+ Note how to use 'errno' to detect errors when calling strerror()
+ Michael Kerrisk [Jon Grant]
+ Add an example of the kind of string returned by strerror()
+
+resolv.conf.5
+ Petr Baudis
+ Document "single-request" option
+
+inotify.7
+ Michael Kerrisk
+ Note buffer size that guarantees being able to read at least one event
+ James Hunt
+ Correct description of size of inotify_event structure
+
+iso_8859-1.7
+ Eugen Dedu
+ Add "-" for SOFT HYPHEN
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=156154
+
+netdevice.7
+ Brian F. G. Bidulock
+ Document some SIOC configuration ioctls
+ This patch adds common but missing SIOC configuration ioctls to
+ the netdevice.7 manual pages that are not documented anywhere
+ else. SIOCSIFPFLAGS and SIOCGIFPFLAGS are linux-specific. Flag
+ values come from Linux 2.6.25 kernel headers for sockios. The
+ others are standard BSD ioctls that have always been implemented
+ by Linux and were verified from inspecting netdevice.c kernel
+ code.
+
+socket.7
+ Michael Kerrisk [Alexey Toptygin]
+ Correct description of SO_BROADCAST
+
+tcp.7
+ lepton
+ Correct description for TCP_MAXSEG on modern kernel
+
+
+==================== Changes in man-pages-3.41 ====================
+
+Released: 2012-05-11, Christchurch
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Akihiro MOTOKI <amotoki@gmail.com>
+Andries E. Brouwer <Andries.Brouwer@cwi.nl>
+Angelo Borsotti <angelo.borsotti@gmail.com>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
+Casper Dik <Casper.Dik@oracle.com>
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Eric Blake <eblake@redhat.com>
+Hugh Dickins <hughd@google.com>
+Ivana Varekova <varekova@redhat.com>
+Jakub Jelinek <jakub@redhat.com>
+Jan Kara <jack@suse.cz>
+Jason Baron <jbaron@redhat.com>
+Jean-Michel Vourgère <jmv_deb@nirgal.com>
+Jeff Moyer <jmoyer@redhat.com>
+Josh Triplett <josh@joshtriplett.org>
+Kasper Dupont <kasperd@gmail.com>
+KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Lauri Kasanen <curaga@operamail.com>
+Mel Gorman <mgorman@suse.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Nick Piggin <npiggin@gmail.com>
+Paul Pluzhnikov <ppluzhnikov@google.com>
+Petr Baudis <pasky@ucw.cz>
+Ralph Corderoy <ralph@inputplus.co.uk>
+Rich Felker <bugdal@aerifal.cx>
+Simone Piccardi <piccardi@truelite.it>
+Simon Paillard <spaillard@debian.org>
+Stefan Puiu <stefan.puiu@gmail.com>
+Stephen Hemminger <shemminger@vyatta.com>
+Vincent Lefevre <vincent@vinc17.net>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+get_robust_list.2
+ Ivana Varekova [Michael Kerrisk]
+ New page documenting get_robust_list(2) and set_robust_list(2)
+
+mallinfo.3
+ Michael Kerrisk [KOSAKI Motohiro, Paul Pluzhnikov]
+ New page for mallinfo(3)
+
+malloc_info.3
+ Michael Kerrisk [Jakub Jelinek]
+ New page for malloc_info(3)
+
+malloc_stats.3
+ Michael Kerrisk [KOSAKI Motohiro]
+ New man page for malloc_stats(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+madvise.2
+ Jason Baron
+ Document MADV_DONTDUMP and MADV_DODUMP
+
+
+New and changed links
+---------------------
+
+set_robust_list.2
+ Michael Kerrisk
+ New link to new get_robust_list.2 page
+
+LIST_ENTRY.3
+LIST_HEAD.3
+LIST_INIT.3
+LIST_INSERT_AFTER.3
+LIST_INSERT_HEAD.3
+LIST_REMOVE.3
+TAILQ_ENTRY.3
+TAILQ_HEAD.3
+TAILQ_INIT.3
+TAILQ_INSERT_AFTER.3
+TAILQ_INSERT_HEAD.3
+TAILQ_INSERT_TAIL.3
+TAILQ_REMOVE.3
+CIRCLEQ_ENTRY.3
+CIRCLEQ_HEAD.3
+CIRCLEQ_INIT.3
+CIRCLEQ_INSERT_AFTER.3
+CIRCLEQ_INSERT_BEFORE.3
+CIRCLEQ_INSERT_HEAD.3
+CIRCLEQ_INSERT_TAIL.3
+CIRCLEQ_REMOVE.3
+ Michael Kerrisk
+ New link to queue.3
+ The queue(3) page documents these macros, so it makes sense to
+ have links for the names.
+
+DES_FAILED.3
+ Michael Kerrisk
+ New link to des_crypt.3
+ The des_crypt(3) page documents this macro, so it makes sense
+ to have a link for the name.
+
+qsort_r.3
+ Michael Kerrisk
+ New link to qsort.3
+ Overlooked to add this link in 3.38, when documentation of
+ qsort_r() was added to the qsort.3 page.
+
+
+Global changes
+--------------
+
+faccessat.2
+fchmodat.2
+fchownat.2
+fstatat.2
+futimesat.2
+inotify_init.2
+linkat.2
+mkdirat.2
+mknodat.2
+openat.2
+readlinkat.2
+renameat.2
+setns.2
+splice.2
+symlinkat.2
+sync.2
+tee.2
+unlinkat.2
+vmsplice.2
+ Michael Kerrisk [Lauri Kasanen]
+ Global fix: note glibc version that added library support
+
+confstr.3
+strcasecmp.3
+strcat.3
+strcmp.3
+strcpy.3
+strdup.3
+strftime.3
+strlen.3
+strnlen.3
+strpbrk.3
+strspn.3
+strtok.3
+strxfrm.3
+ Michael Kerrisk [Andries E. Brouwer]
+ Clarify that these functions operate on bytes, not (wide) characters
+ Change 'character(s)' to 'byte(s)' to make clear that these
+ functions operate on bytes, not wide / UTF8 characters.
+ (POSIX uses 'byte(s)' similarly, to make this point.)
+
+icmp.7
+ipv6.7
+packet.7
+raw.7
+rtnetlink.7
+unix.7
+x25.7
+ Michael Kerrisk
+ Remove names of constants from NAME line
+ Some of the sockets/network protocol pages included names of
+ the corresponding address family constants in the NAME line,
+ but this wasn't done consistently across all pages, and probably
+ it adds little value in those pages that did do this. So, remove
+ these constants from those pages that have them in the NAME
+ section.
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Michael Kerrisk [Josh Triplett]
+ Expand description of CLOCK_REALTIME
+ Make it clear that this clock may be discontinuous, and is
+ affected my incremental NTP and clock-adjtime(2) adjustments.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=540872
+
+epoll_wait.2
+ Michael Kerrisk
+ Clarify that 'timeout' is a *minimum* interval
+ Make it clear that 'timeout' is a minimum interval; the actual
+ interval will be rounded up to the system clock granularity,
+ and may overrun because of kernel scheduling delays.
+
+execve.2
+ Michael Kerrisk
+ Rewording to deemphasize libc5 details
+
+fork.2
+ Mike Frysinger
+ ERRORS: add ENOSYS
+ Can occur on, for example, non-MMU hardware.
+
+getcpu.2
+ Mike Frysinger
+ Add RETURN VALUE and ERRORS sections
+ Michael Kerrisk
+ Refer reader to NOTES for more info about 'tcache'
+ Michael Kerrisk
+ DESCRIPTION: reword a sentence to be clearer
+
+io_cancel.2
+io_destroy.2
+io_getevents.2
+io_setup.2
+io_submit.2
+ Michael Kerrisk
+ Rewrite to focus on system call API
+ Rewrite to focus on the system call interface, adding
+ some notes on the libaio wrapper differences.
+ See the following mail:
+ 2012-05-07 "aio manuals", linux-man@vger
+ http://thread.gmane.org/gmane.linux.man/1935/focus=2910
+
+ Other minor rewrites.
+
+mount.2
+ Michael Kerrisk
+ Comment out an old Linux libc detail
+
+open.2
+ Nick Piggin [KOSAKI Motohiro, Jan Kara, Hugh Dickins]
+ Describe race of direct I/O and fork()
+ Rework 04cd7f64, which didn't capture the details correctly.
+ See the April/May 2012 linux-man@ mail thread "[PATCH]
+ Describe race of direct read and fork for unaligned buffers"
+ http://thread.gmane.org/gmane.linux.kernel.mm/77571
+
+poll.2
+ Michael Kerrisk
+ Clarify that 'timeout' is a *minimum* interval
+ Make it clear that 'timeout' is a minimum interval; the actual
+ interval will be rounded up to the system clock granularity,
+ and may overrun because of kernel scheduling delays.
+ Michael Kerrisk
+ Clarify discussion of wrapper function emulation
+ Clarify that glibc (as well as old libc) provides emulation
+ using select(2) on older kernels that don't have a poll()
+ system call.
+ Michael Kerrisk
+ Make the meaning of a zero timeout explicit
+ Clarify that timeout==0 causes an immediate return, even if
+ no file descriptors are ready.
+
+pread.2
+ Michael Kerrisk [Kasper Dupont]
+ BUGS: Note O_APPEND + pwrite() does the wrong thing
+ See https://bugzilla.kernel.org/show_bug.cgi?id=43178
+
+recvmmsg.2
+ Michael Kerrisk
+ Clarify that 'timeout' is a *minimum* interval
+ Make it clear that 'timeout' interval will be rounded up to the
+ system clock granularity, and may overrun because of kernel
+ scheduling delays.
+
+select.2
+ Michael Kerrisk
+ Clarify that 'timeout' is a *minimum* interval
+ Make it clear that 'timeout' is a minimum interval; the actual
+ interval will be rounded up to the system clock granularity,
+ and may overrun because of kernel scheduling delays.
+ Michael Kerrisk
+ Expand description of the self-pipe trick
+ Michael Kerrisk
+ Add further details on pselect6() system call that underlies pselect()
+
+semop.2
+ Michael Kerrisk
+ Clarify that 'timeout' of semtimedop() is a *minimum* interval
+ Make it clear that 'timeout' interval will be rounded up to the
+ system clock granularity, and may overrun because of kernel
+ scheduling delays.
+
+signal.2
+ Michael Kerrisk
+ Note that 'sig_t' requires _BSD_SOURCE
+ Also remove some old Linux libc details
+
+sigwaitinfo.2
+ Michael Kerrisk
+ Clarify that 'timeout' of sigtimedwait() is a *minimum* interval
+ Make it clear that 'timeout' is a minimum interval; the actual
+ interval will be rounded up to the system clock granularity,
+ and may overrun because of kernel scheduling delays.
+
+stat.2
+ Bjarni Ingi Gislason
+ Formatting fixes
+ From "groff -ww" (or "man --warnings=w ..."):
+
+ warning: around line 442: table wider than line width
+
+ GNU man uses line length of 78.
+
+ Use text blocks. Two spaces between sentences or better: start
+ each sentence in a new line.
+
+syscalls.2
+ Bjarni Ingi Gislason
+ Formatting fixes
+ From "groff -ww ..." (or "man --warnings=w ..."):
+
+ warning: around line 157: table wider than line width
+
+ Have to use text blocks. Move some text to its correct column.
+ Split text to two columns to avoid hyphenation.
+
+sysinfo.2
+ Michael Kerrisk
+ Remove reference to obsolete libc5
+
+syslog.2
+ Michael Kerrisk
+ Remove some details about obsolete Linux libc
+
+aio_cancel.3
+aio_error.3
+aio_fsync.3
+aio_read.3
+aio_return.3
+aio_suspend.3
+aio_write.3
+ Michael Kerrisk
+ ERRORS: Add/update ENOSYS error
+
+aio_cancel.3
+ Michael Kerrisk
+ Clarify what happens when a request isn't successfully canceled
+ Michael Kerrisk
+ Add pointers to aio(7) and sigevent(7)
+
+dbopen.3
+ Michael Kerrisk
+ SYNOPSIS: Add header file <fcntl.h>
+ Upstreamed from Debian, and consistent with FreeBSD
+ dbopen(3) man page.
+
+fmemopen.3
+ Michael Kerrisk
+ Note details of POSIX.1-2008 specification of 'b' in 'mode'
+ Michael Kerrisk [Rich Felker]
+ BUGS: fmemopen() doesn't correctly set file position in some cases
+ If 'mode' is append, but 'size' does not cover a null byte
+ in 'buf', then fmemopen() incorrectly sets the initial file
+ position to -1, rather than the next byte after the end of
+ the buffer.
+
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=13151
+ Michael Kerrisk
+ BUGS: fmemopen() incorrectly handles size==0 case
+ If size is zero, fmemopen() fails, This is surprising behavior,
+ and not specified in POSIX.1-2008.
+
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=11216
+
+ Reported-by; Alex Shinn <alexshinn@gmail.com>
+ Michael Kerrisk
+ BUGS: Note silent ABI change for fmemopen() in glibc 2.9
+ Michael Kerrisk [Rich Felker]
+ BUGS: Append mode does not force writes to append
+ Append mode correctly sets the initial offset but does
+ not force subsequent writes to append at end of stream.
+
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=13152
+ Michael Kerrisk [Eric Blake]
+ BUGS: Note inconsistent treatment of 'b' in 'mode'
+ fopen() permits, for example, both "w+b" and "wb+",
+ but only the latter is meaningful to fmemopen().
+
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=12836
+
+fopencookie.3
+ Michael Kerrisk [Petr Baudis]
+ Correct description of return for user-supplied 'write' function
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=2074
+
+getaddrinfo.3
+ Jean-Michel Vourgère
+ Note that AI_ADDRCONFIG is not affected by loopback addresses
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=660479
+
+iconv.3
+ Michael Kerrisk
+ Upstream useful NOTE from Debian
+ Warn the reader that the pointer arguments can't be
+ interpreted as C style strings. Also, note possible
+ alignment requirements for the referenced bytes sequences,
+ Michael Kerrisk
+ Write a better paragraph introducing iconv() and its arguments
+
+isgreater.3
+ Michael Kerrisk [Vincent Lefevre]
+ Clarify that the arguments to these macros must be real-floating
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=609033
+
+lio_listio.3
+ Michael Kerrisk
+ Clarify that async notification occurs when *all* I/Os complete
+
+makedev.3
+ Michael Kerrisk
+ SYNOPSIS: Correct return types of major() and minor()
+ See https://bugzilla.redhat.com/show_bug.cgi?id=754188
+
+ Reported-by; Zdenek Kabelac <zkabelac@redhat.com>
+
+malloc.3
+ Michael Kerrisk
+ SEE ALSO: Add malloc_info(3)
+
+malloc_get_state.3
+ Michael Kerrisk
+ Fix wordos in function names in NAME line
+
+mallopt.3
+ Michael Kerrisk
+ Fix example program
+ The example code was a version that was not consistent with
+ the shell output shown on the page.
+
+ Reported-bY: Simon Paillard <spaillard@debian.org>
+ Michael Kerrisk
+ Restore accidentally omitted line in shell session
+ Michael Kerrisk
+ SEE ALSO: Add malloc_stats(3)
+
+mmap64.3
+ Michael Kerrisk
+ Change target of link to mmap.2 (was mmap2.2)
+ Upstreamed from Red Hat / Fedora
+
+realpath.3
+ Michael Kerrisk [Casper Dik]
+ Remove note about Solaris possibly returning a relative path
+
+syslog.3
+ Michael Kerrisk [Ralph Corderoy]
+ Document behavior when 'ident' argument to openlog() is NULL
+ See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/382096
+ Michael Kerrisk
+ Update CONFORMING TO for POSIX.1-2008
+ POSIX.1-2008 doesn't change any details, but make
+ that more explicit.
+
+undocumented.3
+ Michael Kerrisk
+ Remove some functions that have been documented
+
+sd.4
+ Michael Kerrisk
+ Remove reference to nonexistent scsi(4) page
+ Upstreamed from RedHat / Fedora
+
+sk98lin.4
+ Michael Kerrisk [Stephen Hemminger]
+ Note that this driver was removed in 2.6.28
+ See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/528020
+
+passwd.5
+ Michael Kerrisk
+ Upstream pieces from Red Hat/Fedora
+ Note mention of empty password field.
+ Add description of "*NP*" in password field.
+ Michael Kerrisk
+ Various minor fixes and improvements
+
+proc.5
+ Michael Kerrisk
+ Note that CAP_SYS_ADMIN processes can override file-max
+ Upstreamed from red Hat / Fedora
+ Michael Kerrisk
+ Document /proc/[pid]/cgroup
+ Upstreamed from Red Hat / Fedora
+
+resolv.conf.5
+ Michael Kerrisk
+ Take a Debian improvement into upstream
+
+tzfile.5
+ Michael Kerrisk
+ Mention timezone directories in DESCRIPTION
+ Note that timezone files are usually in /usr/lib/zoneinfo
+ or /usr/share/zoneinfo.
+ Michael Kerrisk
+ Drop SYNOPSIS
+ The SYNOPSIS doesn't correspond to a user-visible file.
+ Michael Kerrisk
+ SEE ALSO: Add pointer to glibc source file timezone/tzfile.h
+ Michael Kerrisk
+ SEE ALSO: add tzset(3) and tzselect(8)
+
+ascii.7
+ Bjarni Ingi Gislason
+ Indent for "troff" makes table too wide
+ Fix following from "groff -t -ww ...":
+
+ warning: around line 53: table wider than line width
+
+ Extra indent for "troff" makes the table look misplaced
+ (default "ps" output).
+
+cp1251.7
+ Bjarni Ingi Gislason
+ table too wide
+ From "nroff -ww -t ...":
+
+ warning: around line 44: table wider than line width
+
+ Columns are made narrower (column gutter decreased).
+
+ipv6.7
+ Stefan Puiu
+ Add ENODEV error for bind() to link-local IPv6 address
+
+signal.7
+ Michael Kerrisk [Simone Piccardi]
+ Clarify that SIGLOST is unused
+ Michael Kerrisk
+ Comment out crufty BUGS text on SIGLOST
+ It must be a very long time since the statement there
+ about SIGLOST was true. (The text seems to date back to
+ 1996.)
+ Michael Kerrisk
+ Update architectures for tables of signal numbers
+
+utf-8.7
+ Brian M. Carlson
+ Two clarifications
+ This patch clarifies that 0xc0 and 0xc1 are not valid in any UTF-8
+ encoding[0], and it also references RFC 3629 instead of RFC 2279.
+
+ [0] In order to have 0xc0, you'd have to have a two-byte encoding
+ with all the data bits zero in the first byte (and thus only six
+ bits of data), which would be an ASCII character encoded in the
+ non-shortest form. Similarly with 0xc1.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=538641
+
+ldconfig.8
+nscd.8
+ Michael Kerrisk
+ Remove path prefix from NAME line
+ Command names shown in NAME are normally just the basename,
+ not the full pathname of the command.
+
+
+==================== Changes in man-pages-3.42 ====================
+
+Released: 2012-08-14, Konolfingen
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Aaron Peschel <aaron.peschel@gmail.com>
+Adrian Dabrowski <atrox@seclab.tuwien.ac.at>
+Akihiro MOTOKI <amotoki@gmail.com>
+Alan Curry <pacman@kosh.dhis.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Christoph Lameter <cl@linux.com>
+Colin McCabe <cmccabe@alumni.cmu.edu>
+Daniel Zingaro <daniel.zingaro@utoronto.ca>
+David Prévot <taffit@debian.org>
+Denys Vlasenko <vda.linux@gmail.com>
+Henry Hu <henry.hu.sh@gmail.com>
+Herbert Xu <herbert@gondor.apana.org.au>
+Jan Engelhardt <jengelh@medozas.de>
+Jim Hill <gjthill@gmail.com>
+JoonSoo Kim <js1304@gmail.com>
+Kalle Olavi Niemitalo <kon@iki.fi>
+Martin H <textshell-tSIEzQ@neutronstar.dyndns.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael S. Tsirkin <mst@redhat.com>
+Rasmus Villemoes <Rasmus.Villemoes@decode.is>
+Sami Kerola <kerolasa@iki.fi>
+Sam Varshavchik <mrsam@courier-mta.com>
+Shawn Landden <shawnlandden@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Tolga Dalman <tolga.dalman@googlemail.com>
+Ulrich Drepper <drepper@gmail.com>
+Марк Коренберг <socketpair@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Global changes
+--------------
+
+Various pages
+ Sami Kerola
+ Global fix: use UR macro where applicable
+ The syntax .UR http://example.com paired with .UE will create
+ links which one can interact, if the pager allows that. One
+ way to see the effect is ask the man(1) command to use browser
+ display, e.g.:
+
+ man -H man7/uri.7
+
+ ("\:" is optional groff syntax to permit hyphenless line breaks.)
+
+
+Changes to individual pages
+---------------------------
+
+ldd.1
+ Michael Kerrisk
+ Add security note on untrusted executables
+ See also http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
+ and
+ http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html
+
+clone.2
+ Michael Kerrisk
+ Rewrite discussion of sys_clone
+
+futex.2
+ Марк Коренберг
+ Consolidate error descriptions to ERRORS
+ Michael Kerrisk
+ Various wording fix-ups
+ Michael Kerrisk
+ Fix description of EINVAL error
+ The current text seems incorrect. Replace with a more general
+ description.
+
+getdents.2
+select_tut.2
+atof.3
+atoi.3
+pthread_create.3
+pthread_sigmask.3
+rtime.3
+setbuf.3
+tsearch.3
+netlink.7
+ Michael Kerrisk [Jan Engelhardt]
+ Remove unneeded casts
+
+get_robust_list.2
+get_thread_area.2
+getcpu.2
+getdents.2
+gettid.2
+io_cancel.2
+io_destroy.2
+io_getevents.2
+io_setup.2
+io_submit.2
+ioprio_set.2
+kexec_load.2
+llseek.2
+modify_ldt.2
+mq_getsetattr.2
+pivot_root.2
+readdir.2
+rt_sigqueueinfo.2
+set_thread_area.2
+sgetmask.2
+spu_create.2
+spu_run.2
+subpage_prot.2
+sysctl.2
+tkill.2
+ Michael Kerrisk
+ Add note to SYNOPSIS that there is no glibc wrapper for system call
+ Reduce the chance that the reader may be misled into thinking
+ that there is a wrapper function for this system call by noting
+ explicitly in the SYNOPSIS that there is no glibc wrapper and
+ pointing the reader to NOTES for further details.
+
+ioprio_set.2
+ Colin McCabe
+ Clarify the multithreaded behavior of ioprio_set(2)
+ Michael Kerrisk [Марк Коренберг, Kalle Olavi Niemitalo]
+ Document who==0 for IOPRIO_WHO_PROCESS and IOPRIO_WHO_PGRP
+ For IOPRIO_WHO_PROCESS, who==0 means operate on the caller.
+ For IOPRIO_WHO_PGRP, who==0 means operate on the caller's
+ process group.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=652443
+
+migrate_pages.2
+ Michael Kerrisk [Christoph Lameter, JoonSoo Kim]
+ Fix description of return value
+
+mount.2
+ Michael Kerrisk
+ For MS_REMOUNT, source is ignored
+
+mprotect.2
+ Michael Kerrisk [Rasmus Villemoes]
+ 'addr' argument is not const
+ As reported by Rasmus:
+
+ Both my system's man-pages (3.22) and the latest online
+ (3.41) show:
+
+ int mprotect(const void *addr, size_t len, int prot);
+
+ as the prototype for mprotect(2). However, POSIX [1] and the
+ actual sys/mman.h (on all the systems I checked) do not have
+ the const qualifier on the first argument.
+
+msgctl.2
+semctl.2
+shmctl.2
+svipc.7
+ Michael Kerrisk
+ Don't mention that ipc_perm is defined in <sys/ipc.h>
+ There's no need to mention that the 'ipc_perm' structure
+ is defined in <sys/ipc.h>. That's an implementation detail,
+ and furthermore <sys/ipc.h> is itself included by the other
+ System V IPC header files. The current text might lead the
+ reader to conclude that they must include <sys/ipc.h>, which
+ is not the case (it is required neither on Linux, nor by the
+ standards).
+
+msgctl.2
+msgget.2
+msgop.2
+semctl.2
+semget.2
+semop.2
+shmctl.2
+shmget.2
+ Michael Kerrisk
+ NOTES: <sys/types.h> and <sys/ipc.h> aren't strictly needed
+ Add text to NOTES to say that the <sys/types.h> and <sys/ipc.h>
+ header files aren't required by Linux or the standards, but may
+ be needed for portability to old systems.
+
+ptrace.2
+ Denys Vlasenko
+ Explain WNOHANG behavior and EINTR bug
+ I didn't like the "SIGKILL operates similarly, with exceptions"
+ phrase (if it's different, then it's not "similar", right?),
+ and now I got around to changing it. Now it says simply:
+ "SIGKILL does not generate signal-delivery-stop and therefore
+ the tracer can't suppress it."
+
+ Replaced "why WNOHANG is not reliable" example with a more
+ realistic one (the one which actually inspired to add this
+ information to man page in the first place): we got
+ ESRCH - process is gone! - but waitpid(WNOHANG) can still
+ confusingly return 0 "no processes to wait for".
+
+ Replaced "This means that unneeded trailing arguments may
+ be omitted" part with a much better recommendation
+ to never do that and to supply zero arguments instead.
+ (The part about "undocumentedness" of gcc behavior was bogus,
+ btw - deleted).
+
+ Expanded BUGS section with the explanation and an example
+ of visible strace behavior on the buggy syscalls which
+ exit with EINTR on ptrace attach. I hope this will lead
+ to people submitting better bug reports to lkml about
+ such syscalls.
+
+seteuid.2
+ Michael Kerrisk
+ Note glibc version where setegid() implementation changed
+ In glibc 2.2/2.3, setegid() switched from setregid() to setresgid().
+
+set_tid_address.2
+ Michael Kerrisk
+ Rename 'ctid' argument for consistency with clone(2) page
+ Michael Kerrisk
+ Some rewordings and minor clarifications
+
+sigwaitinfo.2
+ Michael Kerrisk [Daniel Zingaro]
+ Some wording clarifications
+ Mainly rewording things like "is delivered" to "becomes pending",
+ which is more accurate terminology.
+
+syscall.2
+ Michael Kerrisk
+ Add some more details to the description of syscall(2)
+ And add another example of using syscall() to the program example.
+
+syscalls.2
+ Michael Kerrisk
+ Add kcmp(2)
+ Michael Kerrisk
+ Move discussion of set_zone_reclaim(2) out of main table
+ This system call was never visible to user space, so it makes
+ sense to move it out of the main table of system calls into
+ the notes below the table.
+
+getifaddrs.3
+ Michael Kerrisk [Adrian Dabrowski]
+ Note that ifa_addr and ifa_netmask can be NULL
+
+readdir.3
+ Michael Kerrisk [Jan Engelhardt]
+ Handle -1 error from pathconf() in example code snippet
+ Improve the example demonstrating allocation of a buffer
+ for readdir_r() to handle -1 error return from pathconf().
+ Otherwise, naive readers may think that pathconf() return
+ value can be used without checking.
+
+realpath.3
+ Shawn Landden
+ Use past tense with ancient history (libc4, libc5)
+
+regex.3
+ Michael Kerrisk
+ Correct SEE ALSO reference to glibc manual "regex" section
+
+rtime.3
+ Michael Kerrisk [Jan Engelhardt]
+ Fix broken pointer cast in example code
+
+sem_close.3
+sem_destroy.3
+sem_getvalue.3
+sem_init.3
+sem_open.3
+sem_post.3
+sem_unlink.3
+sem_wait.3
+sem_overview.7
+ Michael Kerrisk
+ Note that "cc -pthread" is required; "-lrt" no longer works
+ See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/874418
+
+sigwait.3
+ Michael Kerrisk
+ Reword "is delivered" to "becomes pending"
+
+strcat.3
+ Michael Kerrisk
+ Add some text to emphasize the dangers of buffer overruns
+ Michael Kerrisk
+ NOTES: Add discussion of strlcat()
+
+strcpy.3
+ Michael Kerrisk
+ Note that info is lost when strncpy() doesn't null terminate
+ Michael Kerrisk
+ Add some text to emphasize possibility of buffer runs with strcpy()
+ Michael Kerrisk
+ NOTES: Add a discussion of strlcpy()
+ Inspired by https://lwn.net/Articles/506530/
+ Michael Kerrisk
+ Fix description of the null-byte padding performed by strncpy()
+
+tsearch.3
+ Michael Kerrisk
+ NOTES: remove redundant discussion of unorthodox use of term "postorder"
+ This point is already covered at greater length in the main
+ text of the page (See the piece "More commonly, ...").
+ Michael Kerrisk
+ Clarify use for first argument to the twalk() 'action' function
+ There's a number of details in POSIX that are omitted in
+ the current version of this page.
+ Michael Kerrisk
+ Some wording fixes
+
+core.5
+ Michael Kerrisk
+ Note effect of madvise(2) MADV_DONTDUMP flag
+
+capabilities.7
+ Michael Kerrisk
+ Document CAP_BLOCK_SUSPEND
+
+glob.7
+ Bjarni Ingi Gislason
+ Change 8 bit characters to 7 bit representation
+ Fixes rendering errors for accented 'a' characters.
+ Michael Kerrisk [Aaron Peschel]
+ Update bash(1) command used to obtain classical globbing behavior
+ The man page formerly noted the bash(1) v1 command to do this.
+
+iso_8859-1.7
+ Bjarni Ingi Gislason
+ Explanation of SOFT HYPHEN and the code for it
+ <groff: iso_8859-2.7>:89: warning: can't find special character `shc'
+
+ This is the only "iso_8859-*.7" file that has this (now)
+ undefined character. The code in column four in "iso_8859-1.7" is
+ "0x2D" ("HYPHEN, MINUS SIGN" or "HYPHEN-MINUS") instead of "0xAD".
+ See Debian bug 156154 (or package "manpages").
+
+ There should be an explanation for this graphic character and the
+ code should be 0xAD in iso_8859-1.7 (as in all others), even
+ though "[gn]roff" does not display a "HYPHEN" in that position of
+ the table.
+
+ The line with "SOFT HYPHEN" gets a footnote and a short
+ explanation.
+
+mdoc.7
+ Bjarni Ingi Gislason
+ Fixing a warning and a table
+ Fis warning from "groff -ww ..." (or "man --warnings=w ..."):
+
+ <groff: mdoc.7>:294: warning:
+ tab character in unquoted macro argument
+
+ In one table the distance between columns is too small in the
+ "ps" output. (Bug in the groff "doc.tmac" macro?)
+
+mdoc.samples.7
+ Bjarni Ingi Gislason
+ Fix warnings from [ng]roff, corrections
+ From "man -ww ..." (groff -ww ...):
+
+ <standard input>:541: warning:
+ tab character in unquoted macro argument
+ [+3 similar warnings]
+ <standard input>:813: warning: macro `Pu' not defined
+ Usage: .Rv -std in sections 2 and 3 only (#1669)
+ mdoc warning: A .Bl directive has no matching .El (#1821)
+
+ String "Pu" defined as a row of punctuation characters.
+ ".Bl" and ".El" fixed.
+ Some arguments, that start with a period or are the name of a
+ macro, protected with "\&".
+ Variable name for macro ".Rv" corrected.
+
+netdevice.7
+ Bjarni Ingi Gislason
+ Line in table too long
+ Fix warning from "man ..." ("nroff -ww ..."):
+
+ nroff: netdevice.7: warning: around line 98:
+ table wider than line width
+
+ Fix: No right adjustment in text blocks in tables.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673873
+
+netlink.7
+ Bjarni Ingi Gislason
+ Line in table is too long
+ Fix warning from "man ..." ("nroff -ww ..."):
+
+ nroff: netlink.7: warning: around line 195:
+ table wider than line width
+
+ Horizontal line incorporated into table.
+ No right adjustment of text blocks in tables.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673875
+ Simon Paillard [Herbert Xu]
+ Change description of "*_pid" fields to "Port ID"
+ As reported by Herbert Xu, these should not be considered as PIDs.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=383296
+
+rtnetlink.7
+ Bjarni Ingi Gislason
+ Line in table too long
+ Fix warning from "man ..." ("nroff -ww ..."):
+
+ nroff: rtnetlink.7: warning: around line 415:
+ table wider than line width
+
+ Column gutter reduced to fit line length.
+ Right adjustment in text blocks removed in tables.
+ Some header made centered in tables.
+ One table put on same page.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674051
+
+socket.7
+ Martin H
+ Document SO_MARK socket option
+ Commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0 in Jan 2008 added
+ the new SO_MARK socket option.
+
+ This patch is based on text from the commit message.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=16461.
+
+svipc.7
+ Michael Kerrisk
+ SYNOPSIS: Remove include of <sys/types.h> and <sys/ipc.h>
+ Including <sys/types.h> and <sys/ipc.h> isn't needed on Linux
+ and isn't really relevant for the explanation on this page.
+
+
+==================== Changes in man-pages-3.43 ====================
+
+Released: 2012-10-05, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adrian Bunk <bunk@kernel.org>
+Anatoli Klassen <anatoli@aksoft.net>
+Andreas Schwab <schwab@linux-m68k.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+David Prévot <taffit@debian.org>
+Eric Dumazet <edumazet@google.com>
+Florian Weimer <fweimer@redhat.com>
+Frédéric Brière <fbriere@fbriere.net>
+Fredrik Arnerup <arnerup@kth.se>
+Guillem Jover <guillem@hadrons.org>
+Jan Engelhardt <jengelh@inai.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Simon Josefsson <simon@josefsson.org>
+Stephane Fillod <fillods@users.sf.net>
+Trevor Woerner <twoerner@gmail.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+getenv.3
+ Michael Kerrisk [Florian Weimer, Andreas Schwab]
+ Document secure_getenv(3)
+
+
+New and changed links
+---------------------
+
+phys.2
+ Michael Kerrisk
+ New link to unimplemented.2
+
+secure_getenv.3
+ Michael Kerrisk
+ New link to getenv.3
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/-/\\-/ when real hyphen is required (e.g., in code)
+
+Various pages
+ David Prévot [Michael Kerrisk]
+ Global fix: Various consistency fixes for SEE ALSO
+
+Various pages
+ Michael Kerrisk
+ Global fix: use "Linux kernel source" consistently
+ Rather than "kernel source".
+
+Various pages
+ Michael Kerrisk
+ Global fix: disable justification and hyphenation in SEE ALSO
+ For a better visual result, disable justification and hyphenation
+ in SEE ALSO where page names are long.
+
+syscalls.2
+uname.2
+boot.7
+ Michael Kerrisk
+ Global fix: s/OS/operating system/
+
+
+Changes to individual pages
+---------------------------
+
+epoll_wait.2
+ Michael Kerrisk [Fredrik Arnerup]
+ Describe timeout limitation in kernels < 2.6.37
+ As reported by Fredrik (and as far as I can tell the problem
+ went back to 2.6.0):
+
+ The timeout argument has an upper limit. Any values above that
+ limit are treated the same as -1, i.e. to wait indefinitely.
+ The limit is given by:
+
+ #define EP_MAX_MSTIMEO min(1000ULL * MAX_SCHEDULE_TIMEOUT / HZ, \
+ (LONG_MAX - 999ULL) / HZ)
+
+ That is, the limit depends on the size of a long and the timer
+ frequency. Assuming the a long is never smaller than 32 bits
+ and HZ never larger than 1000, the worst case is 35 minutes.
+ I think this should be mentioned under "BUGS".
+
+ Although this is likely to be fixed in the future
+ (http://lkml.org/lkml/2010/8/8/144), the problem exists in
+ at least 2.6.14 - 2.6.35. I don't know if select(2) and poll(2)
+ are affected.
+
+ https://bugzilla.kernel.org/show_bug.cgi?id=20762
+ Michael Kerrisk
+ Add pointer to select(2) for discussion of close in another thread
+
+getitimer.2
+ Michael Kerrisk [Trevor Woerner]
+ Note Linux's odd handling of the new_value==NULL case
+ Michael Kerrisk [Trevor Woerner]
+ Fix types used to declare fields in timeval struct
+
+keyctl.2
+ David Prévot
+ Reorder SEE ALSO, without .br
+
+poll.2
+ Michael Kerrisk
+ Add pointer to select(2) for discussion of close in another thread
+
+select.2
+ Michael Kerrisk [Stephane Fillod]
+ Note behavior if monitored file descriptor is closed in another thread
+ Executive summary: a sane application can't rely on any
+ particular behavior if another thread closes a file descriptor
+ being monitored by select().
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=40852
+ Michael Kerrisk
+ Clarify equivalent pselect() code in terms of threads
+ s/sigprogmask/pthread_sigmask/
+
+semop.2
+ Michael Kerrisk
+ Recast discussion of blocking behavior in terms of threads
+ semop() blocks the calling thread, not the process.
+ Michael Kerrisk
+ SEE ALSO: Add clone(2)
+ Give reader a clue about CLONE_SYSVSEM.
+
+shutdown.2
+ Michael Kerrisk [Eric Dumazet]
+ Document EINVAL error (and associated bug)
+ Eric Dumazet noted that EINVAL was not documented. Some further
+ digging shows that it's also not diagnosed consistently.
+ See https://bugzilla.kernel.org/show_bug.cgi?id=47111.
+
+sigaction.2
+ Michael Kerrisk
+ Tweak SA_RESETHAND description
+
+timer_settime.2
+ Michael Kerrisk
+ Small rewording around discussion of pointer arguments
+
+wait4.2
+ Adrian Bunk
+ Note that these functions are nonstandard and recommend alternatives
+ Some edits to Adrian's patch by mtk.
+ Michael Kerrisk
+ CONFORMING TO: Note SUS details for wait3()
+
+gnu_get_libc_version.3
+ Michael Kerrisk
+ Remove unneeded "#define _GNU_SOURCE" from SYNOPSIS
+
+pthread_kill.3
+pthread_sigqueue.3
+ Michael Kerrisk
+ Remove wording "another"
+ Writing "another thread" in these pages implies that these
+ functions can't be used to send a signal to the calling thread
+ itself, which is of course untrue.
+
+sigvec.3
+ Michael Kerrisk
+ Add "int" arg to sv_handler definition in sigvec structure
+ Michael Kerrisk
+ Fix small error in discussion of blocking of signals
+ The signal that causes the handler to be invoked is blocked,
+ but saying "by default" implies that this can be changed via
+ the API. It cannot. (One needs sigaction(2) for that.)
+
+syslog.3
+ Simon Josefsson
+ Remove (apparently bogus) text claiming LOG_AUTH is deprecated
+ LOG_AUTH is in POSIX, and widely available. There
+ seems to be no basis to the claim it is deprecated.
+
+ Quoting Simon:
+ I cannot find any other source that claim LOG_AUTH is
+ deprecated in any way. LOG_AUTH is distinct from
+ LOG_AUTHPRIV. The GNU C Library manual only documents
+ LOG_AUTH. The header files contains both without any
+ comment. Common systems like Debian appear to refer to
+ both auth and authpriv facilities in syslog configurations.
+ Popular daemons appear to use both facilities.
+ Both facilities are discussed in several RFCs.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=46091
+
+ttyname.3
+ Michael Kerrisk
+ SEE ALSO: Add ctermid(3)
+
+proc.5
+ Michael Kerrisk
+ Clarify header file related to 'flags' field of /proc/PID/stat
+ Michael Kerrisk [Frédéric Brière]
+ Update description of 'starttime' field of /proc/PID/stat
+ The unit of measurement changed from jiffies to clock ticks in
+ Linux 2.6.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=675891
+ Michael Kerrisk
+ Document /proc/sys/kernel/kptr_restrict
+ Michael Kerrisk [Kees Cook]
+ Document /proc/sys/fs/protected_symlinks
+ Based on text in Documentation/sysctl/fs.txt by Kees Cook
+ Michael Kerrisk [Kees Cook]
+ Document /proc/sys/fs/protected_hardlinks
+ Based on text in Documentation/sysctl/fs.txt by Kees Cook
+
+capabilities.7
+ Michael Kerrisk
+ Document interaction of CAP_SYSLOG and /proc/sys/kernel/kptr_restrict
+
+ip.7
+ Michael Kerrisk
+ SEE ALSO: Add ipv6(7)
+ SEE ALSO: Add icmp(7)
+
+man-pages.7
+ Michael Kerrisk
+ Add some advice about disabling hyphenation in SEE ALSO
+
+ld.so.8
+ Michael Kerrisk
+ Describe interpretation of slashes in dependency strings
+ Michael Kerrisk
+ Repeat note that LD_LIBRARY_PATH is ignored in privileged programs
+ This point is already noted when discussing search order for
+ libraries, but it's worth repeating under the specific discussion
+ of LD_LIBRARY_PATH further down the page.
+ Michael Kerrisk
+ Add some details for LD_PRELOAD
+ Note that LD_PRELOAD list separator can be space or colon
+
+
+==================== Changes in man-pages-3.44 ====================
+
+Released: 2012-11-07, Barcelona
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Bert Hubert <bert.hubert@netherlabs.nl>
+David Prévot <taffit@debian.org>
+James Youngman <jay@gnu.org>
+Kees Cook <keescook@chromium.org>
+Lars Wirzenius <liw@iki.fi>
+Lucas De Marchi <lucas.de.marchi@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Rusty Russell <rusty@rustcorp.com.au>
+Simon Paillard <spaillard@debian.org>
+Thomas Habets <thomas@habets.se>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+delete_module.2
+ Michael Kerrisk
+ Rewrite to Linux 2.6+ reality
+ Michael Kerrisk
+ Change license and copyright
+ There is now nothing left of the original FSF-copyrighted
+ page. So, change the copyright and license.
+ Michael Kerrisk [Lucas De Marchi, Rusty Russell]
+ Substantial reorganization after comments from Rusty Russell
+ Rusty notes that O_NONBLOCK is almost always used in
+ practice. Therefore, it would be better to reorganize
+ the page to consider that "the default".
+
+init_module.2
+ Michael Kerrisk
+ Rewrite to Linux 2.6+ reality
+ Michael Kerrisk
+ Change copyright and license
+ Little of the original page now remains. Change
+ copyright and license
+ Michael Kerrisk [Rusty Russell]
+ Changes after review comments from Rusty Russell
+ Kees Cook
+ Add various pieces describing Linux 2.6+ behavior
+ Pieces take from, or inspired by, a patch sent by Kees.
+
+getauxval.3
+ Michael Kerrisk
+ Document getauxval() function added in glibc 2.16
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: Use consistent capitalization in NAME section
+ The line(s) in the NAME section should only use capitals
+ where English usage dictates that. Otherwise, use
+ lowercase throughout.
+
+Various pages
+ Michael Kerrisk
+ Global fix: "userspace" ==> "user space" or "user-space"
+ Existing pages variously use "userspace or "user space".
+ But, "userspace" is not quite an English word.
+ So change "userspace" to "user space" or, when used
+ attributively, "user-space".
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+clock_nanosleep.2
+ Michael Kerrisk
+ Linking with -lrt is no longer needed from glibc 2.17 onward
+
+create_module.2
+ Michael Kerrisk
+ Note that this system call is present only in kernels before 2.6
+ Michael Kerrisk
+ Note that ENOSYS probably indicates kernel 2.6+
+
+execve.2
+ Michael Kerrisk
+ Document treatment of PR_SET_PDEATHSIG on execve()
+ Michael Kerrisk
+ Document treatment of SECBIT_KEEP_CAPS securebits flag on execve()
+
+fork.2
+ Michael Kerrisk
+ Note treatment of default timer slack value on fork()
+
+getdomainname.2
+ Simon Paillard [Lars Wirzenius]
+ Point out that these calls relate to NIS, not DNS
+ See http://bugs.debian.org/295635
+
+get_kernel_syms.2
+ Michael Kerrisk
+ Note that this system call is present only in kernels before 2.6
+
+ipc.2
+ Michael Kerrisk
+ Update note on architectures that don't have ipc()
+ Replace mention of ia64 with x86-64 and ARM.
+
+link.2
+ Michael Kerrisk
+ Add EPERM error triggered by /proc/sys/fs/protected_hardlink
+
+prctl.2
+ Michael Kerrisk
+ Mention Documentation/prctl/no_new_privs.txt for PR_SET_NO_NEW_PRIVS
+ Kees Cook
+ update seccomp sections for mode 2 (BPF)
+ This adds a short summary of the arguments used
+ for "mode 2" (BPF) seccomp.
+ Michael Kerrisk
+ Small improvements to PR_SET_SECCOMP discussion
+ Note type of 'arg3' for SECCOMP_MODE_FILTER.
+ Add pointer to Documentation/prctl/seccomp_filter.txt.
+ Michael Kerrisk
+ Note 'seccomp' semantics with respect to fork(), execve(), and prctl()
+ Michael Kerrisk
+ Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK
+ Michael Kerrisk
+ Reword PR_SET_NAME and PR_GET_NAME in terms of threads
+ Plus tfix
+ Kees Cook
+ document PR_SET_NO_NEW_PRIVS, PR_GET_NO_NEW_PRIVS
+ This adds a short description of the no_new_privs bit,
+ as described in Documentation/prctl/no_new_privs.txt.
+
+ptrace.2
+ Michael Kerrisk
+ Clarify that some operations are not present on all architectures
+ PTRACE_GETREGS, PTRACE_SETGREFS, PTRACE_GETFPREGS,
+ and PTRACE_GETSPREGS are not present on all architectures.
+ PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP are present only
+ on x86.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=122383
+
+query_module.2
+ Michael Kerrisk
+ Add a few words clarifying reference to /sys/module
+ Michael Kerrisk
+ Note that this system call is present only in kernels before 2.6
+ Michael Kerrisk
+ Note that ENOSYS probably indicates kernel 2.6+
+ Michael Kerrisk
+ SEE ALSO: Add modinfo(8) and lsinfo(8)
+ Michael Kerrisk
+ Move some information in NOTES to VERSIONS
+
+socketcall.2
+ Michael Kerrisk
+ Update note on architectures that don't have socketcall()
+ Replace mention of ia64 with x86-64 and ARM.
+
+times.2
+ Thomas Habets
+ Recommend clock_gettime(2) as alternative to times(2)
+
+clock_getcpuclockid.3
+ Michael Kerrisk
+ Linking with -lrt is no longer needed from glibc 2.17 onward
+
+fts.3
+ Simon Paillard [James Youngman]
+ Improve description of physical vs. logical tree walking
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=633505
+
+getenv.3
+ Michael Kerrisk
+ SEE ALSO: add getauxval(3)
+
+proc.5
+ Michael Kerrisk
+ Document /proc/meminfo
+ Info mostly taken from Documentation/filesystems/proc.txt
+ and Documentation/vm/hugetlbpage.txt.
+ Michael Kerrisk
+ Default for /proc/sys/fs/protected_{hardlinks,symlinks} is now 0
+ The default setting of 1 in/proc/sys/fs/protected_hardlinks
+ and /proc/sys/fs/protected_symlinks caused one too many
+ breakages for Linus's taste, so commit 561ec64ae67e changed
+ the default for both files to 0.
+ Note system call error yielded by /proc/sys/fs/protected_symlinks
+ Note that violating 'protected_symlinks' restrictions
+ causes system calls to fail with the error EACCES.
+ Michael Kerrisk
+ Since Linux 2.6.27, /proc/sys/kernel/modprobe depends on CONFIG_MODULES
+
+ipv6.7
+ Bert Hubert
+ Document IPV6_RECVPKTINFO
+
+man-pages.7
+ Michael Kerrisk
+ Note rules for capitalization in NAME section
+
+time.7
+ Michael Kerrisk
+ Add a subsection on timer slack
+
+ld.so.8
+ Michael Kerrisk
+ SEE ALSO: add getauxval(3)
+
+
+==================== Changes in man-pages-3.45 ====================
+
+Released: 2012-12-21, Christchurch
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andi Kleen <andi@firstfloor.org>
+Cyril Hrubis <chrubis@suse.cz>
+David Prévot <taffit@debian.org>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Eric Dumazet <eric.dumazet@gmail.com>
+Felipe Pena <felipensp@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+Gao Feng <gaofeng@cn.fujitsu.com>
+Jan Glauber <jang@linux.vnet.ibm.com>
+Jim Paris <jim@jtan.com>
+Jon Grant <jg@jguk.org>
+Julien Cristau <jcristau@debian.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Rens van der Heijden <rens.vanderheijden@uni-ulm.de>
+Simon Paillard <spaillard@debian.org>
+Thierry Vignaud <thierry.vignaud@gmail.com>
+Trevor Woerner <twoerner@gmail.com>
+YOSHIFUJI Hideaki <yoshfuji@linux-ipv6.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+s390_runtime_instr.2
+ Jan Glauber
+ New page for s390-specific s390_runtime_instr(2)
+
+if_nameindex.3
+ YOSHIFUJI Hideaki
+ Document if_nameindex(3) and if_freenameindex(3)
+ Michael Kerrisk
+ Edits, improvements and corrections to Hideaki's page
+ Michael Kerrisk
+ Add an example program
+
+if_nametoindex.3
+ YOSHIFUJI Hideaki
+ New page documenting if_nametoindex(3) and if_indextoname(3)
+
+
+New and changed links
+---------------------
+
+if_freenameindex.3
+ Michael Kerrisk
+ New link to if_nameindex.3
+
+if_indextoname.3
+ Michael Kerrisk
+ New link to if_nametoindex.3
+
+
+Global changes
+--------------
+
+sysconf.3
+cciss.4
+ Michael Kerrisk
+ Global fix: s/runtime/run time/
+
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Since 2.6.30, CLONE_NEWIPC also supports POSIX message queues
+
+delete_module.2
+ Michael Kerrisk
+ Small rewording of description of effect of O_TRUNC
+
+getrlimit.2
+ Michael Kerrisk [Trevor Woerner]
+ Document Linux's nonstandard treatment or RLIMIT_CPU soft limit
+ Upon encountering the RLIMIT_CPU soft limit when a SIGXCPU handler
+ has been installed, Linux invokes the signal handler *and* raises
+ the soft limit by one second. This behavior repeats until the
+ limit is encountered. No other implementation that I tested
+ (Solaris 10, FreeBSD 9.0, OpenBSD 5.0) does this, and it seems
+ unlikely to be POSIX-conformant. The (Linux-specific)
+ RLIMIT_RTTIME soft limit exhibits similar behavior.
+ Michael Kerrisk
+ Point reader at discussion of /proc/[pid]/limits in proc(5)
+
+io_getevents.2
+ Michael Kerrisk
+ io_getevents() may cause segfault when called with invalid ctx_id
+ For reference see: http://marc.info/?l=linux-aio&m=130089887002435&w=2
+
+recv.2
+ Michael Kerrisk [Eric Dumazet]
+ UNIX domain sockets support MSG_TRUNC since 3.4
+
+sendmmsg.2
+ Elie De Brauwer
+ Add example program for sendmmsg()
+
+stat.2
+ Simon Paillard
+ Clarify description of EOVERFLOW error
+ The EOVERFLOW error is not only for st_size, but also
+ inode and block size fields. See glibc source file
+ sysdeps/unix/sysv/linux/xstatconv.c and kernel source
+ file fs/stat.c. Also, fix bit/byte confusion
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604928
+
+syscalls.2
+ Michael Kerrisk
+ Update various references to "i386" to "x86"
+ Michael Kerrisk
+ Add s390_runtime_instr(2)
+
+sysctl.2
+ Michael Kerrisk
+ Mention CONFIG_SYSCTL_SYSCALL
+ Michael Kerrisk
+ Calls to sysctl() log warnings to the kernel log since 2.6.24
+
+syslog.2
+ Michael Kerrisk
+ Substantially reorganize discussion of commands
+ Make the layout of the discussion of the commands
+ more readable.
+ Michael Kerrisk
+ Add kernel symbolic 'type' names
+ Michael Kerrisk
+ Clarify SYSLOG_ACTION_SIZE_UNREAD semantics
+ SYSLOG_ACTION_SIZE_UNREAD returns the number of bytes
+ available for reading via SYSLOG_ACTION_READ.
+ Michael Kerrisk
+ Clarify where SYSLOG_ACTION_READ_ALL places data it reads
+ Michael Kerrisk
+ Clarify semantics of SYSLOG_ACTION_CLEAR
+ The SYSLOG_ACTION_CLEAR command (5) does not really clear
+ the ring buffer; rather it affects the semantics of what
+ is returned by commands 3 (SYSLOG_ACTION_READ_ALL) and
+ 4 (SYSLOG_ACTION_READ_CLEAR).
+ Michael Kerrisk
+ Clarify discussion of privileges for commands 3 and 10
+ Michael Kerrisk
+ Add mention of CONFIG_LOG_BUF_SHIFT
+
+wait.2
+ Michael Kerrisk
+ BUGS: Document odd waitid() behavior when 'infop' is NULL
+
+getifaddrs.3
+ Michael Kerrisk [Julien Cristau]
+ Update description of ifa_data to Linux 2.6+ reality
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778
+
+memcmp.3
+ Michael Kerrisk [Jon Grant]
+ Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
+ Note that sign of result equals sign of difference between
+ first two bytes that differ (treated as "unsigned char")."
+
+mkstemp.3
+ Michael Kerrisk [Florian Weimer]
+ Deemphasize discussion of mode 066 in glibc 2.0.6
+ Glibc 2.0.6 is now so ld that the discussion of details
+ of that version can be deemphasized placing just under
+ NOTES.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=51811
+
+strcmp.3
+ Michael Kerrisk [Jon Grant]
+ Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
+ Note that sign of result equals sign of difference between
+ first two bytes that differ (treated as "unsigned char")."
+
+ttyname.3
+ Michael Kerrisk
+ Fix confused text in ERRORS
+ The existing text suggested that the ERRORS applied
+ only for ttyname_r(). However, 2 of the 3 errors
+ can occur for ttyname().
+
+undocumented.3
+ Michael Kerrisk
+ Remove some now documented functions
+
+proc.5
+ Michael Kerrisk [Jim Paris]
+ Correct description of SwapFree in /proc/meminfo
+ Michael Kerrisk
+ Note change of /proc/[pid]/limits file permissions in 2.6.36
+
+resolv.conf.5
+ Simon Paillard
+ Document IPv6 format for nameserver
+ See: http://bugs.debian.org/610036
+
+capabilities.7
+ Michael Kerrisk [Rens van der Heijden]
+ Correct URL for POSIX.1e draft
+
+ipv6.7
+ Gao Feng
+ Add description of getsockopt() for IPV6_MTU
+ In IPv4,IP_MTU is only supported by getsockopt.
+ In IPv6, we can use IPV6_MTU to set socket's MTU,
+ but the return value of getsockopt() is the path MTU.
+
+rtnetlink.7
+ Michael Kerrisk [Julien Cristau]
+ Update description of IFLA_STATS to Linux 2.6+ reality
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778
+
+socket.7
+ Michael Kerrisk [YOSHIFUJI Hideaki]
+ Document 'sockaddr' and 'sockaddr_storage' types
+ Andi Kleen
+ Explain effect of SO_SNDTIMEO for connect()
+ When SO_SNDTIMEO is set before connect(), then connect()
+ may return EWOULDBLOCK when the timeout fires.
+
+
+==================== Changes in man-pages-3.46 ====================
+
+Released: 2013-01-27, Canberra
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andrew Perepechko <andrew_perepechko@xyratex.com>
+Cédric Boutillier <cedric.boutillier@gmail.com>
+Cyrill Gorcunov <gorcunov@openvz.org>
+Daan Spitz <daan.f.spitz@gmail.com>
+David Prévot <taffit@debian.org>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Garrett Cooper <yanegomi@gmail.com>
+James Noble <James.Noble@daktronics.com>
+Justin Lebar <justin.lebar@gmail.com>
+Kees Cook <keescook@chromium.org>
+Lucas De Marchi <lucas.demarchi@profusion.mobi>
+Mark Hills <mark@pogo.org.uk>
+Maxin B. John <maxin.john@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Gorny <mgorny@gentoo.org>
+Peter Budny <bigpeteb@gmail.com>
+Peter Lekeynstein <lekensteyn@gmail.com>
+Rusty Russell <rusty@rustcorp.com.au>
+Samuel Thibault <sthibault@debian.org>
+Sam Varshavchik <mrsam@courier-mta.com>
+Shawn Landden <shawnlandden@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Starlight <starlight.2013q1@binnacle.cx>
+Theodore Ts'o <tytso@mit.edu>
+Wolfgang Rohdewald <wolfgang@rohdewald.de>
+Zsbán Ambrus <ambrus@math.bme.hu>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+kcmp.2
+ Cyrill Gorcunov, Michael Kerrisk
+ New page for kcmp(2)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+init_module.2
+ Michael Kerrisk [Kees Cook, Rusty Russell, Lucas De Marchi]
+ Document finit_module(2)
+ Rusty Russell [Lucas De Marchi, Kees Cook]
+ Document finit_module() 'flags' argument
+ Document MODULE_INIT_IGNORE_MODVERSIONS and
+ MODULE_INIT_IGNORE_VERMAGIC. (Some edits by mtk.)
+
+
+New and changed links
+---------------------
+
+finit_module.2
+ Michael Kerrisk
+ New link to init_module.2
+
+__after_morecore_hook.3
+__free_hook.3
+__malloc_initialize_hook.3
+__memalign_hook.3
+__realloc_hook.3
+ Michael Kerrisk
+ New link to malloc_hook.3
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/tty/terminal/
+
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Add kernel versions for various CLONE_* constants
+ Michael Kerrisk
+ CLONE_NEWIPC governs mechanisms that don't have filesystem pathnames
+ Michael Kerrisk
+ CLONE_NEWIPC doesn't mount the POSIX MQ file system
+ Michael Kerrisk
+ Add an example program (CLONE_NEWUTS)
+ Michael Kerrisk
+ Some reworking of CLONE_NEWIPC text
+ No substantial content changes.
+ Michael Kerrisk
+ SEE ALSO: add kcmp(2)
+ SEE ALSO: add setns(2)
+
+fallocate.2
+ Michael Kerrisk
+ FALLOC_FL_* flags are defined in glibc only since 2.18
+
+getxattr.2
+removexattr.2
+setxattr.2
+ Michael Kerrisk [Andrew Perepechko, ]
+ Note that ENOATTR is a synonym for ENODATA
+ Various people have pointed out that strace(1) shows ENODATA
+ for the case where the named attribute does not exist, or
+ the process has no access to this attribute. ENODATA
+ and ENOATTR are in fact defined as synonyms. Point this out
+ in the man page, so that people understand the strace(1) info.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=51871
+
+getxattr.2
+listxattr.2
+removexattr.2
+setxattr.2
+ Michael Kerrisk
+ Put errors under ERRORS section
+ The errno values on these pages were listed in a nonstandard
+ way under the RETURN VALUE section. Put them in ERRORS sections.
+
+init_module.2
+ Michael Kerrisk [Rusty Russell]
+ ERRORS: Add errors for module signatures (EBADMSG, ENOKEY)
+
+link.2
+mkdir.2
+mknod.2
+open.2
+rename.2
+symlink.2
+write.2
+mkfifo.3
+ Mark Hills
+ Document EDQUOT error
+ The return error EDQUOT is not documented in open(2), write(2),
+ symlink(2) etc.
+
+ Whether inodes or disk blocks are required for each function
+ is something I based on received wisdom and BSD documentation,
+ rather than tracing the code to the kernel. For symlink(2)
+ this certainly depends on the file system type.
+
+listxattr.2
+ Michael Kerrisk [Theodore Ts'o]
+ Fix RETURN VALUE description
+ On success, 0 may be returned, so change wording from
+ "positive number" to "nonnegative number".
+
+outb.2
+ Michael Kerrisk
+ Add SYNOPSIS
+
+prctl.2
+ Kees Cook
+ Document PR_SET_PTRACER
+ Document the Yama LSM's prctl handler that allows processes to
+ declare ptrace restriction exception relationships via
+ PR_SET_PTRACER.
+ Michael Kerrisk
+ Make it explicit that PR_SET_PTRACER replaces previous setting
+ The attribute is a scalar, not a list.
+ Shawn Landden
+ Document EINVAL error for PR_SET_PTRACER
+ Michael Kerrisk
+ Document PR_GET_TID_ADDRESS
+
+ptrace.2
+ Michael Kerrisk
+ Document PTRACE_O_EXITKILL
+ Michael Kerrisk
+ Place PTRACE_SETOPTIONS list in alphabetical order
+
+query_module.2
+ Michael Kerrisk
+ Must be called using syscall(2)
+ Yes, the call is way obsolete, but add this info
+ for completeness.
+
+recvmmsg.2
+ Elie De Brauwer
+ Add/correct kernel version info for recvmmsg() and MSG_WAITFORNONE
+ This patch isolates the since/version related fixes as requested.
+ This change introduces the following delta:
+ * The page states it was added in 2.6.32 but it is only added
+ 2.6.33 (ref: http://kernelnewbies.org/Linux_2_6_33)
+ * The MSG_WAITFORONE flag was in turn only added in 2.6.34
+ (ref: http://kernelnewbies.org/Linux_2_6_34)
+ Elie De Brauwer
+ Add an example program
+
+setns.2
+ Michael Kerrisk
+ Add example program
+
+sigaction.2
+ Michael Kerrisk [Zsbán Ambrus]
+ Note feature test macro requirements for 'siginfo_t'
+ See https://bugzilla.kernel.org/show_bug.cgi?id=52931
+
+syscalls.2
+ Michael Kerrisk
+ Add kern_features(2)
+ Michael Kerrisk
+ Add utrap_install(2)
+ Sparc-specific, present since ancient times
+ Michael Kerrisk
+ Add finit_module(2)
+
+sysctl.2
+ Michael Kerrisk [Garrett Cooper]
+ ERRORS: EACCES as a synonym for EPRM
+ See https://bugzilla.kernel.org/show_bug.cgi?id=46731
+ and http://thread.gmane.org/gmane.linux.ltp/11413/focus=957635
+ From: Garrett Cooper <yanegomi <at> gmail.com>
+ Subject: Re: [LTP] [PATCH] sysctl03: sysctl returns EACCES after 2.6.33-rc1
+ Newsgroups: gmane.linux.kernel, gmane.linux.ltp
+ Date: 2010-03-04 18:35:33 GMT
+
+unshare.2
+ Michael Kerrisk
+ Update NOTES on unimplemented flags
+ Michael Kerrisk
+ Fix text problems in description of CLONE_FS
+ Michael Kerrisk
+ SEE ALSO: add kcmp(2)
+ SEE ALSO: add setns(2)
+ Michael Kerrisk
+ Reorder CLONE_NEWUTS entry in list
+
+difftime.3
+ Michael Kerrisk [Michal Gorny]
+ Remove crufty text about 'time_t' on "other systems"
+ Back in 2006, some text came in via Debian patches that seems
+ crufty. Remove it.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=46731
+
+getaddrinfo.3
+getnameinfo.3
+ Michael Kerrisk [Peter Budny]
+ Fix some confused references to function names
+ See https://bugzilla.kernel.org/show_bug.cgi?id=52741
+
+getspnam.3
+ Michael Kerrisk [Wolfgang Rohdewald]
+ ERRORS: Add EACCES
+ See https://bugzilla.kernel.org/show_bug.cgi?id=52681
+
+__setfpucw.3
+ Michael Kerrisk
+ Add proper page cross refs for alternate functions
+
+core.5
+proc.5
+ Kees Cook
+ Clarify suid_dumpable versus core_pattern
+ In Linux 3.6, additional requirements were placed on core_pattern
+ when suid_dumpable is set to 2. Document this and include commit
+ references.
+ Justin Lebar
+ statm's "shared" field refers to pages backed by files
+ I noticed that statm's "shared" field doesn't match the sum of
+ all the "shared" entries in smaps [1].
+
+ The kernel docs explain that statm's "shared" field is "number of
+ pages that are shared (i.e. backed by a file)" [2]. smaps appears
+ to call a page shared if it's mapped by at least two processes,
+ which explains this discrepancy.
+
+ I'm not a kernel hacker, but it appears to me they do mean "i.e."
+ and not "e.g." in the statm description: In
+ fs/proc/task_mmu.c::task_statm, I see
+
+ *shared = get_mm_counter(mm, MM_FILEPAGES);
+
+ Here's a patch which updates the man page to match the (hopefully
+ correct) kernel docs.
+
+ [1] https://bugzilla.mozilla.org/show_bug.cgi?id=807181
+ [2] http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob;f=Documentation/filesystems/proc.txt;h=a1793d670cd01bd374eddf54ffdfc768504291ff;hb=HEAD
+
+proc.5
+ Kees Cook
+ Put /proc/sys/kernel/hotplug in alphabetical order
+ Kees Cook
+ Document /proc/sys/kernel/dmesg_restrict
+ Kees Cook
+ Linux 3.4 changed permissions needed to change kptr_restrict
+ Michael Kerrisk [Samuel Thibault, Simon Paillard]
+ Add field numbers for /proc/PID/stat
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
+ Add numbering to /proc/stat "cpu" fields
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
+ Michael Kerrisk
+ Reorganize text describing /proc/stat "cpu" fields
+ Michael Kerrisk
+ Rewording of suid_dumpable text after comments from Kees Cook
+ Michael Kerrisk [Samuel Thibault, Simon Paillard]
+ Add field numbers for /proc/[pid]/statm
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
+ Michael Kerrisk
+ Document /proc/stat "cpu" "nice_guest" field
+ Info taken from commit ce0e7b28fb75cb003cfc8d0238613aaf1c55e797
+ Michael Kerrisk [Peter Lekeynstein]
+ Document /prod/[pid]/oom_score_adj
+ Text taken directly from Documentation/filesystems/proc.txt,
+ with some light editing.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=50421
+
+shells.5
+ Michael Kerrisk
+ Add /etc/bash to list of example shells
+
+ttytype.5
+ Michael Kerrisk
+ Add proper xref for termcap and terminfo pages
+
+capabilities.7
+ Michael Kerrisk
+ Add kcmp(2) under CAP_SYS_PTRACE
+
+man-pages.7
+ Michael Kerrisk
+ Update description of Section 7
+
+
+==================== Changes in man-pages-3.47 ====================
+
+Released: 2013-02-12, Christchurch
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Lennart Poettering <lennart@poettering.net>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peter Schiffer <pschiffe@redhat.com>
+Radek Pazdera <rpazdera@redhat.com>
+Reuben Thomas <rrt@sc3d.org>
+Shawn Landden <shawnlandden@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Vince Weaver <vweaver1@eecs.utk.edu>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+perf_event_open.2
+ Vincent Weaver
+ New page documenting perf_event_open(2)
+
+pthread_setname_np.3
+ Chandan Apsangi, Michael Kerrisk
+ New page for pthread_setname_np(3) and pthread_getname_np(3)
+
+sln.8
+ Michael Kerrisk [Peter Schiffer]
+ New page documenting the 'sln' command provided by glibc
+ Inspired by a Red Hat downstream page, but with rather
+ more detail.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+prctl.2
+ Michael Kerrisk [Shawn Landden, Lennart Poettering]
+ Document PR_SET_CHILD_SUBREAPER and PR_GET_CHILD_SUBREAPER
+
+ip.7
+ Radek Pazdera
+ Add source-specific multicast sockopts
+ This patch adds documentation of several source-specific multicast
+ socket options that were added to kernel with implementation
+ of IGMPv3 in 2.5.68.
+
+ The following socket options were added:
+ IP_ADD_SOURCE_MEMBERSHIP
+ IP_DROP_SOURCE_MEMBERSHIP
+ IP_BLOCK_SOURCE
+ IP_UNBLOCK_SOURCE
+ IP_MSFILTER
+
+
+Pages moved across sections
+---------------------------
+
+getcontext.3
+ Michael Kerrisk
+ This page really belongs in Section 3 (moved from Section 2)
+
+getdtablesize.3
+ Michael Kerrisk
+ Move from Section 2
+
+
+New and changed links
+---------------------
+
+getcontext.2
+ Michael Kerrisk
+ Make link to page moved into Section 3
+
+getdtablesize.2
+ Michael Kerrisk
+ Link to renamed getdtablesize.3
+
+setcontext.2
+ Michael Kerrisk
+ Modify link to point to Section 3
+
+pthread_getname_np.3
+ Michael Kerrisk
+ New link to new pthread_setname_np.3
+
+setcontext.3
+ Michael Kerrisk
+ Link to getcontext page renamed into Section 3
+
+
+Changes to individual pages
+---------------------------
+
+fallocate.2
+ Michael Kerrisk
+ SEE ALSO: add fallocate(1)
+
+flock.2
+ Michael Kerrisk
+ SEE ALSO: add flock(1)
+
+fork.2
+ Michael Kerrisk
+ SEE ALSO: add exit(2)
+
+getpriority.2
+ Michael Kerrisk
+ BUGS: note that nice value is per-thread on Linux
+
+getrlimit.2
+ Michael Kerrisk
+ SEE ALSO: add prlimit(1)
+
+gettid.2
+ Michael Kerrisk
+ SEE ALSO: add various system calls that use thread IDs
+
+ioprio_set.2
+ Michael Kerrisk
+ SEE ALSO: add ionice(1)
+
+sched_setaffinity.2
+ Michael Kerrisk
+ SEE ALSO: add taskset(1)
+
+sched_setparam.2
+ Michael Kerrisk
+ Scheduling policy and parameters are per-thread on Linux
+ Direct the reader to the discussion in sched_setscheduler(2).
+
+sched_setscheduler.2
+ Michael Kerrisk
+ Scheduling policy and parameters are per-thread on Linux
+ Michael Kerrisk
+ SEE ALSO: add chrt(1)
+
+setsid.2
+ Michael Kerrisk
+ SEE ALSO: add setsid(1)
+
+shmop.2
+ Michael Kerrisk [Peter Schiffer]
+ ERRORS: Add EIDRM
+ Taken from Red Hat downstream patch
+
+sigaction.2
+makecontext.3
+ Michael Kerrisk
+ Change getcontext/setcontext page ref to Section 3
+
+signal.2
+ Michael Kerrisk [Reuben Thomas]
+ Clarify System V vs BSD semantics for signal()
+
+syscalls.2
+ Michael Kerrisk
+ The list on this page is not just syscalls common to all platforms
+ Michael Kerrisk
+ Add perfctr(2)
+ Add ppc_rtas(2)
+ Michael Kerrisk
+ Add kernel version number of utrap_install(2)
+
+unimplemented.2
+ Michael Kerrisk [Peter Schiffer]
+ Remove mention of kernel version number in DESCRIPTION
+
+inet.3
+ Michael Kerrisk [Peter Schiffer]
+ Fix error in EXAMPLE using inet_aton()
+ See https://bugzilla.redhat.com/show_bug.cgi?id=837090
+ Patch taken from Red Hat downstream.
+
+posix_fallocate.3
+ Michael Kerrisk
+ SEE ALSO: add fallocate(1)
+
+regex.3
+ Reuben Thomas
+ Clarify details of matching
+ The first is that it's far from clear that the end points of the
+ complete string match are stored in the zero'th element of the
+ regmatch_t array; secondly, the phrase "next largest substring
+ match" is positively misleading, implying some sort of size
+ ordering, whereas in fact they are ordered according to their
+ appearance in the regex pattern.
+
+scanf.3
+ Michael Kerrisk
+ Clarify meaning of "string conversions" for 'm' modifier
+ Mike Frysinger
+ Update %a vs %m documentation
+ POSIX.1-2008 adopted the 'm' flag for dynamic allocation. Update
+ page to cover it and relegate the glibc-specific 'a' flag to
+ NOTES.
+
+strtol.3
+ Michael Kerrisk [Peter Schiffer]
+ Replace some bogus text about "thousands separator"
+ See https://bugzilla.redhat.com/show_bug.cgi?id=652870
+
+sysconf.3
+ Michael Kerrisk [Peter Schiffer]
+ Use "_SC_PAGESIZE" consistently on page
+ s/_SC_PAGE_SIZE/_SC_PAGESIZE/ in one instance.
+ From Red Hat downstream patch.
+
+nscd.conf.5
+ Peter Schiffer
+ Add max-db-size and auto-propagate descriptions, default values, + misc
+ * added missing valid services (services and netgroup)
+ * added many default values for options
+ * reordered options according to the nscd.conf file
+ (logical order)
+ * added 2 missing options: max-db-size and auto-propagate
+
+nsswitch.conf.5
+ Peter Schiffer
+ Mention initgroups db
+
+proc.5
+ Michael Kerrisk
+ Document /proc/profile
+ Michael Kerrisk [Peter Schiffer]
+ Update /proc/sys/fs/file-nr to include Linux 2.6 details
+ Michael Kerrisk
+ Clarify relationship between file-max and file-nr
+ The third value in /proc/sys/fs/file-nr is the same as
+ the value in /proc/sys/fs/file-max.
+ Michael Kerrisk
+ Note message written to kernel log when file-max limit is hit
+ Info from Documentation/sysctl/fs.txt.
+ Michael Kerrisk
+ Mention lscpu(1) under discussion of /proc/cpuinfo
+
+resolv.conf.5
+ Michael Kerrisk [Peter Schiffer]
+ Document "single-request-reopen" option
+ Taken from Red Hat downstream patch
+
+ See https://bugzilla.redhat.com/show_bug.cgi?id=717770
+ See http://thread.gmane.org/gmane.linux.man/3161
+
+utmp.5
+ Michael Kerrisk
+ SEE ALSO: add utmpdump(1)
+
+cpuset.7
+ Simon Paillard
+ Add missing 'cpuset.' prefix for some flags
+ See kernel commit e21a05cb408bb9f244f11a0813d4b355dad0822e
+
+svipc.7
+ Michael Kerrisk
+ SEE ALSO: add ipcmk(1), ipcrm(1), ipcs(1)
+
+termio.7
+ Michael Kerrisk
+ SEE ALSO: add reset(1), setterm(1), stty(1), tty(4)
+
+ld.so.8
+ Michael Kerrisk [Peter Schiffer]
+ LD_VERBOSE does not work with ld.so --list and --verify
+ From Red Hat downstream patch
+
+ See https://bugzilla.redhat.com/show_bug.cgi?id=532629
+ Michael Kerrisk
+ SEE ALSO: add sln(8)
+
+zdump.8
+ Michael Kerrisk [Peter Schiffer]
+ Bring up to date with zdump --help
+ Patch taken from Red Hat downstream.
+
+
+==================== Changes in man-pages-3.48 ====================
+
+Released: 2013-03-05, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andrey Vagin <avagin@openvz.org>
+Aristeu Rozanski <aris@ruivo.org>
+Colin Walters <walters@verbum.org>
+Cyril Hrubis <chrubis@suse.cz>
+Cyrill Gorcunov <gorcunov@openvz.org>
+Daniel P. Berrange <berrange@redhat.com>
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Denys Vlasenko <vda.linux@googlemail.com>
+Flavio Leitner <fbl@redhat.com>
+Graham Gower <graham.gower@gmail.com>
+Ivana Varekova <varekova@redhat.com>
+Kai Kunschke <kai@kunfoo.org>
+Marcela Maslanova <mmaslano@redhat.com>
+Marc Lehmann <debian-reportbug@plan9.de>
+Marshel Abraham <Marshel.Abraham@in.bosch.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Nathan Stratton Treadway <kernelbugs@nathanst.com>
+Pavel Emelyanov <xemul@parallels.com>
+Peter Schiffer <pschiffe@redhat.com>
+Simon Heimberg <simohe@besonet.ch>
+Simon Paillard <spaillard@debian.org>
+Török Edwin <edwintorok@gmail.com>
+Ulrich Drepper <drepper@redhat.com>
+Zack Weinberg <zackw@panix.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+getunwind.2
+ Marcela Maslanova
+ New page documenting getunwind(2)
+ Taken from Red Hat downstream man pages set
+ Michael Kerrisk
+ Much rewriting
+ Some text taken from arch/ia64/kernel/unwind.c.
+
+perfmonctl.2
+ Ivana Varekova
+ New page documenting IA-64-specific perfmonctl(2)
+ Taken from Red Hat downstream man pages
+ Michael Kerrisk
+ Rework discussion of PFM_CREATE_CONTEXT
+ Add VERSIONS and CONFORMING TO
+ Note that there is no glibc wrapper
+ Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
+ These don't exist, and it appears they never have.
+ Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
+ The types that were being used don't exist!
+ Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL
+
+gai.conf.5
+ Ulrich Drepper
+ New page documenting gai.conf
+ Taken from Red Hat downstream pages
+
+nss.5
+ Ulrich Drepper
+ New page describing nss.conf
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clock_getres.2
+ Cyril Hrubis
+ Document CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE
+ Cyril Hrubis
+ Document CLOCK_BOOTTIME
+ Michael Kerrisk
+ Some improvements to CLOCK_BOOTTIME description
+
+ptrace.2
+ Denys Vlasenko
+ Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends
+ Document PTRACE_GETREGSET, PTRACE_SETREGSET,
+ PTRACE_SEIZE, PTRACE_INTERRUPT, and PTRACE_LISTEN.
+
+
+New and changed links
+---------------------
+
+fattach.2
+fdetach.2
+getmsg.2
+isastream.2
+putmsg.2
+ Michael Kerrisk [Peter Schiffer]
+ New link to unimplemented.2
+ Taken from Red Hat downstream.
+
+ See https://bugzilla.redhat.com/show_bug.cgi?id=436407
+
+
+Global changes
+--------------
+
+Many pages
+ Michael Kerrisk
+ Global fix: remove unneeded double quotes in .SH headings
+
+Many pages
+ Michael Kerrisk
+ Global fix: remove unneeded double quotes in .SS headings
+
+Many pages
+ Michael Kerrisk
+ Global fix: use consistent capitalization in .SS headings
+ Capitalization in .SS sections across pages (and sometimes even
+ within a single page) is wildly inconsistent. Make it consistent.
+ Capitalize first word in heading, but otherwise use lower case,
+ except where English usage (e.g., proper nouns) or programming
+ language requirements (e.g., identifier names) dictate otherwise.
+
+Many pages
+ Michael Kerrisk [Denys Vlasenko]
+ Remove double blank lines in output
+
+Various pages
+ Michael Kerrisk
+ Fix order of SH sections
+
+
+Changes to individual pages
+---------------------------
+
+accept.2
+ Michael Kerrisk
+ NAME: Add "accept4"
+
+access.2
+ Colin Walters
+ Note that access() may also fail for FUSE
+ Since in some cases (e.g. libguestfs's guestmount) it also has the
+ semantics where files can appear owned by root, but are actually
+ mutable by the user, despite what one might infer from the Unix
+ permissions.
+
+getpeername.2
+ Michael Kerrisk [Kai Kunschke]
+ Clarify semantics of getpeername() for datagram sockets
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674034
+
+getuid.2
+ Michael Kerrisk
+ Remove duplicate section heading
+
+mmap.2
+ Cyril Hrubis
+ Add note about partial page in BUGS section
+ This adds a note about Linux behavior with partial page at the end
+ of the object. The problem here is that a page that contains only
+ part of a file (because the file size is not multiple of PAGE_SIZE)
+ stays in page cache even after the mapping is unmapped and the file
+ is closed. So if some process dirties such page, other mappings
+ will see the changes rather than zeroes.
+ Michael Kerrisk [Török Edwin]
+ Some 'flags' values require a feature test macro to be defined
+ Add text to NOTES noting that some MAP_* constants are
+ defined only if a suitable feature test macro is defined.
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=542601
+ Cyril Hrubis
+ Document EOVERFLOW error
+
+open.2
+ Michael Kerrisk
+ Clarify list of file creation flags
+ POSIX.1-2008 TC1 clarified this, so that O_CLOEXEC,
+ O_DIRECTORY, and O_NOFOLLOW are also in this list.
+
+prctl.2
+ Cyrill Gorcunov
+ Add some details for PR_GET_TID_ADDRESS
+
+read.2
+ Michael Kerrisk [Zack Weinberg]
+ Clarify interaction of count==0 and error checking
+ POSIX deliberately leaves this case open, so the man
+ page should be less specific about what happens.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533232
+ Michael Kerrisk [Marc Lehmann]
+ Remove crufty text about O_NONBLOCK on files
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700529
+ Michael Kerrisk
+ Clarify details for seekable files
+
+unimplemented.2
+ Michael Kerrisk [Peter Schiffer]
+ Add various STREAMS interfaces to NAME
+ Taken from Red Hat downstream.
+
+ See https://bugzilla.redhat.com/show_bug.cgi?id=436407
+
+cexp2.3
+ Michael Kerrisk
+ Still does not exist in glibc 2.17
+
+exit.3
+ Michael Kerrisk
+ Note that a call to execve() clears exit handler registrations
+
+getaddrinfo.3
+ Michael Kerrisk
+ SEE ALSO: Add gai.conf(5)
+
+malloc_trim.3
+ Michael Kerrisk
+ Remove duplicate section title
+
+printf.3
+ Marshel Abraham [Graham Gower, Graham Gower]
+ Fix error handling in example code
+ See https://bugzilla.kernel.org/show_bug.cgi?id=23282
+
+pthread_yield.3
+ Michael Kerrisk [Aristeu Rozanski]
+ Add _GNU_SOURCE feature test macro to SYNOPSIS
+
+resolver.3
+resolv.conf.5
+ Michael Kerrisk [Nathan Stratton Treadway, Simon Heimberg]
+ RES_DEBUG is only available if glibc is compiled with debug support
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=692136
+ and https://bugzilla.kernel.org/show_bug.cgi?id=43061
+
+strtol.3
+ Michael Kerrisk [Peter Schiffer]
+ Remove crufty text from previous fix
+
+core.5
+ Michael Kerrisk
+ Document CONFIG_COREDUMP
+
+capabilities.7
+ Andrey Vagin
+ Nonexistent bits are no longer shown as set in /proc/PID/status Cap*
+
+inotify.7
+ Michael Kerrisk
+ A monitoring process can't easily distinguish events triggered by itself
+
+ip.7
+ Flavio Leitner [Peter Schiffer]
+ Improve explanation about calling listen() or connect()
+
+man-pages.7
+ Michael Kerrisk
+ Describe rules for capitalization in .SS headings
+
+rtnetlink.7
+ Pavel Emelyanov
+ Add info about ability to create links with given index
+ Since kernel v3.7 the RTM_NEWLINK message now accepts nonzero
+ values in ifi_index field. Mention this fact in the respective
+ rtnetlink.7 section.
+
+socket.7
+ Pavel Emelyanov
+ SO_BINDTODEVICE is now readable
+ SO_BINDTODEVICE is readable since since kernel 3.8.
+
+
+==================== Changes in man-pages-3.49 ====================
+
+Released: 2013-03-10, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Michael Kerrisk <mtk.manpages@gmail.com>
+
+
+Global changes
+--------------
+
+The goal of the changes below to consistently format copyright
+and license information in the comments in the page source
+at the top of each page. This allows for easy scripting to
+extract that information. Following these changes the comments
+the top of the page source should now consistently have the form:
+
+ .\" <copyright info, possibly spread over several lines>
+ .\"
+ .\" %%%LICENSE_START(<license-type>)
+ .\" <license text>
+ .\" %%%LICENSE_END
+ .\" <other comments>
+
+Note that the 'license-type' is merely descriptive. Its purpose is
+to simplify scripting for the purpose of gathering statistics on
+types of licenses used in man-pages. It is NOT a statement about
+the actual licensing of the page; that license is contain INSIDE the
+LICENSE_START...LICENSE_END clause.
+
+All pages
+ Michael Kerrisk
+ Add a LICENSE_START()...LICENSE_END clause in source at
+ top of each page that encapsulates the license text.
+ Michael Kerrisk
+ Put copyright info at top of page, followed by blank line and LICENSE
+
+Various pages
+ Michael Kerrisk
+ Update info in source comments on where to get a copy of the GPL
+
+Various pages
+ Michael Kerrisk
+ Remove "Hey Emacs" comment in page source
+ Only certain pages have this; there is no consistency, so
+ remove it from all pages
+ Michael Kerrisk
+ Remove "-*- nroff -*-" comment at top of source
+
+
+==================== Changes in man-pages-3.50 ====================
+
+Released: 2013-03-15, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andrey Vagin <avagin@openvz.org>
+Bernhard Kuemel <bernhard@bksys.at>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Erik Saule <erik.saule@bmi.osu.edu>
+Florian Weimer <fweimer@bfk.de>
+Friedrich Delgado Friedrichs <friedel@nomaden.org>
+Jonathan Nieder <jrnieder@gmail.com>
+Jose Luis Domingo Lopez <debian@24x7linux.com>
+Mark R Bannister <mark@proseconsulting.co.uk>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Sam Varshavchik <mrsam@courier-mta.com>
+Simon Paillard <spaillard@debian.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+canonicalize_file_name.3
+ Michael Kerrisk
+ Rewrite page, adding much more detail
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/END_LICENSE/LICENSE_END/
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/bitmask/bit mask/
+
+
+Changes to individual pages
+---------------------------
+
+getent.1
+ Mark R Bannister
+ netgroup description incorrectly refers to initgroups
+
+capget.2
+ Michael Kerrisk
+ Update URL for libcap
+
+fork.2
+ Michael Kerrisk
+ Port access permission bits (ioperm()) are turned off in the child
+
+futex.2
+ Michael Kerrisk
+ 'timeout' is a minimum duration that the call will wait, not a maximum
+
+ioperm.2
+ Michael Kerrisk
+ Note that iopl() level of 3 is needed to access ports
+ Michael Kerrisk
+ 'num' is *bits* not bytes!
+ Michael Kerrisk
+ Linux 2.6.8 lifted the port limit to 65,536
+ See http://article.gmane.org/gmane.linux.kernel/202624/
+ From: Stas Sergeev <stsp <at> aknet.ru>
+ Subject: [patch][rfc] Larger IO bitmap
+ Date: 2004-05-07 19:55:03 GMT
+ Michael Kerrisk
+ ioperm() operates on the calling *thread* (not process)
+ Michael Kerrisk
+ Clarify meaning of 'turn_on' argument
+ Plus form formatting fixes.
+ Michael Kerrisk
+ Clarify that default state of permission bits in child is off
+ Michael Kerrisk
+ NOTES: add mention of /proc/ioports
+ Michael Kerrisk
+ SEE ALSO: add outb(2)
+
+iopl.2
+ Michael Kerrisk
+ CAP_SYS_RAWIO is required to *raise* the I/O privilege level
+ Michael Kerrisk
+ Clarify that the two least significant bits of 'level' are what matter
+ Michael Kerrisk
+ SEE ALSO: add outb(2)
+
+syscalls.2
+ Michael Kerrisk
+ Add version information for all (other) syscalls
+ Michael Kerrisk
+ Add perfmonctl(2)
+
+futimes.3
+ Michael Kerrisk [Jonathan Nieder]
+ ERRORS: Add ENOSYS for lutimes()
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=620746
+
+getpass.3
+ Michael Kerrisk [Erik Saule]
+ Suggest use of the ECHO flag as an alternative
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=644261
+
+realpath.3
+ Michael Kerrisk
+ Document GNU extensions for EACCES and ENOENT errors
+
+stdarg.3
+ Michael Kerrisk [Friedrich Delgado Friedrichs]
+ Describe va_copy()
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=575077
+
+termios.3
+ Michael Kerrisk [Bernhard Kuemel]
+ Mention that noncanonical mode does not do input processing
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=643854
+
+random.4
+ Elie De Brauwer
+ Document write and document the ioctl interface of /dev/random
+ The update consists out of two parts:
+ - a minor thing which just documents what happens if a write to
+ /dev/(u)random is performed, which is used in the example
+ script but not explicitly mentioned.
+ - the other (biggest) part is the documentation of the ioctl()
+ interface which /dev/(u)random exposes. This ioctl() lives in
+ drivers/char/random.c and the primitives can be found in
+ include/linux/random.h
+
+ One comment remains, there used to be an RNDGETPOOL ioctl() which
+ disappeared in v2.6.9. I found two patches on the net:
+ - http://www.kernel.org/pub/linux/kernel/people/akpm/patches/2.6/2.6.8.1/2.6.8.1-mm4/broken-out/dev-random-remove-rndgetpool-ioctl.patch
+ - https://lkml.org/lkml/2004/3/25/168
+
+ But as far as I can tell the first one got applied but the 2nd
+ one seems more correct. The result is that even today one can
+ still find traces of the RNDGETPOOL ioctl() in the header files.
+ Is this there for historical reasons or because it might break
+ userspace, even though using it will just give an EINVAL.
+
+bootparam.7
+ Jose Luis Domingo Lopez
+ Document 'rootfstype' option
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182014
+
+capabilities.7
+ Michael Kerrisk
+ Add various pieces under CAP_SYS_RAWIO
+ Info obtained by grepping the kernel source.
+ Michael Kerrisk
+ Add CAP_SYS_RESOURCE /proc/PID/oom_score_adj case
+
+netlink.7
+ Andrey Vagin
+ Add a note about broadcast messages to multiple groups
+
+socket.7
+ Michael Kerrisk [Florian Weimer]
+ Define _GNU_SOURCE to obtain the definition of 'struct ucred'
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572210
+
+
+==================== Changes in man-pages-3.51 ====================
+
+Released: 2013-04-17, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andreas Jaeger <aj@suse.de>
+Andrew Clayton <andrew@digital-domain.net>
+Brian M. Carlson <sandals@crustytoothpaste.net>
+Changhee Han <ch0.han@lge.com>
+Cyril Hrubis <chrubis@suse.cz>
+Damien Grassart <damien@grassart.com>
+David Prévot <taffit@debian.org>
+Denis Barbier <bouzim@gmail.com>
+Jeff Moyer <jmoyer@redhat.com>
+Krzysztof Konopko <krzysztof.konopko@gmail.com>
+Kyle McMartin <kyle@mcmartin.ca>
+Mark H Weaver <mhw@netris.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Nicolas Hillegeer <nicolas@hillegeer.com>
+Pavel Emelyanov <xemul@parallels.com>
+Peter Schiffer <pschiffe@redhat.com>
+Radek Pazdera <rpazdera@redhat.com>
+Ralph Loader <suckfish@ihug.co.nz>
+Simon Paillard <spaillard@debian.org>
+The Wanderer <wanderer@fastmail.fm>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+sched_rr_get_interval.2
+ Michael Kerrisk
+ Document /proc/sys/kernel/sched_rr_timeslice_ms
+
+proc.5
+ Pavel Emelyanov
+ Document /proc/[pid]/map_files directory
+ This directory was added in Linux v3.3 and provides info about
+ files being mmap-ed in a way very similar to how /proc/[pid]/fd
+ works.
+
+ v2: Added examples of how links look like and noted dependency
+ on kernel config option CONFIG_CHECKPOINT_RESTORE.
+ Michael Kerrisk
+ Document /proc/sys/kernel/shm_rmid_forced
+
+capabilities.7
+ Michael Kerrisk
+ Document /proc/sys/kernel/cap_last_cap
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Global fix: fix placement of word "only"
+
+Various pages
+ Simon Paillard
+ License headers: consistent format
+
+Various pages
+ Michael Kerrisk
+ Global fix: s/since kernel/since Linux/
+
+Various System V IPC pages in Section 2
+ Michael Kerrisk
+ Add "System V" to .TH line and text
+ Make it clear that these pages relate to System V IPC,
+ not POSIX IPC.
+
+
+Changes to individual pages
+---------------------------
+
+access.2
+ Michael Kerrisk [The Wanderer]
+ Clarify RETURN VALUE for F_OK
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=705293
+
+alarm.2
+ Michael Kerrisk
+ Correct the description of behavior when 'seconds' is 0
+
+clone.2
+ Michael Kerrisk [Peter Schiffer]
+ Add prototype for syscall to SYNOPSIS
+ And further clarify the distinction between the system call
+ and the wrapper function in the introductory text.
+ Michael Kerrisk
+ Update feature test macro requirements
+ The requirements quietly changed changed in glibc 2.14
+
+ See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
+ Michael Kerrisk [Mike Frysinger]
+ Clarify differences between clone2() syscall and wrapper function
+ Michael Kerrisk [Mike Frysinger]
+ Note those architectures where the sys_clone argument order differs
+ Michael Kerrisk [Mike Frysinger]
+ Add short subsection noting that blackfin, m68k, and sparc are different
+ Michael Kerrisk
+ Move clone2() text to subsection in description
+ The description of ia64 clone2() should follow the discussion
+ of the raw system call interface.
+ Michael Kerrisk
+ Change subhead for ia64 discussion
+
+getcpu.2
+ Michael Kerrisk
+ Recommend that 'tcache' should be specified as NULL nowadays
+
+io_cancel.2
+ Jeff Moyer, Michael Kerrisk [Cyril Hrubis]
+ Improve description
+
+io_destroy.2
+ Jeff Moyer
+ Improve description
+ The description was rather vague, citing a "list of I/O contexts"
+ and stating that it "can" cancel outstanding requests. This
+ update makes things more concrete so that the reader knows exactly
+ what's going on.
+
+io_getevents.2
+ Jeff Moyer
+ The 'timeout' argument is not updated
+ I looked back through the kernel code, and the timeout was
+ never updated in any case. I've submitted a patch upstream
+ to change the comment above io_getevents.
+
+io_setup.2
+ Jeff Moyer
+ Clarify nr_events
+ nr_events is technically the number of completion events that can
+ be stored in the completion ring. The wording of the man page:
+ "capable of receiving at least nr_events" seems dubious to me,
+ only because I worry that folks might interpret that to mean
+ 'nr_events' total, instead of 'nr_events' concurrently.
+
+ Further, I've added information on where to find the per-user
+ limit on 'nr_events', /proc/sys/fs/aio-max-nr. Let me know if
+ you think that is not relevant.
+
+listxattr.2
+ Michael Kerrisk
+ Explain use of 'size' argument
+
+lseek.2
+ Michael Kerrisk [Andreas Jaeger]
+ _GNU_SOURCE must be defined to get SEEK_DATA 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_handle_at(2) page
+
+
+Global changes
+--------------
+
+fmemopen.3
+getaddrinfo.3
+mq_notify.3
+offsetof.3
+aio.7
+ Michael Kerrisk
+ Print size_t/ssize_t values using %z printf() modifier
+ There are fewer and fewer systems these days that don't
+ support the %z specifier mandated in C99. So replace the
+ use of %ld/%lu + (long) cast with %zd/%zu.
+
+
+Changes to individual pages
+---------------------------
+
+bdflush.2
+fsync.2
+sync.2
+ Kir Kolyshkin
+ SEE ALSO: remove update(8) reference
+ Remove reference to update(8) man page, since there is no such
+ page. This is an ancient BSD leftover I believe.
+
+chown.2
+ Michael Kerrisk
+ Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
+
+getxattr.2
+ Abhay Sachan
+ Fix RETURN VALUE description
+ A EA can have length zero.
+
+inotify_add_watch.2
+ Michael Kerrisk
+ ERRORS: add ENAMETOOLONG
+
+inotify_init.2
+ Michael Kerrisk
+ Add pointer to inotify(7)
+
+link.2
+ Michael Kerrisk
+ When AT_EMPTY_PATH is specified, 'olddirfd' must not refer to a
+ directory
+
+mmap.2
+ Andrey Vagin
+ The file descriptor for a file mapping must be readable
+ There is no difference between MAP_SHARED and MAP_PRIVATE.
+
+open.2
+ Michael Kerrisk
+ SEE ALSO: add open_by_name_at(2)
+
+perf_event_open.2
+ Vince Weaver
+ Document PERF_EVENT_IOC_PERIOD behavior change
+ Linux 3.14 (in commit bad7192b842c83e580747ca57104dd51fe08c223)
+ changes the perf_event PERF_EVENT_IOC_PERIOD ioctl() behavior
+ on all architectures to update immediately, to match the behavior
+ found on ARM.
+
+stat.2
+ Michael Kerrisk
+ Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
+
+syscalls.2
+ Michael Kerrisk
+ Add sched_getattr() and sched_setattr()
+ And update kernel version to 3.14
+
+abort.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function abort() is thread safe.
+
+confstr.3
+ Michael Kerrisk
+ SEE ALSO: add getconf(1), fpathconf(3), sysconf(3), pathconf(3)
+
+exit.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function exit() is not thread safe.
+
+fenv.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions feclearexcept(), fegetexceptflag(), feraiseexcept(),
+ fesetexceptflag(), fetestexcept(), fegetround(), fesetround(),
+ fegetenv(), feholdexcept(), fesetenv(), feupdateenv(),
+ feenableexcept(), fedisableexcept() and fegetexcept() are thread
+ safe.
+
+fpathconf.3
+ Michael Kerrisk
+ SEE ALSO: add confstr(3)
+
+fseek.3
+ Michael Kerrisk [Petr Gajdos]
+ Document EINVAL error for negative file offset
+
+fseeko.3
+ Michael Kerrisk
+ Add feature test macro requirements
+
+fts.3
+ Michael Kerrisk [Mike Frysinger]
+ Remove mention of "32-bit systems" in BUGS
+
+fwide.3
+wprintf.3
+ Michael Kerrisk [Robert P. J. Day]
+ Remove mention of bogus _ISOC95_SOURCE feature test macro
+
+getline.3
+ Alexey Samsonov
+ Caller should free the allocated buffer even if getline() failed
+ Relevant discussion in glibc bugzilla:
+ https://sourceware.org/bugzilla/show_bug.cgi?id=5666
+
+getloadavg.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getloadavg() is thread safe.
+
+getpt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getpt() is thread safe.
+
+if_nametoindex.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions if_nametoindex() and if_indextoname() are thread safe.
+
+index.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions index() and rindex() are thread safe.
+
+mkfifo.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mkfifo() and mkfifoat() are thread safe.
+
+netlink.3
+ Michael Kerrisk
+ SEE ALSO: make the reference for libnetlink the libnetlink(3) man page
+
+random.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions random(), srandom(), initstate() and setstate()
+ are thread safe.
+
+random_r.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions random_r(), srandom_r(), initstate_r() and
+ setstate_r() are thread safe.
+
+sigvec.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sigvec(), sigblock(), sigsetmask() and
+ siggetmask() are thread safe.
+
+ The macro sigmask() is thread safe.
+
+sysconf.3
+ Michael Kerrisk
+ SEE ALSO: add confstr(3)
+
+termios.3
+ Michael Kerrisk [Peter Hurley]
+ Fix error in discussion of MIN > 0, TIME == 0 noncanonical mode
+ As reported by Peter Hurley, for the MIN > 0, TIME == 0 case:
+
+ read() may unblock when MIN bytes are available but return
+ up to the 'count' parameter if more input arrives in between
+ waking and copying into the user buffer.
+ ...
+ read() may also _not_ return until MIN bytes have been
+ received, even if 'count' bytes have been received.
+ Michael Kerrisk
+ Add a note on interaction of O_NONBLOCK with noncanonical MIN/TIME
+ POSIX leaves the behavior open.
+ Michael Kerrisk
+ Clarify termination conditions for MIN > 0, TIME > 0
+ Michael Kerrisk
+ Clarify behavior if data is available before noncanonical read()
+ Michael Kerrisk
+ Add descriptive titles to noncanonical read() cases
+
+symlink.7
+ Michael Kerrisk
+ Add subsection on opening a symbolic link with O_PATH
+ Michael Kerrisk
+ name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
+ Michael Kerrisk
+ Mention use of readlink(2) to read contents of a symlink
+
+
+==================== Changes in man-pages-3.65 ====================
+
+Released: 2014-04-20, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alex Thorlton <athorlton@sgi.com>
+Ashish Sangwan <a.sangwan@samsung.com>
+Christopher Covington <cov@codeaurora.org>
+Christoph Hellwig <hch@infradead.org>
+Craig McQueen <craig.mcqueen@beamcommunications.com>
+Dave Chinner <david@fromorbit.com>
+David Prévot <taffit@debian.org>
+Greg Troxel <gdt@ir.bbn.com>
+Matthew Dempsky <mdempsky@chromium.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Namjae Jeon <namjae.jeon@samsung.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Petr Gajdos <pgajdos@suse.cz>
+Richard Hansen <rhansen@bbn.com>
+Simon Paillard <spaillard@debian.org>
+Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+inet_net_pton.3
+ Michael Kerrisk
+ New page describing inet_net_pton(3) and inet_net_ntop(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fallocate.2
+ Michael Kerrisk, Namjae Jeon [Christoph Hellwig, Dave Chinner]
+ Document FALLOC_FL_COLLAPSE_RANGE
+
+prctl.2
+ Michael Kerrisk [Alex Thorlton]
+ Document PR_SET_THP_DISABLE and PR_GET_THP_DISABLE
+
+proc.5
+ Michael Kerrisk
+ Document /proc/[pid]/stack
+ Michael Kerrisk
+ Document /proc/[pid]/clear_refs
+
+
+New and changed links
+---------------------
+
+inet_net_ntop.3
+ Michael Kerrisk
+ New link to new inet_net_pton.3
+
+
+Changes to individual pages
+---------------------------
+
+fcntl.2
+ Michael Kerrisk
+ Note the race when O_CLOEXEC is used at same time as fork()+execve()
+
+madvise.2
+ Michael Kerrisk
+ SEE ALSO: see prctl(2)
+ Because of PR_SET_THP_DISABLE.
+
+mlock.2
+ Michael Kerrisk
+ Describe treatment of MCL_FUTURE during fork(2) and execve(2)
+
+msync.2
+ Michael Kerrisk [Richard Hansen, Greg Troxel]
+ Warn that one of MS_SYNC or MS_ASYNC is required
+
+open.2
+ Michael Kerrisk
+ Add more detail on the race that O_CLOEXEC is designed to avoid
+ Michael Kerrisk [Matthew Dempsky]
+ Remove crufty text stating that O_DIRECTORY is Linux-specific
+ Michael Kerrisk
+ Note which filesystems support O_TMPFILE
+
+perf_event_open.2
+ Vince Weaver [Michael Kerrisk]
+ Clarify EACCES and EPERM errors
+ Clarify the reasons for EACCES and EPERM errors.
+ Vince Weaver [Michael Kerrisk]
+ Make the ERRORS section more comprehensive.
+ Determined both by code inspection and by writing a large
+ number of test programs.
+
+personality.2
+ Michael Kerrisk
+ Available execution domains are listed in <sys/personality.h>
+ Michael Kerrisk
+ Fix discussion of return value
+
+prctl.2
+ Michael Kerrisk
+ ERRORS: document EINVAL for PR_GET_NO_NEW_PRIVS
+ ERRORS: document EINVAL for PR_SET_PDEATHSIG
+ ERRORS: document EINVAL for PR_SET_TIMING
+ ERRORS: document EINVAL for PR_SET_DUMPABLE
+ ERRORS: document EINVAL for PR_SET_NO_NEW_PRIVS
+
+shmget.2
+ Michael Kerrisk
+ Rewrite description of SHMMNI default value
+ Michael Kerrisk
+ Note default value of SHMMAX
+ Note default value for SHMALL
+
+byteorder.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions htonl(), htons(), ntohl() and ntohs() are thread
+ safe.
+
+fexecve.3
+ Michael Kerrisk [Steven Stewart-Gallus]
+ If 'fd' is a close-on-exec file descriptor for a script, fexecve() fails
+ See https://bugzilla.kernel.org/show_bug.cgi?id=74481
+
+ffs.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ffs(), ffsl() and ffsll() are thread safe.
+
+getauxval.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getauxval() is thread safe.
+
+getcontext.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions getcontext() and setcontext() are thread safe.
+
+getsubopt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getsubopt() is thread safe.
+
+getutmp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions getutmp() and getutmpx() are thread safe.
+
+inet.3
+ Michael Kerrisk
+ Note success and error return for inet_aton()
+
+inet.3
+ Michael Kerrisk [Craig McQueen]
+ The form 'a.b' if is suitable for Class A addresses (not class C)
+ Michael Kerrisk
+ SEE ALSO: add inet_net_pton(3)
+
+makecontext.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions makecontext() and swapcontext() are thread safe.
+
+pthread_attr_setdetachstate.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setdetachstate() and
+ pthread_attr_getdetachstate() are thread safe.
+
+pthread_attr_setguardsize.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setguardsize() and
+ pthread_attr_getguardsize() are thread safe.
+
+sigsetops.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sigemptyset(), sigfillset(), sigaddset(),
+ sigdelset(), sigismember(), sigisemptyset(), sigorset() and
+ sigandset() are thread safe.
+
+proc.5
+ Petr Gajdos
+ Improve /proc/[pid]/smaps entries description
+ Michael Kerrisk
+ /proc/PID/smaps is present only if CONFIG_PROC_PAGE_MONITOR
+ Michael Kerrisk
+ Note kernel version for /proc/sys/kernel/{shmall,shmmax}
+ Michael Kerrisk
+ Note kernel version for /proc/sys/kernel/{msgmax,msgmnb}
+
+capabilities.7
+ Michael Kerrisk
+ SEE ALSO: add capsh(1)
+
+libc.7
+ Michael Kerrisk
+ Add musl libc
+
+
+==================== Changes in man-pages-3.66 ====================
+
+Released: 2014-05-08, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alan Curry <rlwinm@sdf.org>
+Carsten Andrich <carsten.andrich@tu-ilmenau.de>
+Daniel Borkmann <dborkman@redhat.com>
+David Prévot <taffit@debian.org>
+Eric Siegerman <pub08-knl@davor.org>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Jan Kara <jack@suse.cz>
+Jan Moskyto Matejka <mq@suse.cz>
+John Marshall <jm18@sanger.ac.uk>
+Lukáš Czerner <lczerner@redhat.com>
+Manfred Spraul <manfred@colorfullife.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Miklos Szeredi <miklos@szeredi.hu>
+Neil Horman <nhorman@tuxdriver.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Schiffer <pschiffe@redhat.com>
+Randy Dunlap <rdunlap@infradead.org>
+Silvan Jegen <s.jegen@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Stefan Puiu <stefan.puiu@gmail.com>
+Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
+Stijn Hinterding <contact@stijnhinterding.nl>
+Willem de Bruijn <willemb@google.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+fanotify_init.2
+ Heinrich Schuchardt, Michael Kerrisk
+ New page documenting fanotify_init(2)
+
+fanotify_mark.2
+ Heinrich Schuchardt, Michael Kerrisk
+ New page documenting fanotify_mark(2)
+
+sched_setscheduler.2
+ Michael Kerrisk
+ Page rewritten
+ Stripped out the general scheduling material, which
+ moved to sched(7), and rewrote much of the remainder.
+ Changed copyright and license since pretty much all
+ of the content was or is written by mtk.
+
+fanotify.7
+ Heinrich Schuchardt, Michael Kerrisk
+ New page providing overview of the fanotify API
+
+sched.7
+ Michael Kerrisk
+ New page providing an overview of the scheduling APIs
+ Most of this content derives from sched_setscheduler(2). In
+ preparation for adding a sched_setattr(2) page, it makes
+ sense to isolate out this general content to a separate
+ page that is referred to by the other scheduling pages.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fallocate.2
+ Lukas Czerner [Michael Kerrisk]
+ Document FALLOC_FL_ZERO_RANGE
+ FALLOC_FL_ZERO_RANGE was added in Linux 3.14,
+ for zeroing ranges in the allocated space in a file.
+
+rename.2
+ Miklos Szeredi [Michael Kerrisk]
+ Document renameat2() system call added in Linux 3.15
+
+shmop.2
+ Michael Kerrisk
+ Document SHM_EXEC
+
+
+Changes to individual pages
+---------------------------
+
+flock.2
+ Michael Kerrisk
+ Employ term "open file description" in DESCRIPTION
+ And include reference to open(2) for an explanation of the term.
+
+getpriority.2
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+getsockopt.2
+ Carsten Andrich
+ SEE ALSO: add packet(7)
+
+link.2
+ Michael Kerrisk [Steven Stewart-Gallus]
+ Document ENOENT error for linkat()
+ See https://bugzilla.kernel.org/show_bug.cgi?id=73301
+
+msgget.2
+ Michael Kerrisk
+ Reword EEXIST error
+
+msgop.2
+ Michael Kerrisk
+ Note capability required to raise MQ size beyond MSGMNB
+
+msync.2
+ Michael Kerrisk [Heinrich Schuchardt]
+ s/flushes... back to disk/flushes... back to filesystem/
+
+nice.2
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+open.2
+ Peter Schiffer
+ Update note on alignment of user buffer and file offset for O_DIRECT
+ The sentence in open(2) man page in notes for O_DIRECT flag:
+
+ "Under Linux 2.6, alignment to 512-byte boundaries suffices."
+
+ is not universally correct. The alignment is a property of the
+ storage, for example, 4k-sector drives with no 512 byte sector
+ emulation will be unable to perform 512-byte direct I/O.
+ Michael Kerrisk
+ Note some of the various synonyms for "open file description"
+ Michael Kerrisk
+ Remove repetitious text on use of fcntl() to change file status flags
+
+open_by_handle_at.2
+ Michael Kerrisk
+ Mention FreeBSD analogs
+
+posix_fadvise.2
+ Michael Kerrisk [Eric Siegerman]
+ Fix wording error under "Architecture-specific variants"
+ See https://bugzilla.kernel.org/show_bug.cgi?id=75431
+
+process_vm_readv.2
+ Michael Kerrisk [Stijn Hinterding]
+ Add feature test macro requirements
+ The _GNU_SOURCE FTM must be defined.
+
+read.2
+ Michael Kerrisk
+ BUGS: detail nonatomicity bug with respect to file offset updates
+ This bug was fixed in Linux 3.14, with commit
+ 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
+ See also http://thread.gmane.org/gmane.linux.kernel/1649458
+
+sched_get_priority_max.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_rr_get_interval.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_setaffinity.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_setparam.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+sched_yield.2
+ Michael Kerrisk
+ Small changes consistent with migration of content to sched(7)
+
+semget.2
+ Michael Kerrisk
+ Consolidate discussion on noninitialization of semaphores
+ The fact that semget() does not initialize the semaphores
+ in a new set was covered in two places (in DESCRIPTION
+ and BUGS). Consolidate these into one place (in NOTES)
+ and also point out that POSIX.1-2008 says that a future
+ version of the standard may require an implementation to
+ initialize the semaphores to 0.
+ Michael Kerrisk
+ Clarify SEMMNS versus SEMMSL*SEMMNI
+ Michael Kerrisk
+ Rework EINVAL text a little
+ Michael Kerrisk
+ Clarify wording for EEXIST error
+
+shmget.2
+ Manfred Spraul
+ Clarify SHMALL
+ The default for SHMALL is a limit of 8 GB, regardless of
+ PAGE_SIZE. The current documentation does not mention that
+ and is therefore more difficult to understand than necessary.
+ Manfred Spraul
+ Correct math error
+ 2097152 is 2^21, not 2^20.
+ Michael Kerrisk
+ Reword EEXIST error
+ Michael Kerrisk
+ Clarify one of the EINVAL cases
+ Michael Kerrisk
+ Note that SHM_NORESERVE is a Linux extension
+ Michael Kerrisk [Simon Paillard]
+ Fix kernel version numbers in discussion of SHMALL
+ Michael Kerrisk
+ Rework EINVAL text
+ Michael Kerrisk
+ Move and rework discussion of mode bits
+ Michael Kerrisk
+ Reword description of O_EXCL
+
+shmop.2
+ Michael Kerrisk
+ Move fork(2), execve(2), _exit(2) discussion to NOTES
+ Michael Kerrisk
+ Add subheads for shmat() and shmdt()
+ Michael Kerrisk
+ Rework discussion of SHM_RDONLY and SHM_REMAP into list format
+ Michael Kerrisk
+ Structure the attach cases as a list
+
+sigaction.2
+ Alan Curry
+ Fix bad cross reference (times(2) not time(2))
+ The system call that reports child CPU usage is times(2),
+ not time(2).
+
+symlink.2
+ Michael Kerrisk [Steven Stewart-Gallus]
+ Document ENOENT error for symlinkat()
+ See https://bugzilla.kernel.org/show_bug.cgi?id=73301
+
+syscalls.2
+ Michael Kerrisk
+ Add renameat2()
+ And bump kernel version.
+
+write.2
+ Michael Kerrisk
+ BUGS: detail nonatomicity bug with respect to file offset updates
+ This bug was fixed in Linux 3.14, with commit
+ 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
+ See also http://thread.gmane.org/gmane.linux.kernel/1649458
+
+pthread_attr_setinheritsched.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setinheritsched() and
+ pthread_attr_getinheritsched() are thread safe.
+
+pthread_attr_setschedparam.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setschedparam() and
+ pthread_attr_getschedparam() are thread safe.
+
+pthread_attr_setschedpolicy.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setschedpolicy() and
+ pthread_attr_getschedpolicy() are thread safe.
+
+pthread_attr_setscope.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setscope() and pthread_attr_getscope()
+ are thread safe.
+
+pthread_attr_setstack.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setstack() and pthread_attr_getstack()
+ are thread safe.
+
+sched_getcpu.3
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+termios.3
+ Michael Kerrisk [Yuri Kozlov]
+ Rework intro text for 'c_oflag'
+ Michael Kerrisk
+ OFDEL is in POSIX.1-2001, so remove "(Not in POSIX)" text
+
+proc.5
+ Jan Moskyto Matejka [Randy Dunlap]
+ Improve description of /proc/stat 'intr' field
+ The sum at the beginning of line "intr" includes also
+ unnumbered interrupts.
+
+packet.7
+ Carsten Andrich [Neil Horman]
+ Improve sockopt documentation for packet sockets
+ Carsten Andrich [Willem de Bruijn]
+ PACKET_LOSS has inverse meaning
+ Stefan Puiu [Daniel Borkmann, Carsten Andrich]
+ Status in PACKET_RX_RING is actually a bit mask
+ Michael Kerrisk [Carsten Andrich]
+ SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c
+
+
+==================== Changes in man-pages-3.67 ====================
+
+Released: 2014-05-21, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andy Lutomirski <luto@amacapital.net>
+Aurelien Jarno <aurelien@aurel32.net>
+Bill Allombert <ballombe@debian.org>
+Christoph Hellwig <hch@infradead.org>
+Davidlohr Bueso <davidlohr@hp.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Ingo Schwarze <schwarze@usta.de>
+Jan Kara <jack@suse.cz>
+Jon Grant <jg@jguk.org>
+Juri Lelli <juri.lelli@gmail.com>
+Lucas De Marchi <lucas.demarchi@profusion.mobi>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Peter Zijlstra <peterz@infradead.org>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Sam Varshavchik <mrsam@courier-mta.com>
+Simon Paillard <spaillard@debian.org>
+Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
+Török Edwin <edwin@etorok.net>
+William Morriss <wjmelements@gmail.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+sched_setattr.2
+ Michael Kerrisk, Peter Zijlstra [Juri Lelli]
+ New page describing sched_setattr(2) and sched_getattr(2)
+
+system.3
+ Michael Kerrisk
+ Rewrote large parts of the page and added a number of details
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+sched.7
+ Peter Zijlstra, Michael Kerrisk [Juri Lelli]
+ Document SCHED_DEADLINE
+
+New and changed links
+---------------------
+
+renameat2.2
+ Michael Kerrisk
+ New link to rename.2
+
+sched_getattr.2
+ Michael Kerrisk
+ New link to new sched_setattr
+
+
+Changes to individual pages
+---------------------------
+
+bind.2
+ Michael Kerrisk
+ ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
+
+chown.2
+ Michael Kerrisk
+ NOTES: Add some subheadings
+
+connect.2
+ Michael Kerrisk [William Morriss]
+ ERRORS: Add EADDRNOTAVAIL for ephemeral port range exhaustion
+ Verified from testing and the kernel source.
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=745775
+ Michael Kerrisk
+ Remove mention of ip_local_port_range under EAGAIN error
+
+create_module.2
+delete_module.2
+init_module.2
+query_module.2
+ Michael Kerrisk [Lucas De Marchi]
+ Clarify glibc header file declaration/ABI wrapper details
+ create_module(), delete_module(), init_module(), and
+ query_module() are not declared in header files, but
+ through an accident of history glibc provides an ABI
+ for them that it continues to maintain, for
+ compatibility reasons.
+
+execve.2
+ Michael Kerrisk [Steven Stewart-Gallus]
+ Note SIGKILL case when execve() fails beyond the point of no return
+ Michael Kerrisk
+ NOTES: Add a subheading and reorder paragraphs
+
+fanotify_init.2
+ Heinrich Schuchardt [Michael Kerrisk]
+ Document range of permitted flags for event_f_flags
+ With a new patch included in the mm tree, event_f_flags is
+ checked for allowable values.
+
+fcntl.2
+ Michael Kerrisk
+ Add "file locking" subheading under NOTES
+
+fork.2
+ Michael Kerrisk
+ ERRORS: SCHED_DEADLINE tasks can fail with EAGAIN
+ SCHED_DEADLINE tasks can fail with EAGAIN unless the
+ reset-on-fork flag is set.
+
+futex.2
+ Michael Kerrisk
+ Note that there is no glibc wrapper
+
+getpriority.2
+ Rasmus Villemoes
+ Fix prototypes for getpriority() and setpriority()
+ The who argument has type id_t (which happens to be u32 on linux).
+
+get_robust_list.2
+ Rasmus Villemoes
+ Add <sys/types.h> to synopsis of get_robust_list()
+ If one were to implement wrappers for [gs]et_robust_list() using the
+ given prototypes, one would also have to include sys/types.h to get
+ a definition of size_t.
+
+getrusage.2
+ Michael Kerrisk [Bill Allombert]
+ _GNU_SOURCE must be defined to obtain RUSAGE_THREAD definition
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=746569
+
+link.2
+open.2
+ Andy Lutomirski [Michael Kerrisk]
+ Update AT_EMPTY_PATH and O_PATH documentation
+
+listen.2
+ Michael Kerrisk
+ ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
+
+mbind.2
+ Rasmus Villemoes
+ Fix prototype for mbind(2)
+ The nmask argument is const. The return type in numaif.h is long.
+ (Well, at least <numaif.h> says nmask is const. The current kernel
+ does not define it as a const argument, but sys_mbind() only
+ passes it to get_nodes(), which does treat it as const.)
+
+msgop.2
+ Davidlohr Bueso [Michael Kerrisk]
+ Enhance description of "full queue" criteria
+
+poll.2
+ Rasmus Villemoes
+ Add <signal.h> to synopsis for ppoll()
+ One needs to #include <signal.h> to get the definition of the
+ type (sigset_t) of the mask argument to ppoll().
+
+readlink.2
+ Rasmus Villemoes
+ Fix return type of readlinkat()
+
+recv.2
+ Michael Kerrisk
+ Clarify details of msg_name and msg_namelen fields
+
+recvmmsg.2
+ Michael Kerrisk
+ Describe timeout bug
+ See https://bugzilla.kernel.org/show_bug.cgi?id=75371
+ and http://thread.gmane.org/gmane.linux.man/5677
+
+remap_file_pages.2
+ Andy Lutomirski [Christoph Hellwig, Andy Lutomirski]
+ remap_file_pages() has no benefit for real files
+ Linux commit 3ee6dafc677a68e461a7ddafc94a580ebab80735 caused
+ remap_file_pages to be emulated when used on real file.
+
+sched_get_priority_max.2
+ Michael Kerrisk
+ 'policy' can also be SCHED_DEADLINE
+
+sched_setaffinity.2
+ Rasmus Villemoes
+ Fix prototype for sched_setaffinity()
+ The mask argument is const.
+
+sched_setparam.2
+ Michael Kerrisk
+ ERRORS: mark errors that apply just for sched_setparam()
+ Michael Kerrisk
+ ERRORS: Add EINVAL for invalid arguments
+ Michael Kerrisk
+ SEE ALSO: add sched_setattr(2)
+
+sched_setscheduler.2
+ Michael Kerrisk
+ ERRORS: mark errors that apply just to sched_setscheduler()
+ Michael Kerrisk
+ ERRORS: add EINVAL case for pid < 0
+ Michael Kerrisk
+ ERRORS: separate out EINVAL cases
+
+semget.2
+ Michael Kerrisk
+ NOTES: Add subheadings and reorder paragraphs
+
+semop.2
+ Rasmus Villemoes
+ Fix prototypes for semop() and semtimedop()
+ The nsops arguments have type size_t, not unsigned, and the
+ timeout argument of semtimedop() is const.
+ Michael Kerrisk
+ NOTES: Add a subheading
+
+send.2
+ Michael Kerrisk
+ Add details on various 'msghdr' fields
+ Michael Kerrisk
+ ERRORS: Add EAGAIN for ephemeral port range exhaustion
+ Michael Kerrisk
+ Add some subheadings under DESCRIPTION
+
+shmget.2
+ Michael Kerrisk
+ NOTES: Add a subheading
+
+stat.2
+ Michael Kerrisk [Aurelien Jarno]
+ Describe feature test macro requirements for file type test macros
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=728240
+ Michael Kerrisk
+ Update FTM requirements for lstat()
+ Michael Kerrisk
+ Split discussion of 'st_mode' fields into type and permissions
+ Michael Kerrisk
+ Move text on S_I*() macros to follow text on S_I* macros
+ That ordering is more logical
+
+stime.2
+ Rasmus Villemoes
+ Fix prototype for stime()
+ The argument is const, both according to the actual header files and
+ according to <http://www.sco.com/developers/devspecs/vol1a.pdf>.
+
+syscall.2
+ Rasmus Villemoes
+ Fix prototype for syscall()
+ The first argument and the return value of syscall() has type long,
+ not int.
+
+getopt.3
+ Michael Kerrisk
+ EXAMPLE: Add subheadings to distinguish the two example programs
+
+malloc.3
+ Michael Kerrisk
+ Reword text referring to mallopt(3)
+ Linux libc is no longer "recent"; drop mention of it.
+
+pthread_attr_setinheritsched.3
+pthread_attr_setschedparam.3
+pthread_attr_setschedpolicy.3
+pthread_setaffinity_np.3
+pthread_setschedparam.3
+pthread_setschedprio.3
+pthread_yield.3
+pthreads.7
+ Michael Kerrisk
+ Change references to "sched_setscheduler(2)" to "sched(7)"
+ Change consistent with the fact that the scheduling overview
+ page is now sched(7) not sched_setscheduler(2).
+
+pthread_attr_setstackaddr.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setstackaddr() and
+ pthread_attr_getstackaddr() are thread safe.
+
+pthread_attr_setstacksize.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_attr_setstacksize() and
+ pthread_attr_getstacksize() are thread safe.
+
+pthread_kill.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_kill() is thread safe.
+
+pthread_kill_other_threads_np.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_kill_other_threads_np() is thread safe.
+
+pthread_self.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_self() is thread safe.
+
+pthread_setcancelstate.3
+ Michael Kerrisk
+ Add paragraph breaks to "Asynchronous cancelability" subsection
+
+pthread_setcancelstate.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setcancelstate() and
+ pthread_setcanceltype() are thread safe.
+ Michael Kerrisk
+ NOTES: Add some subheadings
+
+pthread_setschedparam.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setschedparam() and pthread_getschedparam()
+ are thread safe.
+
+pthread_setschedprio.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_setschedprio() is thread safe.
+
+pthread_sigmask.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_sigmask() is thread safe.
+
+pthread_sigqueue.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_sigqueue() is thread safe.
+
+pthread_testcancel.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_testcancel() is thread safe.
+
+pthread_yield.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_yield() is thread safe.
+
+remquo.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions remquo(), remquof() and remquol() are thread safe.
+
+rtime.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function rtime() is thread safe.
+
+sched_getcpu.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function sched_getcpu() is thread safe.
+
+stpcpy.3
+ Ingo Schwarze
+ Note some history of stpcpy()
+ Quoting Ingo:
+ I just noticed that the stpcpy(3) manual contains a speculation
+ that appears to be untrue on closer investigation: That function
+ did not originate in MS DOS, but in Lattice C on AmigaDOS.
+
+ Here is a patch against the git master HEAD to fix that, and add
+ some more historical information. To provide some background and
+ allow you to more easily verify the correctness of the patch, i'm
+ appending my mail to <misc@openbsd.org>, where i'm giving some
+ more details about the history and pointing to some primary
+ sources. That mail also contains the (similar, but shorter)
+ patch i just committed to the OpenBSD manual page.
+
+strcasecmp.3
+ Michael Kerrisk [Aurelien Jarno, Török Edwin]
+ Explain why strcasecmp()+strncasecmp() are also declared in <string.h>
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729436
+
+strcpy.3
+ Michael Kerrisk
+ NOTES: Add a subheading
+
+fd.4
+ Michael Kerrisk [Sam Varshavchik]
+ Fix floppy disk device names
+ The naming convention shown in the page was ancient.
+ Now, the page is consistent with Documentation/devices.txt
+ (where it is noted that "The use of the capital letters
+ D, H and E for the 3.5" models have been deprecated, since
+ the drive type is insignificant for these devices"
+
+proc.5
+ Michael Kerrisk
+ Document /proc/timer_stats
+ Michael Kerrisk
+ (Briefly) document /proc/timer_list
+ Michael Kerrisk
+ Add /proc/sys/kernel/{sched_rt_period_us,sched_rt_runtime_us}
+ Reference sched(7) for an explanation of these two files
+
+capabilities.7
+ Michael Kerrisk
+ Mention sched_setattr(2) under CAP_SYS_NICE
+
+cpuset.7
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+
+credentials.7
+ Michael Kerrisk
+ Mention sched_getattr() as a place where credentials are checked
+
+fanotify.7
+ Heinrich Schuchardt [Jan Kara]
+ BUGS: error events can be lost when reading from fanotify FD
+ Michael Kerrisk [Heinrich Schuchardt]
+ Fix description of FAN_EVENT_NEXT()
+ FAN_EVENT_NEXT() does not update 'meta'; rather, it returns a
+ pointer to the next metadata structure. In addition, generally
+ rework the description to be a bit clearer and more detailed.
+ Heinrich Schuchardt
+ Document FAN_EVENT_METADATA_LEN
+
+ip.7
+ Michael Kerrisk
+ Note cases where an ephemeral port is used
+ Michael Kerrisk
+ Remove BUGS text on glibc failing to declare in_pktinfo
+ Michael Kerrisk
+ Clarify 'ip_local_port_range' and mention the term "ephemeral ports"
+ Michael Kerrisk
+ Note some more details about assignment of ephemeral ports
+ Michael Kerrisk
+ BUGS: ephemeral port range exhaustion is diagnosed inconsistently
+ Different system calls use different 'errno' values to diagnose
+ exhaustion of the ephemeral port range.
+
+sched.7
+ Michael Kerrisk
+ Document sched_rt_period_us and sched_rt_runtime_us /proc files
+ And rework and relocate the text on dealing with runaway
+ real-time processes.
+ Michael Kerrisk
+ Mention sched_setattr(2) in list of APIs that can change policies
+ Michael Kerrisk
+ sched_setattr(2) can also be used to set 'nice' value
+ Michael Kerrisk
+ Remove mention of sched_setscheduler() when talking about sched_priority
+ There are nowadays multiple ways to set sched_priority (and
+ in fact there always were, since we also had sched_setparam(2)).
+ Michael Kerrisk
+ SEE ALSO: Add Documentation/scheduler/sched-design-CFS.txt
+ Michael Kerrisk
+ Don't mention sched_setscheduler(2) in discussions of setting policies
+ In a couple of places, sched_setscheduler(2) is mentioned as the
+ way of setting policies. But now there is sched_setattr(2) as
+ well, rewrite the text in a more generic way.
+ Michael Kerrisk
+ Rework summary text describing sched_setattr(2) and sched_getattr(2)
+ Note that these APIs are a superset of sched_setscheduler(2)
+ and sched_getscheduler(2).
+ Michael Kerrisk
+ Remove crufty text relating to sched_setscheduler()
+ All of the removed text is in sched_setscheduler(2) and
+ should have been trimmed from this page.
+ Michael Kerrisk
+ SEE ALSO: Mention more files in Documentation/scheduler/ directory
+
+
+==================== Changes in man-pages-3.68 ====================
+
+Released: 2014-05-28, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alastair McKinstry <mckinstry@computer.org>
+Carsten Grohmann <carstengrohmann@gmx.de>
+Colin Williams <colinwilliams1968@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Lars Wirzenius <liw@iki.fi>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Richard Braakman <richard.braakman@jollamobile.com>
+Simon Paillard <spaillard@debian.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+localedef.1
+ Marko Myllynen, Richard Braakman, Alastair McKinstry, Lars Wirzenius
+ New page for localedef(1)
+ Add new page based on Debian localedef(1) page.
+
+
+New and changed links
+---------------------
+
+procfs.5
+ New link to proc.5
+ Since the term "procfs" is widely used, it seems reasonable to have
+ a link from that name to proc(5).
+
+
+Changes to individual pages
+---------------------------
+
+locale.1
+ Marko Myllynen
+ Provide a step-by-step example of how to use a custom locale
+ Marko Myllynen
+ Use LC_TELEPHONE instead of LC_MESSAGES in the example
+ yesstr/nostr in LC_MESSAGES are planned to be changed at some
+ point [1], so it's better to provide an example which won't
+ be obsoleted by that change.
+
+ [1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975
+
+adjtimex.2
+ Michael Kerrisk
+ Add feature test macro requirements
+
+clone.2
+ Michael Kerrisk
+ ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
+
+fork.2
+ Michael Kerrisk
+ ERRORS: add pid_max and threads-max to EAGAIN
+ And rewrite text to be the same as pthread_create(3).
+
+getrlimit.2
+ Michael Kerrisk
+ RLIMIT_NPROC is not enforced if CAP_SYS_ADMIN or CAP_SYS_RESOURCE
+
+remap_file_pages.2
+ Rasmus Villemoes
+ Fix prototype
+ The pgoff argument has type size_t, not ssize_t (and in the
+ kernel it is unsigned long).
+
+set_mempolicy.2
+ Rasmus Villemoes
+ Fix prototype for set_mempolicy(2)
+ The nodemask argument is const. The return type in numaif.h is long.
+
+swapon.2
+ Rasmus Villemoes
+ Remove header from synopsis
+ The <asm/page.h> header is not readily available, and the comment
+ seems to indicate that it is for getting PAGE_SIZE. But it is
+ never mentioned why one would need to know that, and it is in any
+ case better obtained using sysconf(), provided by <unistd.h>.
+
+a64l.3
+ Rasmus Villemoes
+ Fix prototype for a64l()
+ The argument is const, both according to POSIX and the
+ glibc headers.
+
+adjtime.3
+ Rasmus Villemoes
+ Add required header
+ The prototype for adjtime(3) is declared in <sys/time.h>.
+
+argz_add.3
+ Rasmus Villemoes
+ Fix prototypes
+ Update the prototypes of argz_{delete,extract,next} to agree with
+ glibc headers and manual.
+
+bstring.3
+ Rasmus Villemoes
+ Fix prototypes
+ The length parameter n has type size_t in bcmp(), bcopy() and
+ bzero().
+
+envz_add.3
+ Rasmus Villemoes
+ Fix prototypes
+ The envz_len parameters for envz_entry() and envz_get() are not
+ passed by reference.
+
+fpathconf.3
+ Rasmus Villemoes
+ Fix prototype
+ The path argument to pathconf() is const.
+
+fseek.3
+ Rasmus Villemoes
+ Fix prototype
+ The pos argument to fsetpos() is const.
+
+gcvt.3
+ Rasmus Villemoes
+ Fix prototype
+ The ndigit parameter to gcvt() has type int.
+
+getaddrinfo_a.3
+ Rasmus Villemoes
+ Fix prototype
+ The pointer arguments to gai_suspend() are const.
+
+getauxval.3
+ Rasmus Villemoes
+ Fix permissions
+ There doesn't seem to be any reason for getauxval.3 to be
+ executable...
+
+getnameinfo.3
+ Rasmus Villemoes
+ Fix prototype
+ The hostlen and servlen parameters have type socklen_t.
+ (The types changed in glibc 2.2)
+ Michael Kerrisk
+ Note types of 'hostlen'; and 'servlen' in glibc < 2.2
+
+getrpcent.3
+ Rasmus Villemoes
+ Fix prototype
+ The argument to getrpcbyname() is const.
+
+getrpcport.3
+ Rasmus Villemoes
+ Add #include and fix prototype
+ The prototype for getrpcport() is obtained by #include'ing
+ <rpc/rpc.h>. Also, update its prototype.
+
+getspnam.3
+ Rasmus Villemoes
+ Fix prototype
+ The struct spwd argument to putspent() is const.
+
+getutent.3
+ Rasmus Villemoes
+ Fix prototypes
+ The arguments to getutid(), getutline(), and pututline()
+ are const.
+
+inet.3
+ Rasmus Villemoes
+ Fix prototype
+ The parameters to inet_makeaddr have type in_addr_t.
+
+inet_net_pton.3
+ Rasmus Villemoes
+ srcfix, cfix
+ Use a consistent style throughout the man-pages.
+
+key_setsecret.3
+ Rasmus Villemoes
+ Fix prototypes
+ Remove const qualifiers from arguments to key_decryptsession,
+ key_encryptsession, and key_setsecret.
+
+makecontext.3
+ Rasmus Villemoes
+ Fix prototype
+ The second argument to swapcontext() is const.
+
+makedev.3
+ Rasmus Villemoes
+ Fix prototype
+ gnu_dev_makedev, and hence its trivial macro wrapper makedev, takes
+ two unsigned int parameters; this is consistent with it being the
+ inverse of (gnu_dev_)major/minor, which return unsigned int.
+
+malloc_trim.3
+ Rasmus Villemoes
+ Fix prototype
+ As mentioned further down, malloc_trim returns an integer.
+
+mq_getattr.3
+ Rasmus Villemoes
+ Fix prototype
+ The newattr parameter to mq_setattr is const.
+
+newlocale.3
+ Marko Myllynen
+ List all available category masks
+ Michael Kerrisk
+ Add LC_ALL_MASK description
+
+nl_langinfo.3
+ Marko Myllynen
+ Expand the example code a bit
+ Better illustrate querying elements from different categories.
+
+perror.3
+ Rasmus Villemoes
+ Fix declaration
+ The elements of the array sys_errlist are also const.
+
+pthread_attr_setaffinity_np.3
+pthread_attr_setdetachstate.3
+pthread_attr_setguardsize.3
+pthread_attr_setinheritsched.3
+pthread_attr_setschedparam.3
+pthread_attr_setschedpolicy.3
+pthread_attr_setscope.3
+pthread_attr_setstack.3
+pthread_attr_setstackaddr.3
+pthread_attr_setstacksize.3
+ Rasmus Villemoes
+ Constify parameters
+ Each of the pthread_attr_get* functions extract some piece of
+ information from a pthread_attr_t, which is passed by const
+ reference. Add the const keyword to the prototypes of these
+ functions.
+
+pthread_cleanup_push_defer_np.3
+ Michael Kerrisk [Rasmus Villemoes]
+ Add feature test macro requirements
+
+pthread_create.3
+ Michael Kerrisk [Carsten Grohmann]
+ Add pid_max limit to EAGAIN error cases
+
+pthread_equal.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_equal() is thread safe.
+
+pthread_exit.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_exit() is thread safe.
+
+pthread_getcpuclockid.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_getcpuclockid() is thread safe.
+
+pthread_setaffinity_np.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setaffinity_np() and
+ pthread_getaffinity_np() are thread safe.
+
+pthread_setconcurrency.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setconcurrency() and
+ pthread_getconcurrency() are thread safe.
+
+pthread_setname_np.3
+ Rasmus Villemoes
+ Fix prototype
+ The name parameter of pthread_getname_np is an output parameter and
+ hence not const.
+
+pthread_setschedparam.3
+ Rasmus Villemoes
+ Fix prototypes
+ Add return type for pthread_{s,g}etschedparam.
+
+pthread_setschedprio.3
+ Rasmus Villemoes
+ Fix prototype
+ Add return type for pthread_setschedprio.
+
+pthread_sigqueue.3
+ Rasmus Villemoes
+ Add missing #include <signal.h>
+
+rcmd.3
+ Rasmus Villemoes
+ Fix prototypes
+ Unlike the BSDs, the second argument of rcmd() and rcmd_af() has
+ type unsigned short.
+ The first argument of iruserok_af() has type const void*.
+
+re_comp.3
+ Rasmus Villemoes
+ Fix prototypes
+ re_comp and re_exec take const char* arguments.
+
+resolver.3
+ Rasmus Villemoes
+ Fix prototypes and extern-declaration
+ Fix const- and signedness of various char* parameters.
+
+ Also, there is no "struct state", but _res is a struct
+ __res_state. (Actually, _res is errno-like in that it is really a
+ macro expanding to (*__res_state()).)
+
+rexec.3
+ Rasmus Villemoes
+ Fix prototypes
+ The user, passwd and cmd arguments to rexec and rexec_af are all
+ const.
+
+rtime.3
+ Rasmus Villemoes
+ Replace header
+ The header <rpc/des_crypt.h> does not provide rtime();
+ <rpc/auth_des.h> does, as is also implied in both the NOTES and
+ EXAMPLE sections.
+
+scandir.3
+ Rasmus Villemoes
+ Fix prototypes
+ The alphasort and versionsort functions take arguments of type
+ const struct dirent **, not const void *.
+
+setlocale.3
+ Michael Kerrisk [Marko Myllynen]
+ Simplify locale category listing and add GNU-specific locale categories
+ Some information that was here will move to locale(7).
+ Marko Myllynen
+ Remove now obsolete NOTES section
+
+setnetgrent.3
+ Rasmus Villemoes
+ Fix prototype
+ The buflen argument to getnetgrent_r has type size_t.
+
+sigvec.3
+ Rasmus Villemoes
+ Fix prototype
+ The vec argument to sigvec is const.
+
+tsearch.3
+ Rasmus Villemoes
+ Fix prototype
+ The rootp argument to tfind is "void * const *",
+ not "const void **".
+
+core.5
+ Michael Kerrisk
+ Core dump files are nowadays core.pid by default
+
+locale.5
+ Marko Myllynen
+ Document mon_grouping and grouping properly
+ Michael Kerrisk
+ Note default value for 'first_workday'
+ Michael Kerrisk [Marko Myllynen]
+ Add brief descriptions of collating-element and collating-symbol
+ Marko Myllynen
+ t_fmt_ampm is needed only for locales that employ AM/PM convention
+ Michael Kerrisk [Marko Myllynen]
+ Remove crufty reference to /usr/lib/nls/src
+ That file is nowhere to be found
+ Marko Myllynen
+ Clarify LC_TIME/am_pm and LC_NAME keywords usage
+ am_pm should be defined only if AM/PM convention is used to signal
+ applications they should not try to print them when using them in
+ unwanted.
+
+ Same for all LC_NAME keywords expect for name_fmt which should be
+ always defined.
+ Marko Myllynen
+ Clarify lang_term / lang_lib
+ As noted by Keld Simonsen in the lib-locales@sourceware mailing
+ list:
+
+ https://sourceware.org/ml/libc-locales/2014-q2/msg00008.html
+ From: Keld Simonsen <keld at rap dot rap dot dk>
+ To: Marko Myllynen <myllynen at redhat dot com>
+ Date: Tue, 29 Apr 2014 17:02:09 +0200
+
+ lang_term reflects ISO 639-2/T (terminology) codes, while
+ lang_lib reflects ISO 639-2/B (bibliographic) codes.
+ lang_term is preferred over lang_lib codes for locale names.
+ There are 20 specific ISO 639-2/B codes.
+ Marko Myllynen
+ Correct the FILES section
+
+proc.5
+ Michael Kerrisk
+ 'pid_max' is a system-wide limit on number of threads and processes
+ Since PIDs > /proc/sys/kernel/pid_max are not allocated, this
+ file thus also imposes a system-wide limit on the number of
+ threads and processes.
+
+capabilities.7
+ Michael Kerrisk
+ CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
+ Michael Kerrisk
+ CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
+
+charsets.7
+ Michael Kerrisk [Marko Myllynen]
+ Remove crufty statement that Romanian may be switching to ISO 8859-16
+ Michael Kerrisk
+ Remove ancient paragraph on charsets supported in glibc 2.3.2
+ That test is rather ancient, and probably of little use.
+
+fanotify.7
+ Heinrich Schuchardt
+ Fix to example program: fanotify read() should use aligned buffer
+
+inotify.7
+ Heinrich Schuchardt
+ Add example program
+ This example of the usage of the inotify API shows the
+ usage of inotify_init1(2) and inotify_add_watch(2) as well
+ as polling and reading from the inotify file descriptor.
+ Heinrich Schuchardt
+ munmap() does not generate inotify events
+
+locale.7
+ Marko Myllynen [Michael Kerrisk]
+ Document the LOCPATH environment variable
+ Michael Kerrisk
+ Add further details on various categories
+
+
+
+==================== Changes in man-pages-3.69 ====================
+
+Released: 2014-06-14, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Cyril Hrubis <chrubis@suse.cz>
+Jan Chaloupka <jchaloup@redhat.com>
+Jeff Layton <jlayton@poochiereds.net>
+Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
+KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+NeilBrown <neilb@suse.de>
+Peng Haitao <penght@cn.fujitsu.com>
+Petr Gajdos <pgajdos@suse.cz>
+Qian Lei <qianl.fnst@cn.fujitsu.com>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Vasiliy Kulikov <segoon@openwall.com>
+Walter Harms <wharms@bfs.de>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+iconv.1
+ Marko Myllynen [Michael Kerrisk]
+ New page for the iconv(1) command
+
+iconvconfig.8
+ Marko Myllynen
+ New page for iconvconfig(8)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fcntl.2
+ Jeff Layton, Michael Kerrisk
+ Document open file description locks
+ As provided by the fcntl() operations F_OFD_SETLK,
+ F_OFD_SETLKW, and F_OFD_GETLK
+
+
+Changes to individual pages
+---------------------------
+
+locale.1
+ Marko Myllynen
+ Add FILES section, add charmap(5) reference
+ Marko Myllynen
+ Align with recent charmap(5) / repertoiremap(5) changes
+
+execve.2
+ Michael Kerrisk [NeilBrown]
+ Before kernel 2.6.0, RLIMIT_NPROC had no effect for set*uid()
+ Michael Kerrisk [Vasiliy Kulikov]
+ RLIMIT_NPROC is checked only if preceded by set*uid()
+ Michael Kerrisk [Vasiliy Kulikov, NeilBrown, KOSAKI Motohiro]
+ Document EAGAIN error
+ See also https://bugzilla.kernel.org/show_bug.cgi?id=42704
+
+fcntl.2
+ Michael Kerrisk
+ Detail the limitations of traditional (process-associated) locks
+ Michael Kerrisk [Jeff Layton]
+ Describe how to check whether the kernel supports a particular command
+ Michael Kerrisk
+ ERRORS: add EINVAL for invalid 'cmd'
+ Michael Kerrisk
+ Add para introducing advisory locks and noting existence of OFD locks
+ Michael Kerrisk [Jeff Layton]
+ Add notes on F_SETLKW deadlock detection and its limitations
+ Michael Kerrisk
+ Add an explicit note that mandatory locking is not in POSIX
+ Michael Kerrisk
+ Rewrite introductory paragraphs on mandatory locking
+ Make the structure more logical, and also explicitly mention
+ OFD locks.
+ Michael Kerrisk [Jeff Layton]
+ Reword discussion of mandatory lock bug a little
+ Jeff Layton confirmed that the bug remains even in modern kernels.
+ Michael Kerrisk
+ Explain POSIX background to EACCES/EAGAIN error for F_GETLK
+ Michael Kerrisk
+ Add NOTES subhead for record locking and NFS
+ Michael Kerrisk [NeilBrown]
+ Note treatment of locks when an NFS client loses contact with the server
+ Michael Kerrisk [Jeff Layton]
+ nfsv4leasetime controls the "contact lost" interval for NFSv4
+
+flock.2
+ Michael Kerrisk
+ In some modern BSDs, fcntl() and flock() locks do interact
+ So, reword and extend the discussion of this topic in NOTES.
+ Michael Kerrisk
+ Move NOTES text describing implementation of flock()
+ Michael Kerrisk [NeilBrown]
+ Add more details on NFS, including Linux 2.6.37 changes
+ Also: move NOTES text describing interaction of fcntl()
+ and flock() locks.
+
+fork.2
+ Michael Kerrisk
+ Add notes on inheritance of flock() and OFD locks across fork()
+
+lseek.2
+ Michael Kerrisk
+ Add reference to open(2) for discussion of file descriptors and OFDs
+
+open.2
+ Michael Kerrisk
+ Rework and extend the discussion of open file descriptions
+
+open_by_handle_at.2
+ Rasmus Villemoes
+ Add reference to feature_test_macros(7)
+
+recvmmsg.2
+ Rasmus Villemoes
+ Add reference to feature_test_macros(7)
+
+remap_file_pages.2
+ Michael Kerrisk [Kirill A. Shutemov]
+ Note that remap_file_pages() is deprecated
+
+sendmmsg.2
+ Rasmus Villemoes
+ Add reference to feature_test_macros(7)
+
+seteuid.2
+ Michael Kerrisk
+ seteuid() and setegid() are implemented as library functions
+ Michael Kerrisk
+ Error checking should always be performed, even when caller is UID 0
+
+setresuid.2
+ Michael Kerrisk
+ Document EAGAIN error that can occur after kernel alloc_uid() failure
+ Michael Kerrisk
+ Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
+ Michael Kerrisk
+ Correct the description of the EAGAIN error
+ Michael Kerrisk
+ Error checking should always be performed, even when caller is UID 0
+
+setreuid.2
+ Michael Kerrisk
+ Document EAGAIN error that can occur after kernel alloc_uid() failure
+ Michael Kerrisk
+ Error checking should always be performed, even when caller is UID 0
+ Michael Kerrisk
+ Add EAGAIN error for hitting RLIMIT_NPROC limit
+ Michael Kerrisk
+ Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
+
+setuid.2
+ Michael Kerrisk
+ Document EAGAIN error that can occur after kernel alloc_uid() failure
+ Michael Kerrisk
+ Correct the description of the EAGAIN error
+ Michael Kerrisk
+ Error checking should always be performed, even when caller is UID 0
+ Michael Kerrisk
+ Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
+
+statfs.2
+ Cyril Hrubis
+ Update MAGIC constants
+ Most of the updates are taken from /usr/include/linux/magic.h,
+ some were found by grepping the Linux source code.
+ Cyril Hrubis [Michael Kerrisk]
+ fstatfs(2) was broken on file descriptors from pipe(2)
+
+syscalls.2
+ Michael Kerrisk
+ Note that remap_file_pages() is deprecated
+
+basename.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions basename() and dirname() are thread safe.
+
+catgets.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function catgets() is thread safe.
+
+getdate.3
+ Rasmus Villemoes
+ Use blank definition of _GNU_SOURCE in example program
+
+getdirentries.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getdirentries() is thread safe.
+
+getdtablesize.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function getdtablesize() is thread safe.
+
+iconv.3
+ Qian Lei [Peng Haitao]
+ ATTRIBUTES: Note function that is thread-safe
+ The function iconv() is thread safe.
+ Michael Kerrisk
+ SEE ALSO: add iconvconfig(8)
+
+lockf.3
+ Qian Lei [Peng Haitao]
+ ATTRIBUTES: Note function that is thread-safe
+ The function lockf() is thread safe.
+
+malloc_get_state.3
+ Rasmus Villemoes
+ SYNOPSIS: use correct header
+ The nonstandard functions malloc_set_state() and
+ malloc_get_state() are provided by <malloc.h> not <stdlib.h>.
+
+malloc_usable_size.3
+ Qian Lei
+ ATTRIBUTES: Note function that is thread-safe
+ The function malloc_usable_size() is thread safe.
+
+matherr.3
+ Qian Lei [Peng Haitao]
+ ATTRIBUTES: Note function that is thread-safe
+ The function matherr() is thread safe.
+
+mkdtemp.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function mkdtemp() is thread safe.
+
+mkstemp.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mkstemp(), mkostemp(), mkstemps() and mkostemps()
+ are thread safe.
+
+mq_close.3
+ Qian Lei
+ ATTRIBUTES: Note function that is thread-safe
+ The function mq_close() is thread safe.
+
+mq_getattr.3
+ Qian Lei
+ ATTRIBUTES: Note function that is thread-safe
+ The functions mq_getattr() and mq_setattr() are thread safe.
+
+mq_open.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function mq_open() is thread safe.
+
+mq_receive.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mq_receive() and mq_timedreceive() are thread safe.
+
+mq_send.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions mq_send() and mq_timedsend() are thread safe.
+
+mq_unlink.3
+ Qian Lei
+ ATTRIBUTES: Note function that is thread-safe
+ The function mq_unlink() is thread safe.
+
+posix_fallocate.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function posix_fallocate() is thread safe.
+
+posix_openpt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function posix_openpt() is thread safe.
+
+siginterrupt.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is not thread-safe
+ The function siginterrupt() is not thread safe.
+
+system.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function system() is thread safe.
+
+charmap.5
+ Marko Myllynen
+ Update to match current glibc
+ charmap(5) was outdated, bring it to closer to reality by fixing
+ syntax descriptions to match current glibc code and practices,
+ adding missing options, removing obsolete comments and references,
+ and removing now incorrect examples.
+
+locale.5
+ Marko Myllynen
+ Clarify AM/PM settings a bit
+ localedef(1) complains if really undefined, should be empty instead.
+ Also: add some SEE ALSO references.
+ Marko Myllynen
+ Document glibc conventions regarding days and week
+ Based on existing practice and glibc community wiki page at
+ https://sourceware.org/glibc/wiki/Locales
+
+proc.5
+ Michael Kerrisk [Jan Chaloupka, Walter Harms]
+ Add a brief description of /proc/fs
+
+repertoiremap.5
+ Marko Myllynen
+ New page for repertoiremap(5)
+ Rather obsolete feature but localedef(1) refers to repertoiremaps.
+
+bootparam.7
+ Petr Gajdos
+ Describe 'rootflags' and 'rootdelay' kernel parameters
+ Patch based on text from Documentation/kernel-parameters.txt
+
+charsets.7
+ Marko Myllynen
+ Update to reflect past developments
+ Rewrite the introduction to make Unicode's prominence more obvious.
+ Reformulate parts of the text to reflect current Unicode world.
+ Minor clarification for ASCII/ISO sections, some other minor fixes.
+ Marko Myllynen
+ List CJK encodings in the order of C, J, K
+
+environ.7
+ Michael Kerrisk
+ SEE ALSO: add env(1), printenv(1), ld.so(8)
+
+locale.7
+ Marko Myllynen
+ Add some SEE ALSO references
+
+man-pages.7
+ Michael Kerrisk
+ Note that .TH 'date' field is nowadays automatically updated by scripts
+
+signal.7
+ Michael Kerrisk
+ Describe EINTR semantics for recvmmsg(2)
+ Michael Kerrisk
+ Clarify text describing EINTR semantics for socket interfaces
+
+unicode.7
+ Marko Myllynen
+ Update to reflect past developments
+ The unicode(7) page will look more modern with few small changes:
+
+ - drop old BUGS section, editors cope with UTF-8 ok these days,
+ and perhaps the state-of-the-art is better described elsewhere
+ anyway than in a man page
+ - drop old suggestion about avoiding combined characters
+ - refer to LANANA for Linux zone, add registry file reference
+ - drop a reference to an inactive/dead mailing list
+ - update some reference URLs
+
+utf-8.7
+ Marko Myllynen
+ Drop an old comment about UTF-8 replacing ISO 8859
+ And add locale(1) under SEE ALSO.
+
+
+==================== Changes in man-pages-3.70 ====================
+
+Released: 2014-07-08, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Carlos O'Donell <carlos@redhat.com>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Nadav Har'El <nyh@math.technion.ac.il>
+NeilBrown <neilb@suse.de>
+Rich Felker <dalias@libc.org>
+Robert P. J. Day <rpjday@crashcourse.ca>
+Simon Paillard <spaillard@debian.org>
+Tomi Salminen <tlsalmin@gmail.com>
+Walter Harms <wharms@bfs.de>
+Yuri Kozlov <yuray@komyakino.ru>
+Кирилл <kirillnow@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+sprof.1
+ Michael Kerrisk [Marko Myllynen]
+ New page for the glibc sprof(1) command
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+epoll_ctl.2
+ NeilBrown
+ Document EPOLLWAKEUP
+
+epoll.7
+ NeilBrown
+ Document EPOLLWAKEUP
+
+
+Changes to individual pages
+---------------------------
+
+iconv.1
+iconvconfig.8
+ Marko Myllynen
+ Clarify gconv file terminology a bit
+
+ldd.1
+ Michael Kerrisk
+ SEE ALSO: add sprof(1)
+
+connect.2
+ Michael Kerrisk
+ ERRORS: add EPROTOTYPE
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=708394
+
+dup.2
+ Michael Kerrisk [Rich Felker]
+ Fix erroneous discussion regarding closing 'newfd' before calling dup2()
+ And propose a workaround if the caller cares about catching
+ close() time errors.
+
+ See http://stackoverflow.com/questions/23440216/race-condition-when-using-dup2#comment36888604_23444465
+ and http://austingroupbugs.net/view.php?id=411
+ Michael Kerrisk
+ Rework and enhance discussion of dup2()
+ In particular, note that dup2() performs the steps of closing
+ and reusing 'newfd' atomically.
+ Michael Kerrisk
+ Add subhead for dup3()
+
+epoll_ctl.2
+ Michael Kerrisk
+ BUGS: EPOLLWAKEUP is silently ignored without CAP_BLOCK_SUSPEND
+ If the caller does not have CAP_BLOCK_SUSPEND, then EPOLLWAKEUP
+ is silently ignored.
+
+fcntl.2
+ Michael Kerrisk [Tomi Salminen]
+ The return value for F_SETPIPE_SZ is the pipe capacity
+ Michael Kerrisk
+ ERRORS: Document ENOTDIR error for F_NOTIFY
+ Michael Kerrisk
+ Use proper page cross-references in F_NOTIFY discussion
+ Michael Kerrisk
+ Suggest the use of real-time signals with F_NOTIFY
+
+getitimer.2
+ Michael Kerrisk
+ Rewrite a few pieces to clarify some details
+
+inotify_add_watch.2
+ Michael Kerrisk
+ Clarify that the target of a watch is an i-node
+ The target of a watch is an i-node, not a pathname. Clarify
+ the text to prevent the reader possibly misunderstanding
+ that establishing watches by two different links to the same
+ file might create different watch descriptors.
+
+open.2
+ Michael Kerrisk [Кирилл]
+ O_CLOEXEC is also one the flags not ignored when O_PATH is specified
+
+pipe.2
+ Elie De Brauwer
+ PIPE_BUF is defined in limits.h
+ To make use of PIPE_BUF in an application one should include
+ <limits.h>. Adding a reference to this inclusion.
+
+poll.2
+ Michael Kerrisk [Nadav Har'El]
+ The negate-fd-to-ignore technique does not work for file descriptor 0
+ See https://bugzilla.kernel.org/show_bug.cgi?id=79411
+
+set_tid_address.2
+ Michael Kerrisk [Rich Felker]
+ Use "thread" rather than "process" in DESCRIPTION
+ Michael Kerrisk
+ SEE ALSO: add gettid(2)
+
+shmop.2
+ Michael Kerrisk
+ Explain SHMLBA in much more detail
+
+splice.2
+ Michael Kerrisk
+ Document EAGAIN error
+ See https://bugzilla.kernel.org/show_bug.cgi?id=48641
+
+syscalls.2
+ Carlos O'Donell
+ Add prlimit64(2)
+ While trying to reconcile the new features in glibc with the
+ documented entries in the linux kernel man pages I noticed that
+ glibc exports prlimit64 for use by 32-bit applications (as does
+ the linux kernel), but that prlimit64 was not defined in the
+ syscalls list or in the prlimit-related page.
+
+ This is not the complete fix for this, but I don't have the time
+ to explain why and when prlimit64 should be used (or how it should
+ be used safely). Therefore I'm just patching the syscalls.2 list
+ to show that prlimit64 exists and was added in 2.6.36 (verified
+ with git by checking out the tags before and after).
+
+syslog.2
+ Michael Kerrisk
+ Rework introductory paragraph
+ Michael Kerrisk [Robert P. J. Day]
+ Rework text describing loglevels
+ The kernel header file mentioned in the discussion of the KERN_*
+ constants has morphed and is no longer exported inside glibc.
+ And the definitions of the constants themselves changed subtly
+ with kernel commit 04d2c8c83d0e3ac5f78aeede51babb3236200112.
+ So, rewrite the description of the constants to be a bit more
+ abstract.
+ Michael Kerrisk
+ Rewrite parts of the page, and import /proc/sys/kernel/printk
+ * Move /proc/sys/kernel/printk from proc(5) to this page,
+ and correct various details in the discussion of that file.
+ * Rewrite and correct various other details on the page.
+ * Clean out some crufty text.
+ * Miscellaneous minor fixes.
+ Michael Kerrisk
+ Update SYSLOG_ACTION_CONSOLE_OFF + SYSLOG_ACTION_CONSOLE_ON description
+ Details changed in Linux 2.6.32
+
+tee.2
+ Michael Kerrisk
+ Document EAGAIN error
+ See https://bugzilla.kernel.org/show_bug.cgi?id=48641
+
+vmsplice.2
+ Michael Kerrisk
+ Document EAGAIN error
+ See https://bugzilla.kernel.org/show_bug.cgi?id=48641
+
+ether_aton.3
+ Michael Kerrisk
+ Make description of ether_line() bug a little more informative
+
+mallopt.3
+ Michael Kerrisk [Florian Weimer]
+ MALLOC_MMAP_THRESHOLD_ and MALLOC_MMAP_MAX_ *do* work in setgid programs
+ My testing on this point was bogus, overlooking details of
+ strace(1)'s behavior with setuid programs.
+
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=12155
+
+printf.3
+ Michael Kerrisk [Rich Felker]
+ Remove libc4 and libc5 details
+ Rich Felker noted that "scare text" in the man page warned about
+ the use of snprintf() on libc, and that some people had cited
+ this as a reason not to use snprintf(). Linux libc is now
+ ancient history, so there is no real need to keep that text.
+ But, while we're at it, we may as well clear out all of the
+ other ancient libc4 and libc5 pieces in the page. They are
+ nowadays more clutter than help.
+ Michael Kerrisk
+ SUSv3 and later agree with C99 for the snprintf() return value
+ Determined by inspection of the SUSv3 and SUSv4 specifications.
+ Michael Kerrisk
+ Remove some old text about glibc 2.0 changes
+ We probably don't now need such ancient info.
+ Michael Kerrisk
+ Update references to standards for C and S conversion specifiers
+
+profil.3
+ Michael Kerrisk
+ SEE ALSO: add sprof(1)
+
+charmap.5
+ Marko Myllynen
+ Various minor updates and improvements
+ - more precise title
+ - extend description a bit
+ - document previously omitted WIDTH_DEFAULT
+ Marko Myllynen
+ Remove accidental ISO C compliance reference
+ glibc refers in locale/programs/charmap.c to ISO C 99 section
+ 7.17.(2) and ISO C 99 section 5.2.1.(3) that if a character map
+ is not ASCII compatible then the locale using it is not ISO C
+ compliant. This does not state anything about the character set
+ itself.
+
+proc.5
+ Michael Kerrisk
+ Replace /proc/sys/kernel/printk discussion with reference to syslog(2)
+ It makes more sense to have the /proc/sys/kernel/printk with
+ the related material in syslog(2).
+ Michael Kerrisk
+ Rewrite /proc/sys/kernel/printk description
+
+inotify.7
+ Michael Kerrisk
+ Clarify which events are generated for watched directories
+ Really, with respect to watched directories, events fall into
+ three classes (not two, as was shown):
+
+ * Events that can be generated only for the watched directory.
+ * Events that can be generated only for objects that are inside
+ the watched directory.
+ * Events that can be generated both for the watched directory
+ and for objects inside the directory.
+
+ So, mark these three classes more clearly in the list of inotify
+ events.
+ Heinrich Schuchardt [Michael Kerrisk]
+ BUGS: Note possible bug triggered by watch descriptor reuse
+ Watch descriptor IDs are returned by inotify_add_watch().
+ When calling inotify_rm_watch() an IN_IGNORED is placed on the
+ inotify queue pointing to the ID of the removed watch.
+
+ inotify_add_watch() should not return a watch descriptor ID for
+ which events are still on the queue but should return an
+ unused ID.
+
+ Unfortunately, the existing Kernel code does not provide such a
+ guarantee.
+
+ Actually, in rare cases watch descriptor IDs are returned by
+ inotify_add_watch() for which events are still on the inotify
+ queue.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=77111
+ Michael Kerrisk
+ Add further detail to the watch descriptor reuse bug
+ As well as inotify_rm_watch(), file deletion and unmounting a
+ filesystem can also cause a watch descriptor to be deleted.
+ Michael Kerrisk
+ The watch descriptor reuse bug may be hard to hit in practice
+ Explain the circumstances in detail, indicating that the
+ bug may be very unlikely to occur in practice.
+ Michael Kerrisk
+ Clarify description of IN_EXCL_UNLINK
+ Clarify the text a little, in particular making it clearer
+ that the target of a watch is an i-node (not a pathname).
+ Michael Kerrisk
+ Clarify IN_ONESHOT explanation
+ Make it clearer that the target of monitoring is an i-node,
+ not a pathname.
+ Michael Kerrisk
+ Make comment on 'mask' field more accurate
+
+libc.7
+ Michael Kerrisk
+ Clarify man-pages policy on documenting C libraries other tahn glibc
+ Michael Kerrisk
+ Use absolute dates in discussion of libc vs glibc
+
+pipe.7
+ Elie De Brauwer
+ Add reference that the pipe capacity can be changed
+ In fcntl(2) F_SETPIPE_SZ, F_GETPIPE_SZ and
+ /proc/sys/fs/pipe-max-size are defined, however
+ pipe(7) still defines the pipe capacity as being
+ a static entity. Adding a reference to fcntl(2).
+ Michael Kerrisk [Walter Harms]
+ Clarify that since 2.6.35, 65535 bytes is the default pipe capacity
+
+ld.so.8
+ Michael Kerrisk
+ Clarify that LD_PROFILE can specify just a single shared object
+ Michael Kerrisk
+ Clarify that LD_PROFILE output is appended to target file
+ The LD_PROFILE output is appended to any existing
+ contents of the target file.
+ Michael Kerrisk
+ SEE ALSO: add sprof(1)
+
+
+==================== Changes in man-pages-3.71 ====================
+
+Released: 2014-08-17, Chicago
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adrian Bunk <bunk@kernel.org>
+Damir Nedzibovic <d.nedzibovic@anoxtech.com>
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Jakub Wilk <jwilk@debian.org>
+Jan Chaloupka <jchaloup@redhat.com>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+NeilBrown <neilb@suse.de>
+Paul Jackson <pj@usa.net>
+Peng Haitao <penght@cn.fujitsu.com>
+Rahul Bedarkar <rahulbedarkar89@gmail.com>
+Rob Landley <rob@landley.net>
+Ryan Hammonds <rhammonds@unicoi.com>
+Simon Paillard <spaillard@debian.org>
+Ville Ylenius <ville@ylenius.net>
+Vince Weaver <vincent.weaver@maine.edu>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+group_member.3
+ Michael Kerrisk
+ New page documenting group_member(3)
+
+isfdtype.3
+ Michael Kerrisk
+ New page documenting isfdtype(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+perf_event_open.2
+ Vince Weaver
+ Document new comm_exec flag
+ Linux 3.16 (more specifically, commit 82b897782d10fcc4 )
+ added support for differentiating between process renames
+ caused by exec versus those caused by other methods.
+ Vince Weaver
+ Document new mmap2 record type
+ Linux 3.16 (more specifically, commit a5a5ba72843dd05f9 )
+ enabled the enhanced mmap2 record support.
+ The interface was added in Linux 3.12 but disabled until
+ Linux 3.16.
+ Vince Weaver
+ Document PERF_SAMPLE_BRANCH_COND
+ Linux 3.16 (more specifically, commit bac52139f0b7ab31330 )
+ adds support for gathering PERF_SAMPLE_BRANCH_COND
+ conditional branch values when doing PERF_SAMPLE_BRANCH_STACK
+ sampling.
+
+proc.5
+ Michael Kerrisk
+ Document /proc/PID/comm
+ Michael Kerrisk
+ Document /proc/PID/pagemap
+ Michael Kerrisk
+ Document /proc/PID/personality
+ Michael Kerrisk
+ Document /proc/PID/syscall
+ Michael Kerrisk
+ Document /proc/kpagecount
+ Michael Kerrisk
+ Document /proc/kpageflags
+ Michael Kerrisk
+ Document /proc/sys/vm/overcommit_kbytes
+
+capabilities.7
+ Michael Kerrisk
+ Add CAP_AUDIT_READ
+ CAP_AUDIT_READ is new in Linux 3.16.
+
+
+Global changes
+--------------
+
+ldd.1
+clone.2
+execve.2
+getpagesize.2
+ioperm.2
+msgop.2
+readv.2
+recv.2
+select.2
+send.2
+seteuid.2
+shmop.2
+signal.2
+sync.2
+sysinfo.2
+utime.2
+abs.3
+atoi.3
+catopen.3
+clearenv.3
+ctime.3
+des_crypt.3
+ecvt.3
+flockfile.3
+fseeko.3
+ftime.3
+ftok.3
+ftw.3
+getcwd.3
+getdtablesize.3
+getline.3
+getpass.3
+getpass.3
+getutent.3
+glob.3
+insque.3
+lseek64.3
+memmem.3
+mkstemp.3
+mktemp.3
+on_exit.3
+openpty.3
+putenv.3
+putenv.3
+qecvt.3
+realpath.3
+realpath.3
+remove.3
+setbuf.3
+sigpause.3
+strftime.3
+strptime.3
+tzset.3
+xcrypt.3
+utmp.5
+environ.7
+ipv6.7
+packet.7
+ Michael Kerrisk
+ Remove ancient Linux libc details
+
+access.2
+brk.2
+chmod.2
+eventfd.2
+gethostname.2
+getpriority.2
+mmap.2
+poll.2
+ptrace.2
+readv.2
+sched_setaffinity.2
+select.2
+seteuid.2
+signalfd.2
+sync_file_range.2
+timer_create.2
+uname.2
+wait.2
+ Michael Kerrisk
+ NOTES: add "C library/kernel ABI differences" subheading
+
+
+Changes to individual pages
+---------------------------
+
+access.2
+ Michael Kerrisk
+ Glibc falls back to using access() on kernels that lack faccessat()
+
+bdflush.2
+fsync.2
+sync.2
+proc.5
+ Adrian Bunk
+ Change "sync(1)" to "sync(8)"
+
+bind.2
+ Michael Kerrisk [Ryan Hammonds]
+ Correct EINVAL error description
+ As pointed out by Ryan:
+
+ My application is trying to bind an IPv4 UDP socket to an
+ address. I've found that passing an invalid address length
+ to bind() causes bind to return EINVAL. According to the
+ bind(2) manpage, this should only occur when using unix
+ domain sockets (which I am not).
+
+chmod.2
+ Michael Kerrisk
+ Glibc falls back to chmod() on kernels that don't support fchmodat()
+ Michael Kerrisk
+ Glibc falls back to chown()/lchown() on kernels that lack fchownat()
+
+epoll_wait.2
+ Michael Kerrisk
+ NOTES: describe raw epoll_pwait() system call differences
+
+getgroups.2
+ Michael Kerrisk
+ SEE ALSO: add group_member(3)
+
+getpriority.2
+ Michael Kerrisk
+ Enhance discussion of kernel nice range versus user-space nice range
+ Michael Kerrisk
+ Move text describing nice range on other systems
+
+getrlimit.2
+ Michael Kerrisk
+ Add cross reference to core(5) in discussion of RLIMIT_CORE
+ Michael Kerrisk
+ Describe the "large" resource limit bug on 32-bit platforms
+ See https://bugzilla.kernel.org/show_bug.cgi?id=5042.
+ Michael Kerrisk
+ Glibc's setrlimit() and getrlimit() are implemented using prlimit()
+
+kexec_load.2
+ Michael Kerrisk
+ Note limit of 16 for 'nr_segments'
+ Michael Kerrisk
+ Clarify the 'flags' bits that contain the architecture
+ Michael Kerrisk
+ Add KEXEC_ARCH_68K to list of architectures for 'flags'
+ Michael Kerrisk
+ Reword description of 'flags' a little
+
+link.2
+ Michael Kerrisk
+ Glibc falls back to link() on kernels that lack linkat()
+ Unless 'flags' contains AT_SYMLINK_FOLLOW.
+
+mkdir.2
+ Michael Kerrisk
+ Glibc falls back to mkdir() on kernels that don't support mkdirat()
+
+perf_event_open.2
+ Vince Weaver
+ Clarify PERF_SAMPLE_STACK_USER usage
+ This clarifies the PERF_SAMPLE_STACK_USER section.
+ I found these issue while implementing some code that uses
+ the option. The important change is fixing the name of the
+ sample_stack_user parameter, the rest is just some wording
+ fixes and minor clarifications.
+ Vince Weaver
+ Clarify PERF_SAMPLE_DATA_SRC usage
+ When checking the fields in the PERF_SAMPLE_DATA_SRC type samples
+ you need to shift the masks before doing the compare.
+
+ Although the value you are checking (perf_mem_data_src) is
+ specified as a bitfield so this might all fall apart if trying
+ to access the field in a cross-endian way. The Power people
+ were working on this issue, not sure if they resolved it.
+
+poll.2
+ Michael Kerrisk
+ Describe fifth argument (sigsetsize) of raw ppoll() system call
+
+process_vm_readv.2
+ Michael Kerrisk [Ville Ylenius]
+ Fix typo in example program
+
+readlink.2
+ Michael Kerrisk
+ Glibc falls back to readlink() on kernels that lack readlinkat()
+
+recv.2
+ Michael Kerrisk
+ 'addrlen' should be NULL (not 0) if we don't need sender address
+
+rename.2
+ Michael Kerrisk
+ Glibc falls back to rename() when the kernel doesn't have renameat()
+
+sigwaitinfo.2
+ Michael Kerrisk
+ The raw sigtimedwait() system call has a fifth argument
+
+symlink.2
+ Michael Kerrisk
+ Glibc falls back to symlink() on kernels that lack symlinkat()
+
+sysinfo.2
+ Michael Kerrisk
+ Add VERSIONS section
+
+unlink.2
+ Michael Kerrisk
+ Glibc falls back to unlink() or rmdir() on kernels that lack unlinkat()
+
+atoi.3
+ Michael Kerrisk
+ Downgrade discussion of atoq()
+ Remove most references to atoq() in this page, since this function
+ was present only in Linux libc (not glibc).
+
+cerf.3
+cexp2.3
+clog2.3
+ Michael Kerrisk
+ Update version number on "Not yet in glibc" sentence
+
+fgetgrent.3
+getgrent.3
+getgrent_r.3
+getgrnam.3
+ Michael Kerrisk [Rob Landley]
+ Clarify that 'gr_mem' is a NULL-terminated array of pointers
+
+fseeko.3
+ Michael Kerrisk
+ Add VERSIONS section
+
+ftw.3
+ Michael Kerrisk
+ Add VERSIONS section
+
+getauxval.3
+ Michael Kerrisk
+ Document ENOENT error
+ And add an entry to BUGS explaining the ambiguity that was
+ present before the addition of this error.
+
+getgrouplist.3
+ Michael Kerrisk
+ SEE ALSO: add group_member(3)
+
+getline.3
+ Rahul Bedarkar
+ Close opened file at end of example program
+
+memmem.3
+ Michael Kerrisk
+ Rewrite text of glibc 2.0 bug
+
+printf.3
+ Michael Kerrisk [Jakub Wilk]
+ Clarify details of the %n conversion specifier
+ See http://bugs.debian.org/756602
+ Michael Kerrisk [Jakub Wilk]
+ Note use of 'j', 'z', and 't' length modifiers for '%n'
+ See http://bugs.debian.org/756602
+ Michael Kerrisk
+ Update with some SUSv3 details
+
+setbuf.3
+ Michael Kerrisk
+ Remove ancient Linux libc and 4.x BSD details
+
+strstr.3
+ Michael Kerrisk
+ Remove discussion of Linux libc bugs
+ Linux libc is old enough that we needn't care any longer.
+
+strtod.3
+ Michael Kerrisk
+ Explain NAN(n-char-sequence)
+
+strtod.3
+ Michael Kerrisk
+ SEE ALSO: add nan(3), nanf(3), NANL(3)
+
+updwtmp.3
+ Michael Kerrisk
+ Replace AVAILABILITY section with note to link logwtmp() using -lutil
+ Linux libc details are no longer needed these days.
+
+core.5
+ Rahul Bedarkar
+ Close opened file in example program
+
+proc.5
+ Michael Kerrisk
+ Fix kernel version numbers for /proc/PID/stat fields
+
+proc.5
+ Jan Chaloupka
+ Add missing proc stats fields
+ Adding missing proc stats fields from
+ https://www.kernel.org/doc/Documentation/filesystems/proc.txt
+ Michael Kerrisk [Simon Paillard]
+ Remove crufty text under 'timer_stats'
+ Michael Kerrisk
+ Update /proc/PID/stat 'state' field documentation
+ Michael Kerrisk
+ Improve description of /proc/PID/stat fields added in Linux 3.3 and 3.5
+ Michael Kerrisk
+ Refer to getauxval(3) in discussion of /proc/PID/auxv
+ Michael Kerrisk
+ Rework formatting of /proc/PID/stat list
+ Make the field numbers more prominent.
+ Michael Kerrisk
+ Note that /proc/PID/cmdline is read-only
+ Michael Kerrisk
+ Rework discussion of CommitLimit and /proc/sys/vm/overcommit_memory
+ Michael Kerrisk
+ Improve discussion of /proc/sys/vm/overcommit_ratio
+
+charsets.7
+ David Prévot [Marko Myllynen]
+ Tidy up list
+ Remove German from main list, to be consistent with earlier
+ removal of Dutch and French (in commit a8ed5f7430e0d1).
+
+inotify.7
+ Michael Kerrisk
+ Note that IN_ONLY_DIR can be used to avoid races
+ Michael Kerrisk
+ Note that insertion of IN_MOVED_FROM+IN_MOVED_TO pair is not atomic
+ Michael Kerrisk
+ Mention use of timeout when reading IN_MOVED_TO after IN_MOVED_FROM
+
+man-pages.7
+ Michael Kerrisk
+ Add description of "C library/kernel ABI differences" subsection
+ Michael Kerrisk
+ Rework text describing sections (stylistic improvements)
+
+vdso.7
+ Mike Frysinger
+ Add new i386 vdso symbols in Linux 3.15
+ Michael Kerrisk
+ Note kernel version that exports new i386 symbols (Linux 3.15)
+
+
+==================== Changes in man-pages-3.72 ====================
+
+Released: 2014-09-07, Mountain View
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Christian von Roques <roques@mti.ag>
+Holger Hans Peter Freyther <holger@moiji-mobile.com>
+Michael Haardt <michael@moria.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peter Schiffer <pschiffe@redhat.com>
+Rusty Russell <rusty@rustcorp.com.au>
+Sorin Dumitru <sdumitru@ixiacom.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+memusage.1
+ Peter Schiffer, Michael Kerrisk [Jan Chaloupka]
+ New page for glibc memusage(1) command
+
+memusagestat.1
+ Peter Schiffer [Jan Chaloupka, Michael Kerrisk]
+ New page for glibc memusagestat(1) command
+
+mtrace.1
+ Peter Schiffer [Jan Chaloupka]
+ New page describing the glibc mtrace(1) command
+
+
+Changes to individual pages
+---------------------------
+
+connect.2
+ Michael Haardt
+ Note that a new socket should be used if connect() fails
+
+fcntl.2
+ Michael Kerrisk
+ One must define _GNU_SOURCE to get the F_OFD_* definitions
+
+poll.2, select.2
+ Rusty Russell
+ Fix erroneous description of "available for write".
+ POSIX says: "POLLOUT Normal data may be written without
+ blocking.". This "may" is misleading, see the POSIX
+ write page:
+
+ Write requests to a pipe or FIFO shall be handled in the
+ same way as a regular file with the following exceptions:
+ ...
+ If the O_NONBLOCK flag is clear, a write request may cause
+ the thread to block, but on normal completion it shall
+ return nbyte.
+ ...
+ When attempting to write to a file descriptor (other than a
+ pipe or FIFO) that supports non-blocking writes and cannot
+ accept the data immediately:
+
+ If the O_NONBLOCK flag is clear, write() shall block the
+ calling thread until the data can be accepted.
+
+ If the O_NONBLOCK flag is set, write() shall not block the
+ thread. If some data can be written without blocking the
+ thread, write() shall write what it can and return the
+ number of bytes written. Otherwise, it shall return -1 and
+ set errno to [EAGAIN].
+
+ The net result is that write() of more than 1 byte on a
+ socket, pipe or FIFO which is "ready" may block: write()
+ (unlike read!) will attempt to write the entire buffer and
+ only return a short write under exceptional circumstances.
+
+ Indeed, this is the behaviour we see in Linux:
+
+ https://github.com/rustyrussell/ccan/commit/897626152d12d7fd13a8feb36989eb5c8c1f3485
+ https://plus.google.com/103188246877163594460/posts/BkTGTMHDFgZ
+
+errno.3
+ Michael Kerrisk
+ SEE ALSO: add errno(1)
+
+rtnetlink.3
+ Holger Hans Peter Freyther
+ Fix parameters for the send() call in the example
+
+inotify.7
+ Michael Kerrisk
+ IN_OPEN and IN_CLOSE_NOWRITE can also occur for directories
+ Michael Kerrisk
+ IN_CLOSE_WRITE occurs only for files (not monitored directory)
+ Michael Kerrisk
+ IN_MODIFY is generated for files only (not monitored directories)
+ Michael Kerrisk
+ IN_ACCESS occurs only for files inside directories
+ IN_ACCESS does not occur for monitored directory.
+
+packet.7
+ Sorin Dumitru
+ Fix include file
+ It looks like most of the socket options from this man pages
+ are not defined in <netpacket/packet.h>. They are defined in
+ <linux/if_packet.h> so we should include that one.
+
+
+==================== Changes in man-pages-3.73 ====================
+
+Released: 2014-09-21, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+David Prévot <taffit@debian.org>
+Eric W. Biederman <ebiederm@xmission.com>
+J. Bruce Fields <bfields@fieldses.org>
+Justin Cormack <justin@street-vision.com>
+Lorenzo Beretta <lory.fulgi@infinito.it>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Rob Landley <rob@landley.net>
+Serge E. Hallyn <serge@hallyn.com>
+Serge Hallyn <serge.hallyn@ubuntu.com>
+Vasily Kulikov <segoon@openwall.com>
+Vincent Lefevre <vincent@vinc17.net>
+Vitaly Rybnikov <frodox@zoho.com>
+Yuri Kozlov <yuray@komyakino.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+namespaces.7
+ Michael Kerrisk [Eric W. Biederman]
+ New page providing overview of Linux namespaces
+
+pid_namespaces.7
+ Michael Kerrisk [Eric W. Biederman, Vasily Kulikov, Rob Landley,
+ Serge Hallyn]
+ New page describing PID namespaces
+
+user_namespaces.7
+ Michael Kerrisk [Eric W. Biederman, Andy Lutomirski, Serge Hallyn]
+ New page describing user namespaces.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Eric W. Biederman [Michael Kerrisk]
+ Document CLONE_NEWUSER for creating a new user namespace
+
+setns.2
+ Eric W. Biederman, Michael Kerrisk
+ Document the PID, user, and mount namespace support
+ Document CLONE_NEWPID, CLONE_NEWUSER, and CLONE_NEWNS flags.
+
+unshare.2
+ Michael Kerrisk [Eric W. Biederman]
+ Document CLONE_NEWPID
+ Michael Kerrisk [Eric W. Biederman]
+ Document CLONE_NEWUSER
+ Michael Kerrisk
+ Document CLONE_THREAD, CLONE_SIGHAND, and CLONE_VM
+
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Move some CLONE_NEWNET text to namespaces.7
+ Michael Kerrisk
+ Move some CLONE_NEWUTS text 2 to namespaces.7
+ Michael Kerrisk
+ Move some CLONE_NEWIPC text to namespaces.7
+ Michael Kerrisk
+ Reword discussion of CLONE_NEWNS, removing text also in namespaces(7)
+ Michael Kerrisk
+ Standardize text on CLONE_NEW* flags and CAP_SYS_ADMIN
+ Michael Kerrisk
+ EINVAL if (CLONE_NEWUSER|CLONE_NEWPID) && (CLONE_THREAD|CLONE_PARENT)
+ Michael Kerrisk
+ Add more detail on the meaning of CLONE_SYSVSEM
+
+flock.2
+ Michael Kerrisk [J. Bruce Fields]
+ Don't mention "classical BSD" in discussion of fcntl()/flock interaction
+ The noninteraction of flock(2) and fcntl(2) locks does
+ not seem to be classical BSD semantics (at least, checking
+ the 4.4BSD sources suggest that the lock types do interact,
+ although there have been other systems also where fcntl()
+ and flock() locks do not interact). So, fix the text
+ discussing "classical BSD" lock semantics.
+
+getunwind.2
+ Michael Kerrisk [Yuri Kozlov]
+ Fix description of return value
+ s/size of unwind table/size of the unwind data/
+
+mount.2
+ Eric W. Biederman
+ Clarify use of 'mountflags' and 'data' for MS_REMOUNT
+
+reboot.2
+ Michael Kerrisk [Justin Cormack, Eric W. Biederman]
+ Document effect of reboot() inside PID namespaces
+
+semop.2
+ Michael Kerrisk
+ Refer to clone(2) for semantics of CLONE_SYSVSEM and semadj lists
+
+seteuid.2
+setgid.2
+setresuid.2
+setreuid.2
+setuid.2
+ Michael Kerrisk
+ EINVAL can occur if UID/GID is not valid in caller's user namespace
+
+setns.2
+ Michael Kerrisk [Eric W. Biederman]
+ Clarify capabilities required for reassociating with a mount namespace
+ Michael Kerrisk
+ Specify kernel version on each CLONE_NEW* flag
+ And remove text on flags from VERSIONS.
+
+unshare.2
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk
+ Clarify semantics of CLONE_SYSVSEM
+ Michael Kerrisk
+ CLONE_SYSVSEM does not require CAP_SYS_ADMIN
+ Michael Kerrisk
+ Note flags implied by CLONE_THREAD and CLONE_VM
+
+clock.3
+ Michael Kerrisk [Vincent Lefevre]
+ The implementation uses clock_gettime() was to improve *accuracy*
+ (The man page text mistakenly used the word "precision".)
+
+drand48.3
+ Michael Kerrisk [Lorenzo Beretta]
+ Remove crufty text about SVID 3 marking drand48() obsolete
+ See http://bugs.debian.org/758293
+
+proc.5
+ Michael Kerrisk
+ Move /proc/[pid]/mounts text to namespaces.7
+ Michael Kerrisk
+ Move /proc/[pid]/mountstats text to namespaces.7
+
+capabilities.7
+ Michael Kerrisk
+ Refer reader to user_namespaces(7) for a discussion of capabilities
+ Michael Kerrisk
+ Document CAP_SETUID and CAP_SETGID for user namespace mappings
+ Michael Kerrisk
+ setns() needs CAP_SYS_ADMIN in the *target* namespace
+ Michael Kerrisk
+ Since Linux 3.8, user namespaces no longer require CAP_SYS_ADMIN
+
+mq_overview.7
+ Michael Kerrisk
+ Refer to namespaces(7) for info on POSIX MQs and IPC namespaces
+
+svipc.7
+ Michael Kerrisk
+ Refer to namespaces(7) for info on System V IPC and IPC namespaces
+
+
+==================== Changes in man-pages-3.74 ====================
+
+Released: 2014-10-03, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Arto Bendiken <arto@bendiken.net>
+Ben Hutchings <ben@decadent.org.uk>
+Benjamin Herr <ben@0x539.de>
+C. Alex North-Keys <erlkonig@talisman.org>
+Carlos O'Donell <carlos@redhat.com>
+Cyril Hrubis <chrubis@suse.cz>
+Davidlohr Bueso <dave@stgolabs.net>
+Doug Ledford <dledford@redhat.com>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Jonny Grant <jg@jguk.org>
+Lanchon <lanchon@gmail.com>
+Manfred Spraul <manfred@colorfullife.com>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Shriramana Sharma <samjnaa@gmail.com>
+Thomas Mack <mack@ifis.cs.tu-bs.de>
+Wieland Hoffmann <themineo@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pldd.1
+ Michael Kerrisk
+ New page for pldd(1) command added to glibc in version 2.15
+
+cp1252.7
+ Marko Myllynen
+ New page documenting CP 1252
+ CP 1252 is probably one of the most used Windows Code Pages so
+ let's add a page for it alongside with the already provided
+ CP 1251 page.
+
+ Table generated from /usr/share/i18n/charmaps/CP1252.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+mq_overview.7
+ Michael Kerrisk
+ Document /proc/sys/fs/mqueue/msgsize_default
+ Michael Kerrisk
+ Document /proc/sys/fs/mqueue/msg_default
+
+
+Changes to individual pages
+---------------------------
+
+ldd.1
+ Michael Kerrisk
+ SEE ALSO: add pldd(1)
+
+execve.2
+ Michael Kerrisk [C. Alex North-Keys]
+ Remove unneeded ".sh" extension in interpreter script example
+ See https://bugzilla.kernel.org/show_bug.cgi?id=84701
+
+fanotify_init.2
+ Heinrich Schuchardt
+ BUGS: O_CLOEXEC is ignored
+ Michael Kerrisk [Heinrich Schuchardt]
+ The 'event_f_flags' failure to check invalid flags was fixed in 3.15
+
+fanotify_mark.2
+ Michael Kerrisk
+ Note that various bugs were fixed in Linux 3.16
+
+getrlimit.2
+ Michael Kerrisk [Doug Ledford]
+ Since Linux 3.5, the accounting formula for RLIMIT_MSGQUEUE has changed
+
+open.2
+ Michael Kerrisk [Shriramana Sharma]
+ Fix number and formula in description of EOVERFLOW error
+
+readlink.2
+ Michael Kerrisk [Ben Hutchings]
+ Fix description of readlinkat() with empty 'pathname'
+ Michael Kerrisk
+ SEE ALSO: add realpath(3)
+
+sched_setattr.2
+sched_setscheduler.2
+ Michael Kerrisk
+ SEE ALSO: add chrt(1)
+
+shmget.2
+ Manfred Spraul [Michael Kerrisk, Davidlohr Bueso]
+ Update for increase of SHMALL and SHMMAX
+ The default values of SHMALL and SHMMAX have been increased.
+
+syscalls.2
+ Michael Kerrisk
+ Add 3 new system calls added in Linux 3.17
+
+vmsplice.2
+ Cyril Hrubis
+ vmsplice() does not fail when nr_segs==0
+ This nr_segs==0 case is no-op; the call succeeds and no
+ EINVAL error is returned.
+
+dlopen.3
+ Michael Kerrisk
+ SEE ALSO: add pldd(1)
+
+fseeko.3
+ Michael Kerrisk [Thomas Mack]
+ _FILE_OFFSET_BITS must be defined before including any header file
+
+getgrent.3
+ Carlos O'Donell
+ Add ENOENT and EAGAIN to error list
+
+mq_getattr.3
+ Michael Kerrisk
+ Add an example program
+ The example program can be used to discover the default
+ 'mq_maxmsg' and 'mq_msgsize' values used to create a queue with
+ a mq_open(3) call in which 'attr' is NULL.
+
+mq_open.3
+ Michael Kerrisk
+ Two /proc files control the defaults for the attrp==NULL case
+ Refer the reader to the discussion in mq_overview(7) for a
+ discussion of these files, which exist since Linux 3.5.
+
+realpath.3
+ Michael Kerrisk
+ SEE ALSO: add realpath(1)
+
+proc.5
+ Elie De Brauwer
+ Document /proc/buddyinfo
+ This patch adds a short description about the contents of
+ /proc/buddyinfo and how this file can be used to assist
+ in checking for memory fragmentation issues.
+ Michael Kerrisk
+ Mention pmap(1) in discussion of /proc/PID/smaps
+
+armscii-8.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+ascii.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+ This and [the related *.7] patches will provide unification of
+ charset pages, minor cleanups, and some unifying cosmetic
+ changes. References are adjusted so that all pages include
+ a reference to charsets(7), which contains a description of
+ these sets, stray comments are removed, some obsolete
+ statements (like ISO 8859-1 being the de-facto ASCII
+ replacement) are removed, and some minor reformatting
+ to minimize diff's between the pages are done.
+
+ The actual substance, the character tables, remain unchanged.
+
+ This series changes the following pages (under man7): ascii,
+ armscii, cp1251, koi8-r, koi8-u, and all of iso_8859-*.
+
+cp1251.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-10.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-11.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-13.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-14.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-15.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-16.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-1.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-2.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-3.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-4.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-5.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-6.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-7.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-8.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+iso_8859-9.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+
+koi8-r.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+ - remove stray comments, streamline description
+ (charsets(7) and Wikipedia provide more detailed
+ and up-to-date description)
+ - list differences between koi8-r.7 vs koi8-u.7
+
+koi8-u.7
+ Marko Myllynen
+ Charset pages unification, minor cleanups
+ - remove stray comments, streamline description
+ (charsets(7) and Wikipedia provide more detailed
+ and up-to-date description)
+ - list differences between koi8-r.7 vs koi8-u.7
+
+mq_overview.7
+ Michael Kerrisk
+ Update queues_max details for Linux 3.14
+ And in general rework the text a little.
+ Michael Kerrisk
+ Update discussion of HARD_MSGMAX
+ The limit has changed in 2.6.33 and then again in 3.5.
+ Michael Kerrisk [Arto Bendiken]
+ Update details for 'queues_max' limit
+ Things changed in Linux 3.5.
+ See https://bugs.launchpad.net/bugs/1155695
+ Michael Kerrisk
+ Update details on defaults and ceiling for 'msgsize_max' limit
+ Michael Kerrisk
+ Rework discussion of HARD_MSGMAX
+ Michael Kerrisk [Davidlohr Bueso]
+ Various fixes after review from Davidlohr Bueso
+
+sched.7
+ Michael Kerrisk
+ SEE ALSO: add taskset(1)
+
+ld.so.8
+ Michael Kerrisk
+ SEE ALSO: add pldd(1)
+ Michael Kerrisk
+ SEE ALSO: add dlopen(3)
+ Michael Kerrisk
+ SEE ALSO: add ld(1)
+
+
+
+==================== Changes in man-pages-3.75 ====================
+
+Released: 2014-10-15, Düsseldorf
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Jonny Grant <jg@jguk.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Robert Schweikert <rjschwei@suse.com>
+Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
+Walter Harms <wharms@bfs.de>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pthread_rwlockattr_setkind_np.3
+ Robert Schweikert [Michael Kerrisk]
+ New page documenting pthread_rwlockattr_[sg]etkind_np(3)
+ Documents pthread_rwlockattr_setkind_np(3) and
+ pthread_rwlockattr_getkind_np(3).
+
+
+New and changed links
+---------------------
+
+pthread_rwlockattr_getkind_np.3
+ Robert Schweikert
+ New link to pthread_rwlockattr_setkind_np(3)
+
+
+Changes to individual pages
+---------------------------
+
+readlink.2
+ Michael Kerrisk [Jonny Grant]
+ Add free() call to example program
+
+readv.2
+ Michael Kerrisk
+ The raw preadv() and pwritev() syscalls split 'offset' into 2 arguments
+
+signal.7
+ Michael Kerrisk
+ pthread_mutex_lock() and pthread_cond_wait() are restartable
+ pthread_mutex_lock(, pthread_cond_wait(), and related APIs are
+ automatically restarted if interrupted by a signal handler.
+
+unix.7
+ Michael Kerrisk [Carlos O'Donell, David Miller, Tetsuo Handa]
+ Various additions and rewordings
+ Notable changes:
+ * Clarify some details for pathname sockets.
+ * Add some advice on portably coding with pathname sockets.
+ * Note the "buggy" behavior for pathname sockets when
+ the supplied pathname is 108 bytes (after a report by
+ Tetsuo Handa).
+
+
+==================== Changes in man-pages-3.76 ====================
+
+Released: 2014-12-31, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adam Jiang <jiang.adam@gmail.com>
+Andrea Balboni <andrea.balboni@unimore.it>
+Andreas Schwab <schwab@suse.de>
+Bernhard Walle <bernhard@bwalle.de>
+Carlos O'Donell <carlos@redhat.com>
+David Wragg <david@wragg.org>
+Florian Westphal <fw@strlen.de>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Huxiaoxiang <huxiaoxiang@huawei.com>
+Jan Chaloupka <jchaloup@redhat.com>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Josh Triplett <josh@joshtriplett.org>
+Kamezawa Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
+Laurent Georget <laurent.georget@supelec.fr>
+Manuel López-Ibáñez <lopezibanez@gmail.com>
+Marko Myllynen <myllynen@redhat.com>
+Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
+Mel Gorman <mgorman@suse.de>
+Michael Gehring <mg@ebfe.org>
+Michael Haardt <michael@moria.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Richard Weinberger <richard@nod.at>
+Rich Felker <dalias@libc.org>
+Scott Harvey <scott.harvey@stonybrook.edu>
+Siddhesh Poyarekar <siddhesh.poyarekar@gmail.com>
+Simon Newton <nomis52@gmail.com>
+Simon Paillard <spaillard@debian.org>
+Sven Hoexter <sven@stormbind.net>
+Tobias Werth <werth@cs.fau.de>
+Weijie Yang <weijie.yang.kh@gmail.com>
+Will Newton <will.newton@linaro.org>
+Yuri Kozlov <yuray@komyakino.ru>
+刘湃 <liupai_work@163.com>
+尹杰 <writalnaie@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+adjtimex.2
+ Laurent Georget
+ Add fields in struct timex description
+ This patch updates the man page with the new fields added in
+ struct timex since last edition of the man page.
+ Laurent Georget [Michael Kerrisk]
+ Document ADJ_TAI
+ Michael Kerrisk
+ Improve description of ADJ_OFFSET_SINGLESHOT
+ Michael Kerrisk
+ Add brief documentation of ADJ_MICRO and ADJ_NANO
+ Michael Kerrisk
+ Reformat return value list
+ And remove numeric values, since they're not needed
+ Michael Kerrisk
+ Other 'modes' bits are ignored on ADJ_OFFSET_*
+ Other bits in 'modes' are ignored if modes contains
+ ADJ_OFFSET_SINGLESHOT or ADJ_OFFSET_SS_READ.
+ Michael Kerrisk
+ Add nanosecond details
+ Fixes https://bugzilla.kernel.org/show_bug.cgi?id=61171.
+ Michael Kerrisk
+ Document ADJ_OFFSET_SS_READ
+ Michael Kerrisk
+ Reformat 'times' flags as list
+ And remove numeric values, since they're not needed.
+ Michael Kerrisk
+ Note effect of ADJ_NANO for ADJ_SETOFFSET
+ Michael Kerrisk
+ Add comment noting that timex structure contains padding bytes
+ Michael Kerrisk
+ Add more details to description of 'tai' field
+ Michael Kerrisk
+ Note meaning of "PLL" abbreviation
+ Michael Kerrisk
+ Clarify which 'timex' field is used by each 'modes' bit
+ Michael Kerrisk
+ Document timex 'status' bits
+ Michael Kerrisk
+ Clarify treatment of other 'modes' bits for ADJ_OFFSET_*
+ Michael Kerrisk
+ Update RFC number: RFC 5905 obsoletes RFC 1305
+ Michael Kerrisk
+ Briefly document ADJ_SETOFFSET
+ Michael Kerrisk
+ Note PPS (pulse per second) fields in timex structure
+
+sigreturn.2
+ Michael Kerrisk
+ Add (a lot) more detail on the signal trampoline
+ And rewrite much of the page.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+proc.5
+ Bernhard Walle
+ Document /proc/thread-self
+ /proc/thread-self has been introduced in Linux 3.17 with
+ commit 0097875bd41528922fb3bb5f348c53f17e00e2fd.
+ Sven Hoexter [Michael Kerrisk, Kamezawa Hiroyuki]
+ Document "VmSwap" field of /proc/[pid]/status
+ Florian Westphal
+ Document /proc/net/netfilter/nfnetlink_queue
+
+
+Changes to individual pages
+---------------------------
+
+localedef.1
+ Marko Myllynen
+ Mention default path for compiled files
+
+clock_nanosleep.2
+ Michael Kerrisk
+ Note that 'clock_id' can also be a CPU clock ID
+
+epoll_ctl.2
+ Michael Kerrisk
+ Regular files and directories can't be monitored with epoll_ctl()
+
+ioctl.2
+ Heinrich Schuchardt
+ Rename 'd' argument to 'fd' in text
+ In most other manpages file descriptors are called 'fd'.
+ This patches renames attribute 'd' to 'fd'.
+
+madvise.2
+ Michael Kerrisk
+ VERSIONS: Support for madvise() is now configurable
+ Support for this system call now depends on the
+ CONFIG_ADVISE_SYSCALLS configuration option.
+
+open.2
+ Michael Kerrisk
+ Enhance rationale discussion for openat() and friends
+
+posix_fadvise.2
+ Mel Gorman
+ Document the behavior of partial page discard requests
+ It is not obvious from the interface that "partial page discard"
+ requests are ignored. It should be spelled out.
+ Michael Kerrisk [Weijie Yang]
+ ERRORS: Since 2.6.16, the kernel correctly deals with the ESPIPE case
+ Michael Kerrisk
+ Support for fadvise64() is now configurable
+ Support for this system call now depends on the
+ CONFIG_ADVISE_SYSCALLS configuration option.
+
+prctl.2
+ Andreas Schwab
+ Correct description of null-termination in PR_GET_NAME and PR_SET_NAME
+ The size of the process name has always been at most 16 byte
+ _including_ the null terminator. This also means that the
+ name returned by PR_GET_NAME is always null-terminated.
+ Michael Kerrisk
+ PR_SET_NAME silently truncates strings that exceed 16 bytes
+
+restart_syscall.2
+ Michael Kerrisk
+ Add some text explaining why restart_syscall() exists
+
+sched_setaffinity.2
+ Michael Kerrisk
+ NOTES: Add paragraph on how to discover set of CPUs available on system
+ Michael Kerrisk
+ SEE ALSO: add nproc(1) and lscpu(1)
+
+select.2
+ Michael Kerrisk
+ SEE ALSO: add restart_syscall(2)
+
+semop.2
+ Michael Kerrisk
+ Add note that interrupted semtimedop() returns 'timeout' unchanged
+ Michael Kerrisk
+ Remove information about semtimedop() EAGAIN that is repeated elsewhere
+ Michael Kerrisk
+ Add subsection head for semtimedop()
+
+setsid.2
+ Michael Kerrisk
+ Rewrite some pieces and add some details
+ Among other changes, add an explanation of why setsid() can't
+ be called from a process group leader
+
+sgetmask.2
+ Michael Kerrisk
+ Since 3.16, support for these system calls is configurable
+ Support for these calls is now dependent on the setting of the
+ CONFIG_SGETMASK_SYSCALL option.
+
+sigaction.2
+ Michael Kerrisk
+ Document SA_RESTORER
+ Michael Kerrisk
+ Add some detail on the sa_restorer field
+ Michael Kerrisk
+ SEE ALSO: add sigreturn(2)
+
+splice.2
+ Michael Kerrisk
+ Reformat description of 'fd_in' and 'off_in' to improve readability
+
+syscall.2
+ Michael Kerrisk
+ SEE ALSO: add errno(3)
+
+syscalls.2
+ Michael Kerrisk
+ SEE ALSO: add errno(3)
+ Michael Kerrisk
+ 3.19 adds execveat()
+ Michael Kerrisk
+ Add bpf(2) to list
+
+tee.2
+ Michael Kerrisk
+ Add shell session demonstrating use of the example program
+
+tkill.2
+ Michael Kerrisk [Rich Felker]
+ Remove bogus text saying tgid==-1 makes tgkill() equivalent to tkill()
+
+abort.3
+ Michael Kerrisk
+ Note that SIGABRT is raised as though raise(3) is called
+ Also note that abort() is POSIX.1-2008 compliant.
+
+cmsg.3
+ David Wragg
+ Ensure buf is suitably aligned in sending example
+ Inspection of the definition of CMSG_FIRSTHDR (both in glibc and
+ the suggested definition in RFC3542) shows that it yields the
+ msg_control field. So when sending, the pointer placed in
+ msg_control should be suitably aligned as a struct cmsghdr.
+ In the sending example, buf was declared as a bare char array,
+ and so is not necessarily suitably aligned.
+
+ The solution here involves placing buf inside a union, and is
+ based on the sockets/scm_rights_send.c sample from The Linux
+ Programming Interface "dist" source code collection.
+
+exp10.3
+ Michael Kerrisk
+ Before glibc 2.19, exp() did not give ERANGE error on underflow
+ http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787
+
+ftw.3
+ Michael Kerrisk
+ FTW_CHDIR has no effect on the 'fpath' argument passed to fn()
+
+getopt.3
+ Michael Kerrisk [Jonny Grant]
+ Ensure that 'nsecs' is used
+
+ilogb.3
+ Michael Kerrisk [Will Newton]
+ Since glibc 2.16, ilogb() does correctly diagnose domain errors
+
+memcmp.3
+ Michael Haardt
+ Document return value for n==0 case
+ Michael Haardt
+ Warn against use of memcmp() for comparing security-critical data
+
+mq_open.3
+ Michael Kerrisk
+ Document the O_CLOEXEC flag
+ Michael Kerrisk
+ Place 'flags' constants in alphabetical order
+
+pow.3
+ Manuel López-Ibáñez
+ Add note on performance characteristics of pow()
+
+pthread_setschedparam.3
+ Simon Newton
+ Fix logic error in example program
+ The example program will crash if -A is used, since 'attr'
+ is uninitialized.
+
+ $ ./a.out -A
+ *** Error in `./a.out': free(): invalid pointer: 0xb779c3c4 ***
+ Aborted (core dumped)
+ 刘湃
+ Small fixes to example program
+
+sigvec.3
+ Michael Kerrisk
+ Starting with version 2.21, glibc no longer exports sigvec()
+
+sysconf.3
+ Josh Triplett
+ Document _SC_NGROUPS_MAX
+ Already documented in getgroups(2), but not in sysconf(3).
+
+termios.3
+ Michael Kerrisk
+ SEE ALSO: add tset(1)
+
+tgamma.3
+ Michael Kerrisk
+ Since glibc 2.18, errno is correctly set to EDOM when (x == -infinity))
+
+wordexp.3
+ Carlos O'Donell
+ Make it clear that WRDE_NOCMD prevents command substitution
+ The use of WRDE_NOCMD prevents command substitution. If the flag
+ WRDE_NOCMD is set then no command substitution shall occur and
+ the error WRDE_CMDSUB will be returned if such substitution is
+ requested when processing the words.
+
+ The manual page as-is makes it seem like the command substitution
+ occurs, and an error is returned *after* the substitution.
+ This patch clarifies that.
+
+locale.5
+ Marko Myllynen
+ Describe the formats of values
+ locale(5) describes what a locale should define but doesn't
+ spell out how (in what format). The patch attempts to address
+ this, it also has few trivial additional enhancements.
+
+ * Reference to locale(7) for category descriptions.
+ * Clarify first_workday in NOTES a bit.
+ * Add upstream BZ reference for two missing LC_ADDRESS fields.
+ Marko Myllynen
+ Fix miscoded character
+
+resolv.conf.5
+ Jan Chaloupka
+ Add missing no-tld-query option
+ Based on commit [1], the no-tld-query option exists for
+ resolv.conf configuration file. Description of this option
+ is provided in [2]. This patch just copies this option
+ into resolv.conf.5 man page. Plus changes 'a' member
+ into 'an' before 'unqualified name as if it ...'
+ on the third line of [2]. Based on [3], this option
+ was added in glibc 2.14 as solving [4] bug.
+
+ [1] https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
+ [2] http://www.daemon-systems.org/man/resolv.conf.5.html man page.
+ [3] https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;h=952f32af17e7fb49c4c1a305de673a13075bfaf5;hb=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
+ [4] https://sourceware.org/bugzilla/show_bug.cgi?id=12734
+
+credentials.7
+ Josh Triplett
+ Cross-reference getgroups(2)
+ Since credentials.7 discusses supplementary GIDs, it should
+ reference getgroups(2).
+
+fanotify.7
+ Heinrich Schuchardt
+ Allow relative paths in example
+ The current example code requires passing an absolute
+ path to the mount to be watched.
+
+ By passing AT_FDCWD to fanotify_mark it can use both
+ absolute and relative paths.
+ Heinrich Schuchardt
+ fallocate(2) creates no events
+ fallocate(2) should create FAN_MODIFY events but does not.
+ Heinrich Schuchardt [Michael Kerrisk]
+ fanotify notifies only events generated on the same mount
+ Unfortunately, fanotify does not inform listeners for all paths
+ under which a touched filesystem object is visible, but only the
+ listener using the same path as the process touching the
+ filesystem object.
+ Heinrich Schuchardt
+ Update BUGS to note bugs still not fixed in 3.17
+ I bumped the Linux version number in the BUGS section to 3.17.
+
+inotify.7
+ Heinrich Schuchardt
+ fallocate(2) does not trigger inotify events
+ Calling fallocate(2) does not result in inotify events.
+
+locale.7
+ Marko Myllynen
+ Improve LOCPATH description
+ LOCPATH is ignored by privileged programs.
+
+ Add locale archive references.
+
+ Add FILES section.
+
+man-pages.7
+ Michael Kerrisk [Laurent Georget]
+ Clarify that SEE ALSO entries may refer to pages from other projects
+
+signal.7
+ Michael Kerrisk
+ Mention other "slow devices"
+ Reads from eventfd(2), signalfd(2), timerfd(2), inotify(7),
+ and fanotify(7) file descriptors are also slow operations
+ that are restartable.
+ Michael Kerrisk
+ Fix SO_RECVTIMEO/ SO_SENDTIMEO confusion in text
+ Michael Kerrisk
+ Since Linux 3.8, reads on inotify(7) file descriptors are restartable
+ Michael Kerrisk
+ inotify(7) reads no longer show the odd EINTR error after SIGCONT
+ Since kernel 3.7, reads from inotify(7) file descriptors no longer
+ show the (Linux oddity) behavior of failing with EINTR when the
+ process resumes after a stop signal + SIGCONT.
+ Michael Kerrisk
+ SEE ALSO: add sigreturn(2)
+
+unix.7
+ Michael Kerrisk [Scott Harvey]
+ Fix buglet in code snippet in BUGS section
+
+ld.so.8
+ Carlos O'Donell
+ Add --inhibit-cache option
+ The dynamic loader has 6 options, only 5 are documented.
+ This patch documents the sixth option i.e. `--inhibit-cache`.
+ Jonathan Wakely [Siddhesh Poyarekar]
+ Correct documentation of $ORIGIN
+ As noted by Siddhesh:
+
+ The ld.so man page says:
+
+ $ORIGIN (or equivalently ${ORIGIN})
+ This expands to the directory containing the
+ application executable. Thus, an application located
+ in somedir/app could be compiled with
+
+ This is incorrect since it expands to the directory containing
+ the DSO and not the application executable. This seems like
+ deliberate behaviour in dl-object.c, so it needs to be fixed in
+ the man page.
+
+ See http://stackoverflow.com/questions/26280738/what-is-the-equivalent-of-loader-path-for-rpath-specification-on-linux/26281226#26281226
+
+
+
+==================== Changes in man-pages-3.77 ====================
+
+Released: 2015-01-10, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Akihiro Motoki <amotoki@gmail.com>
+Alexandre Bique <bique.alexandre@gmail.com>
+Andre Majorel <aym-xunil@teaser.fr>
+Andy Lutomirski <luto@amacapital.net>
+Daniel Borkmann <dborkman@redhat.com>
+Dave Hansen <dave.hansen@intel.com>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Ignat Loskutov <ignat.loskutov@gmail.com>
+Jeff Epler <jepler@unpythonic.net>
+Jérôme Pouiller <jezz@sysmic.org>
+Kees Cook <keescook@chromium.org>
+Laurent Georget <laurent.georget@supelec.fr>
+Masanari Iida <standby24x7@gmail.com>
+Michael Haardt <michael@moria.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Richard Cochran <richardcochran@gmail.com>
+Stephan Mueller <stephan.mueller@atsec.com>
+Troy Davis <troy@yort.com>
+Vince Weaver <vincent.weaver@maine.edu>
+Will Drewry <wad@chromium.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+seccomp.2
+ Kees Cook, Michael Kerrisk, Will Drewry [Andy Lutomirski]
+ New page documenting seccomp(2)
+ Combines documentation from prctl, in-kernel seccomp_filter.txt
+ and dropper.c, along with details specific to the new system call.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+netlink.7
+ Stephan Mueller [Michael Kerrisk]
+ Add NETLINK_CRYPTO
+
+
+Changes to individual pages
+---------------------------
+
+adjtimex.2
+ Laurent Georget [Richard Cochran, Jeff Epler]
+ Clarify the 'ppm scaling' used in struct timex
+ This patch makes explicit and clarifies the unit used for
+ the fields "freq", "ppsfreq" and "stabil" in struct timex.
+ Michael Kerrisk [Masanari Iida]
+ Note that TIME_ERROR is the modern synonym for TIME_BAD
+
+perf_event_open.2
+ Vince Weaver
+ Clarify the PERF_FLAG_FD_* flags
+ This change clarifies the behavior of the PERF_FLAG_FD_OUTPUT and
+ PERF_FLAG_FD_NO_GROUP flags to perf_event_open(), and removes
+ the related FIXME comments.
+
+ While writing tests to validate the behavior of these flags I
+ discovered that PERF_FLAG_FD_OUTPUT has been broken since the
+ 2.6.35 kernel release.
+
+prctl.2
+ Dave Hansen [Michael Kerrisk]
+ Add description of Intel MPX calls
+ The 3.19 kernel will have support for Intel MPX, including
+ a pair of new prctl() calls (PR_MPX_ENABLE_MANAGEMENT and
+ PR_MPX_DISABLE_MANAGEMENT) for enabling and disabling the
+ kernel's management of the "bounds tables". Add a
+ descriptions of the interface.
+ Michael Kerrisk
+ Add mention of seccomp(2) under PR_SET_SECCOMP
+ Michael Kerrisk
+ Suggest /proc/PID/status "Seccomp" as alternative to PRCTL_GET_SECCOMP
+ Michael Kerrisk
+ SIGKILL can also occur PRCTL_GET_SECCOMP in SECCOMP_MODE_FILTER mode
+ Kees Cook [Andy Lutomirski]
+ Document SECCOMP_MODE_FILTER vs EFAULT
+ This notes the distinction made between EINVAL and EFAULT when
+ attempting to use SECCOMP_MODE_FILTER with PR_SET_SECCOMP.
+
+setns.2
+pid_namespaces.7
+ Mike Frysinger
+ Elaborate discussion of the PID namespace descendant limitation
+ The setns(2) man page already mentions that CLONE_NEWPID may only
+ be used with descendant namespaces, but this nuance could be
+ listed in a few more places so it is not missed.
+
+shmget.2
+ Michael Kerrisk [Akihiro Motoki]
+ Make wording of SHMALL description a little clearer
+
+sigaction.2
+ Michael Kerrisk
+ Add siginfo_t fields for SECCOMP_RET_TRAP
+
+memchr.3
+strstr.3
+ Alexandre Bique
+ Reference memmem(3) in SEE ALSO section
+
+memcmp.3
+ Michael Kerrisk [Michael Haardt]
+ NOTES: add some detail on avoiding memcmp() of cryptographic data
+ Wording largely based on comments from Michael Haardt.
+
+pthread_tryjoin_np.3
+ Jérôme Pouiller [Michael Kerrisk]
+ Document EINVAL error for pthread_timedjoin_np()
+
+mem.4
+ Elie De Brauwer
+ /dev/kmem depends on CONFIG_DEVKMEM
+ Elie De Brauwer
+ Correct /dev/port group in example
+ mem.4 mentions that group for /dev/port should be set to 'mem'
+ However, all other files (/dev/mem and /dev/kmem) use the kmem
+ group in their examples and on my system /dev/port belongs to
+ kmem. Hence the 'mem' group was probably a typo:
+ Elie De Brauwer
+ Add CONFIG_STRICT_DEVMEM
+ Since 2.6.26 the CONFIG_NONPROMISC_DEVMEM options limits the
+ physical addresses which can be accessed through /dev/mem.
+
+random.4
+ Heinrich Schuchardt
+ Describe handling of O_NONBLOCK
+ /dev/random and /dev/urandom treat O_NONBLOCK differently.
+ This should be described in the manpage.
+ Heinrich Schuchardt
+ Mention PRNG used by urandom
+ /dev/urandom uses a pseudo-random number generator to replace
+ missing entropy.
+
+proc.5
+ Michael Kerrisk
+ Document "Seccomp" field of /proc/PID/status
+
+epoll.7
+ Michael Kerrisk [Ignat Loskutov]
+ Use epoll_create1() rather than epoll_create() in the code example
+ epoll_create1() is more or less the preferred API for new
+ applications, since it allows for some flags and avoids the
+ misdesigned epoll_create() argument, and so it seems sensible
+ to use that in the example, rather than epoll_create().
+
+tcp.7
+ Troy Davis
+ Clarify tcp_tw_recycle on Internet-facing hosts
+ Clarify that tcp_tw_recycle will break communication with many
+ general-purpose remote Internet hosts (namely, remote NAT devices)
+ even when the Linux device itself is not behind NAT.
+
+
+==================== Changes in man-pages-3.78 ====================
+
+Released: 2015-01-22, 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:
+
+Akihiro Motoki <amotoki@gmail.com>
+Alexey Ishchuk <aishchuk@linux.vnet.ibm.com>
+Carlos O'Donell <carlos@redhat.com>
+Christian Seiler <christian@iwakd.de>
+Daniel J Blueman <daniel@quora.org>
+David Drysdale <drysdale@google.com>
+David Herrmann <dh.herrmann@gmail.com>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Elliot Hughes <enh@google.com>
+Jessica McKellar <jessica.mckellar@gmail.com>
+Kees Cook <keescook@chromium.org>
+Michael Hayes <mike@aiinc.ca>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Rich Felker <dalias@aerifal.cx>
+Vince Weaver <vincent.weaver@maine.edu>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+execveat.2
+ David Drysdale, Michael Kerrisk [Rich Felker]
+ New page for execveat(2)
+
+memfd_create.2
+ Michael Kerrisk, David Herrmann
+ New page for memfd_create() system call
+ Including notes about file sealing
+
+s390_pci_mmio_write.2
+ Alexey Ishchuk
+ New page for s390 s390_pci_mmio_write() and s390_pci_mmio_read()
+ New manual page for the new PCI MMIO memory access system
+ calls, s390_pci_mmio_write() and s390_pci_mmio_read(),
+ added for the s390 platform.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fcntl.2
+ David Herrmann [Michael Kerrisk]
+ Document F_ADD_SEALS and F_GET_SEALS commands
+
+proc.5
+ Elie De Brauwer
+ Document /proc/sys/vm/compact_memory
+ Michael Kerrisk
+ Document /proc/sys/fs/nr_open
+
+
+New and changed links
+---------------------
+
+s390_pci_mmio_read.2
+ Michael Kerrisk
+ New link to new s390_pci_mmio_write(2) page
+
+
+Changes to individual pages
+---------------------------
+
+dup.2
+ Michael Kerrisk
+ Add reference to RLIMIT_NOFILE for EMFILE error
+ Michael Kerrisk
+ Add reference to RLIMIT_NOFILE for EBADF error on 'newfd'.
+
+execve.2
+fexecve.3
+ Michael Kerrisk
+ SEE ALSO: add execveat(2)
+
+fallocate.2
+mmap.2
+open.2
+truncate.2
+write.2
+ Michael Kerrisk
+ ERRORS: add EPERM for operation denied by file seal
+
+fcntl.2
+ Michael Kerrisk
+ ERRORS: add EBUSY case for F_SETPIPE_SZ
+ Michael Kerrisk
+ Add reference to RLIMIT_NOFILE for F_DUPFD EINVAL error on 'arg'.
+ Michael Kerrisk
+ ERRORS: add open file description lock error cases
+
+getrlimit.2
+ Michael Kerrisk
+ Update text on RLIMIT_NOFILE ceiling to refer to /proc/sys/fs/file-max
+
+mbind.2
+ Michael Kerrisk [Daniel J Blueman]
+ Clarify EFAULT text
+
+mmap.2
+shmget.2
+shm_open.3
+ Michael Kerrisk
+ SEE ALSO: add memfd_create(2)
+
+open.2
+ Michael Kerrisk
+ Refer to RLIMIT_NOFILE for explanation of EMFILE error
+ Michael Kerrisk
+ Add execveat(2) in system call list under "Rationale for openat()"
+
+perf_event_open.2
+ Vince Weaver
+ Clarify description of overflow events
+ Update the perf_event_open manpage to be more consistent when
+ discussing overflow events. It merges the discussion of
+ poll-type notifications with those generated by SIGIO
+ signal handlers.
+ This addresses the remaining FIXMEs is the document.
+ Vince Weaver
+ Remove inaccurate paragraph describing attr.config
+ Remove an inaccurate paragraph about values in the attr.config
+ field. This information was never true in any released kernel;
+ it somehow snuck into the manpage because it is still described
+ this way in tools/perf/design.txt in the kernel source tree.
+ Michael Kerrisk
+ Correct the kernel version number for PERF_COUNT_HW_CACHE_NODE
+ Michael Kerrisk
+ Add some kernel version numbers to various fields and constants
+
+ptrace.2
+sigaction.2
+seccomp.2
+ Kees Cook
+ Ptrace and siginfo details
+ While writing some additional seccomp tests, I realized
+ PTRACE_EVENT_SECCOMP wasn't documented yet. Fixed this, and added
+ additional notes related to ptrace events SIGTRAP details.
+
+readv.2
+ Michael Kerrisk
+ Update details on glibc readv()/writev() wrapper behavior
+ And add a historical detail about Linux 2.0.
+
+select.2
+ Michael Kerrisk
+ Mention RLIMIT_NOFILE as a possible cause of EINVAL error
+
+syscall.2
+ Kees Cook
+ Add arm64 and mips
+ Add mips and arm64 to tables, along with some further
+ details on these architectures,
+
+syscalls.2
+ Michael Kerrisk
+ Add s390_pci_mmio_read(2) and s390_pci_mmio_write(2)
+ Michael Kerrisk
+ Note kernel() version that introduced get_kernel_syms()
+ Note kernel version that introduced ppc_rtas()
+ Note kernel version that introduced create_module()
+ Note kernel version that added setup()
+ Michael Kerrisk
+ Remove some details for sync_file_range2()
+ Make the table a bit simpler. The details can anyway be
+ found in the system call man page.
+
+utimensat.2
+ Michael Kerrisk [Elliot Hughes]
+ If both tv_sec fields are UTIME_OMIT, the file need not exist
+ As noted by Elliot, if both tv_sec fields are UTIME_OMIT,
+ utimensat() will return success even if the file does not exist.
+
+errno.3
+ Michael Kerrisk
+ The RLIMIT_NOFILE resource limit is a common cause of EMFILE
+
+exec.3
+ Michael Kerrisk
+ SEE ALSO: add execveat(2)
+
+fclose.3
+ Carlos O'Donell
+ Consistency fix: use "stream" as name for "FILE *" argument
+ Harmonize all the manual pages to use "stream" for FILE*
+ instead of randomly using "fp" or "stream." Choosing something
+ and being consistent helps users scan the man pages quickly
+ and understand what they are looking at.
+
+fexecve.3
+ Michael Kerrisk
+ Rewrite the script+close-on-exec problem as a BUG
+ Also, add one or two details about this scenario.
+ Michael Kerrisk
+ The natural idiom when using fexecve() is to use the close-on-exec flag
+
+fmemopen.3
+ Michael Kerrisk
+ Consistency fix: use "stream" as name for "FILE *" argument
+
+fopencookie.3
+ Michael Kerrisk
+ Consistency fix: use "stream" as name for "FILE *" argument
+
+getgrent_r.3
+ Carlos O'Donell
+ Consistency fix: use "stream" as name for "FILE *" argument
+
+getline.3
+ Michael Kerrisk
+ Consistency fix: use "stream" as name for "FILE *" argument
+
+getmntent.3
+ Carlos O'Donell
+ Consistency fix: use "stream" as name for "FILE *" argument
+
+getpw.3
+ Michael Kerrisk [Carlos O'Donell]
+ Describe return value when 'uid' is not found
+
+getpwent_r.3
+ Carlos O'Donell
+ Consistency fix: use "stream" as name for "FILE *" argument
+
+getspnam.3
+ Carlos O'Donell
+ Consistency fix: use "stream" as name for "FILE *" argument
+
+malloc_info.3
+ Carlos O'Donell
+ Consistency fix: use "stream" as name for "FILE *" argument
+
+posix_fallocate.3
+ Michael Kerrisk
+ Note that posix_fallocate() is implemented using fallocate(2)
+
+putgrent.3
+ Carlos O'Donell
+ Consistency fix: use "stream" as name for "FILE *" argument
+ Harmonize all the manual pages to use "stream" for FILE*
+ instead of randomly using "fp" or "stream." Choosing something
+ and being consistent helps users scan the man pages quickly
+ and understand what they are looking at.
+
+locale.5
+ Akihiro Motoki
+ Correct variable name
+
+proc.5
+ Michael Kerrisk
+ Remove bogus statement about NR_OPEN being a ceiling for file-max