-==================== Changes in man-pages-3.78 ====================
+==================== Changes in man-pages-3.79 ====================
-Released: 2015-01-22, Munich
+Released: 2015-02-01, Munich
Contributors
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>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+J William Piggott <elseifthen@gmx.com>
+Masanari Iida <standby24x7@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
-Rich Felker <dalias@aerifal.cx>
+Scot Doyle <lkml14@scotdoyle.com>
+Sergey V. Zubkov <cubbi@cubbi.com>
+Stephan Mueller <stephan.mueller@atsec.com>
Vince Weaver <vincent.weaver@maine.edu>
+Vivek Goyal <vgoyal@redhat.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
-execveat.2
- David Drysdale, Michael Kerrisk [Rich Felker]
- New page for execveat(2)
+getrandom.2
+ Heinrich Schuchardt, Theodore T'so, Michael Kerrisk
+ New page documenting getrandom(2)
+ Kernel 3.17 introduces a new system call getrandom(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
+kexec_load.2
+ Vivek Goyal, Michael Kerrisk
+ Add documentation of kexec_file_load(2)
+ Michael Kerrisk, Vivke Goyal
+ Rewrite and extend documentation of kexec_load().
New and changed links
---------------------
-s390_pci_mmio_read.2
+kexec_file_load.2
Michael Kerrisk
- New link to new s390_pci_mmio_write(2) page
-
+ New link to kexec_load.2
Changes to individual pages
---------------------------
-dup.2
- Michael Kerrisk
- Add reference to RLIMIT_NOFILE for EMFILE error
+personality.2
Michael Kerrisk
- Add reference to RLIMIT_NOFILE for EBADF error on 'newfd'.
+ SEE ALSO: add setarch(8)
-execve.2
-fexecve.3
+prctl.2
Michael Kerrisk
- SEE ALSO: add execveat(2)
+ Unused arguments of PR_MPX_(EN,DIS}ABLE_MANAGEMENT must be zero
-fallocate.2
-mmap.2
-open.2
-truncate.2
-write.2
+reboot.2
Michael Kerrisk
- ERRORS: add EPERM for operation denied by file seal
+ SEE ALSO: add kexec_load(2)
-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
+socket.2
+ Stephan Mueller
+ document AF_ALG
+ Add a reference to the AF_ALG protocol accessible via socket(2).
-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
+fflush.3
+ Michael Kerrisk [Sergey V. Zubkov]
+ Clarify that flushing of input streams occurs only for seekable files
+ See https://bugzilla.kernel.org/show_bug.cgi?id=91931
+ Michael Kerrisk [Sergey V. Zubkov]
+ POSIX.1-2008 specifies the behavior when flushing input streams
+ POSIX.1-2001 did not have a specification for input streams,
+ but POSIX.1-2008 added one.
-mmap.2
-shmget.2
-shm_open.3
+getopt.3
Michael Kerrisk
- SEE ALSO: add memfd_create(2)
+ SEE ALSO: add getopt(1)
-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()"
+random.3
+ Heinrich Schuchardt
+ SEE ALSO: add getrandom(2)
-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
+termios.3
Michael Kerrisk
- Add some kernel version numbers to various fields and constants
+ SEE ALSO: add reset(1), setterm(1), tput(1)
-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.
+tzset.3
+ J William Piggott
+ Document behavior when TZ filespec omits the colon
+ If the TZ filespec omits the leading colon, glibc will parse
+ it for any valid format, i.e., it will still work.
+ J William Piggott
+ Add description for posixrules file
+ J William Piggott
+ Correct system timezone file path
+ J William Piggott
+ There are only two TZ formats
+ tzset(3) currently states that there are three TZ formats. The
+ first two it lists are actually variations of the POSIX-style
+ TZ format, of which there are at least five variations.
-readv.2
- Michael Kerrisk
- Update details on glibc readv()/writev() wrapper behavior
- And add a historical detail about Linux 2.0.
+ This patch corrects this to match the POSIX specification of
+ TZ having only two formats.
+ J William Piggott
+ Filespec omitted incorrect
+ Paragraph three of the DESCRIPTION section says
+ that when TZ is set, but empty, then UTC is used.
-select.2
- Michael Kerrisk
- Mention RLIMIT_NOFILE as a possible cause of EINVAL error
+ Later it says if the TZ filespec is omitted then the file
+ /usr/share/zoneinfo/localtime is used. This is incorrect,
+ it will use UTC in that case as well.
+ J William Piggott
+ Fix incorrect TZ string representation
+ The TZ string representation indicates that the start/end
+ rules are required; this is incorrect.
+ J William Piggott
+ Add ENVIRONMENT section + other rearrangements
+ FILES section was overly verbose and included
+ environment variables. Added ENVIRONMENT section,
+ removing ENV VARS from the FILES section.
-syscall.2
- Kees Cook
- Add arm64 and mips
- Add mips an d arm64 to tables, along with some further
- details on these architectures,
+random.4
+ Heinrich Schuchardt
+ SEE ALSO: add getrandom(2)
-syscalls.2
- Michael Kerrisk
- Add s390_pci_mmio_read(2) and s390_pci_mmio_write(2)
+passwd.5
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.
+ SEE ALSO: add chfn(1), chsh(1)
-errno.3
+capabilities.7
Michael Kerrisk
- The RLIMIT_NOFILE resource limit is a common cause of EMFILE
+ SEE ALSO: add setpriv(1)
-exec.3
+signal.7
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
+ Add getrandom(2) to list of restartable system calls
Michael Kerrisk
- Consistency fix: use "stream" as name for "FILE *" argument
+ Add F_OFD_SETLKW to list of restartable operations
-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