doc: RISC-V: Document that misaligned accesses are supported
authorPalmer Dabbelt <palmer@rivosinc.com>
Thu, 28 Jul 2022 21:07:15 +0000 (14:07 -0700)
committerPalmer Dabbelt <palmer@rivosinc.com>
Wed, 12 Oct 2022 15:58:10 +0000 (08:58 -0700)
The RISC-V ISA manual used to mandate that misaligned accesses were
supported in user mode, but that requirement was removed in 2018 via
riscv-isa-manual commit 61cadb9 ("Provide new description of misaligned
load/store behavior compatible with privileged architecture.").  Since
the Linux uABI was already frozen at that point it's just been demoted
to part of the uABI, but that was never written down.

Link: https://lore.kernel.org/r/20220728210715.17214-1-palmer@rivosinc.com
Signed-off-by: Palmer Dabbelt <palmer@rivosinc.com>
Documentation/riscv/index.rst
Documentation/riscv/uabi.rst [new file with mode: 0644]

index e23b876..2e5b18f 100644 (file)
@@ -8,6 +8,7 @@ RISC-V architecture
     boot-image-header
     vm-layout
     patch-acceptance
+    uabi
 
     features
 
diff --git a/Documentation/riscv/uabi.rst b/Documentation/riscv/uabi.rst
new file mode 100644 (file)
index 0000000..21a82cf
--- /dev/null
@@ -0,0 +1,6 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+RISC-V Linux User ABI
+=====================
+
+Misaligned accesses are supported in userspace, but they may perform poorly.