tdx.h

  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef _ASM_X86_SHARED_TDX_H
  3#define _ASM_X86_SHARED_TDX_H
  4
  5#include <linux/bits.h>
  6#include <linux/types.h>
  7
  8#define TDX_HYPERCALL_STANDARD  0
  9
 10#define TDX_CPUID_LEAF_ID	0x21
 11#define TDX_IDENT		"IntelTDX    "
 12
 13/* TDX module Call Leaf IDs */
 14#define TDG_VP_VMCALL			0
 15#define TDG_VP_INFO			1
 16#define TDG_MR_RTMR_EXTEND		2
 17#define TDG_VP_VEINFO_GET		3
 18#define TDG_MR_REPORT			4
 19#define TDG_MEM_PAGE_ACCEPT		6
 20#define TDG_VM_RD			7
 21#define TDG_VM_WR			8
 22
 23/* TDX attributes */
 24#define TDX_ATTR_DEBUG_BIT		0
 25#define TDX_ATTR_DEBUG			BIT_ULL(TDX_ATTR_DEBUG_BIT)
 26#define TDX_ATTR_HGS_PLUS_PROF_BIT	4
 27#define TDX_ATTR_HGS_PLUS_PROF		BIT_ULL(TDX_ATTR_HGS_PLUS_PROF_BIT)
 28#define TDX_ATTR_PERF_PROF_BIT		5
 29#define TDX_ATTR_PERF_PROF		BIT_ULL(TDX_ATTR_PERF_PROF_BIT)
 30#define TDX_ATTR_PMT_PROF_BIT		6
 31#define TDX_ATTR_PMT_PROF		BIT_ULL(TDX_ATTR_PMT_PROF_BIT)
 32#define TDX_ATTR_ICSSD_BIT		16
 33#define TDX_ATTR_ICSSD			BIT_ULL(TDX_ATTR_ICSSD_BIT)
 34#define TDX_ATTR_LASS_BIT		27
 35#define TDX_ATTR_LASS			BIT_ULL(TDX_ATTR_LASS_BIT)
 36#define TDX_ATTR_SEPT_VE_DISABLE_BIT	28
 37#define TDX_ATTR_SEPT_VE_DISABLE	BIT_ULL(TDX_ATTR_SEPT_VE_DISABLE_BIT)
 38#define TDX_ATTR_MIGRTABLE_BIT		29
 39#define TDX_ATTR_MIGRTABLE		BIT_ULL(TDX_ATTR_MIGRTABLE_BIT)
 40#define TDX_ATTR_PKS_BIT		30
 41#define TDX_ATTR_PKS			BIT_ULL(TDX_ATTR_PKS_BIT)
 42#define TDX_ATTR_KL_BIT			31
 43#define TDX_ATTR_KL			BIT_ULL(TDX_ATTR_KL_BIT)
 44#define TDX_ATTR_TPA_BIT		62
 45#define TDX_ATTR_TPA			BIT_ULL(TDX_ATTR_TPA_BIT)
 46#define TDX_ATTR_PERFMON_BIT		63
 47#define TDX_ATTR_PERFMON		BIT_ULL(TDX_ATTR_PERFMON_BIT)
 48
 49/* TDX TD-Scope Metadata. To be used by TDG.VM.WR and TDG.VM.RD */
 50#define TDCS_CONFIG_FLAGS		0x1110000300000016
 51#define TDCS_TD_CTLS			0x1110000300000017
 52#define TDCS_NOTIFY_ENABLES		0x9100000000000010
 53#define TDCS_TOPOLOGY_ENUM_CONFIGURED	0x9100000000000019
 54
 55/* TDCS_CONFIG_FLAGS bits */
 56#define TDCS_CONFIG_FLEXIBLE_PENDING_VE	BIT_ULL(1)
 57
 58/* TDCS_TD_CTLS bits */
 59#define TD_CTLS_PENDING_VE_DISABLE_BIT	0
 60#define TD_CTLS_PENDING_VE_DISABLE	BIT_ULL(TD_CTLS_PENDING_VE_DISABLE_BIT)
 61#define TD_CTLS_ENUM_TOPOLOGY_BIT	1
 62#define TD_CTLS_ENUM_TOPOLOGY		BIT_ULL(TD_CTLS_ENUM_TOPOLOGY_BIT)
 63#define TD_CTLS_VIRT_CPUID2_BIT		2
 64#define TD_CTLS_VIRT_CPUID2		BIT_ULL(TD_CTLS_VIRT_CPUID2_BIT)
 65#define TD_CTLS_REDUCE_VE_BIT		3
 66#define TD_CTLS_REDUCE_VE		BIT_ULL(TD_CTLS_REDUCE_VE_BIT)
 67#define TD_CTLS_LOCK_BIT		63
 68#define TD_CTLS_LOCK			BIT_ULL(TD_CTLS_LOCK_BIT)
 69
 70/* TDX hypercall Leaf IDs */
 71#define TDVMCALL_GET_TD_VM_CALL_INFO	0x10000
 72#define TDVMCALL_MAP_GPA		0x10001
 73#define TDVMCALL_GET_QUOTE		0x10002
 74#define TDVMCALL_REPORT_FATAL_ERROR	0x10003
 75#define TDVMCALL_SETUP_EVENT_NOTIFY_INTERRUPT 0x10004ULL
 76
 77/*
 78 * TDG.VP.VMCALL Status Codes (returned in R10)
 79 */
 80#define TDVMCALL_STATUS_SUCCESS		0x0000000000000000ULL
 81#define TDVMCALL_STATUS_RETRY		0x0000000000000001ULL
 82#define TDVMCALL_STATUS_INVALID_OPERAND	0x8000000000000000ULL
 83#define TDVMCALL_STATUS_ALIGN_ERROR	0x8000000000000002ULL
 84#define TDVMCALL_STATUS_SUBFUNC_UNSUPPORTED	0x8000000000000003ULL
 85
 86/*
 87 * Bitmasks of exposed registers (with VMM).
 88 */
 89#define TDX_RDX		BIT(2)
 90#define TDX_RBX		BIT(3)
 91#define TDX_RSI		BIT(6)
 92#define TDX_RDI		BIT(7)
 93#define TDX_R8		BIT(8)
 94#define TDX_R9		BIT(9)
 95#define TDX_R10		BIT(10)
 96#define TDX_R11		BIT(11)
 97#define TDX_R12		BIT(12)
 98#define TDX_R13		BIT(13)
 99#define TDX_R14		BIT(14)
