Merge branch 'pm-docs'
authorRafael J. Wysocki <rafael.j.wysocki@intel.com>
Tue, 29 Mar 2022 16:53:28 +0000 (18:53 +0200)
committerRafael J. Wysocki <rafael.j.wysocki@intel.com>
Tue, 29 Mar 2022 16:53:28 +0000 (18:53 +0200)
Merge additional power management documentation udates for 5.18-rc1:

 - Add Intel uncore frequency scaling documentation file to its
   MAINTAINERS entry (Srinivas Pandruvada).

 - Clean up the AMD P-state driver documentation (Jan Engelhardt).

* pm-docs:
  Documentation: amd-pstate: grammar and sentence structure updates
  MAINTAINERS: Add additional file to uncore frequency control

1  2 
Documentation/admin-guide/pm/amd-pstate.rst
MAINTAINERS

@@@ -19,7 -19,7 +19,7 @@@ Linux kernel. The new mechanism is base
  Performance Control (CPPC) which provides finer grain frequency management
  than legacy ACPI hardware P-States. Current AMD CPU/APU platforms are using
  the ACPI P-states driver to manage CPU frequency and clocks with switching
- only in 3 P-states. CPPC replaces the ACPI P-states controls, allows a
+ only in 3 P-states. CPPC replaces the ACPI P-states controls and allows a
  flexible, low-latency interface for the Linux kernel to directly
  communicate the performance hints to hardware.
  
@@@ -27,7 -27,7 +27,7 @@@
  ``ondemand``, etc. to manage the performance hints which are provided by
  CPPC hardware functionality that internally follows the hardware
  specification (for details refer to AMD64 Architecture Programmer's Manual
- Volume 2: System Programming [1]_). Currently ``amd-pstate`` supports basic
+ Volume 2: System Programming [1]_). Currently, ``amd-pstate`` supports basic
  frequency control function according to kernel governors on some of the
  Zen2 and Zen3 processors, and we will implement more AMD specific functions
  in future after we verify them on the hardware and SBIOS.
@@@ -41,9 -41,9 +41,9 @@@ continuous, abstract, and unit-less per
  not tied to a specific performance state / frequency. This is an ACPI
  standard [2]_ which software can specify application performance goals and
  hints as a relative target to the infrastructure limits. AMD processors
- provides the low latency register model (MSR) instead of AML code
+ provide the low latency register model (MSR) instead of an AML code
  interpreter for performance adjustments. ``amd-pstate`` will initialize a
- ``struct cpufreq_driver`` instance ``amd_pstate_driver`` with the callbacks
+ ``struct cpufreq_driver`` instance, ``amd_pstate_driver``, with the callbacks
  to manage each performance update behavior. ::
  
   Highest Perf ------>+-----------------------+                         +-----------------------+
@@@ -91,26 -91,26 +91,26 @@@ AMD CPPC Performance Capabilit
  Highest Performance (RO)
  .........................
  
It is the absolute maximum performance an individual processor may reach,
This is the absolute maximum performance an individual processor may reach,
  assuming ideal conditions. This performance level may not be sustainable
  for long durations and may only be achievable if other platform components
- are in a specific state; for example, it may require other processors be in
+ are in a specific state; for example, it may require other processors to be in
  an idle state. This would be equivalent to the highest frequencies
  supported by the processor.
  
  Nominal (Guaranteed) Performance (RO)
  ......................................
  
It is the maximum sustained performance level of the processor, assuming
- ideal operating conditions. In absence of an external constraint (power,
- thermal, etc.) this is the performance level the processor is expected to
This is the maximum sustained performance level of the processor, assuming
+ ideal operating conditions. In the absence of an external constraint (power,
+ thermal, etc.), this is the performance level the processor is expected to
  be able to maintain continuously. All cores/processors are expected to be
  able to sustain their nominal performance state simultaneously.
  
  Lowest non-linear Performance (RO)
  ...................................
  
It is the lowest performance level at which nonlinear power savings are
This is the lowest performance level at which nonlinear power savings are
  achieved, for example, due to the combined effects of voltage and frequency
  scaling. Above this threshold, lower performance levels should be generally
  more energy efficient than higher performance levels. This register
@@@ -119,7 -119,7 +119,7 @@@ effectively conveys the most efficient 
  Lowest Performance (RO)
  ........................
  
It is the absolute lowest performance level of the processor. Selecting a
This is the absolute lowest performance level of the processor. Selecting a
  performance level lower than the lowest nonlinear performance level may
  cause an efficiency penalty but should reduce the instantaneous power
  consumption of the processor.
@@@ -149,14 -149,14 +149,14 @@@ a relative number. This can be expresse
  performance (infrastructure max). Below the nominal sustained performance
  level, desired performance expresses the average performance level of the
  processor subject to hardware. Above the nominal performance level,
- processor must provide at least nominal performance requested and go higher
the processor must provide at least nominal performance requested and go higher
  if current operating conditions allow.
  
  Energy Performance Preference (EPP) (RW)
  .........................................
  
