Merge tag 'docs-6.5' of git://git.lwn.net/linux
authorLinus Torvalds <torvalds@linux-foundation.org>
Tue, 27 Jun 2023 18:33:47 +0000 (11:33 -0700)
committerLinus Torvalds <torvalds@linux-foundation.org>
Tue, 27 Jun 2023 18:33:47 +0000 (11:33 -0700)
Pull documentation updates from Jonathan Corbet:
 "It's been a relatively calm cycle in docsland. We do have:

   - Some initial page-table documentation from Linus (the other Linus)

   - Regression-handling documentation improvements from Thorsten

   - Addition of kerneldoc documentation for the ERR_PTR() and related
     macros from James Seo

  ... and the usual collection of fixes and updates"

* tag 'docs-6.5' of git://git.lwn.net/linux:
  docs: consolidate storage interfaces
  Documentation: update git configuration for Link: tag
  Documentation: KVM: make corrections to vcpu-requests.rst
  Documentation: KVM: make corrections to ppc-pv.rst
  Documentation: KVM: make corrections to locking.rst
  Documentation: KVM: make corrections to halt-polling.rst
  Documentation: virt: correct location of haltpoll module params
  Documentation/mm: Initial page table documentation
  docs: crypto: async-tx-api: fix typo in struct name
  docs/doc-guide: Clarify how to write tables
  docs: handling-regressions: rework section about fixing procedures
  docs: process: fix a typoed cross-reference
  docs: submitting-patches: Discuss interleaved replies
  MAINTAINERS: direct process doc changes to a dedicated ML
  Documentation: core-api: Add error pointer functions to kernel-api
  err.h: Add missing kerneldocs for error pointer functions
  Documentation: conf.py: Add __force to c_id_attributes
  docs: clarify KVM related kernel parameters' descriptions
  docs: consolidate human interface subsystems
  docs: admin-guide: Add information about intel_pstate active mode

1  2 
Documentation/admin-guide/kernel-parameters.txt
Documentation/core-api/kernel-api.rst
MAINTAINERS

        arm64.nosme     [ARM64] Unconditionally disable Scalable Matrix
                        Extension support
  
 +      arm64.nomops    [ARM64] Unconditionally disable Memory Copy and Memory
 +                      Set instructions support
 +
        ataflop=        [HW,M68k]
  
        atarimouse=     [HW,MOUSE] Atari Mouse
                        Format:
                        <first_slot>,<last_slot>,<port>,<enum_bit>[,<debug>]
  
 -      cpu0_hotplug    [X86] Turn on CPU0 hotplug feature when
 -                      CONFIG_BOOTPARAM_HOTPLUG_CPU0 is off.
 -                      Some features depend on CPU0. Known dependencies are:
 -                      1. Resume from suspend/hibernate depends on CPU0.
 -                      Suspend/hibernate will fail if CPU0 is offline and you
 -                      need to online CPU0 before suspend/hibernate.
 -                      2. PIC interrupts also depend on CPU0. CPU0 can't be
 -                      removed if a PIC interrupt is detected.
 -                      It's said poweroff/reboot may depend on CPU0 on some
 -                      machines although I haven't seen such issues so far
 -                      after CPU0 is offline on a few tested machines.
 -                      If the dependencies are under your control, you can
 -                      turn on cpu0_hotplug.
 -
        cpuidle.off=1   [CPU_IDLE]
                        disable the cpuidle sub-system
  
                        on every CPU online, such as boot, and resume from suspend.
                        Default: 10000
  
 +      cpuhp.parallel=
 +                      [SMP] Enable/disable parallel bringup of secondary CPUs
 +                      Format: <bool>
 +                      Default is enabled if CONFIG_HOTPLUG_PARALLEL=y. Otherwise
 +                      the parameter has no effect.
 +
        crash_kexec_post_notifiers
                        Run kdump after running panic-notifiers and dumping
                        kmsg. This only for the users who doubt kdump always
                        disable
                          Do not enable intel_pstate as the default
                          scaling driver for the supported processors
