From: Yi Sun <yi.sun@intel.com>
To: tglx@linutronix.de, mingo@redhat.com, bp@alien8.de,
dave.hansen@linux.intel.com, peterz@infradead.org,
x86@kernel.org
Cc: kirill.shutemov@linux.intel.com,
sathyanarayanan.kuppuswamy@linux.intel.com, kai.huang@intel.com,
linux-kernel@vger.kernel.org, heng.su@intel.com,
yi.sun@linux.intel.com, Yi Sun <yi.sun@intel.com>,
Dongcheng Yan <dongcheng.yan@intel.com>
Subject: [PATCH v4] x86/tdx: Dump TDX version During the TD Bootup
Date: Fri, 6 Oct 2023 14:28:55 +0800 [thread overview]
Message-ID: <20231006062855.875631-1-yi.sun@intel.com> (raw)
It is essential for TD users to be aware of the vendor and version of
the current TDX. Additionally, they can reference the TDX version when
reporting bugs or issues.
Furthermore, the applications or device drivers running in TD can achieve
enhanced reliability and flexibility by following the TDX Module ABI
specification, because there are significant differences between different
versions of TDX, as mentioned in the "Intel® TDX Module Incompatibilities
between v1.0 and v1.5" reference. Here are a few examples:
MSR Name Index Reason
----------------------------------------------
IA32_UARCH_MISC_CTL 0x1B01 From v1.5
IA32_ARCH_CAPABILITIES 0x010A Changed in v1.5
IA32_TSX_CTRL 0x0122 Changed in v1.5
CPUID Leaf Sub-leaf Reason
---------------------------------------
0x7 2 From v1.5
0x22 0 From v1.5
0x23 0~3 From v1.5
0x80000007 0 From v1.5
During TD initialization, the TDX version info can be obtained by calling
TDG.SYS.RD. This will fetch the current version of TDX, including the major
and minor version numbers and vendor ID.
The TDCALL TDG.SYS.RD originates from TDX version 1.5. If the error
TDCALL_INVALID_OPERAND occurs, it should be treated as TDX version 1.0.
If the __tdcall_ret fails, expect a zero value for all tdx sys info.
No additional error code is necessary to avoid introducing noise during
the bootup.
Co-developed-by: Dongcheng Yan <dongcheng.yan@intel.com>
Signed-off-by: Dongcheng Yan <dongcheng.yan@intel.com>
Signed-off-by: Yi Sun <yi.sun@intel.com>
diff --git a/arch/x86/coco/tdx/tdx.c b/arch/x86/coco/tdx/tdx.c
index 3e6dbd2199cf..991f7dc695bd 100644
--- a/arch/x86/coco/tdx/tdx.c
+++ b/arch/x86/coco/tdx/tdx.c
@@ -37,6 +37,24 @@
#define TDREPORT_SUBTYPE_0 0
+/*
+ * TDX metadata base field id, used by TDCALL TDG.SYS.RD
+ * See TDX ABI Spec section 3.3.2.3 Global Metadata Fields
+ */
+#define TDX_SYS_VENDOR_ID_FID 0x0800000200000000ULL
+#define TDX_SYS_MINOR_FID 0x0800000100000003ULL
+#define TDX_SYS_MAJOR_FID 0x0800000100000004ULL
+#define TDX_VENDOR_INTEL 0x8086
+
+/*
+ * The global-scope metadata field via TDG.SYS.RD TDCALL
+ */
+struct tdg_sys_info {
+ u32 vendor_id;
+ u16 major_version;
+ u16 minor_version;
+};
+
/* Called from __tdx_hypercall() for unrecoverable failure */
noinstr void __noreturn __tdx_hypercall_failed(void)
{
@@ -800,6 +818,60 @@ static bool tdx_enc_status_change_finish(unsigned long vaddr, int numpages,
return true;
}
+/*
+ * Parse the tdx module version info from the global-scope metadata fields.
+ *
+ * Refer to Intel TDX Application Binary Interface (ABI) section
+ * "TDG.SYS.RD".
+ */
+static void tdg_get_sysinfo(struct tdg_sys_info *td_sys)
+{
+ u64 ret;
+ struct tdx_module_args args = {
+ .rdx = TDX_SYS_VENDOR_ID_FID,
+ };
+
+ if (!td_sys)
+ return;
+
+ memset(td_sys, 0, sizeof(struct tdg_sys_info));
+
+ /*
+ * TDCALL leaf TDX_SYS_RD
+ * Input Field Identifier via RDX and get the output via R8.
+ */
+ ret = __tdcall_ret(TDX_SYS_RD, &args);
+ /*
+ * The TDCALL TDG.SYS.RD originates from TDX version 1.5.
+ * Treat TDCALL_INVALID_OPERAND error as TDX version 1.0.
+ * If other errors occur, return with zero td_sys.
+ */
+ if (TDCALL_RETURN_CODE(ret) == TDCALL_INVALID_OPERAND)
+ goto version_1_0;
+ else if (ret)
+ return;
+
+ td_sys->vendor_id = (u32)args.r8;
+
+ args.rdx = TDX_SYS_MAJOR_FID;
+ __tdcall_ret(TDX_SYS_RD, &args);
+
+ td_sys->major_version = (u16)args.r8;
+
+ args.rdx = TDX_SYS_MINOR_FID;
+ __tdcall_ret(TDX_SYS_RD, &args);
+
+ td_sys->minor_version = (u16)args.r8;
+
+ return;
+
+ /* TDX 1.0 does not have the TDCALL TDG.SYS.RD */
+version_1_0:
+ td_sys->vendor_id = TDX_VENDOR_INTEL;
+ td_sys->major_version = 1;
+ td_sys->minor_version = 0;
+}
+
void __init tdx_early_init(void)
{
struct tdx_module_args args = {
@@ -808,6 +880,7 @@ void __init tdx_early_init(void)
};
u64 cc_mask;
u32 eax, sig[3];
+ struct tdg_sys_info td_sys_info;
cpuid_count(TDX_CPUID_LEAF_ID, 0, &eax, &sig[0], &sig[2], &sig[1]);
@@ -867,5 +940,9 @@ void __init tdx_early_init(void)
*/
x86_cpuinit.parallel_bringup = false;
- pr_info("Guest detected\n");
+ tdg_get_sysinfo(&td_sys_info);
+
+ pr_info("Guest detected. TDX version:%u.%u VendorID: %x\n",
+ td_sys_info.major_version, td_sys_info.minor_version,
+ td_sys_info.vendor_id);
}
diff --git a/arch/x86/include/asm/shared/tdx.h b/arch/x86/include/asm/shared/tdx.h
index f74695dea217..d326509832e6 100644
--- a/arch/x86/include/asm/shared/tdx.h
+++ b/arch/x86/include/asm/shared/tdx.h
@@ -17,6 +17,7 @@
#define TDG_MR_REPORT 4
#define TDG_MEM_PAGE_ACCEPT 6
#define TDG_VM_WR 8
+#define TDX_SYS_RD 11
/* TDCS fields. To be used by TDG.VM.WR and TDG.VM.RD module calls */
#define TDCS_NOTIFY_ENABLES 0x9100000000000010
--
2.34.1
next reply other threads:[~2023-10-06 6:33 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-10-06 6:28 Yi Sun [this message]
2023-10-06 8:11 ` Nikolay Borisov
2023-10-06 10:20 ` Yi Sun
2023-10-06 9:48 ` Huang, Kai
2023-10-06 11:09 ` Sun, Yi
2023-10-06 20:40 ` Huang, Kai
2023-10-09 1:23 ` Kuppuswamy Sathyanarayanan
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20231006062855.875631-1-yi.sun@intel.com \
--to=yi.sun@intel.com \
--cc=bp@alien8.de \
--cc=dave.hansen@linux.intel.com \
--cc=dongcheng.yan@intel.com \
--cc=heng.su@intel.com \
--cc=kai.huang@intel.com \
--cc=kirill.shutemov@linux.intel.com \
--cc=linux-kernel@vger.kernel.org \
--cc=mingo@redhat.com \
--cc=peterz@infradead.org \
--cc=sathyanarayanan.kuppuswamy@linux.intel.com \
--cc=tglx@linutronix.de \
--cc=x86@kernel.org \
--cc=yi.sun@linux.intel.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®