From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by mx.groups.io with SMTP id smtpd.web11.4880.1648080647868528787 for ; Wed, 23 Mar 2022 17:10:53 -0700 Authentication-Results: mx.groups.io; dkim=fail reason="unable to parse pub key" header.i=@intel.com header.s=intel header.b=GYoSSpi/; spf=pass (domain: intel.com, ip: 192.55.52.120, mailfrom: min.m.xu@intel.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1648080653; x=1679616653; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=xXqnONzJDO/VoWWcR0AriGlYfexCtE1buOY+4OhIYk4=; b=GYoSSpi/Pt6QEFxOKWJxqz5Y9qXwl4e1gD4JMf3eVcW2XAT4KkQ00XzC oZ7QRM6i/XQc6Ngu03z5Iavn8i0SQ2taXCnw255wGZX7COA+GbwCfeDtz /UUVCekcjaeb4WIkN3JPpYsEiwXryef/5Y8L/OcWtt7Ou31yxBWB9bJS0 oExeywzvjXU+14Qm/qptLKS03T239k3bWyDE7cK9oZN9di1TSvlzX3nVu wWxPppc6YuPUf3UR/cY+ieD4DzhmeyvdXMrbP1nHpkD1xfrosFfK3bgfi yBoCMHjX88a+0eRpRNIAonahCeaCHYRIELMjZZ5nGNBgmap8o3t3RahOp Q==; X-IronPort-AV: E=McAfee;i="6200,9189,10295"; a="257080200" X-IronPort-AV: E=Sophos;i="5.90,205,1643702400"; d="scan'208";a="257080200" Received: from orsmga004.jf.intel.com ([10.7.209.38]) by fmsmga104.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 Mar 2022 17:10:52 -0700 X-IronPort-AV: E=Sophos;i="5.90,205,1643702400"; d="scan'208";a="649650854" Received: from mxu9-mobl1.ccr.corp.intel.com ([10.255.31.90]) by orsmga004-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 Mar 2022 17:10:49 -0700 From: "Min Xu" To: devel@edk2.groups.io Cc: Min Xu , Ray Ni , Michael D Kinney , Liming Gao , Zhiguang Liu , Brijesh Singh , Erdem Aktas , James Bottomley , Jiewen Yao , Tom Lendacky , Gerd Hoffmann Subject: [PATCH V10 02/47] MdePkg: Update Cpuid.h for Tdx Date: Thu, 24 Mar 2022 08:09:48 +0800 Message-Id: <20220324001033.1169-3-min.m.xu@intel.com> X-Mailer: git-send-email 2.29.2.windows.2 In-Reply-To: <20220324001033.1169-1-min.m.xu@intel.com> References: <20220324001033.1169-1-min.m.xu@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit RFC: https://bugzilla.tianocore.org/show_bug.cgi?id=3429 Guest software can be designed to run either as a TD, as a legacy virtual machine, or directly on the CPU, based on enumeration of its run-time environment. [TDX-Module] Chap 10.2 defines the flow and the new CPUID leaf 0x21. [TDX-Module] Architecture Specification: Intel(R) Trust Domain Extensions Module, Chap 10.2, 344425-003US, August 2021 https://www.intel.com/content/dam/develop/external/us/en/documents/ tdx-module-1.0-public-spec-v0.931.pdf Cc: Ray Ni Cc: Michael D Kinney Cc: Liming Gao Cc: Zhiguang Liu Cc: Brijesh Singh Cc: Erdem Aktas Cc: James Bottomley Cc: Jiewen Yao Cc: Tom Lendacky Cc: Gerd Hoffmann Reviewed-by: Liming Gao Acked-by: Gerd Hoffmann Signed-off-by: Min Xu --- MdePkg/Include/Register/Intel/Cpuid.h | 35 +++++++++++++++++++++++++-- 1 file changed, 33 insertions(+), 2 deletions(-) diff --git a/MdePkg/Include/Register/Intel/Cpuid.h b/MdePkg/Include/Register/Intel/Cpuid.h index bd6349d7940d..350bf60252e1 100644 --- a/MdePkg/Include/Register/Intel/Cpuid.h +++ b/MdePkg/Include/Register/Intel/Cpuid.h @@ -12,6 +12,8 @@ @par Specification Reference: Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume 2A, November 2018, CPUID instruction. + Architecture Specification: Intel(R) Trust Domain Extensions Module, Chap 10.2 + 344425-003US, August 2021 **/ @@ -321,9 +323,9 @@ typedef union { /// UINT32 RDRAND : 1; /// - /// [Bit 31] Always returns 0. + /// [Bit 31] A value of 1 indicates that processor is in Para-Virtualized. /// - UINT32 NotUsed : 1; + UINT32 ParaVirtualized : 1; } Bits; /// /// All bit fields as a 32-bit value @@ -3689,6 +3691,35 @@ typedef union { /// @} /// +/** + CPUID Guest TD Run Time Environment Enumeration Leaf + + @note + Guest software can be designed to run either as a TD, as a legacy virtual machine, + or directly on the CPU, based on enumeration of its run-time environment. + CPUID leaf 21H emulation is done by the Intel TDX module. Sub-leaf 0 returns the values + shown below. Other sub-leaves return 0 in EAX/EBX/ECX/EDX. + EAX: 0x00000000 + EBX: 0x65746E49 "Inte" + ECX: 0x20202020 " " + EDX: 0x5844546C "lTDX" + + @param EAX CPUID_GUESTTD_RUNTIME_ENVIRONMENT (0x21) + @param ECX Level number + +**/ +#define CPUID_GUESTTD_RUNTIME_ENVIRONMENT 0x21 + +/// +/// @{ CPUID Guest TD signature values returned by Intel processors +/// +#define CPUID_GUESTTD_SIGNATURE_GENUINE_INTEL_EBX SIGNATURE_32 ('I', 'n', 't', 'e') +#define CPUID_GUESTTD_SIGNATURE_GENUINE_INTEL_ECX SIGNATURE_32 (' ', ' ', ' ', ' ') +#define CPUID_GUESTTD_SIGNATURE_GENUINE_INTEL_EDX SIGNATURE_32 ('l', 'T', 'D', 'X') +/// +/// @} +/// + /** CPUID Extended Function -- 2.29.2.windows.2