-==================== Changes in man-pages-3.64 ====================
+==================== Changes in man-pages-3.65 ====================
-Released: 2014-04-06, Munich
+Released: 2014-04-20, Munich
Contributors
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Abhay Sachan <sachan.abhay@gmail.com>
-Alexey Samsonov <samsonov@google.com>
-Andrey Vagin <avagin@openvz.org>
-Aneesh Kumar K.V <aneesh.kumar@linux.vnet.ibm.com>
+Alex Thorlton <athorlton@sgi.com>
+Ashish Sangwan <a.sangwan@samsung.com>
+Christopher Covington <cov@codeaurora.org>
Christoph Hellwig <hch@infradead.org>
+Craig McQueen <craig.mcqueen@beamcommunications.com>
+Dave Chinner <david@fromorbit.com>
David Prévot <taffit@debian.org>
-Eric Dumazet <edumazet@google.com>
-Eric W. Biederman <ebiederm@xmission.com>
-Jan Kara <jack@suse.cz>
-Kir Kolyshkin <kir@openvz.org>
+Greg Troxel <gdt@ir.bbn.com>
+Matthew Dempsky <mdempsky@chromium.org>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
-NeilBrown <neilb@suse.de>
+Namjae Jeon <namjae.jeon@samsung.com>
Peng Haitao <penght@cn.fujitsu.com>
-Peter Hurley <peter@hurleysoftware.com>
Petr Gajdos <pgajdos@suse.cz>
-Robert P. J. Day <rpjday@crashcourse.ca>
+Richard Hansen <rhansen@bbn.com>
+Simon Paillard <spaillard@debian.org>
+Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
Vince Weaver <vincent.weaver@maine.edu>
Yuri Kozlov <yuray@komyakino.ru>
New and rewritten pages
-----------------------
-open_by_handle_at.2
- Michael Kerrisk [Mike Frysinger, Neil Brown, Aneesh Kumar K.V,
- Christoph Hellwig]
- New page describing name_to_handle_at(2) and open_by_handle_at(2)
-
-inotify.7
- Michael Kerrisk
- Rewrite introductory section
- Reorganize "Limitations and caveats" subsection
- Michael Kerrisk
- Further describe the race when adding a watch to a new subtree
- Michael Kerrisk
- Directory renames may invalidate multiple paths cached by application
- Michael Kerrisk
- Add paragraph on cache consistency checking
- Michael Kerrisk
- Mention cache rebuilding to handle overflow events
- Michael Kerrisk
- Moving an object to another filesystem generates IN_DELETE_SELF
- Michael Kerrisk [Jan Kara]
- Add text on dealing with rename() events
- Michael Kerrisk
- Note rationale and consequences of event coalescing
- Michael Kerrisk [Eric W. Biederman]
- Inotify doesn't work for remote and pseudo filesystems
- Michael Kerrisk
- Add some examples of events generated by various system calls
- Michael Kerrisk
- BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped
- A silent change as a result of the fanotify work in kernel 2.6.36.
- Michael Kerrisk
- Note that IN_DELETE_SELF will be followed by IN_IGNORED
- Michael Kerrisk
- Note that IN_UNMOUNT will be followed by an IN_IGNORED event
- Michael Kerrisk
- Inotify does not report events for mmap(2) and msync(2)
- Michael Kerrisk
- Add examples of syscalls that trigger IN_ATTRIB
- Michael Kerrisk
- Add some examples of syscalls that trigger IN_MODIFY
+inet_net_pton.3
Michael Kerrisk
- execve(2) also generates IN_ACCESS
- Michael Kerrisk
- Add examples of syscalls that trigger IN_CREATE
+ New page describing inet_net_pton(3) and inet_net_ntop(3)
Newly documented interfaces in existing pages
---------------------------------------------
-perf_event_open.2
- Vince Weaver [Michael Kerrisk]
- Document the PERF_FLAG_FD_CLOEXEC flag
- The Linux 3.14 release adds support for the PERF_FLAG_FD_CLOEXEC
- flag.
+fallocate.2
+ Michael Kerrisk, Namjae Jeon [Christoph Hellwig, Dave Chinner]
+ Document FALLOC_FL_COLLAPSE_RANGE
+
+prctl.2
+ Michael Kerrisk [Alex Thorlton]
+ Document PR_SET_THP_DISABLE and PR_GET_THP_DISABLE
-feature_test_macros.7
+proc.5
Michael Kerrisk
- Document _LARGEFILE_SOURCE
+ Document /proc/[pid]/stack
+ Michael Kerrisk
+ Document /proc/[pid]/clear_refs
New and changed links
---------------------
-name_to_handle_at.2
+inet_net_ntop.3
Michael Kerrisk
- New link to new open_by_name_at(2) page
-
-
-Global changes
---------------
-
-fmemopen.3
-getaddrinfo.3
-mq_notify.3
-offsetof.3
-aio.7
- Michael Kerrisk
- Print size_t/ssize_t values using %z printf() modifier
- There are fewer and fewer systems these days that don't
- support the %z specifier mandated in C99. So replace the
- use of %ld/%lu + (long) cast with %zd/%zu.
+ New link to new inet_net_pton.3
Changes to individual pages
---------------------------
-bdflush.2
-fsync.2
-sync.2
- Kir Kolyshkin
- SEE ALSO: remove update(8) reference
- Remove reference to update(8) man page, since there is no such
- page. This is an ancient BSD leftover I believe.
-
-chown.2
+fcntl.2
Michael Kerrisk
- Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
+ Note the race when O_CLOEXEC is used at same time as fork()+execve()
-getxattr.2
- Abhay Sachan
- Fix REURN VALUE description
- A EA can have length zero.
-
-inotify_add_watch.2
+madvise.2
Michael Kerrisk
- ERRORS: add ENAMETOOLONG
+ SEE ALSO: see prctl(2)
+ Because of PR_SET_THP_DISABLE.
-inotify_init.2
+mlock.2
Michael Kerrisk
- Add pointer to inotify(7)
+ Describe treatment of MCL_FUTURE during fork(2) and execve(2)
-link.2
- Michael Kerrisk
- When AT_EMPTY_PATH is specified, 'olddirfd' must not refer to a
- directory
-
-mmap.2
- Andrey Vagin
- The file descriptor for a file mapping must be readable
- There is no difference between MAP_SHARED and MAP_PRIVATE.
+msync.2
+ Michael Kerrisk [Richard Hansen, Greg Troxel]
+ Warn that one of MS_SYNC or MS_ASYNC is required
open.2
Michael Kerrisk
- SEE ALSO: add open_by_name_at(2)
-
- Various clean-ups and bug fixes after review by Mike Frysinger.
+ Add more detail on the race that O_CLOEXEC is designed to avoid
+ Michael Kerrisk [Matthew Dempsky]
+ Remove crufty text stating that O_DIRECTORY is Linux-specific
+ Michael Kerrisk
+ Note which filesystems support O_TMPFILE
perf_event_open.2
- Vince Weaver
- Document PERF_EVENT_IOC_PERIOD behavior change
- Linux 3.14 (in commit bad7192b842c83e580747ca57104dd51fe08c223)
- changes the perf_event PERF_EVENT_IOC_PERIOD ioctl() behavior
- on all architectures to update immediately, to match the behavior
- found on ARM.
-
-stat.2
- Michael Kerrisk
- Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
+ Vince Weaver [Michael Kerrisk]
+ Clarify EACCES and EPERM errors
+ Clarify the reasons for EACCES and EPERM errors.
+ Vince Weaver [Michael Kerrisk]
+ Make the ERRORS section more comprehensive.
+ Determined both by code inspection and by writing a large
+ number of test programs.
-syscalls.2
+personality.2
Michael Kerrisk
- Add sched_getattr() and sched_setattr()
- And update kernel version to 3.14
-
-abort.3
- Peng Haitao
- ATTRIBUTES: Note function that is thread-safe
- The function abort() is thread safe.
+ Available execution domains are listed in <sys/personality.h>
+ Michael Kerrisk
+ Fix discussion of return value
-confstr.3
+prctl.2
Michael Kerrisk
- SEE ALSO: add getconf(1), fpathconf(3), sysconf(3), pathconf(3)
+ ERRORS: document EINVAL for PR_GET_NO_NEW_PRIVS
+ ERRORS: document EINVAL for PR_SET_PDEATHSIG
+ ERRORS: document EINVAL for PR_SET_TIMING
+ ERRORS: document EINVAL for PR_SET_DUMPABLE
+ ERRORS: document EINVAL for PR_SET_NO_NEW_PRIVS
-exit.3
- Peng Haitao
- ATTRIBUTES: Note function that is not thread-safe
- The function exit() is not thread safe.
+shmget.2
+ Michael Kerrisk
+ Rewrite description of SHMMNI default value
+ Michael Kerrisk
+ Note default value of SHMMAX
+ Note default value for SHMALL
-fenv.3
+byteorder.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
- The functions feclearexcept(), fegetexceptflag(), feraiseexcept(),
- fesetexceptflag(), fetestexcept(), fegetround(), fesetround(),
- fegetenv(), feholdexcept(), fesetenv(), feupdateenv(),
- feenableexcept(), fedisableexcept() and fegetexcept() are thread
+ The functions htonl(), htons(), ntohl() and ntohs() are thread
safe.
-fpathconf.3
- Michael Kerrisk
- SEE ALSO: add confstr(3)
-
-fseek.3
- Michael Kerrisk [Petr Gajdos]
- Document EINVAL error for negative file offset
-
-fseeko.3
- Michael Kerrisk
- Add feature test macro requirements
-
-fts.3
- Michael Kerrisk [Mike Frysinger]
- Remove mention of "32-bit systems" in BUGS
+fexecve.3
+ Michael Kerrisk [Steven Stewart-Gallus]
+ If 'fd' is a close-on-exec file descriptor for a script, fexecve() fails
+ See https://bugzilla.kernel.org/show_bug.cgi?id=74481
-fwide.3
-wprintf.3
- Michael Kerrisk [Robert P. J. Day]
- Remove mention of bogus _ISOC95_SOURCE feature test macro
-
-getline.3
- Alexey Samsonov
- Caller should free the allocated buffer even if getline() failed
- Relevant discussion in glibc bugzilla:
- https://sourceware.org/bugzilla/show_bug.cgi?id=5666
-
-getloadavg.3
+ffs.3
Peng Haitao
- ATTRIBUTES: Note function that is thread-safe
- The function getloadavg() is thread safe.
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions ffs(), ffsl() and ffsll() are thread safe.
-getpt.3
+getauxval.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
- The function getpt() is thread safe.
+ The function getauxval() is thread safe.
-if_nametoindex.3
+getcontext.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
- The functions if_nametoindex() and if_indextoname() are thread safe.
+ The functions getcontext() and setcontext() are thread safe.
-index.3
+getsubopt.3
Peng Haitao
- ATTRIBUTES: Note functions that are thread-safe
- The functions index() and rindex() are thread safe.
+ ATTRIBUTES: Note function that is thread-safe
+ The function getsubopt() is thread safe.
-mkfifo.3
+getutmp.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
- The functions mkfifo() and mkfifoat() are thread safe.
+ The functions getutmp() and getutmpx() are thread safe.
+
+inet.3
+ Michael Kerrisk
+ Note success and error return for inet_aton()
-netlink.3
+inet.3
+ Michael Kerrisk [Craig McQueen]
+ The form 'a.b' if is suitable for Class A addresses (not class C)
Michael Kerrisk
- SEE ALSO: make the reference for libnetlink the libnetlink(3) man page
+ SEE ALSO: add inet_net_pton(3)
-random.3
+makecontext.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
- The functions random(), srandom(), initstate() and setstate()
- are thread safe.
+ The functions makecontext() and swapcontext() are thread safe.
-random_r.3
+pthread_attr_setdetachstate.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
- The functions random_r(), srandom_r(), initstate_r() and
- setstate_r() are thread safe.
+ The functions pthread_attr_setdetachstate() and
+ pthread_attr_getdetachstate() are thread safe.
-sigvec.3
+pthread_attr_setguardsize.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
- The functions sigvec(), sigblock(), sigsetmask() and
- siggetmask() are thread safe.
+ The functions pthread_attr_setguardsize() and
+ pthread_attr_getguardsize() are thread safe.
- The macro sigmask() is thread safe.
+sigsetops.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions sigemptyset(), sigfillset(), sigaddset(),
+ sigdelset(), sigismember(), sigisemptyset(), sigorset() and
+ sigandset() are thread safe.
-sysconf.3
- Michael Kerrisk
- SEE ALSO: add confstr(3)
-
-termios.3
- Michael Kerrisk [Peter Hurley]
- Fix error in discussion of MIN > 0, TIME == 0 noncanonical mode
- As reported by Peter Hurley, for the MIN > 0, TIME == 0 case:
-
- read() may unblock when MIN bytes are available but return
- up to the 'count' parameter if more input arrives in between
- waking and copying into the user buffer.
- ...
- read() may also _not_ return until MIN bytes have been
- received, even if 'count' bytes have been received.
- Michael Kerrisk
- Add a note on interaction of O_NONBLOCK with noncanonical MIN/TIME
- POSIX leaves the behavior open.
+proc.5
+ Petr Gajdos
+ Improve /proc/[pid]/smaps entries description
Michael Kerrisk
- Clarify termination conditions for MIN > 0, TIME > 0
+ /proc/PID/smaps is present only if CONFIG_PROC_PAGE_MONITOR
Michael Kerrisk
- Clarify behavior if data is available before noncanonical read()
+ Note kernel version for /proc/sys/kernel/{shmall,shmmax}
Michael Kerrisk
- Add descriptive titles to noncanonical read() cases
+ Note kernel version for /proc/sys/kernel/{msgmax,msgmnb}
-symlink.7
+capabilities.7
Michael Kerrisk
- Add subsection on opening a symbolic link with O_PATH
- Michael Kerrisk
- name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
- Michael Kerrisk
- Mention use of readlink(2) to read contents of a symlink
+ SEE ALSO: add capsh(1)
-tcp.7
- Michael Kerrisk [Eric Dumazet]
- Document /proc/sys/net/ipv4/tcp_autocorking
- Text heavily based on Documentation/networking/ip-sysctl.txt
+libc.7
+ Michael Kerrisk
+ Add musl libc