Merge tag 'docs-6.4' of git://git.lwn.net/linux
authorLinus Torvalds <torvalds@linux-foundation.org>
Mon, 24 Apr 2023 19:35:49 +0000 (12:35 -0700)
committerLinus Torvalds <torvalds@linux-foundation.org>
Mon, 24 Apr 2023 19:35:49 +0000 (12:35 -0700)
Pull documentation updates from Jonathan Corbet:
 "Commit volume in documentation is relatively low this time, but there
  is still a fair amount going on, including:

   - Reorganize the architecture-specific documentation under
     Documentation/arch

     This makes the structure match the source directory and helps to
     clean up the mess that is the top-level Documentation directory a
     bit. This work creates the new directory and moves x86 and most of
     the less-active architectures there.

     The current plan is to move the rest of the architectures in 6.5,
     with the patches going through the appropriate subsystem trees.

   - Some more Spanish translations and maintenance of the Italian
     translation

   - A new "Kernel contribution maturity model" document from Ted

   - A new tutorial on quickly building a trimmed kernel from Thorsten

  Plus the usual set of updates and fixes"

* tag 'docs-6.4' of git://git.lwn.net/linux: (47 commits)
  media: Adjust column width for pdfdocs
  media: Fix building pdfdocs
  docs: clk: add documentation to log which clocks have been disabled
  docs: trace: Fix typo in ftrace.rst
  Documentation/process: always CC responsible lists
  docs: kmemleak: adjust to config renaming
  ELF: document some de-facto PT_* ABI quirks
  Documentation: arm: remove stih415/stih416 related entries
  docs: turn off "smart quotes" in the HTML build
  Documentation: firmware: Clarify firmware path usage
  docs/mm: Physical Memory: Fix grammar
  Documentation: Add document for false sharing
  dma-api-howto: typo fix
  docs: move m68k architecture documentation under Documentation/arch/
  docs: move parisc documentation under Documentation/arch/
  docs: move ia64 architecture docs under Documentation/arch/
  docs: Move arc architecture docs under Documentation/arch/
  docs: move nios2 documentation under Documentation/arch/
  docs: move openrisc documentation under Documentation/arch/
  docs: move superh documentation under Documentation/arch/
  ...

1  2 
Documentation/admin-guide/index.rst
Documentation/admin-guide/kernel-parameters.rst
Documentation/admin-guide/kernel-parameters.txt
Documentation/process/index.rst
Documentation/process/submitting-patches.rst
Documentation/translations/it_IT/process/submitting-patches.rst
Documentation/virt/kvm/api.rst
MAINTAINERS
arch/x86/Kconfig
security/Kconfig

index 09a563bbe3e775d273c4f020b706004be9cca1c9,7840fdbab585a1cd3a90c0e1f9bc75f366f60aee..43ea35613dfcd464f2d861a5baaa62a4fd0fa18e
@@@ -36,6 -36,8 +36,7 @@@ problems and bugs in particular
  
     reporting-issues
     reporting-regressions
 -   security-bugs
+    quickly-build-trimmed-linux
     bug-hunting
     bug-bisect
     tainted-kernels
index 6ae5f129fbcada17943487a67b0fb53499e92f5d,6385e3b9b8797e5f8a22ff231179a79a2c8ce3e5..1ba8f2a44aacdec188276ffbaa5bc6b5e0bf547f
@@@ -128,11 -128,10 +128,11 @@@ parameter is applicable:
        KVM     Kernel Virtual Machine support is enabled.
        LIBATA  Libata driver is enabled
        LP      Printer support is enabled.
 +      LOONGARCH LoongArch architecture is enabled.
        LOOP    Loopback device support is enabled.
        M68k    M68k architecture is enabled.
                        These options have more detailed description inside of
-                       Documentation/m68k/kernel-options.rst.
+                       Documentation/arch/m68k/kernel-options.rst.
        MDA     MDA console support is enabled.
        MIPS    MIPS architecture is enabled.
        MOUSE   Appropriate mouse support is enabled.
        X86-32  X86-32, aka i386 architecture is enabled.
        X86-64  X86-64 architecture is enabled.
                        More X86-64 boot options can be found in
-                       Documentation/x86/x86_64/boot-options.rst.
+                       Documentation/arch/x86/x86_64/boot-options.rst.
        X86     Either 32-bit or 64-bit x86 (same as X86-32+X86-64)
        X86_UV  SGI UV support is enabled.
        XEN     Xen support is enabled
@@@ -193,10 -192,10 +193,10 @@@ In addition, the following text indicat
  Parameters denoted with BOOT are actually interpreted by the boot
  loader, and have no meaning to the kernel directly.
  Do not modify the syntax of boot loader parameters without extreme
- need or coordination with <Documentation/x86/boot.rst>.
+ need or coordination with <Documentation/arch/x86/boot.rst>.
  
  There are also arch-specific kernel-parameters not documented here.
- See for example <Documentation/x86/x86_64/boot-options.rst>.
+ See for example <Documentation/arch/x86/x86_64/boot-options.rst>.
  
  Note that ALL kernel parameters listed below are CASE SENSITIVE, and that
  a trailing = on the name of any parameter states that that parameter will
index 7016cb12dc4e0b39882f929170dcf50b188b702c,7806742dcec316673621bfdaaa7acd07db798aa8..10e2e5c3ff0bb23c3b6b1ce9f59e41d7aac0ca17
  
        debug_objects   [KNL] Enable object debugging
  
-       no_debug_objects
-                       [KNL] Disable object debugging
        debug_guardpage_minorder=
                        [KNL] When CONFIG_DEBUG_PAGEALLOC is set, this
                        parameter allows control of the order of pages that will
  
        mce             [X86-32] Machine Check Exception
  
-       mce=option      [X86-64] See Documentation/x86/x86_64/boot-options.rst
+       mce=option      [X86-64] See Documentation/arch/x86/x86_64/boot-options.rst
  
        md=             [HW] RAID subsystems devices and level
                        See Documentation/admin-guide/md.rst.
                        deep    - Suspend-To-RAM or equivalent (if supported)
                        See Documentation/admin-guide/pm/sleep-states.rst.
  
-       meye.*=         [HW] Set MotionEye Camera parameters
-                       See Documentation/admin-guide/media/meye.rst.
        mfgpt_irq=      [IA-32] Specify the IRQ to use for the
                        Multi-Function General Purpose Timers on AMD Geode
                        platforms.
                        1 to enable accounting
                        Default value is 0.
  
-       nfsaddrs=       [NFS] Deprecated.  Use ip= instead.
-                       See Documentation/admin-guide/nfs/nfsroot.rst.
-       nfsroot=        [NFS] nfs root filesystem for disk-less boxes.
-                       See Documentation/admin-guide/nfs/nfsroot.rst.
+       nfs.cache_getent=
+                       [NFS] sets the pathname to the program which is used
+                       to update the NFS client cache entries.
  
-       nfsrootdebug    [NFS] enable nfsroot debugging messages.
-                       See Documentation/admin-guide/nfs/nfsroot.rst.
+       nfs.cache_getent_timeout=
+                       [NFS] sets the timeout after which an attempt to
+                       update a cache entry is deemed to have failed.
  
        nfs.callback_nr_threads=
                        [NFSv4] set the total number of threads that the
                        [NFS] set the TCP port on which the NFSv4 callback
                        channel should listen.
  
-       nfs.cache_getent=
-                       [NFS] sets the pathname to the program which is used
-                       to update the NFS client cache entries.
-       nfs.cache_getent_timeout=
-                       [NFS] sets the timeout after which an attempt to
-                       update a cache entry is deemed to have failed.
-       nfs.idmap_cache_timeout=
-                       [NFS] set the maximum lifetime for idmapper cache
-                       entries.
        nfs.enable_ino64=
                        [NFS] enable 64-bit inode numbers.
                        If zero, the NFS client will fake up a 32-bit inode
                        of returning the full 64-bit number.
                        The default is to return 64-bit inode numbers.
  