- Provides a hint to the hardware if software wants to bias toward performance
- (0x0) or energy efficiency (0xff).
+ This attribute provides a hint to the hardware if software wants to bias
toward performance (0x0) or energy efficiency (0xff).
  
  
  Key Governors Support
@@@ -173,35 -173,34 +173,34 @@@ operating frequencies supported by the 
  ``amd-pstate`` mainly supports ``schedutil`` and ``ondemand`` for dynamic
  frequency control. It is to fine tune the processor configuration on
  ``amd-pstate`` to the ``schedutil`` with CPU CFS scheduler. ``amd-pstate``
- registers adjust_perf callback to implement the CPPC similar performance
update behavior. It is initialized by ``sugov_start`` and then populate the
- CPU's update_util_data pointer to assign ``sugov_update_single_perf`` as
the utilization update callback function in CPU scheduler. CPU scheduler
- will call ``cpufreq_update_util`` and assign the target performance
according to the ``struct sugov_cpu`` that utilization update belongs to.
- Then ``amd-pstate`` updates the desired performance according to the CPU
+ registers the adjust_perf callback to implement performance update behavior
similar to CPPC. It is initialized by ``sugov_start`` and then populates the
+ CPU's update_util_data pointer to assign ``sugov_update_single_perf`` as the
utilization update callback function in the CPU scheduler. The CPU scheduler
+ will call ``cpufreq_update_util`` and assigns the target performance according
to the ``struct sugov_cpu`` that the utilization update belongs to.
+ Then, ``amd-pstate`` updates the desired performance according to the CPU
  scheduler assigned.
  
  
  Processor Support
  =======================
  
- The ``amd-pstate`` initialization will fail if the _CPC in ACPI SBIOS is
- not existed at the detected processor, and it uses ``acpi_cpc_valid`` to
- check the _CPC existence. All Zen based processors support legacy ACPI
- hardware P-States function, so while the ``amd-pstate`` fails to be
- initialized, the kernel will fall back to initialize ``acpi-cpufreq``
- driver.
+ The ``amd-pstate`` initialization will fail if the ``_CPC`` entry in the ACPI
+ SBIOS does not exist in the detected processor. It uses ``acpi_cpc_valid``
+ to check the existence of ``_CPC``. All Zen based processors support the legacy
+ ACPI hardware P-States function, so when ``amd-pstate`` fails initialization,
+ the kernel will fall back to initialize the ``acpi-cpufreq`` driver.
  
  There are two types of hardware implementations for ``amd-pstate``: one is
  `Full MSR Support <perf_cap_>`_ and another is `Shared Memory Support
- <perf_cap_>`_. It can use :c:macro:`X86_FEATURE_CPPC` feature flag (for
- details refer to Processor Programming Reference (PPR) for AMD Family
- 19h Model 51h, Revision A1 Processors [3]_) to indicate the different
- types. ``amd-pstate`` is to register different ``static_call`` instances
for different hardware implementations.
+ <perf_cap_>`_. It can use the :c:macro:`X86_FEATURE_CPPC` feature flag to
+ indicate the different types. (For details, refer to the Processor Programming
+ Reference (PPR) for AMD Family 19h Model 51h, Revision A1 Processors [3]_.)
+ ``amd-pstate`` is to register different ``static_call`` instances for different
+ hardware implementations.
  
- Currently, some of Zen2 and Zen3 processors support ``amd-pstate``. In the
+ Currently, some of the Zen2 and Zen3 processors support ``amd-pstate``. In the
  future, it will be supported on more and more AMD processors.
  
  Full MSR Support
  Some new Zen3 processors such as Cezanne provide the MSR registers directly
  while the :c:macro:`X86_FEATURE_CPPC` CPU feature flag is set.
  ``amd-pstate`` can handle the MSR register to implement the fast switch
- function in ``CPUFreq`` that can shrink latency of frequency control on the
- interrupt context. The functions with ``pstate_xxx`` prefix represent the
- operations of MSR registers.
+ function in ``CPUFreq`` that can reduce the latency of frequency control in
+ interrupt context. The functions with ``pstate_xxx`` prefix represent the
+ operations on MSR registers.
  
  Shared Memory Support
  ----------------------
  
- If :c:macro:`X86_FEATURE_CPPC` CPU feature flag is not set, that means the
- processor supports shared memory solution. In this case, ``amd-pstate``
+ If the :c:macro:`X86_FEATURE_CPPC` CPU feature flag is not set, the
+ processor supports the shared memory solution. In this case, ``amd-pstate``
  uses the ``cppc_acpi`` helper methods to implement the callback functions
- that defined on ``static_call``. The functions with ``cppc_xxx`` prefix
- represent the operations of acpi cppc helpers for shared memory solution.
+ that are defined on ``static_call``. The functions with the ``cppc_xxx`` prefix
+ represent the operations of ACPI CPPC helpers for the shared memory solution.
  
  
  AMD P-States and ACPI hardware P-States always can be supported in one
@@@ -234,7 -233,7 +233,7 @@@ User Space Interface in ``sysfs`
  ==================================
  
  ``amd-pstate`` exposes several global attributes (files) in ``sysfs`` to
