]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
iommupt: Add the RISC-V page table format
authorJason Gunthorpe <jgg@nvidia.com>
Fri, 27 Feb 2026 15:25:36 +0000 (11:25 -0400)
committerJoerg Roedel <joerg.roedel@amd.com>
Tue, 17 Mar 2026 12:14:21 +0000 (13:14 +0100)
The RISC-V format is a fairly simple 5 level page table not unlike the x86
one. It has optional support for a single contiguous page size of 64k (16
x 4k).

The specification describes a 32-bit format, the general code can support
it via a #define but the iommu side implementation has been left off until
a user comes.

Tested-by: Vincent Chen <vincent.chen@sifive.com>
Acked-by: Paul Walmsley <pjw@kernel.org> # arch/riscv
Reviewed-by: Tomasz Jeznach <tjeznach@rivosinc.com>
Tested-by: Tomasz Jeznach <tjeznach@rivosinc.com>
Signed-off-by: Jason Gunthorpe <jgg@nvidia.com>
Signed-off-by: Joerg Roedel <joerg.roedel@amd.com>
drivers/iommu/generic_pt/.kunitconfig
drivers/iommu/generic_pt/Kconfig
drivers/iommu/generic_pt/fmt/Makefile
drivers/iommu/generic_pt/fmt/defs_riscv.h [new file with mode: 0644]
drivers/iommu/generic_pt/fmt/iommu_riscv64.c [new file with mode: 0644]
drivers/iommu/generic_pt/fmt/riscv.h [new file with mode: 0644]
include/linux/generic_pt/common.h
include/linux/generic_pt/iommu.h

index a78b295f264d2300f9797d93b904b7e7f7eac2fd..0bb98fe581fe9c86b69ca8e31d6b3936e975fb8f 100644 (file)
@@ -5,6 +5,7 @@ CONFIG_DEBUG_GENERIC_PT=y
 CONFIG_IOMMU_PT=y
 CONFIG_IOMMU_PT_AMDV1=y
 CONFIG_IOMMU_PT_VTDSS=y
+CONFIG_IOMMU_PT_RISCV64=y
 CONFIG_IOMMU_PT_X86_64=y
 CONFIG_IOMMU_PT_KUNIT_TEST=y
 
index ce4fb478691457e1305e7982fdf220574d9de314..f4ed1add58b749f915a0060583364021ba637518 100644 (file)
@@ -52,6 +52,16 @@ config IOMMU_PT_VTDSS
 
          Selected automatically by an IOMMU driver that uses this format.
 
+config IOMMU_PT_RISCV64
+       tristate "IOMMU page table for RISC-V 64 bit Sv57/Sv48/Sv39"
+       depends on !GENERIC_ATOMIC64 # for cmpxchg64
+       help
+         iommu_domain implementation for RISC-V 64 bit 3/4/5 level page table.
+         It supports 4K/2M/1G/512G/256T page sizes and can decode a sign
+         extended portion of the 64 bit IOVA space.
+
+         Selected automatically by an IOMMU driver that uses this format.
+
 config IOMMU_PT_X86_64
        tristate "IOMMU page table for x86 64-bit, 4/5 levels"
        depends on !GENERIC_ATOMIC64 # for cmpxchg64
@@ -66,6 +76,7 @@ config IOMMU_PT_KUNIT_TEST
        tristate "IOMMU Page Table KUnit Test" if !KUNIT_ALL_TESTS
        depends on KUNIT
        depends on IOMMU_PT_AMDV1 || !IOMMU_PT_AMDV1
+       depends on IOMMU_PT_RISCV64 || !IOMMU_PT_RISCV64
        depends on IOMMU_PT_X86_64 || !IOMMU_PT_X86_64
        depends on IOMMU_PT_VTDSS || !IOMMU_PT_VTDSS
        default KUNIT_ALL_TESTS
index 976b49ec97dca120839765e41cae7dc3a11d4401..ea024d582594eee20b87168ade63c047d53d6c38 100644 (file)
@@ -5,6 +5,8 @@ iommu_pt_fmt-$(CONFIG_IOMMUFD_TEST) += mock
 
 iommu_pt_fmt-$(CONFIG_IOMMU_PT_VTDSS) += vtdss
 
+iommu_pt_fmt-$(CONFIG_IOMMU_PT_RISCV64) += riscv64
+
 iommu_pt_fmt-$(CONFIG_IOMMU_PT_X86_64) += x86_64
 
 IOMMU_PT_KUNIT_TEST :=
