Merge tag 'docs-5.0' of git://git.lwn.net/linux
authorLinus Torvalds <torvalds@linux-foundation.org>
Sat, 29 Dec 2018 19:21:49 +0000 (11:21 -0800)
committerLinus Torvalds <torvalds@linux-foundation.org>
Sat, 29 Dec 2018 19:21:49 +0000 (11:21 -0800)
Pull documentation update from Jonathan Corbet:
 "A fairly normal cycle for documentation stuff. We have a new document
  on perf security, more Italian translations, more improvements to the
  memory-management docs, improvements to the pathname lookup
  documentation, and the usual array of smaller fixes.

  As is often the case, there are a few reaches outside of
  Documentation/ to adjust kerneldoc comments"

* tag 'docs-5.0' of git://git.lwn.net/linux: (38 commits)
  docs: improve pathname-lookup document structure
  configfs: fix wrong name of struct in documentation
  docs/mm-api: link slab_common.c to "The Slab Cache" section
  slab: make kmem_cache_create{_usercopy} description proper kernel-doc
  doc:process: add links where missing
  docs/core-api: make mm-api.rst more structured
  x86, boot: documentation whitespace fixup
  Documentation: devres: note checking needs when converting
  doc:it: add some process/* translations
  doc:it: fixes in process/1.Intro
  Documentation: convert path-lookup from markdown to resturctured text
  Documentation/admin-guide: update admin-guide index.rst
  Documentation/admin-guide: introduce perf-security.rst file
  scripts/kernel-doc: Fix struct and struct field attribute processing
  Documentation: dev-tools: Fix typos in index.rst
  Correct gen_init_cpio tool's documentation
  Document /proc/pid PID reuse behavior
  Documentation: update path-lookup.md for parallel lookups
  Documentation: Use "while" instead of "whilst"
  dmaengine: Add mailing list address to the documentation
  ...

1  2 
Documentation/admin-guide/kernel-parameters.txt
Documentation/admin-guide/security-bugs.rst
Documentation/driver-model/devres.txt
Documentation/filesystems/proc.txt
Documentation/gpu/drm-uapi.rst
Documentation/media/uapi/v4l/extended-controls.rst
Documentation/networking/device_drivers/dec/de4x5.txt
Documentation/networking/rxrpc.txt
Documentation/x86/boot.txt
include/linux/slab.h
mm/slab_common.c

index 30187d49dc2c7d38869c4073e60093d315c3fc4e,410602752dc40530c9628cc6ee51f71420ccdf2d..dcd6c93c7aacb04f14120bf0c972d2be26fb1c25
@@@ -32,19 -32,18 +32,19 @@@ Disclosure and embargoed informatio
  The security list is not a disclosure channel.  For that, see Coordination
  below.
  
 -Once a robust fix has been developed, our preference is to release the
 -fix in a timely fashion, treating it no differently than any of the other
 -thousands of changes and fixes the Linux kernel project releases every
 -month.
 -
 -However, at the request of the reporter, we will postpone releasing the
 -fix for up to 5 business days after the date of the report or after the
 -embargo has lifted; whichever comes first.  The only exception to that
 -rule is if the bug is publicly known, in which case the preference is to
 -release the fix as soon as it's available.
 +Once a robust fix has been developed, the release process starts.  Fixes
 +for publicly known bugs are released immediately.
 +
 +Although our preference is to release fixes for publicly undisclosed bugs
 +as soon as they become available, this may be postponed at the request of
 +the reporter or an affected party for up to 7 calendar days from the start
 +of the release process, with an exceptional extension to 14 calendar days
 +if it is agreed that the criticality of the bug requires more time.  The
 +only valid reason for deferring the publication of a fix is to accommodate
 +the logistics of QA and large scale rollouts which require release
 +coordination.
  
- Whilst embargoed information may be shared with trusted individuals in
+ While embargoed information may be shared with trusted individuals in
  order to develop a fix, such information will not be published alongside
  the fix or on any other disclosure channel without the permission of the
  reporter.  This includes but is not limited to the original bug report
Simple merge
Simple merge
index 4b4bf2c5eac5d8f54e0bfb5992837099740008a9,f2f079e91b4cf526ff87cc5a53b357af9aa51852..a752aa561ea4d256341274aafdeaf2ebc45c872f
@@@ -194,12 -194,9 +194,12 @@@ EPERM/EACCES
          Returned for an operation that is valid, but needs more privileges.
          E.g. root-only or much more common, DRM master-only operations return
          this when when called by unpriviledged clients. There's no clear
-         difference between EACCESS and EPERM.
+         difference between EACCES and EPERM.
  
  ENODEV:
 +        The device is not (yet) present or fully initialized.
 +
 +EOPNOTSUPP:
          Feature (like PRIME, modesetting, GEM) is not supported by the driver.
  
  ENXIO:
index 89f1302d593a5c0404ed8a434ba580e8440a9139,aab3c393c10df152bc7c417cafa4b94c9294c0ec..c9d052e0cf5136774c1f9a77de8f5bae7d7ad423
@@@ -1056,23 -1056,18 +1056,23 @@@ The kernel interface functions are as f
  
        u32 rxrpc_kernel_check_life(struct socket *sock,
                                    struct rxrpc_call *call);
 +      void rxrpc_kernel_probe_life(struct socket *sock,
 +                                   struct rxrpc_call *call);
  
 -     This returns a number that is updated when ACKs are received from the peer
 -     (notably including PING RESPONSE ACKs which we can elicit by sending PING
 -     ACKs to see if the call still exists on the server).  The caller should
 -     compare the numbers of two calls to see if the call is still alive after
 -     waiting for a suitable interval.
 +     The first function returns a number that is updated when ACKs are received
 +     from the peer (notably including PING RESPONSE ACKs which we can elicit by
 +     sending PING ACKs to see if the call still exists on the server).  The
 +     caller should compare the numbers of two calls to see if the call is still
 +     alive after waiting for a suitable interval.
  
       This allows the caller to work out if the server is still contactable and
-      if the call is still alive on the server whilst waiting for the server to
+      if the call is still alive on the server while waiting for the server to
       process a client operation.
  
 -     This function may transmit a PING ACK.
 +     The second function causes a ping ACK to be transmitted to try to provoke
 +     the peer into responding, which would then cause the value returned by the
 +     first function to change.  Note that this must be called in TASK_RUNNING
 +     state.
  
   (*) Get reply timestamp.
  
index 5e9b826b5f62fd1cf8dfcae07fc5bde66594428b,7973249cce455baa09942a815af538c409e8fa42..f4c2a97bfdbd0d1ed058013b7dbce161d5fb6d9a
@@@ -58,9 -58,21 +58,9 @@@ Protocol 2.11:       (Kernel 3.6) Added a fie
                protocol entry point.
  
  Protocol 2.12:        (Kernel 3.8) Added the xloadflags field and extension fields
-               to struct boot_params for loading bzImage and ramdisk
+               to struct boot_params for loading bzImage and ramdisk
                above 4G in 64bit.
  
 -Protocol 2.13:        (Kernel 3.14) Support 32- and 64-bit flags being set in
 -              xloadflags to support booting a 64-bit kernel from 32-bit
 -              EFI
 -
 -Protocol 2.14:        (Kernel 4.20) Added acpi_rsdp_addr holding the physical
 -              address of the ACPI RSDP table.
 -              The bootloader updates version with:
 -              0x8000 | min(kernel-version, bootloader-version)
 -              kernel-version being the protocol version supported by
 -              the kernel and bootloader-version the protocol version
 -              supported by the bootloader.
 -
  **** MEMORY LAYOUT
  
  The traditional memory map for the kernel loader, used for Image or
Simple merge
Simple merge