+                         active
+                           Use intel_pstate driver to bypass the scaling
+                           governors layer of cpufreq and provides it own
+                           algorithms for p-state selection. There are two
+                           P-state selection algorithms provided by
+                           intel_pstate in the active mode: powersave and
+                           performance.  The way they both operate depends
+                           on whether or not the hardware managed P-states
+                           (HWP) feature has been enabled in the processor
+                           and possibly on the processor model.
                        passive
                          Use intel_pstate as a scaling driver, but configure it
                          to work with generic cpufreq governors (instead of
                        If the value is 0 (the default), KVM will pick a period based
                        on the ratio, such that a page is zapped after 1 hour on average.
  
-       kvm-amd.nested= [KVM,AMD] Allow nested virtualization in KVM/SVM.
-                       Default is 1 (enabled)
+       kvm-amd.nested= [KVM,AMD] Control nested virtualization feature in
+                       KVM/SVM. Default is 1 (enabled).
  
-       kvm-amd.npt=    [KVM,AMD] Disable nested paging (virtualized MMU)
-                       for all guests.
-                       Default is 1 (enabled) if in 64-bit or 32-bit PAE mode.
+       kvm-amd.npt=    [KVM,AMD] Control KVM's use of Nested Page Tables,
+                       a.k.a. Two-Dimensional Page Tables. Default is 1
+                       (enabled). Disable by KVM if hardware lacks support
+                       for NPT.
  
        kvm-arm.mode=
                        [KVM,ARM] Select one of KVM/arm64's modes of operation.
                        Format: <integer>
                        Default: 5
  
-       kvm-intel.ept=  [KVM,Intel] Disable extended page tables
-                       (virtualized MMU) support on capable Intel chips.
-                       Default is 1 (enabled)
+       kvm-intel.ept=  [KVM,Intel] Control KVM's use of Extended Page Tables,
+                       a.k.a. Two-Dimensional Page Tables.  Default is 1
+                       (enabled). Disable by KVM if hardware lacks support
+                       for EPT.
  
        kvm-intel.emulate_invalid_guest_state=
-                       [KVM,Intel] Disable emulation of invalid guest state.
-                       Ignored if kvm-intel.enable_unrestricted_guest=1, as
-                       guest state is never invalid for unrestricted guests.
-                       This param doesn't apply to nested guests (L2), as KVM
-                       never emulates invalid L2 guest state.
-                       Default is 1 (enabled)
+                       [KVM,Intel] Control whether to emulate invalid guest
+                       state. Ignored if kvm-intel.enable_unrestricted_guest=1,
+                       as guest state is never invalid for unrestricted
+                       guests. This param doesn't apply to nested guests (L2),
+                       as KVM never emulates invalid L2 guest state.
+                       Default is 1 (enabled).
  
        kvm-intel.flexpriority=
-                       [KVM,Intel] Disable FlexPriority feature (TPR shadow).
-                       Default is 1 (enabled)
+                       [KVM,Intel] Control KVM's use of FlexPriority feature
+                       (TPR shadow). Default is 1 (enabled). Disalbe by KVM if
+                       hardware lacks support for it.
  
        kvm-intel.nested=
-                       [KVM,Intel] Enable VMX nesting (nVMX).
-                       Default is 0 (disabled)
+                       [KVM,Intel] Control nested virtualization feature in
+                       KVM/VMX. Default is 1 (enabled).
  
        kvm-intel.unrestricted_guest=
-                       [KVM,Intel] Disable unrestricted guest feature
-                       (virtualized real and unpaged mode) on capable
-                       Intel chips. Default is 1 (enabled)
+                       [KVM,Intel] Control KVM's use of unrestricted guest
+                       feature (virtualized real and unpaged mode). Default
+                       is 1 (enabled). Disable by KVM if EPT is disabled or
+                       hardware lacks support for it.
  
        kvm-intel.vmentry_l1d_flush=[KVM,Intel] Mitigation for L1 Terminal Fault
                        CVE-2018-3620.
  
                        Default is cond (do L1 cache flush in specific instances)
  
-       kvm-intel.vpid= [KVM,Intel] Disable Virtual Processor Identification
-                       feature (tagged TLBs) on capable Intel chips.
-                       Default is 1 (enabled)
+       kvm-intel.vpid= [KVM,Intel] Control KVM's use of Virtual Processor
+                       Identification feature (tagged TLBs). Default is 1
+                       (enabled). Disable by KVM if hardware lacks support
+                       for it.
  
        l1d_flush=      [X86,INTEL]
                        Control mitigation for L1D based snooping vulnerability.
                        the propagation of recent CPU-hotplug changes up
                        the rcu_node combining tree.
  
 -      rcutree.use_softirq=    [KNL]
 -                      If set to zero, move all RCU_SOFTIRQ processing to
 -                      per-CPU rcuc kthreads.  Defaults to a non-zero
 -                      value, meaning that RCU_SOFTIRQ is used by default.
 -                      Specify rcutree.use_softirq=0 to use rcuc kthreads.
 -
 -                      But note that CONFIG_PREEMPT_RT=y kernels disable
 -                      this kernel boot parameter, forcibly setting it
 -                      to zero.
 -
 -      rcutree.rcu_fanout_exact= [KNL]
 -                      Disable autobalancing of the rcu_node combining
 -                      tree.  This is used by rcutorture, and might
 -                      possibly be useful for architectures having high
 -                      cache-to-cache transfer latencies.
 -
 -      rcutree.rcu_fanout_leaf= [KNL]
 -                      Change the number of CPUs assigned to each
 -                      leaf rcu_node structure.  Useful for very
 -                      large systems, which will choose the value 64,
 -                      and for NUMA systems with large remote-access
 -                      latencies, which will choose a value aligned
 -                      with the appropriate hardware boundaries.
 -
 -      rcutree.rcu_min_cached_objs= [KNL]
 -                      Minimum number of objects which are cached and
 -                      maintained per one CPU. Object size is equal
 -                      to PAGE_SIZE. The cache allows to reduce the
 -                      pressure to page allocator, also it makes the
 -                      whole algorithm to behave better in low memory
 -                      condition.
 -
 -      rcutree.rcu_delay_page_cache_fill_msec= [KNL]
 -                      Set the page-cache refill delay (in milliseconds)
 -                      in response to low-memory conditions.  The range
 -                      of permitted values is in the range 0:100000.
 -
        rcutree.jiffies_till_first_fqs= [KNL]
                        Set delay from grace-period initialization to
                        first attempt to force quiescent states.
                        When RCU_NOCB_CPU is set, also adjust the
                        priority of NOCB callback kthreads.
  
 -      rcutree.rcu_divisor= [KNL]
 -                      Set the shift-right count to use to compute
 -                      the callback-invocation batch limit bl from
 -                      the number of callbacks queued on this CPU.
 -                      The result will be bounded below by the value of
 -                      the rcutree.blimit kernel parameter.  Every bl
 -                      callbacks, the softirq handler will exit in
 -                      order to allow the CPU to do other work.
 -
 -                      Please note that this callback-invocation batch
 -                      limit applies only to non-offloaded callback
 -                      invocation.  Offloaded callbacks are instead
 -                      invoked in the context of an rcuoc kthread, which
 -                      scheduler will preempt as it does any other task.
 -
        rcutree.nocb_nobypass_lim_per_jiffy= [KNL]
                        On callback-offloaded (rcu_nocbs) CPUs,
                        RCU reduces the lock contention that would
                        the ->nocb_bypass queue.  The definition of "too
                        many" is supplied by this kernel boot parameter.
  
 -      rcutree.rcu_nocb_gp_stride= [KNL]
 -                      Set the number of NOCB callback kthreads in
 -                      each group, which defaults to the square root
 -                      of the number of CPUs.  Larger numbers reduce
 -                      the wakeup overhead on the global grace-period
 -                      kthread, but increases that same overhead on
 -                      each group's NOCB grace-period kthread.
 -
        rcutree.qhimark= [KNL]
                        Set threshold of queued RCU callbacks beyond which
                        batch limiting is disabled.
                        on rcutree.qhimark at boot time and to zero to
                        disable more aggressive help enlistment.
  
 +      rcutree.rcu_delay_page_cache_fill_msec= [KNL]
 +                      Set the page-cache refill delay (in milliseconds)
 +                      in response to low-memory conditions.  The range
 +                      of permitted values is in the range 0:100000.
 +
 +      rcutree.rcu_divisor= [KNL]
 +                      Set the shift-right count to use to compute
 +                      the callback-invocation batch limit bl from
 +                      the number of callbacks queued on this CPU.
 +                      The result will be bounded below by the value of
 +                      the rcutree.blimit kernel parameter.  Every bl
 +                      callbacks, the softirq handler will exit in
 +                      order to allow the CPU to do other work.
 +
 +                      Please note that this callback-invocation batch
 +                      limit applies only to non-offloaded callback
 +                      invocation.  Offloaded callbacks are instead
 +                      invoked in the context of an rcuoc kthread, which
 +                      scheduler will preempt as it does any other task.
 +
 +      rcutree.rcu_fanout_exact= [KNL]
 +                      Disable autobalancing of the rcu_node combining
 +                      tree.  This is used by rcutorture, and might
 +                      possibly be useful for architectures having high
 +                      cache-to-cache transfer latencies.
 +
 +      rcutree.rcu_fanout_leaf= [KNL]
 +                      Change the number of CPUs assigned to each
 +                      leaf rcu_node structure.  Useful for very
 +                      large systems, which will choose the value 64,
 +                      and for NUMA systems with large remote-access
 +                      latencies, which will choose a value aligned
 +                      with the appropriate hardware boundaries.
 +
 +      rcutree.rcu_min_cached_objs= [KNL]
 +                      Minimum number of objects which are cached and
 +                      maintained per one CPU. Object size is equal
 +                      to PAGE_SIZE. The cache allows to reduce the
 +                      pressure to page allocator, also it makes the
 +                      whole algorithm to behave better in low memory
 +                      condition.
 +
 +      rcutree.rcu_nocb_gp_stride= [KNL]
 +                      Set the number of NOCB callback kthreads in
 +                      each group, which defaults to the square root
 +                      of the number of CPUs.  Larger numbers reduce
 +                      the wakeup overhead on the global grace-period
 +                      kthread, but increases that same overhead on
 +                      each group's NOCB grace-period kthread.
 +
        rcutree.rcu_kick_kthreads= [KNL]
                        Cause the grace-period kthread to get an extra
                        wake_up() if it sleeps three times longer than
                        This wake_up() will be accompanied by a
                        WARN_ONCE() splat and an ftrace_dump().
  
 +      rcutree.rcu_resched_ns= [KNL]
 +                      Limit the time spend invoking a batch of RCU
 +                      callbacks to the specified number of nanoseconds.
 +                      By default, this limit is checked only once
 +                      every 32 callbacks in order to limit the pain
 +                      inflicted by local_clock() overhead.
 +
        rcutree.rcu_unlock_delay= [KNL]
                        In CONFIG_RCU_STRICT_GRACE_PERIOD=y kernels,
                        this specifies an rcu_read_unlock()-time delay
                        rcu_node tree with an eye towards determining
                        why a new grace period has not yet started.
  
 +      rcutree.use_softirq=    [KNL]
 +                      If set to zero, move all RCU_SOFTIRQ processing to
 +                      per-CPU rcuc kthreads.  Defaults to a non-zero
 +                      value, meaning that RCU_SOFTIRQ is used by default.
 +                      Specify rcutree.use_softirq=0 to use rcuc kthreads.
 +
 +                      But note that CONFIG_PREEMPT_RT=y kernels disable
 +                      this kernel boot parameter, forcibly setting it
 +                      to zero.
 +
        rcuscale.gp_async= [KNL]
                        Measure performance of asynchronous
                        grace-period primitives such as call_rcu().
  
        rcutorture.stall_cpu_block= [KNL]
                        Sleep while stalling if set.  This will result
 -                      in warnings from preemptible RCU in addition
 -                      to any other stall-related activity.
 +                      in warnings from preemptible RCU in addition to
 +                      any other stall-related activity.  Note that
 +                      in kernels built with CONFIG_PREEMPTION=n and
 +                      CONFIG_PREEMPT_COUNT=y, this parameter will
 +                      cause the CPU to pass through a quiescent state.
 +                      Given CONFIG_PREEMPTION=n, this will suppress
 +                      RCU CPU stall warnings, but will instead result
 +                      in scheduling-while-atomic splats.
 +
 +                      Use of this module parameter results in splats.
 +
  
        rcutorture.stall_cpu_holdoff= [KNL]
                        Time to wait (s) after boot before inducing stall.
                        port and the regular usb controller gets disabled.
  
        root=           [KNL] Root filesystem
 -                      See name_to_dev_t comment in init/do_mounts.c.
 +                      Usually this a a block device specifier of some kind,
 +                      see the early_lookup_bdev comment in
 +                      block/early-lookup.c for details.
 +                      Alternatively this can be "ram" for the legacy initial
 +                      ramdisk, "nfs" and "cifs" for root on a network file
 +                      system, or "mtd" and "ubi" for mounting from raw flash.
  
        rootdelay=      [KNL] Delay (in seconds) to pause before attempting to
                        mount the root filesystem
@@@ -96,6 -96,12 +96,12 @@@ Command-line Parsin
  .. kernel-doc:: lib/cmdline.c
     :export:
  
+ Error Pointers
+ --------------
+ .. kernel-doc:: include/linux/err.h
+    :internal:
  Sorting
  -------
  
@@@ -412,15 -418,3 +418,15 @@@ Read-Copy Update (RCU
  .. kernel-doc:: include/linux/rcu_sync.h
  
  .. kernel-doc:: kernel/rcu/sync.c
 +
 +.. kernel-doc:: kernel/rcu/tasks.h
 +
 +.. kernel-doc:: kernel/rcu/tree_stall.h
 +
 +.. kernel-doc:: include/linux/rcupdate_trace.h
 +
 +.. kernel-doc:: include/linux/rcupdate_wait.h
 +
 +.. kernel-doc:: include/linux/rcuref.h
 +
 +.. kernel-doc:: include/linux/rcutree.h
diff --combined MAINTAINERS
@@@ -956,8 -956,7 +956,8 @@@ F: Documentation/networking/device_driv
  F:    drivers/net/ethernet/amazon/
  
  AMAZON RDMA EFA DRIVER
 -M:    Gal Pressman <galpress@amazon.com>
 +M:    Michael Margolin <mrgolin@amazon.com>
 +R:    Gal Pressman <gal.pressman@linux.dev>
  R:    Yossi Leybovich <sleybo@amazon.com>
  L:    linux-rdma@vger.kernel.org
  S:    Supported
@@@ -1601,7 -1600,7 +1601,7 @@@ F:      drivers/media/i2c/ar0521.
  
  ARASAN NAND CONTROLLER DRIVER
  M:    Miquel Raynal <miquel.raynal@bootlin.com>
 -M:    Naga Sureshkumar Relli <nagasure@xilinx.com>
 +R:    Michal Simek <michal.simek@amd.com>
  L:    linux-mtd@lists.infradead.org
  S:    Maintained
  F:    Documentation/devicetree/bindings/mtd/arasan,nand-controller.yaml
@@@ -1678,7 -1677,10 +1678,7 @@@ F:     drivers/power/reset/arm-versatile-re
  F:    drivers/soc/versatile/
  
  ARM KOMEDA DRM-KMS DRIVER
 -M:    James (Qian) Wang <james.qian.wang@arm.com>
  M:    Liviu Dudau <liviu.dudau@arm.com>
 -M:    Mihail Atanassov <mihail.atanassov@arm.com>
 -L:    Mali DP Maintainers <malidp@foss.arm.com>
  S:    Supported
  T:    git git://anongit.freedesktop.org/drm/drm-misc
  F:    Documentation/devicetree/bindings/display/arm,komeda.yaml
@@@ -1699,6 -1701,8 +1699,6 @@@ F:      include/uapi/drm/panfrost_drm.
  
  ARM MALI-DP DRM DRIVER
  M:    Liviu Dudau <liviu.dudau@arm.com>
 -M:    Brian Starkey <brian.starkey@arm.com>
 -L:    Mali DP Maintainers <malidp@foss.arm.com>
  S:    Supported
  T:    git git://anongit.freedesktop.org/drm/drm-misc
  F:    Documentation/devicetree/bindings/display/arm,malidp.yaml
@@@ -1764,7 -1768,7 +1764,7 @@@ F:      include/linux/amba/mmci.
  
  ARM PRIMECELL PL35X NAND CONTROLLER DRIVER
  M:    Miquel Raynal <miquel.raynal@bootlin.com>
 -M:    Naga Sureshkumar Relli <nagasure@xilinx.com>
 +R:    Michal Simek <michal.simek@amd.com>
  L:    linux-mtd@lists.infradead.org
  S:    Maintained
  F:    Documentation/devicetree/bindings/mtd/arm,pl353-nand-r2p1.yaml
@@@ -1772,7 -1776,7 +1772,7 @@@ F:      drivers/mtd/nand/raw/pl35x-nand-cont
  
  ARM PRIMECELL PL35X SMC DRIVER
  M:    Miquel Raynal <miquel.raynal@bootlin.com>
 -M:    Naga Sureshkumar Relli <nagasure@xilinx.com>
 +R:    Michal Simek <michal.simek@amd.com>
  L:    linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
  S:    Maintained
  F:    Documentation/devicetree/bindings/memory-controllers/arm,pl35x-smc.yaml
@@@ -2430,15 -2434,6 +2430,15 @@@ X:    drivers/net/wireless/atmel
  N:    at91
  N:    atmel
  
 +ARM/MICROCHIP (ARM64) SoC support
 +M:    Conor Dooley <conor@kernel.org>
 +M:    Nicolas Ferre <nicolas.ferre@microchip.com>
 +M:    Claudiu Beznea <claudiu.beznea@microchip.com>
 +L:    linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
 +S:    Supported
 +T:    git https://git.kernel.org/pub/scm/linux/kernel/git/at91/linux.git
 +F:    arch/arm64/boot/dts/microchip/
 +
  ARM/Microchip Sparx5 SoC support
  M:    Lars Povlsen <lars.povlsen@microchip.com>
  M:    Steen Hegelund <Steen.Hegelund@microchip.com>
@@@ -2446,7 -2441,8 +2446,7 @@@ M:      Daniel Machon <daniel.machon@microch
  M:    UNGLinuxDriver@microchip.com
  L:    linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
  S:    Supported
 -T:    git git://github.com/microchip-ung/linux-upstream.git
 -F:    arch/arm64/boot/dts/microchip/
 +F:    arch/arm64/boot/dts/microchip/sparx*
  F:    drivers/net/ethernet/microchip/vcap/
  F:    drivers/pinctrl/pinctrl-microchip-sgpio.c
  N:    sparx5
@@@ -3545,7 -3541,7 +3545,7 @@@ F:      Documentation/filesystems/befs.rs
  F:    fs/befs/
  
  BFQ I/O SCHEDULER
 -M:    Paolo Valente <paolo.valente@linaro.org>
 +M:    Paolo Valente <paolo.valente@unimore.it>
  M:    Jens Axboe <axboe@kernel.dk>
  L:    linux-block@vger.kernel.org
  S:    Maintained
@@@ -4918,6 -4914,7 +4918,6 @@@ F:      drivers/media/cec/i2c/ch7322.
  CIRRUS LOGIC AUDIO CODEC DRIVERS
  M:    James Schulman <james.schulman@cirrus.com>
  M:    David Rhodes <david.rhodes@cirrus.com>
 -M:    Lucas Tanure <tanureal@opensource.cirrus.com>
  M:    Richard Fitzgerald <rf@opensource.cirrus.com>
  L:    alsa-devel@alsa-project.org (moderated for non-subscribers)
  L:    patches@opensource.cirrus.com
@@@ -5139,7 -5136,7 +5139,7 @@@ X:      drivers/clk/clkdev.
  
  COMMON INTERNET FILE SYSTEM CLIENT (CIFS and SMB3)
  M:    Steve French <sfrench@samba.org>
 -R:    Paulo Alcantara <pc@cjr.nz> (DFS, global name space)
 +R:    Paulo Alcantara <pc@manguebit.com> (DFS, global name space)
  R:    Ronnie Sahlberg <lsahlber@redhat.com> (directory leases, sparse files)
  R:    Shyam Prasad N <sprasad@microsoft.com> (multichannel)
  R:    Tom Talpey <tom@talpey.com> (RDMA, smbdirect)
@@@ -5149,8 -5146,8 +5149,8 @@@ S:      Supporte
  W:    https://wiki.samba.org/index.php/LinuxCIFS
  T:    git git://git.samba.org/sfrench/cifs-2.6.git
  F:    Documentation/admin-guide/cifs/
 -F:    fs/cifs/
 -F:    fs/smbfs_common/
 +F:    fs/smb/client/
 +F:    fs/smb/common/
  F:    include/uapi/linux/cifs
  
  COMPACTPCI HOTPLUG CORE
@@@ -5344,18 -5341,6 +5344,18 @@@ F:    include/linux/sched/cpufreq.
  F:    kernel/sched/cpufreq*.c
  F:    tools/testing/selftests/cpufreq/
  
 +CPU HOTPLUG
 +M:    Thomas Gleixner <tglx@linutronix.de>
 +M:    Peter Zijlstra <peterz@infradead.org>
 +L:    linux-kernel@vger.kernel.org
 +S:    Maintained
 +T:    git git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git smp/core
 +F:    kernel/cpu.c
 +F:    kernel/smpboot.*
 +F:    include/linux/cpu.h
 +F:    include/linux/cpuhotplug.h
 +F:    include/linux/smpboot.h
 +
  CPU IDLE TIME MANAGEMENT FRAMEWORK
  M:    "Rafael J. Wysocki" <rafael@kernel.org>
  M:    Daniel Lezcano <daniel.lezcano@linaro.org>
@@@ -5740,14 -5725,6 +5740,14 @@@ F:    include/linux/tfrc.
  F:    include/uapi/linux/dccp.h
  F:    net/dccp/
  
 +DEBUGOBJECTS:
 +M:    Thomas Gleixner <tglx@linutronix.de>
 +L:    linux-kernel@vger.kernel.org
 +S:    Maintained
 +T:    git git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git core/debugobjects
 +F:    lib/debugobjects.c
 +F:    include/linux/debugobjects.h
 +
  DECSTATION PLATFORM SUPPORT
  M:    "Maciej W. Rozycki" <macro@orcam.me.uk>
  L:    linux-mips@vger.kernel.org
@@@ -6035,7 -6012,7 +6035,7 @@@ W:      http://www.dialog-semiconductor.com/
  F:    Documentation/devicetree/bindings/input/da90??-onkey.txt
  F:    Documentation/devicetree/bindings/input/dlg,da72??.txt
  F:    Documentation/devicetree/bindings/mfd/da90*.txt
 -F:    Documentation/devicetree/bindings/mfd/da90*.yaml
 +F:    Documentation/devicetree/bindings/mfd/dlg,da90*.yaml
  F:    Documentation/devicetree/bindings/regulator/da92*.txt
  F:    Documentation/devicetree/bindings/regulator/dlg,da9*.yaml
  F:    Documentation/devicetree/bindings/regulator/slg51000.txt
@@@ -6234,11 -6211,16 +6234,17 @@@ X:   Documentation/devicetree
  X:    Documentation/driver-api/media/
  X:    Documentation/firmware-guide/acpi/
  X:    Documentation/i2c/
 +X:    Documentation/netlink/
  X:    Documentation/power/
  X:    Documentation/spi/
  X:    Documentation/userspace-api/media/
  
+ DOCUMENTATION PROCESS
+ M:    Jonathan Corbet <corbet@lwn.net>
+ S:    Maintained
+ F:    Documentation/process/
+ L:    workflows@vger.kernel.org
  DOCUMENTATION REPORTING ISSUES
  M:    Thorsten Leemhuis <linux@leemhuis.info>
  L:    linux-doc@vger.kernel.org
@@@ -7494,14 -7476,6 +7500,14 @@@ L:    linux-edac@vger.kernel.or
  S:    Maintained
  F:    drivers/edac/mpc85xx_edac.[ch]
  
 +EDAC-NPCM
 +M:    Marvin Lin <kflin@nuvoton.com>
 +M:    Stanley Chu <yschu@nuvoton.com>
 +L:    linux-edac@vger.kernel.org
 +S:    Maintained
 +F:    Documentation/devicetree/bindings/memory-controllers/nuvoton,npcm-memory-controller.yaml
 +F:    drivers/edac/npcm_edac.c
 +
  EDAC-PASEMI
  M:    Egor Martovetsky <egor@pasemi.com>
  L:    linux-edac@vger.kernel.org
@@@ -8190,7 -8164,6 +8196,7 @@@ F:      include/linux/spi/spi-fsl-dspi.
  
  FREESCALE ENETC ETHERNET DRIVERS
  M:    Claudiu Manoil <claudiu.manoil@nxp.com>
 +M:    Vladimir Oltean <vladimir.oltean@nxp.com>
  L:    netdev@vger.kernel.org
  S:    Maintained
  F:    drivers/net/ethernet/freescale/enetc/
@@@ -8819,7 -8792,6 +8825,7 @@@ F:      include/linux/gpio/regmap.
  GPIO SUBSYSTEM
  M:    Linus Walleij <linus.walleij@linaro.org>
  M:    Bartosz Golaszewski <brgl@bgdev.pl>
 +R:    Andy Shevchenko <andy@kernel.org>
  L:    linux-gpio@vger.kernel.org
  S:    Maintained
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/brgl/linux.git
@@@ -9373,7 -9345,7 +9379,7 @@@ F:      include/linux/hisi_acc_qm.
  
  HISILICON ROCE DRIVER
  M:    Haoyue Xu <xuhaoyue1@hisilicon.com>
 -M:    Wenpeng Liang <liangwenpeng@huawei.com>
 +M:    Junxian Huang <huangjunxian6@hisilicon.com>
  L:    linux-rdma@vger.kernel.org
  S:    Maintained
  F:    Documentation/devicetree/bindings/infiniband/hisilicon-hns-roce.txt
@@@ -9716,9 -9688,8 +9722,9 @@@ F:      include/uapi/linux/i2c-*.
  F:    include/uapi/linux/i2c.h
  
  I2C SUBSYSTEM HOST DRIVERS
 +M:    Andi Shyti <andi.shyti@kernel.org>
  L:    linux-i2c@vger.kernel.org
 -S:    Odd Fixes
 +S:    Maintained
  W:    https://i2c.wiki.kernel.org/
  Q:    https://patchwork.ozlabs.org/project/linux-i2c/list/
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/wsa/linux.git
@@@ -9992,9 -9963,8 +9998,9 @@@ M:      Miquel Raynal <miquel.raynal@bootlin
  L:    linux-wpan@vger.kernel.org
  S:    Maintained
  W:    https://linux-wpan.org/
 -T:    git git://git.kernel.org/pub/scm/linux/kernel/git/sschmidt/wpan.git
 -T:    git git://git.kernel.org/pub/scm/linux/kernel/git/sschmidt/wpan-next.git
 +Q:    https://patchwork.kernel.org/project/linux-wpan/list/
 +T:    git git://git.kernel.org/pub/scm/linux/kernel/git/wpan/wpan.git
 +T:    git git://git.kernel.org/pub/scm/linux/kernel/git/wpan/wpan-next.git
  F:    Documentation/networking/ieee802154.rst
  F:    drivers/net/ieee802154/
  F:    include/linux/ieee802154.h
@@@ -10146,7 -10116,7 +10152,7 @@@ S:   Maintaine
  F:    Documentation/process/kernel-docs.rst
  
  INDUSTRY PACK SUBSYSTEM (IPACK)
 -M:    Samuel Iglesias Gonsalvez <siglesias@igalia.com>
 +M:    Vaibhav Gupta <vaibhavgupta40@gmail.com>
  M:    Jens Taprogge <jens.taprogge@taprogge.org>
  M:    Greg Kroah-Hartman <gregkh@linuxfoundation.org>
  L:    industrypack-devel@lists.sourceforge.net
@@@ -11295,10 -11265,6 +11301,10 @@@ W: http://kernelnewbies.org/KernelJanit
  KERNEL NFSD, SUNRPC, AND LOCKD SERVERS
  M:    Chuck Lever <chuck.lever@oracle.com>
  M:    Jeff Layton <jlayton@kernel.org>
 +R:    Neil Brown <neilb@suse.de>
 +R:    Olga Kornievskaia <kolga@netapp.com>
 +R:    Dai Ngo <Dai.Ngo@oracle.com>
 +R:    Tom Talpey <tom@talpey.com>
  L:    linux-nfs@vger.kernel.org
  S:    Supported
  W:    http://nfs.sourceforge.net/
@@@ -11345,9 -11311,9 +11351,9 @@@ R:   Tom Talpey <tom@talpey.com
  L:    linux-cifs@vger.kernel.org
  S:    Maintained
  T:    git git://git.samba.org/ksmbd.git
 -F:    Documentation/filesystems/cifs/ksmbd.rst
 -F:    fs/ksmbd/
 -F:    fs/smbfs_common/
 +F:    Documentation/filesystems/smb/ksmbd.rst
 +F:    fs/smb/common/
 +F:    fs/smb/server/
  
  KERNEL UNIT TESTING FRAMEWORK (KUnit)
  M:    Brendan Higgins <brendanhiggins@google.com>
@@@ -11356,8 -11322,6 +11362,8 @@@ L:   linux-kselftest@vger.kernel.or
  L:    kunit-dev@googlegroups.com
  S:    Maintained
  W:    https://google.github.io/kunit-docs/third_party/kernel/docs/
 +T:    git git://git.kernel.org/pub/scm/linux/kernel/git/shuah/linux-kselftest.git kunit
 +T:    git git://git.kernel.org/pub/scm/linux/kernel/git/shuah/linux-kselftest.git kunit-fixes
  F:    Documentation/dev-tools/kunit/
  F:    include/kunit/
  F:    lib/kunit/
@@@ -13296,11 -13260,10 +13302,11 @@@ F:        drivers/memory/mtk-smi.
  F:    include/soc/mediatek/smi.h
  
  MEDIATEK SWITCH DRIVER
 -M:    Sean Wang <sean.wang@mediatek.com>
 +M:    Arınç ÜNAL <arinc.unal@arinc9.com>
 +M:    Daniel Golle <daniel@makrotopia.org>
  M:    Landen Chao <Landen.Chao@mediatek.com>
  M:    DENG Qingfang <dqfext@gmail.com>
 -M:    Daniel Golle <daniel@makrotopia.org>
 +M:    Sean Wang <sean.wang@mediatek.com>
  L:    netdev@vger.kernel.org
  S:    Maintained
  F:    drivers/net/dsa/mt7530-mdio.c
@@@ -13875,7 -13838,7 +13881,7 @@@ F:   drivers/tty/serial/8250/8250_pci1xxx
  
  MICROCHIP POLARFIRE FPGA DRIVERS
  M:    Conor Dooley <conor.dooley@microchip.com>
 -R:    Ivan Bornyakov <i.bornyakov@metrotek.ru>
 +R:    Vladimir Georgiev <v.georgiev@metrotek.ru>
  L:    linux-fpga@vger.kernel.org
  S:    Supported
  F:    Documentation/devicetree/bindings/fpga/microchip,mpf-spi-fpga-mgr.yaml
@@@ -14609,7 -14572,6 +14615,7 @@@ T:   git git://git.kernel.org/pub/scm/lin
  F:    Documentation/devicetree/bindings/net/
  F:    drivers/connector/
  F:    drivers/net/
 +X:    drivers/net/wireless/
  F:    include/dt-bindings/net/
  F:    include/linux/etherdevice.h
  F:    include/linux/fcdevice.h
@@@ -14659,7 -14621,6 +14665,7 @@@ B:   mailto:netdev@vger.kernel.or
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net.git
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net-next.git
  F:    Documentation/core-api/netlink.rst
 +F:    Documentation/netlink/
  F:    Documentation/networking/
  F:    Documentation/process/maintainer-netdev.rst
  F:    Documentation/userspace-api/netlink/
@@@ -14674,7 -14635,6 +14680,7 @@@ F:   include/uapi/linux/netdevice.
  F:    lib/net_utils.c
  F:    lib/random32.c
  F:    net/
 +X:    net/bluetooth/
  F:    tools/net/
  F:    tools/testing/selftests/net/
  
@@@ -14974,7 -14934,6 +14980,7 @@@ F:   drivers/ntb/hw/intel
  
  NTFS FILESYSTEM
  M:    Anton Altaparmakov <anton@tuxera.com>
 +R:    Namjae Jeon <linkinjeon@kernel.org>
  L:    linux-ntfs-dev@lists.sourceforge.net
  S:    Supported
  W:    http://www.tuxera.com/
@@@ -15976,7 -15935,7 +15982,7 @@@ F:   include/uapi/linux/ppdev.
  
  PARAVIRT_OPS INTERFACE
  M:    Juergen Gross <jgross@suse.com>
 -M:    Srivatsa S. Bhat (VMware) <srivatsa@csail.mit.edu>
 +R:    Ajay Kaher <akaher@vmware.com>
  R:    Alexey Makhalov <amakhalov@vmware.com>
  R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    virtualization@lists.linux-foundation.org
@@@ -16412,7 -16371,7 +16418,7 @@@ F:   Documentation/devicetree/bindings/pc
  F:    drivers/pci/controller/dwc/pcie-keembay.c
  
  PCIE DRIVER FOR INTEL LGM GW SOC
 -M:    Rahul Tanwar <rtanwar@maxlinear.com>
 +M:    Chuanhua Lei <lchuanhua@maxlinear.com>
  L:    linux-pci@vger.kernel.org
  S:    Maintained
  F:    Documentation/devicetree/bindings/pci/intel-gw-pcie.yaml
@@@ -17824,7 -17783,7 +17830,7 @@@ M:   Boqun Feng <boqun.feng@gmail.com
  R:    Steven Rostedt <rostedt@goodmis.org>
  R:    Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
  R:    Lai Jiangshan <jiangshanlai@gmail.com>
 -R:    Zqiang <qiang1.zhang@intel.com>
 +R:    Zqiang <qiang.zhang1211@gmail.com>
  L:    rcu@vger.kernel.org
  S:    Supported
  W:    http://www.rdrop.com/users/paulmck/RCU/
@@@ -17855,7 -17814,7 +17861,7 @@@ F:   tools/testing/selftests/rtc
  Real-time Linux Analysis (RTLA) tools
  M:    Daniel Bristot de Oliveira <bristot@kernel.org>
  M:    Steven Rostedt <rostedt@goodmis.org>
 -L:    linux-trace-devel@vger.kernel.org
 +L:    linux-trace-kernel@vger.kernel.org
  S:    Maintained
  F:    Documentation/tools/rtla/
  F:    tools/tracing/rtla/
@@@ -18076,14 -18035,6 +18082,14 @@@ S: Maintaine
  F:    Documentation/devicetree/bindings/usb/renesas,rzn1-usbf.yaml
  F:    drivers/usb/gadget/udc/renesas_usbf.c
  
 +RENESAS RZ/V2M I2C DRIVER
 +M:    Fabrizio Castro <fabrizio.castro.jz@renesas.com>
 +L:    linux-i2c@vger.kernel.org
 +L:    linux-renesas-soc@vger.kernel.org
 +S:    Supported
 +F:    Documentation/devicetree/bindings/i2c/renesas,rzv2m.yaml
 +F:    drivers/i2c/busses/i2c-rzv2m.c
 +
  RENESAS USB PHY DRIVER
  M:    Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
  L:    linux-renesas-soc@vger.kernel.org
@@@ -18425,7 -18376,7 +18431,7 @@@ F:   drivers/infiniband/ulp/rtrs
  RUNTIME VERIFICATION (RV)
  M:    Daniel Bristot de Oliveira <bristot@kernel.org>
  M:    Steven Rostedt <rostedt@goodmis.org>
 -L:    linux-trace-devel@vger.kernel.org
 +L:    linux-trace-kernel@vger.kernel.org
  S:    Maintained
  F:    Documentation/trace/rv/
  F:    include/linux/rv.h
@@@ -18630,9 -18581,10 +18636,9 @@@ F:  Documentation/admin-guide/LSM/SafeSe
  F:    security/safesetid/
  
  SAMSUNG AUDIO (ASoC) DRIVERS
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
  M:    Sylwester Nawrocki <s.nawrocki@samsung.com>
  L:    alsa-devel@alsa-project.org (moderated for non-subscribers)
 -S:    Supported
 +S:    Maintained
  B:    mailto:linux-samsung-soc@vger.kernel.org
  F:    Documentation/devicetree/bindings/sound/samsung*
  F:    sound/soc/samsung/
@@@ -18760,6 -18712,7 +18766,6 @@@ F:   include/dt-bindings/clock/samsung,*.
  F:    include/linux/clk/samsung.h
  
  SAMSUNG SPI DRIVERS
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
  M:    Andi Shyti <andi.shyti@kernel.org>
  L:    linux-spi@vger.kernel.org
  L:    linux-samsung-soc@vger.kernel.org
@@@ -18895,11 -18848,12 +18901,11 @@@ F:        drivers/target
  F:    include/target/
  
  SCTP PROTOCOL
 -M:    Neil Horman <nhorman@tuxdriver.com>
  M:    Marcelo Ricardo Leitner <marcelo.leitner@gmail.com>
  M:    Xin Long <lucien.xin@gmail.com>
  L:    linux-sctp@vger.kernel.org
  S:    Maintained
 -W:    http://lksctp.sourceforge.net
 +W:    https://github.com/sctp/lksctp-tools/wiki
  F:    Documentation/networking/sctp.rst
  F:    include/linux/sctp.h
  F:    include/net/sctp/
@@@ -19168,9 -19122,6 +19174,9 @@@ SHARED MEMORY COMMUNICATIONS (SMC) SOCK
  M:    Karsten Graul <kgraul@linux.ibm.com>
  M:    Wenjia Zhang <wenjia@linux.ibm.com>
  M:    Jan Karcher <jaka@linux.ibm.com>
 +R:    D. Wythe <alibuda@linux.alibaba.com>
 +R:    Tony Lu <tonylu@linux.alibaba.com>
 +R:    Wen Gu <guwen@linux.alibaba.com>
  L:    linux-s390@vger.kernel.org
  S:    Supported
  F:    net/smc/
@@@ -22548,7 -22499,7 +22554,7 @@@ S:   Supporte
  F:    drivers/misc/vmw_balloon.c
  
  VMWARE HYPERVISOR INTERFACE
 -M:    Srivatsa S. Bhat (VMware) <srivatsa@csail.mit.edu>
 +M:    Ajay Kaher <akaher@vmware.com>
  M:    Alexey Makhalov <amakhalov@vmware.com>
  R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    virtualization@lists.linux-foundation.org
@@@ -22575,8 -22526,8 +22581,8 @@@ F:   drivers/scsi/vmw_pvscsi.
  F:    drivers/scsi/vmw_pvscsi.h
  
  VMWARE VIRTUAL PTP CLOCK DRIVER
 -M:    Srivatsa S. Bhat (VMware) <srivatsa@csail.mit.edu>
  M:    Deep Shah <sdeep@vmware.com>
 +R:    Ajay Kaher <akaher@vmware.com>
  R:    Alexey Makhalov <amakhalov@vmware.com>
  R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    netdev@vger.kernel.org