Commit 3fb6d0e0 authored by Linus Torvalds's avatar Linus Torvalds

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

Pull documentation fixes from Jonathan Corbet:
 "A handful of late-arriving documentation fixes, nothing all that
  notable"

* tag 'docs-5.12-2' of git://git.lwn.net/linux:
  docs: proc.rst: fix indentation warning
  Documentation: cgroup-v2: fix path to example BPF program
  docs: powerpc: Fix tables in syscall64-abi.rst
  Documentation: features: refresh feature list
  Documentation: features: remove c6x references
  docs: ABI: testing: ima_policy: Fixed missing bracket
  Fix unaesthetic indentation
  scripts: kernel-doc: fix array element capture in pointer-to-func parsing
  doc: use KCFLAGS instead of EXTRA_CFLAGS to pass flags from command line
  Documentation: proc.rst: add more about the 6 fields in loadavg
parents a3905af5 f37a15ea
...@@ -29,7 +29,7 @@ Description: ...@@ -29,7 +29,7 @@ Description:
option: [[appraise_type=]] [template=] [permit_directio] option: [[appraise_type=]] [template=] [permit_directio]
[appraise_flag=] [keyrings=] [appraise_flag=] [keyrings=]
base: base:
func:= [BPRM_CHECK][MMAP_CHECK][CREDS_CHECK][FILE_CHECK]MODULE_CHECK] func:= [BPRM_CHECK][MMAP_CHECK][CREDS_CHECK][FILE_CHECK][MODULE_CHECK]
[FIRMWARE_CHECK] [FIRMWARE_CHECK]
[KEXEC_KERNEL_CHECK] [KEXEC_INITRAMFS_CHECK] [KEXEC_KERNEL_CHECK] [KEXEC_INITRAMFS_CHECK]
[KEXEC_CMDLINE] [KEY_CHECK] [CRITICAL_DATA] [KEXEC_CMDLINE] [KEY_CHECK] [CRITICAL_DATA]
......
...@@ -2098,7 +2098,7 @@ If the program returns 0, the attempt fails with -EPERM, otherwise ...@@ -2098,7 +2098,7 @@ If the program returns 0, the attempt fails with -EPERM, otherwise
it succeeds. it succeeds.
An example of BPF_CGROUP_DEVICE program may be found in the kernel An example of BPF_CGROUP_DEVICE program may be found in the kernel
source tree in the tools/testing/selftests/bpf/dev_cgroup.c file. source tree in the tools/testing/selftests/bpf/progs/dev_cgroup.c file.
RDMA RDMA
......
...@@ -49,8 +49,7 @@ extensions = ['kerneldoc', 'rstFlatTable', 'kernel_include', ...@@ -49,8 +49,7 @@ extensions = ['kerneldoc', 'rstFlatTable', 'kernel_include',
if major >= 3: if major >= 3:
sys.stderr.write('''WARNING: The kernel documentation build process sys.stderr.write('''WARNING: The kernel documentation build process
support for Sphinx v3.0 and above is brand new. Be prepared for support for Sphinx v3.0 and above is brand new. Be prepared for
possible issues in the generated output. possible issues in the generated output.\n''')
''')
if (major > 3) or (minor > 0 or patch >= 2): if (major > 3) or (minor > 0 or patch >= 2):
# Sphinx c function parser is more pedantic with regards to type # Sphinx c function parser is more pedantic with regards to type
# checking. Due to that, having macros at c:function cause problems. # checking. Due to that, having macros at c:function cause problems.
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | TODO | | arm: | TODO |
| arm64: | TODO | | arm64: | TODO |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | ok | | hexagon: | ok |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | ok |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | ok | | hexagon: | ok |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | TODO | | arm: | TODO |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,14 +10,13 @@ ...@@ -10,14 +10,13 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
| ia64: | TODO | | ia64: | TODO |
| m68k: | TODO | | m68k: | TODO |
| microblaze: | ok | | microblaze: | ok |
| mips: | TODO | | mips: | ok |
| nds32: | TODO | | nds32: | TODO |
| nios2: | TODO | | nios2: | TODO |
| openrisc: | TODO | | openrisc: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | ok | | h8300: | ok |
| hexagon: | ok | | hexagon: | ok |
......
...@@ -10,8 +10,7 @@ ...@@ -10,8 +10,7 @@
| arc: | ok | | arc: | ok |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO | | csky: | ok |
| csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
| ia64: | TODO | | ia64: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | TODO | | arm: | TODO |
| arm64: | TODO | | arm64: | TODO |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
...@@ -23,7 +22,7 @@ ...@@ -23,7 +22,7 @@
| openrisc: | TODO | | openrisc: | TODO |
| parisc: | ok | | parisc: | ok |
| powerpc: | ok | | powerpc: | ok |
| riscv: | TODO | | riscv: | ok |
| s390: | ok | | s390: | ok |
| sh: | TODO | | sh: | TODO |
| sparc: | TODO | | sparc: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
...@@ -23,7 +22,7 @@ ...@@ -23,7 +22,7 @@
| openrisc: | TODO | | openrisc: | TODO |
| parisc: | ok | | parisc: | ok |
| powerpc: | ok | | powerpc: | ok |
| riscv: | TODO | | riscv: | ok |
| s390: | ok | | s390: | ok |
| sh: | ok | | sh: | ok |
| sparc: | ok | | sparc: | ok |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
...@@ -23,7 +22,7 @@ ...@@ -23,7 +22,7 @@
| openrisc: | TODO | | openrisc: | TODO |
| parisc: | ok | | parisc: | ok |
| powerpc: | ok | | powerpc: | ok |
| riscv: | TODO | | riscv: | ok |
| s390: | ok | | s390: | ok |
| sh: | ok | | sh: | ok |
| sparc: | ok | | sparc: | ok |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | TODO | | arm64: | TODO |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
...@@ -23,7 +22,7 @@ ...@@ -23,7 +22,7 @@
| openrisc: | TODO | | openrisc: | TODO |
| parisc: | TODO | | parisc: | TODO |
| powerpc: | ok | | powerpc: | ok |
| riscv: | TODO | | riscv: | ok |
| s390: | ok | | s390: | ok |
| sh: | TODO | | sh: | TODO |
| sparc: | ok | | sparc: | ok |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | TODO | | arm: | TODO |
| arm64: | TODO | | arm64: | TODO |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | TODO | | arm: | TODO |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | ok | | hexagon: | ok |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | TODO | | arm: | TODO |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | TODO | | arm: | TODO |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | ok | | hexagon: | ok |
...@@ -23,7 +22,7 @@ ...@@ -23,7 +22,7 @@
| openrisc: | TODO | | openrisc: | TODO |
| parisc: | ok | | parisc: | ok |
| powerpc: | ok | | powerpc: | ok |
| riscv: | TODO | | riscv: | ok |
| s390: | ok | | s390: | ok |
| sh: | ok | | sh: | ok |
| sparc: | ok | | sparc: | ok |
......
...@@ -10,14 +10,13 @@ ...@@ -10,14 +10,13 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
| ia64: | TODO | | ia64: | TODO |
| m68k: | TODO | | m68k: | TODO |
| microblaze: | TODO | | microblaze: | TODO |
| mips: | TODO | | mips: | ok |
| nds32: | TODO | | nds32: | TODO |
| nios2: | TODO | | nios2: | TODO |
| openrisc: | TODO | | openrisc: | TODO |
......
...@@ -10,14 +10,13 @@ ...@@ -10,14 +10,13 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
| ia64: | TODO | | ia64: | TODO |
| m68k: | TODO | | m68k: | TODO |
| microblaze: | TODO | | microblaze: | TODO |
| mips: | TODO | | mips: | ok |
| nds32: | TODO | | nds32: | TODO |
| nios2: | TODO | | nios2: | TODO |
| openrisc: | TODO | | openrisc: | TODO |
......
...@@ -33,7 +33,6 @@ ...@@ -33,7 +33,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | .. | | arc: | .. |
| arm: | .. | | arm: | .. |
| arm64: | ok | | arm64: | ok |
| c6x: | .. |
| csky: | .. | | csky: | .. |
| h8300: | .. | | h8300: | .. |
| hexagon: | .. | | hexagon: | .. |
...@@ -23,7 +22,7 @@ ...@@ -23,7 +22,7 @@
| openrisc: | .. | | openrisc: | .. |
| parisc: | .. | | parisc: | .. |
| powerpc: | ok | | powerpc: | ok |
| riscv: | TODO | | riscv: | ok |
| s390: | ok | | s390: | ok |
| sh: | .. | | sh: | .. |
| sparc: | TODO | | sparc: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | TODO | | arm: | TODO |
| arm64: | ok | | arm64: | ok |
| c6x: | ok |
| csky: | ok | | csky: | ok |
| h8300: | ok | | h8300: | ok |
| hexagon: | ok | | hexagon: | ok |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | ok | | csky: | ok |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | TODO | | arm: | TODO |
| arm64: | TODO | | arm64: | TODO |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | .. |
| csky: | .. | | csky: | .. |
| h8300: | .. | | h8300: | .. |
| hexagon: | .. | | hexagon: | .. |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | TODO | | arm: | TODO |
| arm64: | TODO | | arm64: | TODO |
| c6x: | .. |
| csky: | TODO | | csky: | TODO |
| h8300: | .. | | h8300: | .. |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | TODO | | arc: | TODO |
| arm: | TODO | | arm: | TODO |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | TODO | | arm: | TODO |
| arm64: | TODO | | arm64: | TODO |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -10,7 +10,6 @@ ...@@ -10,7 +10,6 @@
| arc: | ok | | arc: | ok |
| arm: | ok | | arm: | ok |
| arm64: | ok | | arm64: | ok |
| c6x: | TODO |
| csky: | TODO | | csky: | TODO |
| h8300: | TODO | | h8300: | TODO |
| hexagon: | TODO | | hexagon: | TODO |
......
...@@ -691,6 +691,10 @@ files are there, and which are missing. ...@@ -691,6 +691,10 @@ files are there, and which are missing.
number of processes currently runnable (running or on ready queue); number of processes currently runnable (running or on ready queue);
total number of processes in system; total number of processes in system;
last pid created. last pid created.
All fields are separated by one space except "number of
processes currently runnable" and "total number of processes
in system", which are separated by a slash ('/'). Example:
0.61 0.61 0.55 3/828 22084
locks Kernel locks locks Kernel locks
meminfo Memory info meminfo Memory info
misc Miscellaneous misc Miscellaneous
......
...@@ -46,25 +46,38 @@ stack frame LR and CR save fields are not used. ...@@ -46,25 +46,38 @@ stack frame LR and CR save fields are not used.
Register preservation rules Register preservation rules
--------------------------- ---------------------------
Register preservation rules match the ELF ABI calling sequence with the Register preservation rules match the ELF ABI calling sequence with some
following differences: differences.
+------------------------------------------------------------------------+ For the sc instruction, the differences from the ELF ABI are as follows:
| For the sc instruction, differences with the ELF ABI |
+--------------+--------------+------------------------------------------+ +--------------+--------------------+-----------------------------------------+
| r0 | Volatile | (System call number.) | | Register | Preservation Rules | Purpose |
| rr3 | Volatile | (Parameter 1, and return value.) | +==============+====================+=========================================+
| rr4-r8 | Volatile | (Parameters 2-6.) | | r0 | Volatile | (System call number.) |
| rcr0 | Volatile | (cr0.SO is the return error condition.) | +--------------+--------------------+-----------------------------------------+
| rcr1, cr5-7 | Nonvolatile | | | r3 | Volatile | (Parameter 1, and return value.) |
| rlr | Nonvolatile | | +--------------+--------------------+-----------------------------------------+
+--------------+--------------+------------------------------------------+ | r4-r8 | Volatile | (Parameters 2-6.) |
| For the scv 0 instruction, differences with the ELF ABI | +--------------+--------------------+-----------------------------------------+
+--------------+--------------+------------------------------------------+ | cr0 | Volatile | (cr0.SO is the return error condition.) |
| r0 | Volatile | (System call number.) | +--------------+--------------------+-----------------------------------------+
| r3 | Volatile | (Parameter 1, and return value.) | | cr1, cr5-7 | Nonvolatile | |
| r4-r8 | Volatile | (Parameters 2-6.) | +--------------+--------------------+-----------------------------------------+
+--------------+--------------+------------------------------------------+ | lr | Nonvolatile | |
+--------------+--------------------+-----------------------------------------+
For the scv 0 instruction, the differences from the ELF ABI are as follows:
+--------------+--------------------+-----------------------------------------+
| Register | Preservation Rules | Purpose |
+==============+====================+=========================================+
| r0 | Volatile | (System call number.) |
+--------------+--------------------+-----------------------------------------+
| r3 | Volatile | (Parameter 1, and return value.) |
+--------------+--------------------+-----------------------------------------+
| r4-r8 | Volatile | (Parameters 2-6.) |
+--------------+--------------------+-----------------------------------------+
All floating point and vector data registers as well as control and status All floating point and vector data registers as well as control and status
registers are nonvolatile. registers are nonvolatile.
......
...@@ -242,7 +242,7 @@ and try to avoid "fixes" which make the warning go away without addressing ...@@ -242,7 +242,7 @@ and try to avoid "fixes" which make the warning go away without addressing
its cause. its cause.
Note that not all compiler warnings are enabled by default. Build the Note that not all compiler warnings are enabled by default. Build the
kernel with "make EXTRA_CFLAGS=-W" to get the full set. kernel with "make KCFLAGS=-W" to get the full set.
The kernel provides several configuration options which turn on debugging The kernel provides several configuration options which turn on debugging
features; most of these are found in the "kernel hacking" submenu. Several features; most of these are found in the "kernel hacking" submenu. Several
......
...@@ -96,7 +96,7 @@ and elsewhere regarding submitting Linux kernel patches. ...@@ -96,7 +96,7 @@ and elsewhere regarding submitting Linux kernel patches.
injection might be appropriate. injection might be appropriate.
20) Newly-added code has been compiled with ``gcc -W`` (use 20) Newly-added code has been compiled with ``gcc -W`` (use
``make EXTRA_CFLAGS=-W``). This will generate lots of noise, but is good ``make KCFLAGS=-W``). This will generate lots of noise, but is good
for finding bugs like "warning: comparison between signed and unsigned". for finding bugs like "warning: comparison between signed and unsigned".
21) Tested after it has been merged into the -mm patchset to make sure 21) Tested after it has been merged into the -mm patchset to make sure
......
...@@ -256,7 +256,7 @@ e cercate di evitare le "riparazioni" che fan sparire l'avvertimento senza ...@@ -256,7 +256,7 @@ e cercate di evitare le "riparazioni" che fan sparire l'avvertimento senza
però averne trovato la causa. però averne trovato la causa.
Tenete a mente che non tutti gli avvertimenti sono disabilitati di default. Tenete a mente che non tutti gli avvertimenti sono disabilitati di default.
Costruite il kernel con "make EXTRA_CFLAGS=-W" per ottenerli tutti. Costruite il kernel con "make KCFLAGS=-W" per ottenerli tutti.
Il kernel fornisce differenti opzioni che abilitano funzionalità di debugging; Il kernel fornisce differenti opzioni che abilitano funzionalità di debugging;
molti di queste sono trovano all'interno del sotto menu "kernel hacking". molti di queste sono trovano all'interno del sotto menu "kernel hacking".
......
...@@ -104,7 +104,7 @@ sottomissione delle patch, in particolare ...@@ -104,7 +104,7 @@ sottomissione delle patch, in particolare
l'iniezione di fallimenti specifici per il sottosistema. l'iniezione di fallimenti specifici per il sottosistema.
22) Il nuovo codice è stato compilato con ``gcc -W`` (usate 22) Il nuovo codice è stato compilato con ``gcc -W`` (usate
``make EXTRA_CFLAGS=-W``). Questo genererà molti avvisi, ma è ottimo ``make KCFLAGS=-W``). Questo genererà molti avvisi, ma è ottimo
per scovare bachi come "warning: comparison between signed and unsigned". per scovare bachi come "warning: comparison between signed and unsigned".
23) La patch è stata verificata dopo essere stata inclusa nella serie di patch 23) La patch è stata verificata dopo essere stata inclusa nella serie di patch
......
...@@ -165,7 +165,7 @@ Linus对这个问题给出了最佳答案: ...@@ -165,7 +165,7 @@ Linus对这个问题给出了最佳答案:
通常,这些警告都指向真正的问题。提交以供审阅的代码通常不会产生任何编译器警告。 通常,这些警告都指向真正的问题。提交以供审阅的代码通常不会产生任何编译器警告。
在消除警告时,注意了解真正的原因,并尽量避免“修复”,使警告消失而不解决其原因。 在消除警告时,注意了解真正的原因,并尽量避免“修复”,使警告消失而不解决其原因。
请注意,并非所有编译器警告都默认启用。使用“make EXTRA_CFLAGS=-W”构建内核以 请注意,并非所有编译器警告都默认启用。使用“make KCFLAGS=-W”构建内核以
获得完整集合。 获得完整集合。
内核提供了几个配置选项,可以打开调试功能;大多数配置选项位于“kernel hacking” 内核提供了几个配置选项,可以打开调试功能;大多数配置选项位于“kernel hacking”
......
# SPDX-License-Identifier: GPL-2.0 # SPDX-License-Identifier: GPL-2.0
ifeq (, $(findstring -W,$(EXTRA_CFLAGS))) ifeq (, $(findstring -W,$(KCFLAGS)))
ccflags-y += -Werror ccflags-y += -Werror
endif endif
......
...@@ -1553,7 +1553,7 @@ sub create_parameterlist($$$$) { ...@@ -1553,7 +1553,7 @@ sub create_parameterlist($$$$) {
} elsif ($arg =~ m/\(.+\)\s*\(/) { } elsif ($arg =~ m/\(.+\)\s*\(/) {
# pointer-to-function # pointer-to-function
$arg =~ tr/#/,/; $arg =~ tr/#/,/;
$arg =~ m/[^\(]+\(\*?\s*([\w\.]*)\s*\)/; $arg =~ m/[^\(]+\(\*?\s*([\w\[\]\.]*)\s*\)/;
$param = $1; $param = $1;
$type = $arg; $type = $arg;
$type =~ s/([^\(]+\(\*?)\s*$param/$1/; $type =~ s/([^\(]+\(\*?)\s*$param/$1/;
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment