Merge tag 'docs-6.4' of git://git.lwn.net/linux

c23f2897 · Linus Torvalds <[email protected]> · 2023-04-24 12:35:49 -07:00

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/
  ...

Commit: c23f28975abc2eb02cecc8bc1f2c95473a59ed2e
Parents: 1be89faa · 7e8472c8

Merge commit. Changes below are compared with the first parent: 1be89faa.

Changes

186 files changed · +2622 −629

File	Status	Add	Del	Content
CREDITS	modified	+16	−0	View file
Documentation/admin-guide/hw-vuln/mds.rst	modified	+1	−1	View file
Documentation/admin-guide/hw-vuln/tsx_async_abort.rst	modified	+1	−1	View file
Documentation/admin-guide/index.rst	modified	+1	−0	View file
Documentation/admin-guide/kernel-parameters.rst	modified	+4	−4	View file
Documentation/admin-guide/kernel-parameters.txt	modified	+169	−172	View file
Documentation/admin-guide/quickly-build-trimmed-linux.rst	added	+1092	−0	View file
Documentation/admin-guide/ras.rst	modified	+1	−1	View file
Documentation/admin-guide/sysctl/kernel.rst	modified	+2	−2	View file
Documentation/admin-guide/unicode.rst	modified	+4	−5	View file
Documentation/arc/arc.rst → Documentation/arch/arc/arc.rst	renamed	+0	−0	View file
Documentation/arc/features.rst → Documentation/arch/arc/features.rst	renamed	+0	−0	View file
Documentation/arc/index.rst → Documentation/arch/arc/index.rst	renamed	+0	−0	View file
Documentation/ia64/aliasing.rst → Documentation/arch/ia64/aliasing.rst	renamed	+0	−0	View file
Documentation/ia64/efirtc.rst → Documentation/arch/ia64/efirtc.rst	renamed	+0	−0	View file
Documentation/ia64/err_inject.rst → Documentation/arch/ia64/err_inject.rst	renamed	+0	−0	View file
Documentation/ia64/features.rst → Documentation/arch/ia64/features.rst	renamed	+0	−0	View file
Documentation/ia64/fsys.rst → Documentation/arch/ia64/fsys.rst	renamed	+0	−0	View file
Documentation/ia64/ia64.rst → Documentation/arch/ia64/ia64.rst	renamed	+0	−0	View file
Documentation/ia64/index.rst → Documentation/arch/ia64/index.rst	renamed	+0	−0	View file
Documentation/ia64/irq-redir.rst → Documentation/arch/ia64/irq-redir.rst	renamed	+0	−0	View file
Documentation/ia64/mca.rst → Documentation/arch/ia64/mca.rst	renamed	+0	−0	View file
Documentation/ia64/serial.rst → Documentation/arch/ia64/serial.rst	renamed	+0	−0	View file
Documentation/arch.rst → Documentation/arch/index.rst	renamed	+7	−7	View file
Documentation/m68k/buddha-driver.rst → Documentation/arch/m68k/buddha-driver.rst	renamed	+0	−0	View file
Documentation/m68k/features.rst → Documentation/arch/m68k/features.rst	renamed	+0	−0	View file
Documentation/m68k/index.rst → Documentation/arch/m68k/index.rst	renamed	+0	−0	View file
Documentation/m68k/kernel-options.rst → Documentation/arch/m68k/kernel-options.rst	renamed	+0	−0	View file
Documentation/nios2/features.rst → Documentation/arch/nios2/features.rst	renamed	+0	−0	View file
Documentation/nios2/index.rst → Documentation/arch/nios2/index.rst	renamed	+0	−0	View file
Documentation/nios2/nios2.rst → Documentation/arch/nios2/nios2.rst	renamed	+0	−0	View file
Documentation/openrisc/features.rst → Documentation/arch/openrisc/features.rst	renamed	+0	−0	View file
Documentation/openrisc/index.rst → Documentation/arch/openrisc/index.rst	renamed	+0	−0	View file
Documentation/openrisc/openrisc_port.rst → Documentation/arch/openrisc/openrisc_port.rst	renamed	+0	−0	View file
Documentation/openrisc/todo.rst → Documentation/arch/openrisc/todo.rst	renamed	+0	−0	View file
Documentation/parisc/debugging.rst → Documentation/arch/parisc/debugging.rst	renamed	+0	−0	View file
Documentation/parisc/features.rst → Documentation/arch/parisc/features.rst	renamed	+0	−0	View file
Documentation/parisc/index.rst → Documentation/arch/parisc/index.rst	renamed	+0	−0	View file
Documentation/parisc/registers.rst → Documentation/arch/parisc/registers.rst	renamed	+0	−0	View file
Documentation/sh/booting.rst → Documentation/arch/sh/booting.rst	renamed	+0	−0	View file
Documentation/sh/features.rst → Documentation/arch/sh/features.rst	renamed	+0	−0	View file
Documentation/sh/index.rst → Documentation/arch/sh/index.rst	renamed	+0	−0	View file
Documentation/sh/new-machine.rst → Documentation/arch/sh/new-machine.rst	renamed	+0	−0	View file
Documentation/sh/register-banks.rst → Documentation/arch/sh/register-banks.rst	renamed	+0	−0	View file
Documentation/sparc/adi.rst → Documentation/arch/sparc/adi.rst	renamed	+0	−0	View file
Documentation/sparc/console.rst → Documentation/arch/sparc/console.rst	renamed	+0	−0	View file
Documentation/sparc/features.rst → Documentation/arch/sparc/features.rst	renamed	+0	−0	View file
Documentation/sparc/index.rst → Documentation/arch/sparc/index.rst	renamed	+0	−0	View file
Documentation/sparc/oradax/dax-hv-api.txt → Documentation/arch/sparc/oradax/dax-hv-api.txt	renamed	+0	−0	View file
Documentation/sparc/oradax/oracle-dax.rst → Documentation/arch/sparc/oradax/oracle-dax.rst	renamed	+0	−0	View file
Documentation/x86/amd-memory-encryption.rst → Documentation/arch/x86/amd-memory-encryption.rst	renamed	+0	−0	View file
Documentation/x86/amd_hsmp.rst → Documentation/arch/x86/amd_hsmp.rst	renamed	+0	−0	View file
Documentation/x86/boot.rst → Documentation/arch/x86/boot.rst	renamed	+2	−2	View file
Documentation/x86/booting-dt.rst → Documentation/arch/x86/booting-dt.rst	renamed	+1	−1	View file
Documentation/x86/buslock.rst → Documentation/arch/x86/buslock.rst	renamed	+8	−2	View file
Documentation/x86/cpuinfo.rst → Documentation/arch/x86/cpuinfo.rst	renamed	+0	−0	View file
Documentation/x86/earlyprintk.rst → Documentation/arch/x86/earlyprintk.rst	renamed	+0	−0	View file
Documentation/x86/elf_auxvec.rst → Documentation/arch/x86/elf_auxvec.rst	renamed	+0	−0	View file
Documentation/x86/entry_64.rst → Documentation/arch/x86/entry_64.rst	renamed	+0	−0	View file
Documentation/x86/exception-tables.rst → Documentation/arch/x86/exception-tables.rst	renamed	+0	−0	View file
Documentation/x86/features.rst → Documentation/arch/x86/features.rst	renamed	+0	−0	View file
Documentation/x86/i386/IO-APIC.rst → Documentation/arch/x86/i386/IO-APIC.rst	renamed	+0	−0	View file
Documentation/x86/i386/index.rst → Documentation/arch/x86/i386/index.rst	renamed	+0	−0	View file
Documentation/x86/ifs.rst → Documentation/arch/x86/ifs.rst	renamed	+0	−0	View file
Documentation/x86/index.rst → Documentation/arch/x86/index.rst	renamed	+0	−0	View file
Documentation/x86/intel-hfi.rst → Documentation/arch/x86/intel-hfi.rst	renamed	+0	−0	View file
Documentation/x86/intel_txt.rst → Documentation/arch/x86/intel_txt.rst	renamed	+0	−0	View file
Documentation/x86/iommu.rst → Documentation/arch/x86/iommu.rst	renamed	+0	−0	View file
Documentation/x86/kernel-stacks.rst → Documentation/arch/x86/kernel-stacks.rst	renamed	+0	−0	View file
Documentation/x86/mds.rst → Documentation/arch/x86/mds.rst	renamed	+0	−0	View file
Documentation/x86/microcode.rst → Documentation/arch/x86/microcode.rst	renamed	+0	−0	View file
Documentation/x86/mtrr.rst → Documentation/arch/x86/mtrr.rst	renamed	+1	−1	View file
Documentation/x86/orc-unwinder.rst → Documentation/arch/x86/orc-unwinder.rst	renamed	+0	−0	View file
Documentation/x86/pat.rst → Documentation/arch/x86/pat.rst	renamed	+0	−0	View file
Documentation/x86/pti.rst → Documentation/arch/x86/pti.rst	renamed	+0	−0	View file
Documentation/x86/resctrl.rst → Documentation/arch/x86/resctrl.rst	renamed	+0	−0	View file
Documentation/x86/sgx.rst → Documentation/arch/x86/sgx.rst	renamed	+0	−0	View file
Documentation/x86/sva.rst → Documentation/arch/x86/sva.rst	renamed	+0	−0	View file
Documentation/x86/tdx.rst → Documentation/arch/x86/tdx.rst	renamed	+0	−0	View file
Documentation/x86/tlb.rst → Documentation/arch/x86/tlb.rst	renamed	+0	−0	View file
Documentation/x86/topology.rst → Documentation/arch/x86/topology.rst	renamed	+0	−0	View file
Documentation/x86/tsx_async_abort.rst → Documentation/arch/x86/tsx_async_abort.rst	renamed	+0	−0	View file
Documentation/x86/usb-legacy-support.rst → Documentation/arch/x86/usb-legacy-support.rst	renamed	+0	−0	View file
Documentation/x86/x86_64/5level-paging.rst → Documentation/arch/x86/x86_64/5level-paging.rst	renamed	+1	−1	View file
Documentation/x86/x86_64/boot-options.rst → Documentation/arch/x86/x86_64/boot-options.rst	renamed	+2	−2	View file
Documentation/x86/x86_64/cpu-hotplug-spec.rst → Documentation/arch/x86/x86_64/cpu-hotplug-spec.rst	renamed	+0	−0	View file
Documentation/x86/x86_64/fake-numa-for-cpusets.rst → Documentation/arch/x86/x86_64/fake-numa-for-cpusets.rst	renamed	+1	−1	View file
Documentation/x86/x86_64/fsgs.rst → Documentation/arch/x86/x86_64/fsgs.rst	renamed	+0	−0	View file
Documentation/x86/x86_64/index.rst → Documentation/arch/x86/x86_64/index.rst	renamed	+0	−0	View file
Documentation/x86/x86_64/machinecheck.rst → Documentation/arch/x86/x86_64/machinecheck.rst	renamed	+0	−0	View file
Documentation/x86/x86_64/mm.rst → Documentation/arch/x86/x86_64/mm.rst	renamed	+0	−0	View file
Documentation/x86/x86_64/uefi.rst → Documentation/arch/x86/x86_64/uefi.rst	renamed	+0	−0	View file
Documentation/x86/xstate.rst → Documentation/arch/x86/xstate.rst	renamed	+0	−0	View file
Documentation/x86/zero-page.rst → Documentation/arch/x86/zero-page.rst	renamed	+0	−0	View file
Documentation/xtensa/atomctl.rst → Documentation/arch/xtensa/atomctl.rst	renamed	+0	−0	View file
Documentation/xtensa/booting.rst → Documentation/arch/xtensa/booting.rst	renamed	+0	−0	View file
Documentation/xtensa/features.rst → Documentation/arch/xtensa/features.rst	renamed	+0	−0	View file
Documentation/xtensa/index.rst → Documentation/arch/xtensa/index.rst	renamed	+0	−0	View file
Documentation/xtensa/mmu.rst → Documentation/arch/xtensa/mmu.rst	renamed	+0	−0	View file
Documentation/arm/index.rst	modified	+0	−2	View file
Documentation/arm/sti/overview.rst	modified	+3	−7	View file
Documentation/arm/sti/stih415-overview.rst	deleted	+0	−14	View before deletion
Documentation/arm/sti/stih416-overview.rst	deleted	+0	−13	View before deletion
Documentation/conf.py	modified	+4	−3	View file
Documentation/core-api/asm-annotations.rst	modified	+1	−1	View file
Documentation/core-api/dma-api-howto.rst	modified	+1	−1	View file
Documentation/dev-tools/kmemleak.rst	modified	+1	−1	View file
Documentation/driver-api/clk.rst	modified	+5	−0	View file
Documentation/driver-api/device-io.rst	modified	+1	−1	View file
Documentation/driver-api/firmware/fw_search_path.rst	modified	+7	−2	View file
Documentation/filesystems/proc.rst	modified	+23	−21	View file
Documentation/filesystems/vfs.rst	modified	+86	−19	View file
Documentation/index.rst	modified	+1	−1	View file
Documentation/kernel-hacking/false-sharing.rst	added	+206	−0	View file
Documentation/kernel-hacking/index.rst	modified	+1	−0	View file
Documentation/mm/physical_memory.rst	modified	+20	−1	View file
Documentation/process/coding-style.rst	modified	+1	−1	View file
Documentation/process/contribution-maturity-model.rst	added	+109	−0	View file
Documentation/process/index.rst	modified	+1	−0	View file
Documentation/process/kernel-docs.rst	modified	+31	−5	View file
Documentation/process/maintainer-tip.rst	modified	+2	−2	View file
Documentation/process/submitting-patches.rst	modified	+8	−11	View file
Documentation/trace/ftrace.rst	modified	+1	−1	View file
Documentation/translations/it_IT/core-api/symbol-namespaces.rst	modified	+1	−2	View file
Documentation/translations/it_IT/doc-guide/parse-headers.rst	modified	+2	−3	View file
Documentation/translations/it_IT/index.rst	modified	+22	−25	View file
Documentation/translations/it_IT/kernel-hacking/locking.rst	modified	+5	−0	View file
Documentation/translations/it_IT/process/5.Posting.rst	modified	+8	−5	View file
Documentation/translations/it_IT/process/changes.rst	modified	+2	−2	View file
Documentation/translations/it_IT/process/clang-format.rst	modified	+1	−1	View file
Documentation/translations/it_IT/process/coding-style.rst	modified	+3	−3	View file
Documentation/translations/it_IT/process/deprecated.rst	modified	+27	−2	View file
Documentation/translations/it_IT/process/email-clients.rst	modified	+25	−0	View file
Documentation/translations/it_IT/process/index.rst	modified	+1	−0	View file
Documentation/translations/it_IT/process/maintainer-pgp-guide.rst	modified	+171	−177	View file
Documentation/translations/it_IT/process/programming-language.rst	modified	+20	−5	View file
Documentation/translations/it_IT/process/stable-kernel-rules.rst	modified	+6	−0	View file
Documentation/translations/it_IT/process/submitting-patches.rst	modified	+2	−2	View file
Documentation/translations/it_IT/process/volatile-considered-harmful.rst	modified	+2	−2	View file
Documentation/translations/sp_SP/memory-barriers.txt	modified	+1	−1	View file
Documentation/translations/sp_SP/process/deprecated.rst	added	+381	−0	View file
Documentation/translations/sp_SP/process/index.rst	modified	+1	−0	View file
Documentation/translations/zh_CN/admin-guide/mm/damon/lru_sort.rst	modified	+1	−1	View file
Documentation/translations/zh_CN/arch.rst → Documentation/translations/zh_CN/arch/index.rst	renamed	+4	−4	View file
Documentation/translations/zh_CN/openrisc/index.rst → Documentation/translations/zh_CN/arch/openrisc/index.rst	renamed	+2	−2	View file
Documentation/translations/zh_CN/openrisc/openrisc_port.rst → Documentation/translations/zh_CN/arch/openrisc/openrisc_port.rst	renamed	+2	−2	View file
Documentation/translations/zh_CN/openrisc/todo.rst → Documentation/translations/zh_CN/arch/openrisc/todo.rst	renamed	+2	−2	View file
Documentation/translations/zh_CN/parisc/debugging.rst → Documentation/translations/zh_CN/arch/parisc/debugging.rst	renamed	+2	−2	View file
Documentation/translations/zh_CN/parisc/index.rst → Documentation/translations/zh_CN/arch/parisc/index.rst	renamed	+2	−2	View file
Documentation/translations/zh_CN/parisc/registers.rst → Documentation/translations/zh_CN/arch/parisc/registers.rst	renamed	+2	−2	View file
Documentation/translations/zh_CN/index.rst	modified	+1	−1	View file
Documentation/userspace-api/ELF.rst	added	+34	−0	View file
Documentation/userspace-api/index.rst	modified	+1	−0	View file
Documentation/userspace-api/media/v4l/pixfmt-rgb.rst	modified	+1	−4	View file
Documentation/virt/kvm/api.rst	modified	+1	−1	View file
MAINTAINERS	modified	+26	−16	View file
arch/arm/Kconfig	modified	+1	−1	View file
arch/ia64/kernel/efi.c	modified	+1	−1	View file
arch/ia64/kernel/fsys.S	modified	+1	−1	View file
arch/ia64/mm/ioremap.c	modified	+1	−1	View file
arch/ia64/pci/pci.c	modified	+1	−1	View file
arch/m68k/Kconfig.machine	modified	+2	−2	View file
arch/sh/Kconfig.cpu	modified	+1	−1	View file
arch/x86/Kconfig	modified	+5	−5	View file
arch/x86/Kconfig.debug	modified	+1	−1	View file
arch/x86/boot/header.S	modified	+1	−1	View file
arch/x86/entry/entry_64.S	modified	+1	−1	View file
arch/x86/include/asm/bootparam_utils.h	modified	+1	−1	View file
arch/x86/include/asm/page_64_types.h	modified	+1	−1	View file
arch/x86/include/asm/pgtable_64_types.h	modified	+1	−1	View file
arch/x86/kernel/cpu/microcode/amd.c	modified	+1	−1	View file
arch/x86/kernel/cpu/resctrl/monitor.c	modified	+1	−1	View file
arch/x86/kernel/cpu/sgx/sgx.h	modified	+1	−1	View file
arch/x86/kernel/kexec-bzimage64.c	modified	+1	−1	View file
arch/x86/kernel/pci-dma.c	modified	+1	−1	View file
arch/x86/mm/pat/set_memory.c	modified	+1	−1	View file
arch/x86/mm/tlb.c	modified	+1	−1	View file
arch/x86/platform/pvh/enlighten.c	modified	+1	−1	View file
arch/xtensa/include/asm/initialize_mmu.h	modified	+1	−1	View file
drivers/sbus/char/oradax.c	modified	+1	−1	View file
drivers/vhost/vhost.c	modified	+1	−1	View file
fs/qnx4/README	deleted	+0	−9	View before deletion
fs/qnx6/README	deleted	+0	−8	View before deletion
security/Kconfig	modified	+1	−1	View file
tools/include/linux/err.h	modified	+1	−1	View file
tools/objtool/Documentation/objtool.txt	modified	+1	−1	View file

