1 /* SPDX-License-Identifier: GPL-2.0 */
3 * pasid.h - PASID idr, table and entry header
5 * Copyright (C) 2018 Intel Corporation
10 #ifndef __INTEL_PASID_H
11 #define __INTEL_PASID_H
13 #define PASID_RID2PASID 0x0
15 #define PASID_MAX 0x100000
16 #define PASID_PTE_MASK 0x3F
17 #define PASID_PTE_PRESENT 1
18 #define PASID_PTE_FPD 2
19 #define PDE_PFN_MASK PAGE_MASK
20 #define PASID_PDE_SHIFT 6
21 #define MAX_NR_PASID_BITS 20
22 #define PASID_TBL_ENTRIES BIT(PASID_PDE_SHIFT)
24 #define is_pasid_enabled(entry) (((entry)->lo >> 3) & 0x1)
25 #define get_pasid_dir_size(entry) (1 << ((((entry)->lo >> 9) & 0x7) + 7))
27 /* Virtual command interface for enlightened pasid management. */
28 #define VCMD_CMD_ALLOC 0x1
29 #define VCMD_CMD_FREE 0x2
30 #define VCMD_VRSP_IP 0x1
31 #define VCMD_VRSP_SC(e) (((e) & 0xff) >> 1)
32 #define VCMD_VRSP_SC_SUCCESS 0
33 #define VCMD_VRSP_SC_NO_PASID_AVAIL 16
34 #define VCMD_VRSP_SC_INVALID_PASID 16
35 #define VCMD_VRSP_RESULT_PASID(e) (((e) >> 16) & 0xfffff)
36 #define VCMD_CMD_OPERAND(e) ((e) << 16)
38 * Domain ID reserved for pasid entries programmed for first-level
39 * only and pass-through transfer modes.
41 #define FLPT_DEFAULT_DID 1
42 #define NUM_RESERVED_DID 2
45 * The SUPERVISOR_MODE flag indicates a first level translation which
46 * can be used for access to kernel addresses. It is valid only for
47 * access to the kernel's static 1:1 mapping of physical memory — not
48 * to vmalloc or even module mappings.
50 #define PASID_FLAG_SUPERVISOR_MODE BIT(0)
51 #define PASID_FLAG_NESTED BIT(1)
52 #define PASID_FLAG_PAGE_SNOOP BIT(2)
55 * The PASID_FLAG_FL5LP flag Indicates using 5-level paging for first-
56 * level translation, otherwise, 4-level paging will be used.
58 #define PASID_FLAG_FL5LP BIT(1)
60 struct pasid_dir_entry {
68 #define PASID_ENTRY_PGTT_FL_ONLY (1)
69 #define PASID_ENTRY_PGTT_SL_ONLY (2)
70 #define PASID_ENTRY_PGTT_NESTED (3)
71 #define PASID_ENTRY_PGTT_PT (4)
73 /* The representative of a PASID table */
75 void *table; /* pasid table pointer */
76 int order; /* page order of pasid table */
77 u32 max_pasid; /* max pasid */
80 /* Get PRESENT bit of a PASID directory entry. */
81 static inline bool pasid_pde_is_present(struct pasid_dir_entry *pde)
83 return READ_ONCE(pde->val) & PASID_PTE_PRESENT;
86 /* Get PASID table from a PASID directory entry. */
87 static inline struct pasid_entry *
88 get_pasid_table_from_pde(struct pasid_dir_entry *pde)
90 if (!pasid_pde_is_present(pde))
93 return phys_to_virt(READ_ONCE(pde->val) & PDE_PFN_MASK);
96 /* Get PRESENT bit of a PASID table entry. */
97 static inline bool pasid_pte_is_present(struct pasid_entry *pte)
99 return READ_ONCE(pte->val[0]) & PASID_PTE_PRESENT;
102 /* Get PGTT field of a PASID table entry */
103 static inline u16 pasid_pte_get_pgtt(struct pasid_entry *pte)
105 return (u16)((READ_ONCE(pte->val[0]) >> 6) & 0x7);
108 extern unsigned int intel_pasid_max_id;
109 int intel_pasid_alloc_table(struct device *dev);
110 void intel_pasid_free_table(struct device *dev);
111 struct pasid_table *intel_pasid_get_table(struct device *dev);
112 int intel_pasid_setup_first_level(struct intel_iommu *iommu,
113 struct device *dev, pgd_t *pgd,
114 u32 pasid, u16 did, int flags);
115 int intel_pasid_setup_second_level(struct intel_iommu *iommu,
116 struct dmar_domain *domain,
117 struct device *dev, u32 pasid);
118 int intel_pasid_setup_pass_through(struct intel_iommu *iommu,
119 struct dmar_domain *domain,
120 struct device *dev, u32 pasid);
121 void intel_pasid_tear_down_entry(struct intel_iommu *iommu,
122 struct device *dev, u32 pasid,
124 int vcmd_alloc_pasid(struct intel_iommu *iommu, u32 *pasid);
125 void vcmd_free_pasid(struct intel_iommu *iommu, u32 pasid);
126 void intel_pasid_setup_page_snoop_control(struct intel_iommu *iommu,
127 struct device *dev, u32 pasid);
128 #endif /* __INTEL_PASID_H */