diff --git a/drivers/iommu/generic_pt/fmt/defs_riscv.h b/drivers/iommu/generic_pt/fmt/defs_riscv.h
new file mode 100644 (file)
index 0000000..cf67474
--- /dev/null
@@ -0,0 +1,29 @@
+/* SPDX-License-Identifier: GPL-2.0-only */
+/*
+ * Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES
+ *
+ */
+#ifndef __GENERIC_PT_FMT_DEFS_RISCV_H
+#define __GENERIC_PT_FMT_DEFS_RISCV_H
+
+#include <linux/generic_pt/common.h>
+#include <linux/types.h>
+
+#ifdef PT_RISCV_32BIT
+typedef u32 pt_riscv_entry_t;
+#define riscvpt_write_attrs riscv32pt_write_attrs
+#else
+typedef u64 pt_riscv_entry_t;
+#define riscvpt_write_attrs riscv64pt_write_attrs
+#endif
+
+typedef pt_riscv_entry_t pt_vaddr_t;
+typedef u64 pt_oaddr_t;
+
+struct riscvpt_write_attrs {
+       pt_riscv_entry_t descriptor_bits;
+       gfp_t gfp;
+};
+#define pt_write_attrs riscvpt_write_attrs
+
+#endif
diff --git a/drivers/iommu/generic_pt/fmt/iommu_riscv64.c b/drivers/iommu/generic_pt/fmt/iommu_riscv64.c
new file mode 100644 (file)
index 0000000..cbf60ff
--- /dev/null
@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: GPL-2.0-only
+/*
+ * Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES
+ */
+#define PT_FMT riscv
+#define PT_FMT_VARIANT 64
+#define PT_SUPPORTED_FEATURES                                  \
+       (BIT(PT_FEAT_SIGN_EXTEND) | BIT(PT_FEAT_FLUSH_RANGE) | \
+        BIT(PT_FEAT_RISCV_SVNAPOT_64K))
+
+#include "iommu_template.h"
diff --git a/drivers/iommu/generic_pt/fmt/riscv.h b/drivers/iommu/generic_pt/fmt/riscv.h
new file mode 100644 (file)
index 0000000..a7fef62
--- /dev/null
@@ -0,0 +1,313 @@
+/* SPDX-License-Identifier: GPL-2.0-only */
+/*
+ * Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES
+ *
+ * RISC-V page table
+ *
+ * This is described in Sections:
+ *  12.3. Sv32: Page-Based 32-bit Virtual-Memory Systems
+ *  12.4. Sv39: Page-Based 39-bit Virtual-Memory System
+ *  12.5. Sv48: Page-Based 48-bit Virtual-Memory System
+ *  12.6. Sv57: Page-Based 57-bit Virtual-Memory System
+ * of the "The RISC-V Instruction Set Manual: Volume II"
+ *
+ * This includes the contiguous page extension from:
+ *  Chapter 13. "Svnapot" Extension for NAPOT Translation Contiguity,
+ *     Version 1.0
+ *
+ * The table format is sign extended and supports leafs in every level. The spec
+ * doesn't talk a lot about levels, but level here is the same as i=LEVELS-1 in
+ * the spec.
+ */
+#ifndef __GENERIC_PT_FMT_RISCV_H
+#define __GENERIC_PT_FMT_RISCV_H
+
+#include "defs_riscv.h"
+#include "../pt_defs.h"
+
+#include <linux/bitfield.h>
+#include <linux/container_of.h>
+#include <linux/log2.h>
+#include <linux/sizes.h>
+
+enum {
+       PT_ITEM_WORD_SIZE = sizeof(pt_riscv_entry_t),
+#ifdef PT_RISCV_32BIT
+       PT_MAX_VA_ADDRESS_LG2 = 32,
+       PT_MAX_OUTPUT_ADDRESS_LG2 = 34,
+       PT_MAX_TOP_LEVEL = 1,
+#else
+       PT_MAX_VA_ADDRESS_LG2 = 57,
+       PT_MAX_OUTPUT_ADDRESS_LG2 = 56,
+       PT_MAX_TOP_LEVEL = 4,
+#endif
+       PT_GRANULE_LG2SZ = 12,
+       PT_TABLEMEM_LG2SZ = 12,
+
+       /* fsc.PPN is 44 bits wide, all PPNs are 4k aligned */
+       PT_TOP_PHYS_MASK = GENMASK_ULL(55, 12),
+};
+
+/* PTE bits */
+enum {
+       RISCVPT_V = BIT(0),
+       RISCVPT_R = BIT(1),
+       RISCVPT_W = BIT(2),
+       RISCVPT_X = BIT(3),
+       RISCVPT_U = BIT(4),
+       RISCVPT_G = BIT(5),
+       RISCVPT_A = BIT(6),
+       RISCVPT_D = BIT(7),
+       RISCVPT_RSW = GENMASK(9, 8),
+       RISCVPT_PPN32 = GENMASK(31, 10),
+
+       RISCVPT_PPN64 = GENMASK_ULL(53, 10),
+       RISCVPT_PPN64_64K = GENMASK_ULL(53, 14),
+       RISCVPT_PBMT = GENMASK_ULL(62, 61),
+       RISCVPT_N = BIT_ULL(63),
+
+       /* Svnapot encodings for ppn[0] */
+       RISCVPT_PPN64_64K_SZ = BIT(13),
+};
+
+#ifdef PT_RISCV_32BIT
+#define RISCVPT_PPN RISCVPT_PPN32
+#define pt_riscv pt_riscv_32
+#else
+#define RISCVPT_PPN RISCVPT_PPN64
+#define pt_riscv pt_riscv_64
+#endif
+
+#define common_to_riscvpt(common_ptr) \
+       container_of_const(common_ptr, struct pt_riscv, common)
+#define to_riscvpt(pts) common_to_riscvpt((pts)->range->common)
+
+static inline pt_oaddr_t riscvpt_table_pa(const struct pt_state *pts)
+{
+       return oalog2_mul(FIELD_GET(RISCVPT_PPN, pts->entry), PT_GRANULE_LG2SZ);
+}
+#define pt_table_pa riscvpt_table_pa
+
+static inline pt_oaddr_t riscvpt_entry_oa(const struct pt_state *pts)
+{
+       if (pts_feature(pts, PT_FEAT_RISCV_SVNAPOT_64K) &&
+           pts->entry & RISCVPT_N) {
+               PT_WARN_ON(pts->level != 0);
+               return oalog2_mul(FIELD_GET(RISCVPT_PPN64_64K, pts->entry),
+                                 ilog2(SZ_64K));
+       }
+       return oalog2_mul(FIELD_GET(RISCVPT_PPN, pts->entry), PT_GRANULE_LG2SZ);
+}
+#define pt_entry_oa riscvpt_entry_oa
+
+static inline bool riscvpt_can_have_leaf(const struct pt_state *pts)
+{
+       return true;
+}
+#define pt_can_have_leaf riscvpt_can_have_leaf
+
+/* Body in pt_fmt_defaults.h */
+static inline unsigned int pt_table_item_lg2sz(const struct pt_state *pts);
+
+static inline unsigned int
+riscvpt_entry_num_contig_lg2(const struct pt_state *pts)
+{
+       if (PT_SUPPORTED_FEATURE(PT_FEAT_RISCV_SVNAPOT_64K) &&
+           pts->entry & RISCVPT_N) {
+               PT_WARN_ON(!pts_feature(pts, PT_FEAT_RISCV_SVNAPOT_64K));
+               PT_WARN_ON(pts->level);
+               return ilog2(16);
+       }
+       return ilog2(1);
+}
+#define pt_entry_num_contig_lg2 riscvpt_entry_num_contig_lg2
+
+static inline unsigned int riscvpt_num_items_lg2(const struct pt_state *pts)
+{
+       return PT_TABLEMEM_LG2SZ - ilog2(sizeof(u64));
+}
+#define pt_num_items_lg2 riscvpt_num_items_lg2
+
+static inline unsigned short
+riscvpt_contig_count_lg2(const struct pt_state *pts)
+{
+       if (pts->level == 0 && pts_feature(pts, PT_FEAT_RISCV_SVNAPOT_64K))
+               return ilog2(16);
+       return ilog2(1);
+}
+#define pt_contig_count_lg2 riscvpt_contig_count_lg2
+
+static inline enum pt_entry_type riscvpt_load_entry_raw(struct pt_state *pts)
+{
+       const pt_riscv_entry_t *tablep = pt_cur_table(pts, pt_riscv_entry_t);
+       pt_riscv_entry_t entry;
+
+       pts->entry = entry = READ_ONCE(tablep[pts->index]);
+       if (!(entry & RISCVPT_V))
+               return PT_ENTRY_EMPTY;
+       if (pts->level == 0 ||
+           ((entry & (RISCVPT_X | RISCVPT_W | RISCVPT_R)) != 0))
+               return PT_ENTRY_OA;
+       return PT_ENTRY_TABLE;
+}
+#define pt_load_entry_raw riscvpt_load_entry_raw
+
+static inline void
+riscvpt_install_leaf_entry(struct pt_state *pts, pt_oaddr_t oa,
+                          unsigned int oasz_lg2,
+                          const struct pt_write_attrs *attrs)
+{
+       pt_riscv_entry_t *tablep = pt_cur_table(pts, pt_riscv_entry_t);
+       pt_riscv_entry_t entry;
+
+       if (!pt_check_install_leaf_args(pts, oa, oasz_lg2))
+               return;
+
+       entry = RISCVPT_V |
+               FIELD_PREP(RISCVPT_PPN, log2_div(oa, PT_GRANULE_LG2SZ)) |
+               attrs->descriptor_bits;
+
+       if (pts_feature(pts, PT_FEAT_RISCV_SVNAPOT_64K) && pts->level == 0 &&
+           oasz_lg2 != PT_GRANULE_LG2SZ) {
+               u64 *end;
+
+               entry |= RISCVPT_N | RISCVPT_PPN64_64K_SZ;
+               tablep += pts->index;
+               end = tablep + log2_div(SZ_64K, PT_GRANULE_LG2SZ);
+               for (; tablep != end; tablep++)
+                       WRITE_ONCE(*tablep, entry);
+       } else {
+               /* FIXME does riscv need this to be cmpxchg? */
+               WRITE_ONCE(tablep[pts->index], entry);
+       }
+       pts->entry = entry;
+}
+#define pt_install_leaf_entry riscvpt_install_leaf_entry
+
+static inline bool riscvpt_install_table(struct pt_state *pts,
+                                        pt_oaddr_t table_pa,
+                                        const struct pt_write_attrs *attrs)
+{
+       pt_riscv_entry_t entry;
+
+       entry = RISCVPT_V |
+               FIELD_PREP(RISCVPT_PPN, log2_div(table_pa, PT_GRANULE_LG2SZ));
+       return pt_table_install64(pts, entry);
+}
+#define pt_install_table riscvpt_install_table
+
+static inline void riscvpt_attr_from_entry(const struct pt_state *pts,
+                                          struct pt_write_attrs *attrs)
+{
+       attrs->descriptor_bits =
+               pts->entry & (RISCVPT_R | RISCVPT_W | RISCVPT_X | RISCVPT_U |
+                             RISCVPT_G | RISCVPT_A | RISCVPT_D);
+}
+#define pt_attr_from_entry riscvpt_attr_from_entry
+
+/* --- iommu */
+#include <linux/generic_pt/iommu.h>
+#include <linux/iommu.h>
+
+#define pt_iommu_table pt_iommu_riscv_64
+
+/* The common struct is in the per-format common struct */
+static inline struct pt_common *common_from_iommu(struct pt_iommu *iommu_table)
+{
+       return &container_of(iommu_table, struct pt_iommu_table, iommu)
+                       ->riscv_64pt.common;
+}
+
+static inline struct pt_iommu *iommu_from_common(struct pt_common *common)
+{
+       return &container_of(common, struct pt_iommu_table, riscv_64pt.common)
+                       ->iommu;
+}
+
+static inline int riscvpt_iommu_set_prot(struct pt_common *common,
+                                        struct pt_write_attrs *attrs,
+                                        unsigned int iommu_prot)
+{
+       u64 pte;
+
+       pte = RISCVPT_A | RISCVPT_U;
+       if (iommu_prot & IOMMU_WRITE)
+               pte |= RISCVPT_W | RISCVPT_R | RISCVPT_D;
+       if (iommu_prot & IOMMU_READ)
+               pte |= RISCVPT_R;
+       if (!(iommu_prot & IOMMU_NOEXEC))
+               pte |= RISCVPT_X;
+
+       /* Caller must specify a supported combination of flags */
+       if (unlikely((pte & (RISCVPT_X | RISCVPT_W | RISCVPT_R)) == 0))
+               return -EOPNOTSUPP;
+
+       attrs->descriptor_bits = pte;
+       return 0;
+}
+#define pt_iommu_set_prot riscvpt_iommu_set_prot
+
+static inline int
+riscvpt_iommu_fmt_init(struct pt_iommu_riscv_64 *iommu_table,
+                      const struct pt_iommu_riscv_64_cfg *cfg)
+{
+       struct pt_riscv *table = &iommu_table->riscv_64pt;
+
+       switch (cfg->common.hw_max_vasz_lg2) {
+       case 39:
+               pt_top_set_level(&table->common, 2);
+               break;
+       case 48:
+               pt_top_set_level(&table->common, 3);
+               break;
+       case 57:
+               pt_top_set_level(&table->common, 4);
+               break;
+       default:
+               return -EINVAL;
+       }
+       table->common.max_oasz_lg2 =
+               min(PT_MAX_OUTPUT_ADDRESS_LG2, cfg->common.hw_max_oasz_lg2);
+       return 0;
+}
+#define pt_iommu_fmt_init riscvpt_iommu_fmt_init
+
+static inline void
+riscvpt_iommu_fmt_hw_info(struct pt_iommu_riscv_64 *table,
+                         const struct pt_range *top_range,
+                         struct pt_iommu_riscv_64_hw_info *info)
+{
+       phys_addr_t top_phys = virt_to_phys(top_range->top_table);
+
+       info->ppn = oalog2_div(top_phys, PT_GRANULE_LG2SZ);
+       PT_WARN_ON(top_phys & ~PT_TOP_PHYS_MASK);
+
+       /*
+        * See Table 3. Encodings of iosatp.MODE field" for DC.tx.SXL = 0:
+        *  8 = Sv39 = top level 2
+        *  9 = Sv38 = top level 3
+        *  10 = Sv57 = top level 4
+        */
+       info->fsc_iosatp_mode = top_range->top_level + 6;
+}
+#define pt_iommu_fmt_hw_info riscvpt_iommu_fmt_hw_info
+
+#if defined(GENERIC_PT_KUNIT)
+static const struct pt_iommu_riscv_64_cfg riscv_64_kunit_fmt_cfgs[] = {
+       [0] = { .common.features = BIT(PT_FEAT_RISCV_SVNAPOT_64K),
+               .common.hw_max_oasz_lg2 = 56,
+               .common.hw_max_vasz_lg2 = 39 },
+       [1] = { .common.features = 0,
+               .common.hw_max_oasz_lg2 = 56,
+               .common.hw_max_vasz_lg2 = 48 },
+       [2] = { .common.features = BIT(PT_FEAT_RISCV_SVNAPOT_64K),
+               .common.hw_max_oasz_lg2 = 56,
+               .common.hw_max_vasz_lg2 = 57 },
+};
+#define kunit_fmt_cfgs riscv_64_kunit_fmt_cfgs
+enum {
+       KUNIT_FMT_FEATURES = BIT(PT_FEAT_RISCV_SVNAPOT_64K),
+};
+#endif
+
+#endif
index 6a9a1acb5aad37deea93118204b34eaf59a67bb2..fc5d0b5edadc085285fcb141508e09e687cc187d 100644 (file)
@@ -175,6 +175,22 @@ enum {
        PT_FEAT_VTDSS_FORCE_WRITEABLE,
 };
 
+struct pt_riscv_32 {
+       struct pt_common common;
+};
+
+struct pt_riscv_64 {
+       struct pt_common common;
+};
+
+enum {
+       /*
+        * Support the 64k contiguous page size following the Svnapot extension.
+        */
+       PT_FEAT_RISCV_SVNAPOT_64K = PT_FEAT_FMT_START,
+
+};
+
 struct pt_x86_64 {
        struct pt_common common;
 };
index 9eefbb74efd087815c8d2e4d34f0b9c7a33de68d..49d9addb98c52c8e42da571089ff104cdb00528d 100644 (file)
@@ -275,6 +275,17 @@ struct pt_iommu_vtdss_hw_info {
 
 IOMMU_FORMAT(vtdss, vtdss_pt);
 
+struct pt_iommu_riscv_64_cfg {
+       struct pt_iommu_cfg common;
+};
+
+struct pt_iommu_riscv_64_hw_info {
+       u64 ppn;
+       u8 fsc_iosatp_mode;
+};
+
+IOMMU_FORMAT(riscv_64, riscv_64pt);
+
 struct pt_iommu_x86_64_cfg {
        struct pt_iommu_cfg common;
        /* 4 is a 57 bit 5 level table */