Only the first 600 diff lines are shown. Download the complete patch.

CREDITS

View file

diff --git a/CREDITS b/CREDITS
index 8470591..b6c93e0 100644
--- a/CREDITS
+++ b/CREDITS
@@ -229,6 +229,10 @@ S: University of Notre Dame
 S: Notre Dame, Indiana
 S: USA
 
+N: Kai Bankett
+E: [email protected]
+D: QNX6 filesystem
+
 N: Greg Banks
 E: [email protected]
 D: IDT77105 ATM network driver
@@ -886,6 +890,10 @@ W: http://jdelvare.nerim.net/
 D: Several hardware monitoring drivers
 S: France
 
+N: Frank "Jedi/Sector One" Denis
+E: [email protected]
+D: QNX4 filesystem
+
 N: Peter Denison
 E: [email protected]
 W: http://www.pnd-pc.demon.co.uk/promise/
@@ -1259,6 +1267,10 @@ S: USA
 N: Adam Fritzler
 E: [email protected]
 
+N: Richard "Scuba" A. Frowijn
+E: [email protected]
+D: QNX4 filesystem
+
 N: Fernando Fuganti
 E: [email protected]
 E: [email protected]
@@ -2218,6 +2230,10 @@ D: Digiboard PC/Xe and PC/Xi, Digiboard EPCA
 D: NUMA support, Slab allocators, Page migration
 D: Scalability, Time subsystem
 
