mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-11-11 12:28:41 +08:00
2a5303b499
When adding the ISA string ordering rules, I didn't sufficiently indent
one of the list items.
Reported-by: kernel test robot <lkp@intel.com>
Link: https://lore.kernel.org/linux-doc/202301300743.bp7Dpazv-lkp@intel.com/
Fixes: f07b2b3f9d ("Documentation: riscv: add a section about ISA string ordering in /proc/cpuinfo")
Signed-off-by: Conor Dooley <conor.dooley@microchip.com>
Reviewed-by: Bagas Sanjaya <bagasdotme@gmail.com>
Link: https://lore.kernel.org/r/20230129235701.2393241-1-conor@kernel.org
Signed-off-by: Palmer Dabbelt <palmer@rivosinc.com>
49 lines
1.9 KiB
ReStructuredText
49 lines
1.9 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
RISC-V Linux User ABI
|
|
=====================
|
|
|
|
ISA string ordering in /proc/cpuinfo
|
|
------------------------------------
|
|
|
|
The canonical order of ISA extension names in the ISA string is defined in
|
|
chapter 27 of the unprivileged specification.
|
|
The specification uses vague wording, such as should, when it comes to ordering,
|
|
so for our purposes the following rules apply:
|
|
|
|
#. Single-letter extensions come first, in canonical order.
|
|
The canonical order is "IMAFDQLCBKJTPVH".
|
|
|
|
#. All multi-letter extensions will be separated from other extensions by an
|
|
underscore.
|
|
|
|
#. Additional standard extensions (starting with 'Z') will be sorted after
|
|
single-letter extensions and before any higher-privileged extensions.
|
|
|
|
#. For additional standard extensions, the first letter following the 'Z'
|
|
conventionally indicates the most closely related alphabetical
|
|
extension category. If multiple 'Z' extensions are named, they will be
|
|
ordered first by category, in canonical order, as listed above, then
|
|
alphabetically within a category.
|
|
|
|
#. Standard supervisor-level extensions (starting with 'S') will be listed
|
|
after standard unprivileged extensions. If multiple supervisor-level
|
|
extensions are listed, they will be ordered alphabetically.
|
|
|
|
#. Standard machine-level extensions (starting with 'Zxm') will be listed
|
|
after any lower-privileged, standard extensions. If multiple machine-level
|
|
extensions are listed, they will be ordered alphabetically.
|
|
|
|
#. Non-standard extensions (starting with 'X') will be listed after all standard
|
|
extensions. If multiple non-standard extensions are listed, they will be
|
|
ordered alphabetically.
|
|
|
|
An example string following the order is::
|
|
|
|
rv64imadc_zifoo_zigoo_zafoo_sbar_scar_zxmbaz_xqux_xrux
|
|
|
|
Misaligned accesses
|
|
-------------------
|
|
|
|
Misaligned accesses are supported in userspace, but they may perform poorly.
|