+       nfs.idmap_cache_timeout=
+                       [NFS] set the maximum lifetime for idmapper cache
+                       entries.
        nfs.max_session_cb_slots=
                        [NFSv4.1] Sets the maximum number of session
                        slots the client will assign to the callback
                        will be autodetected by the client, and it will fall
                        back to using the idmapper.
                        To turn off this behaviour, set the value to '0'.
        nfs.nfs4_unique_id=
                        [NFS4] Specify an additional fixed unique ident-
                        ification string that NFSv4 clients can insert into
                        their nfs_client_id4 string.  This is typically a
                        UUID that is generated at system install time.
  
-       nfs.send_implementation_id =
-                       [NFSv4.1] Send client implementation identification
-                       information in exchange_id requests.
-                       If zero, no implementation identification information
-                       will be sent.
-                       The default is to send the implementation identification
-                       information.
-       nfs.recover_lost_locks =
+       nfs.recover_lost_locks=
                        [NFSv4] Attempt to recover locks that were lost due
                        to a lease timeout on the server. Please note that
                        doing this risks data corruption, since there are
                        The default parameter value of '0' causes the kernel
                        not to attempt recovery of lost locks.
  
-       nfs4.layoutstats_timer =
+       nfs.send_implementation_id=
+                       [NFSv4.1] Send client implementation identification
+                       information in exchange_id requests.
+                       If zero, no implementation identification information
+                       will be sent.
+                       The default is to send the implementation identification
+                       information.
+       nfs4.layoutstats_timer=
                        [NFSv4.2] Change the rate at which the kernel sends
                        layoutstats to the pNFS metadata server.
  
                        driver. A non-zero value sets the minimum interval
                        in seconds between layoutstats transmissions.
  
-       nfsd.inter_copy_offload_enable =
+       nfsd.inter_copy_offload_enable=
                        [NFSv4.2] When set to 1, the server will support
                        server-to-server copies for which this server is
                        the destination of the copy.
  
-       nfsd.nfsd4_ssc_umount_timeout =
+       nfsd.nfs4_disable_idmapping=
+                       [NFSv4] When set to the default of '1', the NFSv4
+                       server will return only numeric uids and gids to
+                       clients using auth_sys, and will accept numeric uids
+                       and gids from such clients.  This is intended to ease
+                       migration from NFSv2/v3.
+       nfsd.nfsd4_ssc_umount_timeout=
                        [NFSv4.2] When used as the destination of a
                        server-to-server copy, knfsd temporarily mounts
                        the source server.  It caches the mount in case
                        used for the number of milliseconds specified by
                        this parameter.
  
-       nfsd.nfs4_disable_idmapping=
-                       [NFSv4] When set to the default of '1', the NFSv4
-                       server will return only numeric uids and gids to
-                       clients using auth_sys, and will accept numeric uids
-                       and gids from such clients.  This is intended to ease
-                       migration from NFSv2/v3.
+       nfsaddrs=       [NFS] Deprecated.  Use ip= instead.
+                       See Documentation/admin-guide/nfs/nfsroot.rst.
+       nfsroot=        [NFS] nfs root filesystem for disk-less boxes.
+                       See Documentation/admin-guide/nfs/nfsroot.rst.
  
+       nfsrootdebug    [NFS] enable nfsroot debugging messages.
+                       See Documentation/admin-guide/nfs/nfsroot.rst.
  
        nmi_backtrace.backtrace_idle [KNL]
                        Dump stacks even of idle CPUs in response to an
        no5lvl          [X86-64] Disable 5-level paging mode. Forces
                        kernel to use 4-level paging instead.
  
-       nofsgsbase      [X86] Disables FSGSBASE instructions.
+       noaliencache    [MM, NUMA, SLAB] Disables the allocation of alien
+                       caches in the slab allocator.  Saves per-node memory,
+                       but will impact performance.
+       noalign         [KNL,ARM]
+       noaltinstr      [S390] Disables alternative instructions patching
+                       (CPU alternatives feature).
+       noapic          [SMP,APIC] Tells the kernel to not make use of any
+                       IOAPICs that may be present in the system.
+       noautogroup     Disable scheduler automatic task group creation.
+       nocache         [ARM]
  
        no_console_suspend
                        [HW] Never suspend the console
                        /sys/module/printk/parameters/console_suspend) to
                        turn on/off it dynamically.
  
-       novmcoredd      [KNL,KDUMP]
-                       Disable device dump. Device dump allows drivers to
-                       append dump data to vmcore so you can collect driver
-                       specified debug info.  Drivers can append the data
-                       without any limit and this data is stored in memory,
-                       so this may cause significant memory stress.  Disabling
-                       device dump can help save memory but the driver debug
-                       data will be no longer available.  This parameter
-                       is only available when CONFIG_PROC_VMCORE_DEVICE_DUMP
-                       is set.
-       noaliencache    [MM, NUMA, SLAB] Disables the allocation of alien
-                       caches in the slab allocator.  Saves per-node memory,
-                       but will impact performance.
-       noalign         [KNL,ARM]
-       noaltinstr      [S390] Disables alternative instructions patching
-                       (CPU alternatives feature).
-       noapic          [SMP,APIC] Tells the kernel to not make use of any
-                       IOAPICs that may be present in the system.
-       noautogroup     Disable scheduler automatic task group creation.
-       nocache         [ARM]
+       no_debug_objects
+                       [KNL] Disable object debugging
  
        nodsp           [SH] Disable hardware DSP at boot time.
  
  
        noexec          [IA-64]
  
-       nosmap          [PPC]
-                       Disable SMAP (Supervisor Mode Access Prevention)
-                       even if it is supported by processor.
-       nosmep          [PPC64s]
-                       Disable SMEP (Supervisor Mode Execution Prevention)
-                       even if it is supported by processor.
        noexec32        [X86-64]
                        This affects only 32-bit executables.
                        noexec32=on: enable non-executable mappings (default)
                        noexec32=off: disable non-executable mappings
                                read implies executable mappings
  
+       no_file_caps    Tells the kernel not to honor file capabilities.  The
+                       only way then for a file to be executed with privilege
+                       is to be setuid root or executed by root.
        nofpu           [MIPS,SH] Disable hardware FPU at boot time.
  
+       nofsgsbase      [X86] Disables FSGSBASE instructions.
        nofxsr          [BUGS=X86-32] Disables x86 floating point extended
                        register save and restore. The kernel will only save
                        legacy floating-point registers on task switch.
  
-       nohugeiomap     [KNL,X86,PPC,ARM64] Disable kernel huge I/O mappings.
-       nohugevmalloc   [KNL,X86,PPC,ARM64] Disable kernel huge vmalloc mappings.
-       nosmt           [KNL,S390] Disable symmetric multithreading (SMT).
-                       Equivalent to smt=1.
-                       [KNL,X86] Disable symmetric multithreading (SMT).
-                       nosmt=force: Force disable SMT, cannot be undone
-                                    via the sysfs control file.
-       nospectre_v1    [X86,PPC] Disable mitigations for Spectre Variant 1
-                       (bounds check bypass). With this option data leaks are
-                       possible in the system.
-       nospectre_v2    [X86,PPC_E500,ARM64] Disable all mitigations for
-                       the Spectre variant 2 (indirect branch prediction)
-                       vulnerability. System may allow data leaks with this
-                       option.
-       nospectre_bhb   [ARM64] Disable all mitigations for Spectre-BHB (branch
-                       history injection) vulnerability. System may allow data leaks
-                       with this option.
-       nospec_store_bypass_disable
-                       [HW] Disable all mitigations for the Speculative Store Bypass vulnerability
-       no_uaccess_flush
-                       [PPC] Don't flush the L1-D cache after accessing user data.
-       noxsave         [BUGS=X86] Disables x86 extended register state save
-                       and restore using xsave. The kernel will fallback to
-                       enabling legacy floating-point and sse state.
-       noxsaveopt      [X86] Disables xsaveopt used in saving x86 extended
-                       register states. The kernel will fall back to use
-                       xsave to save the states. By using this parameter,
-                       performance of saving the states is degraded because
-                       xsave doesn't support modified optimization while
-                       xsaveopt supports it on xsaveopt enabled systems.
-       noxsaves        [X86] Disables xsaves and xrstors used in saving and
-                       restoring x86 extended register state in compacted
-                       form of xsave area. The kernel will fall back to use
-                       xsaveopt and xrstor to save and restore the states
-                       in standard form of xsave area. By using this
-                       parameter, xsave area per process might occupy more
-                       memory on xsaves enabled systems.
-       nohlt           [ARM,ARM64,MICROBLAZE,SH] Forces the kernel to busy wait
-                       in do_idle() and not use the arch_cpu_idle()
-                       implementation; requires CONFIG_GENERIC_IDLE_POLL_SETUP
-                       to be effective. This is useful on platforms where the
-                       sleep(SH) or wfi(ARM,ARM64) instructions do not work
-                       correctly or when doing power measurements to evaluate
-                       the impact of the sleep instructions. This is also
-                       useful when using JTAG debugger.
-       no_file_caps    Tells the kernel not to honor file capabilities.  The
-                       only way then for a file to be executed with privilege
-                       is to be setuid root or executed by root.
        nohalt          [IA-64] Tells the kernel not to use the power saving
                        function PAL_HALT_LIGHT when idle. This increases
                        power-consumption. On the positive side, it reduces
  
        nohibernate     [HIBERNATION] Disable hibernation and resume.
  