+N: Anders Larsen
+E: [email protected]
+D: QNX4 filesystem
+
 N: Paul Laufer
 E: [email protected]
 D: Soundblaster driver fixes, ISAPnP quirk

Documentation/admin-guide/hw-vuln/mds.rst

View file

diff --git a/Documentation/admin-guide/hw-vuln/mds.rst b/Documentation/admin-guide/hw-vuln/mds.rst
index f491de7..48ca0bd 100644
--- a/Documentation/admin-guide/hw-vuln/mds.rst
+++ b/Documentation/admin-guide/hw-vuln/mds.rst
@@ -58,7 +58,7 @@ Because the buffers are potentially shared between Hyper-Threads cross
 Hyper-Thread attacks are possible.
 
 Deeper technical information is available in the MDS specific x86
-architecture section: :ref:`Documentation/x86/mds.rst <mds>`.
+architecture section: :ref:`Documentation/arch/x86/mds.rst <mds>`.
 
 
 Attack scenarios

Documentation/admin-guide/hw-vuln/tsx_async_abort.rst

View file

diff --git a/Documentation/admin-guide/hw-vuln/tsx_async_abort.rst b/Documentation/admin-guide/hw-vuln/tsx_async_abort.rst
index 76673af..014167e 100644
--- a/Documentation/admin-guide/hw-vuln/tsx_async_abort.rst
+++ b/Documentation/admin-guide/hw-vuln/tsx_async_abort.rst
@@ -63,7 +63,7 @@ attacker needs to begin a TSX transaction and raise an asynchronous abort
 which in turn potentially leaks data stored in the buffers.
 
 More detailed technical information is available in the TAA specific x86