100#define TDX_R15		BIT(15)
101
102/*
103 * These registers are clobbered to hold arguments for each
104 * TDVMCALL. They are safe to expose to the VMM.
105 * Each bit in this mask represents a register ID. Bit field
106 * details can be found in TDX GHCI specification, section
107 * titled "TDCALL [TDG.VP.VMCALL] leaf".
108 */
109#define TDVMCALL_EXPOSE_REGS_MASK	\
110	(TDX_RDX | TDX_RBX | TDX_RSI | TDX_RDI | TDX_R8  | TDX_R9  | \
111	 TDX_R10 | TDX_R11 | TDX_R12 | TDX_R13 | TDX_R14 | TDX_R15)
112
113/* TDX supported page sizes from the TDX module ABI. */
114#define TDX_PS_4K	0
115#define TDX_PS_2M	1
116#define TDX_PS_1G	2
117#define TDX_PS_NR	(TDX_PS_1G + 1)
118
119#ifndef __ASSEMBLER__
120
121#include <linux/compiler_attributes.h>
122
123/*
124 * Used in __tdcall*() to gather the input/output registers' values of the
125 * TDCALL instruction when requesting services from the TDX module. This is a
126 * software only structure and not part of the TDX module/VMM ABI
127 */
128struct tdx_module_args {
129	/* callee-clobbered */
130	u64 rcx;
131	u64 rdx;
132	u64 r8;
133	u64 r9;
134	/* extra callee-clobbered */
135	u64 r10;
136	u64 r11;
137	/* callee-saved + rdi/rsi */
138	u64 r12;
139	u64 r13;
140	u64 r14;
141	u64 r15;
142	u64 rbx;
143	u64 rdi;
144	u64 rsi;
145};
146
147/* Used to communicate with the TDX module */
148u64 __tdcall(u64 fn, struct tdx_module_args *args);
149u64 __tdcall_ret(u64 fn, struct tdx_module_args *args);
150u64 __tdcall_saved_ret(u64 fn, struct tdx_module_args *args);
151
152/* Used to request services from the VMM */
153u64 __tdx_hypercall(struct tdx_module_args *args);
154
155/*
156 * Wrapper for standard use of __tdx_hypercall with no output aside from
157 * return code.
158 */
159static inline u64 _tdx_hypercall(u64 fn, u64 r12, u64 r13, u64 r14, u64 r15)
160{
161	struct tdx_module_args args = {
162		.r10 = TDX_HYPERCALL_STANDARD,
163		.r11 = fn,
164		.r12 = r12,
165		.r13 = r13,
166		.r14 = r14,
167		.r15 = r15,
168	};
169
170	return __tdx_hypercall(&args);
171}
172
173
174/* Called from __tdx_hypercall() for unrecoverable failure */
175void __noreturn __tdx_hypercall_failed(void);
176
177bool tdx_accept_memory(phys_addr_t start, phys_addr_t end);
178
179/*
180 * The TDG.VP.VMCALL-Instruction-execution sub-functions are defined
181 * independently from but are currently matched 1:1 with VMX EXIT_REASONs.
182 * Reusing the KVM EXIT_REASON macros makes it easier to connect the host and
183 * guest sides of these calls.
184 */
185static __always_inline u64 hcall_func(u64 exit_reason)
186{
187        return exit_reason;
188}
189
190#endif /* !__ASSEMBLER__ */
191#endif /* _ASM_X86_SHARED_TDX_H */