+       nohlt           [ARM,ARM64,MICROBLAZE,SH] Forces the kernel to busy wait
+                       in do_idle() and not use the arch_cpu_idle()
+                       implementation; requires CONFIG_GENERIC_IDLE_POLL_SETUP
+                       to be effective. This is useful on platforms where the
+                       sleep(SH) or wfi(ARM,ARM64) instructions do not work
+                       correctly or when doing power measurements to evaluate
+                       the impact of the sleep instructions. This is also
+                       useful when using JTAG debugger.
+       nohugeiomap     [KNL,X86,PPC,ARM64] Disable kernel huge I/O mappings.
+       nohugevmalloc   [KNL,X86,PPC,ARM64] Disable kernel huge vmalloc mappings.
        nohz=           [KNL] Boottime enable/disable dynamic ticks
                        Valid arguments: on, off
                        Default: on
                        Note that this argument takes precedence over
                        the CONFIG_RCU_NOCB_CPU_DEFAULT_ALL option.
  
-       noiotrap        [SH] Disables trapped I/O port accesses.
-       noirqdebug      [X86-32] Disables the code which attempts to detect and
-                       disable unhandled interrupt sources.
-       no_timer_check  [X86,APIC] Disables the code which tests for
-                       broken timer IRQ sources.
-       noisapnp        [ISAPNP] Disables ISA PnP code.
        noinitrd        [RAM] Tells the kernel not to load any configured
                        initial RAM disk.
  
  
        noinvpcid       [X86] Disable the INVPCID cpu feature.
  
+       noiotrap        [SH] Disables trapped I/O port accesses.
+       noirqdebug      [X86-32] Disables the code which attempts to detect and
+                       disable unhandled interrupt sources.
+       noisapnp        [ISAPNP] Disables ISA PnP code.
        nojitter        [IA-64] Disables jitter checking for ITC timers.
  
        nokaslr         [KNL]
                        kernel and module base offset ASLR (Address Space
                        Layout Randomization).
  
-       no-kvmclock     [X86,KVM] Disable paravirtualized KVM clock driver
        no-kvmapf       [X86,KVM] Disable paravirtualized asynchronous page
                        fault handling.
  
-       no-vmw-sched-clock
-                       [X86,PV_OPS] Disable paravirtualized VMware scheduler
-                       clock and use the default one.
-       no-steal-acc    [X86,PV_OPS,ARM64,PPC/PSERIES] Disable paravirtualized
-                       steal time accounting. steal time is computed, but
-                       won't influence scheduler behaviour
+       no-kvmclock     [X86,KVM] Disable paravirtualized KVM clock driver
  
        nolapic         [X86-32,APIC] Do not enable or use the local APIC.
  
        nomfgpt         [X86-32] Disable Multi-Function General Purpose
                        Timer usage (for AMD Geode machines).
  
-       nonmi_ipi       [X86] Disable using NMI IPIs during panic/reboot to
-                       shutdown the other cpus.  Instead use the REBOOT_VECTOR
-                       irq.
        nomodeset       Disable kernel modesetting. Most systems' firmware
                        sets up a display mode and provides framebuffer memory
                        for output. With nomodeset, DRM and fbdev drivers will
  
        nomodule        Disable module load
  
+       nonmi_ipi       [X86] Disable using NMI IPIs during panic/reboot to
+                       shutdown the other cpus.  Instead use the REBOOT_VECTOR
+                       irq.
        nopat           [X86] Disable PAT (page attribute table extension of
                        pagetables) support.
  
        nopku           [X86] Disable Memory Protection Keys CPU feature found
                        in some Intel CPUs.
  
+       nopti           [X86-64]
+                       Equivalent to pti=off
        nopv=           [X86,XEN,KVM,HYPER_V,VMWARE]
                        Disables the PV optimizations forcing the guest to run
                        as generic guest with no PV drivers. Currently support
        noresume        [SWSUSP] Disables resume and restores original swap
                        space.
  
+       nosbagart       [IA-64]
        no-scroll       [VGA] Disables scrollback.
                        This is required for the Braillex ib80-piezo Braille
                        reader made by F.H. Papenmeier (Germany).
  
-       nosbagart       [IA-64]
        nosgx           [X86-64,SGX] Disables Intel SGX kernel support.
  
+       nosmap          [PPC]
+                       Disable SMAP (Supervisor Mode Access Prevention)
+                       even if it is supported by processor.
+       nosmep          [PPC64s]
+                       Disable SMEP (Supervisor Mode Execution Prevention)
+                       even if it is supported by processor.
        nosmp           [SMP] Tells an SMP kernel to act as a UP kernel,
                        and disable the IO APIC.  legacy for "maxcpus=0".
  
+       nosmt           [KNL,S390] Disable symmetric multithreading (SMT).
+                       Equivalent to smt=1.
+                       [KNL,X86] Disable symmetric multithreading (SMT).
+                       nosmt=force: Force disable SMT, cannot be undone
+                                    via the sysfs control file.
        nosoftlockup    [KNL] Disable the soft-lockup detector.
  
+       nospec_store_bypass_disable
+                       [HW] Disable all mitigations for the Speculative Store Bypass vulnerability
+       nospectre_bhb   [ARM64] Disable all mitigations for Spectre-BHB (branch
+                       history injection) vulnerability. System may allow data leaks
+                       with this option.
+       nospectre_v1    [X86,PPC] Disable mitigations for Spectre Variant 1
+                       (bounds check bypass). With this option data leaks are
+                       possible in the system.
+       nospectre_v2    [X86,PPC_E500,ARM64] Disable all mitigations for
+                       the Spectre variant 2 (indirect branch prediction)
+                       vulnerability. System may allow data leaks with this
+                       option.
+       no-steal-acc    [X86,PV_OPS,ARM64,PPC/PSERIES] Disable paravirtualized
+                       steal time accounting. steal time is computed, but
+                       won't influence scheduler behaviour
        nosync          [HW,M68K] Disables sync negotiation for all devices.
  