-architecture section: :ref:`Documentation/x86/tsx_async_abort.rst <tsx_async_abort>`.
+architecture section: :ref:`Documentation/arch/x86/tsx_async_abort.rst <tsx_async_abort>`.
 
 
 Attack scenarios

Documentation/admin-guide/index.rst

View file

diff --git a/Documentation/admin-guide/index.rst b/Documentation/admin-guide/index.rst
index 09a563b..43ea356 100644
--- a/Documentation/admin-guide/index.rst
+++ b/Documentation/admin-guide/index.rst
@@ -36,6 +36,7 @@ problems and bugs in particular.
 
    reporting-issues
    reporting-regressions
+   quickly-build-trimmed-linux
    bug-hunting
    bug-bisect
    tainted-kernels

Documentation/admin-guide/kernel-parameters.rst

View file

diff --git a/Documentation/admin-guide/kernel-parameters.rst b/Documentation/admin-guide/kernel-parameters.rst
index 6ae5f12..1ba8f2a 100644
--- a/Documentation/admin-guide/kernel-parameters.rst
+++ b/Documentation/admin-guide/kernel-parameters.rst
@@ -132,7 +132,7 @@ parameter is applicable::
 	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.
@@ -178,7 +178,7 @@ parameter is applicable::
 	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 +193,10 @@ In addition, the following text indicates that the option::
 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

