pthread_sigqueue.3
Michael Kerrisk
- New page documenting ptrhead_sigqueue()
+ New page documenting pthread_sigqueue()
pthread_sigqueue() is new in glibc 2.11 (requires a kernel with
rt_tgsigqueinfo(), added in Linux 2.6.31).
timerfd_create.2
Michael Kerrisk [Josh Triplett]
- Note behavior when timerdfd_settime() old_value is NULL
+ Note behavior when timerfd_settime() old_value is NULL
See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513
Tomislav Jonjic
Fix small error in description of timerfd_settime()
Angelo Borsotti <angelo.borsotti@gmail.com>
Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
-Casper.Dik@oracle.com
+Casper Dik <Casper.Dik@oracle.com>
David Prévot <taffit@debian.org>
D. Barbier <bouzim@gmail.com>
Eric Blake <eblake@redhat.com>
lseek.2
Michael Kerrisk [Andreas Jaeger]
- _GNU_SOURCE must be defined to get SEEK_DATE and SEEK_HOLE definitions
+ _GNU_SOURCE must be defined to get SEEK_DATA and SEEK_HOLE definitions
See http://sourceware.org/bugzilla/show_bug.cgi?id=15312
mmap.2
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.
+ 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
name_to_handle_at.2
Michael Kerrisk
- New link to new open_by_name_at(2) page
+ New link to new open_by_handle_at(2) page
Global changes
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