+       no_timer_check  [X86,APIC] Disables the code which tests for
+                       broken timer IRQ sources.
+       no_uaccess_flush
+                       [PPC] Don't flush the L1-D cache after accessing user data.
+       novmcoredd      [KNL,KDUMP]
+                       Disable device dump. Device dump allows drivers to
+                       append dump data to vmcore so you can collect driver
+                       specified debug info.  Drivers can append the data
+                       without any limit and this data is stored in memory,
+                       so this may cause significant memory stress.  Disabling
+                       device dump can help save memory but the driver debug
+                       data will be no longer available.  This parameter
+                       is only available when CONFIG_PROC_VMCORE_DEVICE_DUMP
+                       is set.
+       no-vmw-sched-clock
+                       [X86,PV_OPS] Disable paravirtualized VMware scheduler
+                       clock and use the default one.
        nowatchdog      [KNL] Disable both lockup detectors, i.e.
                        soft-lockup and NMI watchdog (hard-lockup).
  
                        LEGACY_XAPIC_DISABLED bit set in the
                        IA32_XAPIC_DISABLE_STATUS MSR.
  
+       noxsave         [BUGS=X86] Disables x86 extended register state save
+                       and restore using xsave. The kernel will fallback to
+                       enabling legacy floating-point and sse state.
+       noxsaveopt      [X86] Disables xsaveopt used in saving x86 extended
+                       register states. The kernel will fall back to use
+                       xsave to save the states. By using this parameter,
+                       performance of saving the states is degraded because
+                       xsave doesn't support modified optimization while
+                       xsaveopt supports it on xsaveopt enabled systems.
+       noxsaves        [X86] Disables xsaves and xrstors used in saving and
+                       restoring x86 extended register state in compacted
+                       form of xsave area. The kernel will fall back to use
+                       xsaveopt and xrstor to save and restore the states
+                       in standard form of xsave area. By using this
+                       parameter, xsave area per process might occupy more
+                       memory on xsaves enabled systems.
        nps_mtm_hs_ctr= [KNL,ARC]
                        This parameter sets the maximum duration, in
                        cycles, each HW thread of the CTOP can run
                        and performance comparison.
  
        pirq=           [SMP,APIC] Manual mp-table setup
-                       See Documentation/x86/i386/IO-APIC.rst.
+                       See Documentation/arch/x86/i386/IO-APIC.rst.
  
        plip=           [PPT,NET] Parallel port network link
                        Format: { parport<nr> | timid | 0 }
  
                        Not specifying this option is equivalent to pti=auto.
  
-       nopti           [X86-64]
-                       Equivalent to pti=off
        pty.legacy_count=
                        [KNL] Number of legacy pty's. Overwrites compiled-in
                        default number.
  
        serialnumber    [BUGS=X86-32]
  
-       sev=option[,option...] [X86-64] See Documentation/x86/x86_64/boot-options.rst
+       sev=option[,option...] [X86-64] See Documentation/arch/x86/x86_64/boot-options.rst
  
        shapers=        [NET]
                        Maximal number of shapers.
                        Can be used multiple times for multiple devices.
  
        vga=            [BOOT,X86-32] Select a particular video mode
-                       See Documentation/x86/boot.rst and
+                       See Documentation/arch/x86/boot.rst and
                        Documentation/admin-guide/svga.rst.
                        Use vga=ask for menu.
                        This is actually a boot loader parameter; the value is
                        When enabled, memory and cache locality will be
                        impacted.
  
 +      writecombine=   [LOONGARCH] Control the MAT (Memory Access Type) of
 +                      ioremap_wc().
 +
 +                      on   - Enable writecombine, use WUC for ioremap_wc()
 +                      off  - Disable writecombine, use SUC for ioremap_wc()
 +
        x2apic_phys     [X86-64,APIC] Use x2apic physical mode instead of
                        default x2apic cluster mode on platforms
                        supporting x2apic.
index 565df595152e1684f97c6bfe07d679b529b4f000,33715da7e6843cbcef72518f3eda1c69df47acfc..b501cd977053fa37c765e8a33541a8613ebddab7
@@@ -35,14 -35,6 +35,14 @@@ Below are the essential guides that eve
     kernel-enforcement-statement
     kernel-driver-statement
  
 +For security issues, see:
 +
 +.. toctree::
 +   :maxdepth: 1
 +
 +   security-bugs
 +   embargoed-hardware-issues
 +
  Other guides to the community that are of interest to most developers are:
  
  .. toctree::
     submit-checklist
     kernel-docs
     deprecated
 -   embargoed-hardware-issues
     maintainers
     researcher-guidelines
+    contribution-maturity-model
  
  These are some overall technical guides that have been put here for now for
  lack of a better place.
index 828997bc9ff980a2123eddbdbed38f7308366072,b7e345b93081af2080540f725d382fbeec58f44b..7a5619fecb384e442d7f020a43e97a8d42759939
@@@ -223,20 -223,17 +223,17 @@@ patch
  Select the recipients for your patch
  ------------------------------------
  
- You should always copy the appropriate subsystem maintainer(s) on any patch
- to code that they maintain; look through the MAINTAINERS file and the
- source code revision history to see who those maintainers are.  The
- script scripts/get_maintainer.pl can be very useful at this step (pass paths to
your patches as arguments to scripts/get_maintainer.pl).  If you cannot find a
+ You should always copy the appropriate subsystem maintainer(s) and list(s) on
any patch to code that they maintain; look through the MAINTAINERS file and the
+ source code revision history to see who those maintainers are.  The script
+ scripts/get_maintainer.pl can be very useful at this step (pass paths to your
+ patches as arguments to scripts/get_maintainer.pl).  If you cannot find a
  maintainer for the subsystem you are working on, Andrew Morton
  (akpm@linux-foundation.org) serves as a maintainer of last resort.
  
- You should also normally choose at least one mailing list to receive a copy
- of your patch set.  linux-kernel@vger.kernel.org should be used by default
- for all patches, but the volume on that list has caused a number of
- developers to tune it out.  Look in the MAINTAINERS file for a
- subsystem-specific list; your patch will probably get more attention there.
- Please do not spam unrelated lists, though.
+ linux-kernel@vger.kernel.org should be used by default for all patches, but the
+ volume on that list has caused a number of developers to tune it out.  Please
+ do not spam unrelated lists and unrelated people, though.
  
  Many kernel-related lists are hosted on vger.kernel.org; you can find a
  list of them at http://vger.kernel.org/vger-lists.html.  There are
@@@ -254,7 -251,7 +251,7 @@@ If you have a patch that fixes an explo
  to security@kernel.org.  For severe bugs, a short embargo may be considered
  to allow distributors to get the patch out to users; in such cases,
  obviously, the patch should not be sent to any public lists. See also
 -Documentation/admin-guide/security-bugs.rst.
 +Documentation/process/security-bugs.rst.
  
  Patches that fix a severe bug in a released kernel should be directed
  toward the stable maintainers by putting a line like this::
index 167fce813032c0b6065621543accc0a11153d142,5131a3963e7e4e70453584a5df0030ea31a97746..447b18792e61a29ab9ed3faa362adbab70eebf18
@@@ -272,7 -272,7 +272,7 @@@ embargo potrebbe essere preso in consid
  distribuzioni di prendere la patch e renderla disponibile ai loro utenti;
  in questo caso, ovviamente, la patch non dovrebbe essere inviata su alcuna
  lista di discussione pubblica. Leggete anche
 -Documentation/admin-guide/security-bugs.rst.
 +Documentation/process/security-bugs.rst.
  
  Patch che correggono bachi importanti su un kernel già rilasciato, dovrebbero
  essere inviate ai manutentori dei kernel stabili aggiungendo la seguente riga::
@@@ -429,7 -429,7 +429,7 @@@ poi dovete solo aggiungere una riga ch
  
        Signed-off-by: Random J Developer <random@developer.example.org>
  