Documentation/admin-guide/kernel-parameters.txt

View file

diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt
index 7016cb1..10e2e5c 100644
--- a/Documentation/admin-guide/kernel-parameters.txt
+++ b/Documentation/admin-guide/kernel-parameters.txt
@@ -929,9 +929,6 @@
 
 	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
@@ -2976,7 +2973,7 @@
 
 	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.
@@ -3184,9 +3181,6 @@
 			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.
@@ -3428,14 +3422,13 @@
 			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
@@ -3446,18 +3439,6 @@
 			[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
@@ -3465,6 +3446,10 @@
 			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
@@ -3492,21 +3477,14 @@
 			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
@@ -3518,7 +3496,15 @@
 			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.
 
@@ -3527,12 +3513,19 @@
 			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
@@ -3540,13 +3533,14 @@
 			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
@@ -3579,7 +3573,21 @@
 	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
@@ -3596,32 +3604,8 @@
 			/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.
 
@@ -3631,14 +3615,6 @@
 
 	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)
@@ -3646,74 +3622,18 @@
 			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
@@ -3737,6 +3657,19 @@
 
 	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
@@ -3754,16 +3687,6 @@
 			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.
 
@@ -3775,6 +3698,13 @@
 
 	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]
@@ -3782,18 +3712,10 @@
 			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.
 
@@ -3806,10 +3728,6 @@
 	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
@@ -3822,6 +3740,10 @@
 
 	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.
 
@@ -3830,6 +3752,9 @@
 	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
@@ -3849,21 +3774,77 @@
 	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
+