OSDN Git Service

LDP: Update original to LDP v3.79
[linuxjm/LDP_man-pages.git] / original / Changes.old
index 8fbc803..4afe7c7 100644 (file)
@@ -34623,3 +34623,439 @@ ld.so.8
 
             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