-==================== Changes in man-pages-4.00 ====================
+==================== Changes in man-pages-4.01 ====================
-Released: 2015-05-07, Munich
+Released: ????-??-??, Munich
Contributors
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Advait Dixi <advaitdixit@hotmail.com>
-Alain Kalker <a.c.kalker@gmail.com>
-Andi Kleen <andi@firstfloor.org>
-Andreas Gruenbacher <agruenba@redhat.com>
-Andreas Heiduk <asheiduk@googlemail.com>
-Askar Safin <safinaskar@mail.ru>
-Brice Goglin <Brice.Goglin@inria.fr>
-Cameron Norman <camerontnorman@gmail.com>
-Carlos O'Donell <carlos@redhat.com>
-Chris Metcalf <cmetcalf@tilera.com>
-Christophe Lohr <Christophe.Lohr@telecom-bretagne.eu>
-Christopher Head <chead@chead.ca>
-Christoph Hellwig <hch@infradead.org>
-David Wilcox <davidvsthegiant@gmail.com>
-Denis Du <denisdu@ruggedcom.com>
-Egmont Koblinger <egmont@gmail.com>
-Filipe Brandenburger <filbranden@gmail.com>
-Filipus Klutiero <chealer@gmail.com>
-Florian Weimer <fweimer@redhat.com>
-Frédéric Maria <frederic.maria@free.fr>
-Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
-Graham Shaw <gdshaw@riscpkg.org>
-Gregor Jasny <igjasny@googlemail.com>
-Guillem Jover <guillem@hadrons.org>
-Guy Harris <guy@alum.mit.edu>
-Heinrich Schuchardt <xypron.glpk@gmx.de>
-Ian Pilcher <arequipeno@gmail.com>
-Jann Horn <jann@thejh.net>
-Jason Newton <nevion@gmail.com>
-J. Bruce Fields <bfields@fieldses.org>
-Jiri Pirko <jpirko@redhat.com>
-Joachim Wuttke <j.wuttke@fz-juelich.de>
-Joern Heissler <contact@joern.heissler.de>
-Jonathan Nieder <jrnieder@gmail.com>
-Joonas Salo <salo.joonas@gmail.com>
-Jussi Lehtola <jussilehtola@fedoraproject.org>
-Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
-KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
-Laurence Gonsalves <laurence@xenomachina.com>
-Magnus REFTEL <magnus.xm.reftel@stericsson.com>
-Michael Kerrisk <mtk.manpages@gmail.com>
-NeilBrown <neilb@suse.de>
-Regid Ichira <regid23@nt1.in>
-Sam Varshavchik <mrsam@courier-mta.com>
-Steinar H. Gunderson <sgunderson@bigfoot.com>
-Stéphane Aulery <saulery@free.fr>
-Stephane Fillod <fillods@users.sf.net>
-Tetsuo Handa <from-linux-kernel@i-love.sakura.ne.jp>
-Thomas Hood <jdthood@gmail.com>
-Urs Thuermann <urs@isnogud.escape.de>
-Vasiliy Kulikov <segooon@gmail.com>
-Vegard Nossum <vegard.nossum@gmail.com>
-Weijie Yang <weijie.yang@samsung.com>
-William Woodruff <william@tuffbizz.com>
-Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
-get_phys_pages.3
- William Woodruff
- Document get_phys_pages() and get_avphys_pages()
-
-loop.4
- Urs Thuermann, Michael Kerrisk
- New page documenting the loop device
-
-xattr.7
- Andreas Gruenbacher
- Import attr(5) man page from the 'attr' project
- After discussions with Andreas Gruenbacher, it makes sense to
- move this page into man-pages, since it mostly relates to
- kernel details. Since this is an overview page,
- we'll move it to Section 7.
- Michael Kerrisk
- Rename page
- "xattr" is a more meaningful name than "attr" (it resonates
- with the names of the system calls), so as long as we are
- moving the page to a new section, we'll change the name as well,
- and retain an acl(5) link so that old references remain valid.
-
Newly documented interfaces in existing pages
---------------------------------------------
-mmap.2
- Michael Kerrisk [Andi Kleen]
- Document MAP_HUGE_2MB, MAP_HUGE_1GB, and MAP_HUGE_SHIFT
-
-shmget.2
- Michael Kerrisk [Andi Kleen]
- Document SHM_HUGE_2MB, SHM_HUGE_1GB, and SHM_HUGE_SHIFT
-
-resolver.3
- Michael Kerrisk [Jonathan Nieder]
- Add descriptions of some other resolver functions
- Add res_ninit(), res_nquery(), res_nsearch(),
- and res_nquerydomain(), res_nmkquery(), res_nsend().
-
-tty_ioctl.4
- Frédéric Maria [Stephane Fillod, Andreas Heiduk]
- Document TIOCMIWAIT and TIOCGICOUNT
- Michael Kerrisk
- Document TIOCGEXCL
- Michael Kerrisk
- Document TIOGCPKT
- Michael Kerrisk
- Document TIOCSPTLCK
- Michael Kerrisk
- Document TIOCGPTLCK
-
New and changed links
---------------------
-CMSG_DATA.3
- Michael Kerrisk
- New link to cmsg(3)
-
-CMSG_LEN.3
- Michael Kerrisk
- New link to cmsg(3)
-
-dprintf.3
- Michael Kerrisk
- Convert to a link to printf.3
-
-get_avphys_pages.3
- William Woodruff
- New link to new get_phys_pages.3 page
-
-res_ninit.3
-res_nmkquery.3
-res_nquery.3
-res_nquerydomain.3
-res_nsearch.3
-res_nsend.3
- Michael Kerrisk
- New links to resolver(3) man page
-
-loop-control.4
- Michael Kerrisk
- New link to loop.4
-
-attr.5
- Michael Kerrisk
- New link to xattr(7)
-
Global changes
--------------
-chown.2
-execve.2
-prctl.2
-truncate.2
-proc.5
-capabilities.7
-ld.so.8
- Michael Kerrisk
- Tighter wording: 'mode bit' rather than 'permission bit'
- For sticky, set-UID, and set-GID mode bits (as used in POSIX).
-
Changes to individual pages
---------------------------
-add_key.2
-keyctl.2
-request_key.2
- Michael Kerrisk
- SEE ALSO: add keyrings(7)
-
-add_key.2
-request_key.2
- Michael Kerrisk
- SEE ALSO: add keyctl(3)
-
-epoll_ctl.2
- Michael Kerrisk
- After EPOLLHUP, EOF will be seen only after all data has been consumed
-
-epoll_wait.2
- Michael Kerrisk
- Clarify that signal mask treatment in epoll_pwait() is per-thread
- s/sigprocmask()/pthread_sigmask()/
-
-fcntl.2
- Michael Kerrisk [Vegard Nossum]
- Note an F_SETSIG corner case
-
-get_mempolicy.2, set_mempolicy
- Brice Goglin
- Policy is per thread, not per process
-
-getxattr.2
-listxattr.2
-removexattr.2
-setxattr.2
-capabilities.7
- Michael Kerrisk
- Adjust "attr(5)" references to "xattr(7)"
-
-ioctl.2
- Michael Kerrisk
- SEE ALSO: add console_ioctl(2) and tty_ioctl(2)
-
-listxattr.2
-xattr.7
- Michael Kerrisk
- Describe listxattr(2) E2BIG error and document it as a BUG
-
-mkdir.2
- Michael Kerrisk
- Wording fixes + point reader at stat(2) for explanation of file mode
- Michael Kerrisk [Andreas Grünbacher]
- Further tweaks to text on S_ISVTX and 'mode' argument
-
-mknod.2
- Michael Kerrisk
- Rewordings + point reader at stat(2) for details of mode bits
-
-mmap.2
- Michael Kerrisk
- Remove text that implies that munmap() syncs MAP_SHARED mapping to file
- The existing text in this page:
-
- MAP_SHARED Share this mapping. Updates to the mapping
- are visible to other processes that map this
- file, and are carried through to the underly‐
- ing file. The file may not actually be
- updated until msync(2) or munmap() is called.
-
- implies that munmap() will sync the mapping to the underlying
- file. POSIX doesn't require this, and some light reading of the
- code and some light testing (fsync() after munmap() of a large
- file) also indicates that Linux doesn't do this.
-
-msync.2
- Michael Kerrisk
- Rework text of DESCRIPTION
- Rewrite the text somewhat, for easier comprehension.
- No (intentional) changes to factual content
-
-nfsservctl.2
- Michael Kerrisk [J. Bruce Fields]
- Note that nfsservctl() was replaced by files in nfsd filesystem
-
-open.2
- Michael Kerrisk [Andreas Gruenbacher]
- open() honors the S_ISVTX, S_ISUID, and S_ISGID bits in 'mode'
- Michael Kerrisk
- Tighten wording: use 'mode bit' rather than 'permission bit'
- Michael Kerrisk [NeilBrown]
- BUGS: O_CREAT | O_DIRECTORY succeeds if pathname does not exist
-
-poll.2
- Michael Kerrisk [Ian Pilcher]
- Clarify that signal mask treatment in ppoll() is per-thread
- s/sigprocmask()/pthread_sigmask()/
- Michael Kerrisk [Sam Varshavchik]
- After POLLHUP, EOF will be seen only after all data has been consumed
- Michael Kerrisk
- Make it clearer which bits are ignored in 'events'
-
-prctl.2
- Michael Kerrisk [David Wilcox, Filipe Brandenburger]
- Note that "parent" for purposes of PR_SET_DEATHSIG is a *thread*
- See https://bugzilla.kernel.org/show_bug.cgi?id=43300
-
-sendfile.2
- Michael Kerrisk [Jason Newton]
- Note that sendfile does not support O_APPEND for 'out_fd'
- See https://bugzilla.kernel.org/show_bug.cgi?id=82841
- Michael Kerrisk [Gregor Jasny]
- RETURN VALUE: note the possibility of "short sends"
- See https://bugzilla.kernel.org/show_bug.cgi?id=97491
- Michael Kerrisk [Askar Safin]
- Clarify text on 'out_fd' and regular files in Linux 2.4
- See https://bugzilla.kernel.org/show_bug.cgi?id=86001
-
-shutdown.2
- Michael Kerrisk [Stéphane Aulery]
- BUGS: UNIX domain sockets now detect invalid 'how' values
- Bug fixed in Linux 3.7.
- See https://bugzilla.kernel.org/show_bug.cgi?id=47111
-
-sigaction.2
- Michael Kerrisk
- Refer the reader to fcntl(2) F_SETSIG for further details on si_fd
-
-stat.2
- Jann Horn
- Add note about stat() being racy
- Andreas Gruenbacher
- Improve description of some mode constants
- Michael Kerrisk [Andreas Grünbacher]
- Remove excessive leading zeros on some constants
- Michael Kerrisk
- Add text on POSIX terms "file mode bits" and "file permission bits"
- Recent changes to various pages employ this distinction.
- Michael Kerrisk
- Tighten wording: use 'mode bit' rather than 'permission bit'
- According to POSIX, the the 9 UGO*RWX bits are permissions, and
- 'mode' is used to refer to collectively to those bits plus sticky,
- set-UID, and set_GID bits.
-
-syslog.2
- Michael Kerrisk
- SEE ALSO: add dmesg(1)
-
-umask.2
-open.2
-mknod.2
-mkdir.2
- Andreas Gruenbacher
- Explain what default ACLs do
- Explain the effect that default ACLs have (instead of the umask)
- in umask.2. Mention that default ACLs can have an affect in
- open.2, mknod.2, and mkdir.2.
-
-unshare.2
- Michael Kerrisk [Florian Weimer]
- Give the reader a hint that unshare() works on processes or threads
- See https://bugzilla.kernel.org/show_bug.cgi?id=59281
-
-atexit.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-bsearch.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-cmsg.3
- Michael Kerrisk [Christopher Head]
- Fix error in SCM_RIGHTS code sample
- Remove erroneous second initialization of msg.msg_controllen
- in the example code for SCM_RIGHTS.
- See https://bugzilla.kernel.org/show_bug.cgi?id=15952
-
-CPU_SET.3
- Chris Metcalf
- Clarify language about "available" cpus
- The CPU_SET.3 man page uses the adjective "available" when
- explaining what the argument to CPU_SET() means. This is
- confusing, since "available" isn't well-defined. The kernel
- has a set of adjectives (possible, present, online, and active)
- that qualify cpus, but normally none of these are what the
- cpu_set_t bit index means: it's just "which cpu", using the
- kernel's internal numbering system, even if that cpu isn't
- possible or present.
-
- This change removes the word "available" and adds a sentence
- warning that cpu sets may not be contiguous due to dynamic
- cpu hotplug, etc.
-
-err.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-ftw.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-gethostbyname.3
- Carlos O'Donell
- NSS plugins searched first
- Carlos O'Donell
- "order" is obsolete
-
-gethostid.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are/aren't thread-safe
-
-getmntent.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are/aren't thread-safe
-
-get_nprocs_conf.3
- Michael Kerrisk
- Use exit() rather than return in main()
-
-getopt.3
- Michael Kerrisk [Guy Harris]
- Remove crufty BUGS section
- See https://bugzilla.kernel.org/show_bug.cgi?id=90261
-
-iconv_close.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-inet_ntop.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-longjmp.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-lsearch.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-mcheck.3
- Zeng Linggang
- ATTRIBUTES: Note functions that aren't thread-safe
-
-on_exit.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-printf.3
- Michael Kerrisk [Egmont Koblinger]
- Merge dprintf() and vdprintf() discussion into this page
- Michael Kerrisk
- SEE ALSO: add puts(3)
- Michael Kerrisk
- Move return value discussion to proper RETURN VALUE section
-
-putpwent.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-qsort.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-regex.3
- Michael Kerrisk [Laurence Gonsalves]
- Fix error in description of 'cflags'
- 'cflags' is a bit mask of *zero* (not one) or more flags.
-
-resolver.3
- Stéphane Aulery
- Add info about RES_INSECURE1 and RES_INSECURE2 option in debug mode
-
-scanf.3
- Joern Heissler
- Improve description of %n specifier
-
-setjmp.3
- Zeng Linggang
- ATTRIBUTES: Note functions that are thread-safe
-
-setlocale.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-setlogmask.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-sleep.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-strsignal.3
- Zeng Linggang
- ATTRIBUTES: Note function that isn't thread-safe
-
-sysconf.3
- Zeng Linggang
- ATTRIBUTES: Note function that is thread-safe
-
-undocumented.3
- William Woodruff
- Remove documented functions
-
-tty_ioctl.4
- Michael Kerrisk [Denis Du]
- Fix error in code example
-
-proc.5
- Michael Kerrisk [Cameron Norman, Vasiliy Kulikov]
- Document /proc mount options
- Document the 'hidepid' and 'gid' mount options that were added in
- Linux 3.3. See https://bugzilla.kernel.org/show_bug.cgi?id=90641
- Based on text by Vasiliy Kulikov in
- Documentation/filesystems/proc.txt.
- Michael Kerrisk [Kirill A. Shutemov]
- Improve description of /proc/PID/status
- Guillem Jover
- Document /proc/PID/exe behaviour on unlinked pathnames
- Michael Kerrisk [Weijie Yang]
- Document /proc/PID/status VmPMD
-
-resolv.conf.5
- Stéphane Aulery [Thomas Hood]
- Document use-vc option added to glibc 2.14
- Fix Ubuntu bug #1110781:
- https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781
- Stéphane Aulery [Thomas Hood]
- Document RES_SNGLKUPREOP
- Fix Ubuntu bug #1110781:
- https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781
-
-tzfile.5
- Sam Varshavchik
- Add various details on version 2 format
-
-aio.7
- Michael Kerrisk
- Add details and update URL for OLS 2003 paper on AIO
-
-xattr.7
- Michael Kerrisk
- Document EA limits for Btrfs
- Document VFS-imposed limits on EAs
- VFS imposes a 255-byte limit on EA names, and a 64kB limit on
- EA values.
- Michael Kerrisk
- The ext[234] block limitation applies to sum of all EAs
- It is not a per-EA limit.
- Michael Kerrisk
- Clarify permissions required to work with 'user' EAs
- Michael Kerrisk
- ext2 and ext3 no longer need mounting with 'user_xattr' for user EAs
- Michael Kerrisk
- Add various relevant pages to SEE ALSO
- Michael Kerrisk
- Add CONFORMING TO section
- Michael Kerrisk
- Modify headings to man-pages norms
- Michael Kerrisk
- Btrfs also supports extended attributes
- Michael Kerrisk
- File capabilities are implemented using *security* attributes
- Not *system* attributes
- Michael Kerrisk
- Describe limit on EA values for JFS, XFS, and Reiserfs
-
-bootparam.7
- Michael Kerrisk [Alain Kalker]
- Update discussion of 'debug' option
- See https://bugzilla.kernel.org/show_bug.cgi?id=97161
- Michael Kerrisk
- Summary of multiple changes: remove cruft from this page.
- Much of the detail on hardware specifics in this page dates
- from the 20th century. (The last major update to this page was in
- man-pages-1.14!) It's hugely out of date now (many of these
- devices disappeared from the kernel years ago.) So, I've taken
- a large scythe to the page to remove anything that looks
- seriously dated. In the process, the page has shrunk to less
- than 50% of its previous size.
- Michael Kerrisk
- Remove "buff=" details
- This seems to have gone away in Linux 2.2.
- Michael Kerrisk
- Remove crufty "Mouse drivers" options
- Michael Kerrisk
- Remove crufty "General non-device-specific boot arguments" options
- Michael Kerrisk
- Remove crufty "Hard disks" options
- Michael Kerrisk
- Remove crufty "mem=" details
- Michael Kerrisk
- Remove crufty details on IBM MCA bus devices
- Michael Kerrisk
- Remove 'swap=" details
- This seems to have gone away in Linux 2.2,
- Michael Kerrisk
- Remove crufty floppy disk driver options
- In the specific case of floppy drives: the drivers still
- exist, but it's been a while since most of saw these devices
- in the wild. So, just refer the reader to the kernel source
- file for details. (The detail in this man page was after all
- originally drawn from that file.)
- Remove crufty "ISDN drivers" options
- Michael Kerrisk
- Remove crufty "line printer driver" options
- Michael Kerrisk
- Remove crufty "Serial port drivers" options
- Michael Kerrisk
- Remove crufty reference to CONFIG_BUGi386
- That option disappeared in Linux 2.4.
- Michael Kerrisk
- Remove crufty text
- "bootsetups array" dates from Linux 2.0.
- Michael Kerrisk
- Remove crufty "Video hardware" options
- Michael Kerrisk
- Remove crufty SCSI device driver options
-
-fanotify.7
- Michael Kerrisk [Heinrich Schuchardt]
- Since Linux 3.19, fallocate(2) generates FAN_MODIFY events
-
-inotify.7
- Michael Kerrisk [Heinrich Schuchardt]
- Since Linux 3.19, fallocate(2) generates IN_MODIFY events
-
-ip.7
- Michael Kerrisk
- Explain how IP_ADD_MEMBERSHIP determines its argument type
- Michael Kerrisk [Jiri Pirko, Magnus REFTEL]
- Clarify details of the IP_MULTICAST_IF socket option
- Michael Kerrisk [Advait Dixi]
- Remove dubious text that says that SO_PRIORITY set IP TOS
- See https://bugzilla.kernel.org/show_bug.cgi?id=35852
- Michael Kerrisk
- Relocate misplaced text describing ENOPROTOOPT error
-
-packet.7
- Graham Shaw
- Add sll_protocol to list of required fields for outbound packets
-
-pthreads.7
- Michael Kerrisk [KOSAKI Motohiro]
- Using thread IDs whose lifetime has expired gives undefined behavior
- See https://bugzilla.kernel.org/show_bug.cgi?id=53061
-
-raw.7
- Michael Kerrisk [Tetsuo Handa]
- For incoming datagrams, sin_port is set to zero
- Michael Kerrisk
- Mention sendto(), recvfrom(), and so on when discussing address format
- This gives the reader a little context for the following
- discussion of 'sin_port'.
- Michael Kerrisk
- Remove crufty reference to <netinet/in.h>
- Michael Kerrisk
- Replace reference to RFC 1700 with pointer to IANA protocol number list
-
-signal.7
- Michael Kerrisk [Steinar H. Gunderson]
- Clarify that I/O operations on disks are not interrupted by signals
- See https://bugzilla.kernel.org/show_bug.cgi?id=97721
-
-unix.7
- Michael Kerrisk [Christophe Lohr]
- Remove mention of UNIX_PATH_MAX
- This kernel constant is not exposed to user space.
- Michael Kerrisk
- Note the 108 bytes for sun_path is how things are done on Linux
- And refer the reader to NOTES for discussion of portability.
-
-
-xattr.7
- Michael Kerrisk
- Explicitly mention some of the xattr system calls in DESCRIPTION
- Naming the system calls helps to orient the reader
-
-nscd.8
- Michael Kerrisk
- Add mention of 'services' and 'netgroup' databases
- This makes the page consistent with nscd.conf(5).
nptl.7
Michael Kerrisk
Add reference to timer_create(2)
+
+
+==================== Changes in man-pages-4.00 ====================
+
+Released: 2015-05-07, 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:
+
+Advait Dixi <advaitdixit@hotmail.com>
+Alain Kalker <a.c.kalker@gmail.com>
+Andi Kleen <andi@firstfloor.org>
+Andreas Gruenbacher <agruenba@redhat.com>
+Andreas Heiduk <asheiduk@googlemail.com>
+Askar Safin <safinaskar@mail.ru>
+Brice Goglin <Brice.Goglin@inria.fr>
+Cameron Norman <camerontnorman@gmail.com>
+Carlos O'Donell <carlos@redhat.com>
+Chris Metcalf <cmetcalf@tilera.com>
+Christophe Lohr <Christophe.Lohr@telecom-bretagne.eu>
+Christopher Head <chead@chead.ca>
+Christoph Hellwig <hch@infradead.org>
+David Wilcox <davidvsthegiant@gmail.com>
+Denis Du <denisdu@ruggedcom.com>
+Egmont Koblinger <egmont@gmail.com>
+Filipe Brandenburger <filbranden@gmail.com>
+Filipus Klutiero <chealer@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+Frédéric Maria <frederic.maria@free.fr>
+Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
+Graham Shaw <gdshaw@riscpkg.org>
+Gregor Jasny <igjasny@googlemail.com>
+Guillem Jover <guillem@hadrons.org>
+Guy Harris <guy@alum.mit.edu>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Ian Pilcher <arequipeno@gmail.com>
+Jann Horn <jann@thejh.net>
+Jason Newton <nevion@gmail.com>
+J. Bruce Fields <bfields@fieldses.org>
+Jiri Pirko <jpirko@redhat.com>
+Joachim Wuttke <j.wuttke@fz-juelich.de>
+Joern Heissler <contact@joern.heissler.de>
+Jonathan Nieder <jrnieder@gmail.com>
+Joonas Salo <salo.joonas@gmail.com>
+Jussi Lehtola <jussilehtola@fedoraproject.org>
+Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
+KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Laurence Gonsalves <laurence@xenomachina.com>
+Magnus REFTEL <magnus.xm.reftel@stericsson.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+NeilBrown <neilb@suse.de>
+Regid Ichira <regid23@nt1.in>
+Sam Varshavchik <mrsam@courier-mta.com>
+Steinar H. Gunderson <sgunderson@bigfoot.com>
+Stéphane Aulery <saulery@free.fr>
+Stephane Fillod <fillods@users.sf.net>
+Tetsuo Handa <from-linux-kernel@i-love.sakura.ne.jp>
+Thomas Hood <jdthood@gmail.com>
+Urs Thuermann <urs@isnogud.escape.de>
+Vasiliy Kulikov <segooon@gmail.com>
+Vegard Nossum <vegard.nossum@gmail.com>
+Weijie Yang <weijie.yang@samsung.com>
+William Woodruff <william@tuffbizz.com>
+Zeng Linggang <zenglg.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+get_phys_pages.3
+ William Woodruff
+ Document get_phys_pages() and get_avphys_pages()
+
+loop.4
+ Urs Thuermann, Michael Kerrisk
+ New page documenting the loop device
+
+xattr.7
+ Andreas Gruenbacher
+ Import attr(5) man page from the 'attr' project
+ After discussions with Andreas Gruenbacher, it makes sense to
+ move this page into man-pages, since it mostly relates to
+ kernel details. Since this is an overview page,
+ we'll move it to Section 7.
+ Michael Kerrisk
+ Rename page
+ "xattr" is a more meaningful name than "attr" (it resonates
+ with the names of the system calls), so as long as we are
+ moving the page to a new section, we'll change the name as well,
+ and retain an acl(5) link so that old references remain valid.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+mmap.2
+ Michael Kerrisk [Andi Kleen]
+ Document MAP_HUGE_2MB, MAP_HUGE_1GB, and MAP_HUGE_SHIFT
+
+shmget.2
+ Michael Kerrisk [Andi Kleen]
+ Document SHM_HUGE_2MB, SHM_HUGE_1GB, and SHM_HUGE_SHIFT
+
+resolver.3
+ Michael Kerrisk [Jonathan Nieder]
+ Add descriptions of some other resolver functions
+ Add res_ninit(), res_nquery(), res_nsearch(),
+ and res_nquerydomain(), res_nmkquery(), res_nsend().
+
+tty_ioctl.4
+ Frédéric Maria [Stephane Fillod, Andreas Heiduk]
+ Document TIOCMIWAIT and TIOCGICOUNT
+ Michael Kerrisk
+ Document TIOCGEXCL
+ Michael Kerrisk
+ Document TIOGCPKT
+ Michael Kerrisk
+ Document TIOCSPTLCK
+ Michael Kerrisk
+ Document TIOCGPTLCK
+
+
+New and changed links
+---------------------
+
+CMSG_DATA.3
+ Michael Kerrisk
+ New link to cmsg(3)
+
+CMSG_LEN.3
+ Michael Kerrisk
+ New link to cmsg(3)
+
+dprintf.3
+ Michael Kerrisk
+ Convert to a link to printf.3
+
+get_avphys_pages.3
+ William Woodruff
+ New link to new get_phys_pages.3 page
+
+res_ninit.3
+res_nmkquery.3
+res_nquery.3
+res_nquerydomain.3
+res_nsearch.3
+res_nsend.3
+ Michael Kerrisk
+ New links to resolver(3) man page
+
+loop-control.4
+ Michael Kerrisk
+ New link to loop.4
+
+attr.5
+ Michael Kerrisk
+ New link to xattr(7)
+
+
+Global changes
+--------------
+
+chown.2
+execve.2
+prctl.2
+truncate.2
+proc.5
+capabilities.7
+ld.so.8
+ Michael Kerrisk
+ Tighter wording: 'mode bit' rather than 'permission bit'
+ For sticky, set-UID, and set-GID mode bits (as used in POSIX).
+
+
+Changes to individual pages
+---------------------------
+
+add_key.2
+keyctl.2
+request_key.2
+ Michael Kerrisk
+ SEE ALSO: add keyrings(7)
+
+add_key.2
+request_key.2
+ Michael Kerrisk
+ SEE ALSO: add keyctl(3)
+
+epoll_ctl.2
+ Michael Kerrisk
+ After EPOLLHUP, EOF will be seen only after all data has been consumed
+
+epoll_wait.2
+ Michael Kerrisk
+ Clarify that signal mask treatment in epoll_pwait() is per-thread
+ s/sigprocmask()/pthread_sigmask()/
+
+fcntl.2
+ Michael Kerrisk [Vegard Nossum]
+ Note an F_SETSIG corner case
+
+get_mempolicy.2, set_mempolicy
+ Brice Goglin
+ Policy is per thread, not per process
+
+getxattr.2
+listxattr.2
+removexattr.2
+setxattr.2
+capabilities.7
+ Michael Kerrisk
+ Adjust "attr(5)" references to "xattr(7)"
+
+ioctl.2
+ Michael Kerrisk
+ SEE ALSO: add console_ioctl(2) and tty_ioctl(2)
+
+listxattr.2
+xattr.7
+ Michael Kerrisk
+ Describe listxattr(2) E2BIG error and document it as a BUG
+
+mkdir.2
+ Michael Kerrisk
+ Wording fixes + point reader at stat(2) for explanation of file mode
+ Michael Kerrisk [Andreas Grünbacher]
+ Further tweaks to text on S_ISVTX and 'mode' argument
+
+mknod.2
+ Michael Kerrisk
+ Rewordings + point reader at stat(2) for details of mode bits
+
+mmap.2
+ Michael Kerrisk
+ Remove text that implies that munmap() syncs MAP_SHARED mapping to file
+ The existing text in this page:
+
+ MAP_SHARED Share this mapping. Updates to the mapping
+ are visible to other processes that map this
+ file, and are carried through to the underly‐
+ ing file. The file may not actually be
+ updated until msync(2) or munmap() is called.
+
+ implies that munmap() will sync the mapping to the underlying
+ file. POSIX doesn't require this, and some light reading of the
+ code and some light testing (fsync() after munmap() of a large
+ file) also indicates that Linux doesn't do this.
+
+msync.2
+ Michael Kerrisk
+ Rework text of DESCRIPTION
+ Rewrite the text somewhat, for easier comprehension.
+ No (intentional) changes to factual content
+
+nfsservctl.2
+ Michael Kerrisk [J. Bruce Fields]
+ Note that nfsservctl() was replaced by files in nfsd filesystem
+
+open.2
+ Michael Kerrisk [Andreas Gruenbacher]
+ open() honors the S_ISVTX, S_ISUID, and S_ISGID bits in 'mode'
+ Michael Kerrisk
+ Tighten wording: use 'mode bit' rather than 'permission bit'
+ Michael Kerrisk [NeilBrown]
+ BUGS: O_CREAT | O_DIRECTORY succeeds if pathname does not exist
+
+poll.2
+ Michael Kerrisk [Ian Pilcher]
+ Clarify that signal mask treatment in ppoll() is per-thread
+ s/sigprocmask()/pthread_sigmask()/
+ Michael Kerrisk [Sam Varshavchik]
+ After POLLHUP, EOF will be seen only after all data has been consumed
+ Michael Kerrisk
+ Make it clearer which bits are ignored in 'events'
+
+prctl.2
+ Michael Kerrisk [David Wilcox, Filipe Brandenburger]
+ Note that "parent" for purposes of PR_SET_DEATHSIG is a *thread*
+ See https://bugzilla.kernel.org/show_bug.cgi?id=43300
+
+sendfile.2
+ Michael Kerrisk [Jason Newton]
+ Note that sendfile does not support O_APPEND for 'out_fd'
+ See https://bugzilla.kernel.org/show_bug.cgi?id=82841
+ Michael Kerrisk [Gregor Jasny]
+ RETURN VALUE: note the possibility of "short sends"
+ See https://bugzilla.kernel.org/show_bug.cgi?id=97491
+ Michael Kerrisk [Askar Safin]
+ Clarify text on 'out_fd' and regular files in Linux 2.4
+ See https://bugzilla.kernel.org/show_bug.cgi?id=86001
+
+shutdown.2
+ Michael Kerrisk [Stéphane Aulery]
+ BUGS: UNIX domain sockets now detect invalid 'how' values
+ Bug fixed in Linux 3.7.
+ See https://bugzilla.kernel.org/show_bug.cgi?id=47111
+
+sigaction.2
+ Michael Kerrisk
+ Refer the reader to fcntl(2) F_SETSIG for further details on si_fd
+
+stat.2
+ Jann Horn
+ Add note about stat() being racy
+ Andreas Gruenbacher
+ Improve description of some mode constants
+ Michael Kerrisk [Andreas Grünbacher]
+ Remove excessive leading zeros on some constants
+ Michael Kerrisk
+ Add text on POSIX terms "file mode bits" and "file permission bits"
+ Recent changes to various pages employ this distinction.
+ Michael Kerrisk
+ Tighten wording: use 'mode bit' rather than 'permission bit'
+ According to POSIX, the the 9 UGO*RWX bits are permissions, and
+ 'mode' is used to refer to collectively to those bits plus sticky,
+ set-UID, and set_GID bits.
+
+syslog.2
+ Michael Kerrisk
+ SEE ALSO: add dmesg(1)
+
+umask.2
+open.2
+mknod.2
+mkdir.2
+ Andreas Gruenbacher
+ Explain what default ACLs do
+ Explain the effect that default ACLs have (instead of the umask)
+ in umask.2. Mention that default ACLs can have an affect in
+ open.2, mknod.2, and mkdir.2.
+
+unshare.2
+ Michael Kerrisk [Florian Weimer]
+ Give the reader a hint that unshare() works on processes or threads
+ See https://bugzilla.kernel.org/show_bug.cgi?id=59281
+
+atexit.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that is thread-safe
+
+bsearch.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that is thread-safe
+
+cmsg.3
+ Michael Kerrisk [Christopher Head]
+ Fix error in SCM_RIGHTS code sample
+ Remove erroneous second initialization of msg.msg_controllen
+ in the example code for SCM_RIGHTS.
+ See https://bugzilla.kernel.org/show_bug.cgi?id=15952
+
+CPU_SET.3
+ Chris Metcalf
+ Clarify language about "available" cpus
+ The CPU_SET.3 man page uses the adjective "available" when
+ explaining what the argument to CPU_SET() means. This is
+ confusing, since "available" isn't well-defined. The kernel
+ has a set of adjectives (possible, present, online, and active)
+ that qualify cpus, but normally none of these are what the
+ cpu_set_t bit index means: it's just "which cpu", using the
+ kernel's internal numbering system, even if that cpu isn't
+ possible or present.
+
+ This change removes the word "available" and adds a sentence
+ warning that cpu sets may not be contiguous due to dynamic
+ cpu hotplug, etc.
+
+err.3
+ Zeng Linggang
+ ATTRIBUTES: Note functions that are thread-safe
+
+ftw.3
+ Zeng Linggang
+ ATTRIBUTES: Note functions that are thread-safe
+
+gethostbyname.3
+ Carlos O'Donell
+ NSS plugins searched first
+ Carlos O'Donell
+ "order" is obsolete
+
+gethostid.3
+ Zeng Linggang
+ ATTRIBUTES: Note functions that are/aren't thread-safe
+
+getmntent.3
+ Zeng Linggang
+ ATTRIBUTES: Note functions that are/aren't thread-safe
+
+get_nprocs_conf.3
+ Michael Kerrisk
+ Use exit() rather than return in main()
+
+getopt.3
+ Michael Kerrisk [Guy Harris]
+ Remove crufty BUGS section
+ See https://bugzilla.kernel.org/show_bug.cgi?id=90261
+
+iconv_close.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that is thread-safe
+
+inet_ntop.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that is thread-safe
+
+longjmp.3
+ Zeng Linggang
+ ATTRIBUTES: Note functions that are thread-safe
+
+lsearch.3
+ Zeng Linggang
+ ATTRIBUTES: Note functions that are thread-safe
+
+mcheck.3
+ Zeng Linggang
+ ATTRIBUTES: Note functions that aren't thread-safe
+
+on_exit.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that is thread-safe
+
+printf.3
+ Michael Kerrisk [Egmont Koblinger]
+ Merge dprintf() and vdprintf() discussion into this page
+ Michael Kerrisk
+ SEE ALSO: add puts(3)
+ Michael Kerrisk
+ Move return value discussion to proper RETURN VALUE section
+
+putpwent.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that is thread-safe
+
+qsort.3
+ Zeng Linggang
+ ATTRIBUTES: Note functions that are thread-safe
+
+regex.3
+ Michael Kerrisk [Laurence Gonsalves]
+ Fix error in description of 'cflags'
+ 'cflags' is a bit mask of *zero* (not one) or more flags.
+
+resolver.3
+ Stéphane Aulery
+ Add info about RES_INSECURE1 and RES_INSECURE2 option in debug mode
+
+scanf.3
+ Joern Heissler
+ Improve description of %n specifier
+
+setjmp.3
+ Zeng Linggang
+ ATTRIBUTES: Note functions that are thread-safe
+
+setlocale.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that isn't thread-safe
+
+setlogmask.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that isn't thread-safe
+
+sleep.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that isn't thread-safe
+
+strsignal.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that isn't thread-safe
+
+sysconf.3
+ Zeng Linggang
+ ATTRIBUTES: Note function that is thread-safe
+
+undocumented.3
+ William Woodruff
+ Remove documented functions
+
+tty_ioctl.4
+ Michael Kerrisk [Denis Du]
+ Fix error in code example
+
+proc.5
+ Michael Kerrisk [Cameron Norman, Vasiliy Kulikov]
+ Document /proc mount options
+ Document the 'hidepid' and 'gid' mount options that were added in
+ Linux 3.3. See https://bugzilla.kernel.org/show_bug.cgi?id=90641
+ Based on text by Vasiliy Kulikov in
+ Documentation/filesystems/proc.txt.
+ Michael Kerrisk [Kirill A. Shutemov]
+ Improve description of /proc/PID/status
+ Guillem Jover
+ Document /proc/PID/exe behaviour on unlinked pathnames
+ Michael Kerrisk [Weijie Yang]
+ Document /proc/PID/status VmPMD
+
+resolv.conf.5
+ Stéphane Aulery [Thomas Hood]
+ Document use-vc option added to glibc 2.14
+ Fix Ubuntu bug #1110781:
+ https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781
+ Stéphane Aulery [Thomas Hood]
+ Document RES_SNGLKUPREOP
+ Fix Ubuntu bug #1110781:
+ https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781
+
+tzfile.5
+ Sam Varshavchik
+ Add various details on version 2 format
+
+aio.7
+ Michael Kerrisk
+ Add details and update URL for OLS 2003 paper on AIO
+
+xattr.7
+ Michael Kerrisk
+ Document EA limits for Btrfs
+ Document VFS-imposed limits on EAs
+ VFS imposes a 255-byte limit on EA names, and a 64kB limit on
+ EA values.
+ Michael Kerrisk
+ The ext[234] block limitation applies to sum of all EAs
+ It is not a per-EA limit.
+ Michael Kerrisk
+ Clarify permissions required to work with 'user' EAs
+ Michael Kerrisk
+ ext2 and ext3 no longer need mounting with 'user_xattr' for user EAs
+ Michael Kerrisk
+ Add various relevant pages to SEE ALSO
+ Michael Kerrisk
+ Add CONFORMING TO section
+ Michael Kerrisk
+ Modify headings to man-pages norms
+ Michael Kerrisk
+ Btrfs also supports extended attributes
+ Michael Kerrisk
+ File capabilities are implemented using *security* attributes
+ Not *system* attributes
+ Michael Kerrisk
+ Describe limit on EA values for JFS, XFS, and Reiserfs
+
+bootparam.7
+ Michael Kerrisk [Alain Kalker]
+ Update discussion of 'debug' option
+ See https://bugzilla.kernel.org/show_bug.cgi?id=97161
+ Michael Kerrisk
+ Summary of multiple changes: remove cruft from this page.
+ Much of the detail on hardware specifics in this page dates
+ from the 20th century. (The last major update to this page was in
+ man-pages-1.14!) It's hugely out of date now (many of these
+ devices disappeared from the kernel years ago.) So, I've taken
+ a large scythe to the page to remove anything that looks
+ seriously dated. In the process, the page has shrunk to less
+ than 50% of its previous size.
+ Michael Kerrisk
+ Remove "buff=" details
+ This seems to have gone away in Linux 2.2.
+ Michael Kerrisk
+ Remove crufty "Mouse drivers" options
+ Michael Kerrisk
+ Remove crufty "General non-device-specific boot arguments" options
+ Michael Kerrisk
+ Remove crufty "Hard disks" options
+ Michael Kerrisk
+ Remove crufty "mem=" details
+ Michael Kerrisk
+ Remove crufty details on IBM MCA bus devices
+ Michael Kerrisk
+ Remove 'swap=" details
+ This seems to have gone away in Linux 2.2,
+ Michael Kerrisk
+ Remove crufty floppy disk driver options
+ In the specific case of floppy drives: the drivers still
+ exist, but it's been a while since most of saw these devices
+ in the wild. So, just refer the reader to the kernel source
+ file for details. (The detail in this man page was after all
+ originally drawn from that file.)
+ Remove crufty "ISDN drivers" options
+ Michael Kerrisk
+ Remove crufty "line printer driver" options
+ Michael Kerrisk
+ Remove crufty "Serial port drivers" options
+ Michael Kerrisk
+ Remove crufty reference to CONFIG_BUGi386
+ That option disappeared in Linux 2.4.
+ Michael Kerrisk
+ Remove crufty text
+ "bootsetups array" dates from Linux 2.0.
+ Michael Kerrisk
+ Remove crufty "Video hardware" options
+ Michael Kerrisk
+ Remove crufty SCSI device driver options
+
+fanotify.7
+ Michael Kerrisk [Heinrich Schuchardt]
+ Since Linux 3.19, fallocate(2) generates FAN_MODIFY events
+
+inotify.7
+ Michael Kerrisk [Heinrich Schuchardt]
+ Since Linux 3.19, fallocate(2) generates IN_MODIFY events
+
+ip.7
+ Michael Kerrisk
+ Explain how IP_ADD_MEMBERSHIP determines its argument type
+ Michael Kerrisk [Jiri Pirko, Magnus REFTEL]
+ Clarify details of the IP_MULTICAST_IF socket option
+ Michael Kerrisk [Advait Dixi]
+ Remove dubious text that says that SO_PRIORITY set IP TOS
+ See https://bugzilla.kernel.org/show_bug.cgi?id=35852
+ Michael Kerrisk
+ Relocate misplaced text describing ENOPROTOOPT error
+
+packet.7
+ Graham Shaw
+ Add sll_protocol to list of required fields for outbound packets
+
+pthreads.7
+ Michael Kerrisk [KOSAKI Motohiro]
+ Using thread IDs whose lifetime has expired gives undefined behavior
+ See https://bugzilla.kernel.org/show_bug.cgi?id=53061
+
+raw.7
+ Michael Kerrisk [Tetsuo Handa]
+ For incoming datagrams, sin_port is set to zero
+ Michael Kerrisk
+ Mention sendto(), recvfrom(), and so on when discussing address format
+ This gives the reader a little context for the following
+ discussion of 'sin_port'.
+ Michael Kerrisk
+ Remove crufty reference to <netinet/in.h>
+ Michael Kerrisk
+ Replace reference to RFC 1700 with pointer to IANA protocol number list
+
+signal.7
+ Michael Kerrisk [Steinar H. Gunderson]
+ Clarify that I/O operations on disks are not interrupted by signals
+ See https://bugzilla.kernel.org/show_bug.cgi?id=97721
+
+unix.7
+ Michael Kerrisk [Christophe Lohr]
+ Remove mention of UNIX_PATH_MAX
+ This kernel constant is not exposed to user space.
+ Michael Kerrisk
+ Note the 108 bytes for sun_path is how things are done on Linux
+ And refer the reader to NOTES for discussion of portability.
+
+
+xattr.7
+ Michael Kerrisk
+ Explicitly mention some of the xattr system calls in DESCRIPTION
+ Naming the system calls helps to orient the reader
+
+nscd.8
+ Michael Kerrisk
+ Add mention of 'services' and 'netgroup' databases
+ This makes the page consistent with nscd.conf(5).