OSDN Git Service

LDP: Update original to LDP v3.79
[linuxjm/LDP_man-pages.git] / original / Changes
index 0c4f489..ab3ee7f 100644 (file)
@@ -1,6 +1,6 @@
-==================== Changes in man-pages-3.78 ====================
+==================== Changes in man-pages-3.79 ====================
 
-Released: 2015-01-22, Munich
+Released: 2015-02-01, Munich
 
 
 Contributors
@@ -11,20 +11,15 @@ 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>
+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!
 
@@ -32,232 +27,116 @@ 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