- control its functionality at the system level. They located in the
+ control its functionality at the system level. They are located in the
  ``/sys/devices/system/cpu/cpufreq/policyX/`` directory and affect all CPUs. ::
  
   root@hr-test1:/home/ray# ls /sys/devices/system/cpu/cpufreq/policy0/*amd*
  ``amd_pstate_highest_perf / amd_pstate_max_freq``
  
  Maximum CPPC performance and CPU frequency that the driver is allowed to
- set in percent of the maximum supported CPPC performance level (the highest
+ set, in percent of the maximum supported CPPC performance level (the highest
  performance supported in `AMD CPPC Performance Capability <perf_cap_>`_).
- In some of ASICs, the highest CPPC performance is not the one in the _CPC
- table, so we need to expose it to sysfs. If boost is not active but
- supported, this maximum frequency will be larger than the one in
+ In some ASICs, the highest CPPC performance is not the one in the ``_CPC``
+ table, so we need to expose it to sysfs. If boost is not active, but
+ still supported, this maximum frequency will be larger than the one in
  ``cpuinfo``.
  This attribute is read-only.
  
  ``amd_pstate_lowest_nonlinear_freq``
  
- The lowest non-linear CPPC CPU frequency that the driver is allowed to set
- in percent of the maximum supported CPPC performance level (Please see the
+ The lowest non-linear CPPC CPU frequency that the driver is allowed to set,
+ in percent of the maximum supported CPPC performance level. (Please see the
  lowest non-linear performance in `AMD CPPC Performance Capability
- <perf_cap_>`_).
+ <perf_cap_>`_.)
  This attribute is read-only.
  
For other performance and frequency values, we can read them back from
Other performance and frequency values can be read back from
  ``/sys/devices/system/cpu/cpuX/acpi_cppc/``, see :ref:`cppc_sysfs`.
  
  
  ``amd-pstate`` vs ``acpi-cpufreq``
  ======================================
  
- On majority of AMD platforms supported by ``acpi-cpufreq``, the ACPI tables
- provided by the platform firmware used for CPU performance scaling, but
- only provides 3 P-states on AMD processors.
- However, on modern AMD APU and CPU series, it provides the collaborative
processor performance control according to ACPI protocol and customize this
- for AMD platforms. That is fine-grain and continuous frequency range
+ On the majority of AMD platforms supported by ``acpi-cpufreq``, the ACPI tables
+ provided by the platform firmware are used for CPU performance scaling, but
+ only provide 3 P-states on AMD processors.
+ However, on modern AMD APU and CPU series, hardware provides the Collaborative
Processor Performance Control according to the ACPI protocol and customizes this
+ for AMD platforms. That is, fine-grained and continuous frequency ranges
  instead of the legacy hardware P-states. ``amd-pstate`` is the kernel
- module which supports the new AMD P-States mechanism on most of future AMD
- platforms. The AMD P-States mechanism will be the more performance and energy
+ module which supports the new AMD P-States mechanism on most of the future AMD
+ platforms. The AMD P-States mechanism is the more performance and energy
  efficiency frequency management method on AMD processors.
  
  Kernel Module Options for ``amd-pstate``
  Use a module param (shared_mem) to enable related processors manually with
  **amd_pstate.shared_mem=1**.
  Due to the performance issue on the processors with `Shared Memory Support
- <perf_cap_>`_, so we disable it for the moment and will enable this by default
- once we address performance issue on this solution.
+ <perf_cap_>`_, we disable it presently and will re-enable this by default
+ once we address performance issue with this solution.
  
- The way to check whether current processor is `Full MSR Support <perf_cap_>`_
+ To check whether the current processor is using `Full MSR Support <perf_cap_>`_
  or `Shared Memory Support <perf_cap_>`_ : ::
  
    ray@hr-test1:~$ lscpu | grep cppc
    Flags:                           fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ht syscall nx mmxext fxsr_opt pdpe1gb rdtscp lm constant_tsc rep_good nopl nonstop_tsc cpuid extd_apicid aperfmperf rapl pni pclmulqdq monitor ssse3 fma cx16 sse4_1 sse4_2 x2apic movbe popcnt aes xsave avx f16c rdrand lahf_lm cmp_legacy svm extapic cr8_legacy abm sse4a misalignsse 3dnowprefetch osvw ibs skinit wdt tce topoext perfctr_core perfctr_nb bpext perfctr_llc mwaitx cpb cat_l3 cdp_l3 hw_pstate ssbd mba ibrs ibpb stibp vmmcall fsgsbase bmi1 avx2 smep bmi2 erms invpcid cqm rdt_a rdseed adx smap clflushopt clwb sha_ni xsaveopt xsavec xgetbv1 xsaves cqm_llc cqm_occup_llc cqm_mbm_total cqm_mbm_local clzero irperf xsaveerptr rdpru wbnoinvd cppc arat npt lbrv svm_lock nrip_save tsc_scale vmcb_clean flushbyasid decodeassists pausefilter pfthreshold avic v_vmsave_vmload vgif v_spec_ctrl umip pku ospke vaes vpclmulqdq rdpid overflow_recov succor smca fsrm
  
- If CPU Flags have cppc, then this processor supports `Full MSR Support
- <perf_cap_>`_. Otherwise it supports `Shared Memory Support <perf_cap_>`_.
+ If the CPU flags have ``cppc``, then this processor supports `Full MSR Support
+ <perf_cap_>`_. Otherwise, it supports `Shared Memory Support <perf_cap_>`_.
  
  
  ``cpupower`` tool support for ``amd-pstate``
  ===============================================
  
- ``amd-pstate`` is supported on ``cpupower`` tool that can be used to dump the frequency
- information. And it is in progress to support more and more operations for new
- ``amd-pstate`` module with this tool. ::
+ ``amd-pstate`` is supported by the ``cpupower`` tool, which can be used to dump
+ frequency information. Development is in progress to support more and more
operations for the new ``amd-pstate`` module with this tool. ::
  
   root@hr-test1:/home/ray# cpupower frequency-info
   analyzing CPU 0:
@@@ -336,10 -335,10 +335,10 @@@ Trace Event
  --------------
  
  There are two static trace events that can be used for ``amd-pstate``
- diagnostics.  One of them is the cpu_frequency trace event generally used
+ diagnostics. One of them is the ``cpu_frequency`` trace event generally used
  by ``CPUFreq``, and the other one is the ``amd_pstate_perf`` trace event
  specific to ``amd-pstate``.  The following sequence of shell commands can
- be used to enable them and see their output (if the kernel is generally
+ be used to enable them and see their output (if the kernel is
  configured to support event tracing). ::
  
   root@hr-test1:/home/ray# cd /sys/kernel/tracing/
            <idle>-0       [003] d.s..  4995.980971: amd_pstate_perf: amd_min_perf=85 amd_des_perf=85 amd_max_perf=166 cpu_id=3 changed=false fast_switch=true
            <idle>-0       [011] d.s..  4995.980996: amd_pstate_perf: amd_min_perf=85 amd_des_perf=85 amd_max_perf=166 cpu_id=11 changed=false fast_switch=true
  
- The cpu_frequency trace event will be triggered either by the ``schedutil`` scaling
+ The ``cpu_frequency`` trace event will be triggered either by the ``schedutil`` scaling
  governor (for the policies it is attached to), or by the ``CPUFreq`` core (for the
  policies with other scaling governors).
  
  
 +Tracer Tool
 +-------------
 +
 +``amd_pstate_tracer.py`` can record and parse ``amd-pstate`` trace log, then
 +generate performance plots. This utility can be used to debug and tune the
 +performance of ``amd-pstate`` driver. The tracer tool needs to import intel
 +pstate tracer.
 +
 +Tracer tool located in ``linux/tools/power/x86/amd_pstate_tracer``. It can be
 +used in two ways. If trace file is available, then directly parse the file
 +with command ::
 +
 + ./amd_pstate_trace.py [-c cpus] -t <trace_file> -n <test_name>
 +
 +Or generate trace file with root privilege, then parse and plot with command ::
 +
 + sudo ./amd_pstate_trace.py [-c cpus] -n <test_name> -i <interval> [-m kbytes]
 +
 +The test result can be found in ``results/test_name``. Following is the example
 +about part of the output. ::
 +
 + common_cpu  common_secs  common_usecs  min_perf  des_perf  max_perf  freq    mperf   apef    tsc       load   duration_ms  sample_num  elapsed_time  common_comm
 + CPU_005     712          116384        39        49        166       0.7565  9645075 2214891 38431470  25.1   11.646       469         2.496         kworker/5:0-40
 + CPU_006     712          116408        39        49        166       0.6769  8950227 1839034 37192089  24.06  11.272       470         2.496         kworker/6:0-1264
 +
 +
  Reference
  ===========
  
diff --combined MAINTAINERS
@@@ -1002,7 -1002,6 +1002,7 @@@ L:      linux-pm@vger.kernel.or
  S:    Supported
  F:    Documentation/admin-guide/pm/amd-pstate.rst
  F:    drivers/cpufreq/amd-pstate*
 +F:    tools/power/x86/amd_pstate_tracer/amd_pstate_trace.py
  
  AMD PTDMA DRIVER
  M:    Sanjay R Mehta <sanju.mehta@amd.com>
@@@ -1770,7 -1769,7 +1770,7 @@@ T:      git https://github.com/AsahiLinux/li
  F:    Documentation/devicetree/bindings/arm/apple.yaml
  F:    Documentation/devicetree/bindings/arm/apple/*
  F:    Documentation/devicetree/bindings/i2c/apple,i2c.yaml
 -F:    Documentation/devicetree/bindings/interrupt-controller/apple,aic.yaml
 +F:    Documentation/devicetree/bindings/interrupt-controller/apple,*
  F:    Documentation/devicetree/bindings/mailbox/apple,mailbox.yaml
  F:    Documentation/devicetree/bindings/pci/apple,pcie.yaml
  F:    Documentation/devicetree/bindings/pinctrl/apple,pinctrl.yaml
@@@ -2255,7 -2254,7 +2255,7 @@@ F:      drivers/phy/mediatek
  ARM/Microchip (AT91) SoC support
  M:    Nicolas Ferre <nicolas.ferre@microchip.com>
  M:    Alexandre Belloni <alexandre.belloni@bootlin.com>
 -M:    Ludovic Desroches <ludovic.desroches@microchip.com>
 +M:    Claudiu Beznea <claudiu.beznea@microchip.com>
  L:    linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
  S:    Supported
  W:    http://www.linux4sam.org
@@@ -2573,7 -2572,7 +2573,7 @@@ F:      sound/soc/rockchip
  N:    rockchip
  
  ARM/SAMSUNG S3C, S5P AND EXYNOS ARM ARCHITECTURES
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  R:    Alim Akhtar <alim.akhtar@samsung.com>
  L:    linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
  L:    linux-samsung-soc@vger.kernel.org
@@@ -2740,7 -2739,7 +2740,7 @@@ N:      stm3
  N:    stm
  
  ARM/Synaptics SoC support
 -M:    Jisheng Zhang <Jisheng.Zhang@synaptics.com>
 +M:    Jisheng Zhang <jszhang@kernel.org>
  M:    Sebastian Hesselbarth <sebastian.hesselbarth@gmail.com>
  L:    linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
  S:    Maintained
@@@ -3906,7 -3905,7 +3906,7 @@@ M:      Scott Branden <sbranden@broadcom.com
  M:    bcm-kernel-feedback-list@broadcom.com
  L:    linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
  S:    Maintained
 -T:    git git://github.com/broadcom/cygnus-linux.git
 +T:    git git://github.com/broadcom/stblinux.git
  F:    arch/arm64/boot/dts/broadcom/northstar2/*
  F:    arch/arm64/boot/dts/broadcom/stingray/*
  F:    drivers/clk/bcm/clk-ns*
@@@ -6308,8 -6307,8 +6308,8 @@@ T:      git git://anongit.freedesktop.org/dr
  F:    drivers/gpu/drm/vboxvideo/
  
  DRM DRIVER FOR VMWARE VIRTUAL GPU
 -M:    "VMware Graphics" <linux-graphics-maintainer@vmware.com>
  M:    Zack Rusin <zackr@vmware.com>
 +R:    VMware Graphics Reviewers <linux-graphics-maintainer@vmware.com>
  L:    dri-devel@lists.freedesktop.org
  S:    Supported
  T:    git git://anongit.freedesktop.org/drm/drm-misc
@@@ -7745,7 -7744,8 +7745,7 @@@ M:      Qiang Zhao <qiang.zhao@nxp.com
  L:    linuxppc-dev@lists.ozlabs.org
  S:    Maintained
  F:    drivers/soc/fsl/qe/
 -F:    include/soc/fsl/*qe*.h
 -F:    include/soc/fsl/*ucc*.h
 +F:    include/soc/fsl/qe/
  
  FREESCALE QUICC ENGINE UCC ETHERNET DRIVER
  M:    Li Yang <leoyang.li@nxp.com>
@@@ -7776,7 -7776,6 +7776,7 @@@ F:      Documentation/devicetree/bindings/mi
  F:    Documentation/devicetree/bindings/soc/fsl/
  F:    drivers/soc/fsl/
  F:    include/linux/fsl/
 +F:    include/soc/fsl/
  
  FREESCALE SOC FS_ENET DRIVER
  M:    Pantelis Antoniou <pantelis.antoniou@gmail.com>
@@@ -9921,6 -9920,7 +9921,7 @@@ INTEL UNCORE FREQUENCY CONTRO
  M:    Srinivas Pandruvada <srinivas.pandruvada@linux.intel.com>
  L:    platform-driver-x86@vger.kernel.org
  S:    Maintained
+ F:    Documentation/admin-guide/pm/intel_uncore_frequency_scaling.rst
  F:    drivers/platform/x86/intel/uncore-frequency.c
  
  INTEL VENDOR SPECIFIC EXTENDED CAPABILITIES DRIVER
@@@ -10456,8 -10456,6 +10457,8 @@@ KERNEL REGRESSION
  M:    Thorsten Leemhuis <linux@leemhuis.info>
  L:    regressions@lists.linux.dev
  S:    Supported
 +F:    Documentation/admin-guide/reporting-regressions.rst
 +F:    Documentation/process/handling-regressions.rst
  
  KERNEL SELFTEST FRAMEWORK
  M:    Shuah Khan <shuah@kernel.org>
@@@ -11678,7 -11676,7 +11679,7 @@@ F:   drivers/iio/proximity/mb1232.
  
  MAXIM MAX17040 FAMILY FUEL GAUGE DRIVERS
  R:    Iskren Chernev <iskren.chernev@gmail.com>
 -R:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +R:    Krzysztof Kozlowski <krzk@kernel.org>
  R:    Marek Szyprowski <m.szyprowski@samsung.com>
  R:    Matheus Castello <matheus@castello.eng.br>
  L:    linux-pm@vger.kernel.org
@@@ -11688,7 -11686,7 +11689,7 @@@ F:   drivers/power/supply/max17040_batter
  
  MAXIM MAX17042 FAMILY FUEL GAUGE DRIVERS
  R:    Hans de Goede <hdegoede@redhat.com>
 -R:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +R:    Krzysztof Kozlowski <krzk@kernel.org>
  R:    Marek Szyprowski <m.szyprowski@samsung.com>
  R:    Sebastian Krzyszkowiak <sebastian.krzyszkowiak@puri.sm>
  R:    Purism Kernel Team <kernel@puri.sm>
@@@ -11733,7 -11731,7 +11734,7 @@@ F:   Documentation/devicetree/bindings/po
  F:    drivers/power/supply/max77976_charger.c
  
  MAXIM MUIC CHARGER DRIVERS FOR EXYNOS BASED BOARDS
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  M:    Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
  L:    linux-pm@vger.kernel.org
  S:    Supported
@@@ -11742,7 -11740,7 +11743,7 @@@ F:   drivers/power/supply/max77693_charge
  
  MAXIM PMIC AND MUIC DRIVERS FOR EXYNOS BASED BOARDS
  M:    Chanwoo Choi <cw00.choi@samsung.com>
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  M:    Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
  L:    linux-kernel@vger.kernel.org
  S:    Supported
@@@ -12431,7 -12429,7 +12432,7 @@@ F:   include/linux/memblock.
  F:    mm/memblock.c
  
  MEMORY CONTROLLER DRIVERS
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  L:    linux-kernel@vger.kernel.org
  S:    Maintained
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/krzk/linux-mem-ctrl.git
@@@ -13379,7 -13377,6 +13380,7 @@@ F:   net/core/drop_monitor.
  NETWORKING DRIVERS
  M:    "David S. Miller" <davem@davemloft.net>
  M:    Jakub Kicinski <kuba@kernel.org>
 +M:    Paolo Abeni <pabeni@redhat.com>
  L:    netdev@vger.kernel.org
  S:    Maintained
  Q:    https://patchwork.kernel.org/project/netdevbpf/list/
@@@ -13426,7 -13423,6 +13427,7 @@@ F:   tools/testing/selftests/drivers/net/
  NETWORKING [GENERAL]
  M:    "David S. Miller" <davem@davemloft.net>
  M:    Jakub Kicinski <kuba@kernel.org>
 +M:    Paolo Abeni <pabeni@redhat.com>
  L:    netdev@vger.kernel.org
  S:    Maintained
  Q:    https://patchwork.kernel.org/project/netdevbpf/list/
@@@ -13570,7 -13566,7 +13571,7 @@@ F:   include/uapi/linux/nexthop.
  F:    net/ipv4/nexthop.c
  
  NFC SUBSYSTEM
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  L:    linux-nfc@lists.01.org (subscribers-only)
  L:    netdev@vger.kernel.org
  S:    Maintained
@@@ -13704,7 -13700,7 +13705,7 @@@ F:   scripts/nsdep
  NTB AMD DRIVER
  M:    Sanjay R Mehta <sanju.mehta@amd.com>
  M:    Shyam Sundar S K <Shyam-sundar.S-k@amd.com>
 -L:    linux-ntb@googlegroups.com
 +L:    ntb@lists.linux.dev
  S:    Supported
  F:    drivers/ntb/hw/amd/
  
@@@ -13712,7 -13708,7 +13713,7 @@@ NTB DRIVER COR
  M:    Jon Mason <jdmason@kudzu.us>
  M:    Dave Jiang <dave.jiang@intel.com>
  M:    Allen Hubbe <allenbh@gmail.com>
 -L:    linux-ntb@googlegroups.com
 +L:    ntb@lists.linux.dev
  S:    Supported
  W:    https://github.com/jonmason/ntb/wiki
  T:    git git://github.com/jonmason/ntb.git
@@@ -13724,13 -13720,13 +13725,13 @@@ F:        tools/testing/selftests/ntb
  
  NTB IDT DRIVER
  M:    Serge Semin <fancer.lancer@gmail.com>
 -L:    linux-ntb@googlegroups.com
 +L:    ntb@lists.linux.dev
  S:    Supported
  F:    drivers/ntb/hw/idt/
  
  NTB INTEL DRIVER
  M:    Dave Jiang <dave.jiang@intel.com>
 -L:    linux-ntb@googlegroups.com
 +L:    ntb@lists.linux.dev
  S:    Supported
  W:    https://github.com/davejiang/linux/wiki
  T:    git https://github.com/davejiang/linux.git
@@@ -13884,7 -13880,7 +13885,7 @@@ F:   Documentation/devicetree/bindings/re
  F:    drivers/regulator/pf8x00-regulator.c
  
  NXP PTN5150A CC LOGIC AND EXTCON DRIVER
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  L:    linux-kernel@vger.kernel.org
  S:    Maintained
  F:    Documentation/devicetree/bindings/extcon/extcon-ptn5150.yaml
@@@ -14608,9 -14604,8 +14609,9 @@@ F:   include/uapi/linux/ppdev.
  
  PARAVIRT_OPS INTERFACE
  M:    Juergen Gross <jgross@suse.com>
 -M:    Deep Shah <sdeep@vmware.com>
 -M:    "VMware, Inc." <pv-drivers@vmware.com>
 +M:    Srivatsa S. Bhat (VMware) <srivatsa@csail.mit.edu>
 +R:    Alexey Makhalov <amakhalov@vmware.com>
 +R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    virtualization@lists.linux-foundation.org
  L:    x86@kernel.org
  S:    Supported
@@@ -15311,7 -15306,7 +15312,7 @@@ F:   drivers/pinctrl/renesas
  
  PIN CONTROLLER - SAMSUNG
  M:    Tomasz Figa <tomasz.figa@gmail.com>
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  M:    Sylwester Nawrocki <s.nawrocki@samsung.com>
  R:    Alim Akhtar <alim.akhtar@samsung.com>
  L:    linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
@@@ -15971,15 -15966,14 +15972,15 @@@ M:        Niklas Cassel <nks@flawful.org
  L:    linux-pm@vger.kernel.org
  L:    linux-arm-msm@vger.kernel.org
  S:    Maintained
 -F:    Documentation/devicetree/bindings/power/avs/qcom,cpr.txt
 +F:    Documentation/devicetree/bindings/power/avs/qcom,cpr.yaml
  F:    drivers/soc/qcom/cpr.c
  
  QUALCOMM CPUFREQ DRIVER MSM8996/APQ8096
  M:    Ilia Lin <ilia.lin@kernel.org>
  L:    linux-pm@vger.kernel.org
  S:    Maintained
 -F:    Documentation/devicetree/bindings/opp/qcom-nvmem-cpufreq.txt
 +F:    Documentation/devicetree/bindings/cpufreq/qcom-cpufreq-nvmem.yaml
 +F:    Documentation/devicetree/bindings/opp/opp-v2-kryo-cpu.yaml
  F:    drivers/cpufreq/qcom-cpufreq-nvmem.c
  
  QUALCOMM CRYPTO DRIVERS
@@@ -16328,8 -16322,6 +16329,8 @@@ F:   tools/testing/selftests/resctrl
  
  READ-COPY UPDATE (RCU)
  M:    "Paul E. McKenney" <paulmck@kernel.org>
 +M:    Frederic Weisbecker <frederic@kernel.org> (kernel/rcu/tree_nocb.h)
 +M:    Neeraj Upadhyay <quic_neeraju@quicinc.com> (kernel/rcu/tasks.h)
  M:    Josh Triplett <josh@joshtriplett.org>
  R:    Steven Rostedt <rostedt@goodmis.org>
  R:    Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
@@@ -16956,7 -16948,7 +16957,7 @@@ W:   http://www.ibm.com/developerworks/li
  F:    drivers/s390/scsi/zfcp_*
  
  S3C ADC BATTERY DRIVER
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  L:    linux-samsung-soc@vger.kernel.org
  S:    Odd Fixes
  F:    drivers/power/supply/s3c_adc_battery.c
@@@ -17001,7 -16993,7 +17002,7 @@@ F:   Documentation/admin-guide/LSM/SafeSe
  F:    security/safesetid/
  
  SAMSUNG AUDIO (ASoC) DRIVERS
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  M:    Sylwester Nawrocki <s.nawrocki@samsung.com>
  L:    alsa-devel@alsa-project.org (moderated for non-subscribers)
  S:    Supported
@@@ -17009,7 -17001,7 +17010,7 @@@ F:   Documentation/devicetree/bindings/so
  F:    sound/soc/samsung/
  
  SAMSUNG EXYNOS PSEUDO RANDOM NUMBER GENERATOR (RNG) DRIVER
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  L:    linux-crypto@vger.kernel.org
  L:    linux-samsung-soc@vger.kernel.org
  S:    Maintained
@@@ -17044,7 -17036,7 +17045,7 @@@ S:   Maintaine
  F:    drivers/platform/x86/samsung-laptop.c
  
  SAMSUNG MULTIFUNCTION PMIC DEVICE DRIVERS
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  M:    Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
  L:    linux-kernel@vger.kernel.org
  L:    linux-samsung-soc@vger.kernel.org
@@@ -17070,7 -17062,7 +17071,7 @@@ F:   drivers/media/platform/s3c-camif
  F:    include/media/drv-intf/s3c_camif.h
  
  SAMSUNG S3FWRN5 NFC DRIVER
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  M:    Krzysztof Opasiak <k.opasiak@samsung.com>
  L:    linux-nfc@lists.01.org (subscribers-only)
  S:    Maintained
@@@ -17092,7 -17084,7 +17093,7 @@@ S:   Supporte
  F:    drivers/media/i2c/s5k5baf.c
  
  SAMSUNG S5P Security SubSystem (SSS) DRIVER
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  M:    Vladimir Zapolskiy <vz@mleia.com>
  L:    linux-crypto@vger.kernel.org
  L:    linux-samsung-soc@vger.kernel.org
@@@ -17127,7 -17119,7 +17128,7 @@@ F:   include/linux/clk/samsung.
  F:    include/linux/platform_data/clk-s3c2410.h
  
  SAMSUNG SPI DRIVERS
 -M:    Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
 +M:    Krzysztof Kozlowski <krzk@kernel.org>
  M:    Andi Shyti <andi@etezian.org>
  L:    linux-spi@vger.kernel.org
  L:    linux-samsung-soc@vger.kernel.org
@@@ -20647,33 -20639,30 +20648,33 @@@ F:        tools/testing/vsock
  
  VMWARE BALLOON DRIVER
  M:    Nadav Amit <namit@vmware.com>
 -M:    "VMware, Inc." <pv-drivers@vmware.com>
 +R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    linux-kernel@vger.kernel.org
  S:    Maintained
  F:    drivers/misc/vmw_balloon.c
  
  VMWARE HYPERVISOR INTERFACE
 -M:    Deep Shah <sdeep@vmware.com>
 -M:    "VMware, Inc." <pv-drivers@vmware.com>
 +M:    Srivatsa S. Bhat (VMware) <srivatsa@csail.mit.edu>
 +M:    Alexey Makhalov <amakhalov@vmware.com>
 +R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    virtualization@lists.linux-foundation.org
 +L:    x86@kernel.org
  S:    Supported
 +T:    git git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git x86/vmware
  F:    arch/x86/include/asm/vmware.h
  F:    arch/x86/kernel/cpu/vmware.c
  
  VMWARE PVRDMA DRIVER
  M:    Bryan Tan <bryantan@vmware.com>
  M:    Vishnu Dasa <vdasa@vmware.com>
 -M:    VMware PV-Drivers <pv-drivers@vmware.com>
 +R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    linux-rdma@vger.kernel.org
  S:    Maintained
  F:    drivers/infiniband/hw/vmw_pvrdma/
  
  VMware PVSCSI driver
  M:    Vishal Bhakta <vbhakta@vmware.com>
 -M:    VMware PV-Drivers <pv-drivers@vmware.com>
 +R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    linux-scsi@vger.kernel.org
  S:    Maintained
  F:    drivers/scsi/vmw_pvscsi.c
@@@ -20681,7 -20670,7 +20682,7 @@@ F:   drivers/scsi/vmw_pvscsi.
  
  VMWARE VIRTUAL PTP CLOCK DRIVER
  M:    Vivek Thampi <vithampi@vmware.com>
 -M:    "VMware, Inc." <pv-drivers@vmware.com>
 +R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    netdev@vger.kernel.org
  S:    Supported
  F:    drivers/ptp/ptp_vmw.c
  VMWARE VMCI DRIVER
  M:    Jorgen Hansen <jhansen@vmware.com>
  M:    Vishnu Dasa <vdasa@vmware.com>
 +R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    linux-kernel@vger.kernel.org
 -L:    pv-drivers@vmware.com (private)
  S:    Maintained
  F:    drivers/misc/vmw_vmci/
  
  VMWARE VMMOUSE SUBDRIVER
 -M:    "VMware Graphics" <linux-graphics-maintainer@vmware.com>
 -M:    "VMware, Inc." <pv-drivers@vmware.com>
 +M:    Zack Rusin <zackr@vmware.com>
 +R:    VMware Graphics Reviewers <linux-graphics-maintainer@vmware.com>
 +R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    linux-input@vger.kernel.org
  S:    Maintained
  F:    drivers/input/mouse/vmmouse.c
@@@ -20705,7 -20693,7 +20706,7 @@@ F:   drivers/input/mouse/vmmouse.
  
  VMWARE VMXNET3 ETHERNET DRIVER
  M:    Ronak Doshi <doshir@vmware.com>
 -M:    pv-drivers@vmware.com
 +R:    VMware PV-Drivers Reviewers <pv-drivers@vmware.com>
  L:    netdev@vger.kernel.org
  S:    Maintained
  F:    drivers/net/vmxnet3/
@@@ -21481,6 -21469,7 +21482,6 @@@ THE RES
  M:    Linus Torvalds <torvalds@linux-foundation.org>
  L:    linux-kernel@vger.kernel.org
  S:    Buried alive in reporters
 -Q:    http://patchwork.kernel.org/project/LKML/list/
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
  F:    *
  F:    */