- usando il vostro vero nome (spiacenti, non si accettano pseudonimi o
+ usando il vostro vero nome (spiacenti, non si accettano
  contributi anonimi). Questo verrà fatto automaticamente se usate
  ``git commit -s``. Anche il ripristino di uno stato precedente dovrebbe
  includere "Signed-off-by", se usate ``git revert -s`` questo verrà
@@@ -785,7 -785,7 +785,7 @@@ Riferiment
  -----------
  
  Andrew Morton, "La patch perfetta" (tpp).
-   <http://www.ozlabs.org/~akpm/stuff/tpp.txt>
+   <https://www.ozlabs.org/~akpm/stuff/tpp.txt>
  
  Jeff Garzik, "Formato per la sottomissione di patch per il kernel Linux"
    <https://web.archive.org/web/20180829112450/http://linux.yyz.us/patch-format.html>
index a5c803f3983238f58ff672cc215745df82a985fd,53623e84c20e4d61702575de848ca95797ff5ca0..841e9d1987bde6f5132306cbe54722634b296433
@@@ -7456,7 -7456,7 +7456,7 @@@ system fingerprint.  To prevent userspa
  by running an enclave in a VM, KVM prevents access to privileged attributes by
  default.
  
- See Documentation/x86/sgx.rst for more details.
+ See Documentation/arch/x86/sgx.rst for more details.
  
  7.26 KVM_CAP_PPC_RPT_INVALIDATE
  -------------------------------
@@@ -8296,11 -8296,11 +8296,11 @@@ ENOSYS for the others
  8.35 KVM_CAP_PMU_CAPABILITY
  ---------------------------
  
 -:Capability KVM_CAP_PMU_CAPABILITY
 +:Capability: KVM_CAP_PMU_CAPABILITY
  :Architectures: x86
  :Type: vm
  :Parameters: arg[0] is bitmask of PMU virtualization capabilities.
 -:Returns 0 on success, -EINVAL when arg[0] contains invalid bits
 +:Returns: 0 on success, -EINVAL when arg[0] contains invalid bits
  
  This capability alters PMU virtualization in KVM.
  
diff --combined MAINTAINERS
index d172ca02a1d55f2a77aa59caa75f54ed9062867d,02720bc91481b485a9a5b427b9da0730db622d87..4ae3bb24af1fb85f850fb1f0ebc8940ea02d0b84
@@@ -73,7 -73,7 +73,7 @@@ Tips for patch submitter
        and ideally, should come with a patch proposal. Please do not send
        automated reports to this list either. Such bugs will be handled
        better and faster in the usual public places. See
 -      Documentation/admin-guide/security-bugs.rst for details.
 +      Documentation/process/security-bugs.rst for details.
  
  8.    Happy hacking.
  
@@@ -224,13 -224,13 +224,13 @@@ S:      Orphan / Obsolet
  F:    drivers/net/ethernet/8390/
  
  9P FILE SYSTEM
 -M:    Eric Van Hensbergen <ericvh@gmail.com>
 +M:    Eric Van Hensbergen <ericvh@kernel.org>
  M:    Latchesar Ionkov <lucho@ionkov.net>
  M:    Dominique Martinet <asmadeus@codewreck.org>
  R:    Christian Schoenebeck <linux_oss@crudebyte.com>
 -L:    v9fs-developer@lists.sourceforge.net
 +L:    v9fs@lists.linux.dev
  S:    Maintained
 -W:    http://swik.net/v9fs
 +W:    http://github.com/v9fs
  Q:    http://patchwork.kernel.org/project/v9fs-devel/list/
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/ericvh/v9fs.git
  T:    git git://github.com/martinetd/linux.git
@@@ -1071,7 -1071,7 +1071,7 @@@ M:      Naveen Krishna Chatradhi <naveenkris
  R:    Carlos Bilbao <carlos.bilbao@amd.com>
  L:    platform-driver-x86@vger.kernel.org
  S:    Maintained
- F:    Documentation/x86/amd_hsmp.rst
+ F:    Documentation/arch/x86/amd_hsmp.rst
  F:    arch/x86/include/asm/amd_hsmp.h
  F:    arch/x86/include/uapi/asm/amd_hsmp.h
  F:    drivers/platform/x86/amd/hsmp.c
@@@ -4461,14 -4461,14 +4461,14 @@@ F:   Documentation/devicetree/bindings/ne
  F:    drivers/net/ieee802154/ca8210.c
  
  CANAAN/KENDRYTE K210 SOC FPIOA DRIVER
 -M:    Damien Le Moal <damien.lemoal@wdc.com>
 +M:    Damien Le Moal <dlemoal@kernel.org>
  L:    linux-riscv@lists.infradead.org
  L:    linux-gpio@vger.kernel.org (pinctrl driver)
  F:    Documentation/devicetree/bindings/pinctrl/canaan,k210-fpioa.yaml
  F:    drivers/pinctrl/pinctrl-k210.c
  
  CANAAN/KENDRYTE K210 SOC RESET CONTROLLER DRIVER
 -M:    Damien Le Moal <damien.lemoal@wdc.com>
 +M:    Damien Le Moal <dlemoal@kernel.org>
  L:    linux-kernel@vger.kernel.org
  L:    linux-riscv@lists.infradead.org
  S:    Maintained
@@@ -4476,7 -4476,7 +4476,7 @@@ F:      Documentation/devicetree/bindings/re
  F:    drivers/reset/reset-k210.c
  
  CANAAN/KENDRYTE K210 SOC SYSTEM CONTROLLER DRIVER
 -M:    Damien Le Moal <damien.lemoal@wdc.com>
 +M:    Damien Le Moal <dlemoal@kernel.org>
  L:    linux-riscv@lists.infradead.org
  S:    Maintained
  F:      Documentation/devicetree/bindings/mfd/canaan,k210-sysctl.yaml
@@@ -5940,11 -5940,6 +5940,6 @@@ F:     drivers/devfreq/event
  F:    include/dt-bindings/pmu/exynos_ppmu.h
  F:    include/linux/devfreq-event.h
  
- DEVICE NUMBER REGISTRY
- M:    Torben Mathiasen <device@lanana.org>
- S:    Maintained
- W:    http://lanana.org/docs/device-list/index.html
  DEVICE RESOURCE MANAGEMENT HELPERS
  M:    Hans de Goede <hdegoede@redhat.com>
  R:    Matti Vaittinen <mazziesaccount@gmail.com>
@@@ -5971,7 -5966,7 +5966,7 @@@ F:      include/linux/dm-*.
  F:    include/uapi/linux/dm-*.h
  
  DEVLINK
 -M:    Jiri Pirko <jiri@nvidia.com>
 +M:    Jiri Pirko <jiri@resnulli.us>
  L:    netdev@vger.kernel.org
  S:    Supported
  F:    Documentation/networking/devlink
@@@ -6207,6 -6202,7 +6202,7 @@@ DOCUMENTATION REPORTING ISSUE
  M:    Thorsten Leemhuis <linux@leemhuis.info>
  L:    linux-doc@vger.kernel.org
  S:    Maintained
+ F:    Documentation/admin-guide/quickly-build-trimmed-linux.rst
  F:    Documentation/admin-guide/reporting-issues.rst
  
  DOCUMENTATION SCRIPTS
@@@ -8216,7 -8212,6 +8212,7 @@@ F:      drivers/net/ethernet/freescale/dpa
  
  FREESCALE QORIQ DPAA FMAN DRIVER
  M:    Madalin Bucur <madalin.bucur@nxp.com>
 +R:    Sean Anderson <sean.anderson@seco.com>
  L:    netdev@vger.kernel.org
  S:    Maintained
  F:    Documentation/devicetree/bindings/net/fsl-fman.txt
@@@ -9729,7 -9724,7 +9725,7 @@@ F:      include/linux/i3c
  IA64 (Itanium) PLATFORM
  L:    linux-ia64@vger.kernel.org
  S:    Orphan
- F:    Documentation/ia64/
+ F:    Documentation/arch/ia64/
  F:    arch/ia64/
  
  IBM Operation Panel Input Driver
@@@ -9872,10 -9867,10 +9868,10 @@@ M:   Christian Brauner <brauner@kernel.or
  M:    Seth Forshee <sforshee@kernel.org>
  L:    linux-fsdevel@vger.kernel.org
  S:    Maintained
 -T:    git://git.kernel.org/pub/scm/linux/kernel/git/vfs/idmapping.git
 +T:    git git://git.kernel.org/pub/scm/linux/kernel/git/vfs/idmapping.git
  F:    Documentation/filesystems/idmappings.rst
 -F:    tools/testing/selftests/mount_setattr/
  F:    include/linux/mnt_idmapping.*
 +F:    tools/testing/selftests/mount_setattr/
  
  IDT VersaClock 5 CLOCK DRIVER
  M:    Luca Ceresoli <luca@lucaceresoli.net>
@@@ -10648,7 -10643,7 +10644,7 @@@ L:   tboot-devel@lists.sourceforge.ne
  S:    Supported
  W:    http://tboot.sourceforge.net
  T:    hg http://tboot.hg.sourceforge.net:8000/hgroot/tboot/tboot
- F:    Documentation/x86/intel_txt.rst
+ F:    Documentation/arch/x86/intel_txt.rst
  F:    arch/x86/kernel/tboot.c
  F:    include/linux/tboot.h
  
@@@ -10659,7 -10654,7 +10655,7 @@@ L:   linux-sgx@vger.kernel.or
  S:    Supported
  Q:    https://patchwork.kernel.org/project/intel-sgx/list/
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git x86/sgx
- F:    Documentation/x86/sgx.rst
+ F:    Documentation/arch/x86/sgx.rst
  F:    arch/x86/entry/vdso/vsgx.S
  F:    arch/x86/include/asm/sgx.h
  F:    arch/x86/include/uapi/asm/sgx.h
@@@ -11758,7 -11753,7 +11754,7 @@@ T:   git git://git.kernel.org/pub/scm/lin
  F:    drivers/ata/sata_promise.*
  
  LIBATA SUBSYSTEM (Serial and Parallel ATA drivers)
 -M:    Damien Le Moal <damien.lemoal@opensource.wdc.com>
 +M:    Damien Le Moal <dlemoal@kernel.org>
  L:    linux-ide@vger.kernel.org
  S:    Maintained
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/dlemoal/libata.git
@@@ -14594,7 -14589,6 +14590,7 @@@ F:   net/netlabel
  
  NETWORKING [MPTCP]
  M:    Matthieu Baerts <matthieu.baerts@tessares.net>
 +M:    Mat Martineau <martineau@kernel.org>
  L:    netdev@vger.kernel.org
  L:    mptcp@lists.linux.dev
  S:    Maintained
@@@ -14658,8 -14652,10 +14654,8 @@@ F:  net/ipv4/nexthop.
  
  NFC SUBSYSTEM
  M:    Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
 -L:    linux-nfc@lists.01.org (subscribers-only)
  L:    netdev@vger.kernel.org
  S:    Maintained
 -B:    mailto:linux-nfc@lists.01.org
  F:    Documentation/devicetree/bindings/net/nfc/
  F:    drivers/nfc/
  F:    include/linux/platform_data/nfcmrvl.h
@@@ -14670,6 -14666,7 +14666,6 @@@ F:   net/nfc
  NFC VIRTUAL NCI DEVICE DRIVER
  M:    Bongsu Jeon <bongsu.jeon@samsung.com>
  L:    netdev@vger.kernel.org
 -L:    linux-nfc@lists.01.org (subscribers-only)
  S:    Supported
  F:    drivers/nfc/virtual_ncidev.c
  F:    tools/testing/selftests/nci/
@@@ -14871,12 -14868,12 +14867,12 @@@ M:        Sagi Grimberg <sagi@grimberg.me
  L:    linux-nvme@lists.infradead.org
  S:    Supported
  W:    http://git.infradead.org/nvme.git
 -T:    git://git.infradead.org/nvme.git
 +T:    git git://git.infradead.org/nvme.git
  F:    Documentation/nvme/
 -F:    drivers/nvme/host/
  F:    drivers/nvme/common/
 -F:    include/linux/nvme.h
 +F:    drivers/nvme/host/
  F:    include/linux/nvme-*.h
 +F:    include/linux/nvme.h
  F:    include/uapi/linux/nvme_ioctl.h
  
  NVM EXPRESS FABRICS AUTHENTICATION
@@@ -14911,7 -14908,7 +14907,7 @@@ M:   Chaitanya Kulkarni <kch@nvidia.com
  L:    linux-nvme@lists.infradead.org
  S:    Supported
  W:    http://git.infradead.org/nvme.git
 -T:    git://git.infradead.org/nvme.git
 +T:    git git://git.infradead.org/nvme.git
  F:    drivers/nvme/target/
  
  NVMEM FRAMEWORK
@@@ -15041,6 -15038,7 +15037,6 @@@ F:   Documentation/devicetree/bindings/so
  F:    sound/soc/codecs/tfa989x.c
  
  NXP-NCI NFC DRIVER
 -L:    linux-nfc@lists.01.org (subscribers-only)
  S:    Orphan
  F:    Documentation/devicetree/bindings/net/nfc/nxp,nci.yaml
  F:    drivers/nfc/nxp-nci
@@@ -15077,7 -15075,7 +15073,7 @@@ F:   Documentation/hwmon/nzxt-smart2.rs
  F:    drivers/hwmon/nzxt-smart2.c
  
  OBJAGG
 -M:    Jiri Pirko <jiri@nvidia.com>
 +M:    Jiri Pirko <jiri@resnulli.us>
  L:    netdev@vger.kernel.org
  S:    Supported
  F:    include/linux/objagg.h
@@@ -15640,7 -15638,7 +15636,7 @@@ S:   Maintaine
  W:    http://openrisc.io
  T:    git https://github.com/openrisc/linux.git
  F:    Documentation/devicetree/bindings/openrisc/
- F:    Documentation/openrisc/
+ F:    Documentation/arch/openrisc/
  F:    arch/openrisc/
  F:    drivers/irqchip/irq-ompic.c
  F:    drivers/irqchip/irq-or1k-*
@@@ -15836,7 -15834,7 +15832,7 @@@ W:   https://parisc.wiki.kernel.or
  Q:    http://patchwork.kernel.org/project/linux-parisc/list/
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/jejb/parisc-2.6.git
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/deller/parisc-linux.git
- F:    Documentation/parisc/
+ F:    Documentation/arch/parisc/
  F:    arch/parisc/
  F:    drivers/char/agp/parisc-agp.c
  F:    drivers/input/misc/hp_sdc_rtc.c
@@@ -15851,7 -15849,7 +15847,7 @@@ F:   drivers/video/logo/logo_parisc
  F:    include/linux/hp_sdc.h
  
  PARMAN
 -M:    Jiri Pirko <jiri@nvidia.com>
 +M:    Jiri Pirko <jiri@resnulli.us>
  L:    netdev@vger.kernel.org
  S:    Supported
  F:    include/linux/parman.h
@@@ -16389,7 -16387,6 +16385,7 @@@ R:   Alexander Shishkin <alexander.shishk
  R:    Jiri Olsa <jolsa@kernel.org>
  R:    Namhyung Kim <namhyung@kernel.org>
  R:    Ian Rogers <irogers@google.com>
 +R:    Adrian Hunter <adrian.hunter@intel.com>
  L:    linux-perf-users@vger.kernel.org
  L:    linux-kernel@vger.kernel.org
  S:    Supported
@@@ -17167,6 -17164,12 +17163,12 @@@ F: fs/qnx4
  F:    include/uapi/linux/qnx4_fs.h
  F:    include/uapi/linux/qnxtypes.h
  
+ QNX6 FILESYSTEM
+ S:    Orphan
+ F:    Documentation/filesystems/qnx6.rst
+ F:    fs/qnx6/
+ F:    include/linux/qnx6_fs.h
  QORIQ DPAA2 FSL-MC BUS DRIVER
  M:    Stuart Yoder <stuyoder@gmail.com>
  M:    Laurentiu Tudor <laurentiu.tudor@nxp.com>
@@@ -17627,7 -17630,7 +17629,7 @@@ M:   Fenghua Yu <fenghua.yu@intel.com
  M:    Reinette Chatre <reinette.chatre@intel.com>
  L:    linux-kernel@vger.kernel.org
  S:    Supported
- F:    Documentation/x86/resctrl*
+ F:    Documentation/arch/x86/resctrl*
  F:    arch/x86/include/asm/resctrl.h
  F:    arch/x86/kernel/cpu/resctrl/
  F:    tools/testing/selftests/resctrl/
@@@ -17636,13 -17639,11 +17638,13 @@@ 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:    Joel Fernandes <joel@joelfernandes.org>
  M:    Josh Triplett <josh@joshtriplett.org>
 +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:    Joel Fernandes <joel@joelfernandes.org>
 +R:    Zqiang <qiang1.zhang@intel.com>
  L:    rcu@vger.kernel.org
  S:    Supported
  W:    http://www.rdrop.com/users/paulmck/RCU/
@@@ -17990,7 -17991,7 +17992,7 @@@ F:   Documentation/devicetree/bindings/sp
  F:    Documentation/devicetree/bindings/usb/microchip,mpfs-musb.yaml
  F:    arch/riscv/boot/dts/microchip/
  F:    drivers/char/hw_random/mpfs-rng.c
 -F:    drivers/clk/microchip/clk-mpfs.c
 +F:    drivers/clk/microchip/clk-mpfs*.c
  F:    drivers/i2c/busses/i2c-microchip-corei2c.c
  F:    drivers/mailbox/mailbox-mpfs.c
  F:    drivers/pci/controller/pcie-microchip-host.c
@@@ -18291,9 -18292,8 +18293,9 @@@ F:   drivers/s390/block/dasd
  F:    include/linux/dasd_mod.h
  
  S390 IOMMU (PCI)
 +M:    Niklas Schnelle <schnelle@linux.ibm.com>
  M:    Matthew Rosato <mjrosato@linux.ibm.com>
 -M:    Gerald Schaefer <gerald.schaefer@linux.ibm.com>
 +R:    Gerald Schaefer <gerald.schaefer@linux.ibm.com>
  L:    linux-s390@vger.kernel.org
  S:    Supported
  F:    drivers/iommu/s390-iommu.c
@@@ -18488,6 -18488,7 +18490,6 @@@ F:   include/media/drv-intf/s3c_camif.
  
  SAMSUNG S3FWRN5 NFC DRIVER
  M:    Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
 -L:    linux-nfc@lists.01.org (subscribers-only)
  S:    Maintained
  F:    Documentation/devicetree/bindings/net/nfc/samsung,s3fwrn5.yaml
  F:    drivers/nfc/s3fwrn5
@@@ -18802,7 -18803,7 +18804,7 @@@ F:   include/uapi/linux/sed
  SECURITY CONTACT
  M:    Security Officers <security@kernel.org>
  S:    Supported
 -F:    Documentation/admin-guide/security-bugs.rst
 +F:    Documentation/process/security-bugs.rst
  
  SECURITY SUBSYSTEM
  M:    Paul Moore <paul@paul-moore.com>
@@@ -18824,8 -18825,8 +18826,8 @@@ S:   Supporte
  W:    https://selinuxproject.org
  W:    https://github.com/SELinuxProject
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/pcmoore/selinux.git
 -F:    Documentation/ABI/obsolete/sysfs-selinux-checkreqprot
 -F:    Documentation/ABI/obsolete/sysfs-selinux-disable
 +F:    Documentation/ABI/removed/sysfs-selinux-checkreqprot
 +F:    Documentation/ABI/removed/sysfs-selinux-disable
  F:    Documentation/admin-guide/LSM/SELinux.rst
  F:    include/trace/events/avc.h
  F:    include/uapi/linux/selinux_netlink.h
@@@ -19150,7 -19151,9 +19152,7 @@@ W:   http://www.brownhat.org/sis900.htm
  F:    drivers/net/ethernet/sis/sis900.*
  
  SIS FRAMEBUFFER DRIVER
 -M:    Thomas Winischhofer <thomas@winischhofer.net>
 -S:    Maintained
 -W:    http://www.winischhofer.net/linuxsisvga.shtml
 +S:    Orphan
  F:    Documentation/fb/sisfb.rst
  F:    drivers/video/fbdev/sis/
  F:    include/video/sisfb.h
@@@ -19862,6 -19865,13 +19864,6 @@@ S:  Maintaine
  W:    http://wiki.laptop.org/go/DCON
  F:    drivers/staging/olpc_dcon/
  
 -STAGING - REALTEK RTL8188EU DRIVERS
 -M:    Larry Finger <Larry.Finger@lwfinger.net>
 -M:    Phillip Potter <phil@philpotter.co.uk>
 -R:    Pavel Skripkin <paskripkin@gmail.com>
 -S:    Supported
 -F:    drivers/staging/r8188eu/
 -
  STAGING - REALTEK RTL8712U DRIVERS
  M:    Larry Finger <Larry.Finger@lwfinger.net>
  M:    Florian Schilhabel <florian.c.schilhabel@googlemail.com>.
@@@ -20115,7 -20125,7 +20117,7 @@@ M:   John Paul Adrian Glaubitz <glaubitz@
  L:    linux-sh@vger.kernel.org
  S:    Maintained
  Q:    http://patchwork.kernel.org/project/linux-sh/list/
- F:    Documentation/sh/
+ F:    Documentation/arch/sh/
  F:    arch/sh/
  F:    drivers/sh/
  
@@@ -20175,7 -20185,7 +20177,7 @@@ M:   Vineet Gupta <vgupta@kernel.org
  L:    linux-snps-arc@lists.infradead.org
  S:    Supported
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/vgupta/arc.git
- F:    Documentation/arc/
+ F:    Documentation/arch/arc
  F:    Documentation/devicetree/bindings/arc/*
  F:    Documentation/devicetree/bindings/interrupt-controller/snps,arc*
  F:    arch/arc/
@@@ -20645,6 -20655,7 +20647,6 @@@ F:   sound/soc/codecs/tscs*.
  TENSILICA XTENSA PORT (xtensa)
  M:    Chris Zankel <chris@zankel.net>
  M:    Max Filippov <jcmvbkbc@gmail.com>
 -L:    linux-xtensa@linux-xtensa.org
  S:    Maintained
  T:    git https://github.com/jcmvbkbc/linux-xtensa.git
  F:    arch/xtensa/
@@@ -20980,6 -20991,7 +20982,6 @@@ F:   drivers/iio/magnetometer/tmag5273.
  TI TRF7970A NFC DRIVER
  M:    Mark Greer <mgreer@animalcreek.com>
  L:    linux-wireless@vger.kernel.org
 -L:    linux-nfc@lists.01.org (subscribers-only)
  S:    Supported
  F:    Documentation/devicetree/bindings/net/nfc/ti,trf7970a.yaml
  F:    drivers/nfc/trf7970a.c
@@@ -21234,6 -21246,14 +21236,14 @@@ S: Maintaine
  F:    Documentation/tools/rtla/
  F:    tools/tracing/rtla/
  
+ TECHNICAL ADVISORY BOARD PROCESS DOCS
+ M:    "Theodore Ts'o" <tytso@mit.edu>
+ M:    Greg Kroah-Hartman <gregkh@linuxfoundation.org>
+ L:    tech-board-discuss@lists.linux-foundation.org
+ S:    Maintained
+ F:    Documentation/process/researcher-guidelines.rst
+ F:    Documentation/process/contribution-maturity-model.rst
  TRADITIONAL CHINESE DOCUMENTATION
  M:    Hu Haowen <src.res@email.cn>
  L:    linux-doc-tw-discuss@lists.sourceforge.net (moderated for non-subscribers)
@@@ -21641,7 -21661,6 +21651,7 @@@ USB OVER IP DRIVE
  M:    Valentina Manea <valentina.manea.m@gmail.com>
  M:    Shuah Khan <shuah@kernel.org>
  M:    Shuah Khan <skhan@linuxfoundation.org>
 +R:    Hongren Zheng <i@zenithal.me>
  L:    linux-usb@vger.kernel.org
  S:    Maintained
  F:    Documentation/usb/usbip_protocol.rst
@@@ -22641,7 -22660,7 +22651,7 @@@ L:   linux-kernel@vger.kernel.or
  S:    Maintained
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git x86/core
  F:    Documentation/devicetree/bindings/x86/
- F:    Documentation/x86/
+ F:    Documentation/arch/x86/
  F:    arch/x86/
  
  X86 ENTRY CODE
@@@ -22657,7 -22676,7 +22667,7 @@@ M:   Borislav Petkov <bp@alien8.de
  L:    linux-edac@vger.kernel.org
  S:    Maintained
  F:    Documentation/ABI/testing/sysfs-mce
- F:    Documentation/x86/x86_64/machinecheck.rst
+ F:    Documentation/arch/x86/x86_64/machinecheck.rst
  F:    arch/x86/kernel/cpu/mce/*
  
  X86 MICROCODE UPDATE SUPPORT
@@@ -23036,6 -23055,7 +23046,6 @@@ F:   drivers/gpio/gpio-xra1403.
  
  XTENSA XTFPGA PLATFORM SUPPORT
  M:    Max Filippov <jcmvbkbc@gmail.com>
 -L:    linux-xtensa@linux-xtensa.org
  S:    Maintained
  F:    drivers/spi/spi-xtensa-xtfpga.c
  F:    sound/soc/xtensa/xtfpga-i2s.c
@@@ -23118,7 -23138,7 +23128,7 @@@ S:   Maintaine
  F:    arch/x86/kernel/cpu/zhaoxin.c
  
  ZONEFS FILESYSTEM
 -M:    Damien Le Moal <damien.lemoal@opensource.wdc.com>
 +M:    Damien Le Moal <dlemoal@kernel.org>
  M:    Naohiro Aota <naohiro.aota@wdc.com>
  R:    Johannes Thumshirn <jth@kernel.org>
  L:    linux-fsdevel@vger.kernel.org
diff --combined arch/x86/Kconfig
index 947e24714c28ef643a2886535b721f689047dc82,1720eabc31ec91fe0b9400c123058b0a328c3f4b..57a14206ad8f52de38ed2d0bbbac1ed7a86160ac
@@@ -283,6 -283,7 +283,6 @@@ config X8
        select RTC_LIB
        select RTC_MC146818_LIB
        select SPARSE_IRQ
 -      select SRCU
        select SYSCTL_EXCEPTION_TRACE
        select THREAD_INFO_IN_TASK
        select TRACE_IRQFLAGS_SUPPORT
@@@ -433,7 -434,7 +433,7 @@@ config SM
          Y to "Enhanced Real Time Clock Support", below. The "Advanced Power
          Management" code will be disabled if you say Y here.
  
-         See also <file:Documentation/x86/i386/IO-APIC.rst>,
+         See also <file:Documentation/arch/x86/i386/IO-APIC.rst>,
          <file:Documentation/admin-guide/lockup-watchdogs.rst> and the SMP-HOWTO available at
          <http://www.tldp.org/docs.html#howto>.
  
@@@ -1323,7 -1324,7 +1323,7 @@@ config MICROCOD
          the Linux kernel.
  
          The preferred method to load microcode from a detached initrd is described
-         in Documentation/x86/microcode.rst. For that you need to enable
+         in Documentation/arch/x86/microcode.rst. For that you need to enable
          CONFIG_BLK_DEV_INITRD in order for the loader to be able to scan the
          initrd for microcode blobs.
  
@@@ -1509,7 -1510,7 +1509,7 @@@ config X86_5LEVE
          A kernel with the option enabled can be booted on machines that
          support 4- or 5-level paging.
  
-         See Documentation/x86/x86_64/5level-paging.rst for more
+         See Documentation/arch/x86/x86_64/5level-paging.rst for more
          information.
  
          Say N if unsure.
@@@ -1773,7 -1774,7 +1773,7 @@@ config MTR
          You can safely say Y even if your machine doesn't have MTRRs, you'll
          just add about 9 KB to your kernel.
  
-         See <file:Documentation/x86/mtrr.rst> for more information.
+         See <file:Documentation/arch/x86/mtrr.rst> for more information.
  
  config MTRR_SANITIZER
        def_bool y
@@@ -1937,6 -1938,7 +1937,6 @@@ config X86_SG
        depends on X86_64 && CPU_SUP_INTEL && X86_X2APIC
        depends on CRYPTO=y
        depends on CRYPTO_SHA256=y
 -      select SRCU
        select MMU_NOTIFIER
        select NUMA_KEEP_MEMINFO if NUMA
        select XARRAY_MULTI
@@@ -2549,7 -2551,7 +2549,7 @@@ config PAGE_TABLE_ISOLATIO
          ensuring that the majority of kernel addresses are not mapped
          into userspace.
  
-         See Documentation/x86/pti.rst for more details.
+         See Documentation/arch/x86/pti.rst for more details.
  
  config RETPOLINE
        bool "Avoid speculative indirect branches in kernel"
diff --combined security/Kconfig
index cbf9bbc86b9c381010ea326ccda5ccdc760d3e8a,b288d9d105d429506b3356cae6b236ca816d1b62..97abeb9b9a194b2710d4636c7977a0eba7d6a518
@@@ -32,6 -32,11 +32,6 @@@ config SECURIT
  
          If you are unsure how to answer this question, answer N.
  
 -config SECURITY_WRITABLE_HOOKS
 -      depends on SECURITY
 -      bool
 -      default n
 -
  config SECURITYFS
        bool "Enable the securityfs filesystem"
        help
@@@ -105,7 -110,7 +105,7 @@@ config INTEL_TX
          See <https://www.intel.com/technology/security/> for more information
          about Intel(R) TXT.
          See <http://tboot.sourceforge.net> for more information about tboot.
-         See Documentation/x86/intel_txt.rst for a description of how to enable
+         See Documentation/arch/x86/intel_txt.rst for a description of how to enable
          Intel TXT support in a kernel boot.
  
          If you are unsure as to whether this is required, answer N.
@@@ -241,17 -246,15 +241,17 @@@ endchoic
  
  config LSM
        string "Ordered list of enabled LSMs"
 -      default "landlock,lockdown,yama,loadpin,safesetid,integrity,smack,selinux,tomoyo,apparmor,bpf" if DEFAULT_SECURITY_SMACK
 -      default "landlock,lockdown,yama,loadpin,safesetid,integrity,apparmor,selinux,smack,tomoyo,bpf" if DEFAULT_SECURITY_APPARMOR
 -      default "landlock,lockdown,yama,loadpin,safesetid,integrity,tomoyo,bpf" if DEFAULT_SECURITY_TOMOYO
 -      default "landlock,lockdown,yama,loadpin,safesetid,integrity,bpf" if DEFAULT_SECURITY_DAC
 -      default "landlock,lockdown,yama,loadpin,safesetid,integrity,selinux,smack,tomoyo,apparmor,bpf"
 +      default "landlock,lockdown,yama,loadpin,safesetid,smack,selinux,tomoyo,apparmor,bpf" if DEFAULT_SECURITY_SMACK
 +      default "landlock,lockdown,yama,loadpin,safesetid,apparmor,selinux,smack,tomoyo,bpf" if DEFAULT_SECURITY_APPARMOR
 +      default "landlock,lockdown,yama,loadpin,safesetid,tomoyo,bpf" if DEFAULT_SECURITY_TOMOYO
 +      default "landlock,lockdown,yama,loadpin,safesetid,bpf" if DEFAULT_SECURITY_DAC
 +      default "landlock,lockdown,yama,loadpin,safesetid,selinux,smack,tomoyo,apparmor,bpf"
        help
          A comma-separated list of LSMs, in initialization order.
 -        Any LSMs left off this list will be ignored. This can be
 -        controlled at boot with the "lsm=" parameter.
 +        Any LSMs left off this list, except for those with order
 +        LSM_ORDER_FIRST and LSM_ORDER_LAST, which are always enabled
 +        if selected in the kernel configuration, will be ignored.
 +        This can be controlled at boot with the "lsm=" parameter.
  
          If unsure, leave this as the default.